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.
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
Cluster Administration Executable (command line only)
User-defined name of the cluster
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.
Establish a dependency between the service and the cluster.
Determines what the cluster does (shut down, wait, and so on) if the PATROL Agent service fails and is unable to restart.
Identify the service name of the PATROL Agent service bound to the cluster application.
Specify startup characteristics such as port number.
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.
For each command, you must reenter the name of the cluster executable, name of the cluster, resource option, and service name.
- Go to the command line.
- 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"
- 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"
- 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
- 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>"
- 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 .
cluster.exe clusterName RES "PatrolAgent for MyApplication" /Priv StartupParameters="-p Port#"
- Set the service to be available (online) when the cluster is running.
cluster.exe clusterName RES "PatrolAgent for MyApplication" /ON