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 22.1. Open link

Using the pconfig utility to modify PATROL Agent configuration variables

The PATROL Agent Configuration File (.cfg) has the following format:

  • PATROL_CONFIG is required at the start of the configuration file.
  • The file can have multiple configuration variables, but the last variable must not have a trailing comma.

Following is a sample configuration file:

PATROL_CONFIG
"Agent_Variable_1" = {REPLACE = "New_Value"},
"Agent_Variable_2" = {REPLACE = "New_Value"},
"Agent_Variable_3" = {REPLACE = "New_Value"},
"Agent_Variable_4" = {REPLACE = "New_Value"
}

The following tasks explain how to use the pconfig command line utility to modify the PATROL Agent configuration variables on UNIX and Windows.

To modify configuration variables on UNIX

  1. Go to the PATROL Agent installation directory and run the following script:
    For Korn and Bourne shell: . ./patrolrc.sh
    For C shell: source .patrolrc
  2. Create the config_file.cfg file and edit the configuration variables as required.
    For example, to modify the value of the /AgentSetup/historyRetentionPeriodconfiguration variable, use the following format:

    PATROL_CONFIG "/AgentSetup/historyRetentionPeriod" = {REPLACE = "7"}
  3. Save the config_file.cfg file.
  4. Apply the changes made in the configuration variable to the PATROL Agent, as follows.

    pconfig +Reload -p <port> -host <hostName> <config_file.cfg>
  5. Verify that the change is made to the configuration variable.

     pconfig +get -p <port> -host <hostName> | grep historyRetentionPeriod

To modify configuration variables on Windows

  1. Create the config_file.cfg file and edit the configuration variables as required.
    For example, to modify the value of the /AgentSetup/historyRetentionPeriodconfiguration variable, use the following format:

     PATROL_CONFIG "/AgentSetup/historyRetentionPeriod" = {REPLACE = "7"}
  2. Save the config_file.cfg file.
  3. Apply the changes made in the configuration variable to the PATROL Agent, as follows:

    pconfig +Reload -p <port> -host <hostName> <config_file.cfg
  4. Obtain the latest configuration information, as follows:

    pconfig +get -p <port> -host <hostName> -save <config_file.cfg>
  5. Verify that the change is made to the configuration variable.
Was this page helpful? Yes No Submitting... Thank you

Comments