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.
Recent versions of Pump Server and Pump Drivers will read settings for logging from the file:
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.