Capturing Log File Diagnostics

This task describes how to gather basic system information. With it, you can gather system information as well as to generate debug information for different components of the PATROL Knowledge Module for UNIX and Linux.

To Capture UNIX Diagnostic Information

1. Access the UNIX OS application menu as described in Accessing KM Commands and InfoBoxes.
2. Select Debug and Diagnostics > Capture UNIX Diagnostics.
   BMC PATROL displays the Select Categories of Diagnostics dialog box. To view an example, see Select Categories of Diagnostics dialog box.
3. Select the Log Files check box.
4. Place the cursor in the Output File for Diagnostics field and type the path and file name to which you want the diagnostic information written.
5. Click Accept.
   BMC PATROL displays the Select Log Files to Collect dialog box.
   
   Select Log Files to Collect Dialog Box
   

6. Select the check boxes of the log files that you want BMC PATROL to capture. Following table lists the options in the order that they appear in the dialog box.

   Select Log Files to Collect Options

   Options	Description
   All Logs Contained in $PATROL_HOME/log	Gathers log information from all the log files stored in the BMC PATROL log directory
   Agent Error Log	Gathers log information the BMC PATROL Agent
   DCM Debug Log	Gathers log information from the Data Collection Manager executable used in the DCM collection method
   apidll Log	Gathers log information from the C library loaded by the BMC PATROL Agent during runtime so that it can read and write to FIFO
   bgscollect Log	Gathers log information from the bgscollect executable, which accesses the kernel, retrieves the requested data, and writes it to the shared memory segment
   MrConsumer Log	Gathers log information from the MrConsumer library, which is used by DCM to read the data from the shared memory segment written by bgscollect executable

7. Click Accept.
   BMC PATROL writes some of the information to a task object (Capture UNIX Diagnostics) in the UNIX OS container. BMC PATROL writes the entire contents of all the log files that you selected to the .tar file that you specified.