Automation Engine and Clusters

Clusters group computers in order to achieve increased computer capacity or workload distribution. AE can also run in a cluster.

Installation and configuration for a cluster are almost the same as they are for an individual computer. The most important steps are listed below. Other settings in the cluster itself depend on the cluster software in use.

Automation Engine

It is useful to integrate your Automation Engine in a cluster if it has only been installed on one computer.

Install the Automation Engine in a separate directory.
Enter the cluster's virtual IP address in hostname= parameter in the [TCP/IP] section of the INI file.
Install the ServiceManager on all the cluster's computers in order to ensure that the server processes can be started if the computer is changed. The ServiceManager must be available as a cluster service. For more information, see ServiceManager.

Agents

Agents can also run in a cluster.

Install the agent in a separate directory.
Enter the cluster's virtual IP address in the UC_EX_IP_ADDR INI file parameter. For more information, see List of Agent Variables.
Install the ServiceManager on all the cluster's computers in order to ensure that the agents can be started if the computer is changed. The ServiceManager must be available as a cluster service. For more information, see ServiceManager.

Example: Microsoft Cluster

The following instructions guide your through installing an Agent in a cluster. There are two different installation types:

The ServiceManager and the Agent are either installed on a shared disk.
The ServiceManager is installed on a local disk and the Agent on a shared disk. This type does not require you to switch the cluster group during the installation. The ServiceManager must be installed on each node.

Type 1

Install the Agent and the ServiceManager on a shared disk of the Microsoft Cluster.

Perform the installation first on the primary node and, after switching the disk, on the secondary node in the same directory.
Enter the virtual IP address of the cluster in the [VARIABLES] section of the Agent's INI file. To do so, use the UC_EX_IP_ADDR variable.
Register the ServiceManager as a service using the command UCYBSMGR –install <Phrase>.

The start type must be set to Manually; do not set it to Automatically. Start this procedure on the computer on which the second installation was made, then switch the disk and continue on the primary node.
In the MSCS, define the ServiceManager Phrase as resource type Generic Service.
Select the dependencies' shared disk and, if required, the IP address assigned to the group.
If the Agent needs to use particular settings, use an extra variable for the host characteristics. For more information, see UC_HOSTCHAR_DEFAULT - Host Characteristics.

Type 2

Install the ServiceManager on each node on a local disk unit.
Register the ServiceManager as a service using the command UCYBSMGR –install <Phrase>.

The start type must be set to Manually; do not set it to Automatically.
Install the Agent on a shared disk of the Microsoft Cluster.
Enter the virtual IP address of the cluster in the [VARIABLES] section of the Agent's INI file. To do so, use the UC_EX_IP_ADDR variable.
In the MSCS, define the ServiceManager Phrase as resource type Generic Service.
Select the dependencies' shared disk and, if required, the IP address assigned to the group.
Now you can start the group on a node.
Use the ServiceManager Dialog Program to adjust the services (such as Agent properties, automatic start), see ServiceManager - Dialog Program.
Copy the updated *.smd and *.smc files to the other nodes from the installation folder of the ServiceManager.
If the Agent needs to use particular settings, use an extra variable for the host characteristics. For more information, see UC_HOSTCHAR_DEFAULT - Host Characteristics.
The key that is used to communicate to the Server is entered in the Keystore file when the Agent starts on the first node for the first time. Define the name and path of the Keystore file in the Agent's INI file.
A copy of the first node's Keystore file must be available on the second node on which the Agent should run using the same name. Otherwise, you cannot start an Agent of the same name on a different computer if it is already registered on the system. This procedure is always required regardless of the authentication method that is used.