how to upgrade Tomcat 8.5.56 to 9.0.55 for Web Admin Console (WAC) and Content Import Client (CIC) ?

Products

• CA Client Automation

Issue/Introduction

This article describes how to upgrade Tomcat 8.5.56 to 9.0.55 for Web Admin Console (WAC) and Content Import Client (CIC) components in CA Client Automation.

Environment

Client Automation 14.5 and higher

Resolution

Web Admin Console (WAC)

Web Admin Console uses Tomcat 8.5.56 version. To upgrade to the latest version (9.0.55) of Tomcat, perform the following steps:

1. 1. Download the 9.0.55, 32-bit Tomcat for windows from Apache Tomcat website.
      
      
      1. Download archived Tomcat version  9.0.55 from URL as shown in below
         
         
         
         
   2. Extract the downloaded zip file.
      
      
   3. Stop the tomcat service (in command prompt : caf stop tomcat).
      
      
   4. Take a backup of the current installed version of Tomcat in your environment before proceeding with the upgrade process:
      
      For example: ..\CA\SC\Tomcat\8.5.56
      
      
      
   5. Copy the 9.0.55 directory structure and place in “..\CA\SC\Tomcat”.
      
      
   6. Rename the folder name as 8.5.56.
      
      
   7. Navigate to the conf folder and edit the server.xml file (..\CA\SC\Tomcat\9.0.55\conf)  and comment the below property (This item might already be updated with the requested change). 
      
      Existing:
      <Connector port="8009" protocol="AJP/1.3" redirectPort="8443" />
      
      New change:
      <!-- <Connector port="8009" protocol="AJP/1.3" redirectPort="8443" /> -->
      
      
      Navigate to the directory “\CA\DSM\Web Console\conf” and take a backup of server.xml and try edit original server.xml and update under the below property:   
      Existing:
       <Connector port="8020" protocol="AJP/1.3" redirectPort="8443" />
      
      New change:
       <Connector port="8020" protocol="AJP/1.3" redirectPort="8443" address="0.0.0.0" secretRequired="true" secret="mysecret" />
      
      
      
   8. Navigate to the worker.properties file in “ CA\DSM\Web Console\jakarta\worker.properties” and update/add the “worker.ajp13w.secret=mysecret” entry as shown below:
      
      
      1. worker.ajp13w.type=ajp13
      2. worker.ajp13w.host=localhost
      3. worker.ajp13w.port=8020
      4. worker.ajp13w.secret=mysecret
         
         
         
   9. Run the below commands from the command prompt:
      1. iisreset /stop
      2. iisreset /start
      3. caf start tomcat
         
         
   10. Now, launch the WAC (Web Admin Console).
       
       
   11. Open the catalina.20xx-xx-xx log file from “CA\DS\Web Console\logs” and observe the log you can see in the updated tomcat version (Starting Servlet engine: [Apache Tomcat/9.0.55]) entries

   

Content Import Client (CIC):

If Content Import Client (CIC) uses Tomcat 8.5.56 version, upgrade to the latest version (9.0.55), perform the following steps:

1. Download the 9.0.55, 32-bit Tomcat for windows from Apache Tomcat
   
   
   
   
2. Extract the downloaded zip file.
   
   
3. Take backup of existing Tomcat folder (i.e.,  CA\SC\CIC\Tomcat).
   
   
4. Run in command prompt "ShutdownCICManager.bat”, “shutdown.bat” from the location ..\CA\SC\CIC\Tomcat\bin (SET JRE_HOME=C:\Program Files (x86)\CA\SC\CIC\jre).
   
   
5. Copy the 9.0.55 entire directory structure and place in the “..\CA\SC\CIC”. Rename the folder name as Tomcat.
   
   
6. Navigate to the bin (Tomcat\bin) directory under backup Tomcat folder structure copy these files LaunchCICManager.bat, ShutdownCICManager.bat and place in latest bin directory (..\CA\SC\CIC\Tomcat\bin).
   
   
7. Navigate to the conf folder and edit the server.xml file under..\CA\SC\ CIC\Tomcat\ conf and replace the following existing content with (This item might already be updated with the requested change):

Existing:
<Connector port="8009" protocol="AJP/1.3" redirectPort="8443" />

New change:
<!-- <Connector port="8009" protocol="AJP/1.3" redirectPort="8443" /> -->

8. Navigate to the webapps directory ...\CA\SC\CIC\Tomcat\webapps and delete or move the ROOT Directory from there. Copy the old ROOT, CICManager directories and CICManager.war file from backup Tomcat folder and place to the new webapps directory.
   
   
9. Run the following batch files from the location ..\CA\SC\CIC\Tomcat\bin to start the Tomcat and CIC Manager services (SET JRE_HOME=C:\Program Files (x86)\CA\SC\CIC\jre).
   
   
   1. Startup.bat
   2. LaunchCICManager.bat

10. Open the latest Log file from “CA\SC\CIC\Tomcat\logs” and observe the catalina.20xx-xx-xx log file. You can see latest Tomcat (Starting Servlet engine: [Apache Tomcat/9.0.55]) version entries.  

 

 

Tomcat 8.5.56 to 9.0.55 for ENC:

1. CAF stop 
   
   
2. Backup the Tomcat directory (C:\Program Files (x86)\CA\DSM\ENC\Tomcat)
   
   
3. Placed the Tomcat 9.0.55 files and folders
   
   
4. Copied the " encServer" folder from backup directory to the  C:\Program Files (x86)\CA\DSM\ENC\Tomcat\webapps
   
   
5. CAF start
   
   
6. Verified version information after upgrade ( C:\Program Files (x86)\CA\DSM\ENC\Tomcat\bin) : <versioninfo.bat> upgraded to 9.0.55
   
   
7. caf status encserver (state: Running)
   
   
8. I executed the following commands, but no information captured to the log file  C:\Program Files (x86)\CA\DSM\ENC\Tomcat\logs

encutilcmd server -server

encutilcmd server -client

 

If no information are captured, the Problem could be with the port in “...\ENC\Tomcat\conf\server.xml”

<Connector port="8080" protocol="HTTP/1.1"
               connectionTimeout="20000"
               redirectPort="8443" />

 

The port number 8080 has to be changed to the one given at the time installation.

 And also when Tomcat is replaced, please make sure the examples application is deleted from..\Tomcat\webapps\examples in all instances of tomcat.