Upgrade Web Viewer 12.0 to 12.1 When Running Tomcat

Products

• Output Management Web Viewer

Issue/Introduction

How to upgrade Web Viewer 12.0 to 12.1 in production while 12.0 is still running. How to cutover or back out.  You will be running two versions simultaneously. 

 

Environment

• Output Management Web Viewer 12.0, 12.1
• Apache Tomcat®

Resolution

Install and Configure the new 12.1 on the production System

1. Do a new install of 12.1 on the production System
2. Run the configtool and configure 12.1 based on the 12.0 values.  You may use the same database or create a test database.
3. Change the ports of the new 12.1 production system to test ports:
4. Edit apache-tomcat/conf/server.xml
5. Tomcat/Web Viewer uses 8080, 8009, and 8005 by default.  You will have to change any of these ports that are in use by the 12.0 production system.
6. Test the 12.1 production system
7. Start the 12.1 application
8. Test it while it is running on the alternate Tomcat ports

Cutover to the New 12.1 System 

1. Stop the 12.1 application
2. Change the ports of your 12.1 production system to the final production ports
3. Stop the 12.0 Apache Tomcat
4. Start the 12.1. The turnover time of the final switch, should be quite fast.  Probably one or two minutes.

Backout
If anything goes wrong:

1. Stop the 12.1 application server 
2. Restart the 12.0 application server.