Procedure to Update Tomcat on Most Typical RMS Installations​

To keep up with the latest bug fixes and security patches of Apache Tomcat, it may be necessary to update to a newer version of Tomcat. This can be achieved through the process below. Unless otherwise noted, the most recent minor version of Tomcat (X.xx.xx) will work with RMS. Please stay within the major version required for RMS. For example, RMS version 4.8.4 requires Tomcat 9.

Please do not uninstall the current version of Tomcat until step 5.
 

1. This will use Apache Tomcat's 32-bit/64-bit Windows Service Installer. The downloaded file will be:
   "apache-tomcat-9.x.x.exe"
2. Search for and open the "Configure Tomcat" application and stop the service.
3. Note the "Log On | Log on as:" setting and the "Java | Java Virtual Machine:" location.
4. Copy the current Tomcat 9.0 folder to a safe location (i.e. Desktop). The folder is commonly located here:
   - C:\Program Files\Apache Software Foundation\Tomcat 9.0 
   
5. Uninstall the current version of Tomcat using the Windows method (search "remove programs").
   - The Uninstaller will ask to remove all files. If NO it will maintain "rms.war" which is fine.
   
6. Run the new version's installer as administrator. (IMPORTANT: right-click/"Run as administrator”).
   - No need to change the port as this is stored in the "server.xml".
   
   - The installer will confirm the Java Virtual Machine. This should be the 'base' Java location noted in step 3. For example: C:\Program Files\Java\jdk-11.0.23\  (not all: \\bin\server\jvm.dll)
   
   - The install location should be that of the original. Typically this is C:\Program Files\Apache Software Foundation\Tomcat 9.0
   
   - On the final screen, "Completing Apache Tomcat Setup", uncheck the "Run Apache Tomcat" box. Do not start Tomcat yet.
7. Replace default server.xml with the original. Copy over rms.war (if not kept). Here are the common locations:
   - C:\Program Files\Apache Software Foundation\Tomcat 9.0\conf\server.xml
   - C:\Program Files\Apache Software Foundation\Tomcat 9.0\webapps\rms.war
8. Search for and run the "Configure Tomcat" application.
9. In the Java tab, set both memory pools to 2048 and add the following to the end of "Java Options":
   -  -XX:MaxMetaspaceSize=200M
   - Make sure not to have a spaceb before or after.
10. On the General tab set the "Startup type:" to Automatic (or delayed).
    
11. Search for and run the "RMS Configuration" application and simply click SAVE. After the process completes, close the application.
    
12. Start the Apache Tomcat service. This initial start of RMS may take longer than usual.
13. RMS should be back in business.