Collecting troubleshooting information to provide to HCL Support

The SafeLinx Support Utility command collects information to assist HCL Support in resolving existing HCL SafeLinx product support cases. The command collects information about the current SafeLinx Server configuration, along with diagnostic data, such as traces and system dumps in a file, which you then upload to the HCL Support site.

SafeLinx Support files

The SafeLinx Support command collects support information from several file types. Most of these files are created in the /logs directory in the SafeLinx installation folder (for example, /var/adm/logs/). The following types of support files are available:
wg.log
SafeLinx Server log
wg.trace
SafeLinx Server trace
wgmgrd.log
Access Manager log
wgmgrsd.log
Secure Access Manager log
*.backtrace
Process troubleshooting information
*.dmp
Windows process image. You can find more information about Windows process images later in this topic.
*.core
Linux process image. When necessary, HCL Support provides instructions on how to generate a process image for Linux after you report an incident.

Running the SafeLinx Support utility to collect support files

The SafeLinx Support command is installed in the SafeLinx/bin directory on the SafeLinx Server node. You start the SafeLinx Support command by entering the safelinxsupport command in a console or command window from any SafeLinx Server directory. The command supports a single option, case, which has a value of case_number, which is the number of an existing product support case that you previously obtained from HCL Support.

The utility assembles a support archive in the SafeLinx /logs directory with the name case_number_safelinxsupport_yyyymmdd_hhmm.zip. For example, from a Windows command prompt, you would type the command in the following format:

safelinxsupport case CS12345678

From a Linux command window or console, you would type the same command in the following format:

safelinxsupport.sh case CS12345678

Uploading the file to the HCL Support site

For information on how to load the support file to the HCL Support site, see this article: HTTPS and SFTP upload and download instructions.

If you require more help that is related to HCL Support Service requests, refer to the HCL Service requests and Support page at https://support.hcltechsw.com/csm.

Troubleshooting

If the HCL SafeLinx gateway on a Windows server becomes unresponsive, you can generate a Windows process image file to report the problem to HCL Support. To create the process image file, first create the file wg.dodmp in the SafeLinx \logs directory. For example, you can create the file by entering the following command at a command prompt:

echo 1 >C:\Program Files\HCL\SafeLinx Server\logs\wg.dodmp

Approximately 1 minute after you create the file, an image file is generated in the \logs directory with the name wgated-yyyymmdd-hhmmss-pid-tid.dmp. After the process image is created, use the methods that are mentioned earlier to report the incident to HCL Support