Defining a configuration variable

The BMC PATROL Agent configuration is saved in a set of configuration variables that are stored in the agent's configuration database. You can control the BMC PATROL Agent configuration by changing the values of these configuration variables. You can use the Configuration Variable option on the Add Policy window to configure the Knowledge Modules (KMs) that are not supported by Central Monitoring Administration or update the existing configuration variables.

Also, you can define a configuration variable, and the definitions are set on BMC PATROL Agent when the policy is applied.

To create a configuration variable

Perform the following procedure to create or edit a configuration variable.

1. On the Configuration Variables page, click Add .
2. In the Add Configuration Variable dialog box, perform the following tasks:

   1. In the Variable box, specify a name for the configuration variable.

      The variable names are case sensitive and must start with slash (/). You must enter the complete path for the variable, not just the name. If the intermediate variables do not exist, the variables are created.

   2. In the Operation list, select the operation that you want to perform on the configuration variable. The supported operations are as follows:
      • REPLACE—Replaces the current value of the variable on the BMC PATROL Agent if the variable already exists. If the variable does not exist, a new variable is created with the specified value.
      • DELVAR—Deletes the variable from the BMC PATROL Agent
      • DELETE—Deletes the value of the variable, and the variable remains empty.
   3. In the Value box, specify the value that you want to configure for the variable.
      • For the defaultAccount configuration variable, specify the value in the userName/password format. Note that the password can be a plain text or a BMC PATROL Agent-encrypted string.
        
        Examples:
        patrol/patAdm1n
patrol/FA4E70ECEAE09E75A744B52D2593C19F
      • For the SecureStore configuration variable, specify the value in the context/data format. Note that the context and data can be a plain text or a BMC PATROL Agent-encrypted string.
        
        Examples:
        MY_KM1;MY_KM2;MY_KM3/mysecretdata 
“EDC10278901F8CB04CF927C82828595B62D25EC355D0AF38589CE4235A246F8C63F24575073E4ECD”
        
        where “EDC10278901F8CB04CF927C82828595B62D25EC355D0AF38589CE4235A246F8C63F24575073E4ECD” is the encrypted form of "MY_KM1;MY_KM2;MY_KM3/mysecretdata"
3. Click Add.
4. To add more configuration variables, repeat step 2 through step 3.
5. After you complete adding configuration variables, click Close.
6. Click Finish.

To edit a configuration variable

1. On the Configuration Variables page, in the Defined Configuration Variables table, select a configuration variable that you want to edit.
2. Click Edit .
3. In the Edit Configuration Variable dialog box, edit the values.
4. Click Update.

To delete a configuration variable

1. On the Configuration Variables page, in the Defined Configuration Variables table, select a configuration variable that you want to delete.
2. Click Delete.
3. In the Confirm Delete dialog box, click Yes.

To import a ruleset file

You can import a configuration variable from a ruleset file (.cfg). The import operation supports only REPLACE, DELETE, and DELVAR operators. If the .cfg file contains the MERGE or APPEND operators, the file cannot be imported, and you must delete the operators before importing the file.

Perform the following steps to import the configuration variable:

1. On the Configuration Variables page, click Import .

2. Navigate to the location of the .cfg file, select the file, and click Open.