ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

This content has been translated automatically.  Click here  to view the French version.
Help / WLanguage / Managing databases / HFSQL / Managing HFSQL Client/Server
  • Overview
  • Content of HFConf.Ini file
  • INIT section
  • MANAGER section
  • AUTOANALYSIS section
  • TELEMETRY section
  • ACTIVEDIRECTORY section
WINDEV
WindowsLinuxJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac Catalyst
Others
Stored procedures
Overview
The HFConf.INI file is found at server root. This file is used to define several characteristics of HFSQL Client/Server server.
This file is also used to specify the characteristics of log files created on the server. The log files are text files whose items are separated by TAB characters. The first file line contains the definition of columns. The log files are created by HFLogger.exe (hflogger in Linux).
Content of HFConf.Ini file
The HFConf.INI file contains several sections:
  • The INIT section that is used to perform different initializations.
  • The MANAGER section, used in Linux only.
  • The AUTOANALYSIS section that is used to configure the optimization of indexes in background task.
  • The TELEMETRY section that is used to configure the transmission of data to PC SOFT in order to improve the product (telemetry).
  • The ACTIVEDIRECTORY section that is used to configure the authentication via Active Directory.

INIT section

The INIT section can contain the following keywords:
KeywordDescriptionDefault value
AccessPort Network port used.4900
ActivityStatisticMaxFileSizeMaximum size of the file for activity statistics (MB).
This value must be greater than or equal to 1 otherwise no modification is performed.
The statistics are saved and reinitialized.
ActivityStatisticPathPath of files for activity statistics. The path is created on the server if it does not exist.
The statistics are saved and reinitialized.
ActivityStatisticPeriodPeriod (in seconds) between each backup of values for the different activity counters.
This value must be greater than or equal to 1 otherwise no modification is performed.
The statistics are saved and reinitialized.
BackupDirectoryPath of the directory in which backups will be made. The path is created on the server if it does not exist.
CacheMaxUnusedFilesMaximum number of unused HFSQL tables that are stored in cache (which means opened) on the server. When this number is reached, the less recent unused table is automatically deleted from the cache.
CacheFilesPrefetchConfigures the automatic fill for the cache of tables.
The possible values are:
  • 1: Automatic filling activated.
  • 0: Automatic filling inactive.
0, automatic fill of table caches disabled
DBRootPathPath of directory containing all databases (which means the data files of different HFSQL Client/Server applications).
To specify the directory of Manta service, simply use "%%EXE%%".
"%%EXE%%DB" ("DB" subdirectory of directory of Manta service)
DaemonUser
Linux only
Username that will be used by the server."root"
JNLBackupRootPathPath of backup directory for the logs. This path is automatically created if it does not exist when restarting the server."__JNLBackup" subdirectory of directory containing all the data files
JNLRootPathPath of the directory containing all the logs of different HFSQL Client/Server applications (history of write operations performed in the HFSQL data files). All the logs will be found in the "__JNL" subdirectory of specified directory.
For example, if the specified directory is "C:\Mydir", the logs will be found in the "C:\MyDir\__JNL" directory.
We advise you to modify the default path of logs for security reasons. Indeed, if a technical problem occurs on the hard disk containing the data, you will be able to replay the log (saved on another disk) from a backup.
To specify the directory of Manta service, simply use "%%EXE%%".
"__JNL" subdirectory of directory containing all data files
KeepAliveIntervalMaximum time (in seconds) after which, if no communication is established between the server and the client, the server will check the presence of client.30 minutes
KeepAliveTimeOutMaximum timeout (in seconds) for the server when checking the presence of client. If the client is not found at the end of this timeout, the client is automatically disconnected.2 minutes
KeySearchEnable the search for keys.
The possible values are:
  • 0: Automatic key search inactive,
  • 1: Automatic key search enabled.
0, automatic search for keys is disabled.
LoadCoeffCallGlobal coefficient for the number of client calls.
This value (included between -100 and 100) increases or reduces the coefficient applied to the counter for the client calls to the server.
The coefficients are used to modify the importance of each counter in the formula for calculating the load generated by a user on the server.
A value equal to 1, 0 or -1 does not modify the coefficient.
A value greater than 100 is equivalent to 100.
A value less than -100 is equivalent to -100.
LoadCoeffDiskGlobal coefficient for the number of bytes read or written on disk.
This value (included between -100 and 100) increases or reduces the coefficient applied to the counter for the bytes read or written on disk by the server.
The coefficients are used to modify the importance of each counter in the formula for calculating the load generated by a user on the server.
A value equal to 1, 0 or -1 does not modify the coefficient.
A value greater than 100 is equivalent to 100.
A value less than -100 is equivalent to -100.
LoadCoeffDiskAccessGlobal coefficient for the number of accesses to the disk.
This value (included between -100 and 100) increases or reduces the coefficient applied to the counter for the number of accesses to the disk.
The coefficients are used to modify the importance of each counter in the formula for calculating the load generated by a user on the server.
A value equal to 1, 0 or -1 does not modify the coefficient.
A value greater than 100 is equivalent to 100.
A value less than -100 is equivalent to -100.
LoadCoeffRecvGlobal coefficient for the number of bytes received on the network.
This value (included between -100 and 100) increases or reduces the coefficient applied to the counter for the bytes received by the server.
The coefficients are used to modify the importance of each counter in the formula for calculating the load generated by a user on the server.
A value equal to 1, 0 or -1 does not modify the coefficient.
A value greater than 100 is equivalent to 100.
A value less than -100 is equivalent to -100.
LoadCoeffSendGlobal coefficient for the number of bytes sent over the network.
This value (included between -100 and 100) increases or reduces the coefficient applied to the counter for the bytes sent by the server.
The coefficients are used to modify the importance of each counter in the formula for calculating the load generated by a user on the server.
A value equal to 1, 0 or -1 does not modify the coefficient.
A value greater than 100 is equivalent to 100.
A value less than -100 is equivalent to -100.
LoadEnableIndicates whether the load balancing is enabled (True) or not (False)
LoadMaxWaitMaximum time (in ms) during which a request to the server can be temporarily stopped by the system for load balancing before it is processed.
LogConnectionUsed to add information to the system log files whenever a client connects to the server.
This keyword can be set to 0 (no addition) or 1 (addition allowed).
0 (no addition)
New in SaaS
ManagerHistoryOptimEnable
Keeps track of optimization history (re-indexing, etc.).
The value of this keyword can be 0 (history not activated) or 1 (history activated).
1 (history activated)
MaximumConnectionsNumberMaximum number of connections allowed per application. The number of connections is determined by the number of applications (processes) with at least one non-superuser connection on the server. For example:
  • an application that has opened a single connection in super-user mode counts as zero.
  • an application that has opened a single connection with a normal user counts as 1.
  • an application that has opened two connections of a normal user counts as 1.
  • an application that has opened superuser and normal user connections counts as 1.
If the value of this keyword is 0, there is no limit.
0, no limit.
MoreThan2GBIndicates whether system files support more than 2 GB.
This keyword can be set to 0 (No) or 1 (Yes).
0 (no)
NdxCacheSizeSize of the index cache (MB).
This size must be greater than 1.
Note: on a 32-bit server, this parameter cannot exceed 1 GB.
New in version 2025
ScheduledHistoryMaxValues
Maximum number of executions to be kept in the scheduled execution history.
The default limit is 100,000.
0, no limit.
ServerLanguageSet HFSQL server language.
This parameter corresponds to one of the following values:
  • FR: the server language is French.
  • US: server language is English.
  • ES: server language is Spanish. |
ServerLogLevelsDefines the elements that must be in the log file.
The possible parameters are "WL" and "PARAM", separated by a comma:
  • "WL": allows you to log calls to the server.
  • "PARAM": allows logging the call parameters in the log file.
No log file will be created
ServerLogPathLocation of the audit log files of the server (set of operations requested by the client computers to the server).
The path is created on the server if it does not exist.
"%%EXE%%\Logs" ("Logs" subdirectory of directory of Manta service)
ServerLogMaxSizeMaximum size of a log file (in MB).
This size must be greater than 1.
20 MB
TmpPathPath of temporary directory. This directory can be used, for example, to create temporary files when reindexing large data files.
WindowsFileCacheSizeConfigures the management of Windows disk caches.
The possible values are:
  • -1 for a size that is automatically calculated,
  • 0 for an unlimited cache size,
  • a positive value is used to define a custom cache size.
Note: Windows' standard disk cache management in 64-bit mode (independent of HFSQL) can lead to memory saturation.. This option is used to customize the management of memory caches.
-1
WLDebugPortPort used to debug the stored procedures and the Client/Server triggers.27281
Note: In directory paths, you can use %%COMMONAPPDATA%%:
  • Under Windows, the directory obtained corresponds to that obtained by the SysDir function (syntax: SysDir(srAppDataCommon)).
  • In Linux, the directory is "/var/lib/".
WINDEVWEBDEV - Server codeLinux

MANAGER section

The MANAGER section is used in Linux only. This section can contain the following keywords:
  • RestartOnFailed Enables server restart after a fatal error. This keyword can be set to 0 (no activation) or 1 (activation). By default, this keyword is set to 1 (activation).
  • CheckPeriod Period (in seconds) after which MantaManager checks whether the server has stopped abnormally. 600 by default (which means every 10 minutes).

AUTOANALYSIS section

The AUTOANALYSIS section that is used to configure the optimization of indexes in background task. This section can contain the following keyword:
Enabled Enables background index optimization. This keyword can be set to 0 (no activation) or 1 (activation). By default, this keyword is set to 1 (activation).
If the optimization of indexes in background task is enabled, the indexes of the data files are automatically optimized if the following conditions are fulfilled:
  • the statistics have not been calculated for the data file since at least 7 days.
  • the data file was created since at least 1 day.
  • the number of writes since the last statistics calculation is greater than 1000 (more than 10% of the number of records in the data file).
If the optimization of indexes is enabled, this operation is not a locking operation.

TELEMETRY section

The TELEMETRY section is used to configure the implementation of data transmission for the HFSQL server (telemetry). You can help us improve the product installed by allowing us to collect information regarding the use of product. This optional and anonymous collect allows PC SOFT to improve the product features.
This section contains the following keyword:
Active: Enables transmission of HFSQL server usage data. The value of this keyword can be:
  • 1 if the transmission of data (telemetry) was enabled when installing the HFSQL server,
  • 0 if the transmission of data (telemetry) was refused when installing the HFSQL server.
  • another value if no choice was made during the setup regarding the use of telemetry. The question will be asked again during the next setup of HFSQL server.
Note: If the "TELEMETRY" section does not exist in the HFConf.ini file, transmission of product usage data is not enabled for the HFSQL server.

ACTIVEDIRECTORY section

The ACTIVEDIRECTORY section is used to configure the authentication via Active Directory.
This section can contain the following keywords:
  • Enabled Enables Active Directory authentication. This keyword can be set to 0 (no activation) or 1 (activation).
  • KerberosKeyFile (only used under Linux): Path to keytab.
Minimum version required
  • Version 10
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 03/30/2025

Send a report | Local help