Defining configuration variables

The PATROL Agent configuration is saved in a set of configuration variables that are stored in the agent's configuration database. You can control the 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 PATROL Agent when the policy is applied.

This topic covers the following tasks:

• • Before you begin
  • To create a configuration variable
  •  To edit a configuration variable
  • To delete a configuration variable
  • To import a ruleset file
  • Related topics

Before you begin

If you have not done so already, perform the steps provided under the following sections:

• Defining general policy details
• Selecting an agent

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.

      Note

      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 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 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 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 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.

Related topics

Configuring-a-monitor

Configuring-filter-options

Configuring-PATROL-Agent-thresholds

Configuring-a-server-threshold

Configuring-a-PATROL-Agent

Specifying-server-configuration