Web Viewer 12.1 Upgrade Windows Server Version

Products

• Output Management Web Viewer

Issue/Introduction

This article specifies how to do a new install of Web Viewer 12.1 on an existing server that has been upgraded with a new version of Windows. In this case the new version is Windows Server 2016 Standard.

Much of this information will be useful for other upgrades as well.

Environment

MS Windows Server 2016, 2019

Resolution

Backup your current server

Back up your current Web Viewer files.  In particular, you will need:

• Your current configuration files as you should be able to just use these. They are text files. These are in the config subdirectory under your Install directory path: CCIClient.properties and WVProfile.properties
• If you had the internal derby database, you can use that and will need to back it up from C:\Program Files\CA\CA_OM_Web_Viewer\database - everything from \admin and below and restore it after you have installed Or if you had an external database for your previous install, you can continue to use that also. The WVProfile.properties files will contain the configuration information for your external database.
• Your Tomcat server.xml file from the bin subdirectory under Tomcat if you are using SSL, and your current .jks certificate.

 

Download files you will need from the Broadcom Support Portal

• Download the latest install image (.iso) which is available on my Downloads on Broadcom Support.  (you must be logged into the Broadcom support portal). It includes all maintenance through cumulative build 203 and should be applied on it. It includes Tomcat 8.5.4 when doing a full install. 
• Choose 

  CA OUTPUT MANAGEMENT WEB VIEWER V12.1 S1409 - MEDIA REPLACEMENT

  DVD0000000001981.ISO

   

• Click on the cloud icon to the right of the .iso to download
• Download the latest maintenance to apply after the install is complete. Here is the link to download the latest maintenance:   You only need to apply the latest solution on the list that is NOT Tomcat maintenance.  All other maintenance is cumulative\.
• Download the Web Viewer Tomcat maintenance.  Scroll down in the list of maintenance to find the latest Tomcat maintenance  

Prepare the Windows server

• Make sure the server has enough RAM for the heap size.  16GB is recommended.  In general, you can use about 50% of your installed memory (RAM) for heap if no other applications are running on your server.
• You will need a 64 bit version of Java JRE or JDK. Up to Java 16 is certified. You may use ORACLE or an Open Java

 Install

1. Extract the CAOMVW,exe file from the .iso install file by right clicking and choosing MOUNT or using Winzip or any unzip app
2. Click on it to start the install.
3. The install will stop the Tomcat service
4. Follow prompts and select yes for Tomcat as a service.
5. When it completes, copy the .properties files into C:\Program Files\CA\CA_OM_Web_Viewer\config, for example
6. If using the internal Derby Database, restore the database files.
7. If using SSL or TLS,  copy the server.xml file to restore the encrypted port numbers.
8. After the install is complete restart the Tomcat service and set it to come up automatically
9. Bring up Web Viewer to complete the install.
10. Verify that the heap size is sufficient.

Apply Maintenance

1. Apply the latest maintenance you downloaded in preparation for the install. 
2. Apply the Tomcat maintenance you downloaded.  Follow the special instructions carefully.

Additional Information

Web Viewer 12.1 Check & Increase Java Heap Size