PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

  • Équilibrage dynamique de charge
  • Gestion des logs
Produits
WINDEVWEBDEV - Code ServeurWEBDEV - Code NavigateurWINDEV MobileEtats et Requêtes
Plateformes
WindowsLinuxWindows MobileUniversal Windows 10 AppAndroidWidget AndroidiPhone/iPadApple Watch
Langages
JavaPHPAjaxCode Utilisateur (MCU)Langage Externe
Bases de données
HFSQLHFSQL Client/ServeurProcédures stockéesOLE DBODBCAccès Natifs
HGèreServeur (Fonction)
En anglais : HSetServer
Permet de connaître et de modifier certains paramétrages du serveur HFSQL Client/Serveur.
Remarque : Le droit de gestion du serveur est nécessaire pour utiliser cette fonction. Ce droit correspond à la constante hDroitGestionServeur utilisée dans les fonctions HInfoDroitServeur et HModifieDroitServeur.
Versions 17 et supérieures
WINDEV MobileiPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Nouveauté 17
WINDEV MobileiPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
WINDEV MobileiPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Versions 18 et supérieures
WINDEVWINDEV MobileUniversal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Nouveauté 18
WINDEVWINDEV MobileUniversal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
WINDEVWINDEV MobileUniversal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Versions 21 et supérieures
WINDEVWINDEV MobileUniversal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Nouveauté 21
WINDEVWINDEV MobileUniversal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
WINDEVWINDEV MobileUniversal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Remarque : A partir de la version 19, HFSQL est le nouveau nom de HyperFileSQL.
Versions 22 et supérieures
WINDEV MobileWidget Android Cette fonction est désormais disponible en mode Widget Android.
WINDEV MobileAndroid Cette fonction est désormais disponible pour les applications Android.
WINDEVJava Cette fonction est désormais disponible pour les applications Java.
Nouveauté 22
WINDEV MobileWidget Android Cette fonction est désormais disponible en mode Widget Android.
WINDEV MobileAndroid Cette fonction est désormais disponible pour les applications Android.
WINDEVJava Cette fonction est désormais disponible pour les applications Java.
WINDEV MobileWidget Android Cette fonction est désormais disponible en mode Widget Android.
WINDEV MobileAndroid Cette fonction est désormais disponible pour les applications Android.
WINDEVJava Cette fonction est désormais disponible pour les applications Java.
Exemple
// Désactivation de la gestion des logs d'audit du serveur
HGèreServeur("MaConnexion", hNiveauLog, "")
Syntaxe

Connaître la valeur d'un paramètre Masquer les détails

<Résultat> = HGèreServeur(<Nom de la connexion> , <Option>)
<Résultat> : Chaîne de caractères
  • Valeur de l'option spécifiée.
  • Chaîne vide ("") si l'option n'est pas définie.
<Nom de la connexion> : Chaîne de caractères (avec ou sans guillemets)
Nom de la connexion au serveur pour lequel la valeur du paramètre <Option> souhaite être connue.
<Option> : Constante de type entier
Indique l'option à connaître. Ces options sont stockées dans le fichier HFConf.Ini, présent à la racine du serveur.
Liste des options disponibles :
Versions 21 et supérieures
hCacheNbFichierInutilisé
Nouveauté 21
hCacheNbFichierInutilisé
hCacheNbFichierInutilisé
Paramètre <CacheMaxUnusedFiles> du fichier HFConf.Ini.
Nombre maximum de tables HFSQL non utilisées par des clients qui sont gardées en cache (c'est-à-dire ouvertes) sur le serveur. Lorsque ce nombre est atteint, la table la plus ancienne non utilisée est supprimée du cache.
Versions 18 et supérieures
hCalculStatistiqueAuto
Nouveauté 18
hCalculStatistiqueAuto
hCalculStatistiqueAuto
Paramètre <Enable> de la section AUTOANALYSE du fichier HFConf.Ini.
Activation du calcul automatique des statistiques des fichiers de données (optimisation des index).
Valeur :
  • 0, le calcul automatique des statistiques n'est pas activé,
  • 1, le calcul automatique des statistiques est activé.
hCheminBaseDeDonnéesParamètre <DBRootPath> du fichier HFConf.Ini.
Chemin du répertoire contenant l'ensemble des bases de données (c'est-à-dire les fichiers de données des différentes applications HFSQL Client/Serveur).
hCheminJNLParamètre <JNLRootPath> du fichier HFConf.Ini.
Chemin du répertoire contenant l'ensemble des journaux des différentes applications HFSQL Client/Serveur (historique des écritures dans les fichiers de données HFSQL).
hCheminJNLBackupParamètre <JNLBackupRootPath> du fichier HFConf.Ini.
Chemin du répertoire contenant la sauvegarde des journaux.
hCheminLogParamètre <ServerLogPath> du fichier HFConf.Ini.
Chemin du répertoire contenant les fichiers de log d'audit du serveur (ensemble des opérations demandées par les postes client au serveur).
hCheminStatistiquesActivitéParamètre <StatisticPath> du fichier HFConf.Ini.
Chemin du répertoire contenant les fichiers de statistiques d'activité.
hDaemonUserParamètre <DaemonUser> du fichier HFConf.Ini.
Nom d'utilisateur sous lequel le serveur va fonctionner.
hecAccèsDisqueParamètre <LoadCoeffDiskAccess> du fichier HFConf.Ini.
Coefficient global pour le nombre d'accès au disque.
hecActifParamètre <LoadEnable> du fichier HFConf.Ini.
Indique si l'équilibrage de charges est activée ou non.
hecAppelsClientParamètre <LoadCoeffCall> du fichier HFConf.Ini.
Coefficient global pour le nombre d'appels du client.
hecAttenteMaxParamètre <LoadMaxWait> du fichier HFConf.Ini.
Temps maximum (en ms) pour lequel une demande au serveur pourra être mise en attente par le système d'équilibrage de charge avant d'être traitée.
hecDisqueParamètre <LoadCoeffDisk> du fichier HFConf.Ini.
Coefficient global pour le nombre d'octets lus ou écrits sur disque.
hecEnvoyéParamètre <LoadCoeffSend> du fichier HFConf.Ini.
Coefficient global pour le nombre d'octets envoyés sur le réseau.
hecReçuParamètre <LoadCoeffRecv> du fichier HFConf.Ini.
Coefficient global pour le nombre d'octets reçus sur le réseau.
hMode2GoParamètre <MoreThan2Go> du fichier HFConf.Ini.
Indique si les tables systèmes peuvent avoir une taille supérieure à 2 Go.
Remarque : le système doit gérer les fichiers de plus de 2 Go.
hNiveauLogParamètre <ServerLogLevels> du fichier HFConf.Ini.
Définit ce qui doit être présent dans le fichier de log.
hPériodeStatistiquesActivitéParamètre <StatisticPeriod> du fichier HFConf.Ini.
Indique la période en seconde entre chaque sauvegarde des valeurs des différents compteurs d'activité. Il est possible d'indiquer 0 pour arrêter la collecte des statistiques.
hPortDébogageParamètre <WLDebugPort> du fichier HFConf.Ini.
Port utilisé pour le débogage des procédures stockées et des triggers Client/Serveur.
hPortServeurParamètre <AccessPort> du fichier HFConf.Ini.
Port réseau utilisé.
Versions 22 et supérieures
hRechercheClé
Nouveauté 22
hRechercheClé
hRechercheClé
Paramètre <KeySearch> du fichier HFConf.Ini.
Activation de la recherche des clés.
Valeur :
  • 0, la recherche automatique des clés n'est pas activée,
  • 1, la recherche automatique des clés est activée.
Versions 17 et supérieures
hRépertoireTemp
Nouveauté 17
hRépertoireTemp
hRépertoireTemp
Paramètre <TmpPath> du fichier HFConf.Ini.
Chemin du répertoire temporaire. Ce répertoire est utilisé pour créer les fichiers temporaires si nécessaire (par exemple, fichiers temporaires créés lors de la réindexation de gros fichiers de données).
Versions 19 et supérieures
hTailleCacheDisqueWindows
Nouveauté 19
hTailleCacheDisqueWindows
hTailleCacheDisqueWindows
Paramètre <WindowsFileCacheSize> du fichier HFConf.ini
Configuration de la gestion de la taille du cache disque de Windows.
Valeur :
  • -1, pour une taille calculée automatiquement,
  • 0, pour une taille du cache sans limite,
  • une valeur positive correspond à une taille de cache personnalisée.
Remarque : La gestion standard des caches disques de Windows en mode 64 bits (indépendamment de HFSQL) peut amener à des saturations mémoire. Cette constante permet de personnaliser la gestion des caches mémoire.
hTailleCacheNdxParamètre <NdxCacheSize> du fichier HFConf.Ini.
Taille du cache des index (en Mo). La valeur par défaut est 10 Mo.
hTailleMaxLogParamètre <ServerLogMaxSize> du fichier HFConf.Ini.
Taille maximale d'un fichier de log (en Mo).
hTailleMaxStatistiquesActivitéParamètre <ActivityStatisticMaxFileSize> du fichier HFConf.Ini.
Taille maximale d'un fichier de statistiques d'activité (en Mo).
Versions 22 et supérieures
hTélémétrieActive
Nouveauté 22
hTélémétrieActive
hTélémétrieActive
Paramètre <Active> de la section TELEMETRY du fichier HFConf.ini
Configuration de la transmission des données en vue de l'amélioration du serveur HFSQL.
Valeur :
  • 1, si lors de l'installation du serveur HFSQL, la transmission des données (télémétrie) a été activée,
  • 0, si lors de l'installation du serveur HFSQL, la transmission des données (télémétrie) a été refusée,
  • une autre valeur signifie qu'aucun choix n'a été fait lors de l'installation concernant l'usage de la télémétrie. La question sera reposée lors de la prochaine installation du serveur HFSQL.
Remarque : Si la section "TELEMETRY" n'existe pas dans le fichier HFConf.ini, la transmission des données relatives à l'utilisation du produit n'est pas activée pour le serveur HFSQL.

Modifier la valeur d'un paramètre Masquer les détails

<Résultat> = HGèreServeur(<Nom de la connexion> , <Option> , <Valeur>)
<Résultat> : Chaîne de caractères
  • Ancienne valeur de l'option,
  • Chaîne vide ("") si une erreur a été rencontrée.
<Nom de la connexion> : Chaîne de caractères (avec ou sans guillemets)
Nom de la connexion au serveur pour lequel la valeur du paramètre <Option> souhaite être modifiée.
<Option> : Constante de type entier
Indique l'option à connaître. Ces options sont stockées dans le fichier HFConf.Ini, présent à la racine du serveur.
Remarque : Une description plus détaillée de chaque paramètre est disponible sur la page HFConf.Ini
  • Liste des options pour une utilisation simple :
    Remarque : Les modifications pour ces options sont prises en compte sans devoir redémarrer le serveur.
    Versions 18 et supérieures
    hCalculStatistiqueAuto
    Nouveauté 18
    hCalculStatistiqueAuto
    hCalculStatistiqueAuto
    Paramètre <Enable> de la section AUTOANALYSE du fichier HFConf.Ini.
    Activation du calcul automatique des statistiques des fichiers de données (optimisation des index).
    Valeur :
    • 0, le calcul automatique des statistiques n'est pas activé,
    • 1, le calcul automatique des statistiques est activé.
    hCheminLogParamètre <ServerLogPath> du fichier HFConf.Ini.
    Chemin des fichiers de log. Le chemin est créé sur le serveur si il n'existe pas.
    hCheminStatistiquesActivitéParamètre <StatisticPath> du fichier HFConf.Ini.
    Chemin des fichiers de statistiques d'activité. Le chemin est créé sur le serveur si il n'existe pas.
    Les statistiques sont sauvegardées et réinitialisées.
    hNiveauLogParamètre <ServerLogLevels> du fichier HFConf.Ini.
    Définit ce qui doit être présent dans le fichier de log
    hPériodeStatistiquesActivitéParamètre <StatisticPeriod> du fichier HFConf.Ini.
    Indique la période (en secondes) entre chaque sauvegarde des valeurs des différents compteurs d'activité.
    Cette valeur doit être supérieure ou égale à 1 sinon aucune modification n'est effectuée.
    Les statistiques sont sauvegardées et réinitialisées.
    Il est possible d'indiquer 0 pour arrêter la collecte des statistiques.
    Versions 22 et supérieures
    hRechercheClé
    Nouveauté 22
    hRechercheClé
    hRechercheClé
    Paramètre <KeySearch> du fichier HFConf.Ini.
    Activation de la recherche des clés.
    Valeur :
    • 0, la recherche automatique des clés n'est pas activée,
    • 1, la recherche automatique des clés est activée.
    Versions 17 et supérieures
    hRépertoireTemp
    Nouveauté 17
    hRépertoireTemp
    hRépertoireTemp
    Paramètre <TmpPath> du fichier HFConf.Ini.
    Chemin du répertoire temporaire. Ce répertoire est utilisé pour créer les fichiers temporaires si nécessaire (par exemple, fichiers temporaires créés lors de la réindexation de gros fichiers de données).
    Le chemin est créé sur le serveur si il n'existe pas.
    hTailleCacheNdxParamètre <NdxCacheSize> du fichier HFConf.Ini.
    Taille du cache des index (en Mo).
    Cette valeur doit être supérieure ou égale à 1 sinon aucune modification n'est effectuée.
    hTailleMaxLogParamètre <ServerLogMaxSize> du fichier HFConf.Ini.
    Taille maximale d'un fichier de log (en Mo).
    Cette valeur doit être supérieure ou égale à 1 sinon aucune modification n'est effectuée.
    hTailleMaxStatistiquesActivitéParamètre <StatisticMaxFileSize> du fichier HFConf.Ini
    Taille maximale d'un fichier de statistiques d'activité (en Mo).
    Cette valeur doit être supérieure ou égale à 1 sinon aucune modification n'est effectuée.
    Les statistiques sont sauvegardées et réinitialisées.
    Versions 22 et supérieures
    hTélémétrieActive
    Nouveauté 22
    hTélémétrieActive
    hTélémétrieActive
    Paramètre <Active> de la section TELEMETRY du fichier HFConf.ini
    Configuration de l'utilisation de la transmission des données relatives à l'utilisation du serveur HFSQL pour une amélioration du produit.
    Valeur :
    • 1, si lors de l'installation du serveur HFSQL, la transmission des données (télémétrie) a été activée,
    • 0, si lors de l'installation du serveur HFSQL, la transmission des données (télémétrie) a été refusée,
    • une autre valeur signifie qu'aucun choix n'a été fait lors de l'installation concernant l'usage de la télémétrie. La question sera reposée lors de la prochaine installation du serveur HFSQL.
    Remarque : Si la section "TELEMETRY" n'existe pas dans le fichier HFConf.ini, la transmission des données relative à l'utilisation du produit n'est pas activée pour le serveur HFSQL.
  • Liste des options pour une utilisation avancée :
    Remarque : Les modifications pour ces options seront prises en compte au prochain redémarrage du serveur.
    hCheminBaseDeDonnéesParamètre <DBRootPath> du fichier HFConf.Ini.
    Chemin du répertoire contenant l'ensemble des bases de données (c'est-à-dire les fichiers de données des différentes applications HFSQL Client/Serveur).
    Le chemin est créé sur le serveur si il n'existe pas au redémarrage du serveur.
    hCheminJNLParamètre <JNLRootPath> du fichier HFConf.Ini
    Chemin du répertoire contenant l'ensemble des journaux des différentes applications HFSQL Client/Serveur.
    Le chemin est créé sur le serveur si il n'existe pas au redémarrage du serveur.
    hCheminJNLBackupParamètre <JNLBackupRootPath> du fichier HFConf.Ini.
    Chemin du répertoire contenant la sauvegarde des journaux.
    Le chemin est créé sur le serveur si il n'existe pas au redémarrage du serveur.
    hDaemonUserParamètre <DaemonUser> du fichier HFConf.Ini.
    Nom d'utilisateur sous lequel le serveur va tourner.
    hMode2GoParamètre <MoreThan2Go> du fichier HFConf.Ini.
    Indique si les tables systèmes peuvent avoir une taille supérieure à 2 Go.
    Remarque : le système doit gérer les fichiers de plus de 2 Go.
    hPortServeurParamètre <AccessPort> du fichier HFConf.Ini.
    Port réseau utilisé.
    Versions 19 et supérieures
    hTailleCacheDisqueWindows
    Nouveauté 19
    hTailleCacheDisqueWindows
    hTailleCacheDisqueWindows
    Paramètre <WindowsFileCacheSize> du fichier HFConf.ini
    Mode de gestion de la taille du cache disque de Windows.
    Valeur :
    • -1, pour une taille calculée automatiquement,
    • 0, pour une taille du cache sans limite,
    • une valeur positive indique la taille du cache personnalisée.
    Remarque : La gestion standard des caches disques de Windows en mode 64 bits (indépendamment de HFSQL) peut amener à des saturations mémoire. Cette constante permet de personnaliser la gestion des caches mémoire.
  • Liste des options pour l'équilibrage dynamique de charge :
    Remarque : Les modifications pour ces options sont prises en compte sans devoir redémarrer le serveur.
    hecAccèsDisqueParamètre <LoadCoeffDiskAccess> du fichier HFConf.Ini.
    Coefficient global pour le nombre d'accès au disque.
    Cette valeur, comprise entre -100 et 100, augmente ou diminue le coefficient appliqué au compteur du nombre d'accès au disque.
    hecActifParamètre <LoadEnable> du fichier HFConf.Ini.
    Indique si l'équilibrage de charges est activée ou non.
    • Vrai si l'équilibrage de charge doit être activé ,
    • Faux dans le cas contraire.
    hecAppelsClientParamètre <LoadCoeffCall> du fichier HFConf.Ini.
    Coefficient global pour le nombre d'appels du client.
    Cette valeur, comprise entre -100 et 100, augmente ou diminue le coefficient appliqué au compteur des appels clients au serveur.
    hecAttenteMaxParamètre <LoadMaxWait> du fichier HFConf.Ini.
    Temps maximum (en ms) pour lequel une demande au serveur pourra être mise en attente par le système d'équilibrage de charge avant d'être traitée.
    hecDisqueParamètre <LoadCoeffDisk> du fichier HFConf.Ini.
    Coefficient global pour le nombre d'octets lus ou écrits sur disque.
    Cette valeur, comprise entre -100 et 100, augmente ou diminue le coefficient appliqué au compteur des octets lus ou écrits sur disque par le serveur.
    hecEnvoyéParamètre <LoadCoeffSend> du fichier HFConf.Ini.
    Coefficient global pour le nombre d'octets envoyés sur le réseau.
    Cette valeur, comprise entre -100 et 100, augmente ou diminue le coefficient appliqué au compteur des octets envoyés par le serveur.
    hecReçuParamètre <LoadCoeffRecv> du fichier HFConf.Ini.
    Coefficient global pour le nombre d'octets reçus sur le réseau.
    Cette valeur, comprise entre -100 et 100, augmente ou diminue le coefficient appliqué au compteur des octets reçus par le serveur.
<Valeur> : Variant
Nouvelle valeur de l'option spécifiée.
Remarques

Équilibrage dynamique de charge

Les coefficients servent à faire varier l'importance de chaque compteur dans la formule de calcul de la charge engendrée par un utilisateur sur le serveur.
  • Une valeur de 1, 0 ou -1 ne modifie pas le coefficient.
  • Une valeur supérieure à 100 est équivalente à 100.
  • Une valeur inférieure à -100 est équivalente à -100.

Gestion des logs

Les informations concernant les logs peuvent être modifiées sans redémarrage du serveur. Il est conseillé de modifier le chemin des logs avant de les activer. Dans le cas contraire, les logs seront écrits dans le répertoire par défaut entre l'activation et le changement de chemin.
Liste des exemples associés :
La fonction HGèreServeur Exemples unitaires (WINDEV) : La fonction HGèreServeur
[ + ] Utilisation de la fonction HGèreServeur de WINDEV.
Cette fonction permet de modifier un certain nombre de paramètres sur le serveur HFSQL.
Elle vous permet ainsi de gérer plus finement votre serveur.
Composantes
WINDEVWEBDEV - Code ServeurEtats et Requêtes wd220hf.dll
Windows Mobile wp220hf.dll
Java wd220java.jar
Linux wd220hf.so
Android wd220android.jar
Version minimum requise
  • Version 11
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire