Manually Upgrading Jamf Pro on Linux

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

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.
    Alternatively, you can execute the following command:
    sudo systemctl stop jamf.tomcat8.service
  3. Move the existing ROOT.war file and ROOT folder from /usr/local/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 /usr/local/jss/tomcat/webapps.
  5. Use the Jamf Pro Server Tools CLI to start Tomcat. For instructions, see the Starting and Stopping Tomcat article.
    Alternatively, you can execute the following command:
    sudo systemctl start jamf.tomcat8.service

    The ROOT.war unpacks, 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 /usr/local/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 /usr/local/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 /usr/local/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.