Configuring failover nodes by using the PATROL Configuration Manager CLI


The PATROL Configuration Manager CLI processes a script file that contains commands regarding RuleSets.

To configure failover nodes by using the PATROL Configuration Manager RuleSets, you must appropriately modify the pbprulesets.cfg file, and ensure that only the following variables with appropriate values are present. After modifying the file, you can apply these changes to the configured PATROL Agent by using the PATROL Configuration Manager CLI.

Location of the pbprulesets.cfg file: %PATROL_HOME%\...\pconfmgr\rulesets\Shipped\pbp

Variables:

  • "/PBP__P4PNetSelfMon/IS/0/Connectivity/FailoverNodes/PatrolAgentHostName:PatrolAgentPortOnFailoverNode/uname" - {REPLACE = "failoverNodeUserName"}
    Example: "PBP__P4PNetSelfMon/IS/0/Connectivity/FailoverNodes/PatrolAgent1:3181/uname" - {REPLACE = "neo"}
  • "/SecureStore/PBP__P4PNetSelfMon/IS/0/Connectivity/FailoverNodes/PatrolAgentHostName:PatrolAgentPortOnFailoverNode/uname/failoverNodeUserName" - {REPLACE = "BPPM_MTM_CONNECTION_PROFILE/password"}
    Example: "/SecureStore/PBP__P4PNetSelfMon/IS/0/Connectivity/FailoverNodes/PatrolAgent1:3181/uname/neo" - {REPLACE = BPPM_MTM_CONNECTION_PROFILE/password}
  • "/PBP__P4PNetSelfMon/IS/0/Connectivity/FailoverNodes/list" - {MERGE =listOfPatrolAgents"}
    Example: "/PBP_P4PNetSelfMon/IS/0/Connectivity/FailoverNodes/list" - {MERGE = PatrolAgent1:3181,PatrolAgent2:3181"}

Placeholders used

Description

PatrolAgentHostName

Host name of the PATROL Agent on which the particular failover node (Integration Service) is being monitored.

PatrolAgentPortOnFailoverNode

Port number of the PATROL Agent on which the particular failover node (Integration Service) is being monitored.

failoverNodeUserName

User name of the PATROL Agent on which the particular failover node (Integration Service) that you want to add is being monitored.

listOfPatrolAgents

Comma-separated list of the PATROL Agent host names and port numbers in the following format:

PatrolAgentHostName:PatrolAgentPortOnFailoverNode

Example:
PatrolAgent1:3181,PatrolAgent2:3183

For a list of configuration variables, see PATROL-Agent-configuration-variables.

Copy the pbprulesets.cfg file to the %PATROL_HOME%\...\pconfmgr\rulesets\Shipped\pbp directory and run the pcm.cmd -f scriptFileLocation command to apply the RuleSets. The scriptFileLocation refers to the path where the script file is located on your computer. This file must contain the apply -a agentName RuleSetsFileName command.

Warning

Note

In the apply -a agentName RuleSetsFileLocation command:

  • RuleSetFileLocation refers to the path where the pbprulesets.cfg is stored on your computer. 
  • Do not add the extension while specifying the pbprulesets.cfg file.

For more information about the commands and options that can be used in a script file, see the PATROL Configuration Manager User Guide at PDFs.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

BMC PATROL for BMC ProactiveNet Self Monitoring 1.0