Enabling the Debug Mode

By default, IBM DS3000, DS4000, DS5000 Series KM for PATROL sends only the most critical information, warning and error messages to the System Output Window of the PATROL Consoles. Most often, this information is accurate enough to ensure that IBM DS3000, DS4000, DS5000 Series KM for PATROL is working properly.

If you encounter a problem with the KM and wish to report it to Customer Support, you will be asked to enable the Debug Mode and provide the debug output to the Sentry Software support team. To facilitate the understanding of the debug log content, a separated debug file is created for each monitored system. A generic debug file is also available for reporting on generic information.

The size of the debug logs is unlimited.

To enable the debug mode:

1.	Right-click the main KM icon > KM Commands > KM Settings > Debug...

KMCmd_Debug

Enabling the Debug Mode

2.	Select Enable debug mode.

3.	Enter the path for the debug output file on the local server. When left empty, the debug output will be displayed in the system output window of your console.

4.	Select the Reinitialize option if you wish all the processes associated to the KM to be stopped and to automatically trigger a discovery before generating the debug file.

There could be some loss of debug information by the PATROL console, if debug is enabled just as the PATROL Agent is starting as it is not yet connected to the PATROL Agent. In other cases, or when you want to trace the activity of IBM DS3000, DS4000, DS5000 Series KM for PATROL during a few minutes, some debug information may be lost by the PATROL Console owing to a full buffer.
In such cases, it may help to send the debug output of IBM DS3000, DS4000, DS5000 Series KM for PATROL to a specified file.

The debug file is stored on the computer where the Agent is running.

Pay attention to the file size. The debug output of IBM DS3000, DS4000, DS5000 Series KM for PATROL may rapidly become large if running for several days.