Using the PCC Wizard to configure multiple PATROL Agents

After you have installed PCC Wizard on all nodes, use the following instructions to use the PCC Wizard to configure the PATROL Agent resources. To configure all nodes, you need to run the PCC Wizard just once, from a single node.

Information required by PCC

Use the following table to plan your configuration of each PATROL Agent resource.

Information required by PCC

Required information

Your information

PCC

Cluster Name

Adds the PATROL Agent resource to the cluster you select or enter.

Group Name(s)

Adds the PATROL Agent resource to one or more cluster groups.

Resource Name

Adds the PATROL Agent service as a Generic Service resource type with this name. The resource name must be unique for this cluster.

Service Name

Creates registry entries for this PATROL Agent service name on each node you select. The service name must be unique for this system and comply with the rules for a service name.

Note: PATROL does not rename the PatrolAgent.exe.

Network Name

Sets the PATROL_VIRTUALNAME_ PORT# environment variable to this network name, which the PATROL Agent uses instead of the host name to store the PATROL configuration and history data. For easy identification, this name should be the virtual server name of the cluster group with which the agent is bundled. For example, the network name for an agent on port 3182 is PATROL_VIRTUALNAME_ 3182 = BMC_ExchangeHou.

Port Number

Sets the port number that the PATROL Agent is using and that is referenced by all environment variables. Each PATROL virtual Agent must have a unique port number.

Shared Drive

Sets the drive shared by a cluster on which the configuration and history data will be stored. The PATROL Agent must be able to access this shared drive at agent startup, and the shared drive should belong to the cluster group with which the PATROL Agent is bundled.

History Path

Sets the PATROL_HISTORY_ PORT# environment variable to this path on the shared drive, which stores the agent history files. For example, the history data location for an agent on port 3182 is PATROL_HISTORY_ 3182 = X:\patrol\history.

Config DB Path

Sets the PATROL_CONFIG_ PORT# environment variable to this path on the shared drive, which stores the PATROL Agent configuration database. For example, the configuration database location for an agent on port 3182 is PATROL_CONFIG_ 3182 = X:\patrol\config.

RTSERVERSvariable

Sets the RTSERVERSenvironment variable associated with the PATROL Agent. If you have not configured an RTserver for your PATROL environment, you can leave this field blank. You may enter one or more known RTservers. Each entry is separated by a comma and has the format of protocol:hostname:port. For example, tcp:tbrady3w2k.bmc.com:2059.

Node(s)

Creates a registry entry for the PATROL Agent service on each cluster node you select.

Configuring the PATROL Agent

The following table provides information about configuring the PATROL Agent:

(Click the images under the Dialog box column to see an expanded view).

Action

Dialog box

Notes

1. Click Next.

2. Select the appropriate option and click Next.

If you are installing the first resource, select Add one or multiple PATROL Agent resource(s). Adding a PATROL Agent as a cluster resource performs the following actions:

  • Sets the required environment variables
  • Registers the PATROL Agent with a new service name
  • Adds the PATROL Agent to the cluster as a Generic Service resource type and sets the resource properties

3. Select the groups to which you want to add the agent and click Next.

You can select multiple groups. In most cases, the groups will correspond to the applications you want to monitor.

4. Enter the appropriate information and click Node List.

If you do not know what names to use, accept the defaults. The port number must be a port that is not in use by any other process.

5. Verify that all nodes that you want to configure are selected and click OK. You are returned to the PATROL Agent configuration screen. Click Next.

You can select a node by clicking the node. All nodes are selected by default.

6. Verify the configuration information and click Configure.

7. Click View Log or Finish.

You have finished configuring the agent.

Your configuration of the PATROL Agent using PCC performs the following actions:

  • Registers the PATROL Agent service with a new service name within the Service Control Manager.
  • Sets the registry parameters and port number.
  • Sets the service startup to manual.
  • Creates the resource of type Generic Service in the cluster.
  • Sets the Generic Service resource properties to restart without affecting the cluster group; remaining properties have default values.
  • Sets the service name parameter of the Generic Service and enables use Network Name for computer name.
  • Creates PATROL Agent history and configuration files on shared disk.
  • Creates environment variables for cluster nodes.
  • Brings the newly created resource online if the selection box is checked.
  • Sets resource dependencies on the specified Physical Disk and Network Name.