Upgrading to Tomcat 10 and JDK 17

This document is designed to give system administrators step by step instructions on how to update to Tomcat 10 and JDK 17.

Before we begin, please note these instructions are designed for standard Windows installations. If you are utilizing any of the following, please consider engaging m-Power in a services agreements for us to do this conversion for you as we are familiar with these types of customized solutions:

• Load Balancing
• Clustering
• SSL
• mod_jk to communicate between Tomcat/Apache
• Custom Contexts
• Reverse Proxies

Step 2: Install JDK 17

1. Download JDK 17 from Amazon Corretto.
2. Run the Corretto installer.
3. Restart the server.

Step 4: Remove Tomcat 9 Services

1. Stop existing Tomcat services.
2. Open CMD mode as Administrator.
3. Navigate to C:\Program Files\mrc\development\m-power\tomcat\bin.
4. Type service remove TC9DEV
5. Navigate to C:\Program Files\mrc\development\m-power

If upgrading from Tomcat 7, reference TC7DEV instead of TC9DEV.

When removing the production Tomcat service, the service name is TC9PROD.

Step 5: Install Tomcat 10

1. Download the Windows version of Tomcat 10 from mrc here.
2. Rename the existing \mrc\development\m-power\tomcat folder to tomcat9.
3. Unzip the downloaded files into C:\Program Files\mrc\development\m-power. When completed you should have a C:\Program Files\mrc\development\m-power\tomcat folder.
4. If you connect to MSSQL or MySQL, move over the necessary driver jar files from \tomcat9\lib to \tomcat\lib.
   
   

   If you connect to MSSQL and coming from JDK 8, please follow the additional required steps for Installing a New JDBC Driver and Configure m-Power SQL Server Properties.

   
   
5. Examine the server.xml in \tomcat9\conf. Specifically, note the shutdown port, connector port, and contexts. Ensure these changes are made within the server.xml in the new \tomcat\conf folder.
   
   
   
   
   
   

Step 6: Install Tomcat 10 Services

1. Open CMD mode as Administrator.
2. Navigate to C:\Program Files\mrc\development\m-power\tomcat\bin
3. Type service install TC10DEV and press Enter.
4. When the service is installed, type tomcat10w //ES//TC10DEV and press Enter.
5. In the General tab, ensure that the startup type is Automatic.
6. In the Java tab set the JVM to the appropriate jvm.dll (found in a path similar to C:\Program Files\Amazon Corretto\jdk17.0.X_X\bin\server\jvm.dll
7. Back in the General tab, press Start.

When installing the production Tomcat service, the service name should be TC10PROD.

Step 7: Convert Apps to use Tomcat 10

1. Open CMD mode as Administrator.
2. Navigate to C:\Program Files\mrc\development\m-power\tomcat\lib.
3. Run the following command java -jar jakartaee-migration-1.0.8-shaded.jar "C:\Program Files\mrc\development\m-power\mrcjava\WEB-INF\classes" "C:\Program Files\mrc\development\m-power\mrcjava\WEB-INF\classes-out"
4. Rename the \m-power\mrcjava\WEB-INF\classes folder to classes_tc9.
5. Rename the \m-power\mrcjava\WEB-INF\classes-out folder to classes.
6. Restart development Tomcat.

Step 8: Apply Update

Sign into the m-Power Development interface and click “Apply Update” when prompted.

Step 9: Production/Other Tomcat Environments

Repeat above steps 1 and 4-7 for your production environments (or any other Tomcat environments you have).

Be sure to substitute any path reference of ‘development’ with the appropriate environment.

Non-Windows Installations

For Linux/iSeries m-Power installations, the steps are generally the same as above:

1. Update to the October 2024 version of m-Power (or later) from here.
   • Follow all of the next steps prior to signing into the interface to apply the update.
2. Download and run the appropriate JDK 17 installer for your server.
3. Restart the server after installing.
4. Follow the above steps to Install Tomcat 10.
5. Follow the above steps to Convert Apps to use Tomcat 10.
   • Note: Navigate to your specific m-power folder as you will not have a C:/Program Files directory