how to upgrade Tomcat 8.5.56 to 9.0.55 for Web Admin Console (WAC) and Content Import Client (CIC) ?
searchcancel
how to upgrade Tomcat 8.5.56 to 9.0.55 for Web Admin Console (WAC) and Content Import Client (CIC) ?
book
Article ID: 232867
calendar_today
Updated On: 03-16-2023
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:
Download the 9.0.55, 32-bit Tomcat for windows from Apache Tomcat website.
Download archived Tomcat version 9.0.55 from URL as shown in below
Extract the downloaded zip file.
Stop the tomcat service (in command prompt : caf stop tomcat).
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
Copy the 9.0.55 directory structure and place in “..\CA\SC\Tomcat”.
Rename the folder name as 8.5.56.
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).
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" />
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:
worker.ajp13w.type=ajp13
worker.ajp13w.host=localhost
worker.ajp13w.port=8020
worker.ajp13w.secret=mysecret
Run the below commands from the command prompt:
iisreset /stop
iisreset /start
caf start tomcat
Now, launch the WAC (Web Admin Console).
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:
Download the 9.0.55, 32-bit Tomcat for windows from Apache Tomcat
Extract the downloaded zip file.
Take backup of existing Tomcat folder (i.e., CA\SC\CIC\Tomcat).
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).
Copy the 9.0.55 entire directory structure and place in the “..\CA\SC\CIC”. Rename the folder name as Tomcat.
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).
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):
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.
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).
Startup.bat
LaunchCICManager.bat
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:
CAF stop
Backup the Tomcat directory (C:\Program Files (x86)\CA\DSM\ENC\Tomcat)
Placed the Tomcat 9.0.55 files and folders
Copied the " encServer" folder from backup directory to the C:\Program Files (x86)\CA\DSM\ENC\Tomcat\webapps
CAF start
Verified version information after upgrade ( C:\Program Files (x86)\CA\DSM\ENC\Tomcat\bin) : <versioninfo.bat> upgraded to 9.0.55
caf status encserver (state: Running)
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”