Debugging remote XPC

You can enable and disable the debugging at the XPC and library levels for the remote XPC for a remote host.

By default, debugging is disabled and the value for /NUK_LINUX_REMOTE_HOSTS/NUKREM_DBG_FILE pconfig variable is 0.

Enabling debugging for remote XPC

You can store the debug information for the remote XPC in an external file.

To enable debugging for the remote XPC for a remote host

Access the Linux OS application menu for the remote host in the Remote Monitoring container.
Choose KM Commands > Debug and Diagnostics > Remote XPC Debug Admin.
In the NUK Remote Host Debug Admin dialog box, select the Enable XPC Debug check box to start the debugging at XPC level.
Select the Enable Libssh2 TRACE check box to start the debugging at library level.
Enter the absolute path and name of the log file in which you want the KM to store the debug information. For example,/tmp/PukRemoteDebug.txt.
Click Accept.
The log file will be generated in the following format: /tmp/PukRemoteDebug.txt~pid, where pid is the process ID of the running pukremotexec.xpc.

To enable debugging for the remote XPC using pconfig variable

To enable the debug logs, set the following pconfig variable to 1:
/REMOTE_HOSTS/log_level
The logs are created at $PATROL_HOME/log.
Log file name convention: puk_rem.log~<pid>~#
where, <pid> is the process ID of the running pukremotexec.xpc.
and # is a number starting from 1.

OR

Execute the following PSL command from the PATROL Console system output window:
%PSL pconfig("REPLACE","/REMOTE_HOSTS/log_level",1);

Disabling debugging for remote XPC

To disable debugging for the remote XPC for a remote host

Access the Linux OS application menu for the remote host in the Remote Monitoring container.
Choose KM Commands > Debug and Diagnostics > Remote XPC Debug Admin.
In the NUK Remote Host Debug Admin dialog box, clear the Enable XPC Debug check box to stop debugging at XPC level.
Clear the Enable Libssh2 TRACE check box to stop debugging at library level.
To close the generated log file, select the Close debug file check box.
Click Accept.

BMC Software, Inc. offers several PATROL consoles from which you can view a BMC PATROL Knowledge Module (KM). Due to the environments in which these consoles run, each one uses different methods to display and access information in the KM. This appendix provides instructions on how to access the KM menu commands and InfoBoxes, and how to access the online Help for the KM using each of the BMC PATROL consoles.

To disable debugging for the remote XPC using pconfig variable

To disable the debug logs, set the following pconfig variable to 0 and restart the PATROL Agent:
/REMOTE_HOSTS/log_level

Execute the following PSL command from the PATROL Console System Output Window and restart the PATROL Agent:

%PSL pconfig("REPLACE","/REMOTE_HOSTS/log_level",0);