Important

   

This documentation space contains information about PATROL Agents when deployed in a BMC Helix Operations Management environment. If you are a TrueSight Operations Management user, see PATROL Agent 21.02. Open link

Determining the command string to use for the task

Use the following table to find the pconfig command string for the task that you want to perform. For information about the available options, see Determining the option to use for the task.


pconfig command strings

Task to perform

Command string to use

Additional information

Get a PATROL Agent's configuration and save it to a file.

pconfig +get [options] - save filename

[options] available for +get
-host <hostname>
-debug
-lp
-port <portnumber>
+tcp
+verbose
+Defaults
-user (or -u) <secure username>
-password (or -w) <plain-text-secure password>
-timeout

The resultant file contains the change information. That is, this file can be used to re-create the source configuration when applied with the config.default file. The default is stdout.

Note - If the file already exists, the save option appends the new information to the end of the file. When using the host option, you can specify multiple host names. information about multiple hosts is saved to the same file.

Get Help on the options for pconfig.

pconfig -help

This provides a brief description of the available options.

Stop the PATROL Agent.

pconfig +KILL [options]

[options] available for +KILL:
-host <hostname>
-debug
-lp
-port <portnumber>
+tcp
+verbose
-user <secure username>
-password <plain-text-secure password>

This command can be used to stop any agent that is accessible on the network.

Reload the config.default if it has been changed.

pconfig [options] +Reload [+PURGE] filename

[options] available for +Reload
-host <hostname>
-debug
-lp
-port <portnumber>
+tcp
+verbose
-user <secure username>
-password <plain-text-secure password>
-timeout

This option does not remove or modify any changes applied to the configuration; it reapplies the underlying default configuration file and combines it with the changes. The result is a configuration database built from the new default configuration and from the changes that had been applied previously.

You can specify the files to use to create the new configuration. You can use more than one file name separated by a space, or you can use -- for stdin.

Remove the existing configuration from the destination agent and create another one from the config.default file.

pconfig [options] +PURGE [+Reload] filename

[options] available for +PURGE
-host <hostname>
-debug
-lp
-port <portnumber>
+tcp
+verbose
-user <secure username>
-password <plain-text-secure password>
-timeout

None

Restart the PATROL Agent.

pconfig +RESTART [options]

[options] available for +RESTART
-host <hostname>
-debug
-lp
-port <portnumber>
+tcp
+verbose
-user <secure username>
-password <plain-text-secure password>

None

Display the version information of pconfig.

-version

This option provides the version of the pconfig utility.

Was this page helpful? Yes No Submitting... Thank you

Comments