Versions Compared

Key

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

...

Step 1

From the Stonebranch Customer Portal, download the Universal Controller 7.6.x package (for instructions, see /wiki/spaces/UC71x/pages/5178154 Downloading Universal Controller Software).

Step 2If 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:
 
Windows
Use an appropriate archiving / unzipping product.
 
Linux/Unix

Panel
tar -xvf universal-controller-N.N.N.N.tar


Step 4

Stop the Tomcat container in which the Passive cluster node is deployed.
 
Windows
Use the services application to stop Tomcat. You also can issue the stop command on a command line:
 

Panel
net stop [name of Tomcat service]

 
UNIX
Stop the daemon using the script found in the /etc/init.d directory for Tomcat.
 

Panel
service [name of Tomcat service] stop

 
Windows or UNIX
Stop the service using the $CATALINA_HOME/bin/shutdown.bat or $CATALINA_HOME/bin/shutdown.sh scripts:

  • Windows

    Panel
    cd $CATALINA_HOME\bin
    shutdown


  • Linux/Unix

    Panel
    cd $CATALINA_HOME/bin
    ./shutdown 


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:

  1. Delete the existing deployment directory and war file from your webapps directory.

    The Controller installation process renamed the unpacked war file (universal-controller-N.N.N.N-build.N.war) as uc.war, so the following would be your deployment directory and war file:
Panel
[tomcat-install]\webapps\uc
[tomcat-install]\webapps\uc.war


Note
titleNote

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 uc.war.

3. Start the Tomcat container in which the Active cluster node is deployed.

Note
titleNote

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
titleNote

If you have deployed any JDBC driver jar files (or in the case of DB2, a JDBC driver license jar file) to the $CATALINA_HOME/webapps/uc/WEB-INF/lib directory, you must recopy these files to this directory and restart Tomcat after your initial validation.


Step 7

Repeat Step 6 for the Passive cluster node deployment.

...