|
|
|
|
|
- Équilibrage dynamique de charge
- Gestion des logs
HGèreServeur (Fonction) En anglais : HSetServer
Disponible uniquement avec ce type de connexion
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.
HGèreServeur("MaConnexion", hNiveauLog, "")
Syntaxe
Connaître la valeur d'un paramètre Masquer les détails
<Résultat> = HGèreServeur(<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.
<Connexion> : Chaîne de caractères ou variable de type Connexion Connexion au serveur pour lequel la valeur du paramètre <Option> doit être connue. Cette connexion correspond : <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 : | | hActiveDirectory | Paramètre <Enable> de la section ACTIVEDIRECTORY du fichier HFConf.Ini. Activation de l'authentification par Active Directory. Valeur :- 0, l'authentification par Active Directory n'est pas activée,
- 1, l'authentification par Active Directory est activée.
| 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. | 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ées | Paramè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). | hCheminJNL | Paramè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). | hCheminJNLBackup | Paramètre <JNLBackupRootPath> du fichier HFConf.Ini. Chemin du répertoire contenant la sauvegarde des journaux. | hCheminLog | Paramè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). | hCheminSauvegardes | Paramètre <BackupDirectory> du fichier HFConf.Ini. Chemin du répertoire dans lequel les sauvegardes seront effectuées. | hCheminStatistiquesActivité | Paramètre <StatisticPath> du fichier HFConf.Ini. Chemin du répertoire contenant les fichiers de statistiques d'activité. | hDaemonUser | Paramètre <DaemonUser> du fichier HFConf.Ini. Nom d'utilisateur sous lequel le serveur va fonctionner. | hecAccèsDisque | Paramètre <LoadCoeffDiskAccess> du fichier HFConf.Ini. Coefficient global pour le nombre d'accès au disque. | hecActif | Paramètre <LoadEnable> du fichier HFConf.Ini. Indique si l'équilibrage de charge est activé ou non. | hecAppelsClient | Paramètre <LoadCoeffCall> du fichier HFConf.Ini. Coefficient global pour le nombre d'appels du client. | hecAttenteMax | Paramè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. | hecDisque | Paramè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çu | Paramètre <LoadCoeffRecv> du fichier HFConf.Ini. Coefficient global pour le nombre d'octets reçus sur le réseau. | hkaIntervalle | Paramètre <KeepAliveInterval> du fichier HFConf.Ini. Temps maximum (en secondes) au bout duquel si aucune communication n'est effectuée entre le serveur et le client, le serveur vérifie la présence du client. Par défaut, ce paramètre vaut 30 minutes. | hkaTimeout | Paramètre <KeepAliveTimeout> du fichier HFConf.Ini. Temps maximum (en secondes) d'attente du serveur lors de la vérification de la présence du client. Si le client n'est pas présent à la fin de cette durée, le client est automatiquement déconnecté. Par défaut, ce paramètre vaut 2 minutes. | hLangueServeur | Paramètre <ServerLanguage> du fichier HFConf.Ini. Langue du serveur HFSQL. Valeur : - FR : la langue du serveur est le français.
- US : la langue du serveur est l'anglais.
- ES : la langue du serveur est l'espagnol.
| hMode2Go | Paramè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. | hNiveauLog | Paramètre <ServerLogLevels> du fichier HFConf.Ini. Définit ce qui doit être présent dans le fichier de log. | hNombreMaxConnexion | Paramètre <MaximumConnectionsNumber> du fichier HFConf.ini Nombre maximum de connexions autorisées par application. Le nombre de connexions est déterminé par le nombre d'applications (process) ayant au moins une connexion non super-utilisateur sur le serveur. Par exemple : - une application ayant ouvert une seule connexion en mode super-utilisateur compte pour zéro.
- une application ayant ouvert une seule connexion avec un utilisateur normal compte pour 1.
- une application ayant ouvert deux connexions d'un utilisateur normal compte pour 1.
- une application ayant ouvert des connexion en super-utilisateur et en utilisateur normal compte pour 1.
| 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ébogage | Paramètre <WLDebugPort> du fichier HFConf.Ini. Port utilisé pour le débogage des procédures stockées et des triggers Client/Serveur. | hPortServeur | Paramètre <AccessPort> du fichier HFConf.Ini. Port réseau utilisé. | 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.
| 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). | 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. | hTailleCacheNdx | Paramètre <NdxCacheSize> du fichier HFConf.Ini. Taille du cache des index (en Mo). La valeur par défaut est 10 Mo. | hTailleMaxLog | Paramè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). | 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(<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.
<Connexion> : Chaîne de caractères ou variable de type Connexion Connexion au serveur pour lequel la valeur du paramètre <Option> doit être modifiée. Cette connexion correspond : <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 : La modification de ces options effectuée avec la fonction HGèreServeur est prise en compte sans devoir redémarrer le serveur.
| | hActiveDirectory | Paramètre <Enable> de la section ACTIVEDIRECTORY du fichier HFConf.Ini. Activation de l'authentification par Active Directory. Valeur :- 0, l'authentification par Active Directory n'est pas activée,
- 1, l'authentification par Active Directory est activée.
| 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é.
| hCheminLog | Paramètre <ServerLogPath> du fichier HFConf.Ini. Chemin des fichiers de log. Le chemin est créé sur le serveur s'il n'existe pas. | hCheminSauvegardes | Paramètre <BackupDirectory> du fichier HFConf.Ini. Chemin du répertoire dans lequel les sauvegardes seront effectuées. Le chemin est créé sur le serveur s'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 s'il n'existe pas. Les statistiques sont sauvegardées et réinitialisées. | hkaIntervalle | Paramètre <KeepAliveInterval> du fichier HFConf.Ini. Temps maximum (en secondes) au bout duquel si aucune communication n'est effectuée entre le serveur et le client, le serveur vérifie la présence du client. Par défaut, ce paramètre vaut 30 minutes. | hkaTimeout | Paramètre <KeepAliveTimeout> du fichier HFConf.Ini. Temps maximum (en secondes) d'attente du serveur lors de la vérification de la présence du client. Si le client n'est pas présent à la fin de cette durée, le client est automatiquement déconnecté. Par défaut, ce paramètre vaut 2 minutes. | hNiveauLog | Paramètre <ServerLogLevels> du fichier HFConf.Ini. Définit ce qui doit être présent dans le fichier de log. | hNombreMaxConnexion | Paramètre <MaximumConnectionsNumber> du fichier HFConf.ini Nombre maximum de connexions autorisées par application. Le nombre de connexions est déterminé par le nombre d'applications (process) ayant au moins une connexion non super-utilisateur sur le serveur. Par exemple : - une application ayant ouvert une seule connexion en mode super-utilisateur compte pour zéro.
- une application ayant ouvert une seule connexion avec un utilisateur normal compte pour 1.
- une application ayant ouvert deux connexions d'un utilisateur normal compte pour 1.
- une application ayant ouvert des connexion en super-utilisateur et en utilisateur normal compte pour 1.
Par défaut, ce paramètre vaut 0 (pas de limite). | 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. | 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.
| 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 s'il n'existe pas. | hTailleCacheNdx | Paramè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. | hTailleMaxLog | Paramè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. | 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 : La modification de ces options via la fonction HGèreServeur sera prise en compte au prochain redémarrage du serveur.
| | hCheminBaseDeDonnées | Paramè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 s'il n'existe pas au redémarrage du serveur. | hCheminJNL | Paramè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 s'il n'existe pas au redémarrage du serveur. | hCheminJNLBackup | Paramètre <JNLBackupRootPath> du fichier HFConf.Ini. Chemin du répertoire contenant la sauvegarde des journaux. Le chemin est créé sur le serveur s'il n'existe pas au redémarrage du serveur. | hDaemonUser | Paramètre <DaemonUser> du fichier HFConf.Ini. Nom d'utilisateur sous lequel le serveur va tourner. | hLangueServeur | Paramètre <ServerLanguage> du fichier HFConf.Ini. Langue du serveur HFSQL. Valeur : - FR : la langue du serveur est le français.
- US : la langue du serveur est l'anglais.
- ES : la langue du serveur est l'espagnol.
| hMode2Go | Paramè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. | hPortServeur | Paramètre <AccessPort> du fichier HFConf.Ini. Port réseau utilisé. | 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 : La modification de ces options effectuée avec la fonction HGèreServeur est prise en compte sans devoir redémarrer le serveur.
| | hecAccèsDisque | Paramè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. | hecActif | Paramètre <LoadEnable> du fichier HFConf.Ini. Indique si l'équilibrage de charge est activé ou non.- Vrai si l'équilibrage de charge doit être activé,
- Faux dans le cas contraire.
| hecAppelsClient | Paramè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. | hecAttenteMax | Paramè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. | hecDisque | Paramè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çu | Paramè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 :
|
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.
|
Classification Métier / UI : Code métier
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|