Restoring Backups of the Tomcat Directory

Updated: 01 July 2021
Product: Jamf Pro

The Jamf Pro Installer automatically creates a backup of important Jamf Pro files, including the Tomcat directory. This article explains how to restore the backup of the Tomcat directory on the Jamf Pro host server.

You may need to restore the Tomcat directory for several reasons:

  • To correct unintentional changes or corruption to files in the Tomcat directory

  • After migrating Jamf Pro to a new host server (especially to a different OS platform)
    Note:

    Simply replacing the Tomcat directory may not be possible and replacing individual files (e.g., server.xml) or even replacing contents within individual files may be necessary.

  • When attempting to roll back after a failed Jamf Pro upgrade. For more information, see the Reverting to a Previous Version of Jamf Pro after a Failed Upgrade article.
    Note:

    The upgrade process also makes changes to the database, and restoring the database from a backup is also recommended. A mismatch between the Tomcat directory and the database could result in data corruption or a non-functional Jamf Pro.

If you have questions about your situation, contact Jamf Support.

Requirements

Administrator access to the Jamf Pro host server

  1. Locate the backup directory containing the Tomcat directory that you want to restore. The Tomcat directory will be found in a subfolder within the backup directory named with the date and time of the backup. The paths to the backup directories are:

    • Linux: /usr/local/jss/backups

    • Windows: C:\Program Files\JSS\Backups\

    • Mac: /Library/JSS/Backups
      Note:

      Paths to the Tomcat directory backup may differ for older versions of Jamf Pro or for manual installations of Jamf Pro, but the restoration process is similar.

  2. Stop Tomcat. See Starting and Stopping Tomcat for instructions.
  3. Remove the Tomcat directory you want to replace. Paths to the operational Tomcat directory are:

    • Linux: /usr/local/jss/tomcat

    • Windows: C:\Program Files\JSS\Tomcat

    • Mac: /Library/JSS/Tomcat

  4. Using the Tomcat directory identified earlier, copy the Tomcat directory to the operational JSS directory.
  5. Restore the Jamf Pro database, if needed.
  6. Start Tomcat. See Starting and Stopping Tomcat for instructions.