DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Gestion des bases de données / HFSQL / Gestion de HFSQL Client/Serveur
  • Présentation
  • Contenu du fichier HFConf.Ini
  • Section INIT
  • Section MANAGER
  • Section AUTOANALYSE
  • Section TELEMETRY
  • Section ACTIVEDIRECTORY
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Présentation
Le fichier HFConf.INI est présent à la racine du serveur. Ce fichier permet de définir plusieurs caractéristiques du serveur HFSQL Client/Serveur.
Ce fichier permet entre autre de spécifier les caractéristiques des fichiers de log créés sur le serveur. Les fichiers de log sont des fichiers texte dont les rubriques sont séparées par des TAB. La première ligne du fichier contient la définition des colonnes. Les fichiers de log sont créés par le programme HFLogger.exe (hflogger sous Linux).
Contenu du fichier HFConf.Ini
Le fichier HFConf.INI contient plusieurs sections :
  • La section INIT qui permet de faire différentes initialisations.
  • La section MANAGER, utilisée en Linux uniquement.
  • La section AUTOANALYSE qui permet de paramétrer l'optimisation des index en tâche de fond.
  • La section TELEMETRY qui permet de configurer la transmission des données à PC SOFT en vue de l'amélioration du produit (télémétrie).
  • La section ACTIVEDIRECTORY qui permet de configurer l'authentification via Active Directory.

Section INIT

La section INIT peut contenir les mots-clés suivants :
Mot-cléDescriptionValeur par défaut
AccessPort Port réseau utilisé.4900
ActivityStatisticMaxFileSizeTaille maximale du fichier de statistiques d'activité (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.
ActivityStatisticPath 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.
ActivityStatisticPeriod 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.
CacheMaxUnusedFilesNombre 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.
CacheFilesPrefetchConfigure le remplissage automatique du cache des tables.
Les valeurs possibles sont :
  • 1 : Remplissage automatique activé.
  • 0 : Remplissage automatique inactif.
0, remplissage automatique des caches des tables inactif.
DBRootPathChemin 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).
Pour spécifier le répertoire du service Manta, il suffit d'utiliser la chaîne de caractères "%%EXE%%".
"%%EXE%%DB" (sous-répertoire "DB" du répertoire du service Manta)
DaemonUser
Linux uniquement
Nom d'utilisateur sous lequel le serveur va tourner."root"
JNLBackupRootPathChemin du répertoire de sauvegarde des journaux. Si ce chemin n'existe pas au redémarrage du serveur, il est automatiquement créé.Sous-répertoire "__JNLBackup" du répertoire contenant l'ensemble des fichiers de données
JNLRootPathChemin 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). L'ensemble des journaux sera contenu dans le sous-répertoire "__JNL" du répertoire spécifié.
Par exemple, si le répertoire spécifié est "C:\MonRep", les journaux seront contenus dans le répertoire "C:\MonRep\__JNL".
Il est conseillé de modifier le chemin par défaut des journaux pour sécuriser les données. En effet, si le disque dur contenant les données a un problème technique, il sera toujours possible de rejouer le journal (enregistré sur un autre disque) à partir d'une sauvegarde.
Pour spécifier le répertoire du service Manta, il suffit d'utiliser la chaîne de caractères "%%EXE%%".
Sous-répertoire "__JNL" du répertoire contenant l'ensemble des fichiers de données
KeepAliveIntervalTemps 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.30 minutes
KeepAliveTimeOutTemps 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é.2 minutes
KeySearchActivation de la recherche des clés.
Les valeurs possibles sont :
  • 0 : Recherche automatique des clés inactive,
  • 1 : Recherche automatique des clés activée.
0, recherche automatique des clés inactive.
LoadCoeffCallCoefficient 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.
Les coefficients permettent de 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, -1 ne modifie pas le coefficient.
Une valeur supérieure à 100 est équivalente à 100.
Une valeur inférieure à -100 est équivalente à -100.
LoadCoeffDisk 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.
Les coefficients permettent de 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, -1 ne modifie pas le coefficient.
Une valeur supérieure à 100 est équivalente à 100.
Une valeur inférieure à -100 est équivalente à -100.
LoadCoeffDiskAccessCoefficient 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.
Les coefficients permettent de 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, -1 ne modifie pas le coefficient.
Une valeur supérieure à 100 est équivalente à 100.
Une valeur inférieure à -100 est équivalente à -100.
LoadCoeffRecvCoefficient 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.
Les coefficients permettent de 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, -1 ne modifie pas le coefficient.
Une valeur supérieure à 100 est équivalente à 100.
Une valeur inférieure à -100 est équivalente à -100.
LoadCoeffSendCoefficient 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.
Les coefficients permettent de 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, -1 ne modifie pas le coefficient.
Une valeur supérieure à 100 est équivalente à 100.
Une valeur inférieure à -100 est équivalente à -100.
LoadEnableIndique si l'équilibrage de charge est activé (Vrai) ou non (Faux).
LoadMaxWaitTemps 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.
LogConnexionPermet d'ajouter une information dans les fichiers log système à chaque connexion d'un client sur le serveur.
La valeur de ce mot-clé peut être 0 (pas d'ajout) ou 1 (ajout possible).
0 (pas d'ajout)
MaximumConnectionsNumberNombre 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 connexions en super-utilisateur et en utilisateur normal compte pour 1.
Si la valeur de ce mot-clé vaut 0, il n'y a pas de limite.
0, pas de limite.
MoreThan2GoIndique si les fichiers systèmes supportent plus de 2 Go.
La valeur de ce mot-clé peut être 0 (non) ou 1 (oui).
0 (non)
NdxCacheSizeTaille du cache des index (Mo).
Cette taille doit être supérieure à 1.
Remarque : sur un serveur 32 bits, ce paramètre ne peut dépasser 1 Go.
ServerLogLevelsDéfinit ce qui doit être présent dans le fichier de log.
Les paramètres possibles sont "WL" et "PARAM", séparés par une virgule :
  • "WL" : permet de mettre dans le fichier de log les appels au serveur.
  • "PARAM" : permet de mettre dans le fichier de log les paramètres des appels.
Aucun fichier de log réalisé
ServerLogPathEmplacement des fichiers de log d'audit du serveur (ensemble des opérations demandées par les postes client au serveur).
Le chemin est créé sur le serveur s'il n'existe pas.
"%%EXE%%\Logs" (sous-répertoire "Logs" du répertoire du service Manta)
ServerLogMaxSizeTaille maximale d'un fichier de log (en Mo).
Cette taille doit être supérieure à 1.
20 Mo
TmpPathChemin du répertoire temporaire. Ce répertoire peut être utilisé par exemple pour créer des fichiers temporaires lors de la réindexation de gros fichiers.
WindowsFileCacheSizeConfigure la gestion des caches disques de Windows.
Les valeurs possibles sont :
  • -1, pour une taille calculée automatiquement,
  • 0, pour une taille du cache sans limite,
  • une valeur positive permet de définir 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 option permet de personnaliser la gestion des caches mémoire.
-1
WLDebugPortPort utilisé pour le débogage des procédures stockées et des triggers Client/Serveur.27281
Remarque : Dans les chemins de répertoire, il est possible d'utiliser %%COMMONAPPDATA%% :
  • Sous Windows, le répertoire obtenu correspond à celui obtenu par la fonction SysRep (syntaxe : SysRep(srAppDataCommun)).
  • Sous Linux, le répertoire obtenu est "/var/lib/".
WINDEVWEBDEV - Code ServeurLinux

Section MANAGER

La section MANAGER est utilisée en Linux uniquement. Cette section peut contenir les mots-clés suivants :
  • RestartOnFailed : Active le relancement du serveur après une erreur fatale. La valeur de ce mot-clé peut être 0 (pas d'activation) ou 1 (activation). Par défaut, ce mot-clé vaut 1 (activation).
  • CheckPeriod : Période (exprimée en secondes) après laquelle MantaManager vérifie si le serveur s'est arrêté anormalement. Par défaut, 600 secondes (soit toutes les 10 minutes).

Section AUTOANALYSE

La section AUTOANALYSE permet de paramétrer l'optimisation des index en tâche de fond. Cette section peut contenir le mot-clé suivant :
Enabled : Active l'optimisation des index en tâche de fond. La valeur de ce mot-clé peut être 0 (pas d'activation) ou 1 (activation). Par défaut, ce mot-clé vaut 1 (activation).
Si l'optimisation des index en tâche de fond est activée, les index des fichiers de données sont automatiquement optimisés si les conditions suivantes sont réunies :
  • les statistiques du fichier de données n'ont pas été calculées depuis au moins 7 jours.
  • le fichier de données a été créé depuis au moins 1 jour.
  • le nombre d'écritures depuis le dernier calcul de statistiques est supérieur à 1000 (plus 10% du nombre d'enregistrements du fichier).
Si l'optimisation des index est lancée, cette opération n'est pas bloquante.

Section TELEMETRY

La section TELEMETRY permet de paramétrer la mise en place de la transmission des données pour le serveur HFSQL (télémétrie). Il est ainsi possible de participer à l'amélioration du produit installé en autorisant la collecte d'informations relatives à l'utilisation du produit. Cette collecte, facultative et anonyme, permet à PC SOFT d'améliorer les fonctionnalités du produit.
Cette section contient le mot-clé suivant :
Active : Active la transmission des données relatives à l'utilisation du serveur HFSQL. La valeur de ce mot-clé peut être :
  • 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 si 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.

Section ACTIVEDIRECTORY

La section ACTIVEDIRECTORY permet de configurer l'authentification via Active Directory.
Cette section contient les mots-clés suivants :
  • Enabled : Active l'authentification via Active Directory. La valeur de ce mot-clé peut être 0 (pas d'activation) ou 1 (activation).
  • KerberosKeyFile (utilisé uniquement sous Linux) : Chemin vers la "keytab".
Version minimum requise
  • Version 10
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 04/07/2023

Signaler une erreur ou faire une suggestion | Aide en ligne locale