Applying Maintenance to Universal Controller
Overview
For Universal Controller 7.2.x, applying maintenance refers to the increase from a currently installed 6.1.x or later release of the Controller to a 7.2.x release of the Controller (for example, increase Controller 6.2.0.1 to Controller 7.2.0.0).
If you want to increase Controller 5.2.0 to Controller 7.2.x, you must perform an upgrade. The procedures for upgrading differ from the procedures for applying maintenance (see Upgrading Universal Controller from 5.2.0).
Applying Maintenance vs. Upgrading
For Universal Controller 7.2.x, upgrading refers to the increase of its currently installed 5.2.0 version to a 7.2.x version (for example, upgrading Controller 5.2.0.5 to Controller 7.2.0.0).
You cannot upgrade to Controller 7.2.x from versions prior to 5.2.0 (for example, 5.1.1).
The procedures for upgrading differ from the procedures for applying maintenance (see Upgrading Universal Controller from 5.2.0).
Universal Controller Maintenance
As a precautionary measure, it is highly recommended that you back up the Universal Controller database prior to applying maintenance.
Note
These instructions assume that you are running a High Availability Universal Controller system: a system configured with Active and Passive Controllers (cluster nodes). If you are running a single Controller, disregard the steps for the Passive Controllers.
To apply maintenance to the currently installed release of Universal Controller:
StepĀ 1 | From the Stonebranch Customer Portal, download the Universal Controller 7.1.x package (for instructions, see /wiki/spaces/UC71x/pages/5178154). |
---|---|
Step 2 | If any JDBC drivers have been added to the Controller installation, these should be backed up prior to the application of maintenance and then copied back after the application. Instructions for adding drivers can be found here.Ā |
Step 3 | Unpack the Universal Controller distribution file, using the following method appropriate for your platform: tar -xvf universal-controller-N.N.N.N.tar |
Step 4 | Stop the Tomcat container in which the Passive cluster node is deployed. net stop [name of Tomcat service] Ā service [name of Tomcat service] stop Ā
|
Step 5 | Stop the Tomcat container in which the Active cluster node is deployed, using one of the methods shown in Step 4. |
Step 6 | For the Active cluster node deployment:
[tomcat-install]\webapps\uc [tomcat-install]\webapps\uc.war Note If you want to rename the deployment directory and uc.war for back-up, you must do so outside of the Tomcat folder. 2. Copy the war file from the new downloaded package to your webapps directory and rename the war file 3. Start the Tomcat container in which the Active cluster node is deployed. Note We recommend that all Universal Controller users clear their browser cache and close their browser prior to re-opening and navigating back to the Universal Controller URL to ensure that the most recent client updates are loaded. 4. Log in to the Active cluster node deployment with user ops.admin or a user with equivalent authorization and verify the installation (see Verify the Installation, below). Note If you have deployed any JDBC driver jar files (or in the case of DB2, a JDBC driver license jar file) to the |
Step 7 | Repeat Step 6 for the Passive cluster node deployment. |
Verify the Installation
To make sure the Controller is installed, running, and communication with Universal Agent and Universal Message Service (OMS), verify the installation after you have logged on:
Ā
StepĀ 1 | From the Home dashboard, verify that the System Details widget displays the appropriate Universal Controller release. |
---|---|
StepĀ 2 | From the Agents and Connections navigation pane, select Agents > All Agents or Agents > <type of Agent>. You will see a list similar to the following example. Make sure the Status of the Agent is Active. |
StepĀ 3 | From the Agents and Connections navigation pane, select System > OMS Servers. You will see a list similar to the following example. Make sure the Status of the OMS Servers are Connected. |
StepĀ 4 | For more information about these components in the Universal Controller user interface, see: |