Important

   

This documentation space contains information about PATROL Agents when deployed in a TrueSight Operations Management environment. If you are a BMC Helix Operations Management user, see PATROL Agent 22.4 for BMC Helix Operations Management. Open link

Defining the PATROL Agent as a member of the group

This section explains how to add the new PATROL Agent service as a resource of type "Generic Service" to the cluster. This task is commonly referred to as binding the agent to the cluster application.

Note

This task description uses Windows Cluster Management Software as an example. The steps describing how to set up the software are intended as a general outline of the process and are not intended as step-by-step instructions.


Perform the following task on only the master node of the cluster. The cluster software provides two methods for binding a service to a cluster: GUI or command line. Regardless of the method, you must provide the information listed in the following table:


Cluster administration properties

Arguments

Description

cluster.exe

Cluster Administration Executable (command line only)

clusterName

User-defined name of the cluster

RES

Specifies the service as a resource of the cluster

"PatrolAgent for MyApplication"

Description of the service

/CREATE /Group: /TYPE:

Create a group and assign it a resource type.

/ADDEP

Establish a dependency between the service and the cluster.

/Prop:RestartAction

Determines what the cluster does (shut down, wait, and so on) if the PATROL Agent service fails and is unable to restart.

/Priv: ServiceName

Identify the service name of the PATROL Agent service bound to the cluster application.

/Priv: StartupParameters

Specify startup characteristics such as port number.

/ON

Make the PATROL Agent service available (online) to the cluster.

Using Cluster Administration GUI

Add the new PATROL Agent service as a resource of type "Generic Service" to the cluster using the Cluster Administrator GUI.

Using the command line

To bind a PATROL Agent service to the cluster application, you must issue a number of commands. Each command contains the name of the cluster registration executable, name of the cluster, RES, description of the service, and various attributes.

Note

For each command, you must reenter the name of the cluster executable, name of the cluster, resource option, and service name.

  1. Go to the command line.
  2. Name the service, designate it as a resource of the cluster, create a group, and assign it a resource type of "Generic Service".

    cluster.exe clusterName RES "PatrolAgent for MyApplication" /CREATE /Group:MyGroup /TYPE:"Generic Service"
  3. Add the disk that stores the PATROL Agent configuration and history information as a dependency. This command instructs the cluster software to bring up the disk with configuration information before it attempts to start the PATROL Agent.

    cluster.exe clusterName RES "PatrolAgent for MyApplication" /ADDDEP:"Disk MyGroupDisk"
  4. Set the restart action. This command determines what the cluster does if an application fails and is unable to restart. A value of one (1) indicates that if the application is unable to restart, the cluster will continue to run.

    cluster.exe clusterName RES "PatrolAgent for MyApplication" /Prop:RestartAction=1
  5. Identify the service name to the cluster software. The service name must be identical to the service name assigned to the PATROL Agent executable on each cluster node.

    cluster.exe clusterName RES "PatrolAgent for MyApplication" /Priv ServiceName="PatrolAgent -<application_name>"
  6. Set the port number for the PATROL Agent bound to the cluster application. This number must be the same as the number assigned as a suffix to the PATROL cluster-specific environment variables.
    For more information about the PATROL cluster-specific environment variables, see Define the PATROL cluster-specific environment variables.

    cluster.exe clusterName RES "PatrolAgent for MyApplication" /Priv StartupParameters="-p Port#"
  7. Set the service to be available (online) when the cluster is running.

    cluster.exe clusterName RES "PatrolAgent for MyApplication" /ON
Was this page helpful? Yes No Submitting... Thank you

Comments