Enabler Logging

Home > Support > FAQ > Enabler Logging

Enabler logs every critical part of it's operation, including all non-idle communication with pumps and tank gauges. ITL uses these logs to diagnose problems. They are critical to our support since there are so many different situations in the world with pump variants that we cannot reproduce here on the pump computers we have.

The log files are intended mainly for ITL support. While you are free to read them we do not recommend trying to interpret their meaning by yourself.

Log files are stored in the C:\Enabler\Log\ folder. This location is currently fixed.

Each logical log is actually broken up into numbered files to make them easier to work with. For example, the pump server's main log consists of files named psrvr_X.log, where X is a number starting from 0. The higher the number, the older the file. The following log files are created by a typical Enabler pump server:

Psrvr_X.log: The main pump server log file
db_X.log: Database activity
loopA_X.log: Pump driver communications logs. A is a number 1 to 6.
tankgauge_X.log: Tank Gauge communications

The following additional log files may be created, and can appear on client computers as well.

enbsessx.log: Logs from the EnbSessionX ActiveX control.
VBErrors.log: Logs from the Enabler applications (e.g. Configuration).

Example Log Folder

Directory of C:\enabler\log
[.]               [..]              db_0.log          db_1.log
db_2.log          db_3.log          db_4.log          db_5.log
db_6.log          db_7.log          db_8.log          db_9.log
enbsessx.log      loop1_0.log       loop1_1.log       loop1_2.log
loop1_3.log       loop2_0.log       loop2_1.log       loop2_10.log
loop2_11.log      loop2_12.log      loop2_13.log      loop2_14.log
loop2_2.log       loop2_3.log       loop2_4.log       loop2_5.log
loop2_6.log       loop2_7.log       loop2_8.log       loop2_9.log
loop3_0.log       loop3_1.log       loop3_2.log       loop4_0.log
loop5_0.log       loop5_1.log       loop6_0.log       psrvr_0.log
psrvr_1.log       psrvr_2.log       psrvr_3.log       psrvr_4.log
psrvr_5.log       psrvr_6.log       psrvr_7.log       psrvr_8.log
psrvr_9.log       tankgauge_0.log   tankgauge_1.log   tankgauge_2.log
tankgauge_3.log   tankgauge_4.log   tankgauge_5.log   tankgauge_6.log
tankgauge_7.log   tankgauge_8.log   tankgauge_9.log   VBErrors.log
              58 File(s)     93,520,574 bytes

Sending Logs to ITL

If you have any kind of problem with Enabler, it's best to send the Enabler log files. Send all the log files, and compress them into a zip file before sending.

Space Used by Logs

Until 2006, each log consisted of 10 files of 1.4MB each. For example, for the log "psrvr" there would be files psrvr_0.log, psrvr_1.log, psrvr_2.log ... psrvr_9.log, and each file would be 1.4MB. A typical site would have around 100MB of log files, which would compress down to around 5MB.

In 2006 we added configurability to the Enabler logging, and increased the size of individual files to 2MB.

The default settings now keep files for 7 days if possible, up to a maximum of 50 files (100MB) per log. The total size of all logs might be around 200MB.

We recommend you leave the log settings at the defaults unless you have a specific reason to want more log files.

Configuring Logging

Recent versions of Pump Server and Pump Drivers will read settings for logging from the file:

c:\enabler\itlintegrate.ini

For each log (e.g. psrvr), the settings are:

[Log:<Name>]
MAXMB=X
MINDAYS=Y

Name is the name of the log. These can be psrvr, loop1, loop2, loop3, loop4, loop5, tankgauge, or psrvr_db.

MINDAYS controls the minimum days worth of logs to keep, up to MAXMB. Log files older than this will be deleted, even if MAXMB has not been reached. Default is 7.

MAXMB Specifies the maximum total size of files for this log, in MB. The individual file size is still fixed at 2MB, so this setting controls the number of individual files per log. For example if you specify MAXMB=300 then up to 150 files can be created. It can be from 20 to 2000 (2GB). The default is 100.

There will always be a minimum of 2 files or 1 day kept.

How to use the Settings

If you need to keep log files for a long time to capture some problem that occurs rarely on a site, then set the MINDAYS to more than the longest time between the problem and collecting the log files from the site. You should also increase MAXMB to a large number so that it won't limit the number of files.

Example