The following instructions explain how to use the ROOT.war file to manually upgrade Jamf Pro on Windows.

1. To obtain the Jamf Pro Manual Installation ZIP file, log in to Jamf Account and navigate to the Products page for Jamf Pro.

2. On your Windows server, create a backup of the current database. For instructions, see Backing Up the Database.

3. Create a backup of the Tomcat directory located in C:\Program Files\JSS\Tomcat.

4. Stop Tomcat:

   1. Right-click the Start menu, and select Computer Management.

   2. Under Services and Applications, click Services.

   3. Click Apache Tomcat 8.5 in the Services list, and then click Stop.

5. Move the existing ROOT.war file and ROOT folder from C:\Program Files\JSS\Tomcat\webapps\ to a location outside of that directory. Keep the older ROOT.war file and ROOT folder until the upgrade is complete.

6. Open the Jamf Pro Manual Installation ZIP file, and copy the ROOT.war file to C:\Program Files\JSS\Tomcat\webapps.

7. Ensure you have the latest version of the Jamf Pro Server Tools command-line interface. For download and installation instructions, see the The Jamf Pro Server Tools Command-Line Interface article.

8. Start Tomcat:

   1. Right-click the Start menu, and select Computer Management.

   2. Under Services and Applications, click Services.

   3. Click Apache Tomcat 8.5 in the Services list, and then click Start.

   The ROOT.war unpacks during this time, which may take several minutes.

9. Stop Tomcat again.

10. Go to the \ROOT\WEB-INF\xml\ directory in the ROOT folder that you moved earlier, and copy the DataBase.xml file to C:\Program Files\JSS\Tomcat\webapps\ROOT\WEB-INF\xml.

11. When prompted, choose to overwrite the existing DataBase.xml file.

12. Go to the \ROOT\WEB-INF\classes\ directory in the ROOT folder that you moved earlier, and copy the ESAPI.properties and log4j2.xml files to C:\Program Files\JSS\Tomcat\webapps\ROOT\WEB-INF\classes.

13. When prompted, choose to overwrite the existing files.

    Important: If you are using memcached in your environment, also copy the cache.properties and memcached.properties files from \ROOT\WEB-INF\classes\dal\ in the ROOT folder that you moved earlier to C:\Program Files\JSS\Tomcat\webapps\ROOT\WEB-INF\classes\dal.

14. Important: If you customized the log4j.properties file in Jamf Pro 10.30.x or earlier, you must edit the log4j2.xml file and reapply your customizations.

15. Start Tomcat again.

The upgrade is complete.