Configuring failover nodes by using the PATROL Configuration Manager menu commands

This section explains how to use the PATROL Configuration Manager menu commands to configure failover nodes.

To configure failover nodes by using the PATROL Configuration Manager menu commands

1. In PATROL Configuration Manager, right-click the agentHostName from where you are monitoring the Integration Service.
2. Right-click agentHostName and select Configuration > Get.
    The account status is displayed in the Job Status Information dialog box. When PATROL Configuration Manager completes the transfer of the configuration variables from the selected host, the line that represents the host becomes green and OK is displayed in the Status field for the host.
    The Configuration > Get command copies the pconfig variables from the Agent, converts them into rules, and pastes them into PATROL Configuration Manager in the following folder:
   
   RuleSets\PCM\backup\agentHostName\agentHostName\date-timestamp
   
   The following figure shows the Configuration > Get menu command in the left panel of the PATROL Configuration Manager. An example of the rules is displayed in the right panel after the Configuration > Get command finishes importing the configuration variables from the Agent. Each rule in PATROL Configuration Manager contains a configuration variable. A RuleSet is the entire set of rules for an Agent.
3. Select the directory with the most recent timestamp, at the bottom of the list.
4. To add a failover node, complete the following steps:
   1. Right-click the directory with the most recent timestamp and select New Rule.
   2. In the RuleSet dialog box, double-click the highlighted space in the Variable column and add the following variable:
      /PBP_P4PNetSelfMon/IS/0/Connectivity/FailoverNodes/PatrolAgentHostName:PatrolAgentPortOnFailoverNode/uname
       where,
      PatrolAgentHostName, refers to the host name of the PATROL Agent on which the particular failover node (Integration Service) is being monitored.
      PatrolAgentPortOnFailoverNode, refers to the port number of the PATROL Agent on which the particular failover node (Integration Service) is being monitored.
      Example: /PBP_P4PNetSelfMon/IS/0/Connectivity/FailoverNodes/PatrolAgent1:3181/uname
   3. In the Operation column, select the REPLACE option.
   4. Double-click the highlighted space in the Value column and enter the user name of the PATROL Agent on which the failover node (Integration Service) that you want to add is being monitored.
   5. Click OK.
       Example:

   6. Repeat #step a to #step e to add the following variables:

      Variable	Value
      /SecureStore/PBP_P4PNetSelfMon/IS/0/Connectivity/FailoverNodes/PatrolAgentHostName:PatrolAgentPortOnFailoverNode/uname/failoverNodeUserName Example: /SecureStore/PBP_P4PNetSelfMon/IS/0/Connectivity/FailoverNodes/PatrolAgent1:3181/uname/FailoverNode2 Note: Your password will not be applied until you do not add the following variable: /PBP__P4PNetSelfMon/IS/0/Connectivity/FailoverNodes/list Placeholders used: PatrolAgentHostName, refers to the host name of the PATROL Agent on which the failover node (that you added in step 4) is being monitored. PatrolAgentPortOnFailoverNode, refers to the PATROL Agent port number on which the failover node (that you added in step 4) is being monitored. failoverNodeUserName, refers to the user name of the PATROL Agent on which the failover node (that you added in step 4) is being monitored.	Enter the PATROL Agent password on which the failover node (that you added in step 4) is being monitored.
      /PBP__P4PNetSelfMon/IS/0/Connectivity/FailoverNodes/list Placeholders used: PatrolAgentHostName, refers to the host name of the PATROL Agent on which the failover node (that you added in step 4) is being monitored. PatrolAgentPortOnFailoverNode, refers to the PATROL Agent port number on which the failover node (that you added in step 4) is being monitored.	Enter a comma-separated list of the PATROL Agent host names and port numbers in the following format: PatrolAgentHostName:PatrolAgentPortOnFailoverNode Example: PatrolAgent1:3181,PatrolAgent2:3183

5. To modify information that you provided in the preceding steps while configuring failover nodes, such as the PATROL Agent user name, password, port, and host name, complete the following steps:
   1. Right-click the rule containing one of the following variables and select Edit Rule:
      • /PBP_P4PNetSelfMon/IS/0/Connectivity/FailoverNodes/PatrolAgentHostName:PatrolAgentPortOnFailoverNode/uname
      • /SecureStore/PBP_P4PNetSelfMon/IS/0/Connectivity/FailoverNodes/PatrolAgentHostName:PatrolAgentPortOnFailoverNode/uname/failoverNodeUserName
      • /PBP__P4PNetSelfMon/IS/0/Connectivity/FailoverNodes/list 
   2. In the RuleSet dialog box, modify the value of the variable as required.
   3. Click OK.
6. To delete failover nodes already configured, right-click the rules containing the following variables and select Delete:
   • /PBP_P4PNetSelfMon/IS/0/Connectivity/FailoverNodes/PatrolAgentHostName:PatrolAgentPortOnFailoverNode/uname
   • /SecureStore/PBP_P4PNetSelfMon/IS/0/Connectivity/FailoverNodes/PatrolAgentHostName:PatrolAgentPortOnFailoverNode/uname/failoverNodeUserName
   • /PBP__P4PNetSelfMon/IS/0/Connectivity/FailoverNodes/list
     
7. If you have modified or added a failover node, drag the new RuleSet onto the agentHostName in the left pane.
8. Click the Apply Configuration icon in the PATROL Configuration Manager menu bar.
    For more information about a list of PATROL Agent configuration variables with detailed descriptions, see PATROL-Agent-configuration-variables.

Adding or modifying pconfig variables manually

Some configuration variables are not automatically available, and cannot be activated by using a menu command. You must enter these variables manually by using the PATROL Developer console.You must be sure to enter valid values because PATROL Configuration Manager does not verify or notify you if the value you enter is invalid. All of the variables and their valid values are listed under the topic PATROL-Agent-configuration-variables.

To add, modify, or delete a pconfig variable manually

1. Right-click the host, and select Development > Agent Configuration.
2. To add a variable, complete the following steps:
   1. From the main menu, select Edit > Add Variable to display the Add Variable dialog box.
   2. In the Variable field, enter the instance name (if required) and then the variable.
   3. In the Value field, enter the value you want to apply to the variable.
       For more information about valid values, see PATROL-Agent-configuration-variables.
   4. To save the configuration, select File > Save.
3. To modify the value of a variable, complete the following steps:
   1. Select the variable you want to modify.
   2. From the main menu, select Edit > Modify Variable to display the Modify Variable dialog box.
   3. Double-click the entry from the Change Entries list.
   4. In the Value field, modify the value for the variable.
       For more information about valid values, see PATROL-Agent-configuration-variables.
   5. To save the configuration, select File > Save.
4. To delete the value of a variable, complete the following steps:
   1. Select the variable you want to delete.
   2. From the main menu, select Edit > Delete Variable.
   3. The values for the selected variable is deleted.
   4. To save the configuration, select File > Save.

For instructions on how to add a variable or RuleSet using PATROL Configuration Manager, see the PATROL Configuration Manager User Guide at PDFs.