Versions Compared

Old Version 3

changes.mady.by.user Stonebranch

Saved on

compared with

New Version 4

changes.mady.by.user IT Stonebranch

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Macro name changed from html to html-bobswift during server to cloud migration processing.

...

Step 1

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

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
Html bobswift
<pre>tar -xvf universal-controller-N.N.N.N.tar</pre>

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
Html bobswift
<pre>
 net stop [name of Tomcat service]
</pre>

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

Panel
Html bobswift
<pre>
 service [name of Tomcat service] stop
</pre>

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

  • Windows

    Panel
    Html bobswift
    <pre>
cd $CATALINA_HOME\bin
shutdown</pre>

  • Linux/Unix

    Panel
    Html bobswift
    <pre>
cd $CATALINA_HOME/bin
./shutdown </pre>

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:

Html bobswift
<ol>
<li> Delete the existing <b>deployment directory</b> and <b>war</b> file from your <b>webapps</b> directory.  
<br><br>
The Controller installation process renamed the unpacked <b>war</b> file (<b><code>universal-controller-N.N.N.N-build.N.war</code></b>) as <b><code>uc.war</code></b>, so the following would be your <b>deployment directory</b> and <b>war</b> file:
<br><br>
Panel
Html bobswift
<pre>
[tomcat-install]\webapps\uc
[tomcat-install]\webapps\uc.war
</pre>
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.

Html bobswift
<li> Copy the <b>war</b> file from the new downloaded package to your <b>webapps</b> directory and rename the <b>war</b> file <b><code>uc.war</code></b>. 
<li> Start the Tomcat container in which the <b><i>Active</i></b> 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.

Html bobswift
<li> Log in to the <b><i>Active</i></b> cluster node deployment with user <b>ops.admin</b> or a user with equivalent authorization and verify the installation (see <b>Verify the Installation</b>, 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.

Html bobswift
</ol>

Step 7

Repeat Step 6 for the Passive cluster node deployment.

...