How to upgrade the Control-M/Enterprise Manager supplied Web Server (Tomcat 8.5.31) in Control-M 9.0.19? |
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 1) Download the latest available Tomcat minor version 8.5.xx binaries from https://tomcat.apache.org/download-80.cgi (Binary distribution Core, ZIP or tar.gz file)
Or Tomcat minor version 9.0.xx binaries 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:
11) Delete all folders under destination directory "webapps" except ROOT folder, but do not delete any of the .war files. a. Windows: %EM_HOME%/emweb/tomcat/webapps b. UNIX: $EM_HOME/etc/emweb/tomcat/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" 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. |