Skip to Content

Configuring the Agent Failover monitor profile

Monitor the availability of PATROL Agents by configuring the Agent Failover solution. For more information about the attributes collected during monitoring agent failover, see Monitor types and attributes.

Before you begin

  • Both the primary and secondary agents must be configured to use a common virtual agent name.
  • During failover configuration, the primary agent must be connected to the BMC Helix Operations Management, while the secondary agent remains disconnected from the BMC Helix Operations Management.

  • It is recommended to use a tag-based policy configuration for the agents so that the required monitoring policy is already applied to the primary agent.

To configure Agent Failover

  1. In BMC Helix Operations Management, select Configuration > Monitor Policies > Create Policy.
  2. On the Create Monitoring Policy page, select the Monitoring tab and click Add Monitoring Configuration.
  3. From the Monitoring Solution list, select PATROL for Agent Failover.
  4. From the Monitor Profile, select PATROL for Agent Failover.
  5. From the Monitor Type lists, select Environments.
  6. In the FailOver Monitoring Configuration section, click Add.
  7. Add the monitoring configuration as described in the following table:

Field

Description

FailOver Environment Name

Enter a name to identify the failover environment configuration.

Virtual Agent name used by Member Agents

Enter a virtual agent name to configure the PATROL_VIRTUALNAME_<port#> environment variable on both PATROL Agents that collect data.

Virtual Agent Port# used by Member Agents

Enter a virtual agent port number to configure the PATROL_VIRTUALNAME_<port#> environment variable on both PATROL Agents that collect data.

Debug Logging - located in log directory using PAW-host.kmlog

Select this checkbox to enable debug logging.

Monitoring Control Tags

Click Add to configure the control tags.

Agent Side TAG required for Actively Monitoring Solution—Enter the name of the Agent Tag to associate "Active" PATROL Agents with specific collection configuration policies. For instance, when utilizing a pair of agents for remote ping, the PING tag should be associated with the respective agents.

  • You can add any number of Agent Tags to the configuration.
  • These Agent Tags should be placed within the configuration of the collection agents to link the "Active" PATROL Agent with the desired collection configuration policy or policies.
    Example: If a pair of agents is engaged in a remote ping, the PING tag should be associated with those agents that contain the PING policy.
  • Each Tag can be independently added to the respective Policy, enabling versatile and granular configuration.
Member Agents - Setup Details

Expand Member Agents - Setup Details to configure the connection credentials of the member agents.

  • User Name—Enter a user name.
  • Password—Enter a password.
  • Confirm Password—Confirm the password.
Advance configuration

Expand the Advance configuration field to configure failover retry attempts.

Failover Retry Attempts—Enter the number of retry attempts to reconnect to the primary PATROL Agent before switching to the secondary Agent. If the primary Agent becomes available during these attempts, a failover does not occur. The default value is 3.

Primary Server Details

Expand the Primary Server Details to configure the primary server details for the primary agent:

  • Primary Agent Hostname—Enter a primary agent host name.
  • Primary Agent Integration connect string—Enter a primary agent integration connect string
  • Primary Agent Proxy Server Name—Enter a primary agent proxy server name.
  • Primary Agent Proxy Server User—Enter a primary agent proxy server user name, if your primary agent needs to be connected to a proxy server. 
  • Primary Agent Proxy Server Password—Enter a primary agent proxy server password.
    Important: A password is unnecessary when using a credentials-less proxy server.
Secondary Server Details

Expand the Secondary Server Details to configure the secondary server details for the secondary agent:

  • Secondary Agent Hostname—Enter a secondary agent host name.
  • Secondary Agent Integration connect string—Enter a secondary agent integration connect string; if blank, then the primary agent integration connect string will be used.
  • Secondary Agent Proxy Server Name—Enter a secondary agent proxy server name, if your secondary agent needs to be connected to proxy server, If blank and primary agent proxy server details are available, then those details will be used.
  • Secondary Agent Proxy Server User—Enter a secondary agent proxy server user name.
  • Secondary Agent Proxy Server Password—Enter a secondary agent proxy server password.

    Important: A password is not needed when using a credentials-less proxy server.

  1.  Click Save.

 

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

BMC PATROL for Agent High Availability 25.4