LKSUPPORT

LKSUPPORT.CMD, found in the %LKROOT%/SUPPORT directory, is used to collect important configuration information and event log files and put them in a zip file. SIOS Support Engineers will commonly request this zip file as part of the Support process. To run this utility, simply double-click LKSUPPORT and the zip file will be created in the same Support directory.

ENABLE_CRASH_DUMPS

LKSUPPORT will retrieve core LK process dumps if any have occurred. These dumps are stored in the folder %LKROOT%/SUPPORT/ProcessDumps. The generation of process dumps can be controlled by the variable ENABLE_CRASH_DUMPS in the %LKROOT%\etc\default\LifeKeeper file. By default, this value is “1” - setting it to 0 will disable process dump collection. The value is evaluated when LifeKeeper starts - after changing the value, either restart LifeKeeper or run the utility %LKROOT%\admin\bin\ConfigureDumps.pl. To run the utility manually, start a Windows CMD prompt and run the following:

%LKBIN%\perl %LKROOT%\admin\bin\ConfigureDumps.pl

Dump generation is controlled by registry values in the following key:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\Windows Error Reporting\LocalDumps

A subkey for each LifeKeeper core process is added to this key when ENABLE_CRASH_DUMPS is set to 1. The default values in each process key are:

• DumpType (REG_DWORD): 2 (full process dump)
• DumpCount (REG_DWORD): 0xa (10 dump files maximum in the DumpFolder)
• DumpFolder (REG_EXPAND_SZ): %LKROOT%\Support\ProcessDumps

The values can be modified as needed and will not be updated by ConfigureDumps.pl.

All LifeKeeper process entries are removed from the registry when ConfigureDumps.pl is executed with ENABLE_CRASH_DUMPS set to 0. This disables future creation of process dump files, but any existing dump files are left in %LKROOT%\support\ProcessDumps. The %LKROOT%\support\ProcessDumps file can be safely deleted at any time, to prevent the inclusion of dumps in lksupport zip files.