Type
  • Best practice
Description
  • This article explains how to enable debug for the Hardware Sentry KM via the command-line interface.
Additional Keywords
  • Debug

Related Topics

Knowledge Base

Enabling Debug from the Command-line Interface

KB1159 - Nov 18, 2014

Description

For various reasons, you may want to enable the debug mode for the Hardware Sentry KM via the command-line interface. This article explains the procedure to follow

Note: The preferred method for enabling the debug mode is either through the PATROL console or through the BMC ProactiveNet Central Monitoring Administration.

Procedure

In a PATROL Environment

  1. Create a text file (for example, debug_patrol.txt) that contains the following lines:
    PATROL_CONFIG
    "/SENTRY/HARDWARE/debugEndTime" = { REPLACE = "2014/10/30 11:00:00" },
    "/SENTRY/HARDWARE/debugMode" = { REPLACE = "1" },
    "/SENTRY/HARDWARE/automaticReinitialization" = { REPLACE = "1" }

    Note: The value of the debugEndTime must indicate the time at which the system must stop logging debug information to the log file. 2014/10/30 11:00:00 means that debug will end at 11:00 AM on October 30th, 2014.

  2. In your PATROL console, right-click the Hardware Sentry main icon and select System Output Window.
  3. Run the following commands:
    • pconfig -host <hostname> -p <port> debug_patrol.txt to load the debug configuration on the PATROL Agent
    • pconfig +RESTART -host <hostname> -p <port> for the change to take effect immediately
    Example:
    pconfig -host babbage -p 3184 c:\debug_patrol.txt
    pconfig +RESTART -host babbage -p 3184
  4. Wait for the debug to finish to collect the debug log files available on the machine where the PATROL agent is installed, in the PATROL_HOME/log directory:
    • SEN_CollectionHub_debug_psl_<port>_<date>-<time>.log
    • SEN_CollectionHub_debug_java_<port>_<date>-<time>.log
    • MS_HW_global_debug_km_<port>_<date>-<time>.log
    • All the MS_HW_<hostname>_debug_km_<port>_<date>-<time>.log  files (there is one log file per monitored system)

    If PATROL Agent is managed through a BPPM policy

  1. Create a text file (debug_bppm.txt  in this example) that contains the following lines:
    PATROL_CONFIG
    "/ConfigData/MS_HW_MAIN/debugEndTime" = { REPLACE = "2014/10/30 09:55:00" },
    "/ConfigData/MS_HW_MAIN/debugMode" = { REPLACE = "1" },
    "/ConfigData/MS_HW_MAIN/automaticReinitialization" = { REPLACE = "1" }

    Note: The value of the debugEndTime must indicate the time at which the system must stop logging debug information to the log file. 2014/10/30 11:00:00 means that debug will end at 11:00 AM on October 30th, 2014.

  2. In your PATROL console, right-click the Hardware Sentry main icon and select System Output Window.
  3. Run the following commands:
    • pconfig -host <hostname> -p <port> debug_patrol.txt to load the debug configuration on the PATROL Agent
    • pconfig +RESTART -host <hostname> -p <port> for the change to take effect immediately
    Example:
    pconfig -host babbage -p 3184 c:\debug_patrol.txt
    pconfig +RESTART -host babbage -p 3184
  4. Wait for the debug to finish to collect the debug log files available on the machine where the PATROL agent is installed, in the PATROL_HOME/log directory:
    • SEN_CollectionHub_debug_psl_<port>_<date>-<time>.log
    • SEN_CollectionHub_debug_java_<port>_<date>-<time>.log
    • MS_HW_global_debug_km_<port>_<date>-<time>.log
    • All the MS_HW_<hostname>_debug_km_<port>_<date>-<time>.log  files (there is one log file per monitored system)