Enabling Debug from the Command-line Interface

  • kb1159
  • Nov. 18, 2014
  • 2 min read

How to enable debug for the Hardware Sentry KM via the command-line interface.

Best practice Debug

Related Topics

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)
Best practice Debug