How to upgrade the Control-M/Enterprise Manager supplied Web Server (Tomcat 9.0.30) in Control-M 9.0.20?

For Control-M version 9.0.00 or lower please refer to knowledge article 000102371
For Control-M version 9.0.18 the procedure to upgrade Tomcat is documented in knowledge article 000148756
For Control-M version 9.0.19 the procedure to upgrade Tomcat is documented in knowledge article 000271725
For Control-M version 9.0.21 the procedure to upgrade Tomcat is documented in knowledge article 000403085

1)   Download the latest available Tomcat minor version 9.0.xx binaries (where xx is greater than 30) from https://tomcat.apache.org/download-90.cgi   (Binary distribution Core, ZIP or tar.gz file)

2)    Extract the new Tomcat package to a newly created temporary source location on the Control-M/Enterprise Manager server:
       a. Windows: %EM_HOME%/Tomcat_Update
       b. UNIX: $EM_HOME/Tomcat_Update
     
3)    Stop all Control-M/Enterprise Manager components with the following command:
        Unix:  em ctl -mcs -all -C Config_Agent -cmd shutdown
        Windows: ctl -mcs -all -C Config_Agent -cmd shutdown

4)    Make sure all components were stopped:
               All GUI Servers
               GCS
               Naming Service
               CMS
               Configuration Agent (maintag)
               BIM
               Forecast
               Self Service
               All Gateways
               Archive Servers
               Web Servers               
         Note: The Enterprise Manager database should remain running
 
5)    Backup the destination Control-M/Enterprise Manager server “Tomcat” directory (copy to different directory)
       a. Windows: %EM_HOME%/emweb/tomcat
       b. UNIX: $EM_HOME/etc/emweb/tomcat

6)    Rename the destination Control-M/Enterprise Manager server directory tomcat/bin to tomcat/bin-org.

7)    Rename the destination Control-M/Enterprise Manager server directory tomcat/lib to tomcat/lib-org.

8)    Copy the directories “bin” and “lib” from the temporary source location in Step 2 to the destination directory "tomcat".

9)    Copy the files LICENSE, NOTICE, RELEASE-NOTES and RUNNING from the source location in Step 2 to the "tomcat" destination directories(overwrite the existing files)

10)   Copy the following .jar files from the destination directory lib-org in Step 7 into the new destination directory emweb/tomcat/lib:

• BMCHeaderSecurityFilter.jar
• BMCMobileHeaderSecurityFilter.jar
• BMCRFHeaderSecurityFilter.jar
• CustomAccessLog.jar
• bc-fips-1.0.1.jar
• bcmail-fips-1.0.1.jar
• bcpg-fips-1.0.3.jar
• bcpkix-fips-1.0.1.jar
• bmc-data-collection.jar
• commons-codec-1.9.jar
• log4j-1.2.8.jar
• ojdbc8.jar
• postgresql-42.2.6.jar
• security-9.0.jar
• slf4j-api-1.6.4.jar
• slf4j-jdk14-1.7.6.jar
• sqljdbc4.jar
• tomcat-juli.jar
• web_connector.jar

** this file list was taken from comparison between v20 base version of Tomcat 9.0.30 and Tomcat 9.0.39. The file list may different for different versions of Tomcat or Control-M. Simply list all jar files between the original and the new Tomcat env and copy ONLY what is not found in the new Tomcat environment. Keep only one version of each file that is found in the new environment. The database file may also be different depending on what database EM server is connected to. The list above shows posgresql file but you may have Oracle installed there and will see a comprable jar for oracle.
 
11)   Delete all folders under destination directory "webapps"
                    run remove_webapps (in Unix em remove_webapps)    

12)  Delete the AIRepo directory under tomcat directory if not using Control-M Application Integrator.
 
13)    Start all EM components
       a. Windows: Start Service "Control-MEM Configuration Agent" or net start "Control-MEM Configuration Agent"
       b. UNIX: em start_config_agent
 
14)    Only after confirming that the web server starts and Control-M functions properly, delete the destination directories tomcat/bin-org and tomcat/lib-org.

NOTE: To rollback to the previous version, undo the steps performed for steps 5,6 and 7.