Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

This page describes the following procedure:

This procedure assumes you already have performed any required pre-installation procedure steps for the cluster node being added.

Anchor
Copy and Unpack the Downloaded Distribution File
Copy and Unpack the Downloaded Distribution File

Copy and Unpack the Universal Controller Distribution File

Copy the downloaded distribution file, which was used to install the current, single instance of Universal Controller, from its current location to the machine on which you want to install a new instance of the Controller.

...

Linux/Unix


Panel
tar xvf uc-controller-N.N.N.N.tar


Windows

Use an appropriate archiving / unzipping product.

Anchor
Install the Controller
Install the Controller

Install the Controller

To install the Controller, issue the following command that is appropriate for your platform:

...

Linux


Panel
sh install-controller.sh --tomcat-dir ~/tomcat --controller-file ./uc-controller-N.N.N.N-build.N.war --dbuser root --dbpass userpass


Windows


Panel
install-controller.bat --tomcat-dir "c:\Program Files\Apache Software Foundation\Tomcat 8.5"
--controller-file uc-controller-N.N.N.N-build.N.war --dbuser root --dbpass userpass


Note
titleNote

In the Tomcat directory (--tomcat-dir), when quoting the directory is necessary due to spaces, do not use a single backslash before the ending quotation mark; use either a double backslash or no backslash to avoid the command shell from treating \" as an escape character.


Anchor
Deploy the Controller
Deploy the Controller

Deploy the Controller

In this procedure, you will start Tomcat, which starts the Controller and builds your database tables. This process takes several minutes. When it is complete, the Controller is started and ready to use.

...

You now have completed the install process and the Controller is running.

Anchor
Verify the Installation
Verify the Installation

Verify the Installation

To make sure the new cluster node is installed and running properly:

...

Note
titleNote

The license key for the installed Universal Controller applies to all instances (cluster nodes) of that Controller; no additional licensing is required.

System Notifications configured for the installed Universal Controller apply to all instances (cluster nodes) of that Controller; no additional system notifications have to be configured.

Anchor
Adding an OMS Server
Adding an OMS Server

Adding an OMS Server

To add a second OMS Server to an HA environment (which creates an OMS cluster), you must install Universal Agent on a machine where one of the additional cluster nodes has been added.

...

The OMS Servers list screen will contain a single entry for all OMS cluster members defined in the record. (The OMS Servers list screen could have additional entries for an OMS Server or OMS cluster outside of your HA environment. For example, OMS Servers outside a firewall would connect to a different message database and serve different Agents, but would connect to to the same Controller.)

Anchor
OMS Server Message Database
OMS Server Message Database

OMS Server Message Database

Members of an OMS cluster in an HA environment must use the same OMS Server message database.

...