Introduction
To ensure a smooth transition, it is important to follow a systematic process while upgrading Tomcat from version 9.0.x to version 9.0.95. This guide outlines a series of steps to help you navigate the upgrade process seamlessly. Each step, from backing up your existing configuration and data to testing the upgraded Tomcat version's functionality, is outlined with clear instructions.
Prerequisite
The user must have admin privileges on the Windows server.
Step-by-Step Instructions
Step#1: Backup Existing Configuration and Data
- Before initiating the upgrade, creating backups of your current Tomcat configuration and data is important. This includes crucial elements such as configuration files (server.xml), Java parameters, and memory pool settings.
- Go to the current Apache-tomcat running inside the bin folder, open the command prompt, and run the command below.
Command: tomcat9w.exe //ES//<service name> - For Java backup, copy the highlighted configuration from the above screenshot.
Note: For Server.xml backup, go to the current apache-tomcat running inside the conf folder and take the file backup.
Step#2: Stop the Tomcat Server
- Halt the currently running Tomcat server through services.
Note: In the Windows search bar, type services, and press Enter. The screenshot below will appear. Navigate to Tomcat services and stop it.
Step#3: Download Tomcat 9.0.95
- Visit the Tomcat downloads page. (https://archive.apache.org/dist/tomcat/tomcat-9/v9.0.95/bin/) and download the 9.0.95 version of Apache Tomcat tailored for Windows.
Step#4: Extract Tomcat 9.0.95
- Extract the downloaded Tomcat 9.0.95 package to a new directory using WinZip, WinRAR, or the Windows built-in extraction tool. Once extraction is complete, proceed with deleting the zip file.
Step#5: Setup Tomcat 9.0.95 as a Service and Copy Configuration
- Uninstall the existing Tomcat service using the command and go to the Old Apache-tomcats > bin folder, open cmd, and run the below command:
service.bat uninstall<service_name>
Example: service.bat uninstall tomcat9 - Set up the new Tomcat 9.0.95 as a service using the command.
- Go to the newly installed Apache-tomcat > bin folder, open the command prompt, and run below the command.
Command: service.bat install tomcat9 - In the same folder of Apache-tomcat inside the bin directory, open the tomcat properties file using the below command:
Command: tomcat9w.exe //ES//tomcat9 - Once you open the file, go to the Java tab and copy the configuration data, such as Java parameters and memory pool settings, we took from Step 1.
Step#6: Check and Update Configuration
- Review the configuration files(server.xml) copied from the old configuration and update the newly installed Apache-tomcat > server.xml file. Check for the startup and shutdown ports along with the SSL configuration.
Step#7: Moving ovaledge.war file Old Apache-tomcat to New Apache-tomcat
- Delete the folders within the New Apache-tomcat and go to the webapps folder.
- Copy the application file ("ovaledge.war") from the old Tomcat webapps directory to the new one.
Step#8: Start Tomcat 9.0.95
- Navigate to the new services and start the newly created Tomcat service name tomcat9.
Testing and Verification
- Ensure successful access to your application via a web browser using the appropriate URL.
- Validate the "OvalEdge" application functions as expected on the upgraded Tomcat version.
- Monitor the Tomcat logs for errors or warnings (logs/catalina.out, logs/catalina.YYYY-MM-DD.log, etc.).
Copyright © 2024, OvalEdge LLC, Peachtree Corners, GA USA