Child pages
    • Defining a configuration variable
    Skip to end of metadata
    Go to start of metadata

    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.

    Note

    To view configuration variables available in previous BMC PATROL Agent versions, use the Query Agent functionality available in the operator console or Central Monitoring Administration. To edit the configuration variables available in the previous versions, see To edit a configuration variable.

    Before you begin

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

    To create a configuration variable

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

    Note

    If you are modifying the Default account configuration, you must restart the BMC PATROL Agent to reflect the changes.

    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.

    Note

    BMC recommends that you do not create a policy with both monitoring configuration and a configuration variable. You can create separate policies for monitoring configuration and configuration variables. See also Configuring a monitor.

    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 keep the BMC PATROL Agent in sync with the policy configuration, change an existing configuration variable's operation to DELVAR, instead of deleting it.

    Once a configuration variable is deleted from the policy, it is not possible to perform actions on it through Central Monitoring Administration.

    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.

    Note

    If the ruleset file is in a non-English language, ensure that the file is encoded in the UTF-8 format. The import process does not support the non-English ruleset files that are encoded in the ANSI format.

    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.

    • No labels