Manually Upgrading Jamf Pro on Windows

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

Requirements
  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. Use the Jamf Pro Server Tools CLI to stop Tomcat. For instructions, see the Starting and Stopping Tomcat article.
  3. 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.
  4. Open the Jamf Pro Manual Installation ZIP file, and copy the ROOT.war file to C:\Program Files\JSS\Tomcat\webapps.
  5. Use the Jamf Pro Server Tools CLI to start Tomcat. For instructions, see the Starting and Stopping Tomcat article.

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

  6. Stop Tomcat again.
  7. 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.
  8. When prompted, choose to overwrite the existing DataBase.xml file.
  9. 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.
  10. 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.
  11. Start Tomcat again.
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.