Debugging - License Server Variables

APPX_LS_DBG

Specifies the debug level for license server issues. If you experience license server problems, set this to 0xFFFFFFFF. Debug information for the “appx -l=” license server process will be written to the file named after the “-l=”, and debug information for clients attempting to obtain session licenses will appear in APPX_LS_LOG, if it is set. You must kill and restart the license server process in order for this variable setting to affect it. Setting this variable after the license server is running will not cause it to log anything. Warning: license server logging can issue many messages, so pay attention to the size of your log file when you have this variable set. You can fill up your disk more quickly than you think.

Valid values: hex numbers between 0x00000000 and 0xFFFFFFFF

Default value: 0x00000000

APPX_LS_DELAY

Specifies the number of seconds to wait after starting the license server before an APPX session validates its license information. If you receive a “no license server detected” error message upon starting APPX, set this variable to a larger number than the default value. This will avoid that error message, at a slight performance cost.

Valid values: integers

Default value: 5 (Unix) or 8 (Windows)

APPX_LS_GHOSTS

Clears out “ghost” sessions from the 0SA USAGE file. “Ghost” sessions are still listed in the USAGE file, but their actual APPX processes no longer exist. This can happen any time an APPX session is abnormally ended. Aggressively pursuing the removal of these on busy systems results in excessive contention for USAGE locks, so this variable is now disabled as a default.

If a site has no problems with USAGE locks, and would like to re-enable the algorithm that clears “ghosts”, set this variable to 1 for that site. Their display of license users will then more closely match reality. Having this variable disabled can result in the buildup of a large number of entries in the USAGE file, which can reduce system performance.

It is necessary to restart your license server for this variable to take effect.

Valid values: 1

Default value: not set

APPX_LS_INTERVAL

Specifies the number of minutes between checks of USAGE file information. Sometimes performance on busy systems can be improved by setting this to a larger number than the default value. Do not set this variable to a number greater than 10 minutes.

Valid values: integers

Default value: 2

APPX_LS_LOG

Specifies where license server client debugging information should be written. In older releases of APPX (early 3.x) this variable was used to specify the server log file location as well. However, all license server debugging information is now written into the log file named after “-l=” on the license server command line. See the variable APPX_LS_DBG for additional information.

Valid values: path to a write-enabled log file

Default value: not set