ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

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
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
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.
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 fill enabled.
  • 0: Automatic fill disabled.
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
User name 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 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 search for inactive keys,
  • 1: Automatic search for active keys.
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)
MaximumConnectionsNumberMaximum number of connections allowed per application. This number is determined by the number of applications (processes) with at least one non-super-user 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 connections as super-user and normal user counts as 1.
If the value of this keyword is 0, there is no limit.
0, no limit.
MoreThan2GBIndicates whether the 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.
Remark: on a 32-bit server, this parameter cannot exceed 1 GB.
ServerLogLevelsDefines the elements that must be found in the log file.
The possible parameters are "WL" and "PARAM", separated by a comma:
  • "WL": the calls to the server will be included in the log file.
  • "PARAM": the parameters of the calls will be included 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 to create temporary files when reindexing large data files for example.
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.
Remark: The standard management of Windows disk caches in 64-bit mode (independently from HFSQL) can create 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
Remark: In the directory paths, you have the ability to use %%COMMONAPPDATA%%:
  • In Windows, the directory corresponds to the one returned by SysDir (syntax: SysDir(srCommonAppData)).
  • 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: Restarts the server when a fatal error occurs. 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 was stopped properly. 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 the optimization of indexes in background task. 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 write operations since the last statistical calculation is greater than 10000 (plus 10% of the number of file records).
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 the transmission of data regarding the use of HFSQL server. 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.
Remark: If the "TELEMETRY" section does not exist in the HFConf.ini file, the transmission of data regarding the use of product 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 the authentication via Active Directory. This keyword can be set to 0 (no activation) or 1 (activation).
  • KerberosKeyFile (used in Linux only): Path to "keytab".
Minimum version required
  • Version 10
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 09/07/2023

Send a report | Local help