PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE


  • 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/iPadApple WatchUniversal Windows 10 AppWindows Mobile
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).
Remarque : A partir de la version 19, HFSQL est le nouveau nom de HyperFileSQL.
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.
  • Versions 18 et supérieures
    La section AUTOANALYSE qui permet de paramétrer l'optimisation des index en tâche de fond.
    Nouveauté 18
    La section AUTOANALYSE qui permet de paramétrer l'optimisation des index en tâche de fond.
    La section AUTOANALYSE qui permet de paramétrer l'optimisation des index en tâche de fond.
  • Versions 22 et supérieures
    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).
    Nouveauté 22
    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 TELEMETRY qui permet de configurer la transmission des données à PC SOFT en vue de l'amélioration du produit (télémétrie).
  • Versions 23 et supérieures
    La section ACTIVEDIRECTORY qui permet de configurer l'authentification via Active Directory.
    Nouveauté 23
    La section ACTIVEDIRECTORY qui permet de configurer l'authentification via Active Directory.
    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.
Versions 21 et supérieures
CacheMaxUnusedFiles
Nouveauté 21
CacheMaxUnusedFiles
CacheMaxUnusedFiles
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 21 et supérieures
CacheFilesPrefetch
Nouveauté 21
CacheFilesPrefetch
CacheFilesPrefetch
Configure 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
Versions 23 et supérieures
KeepAliveInterval
Nouveauté 23
KeepAliveInterval
KeepAliveInterval
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.30 minutes
Versions 23 et supérieures
KeepAliveTimeOut
Nouveauté 23
KeepAliveTimeOut
KeepAliveTimeOut
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é.2 minutes
Versions 22 et supérieures
KeySearch
Nouveauté 22
KeySearch
KeySearch
Activation 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)
Versions 24 et supérieures
MaximumConnectionsNumber
Nouveauté 24
MaximumConnectionsNumber
MaximumConnectionsNumber
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 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
Versions 17 et supérieures
TmpPath
Nouveauté 17
TmpPath
TmpPath
Chemin 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.
Versions 19 et supérieures
WindowsFileCacheSize
Nouveauté 19
WindowsFileCacheSize
WindowsFileCacheSize
Configure 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
Versions 16 et supérieures
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/".
Nouveauté 16
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/".
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).
Versions 18 et supérieures

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.
Nouveauté 18

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 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.
Versions 22 et supérieures

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.
Nouveauté 22

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 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.
Versions 23 et supérieures

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".
Nouveauté 23

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".

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