Method 2: Migrate to new server, then upgrade software

Technical Articles
Solution
Application
Content Type
Technical Documentation
Utilities & Services
ft:locale
en-US

If you have decided to migrate first and then upgrade the software, ensure the older software versions are (temporarily) compatible with the new server.

Requirements

  • The Jamf Pro Installer for the operating system of the new server which matches the version of Jamf Pro installed on the existing server

  • MySQL and Java installers for the operating system of the new server which match the software versions installed on the existing server

  1. Stop Tomcat and back up the existing Jamf Pro database. For instructions, see Backing Up the Database Using Jamf Pro Server Tools.
  2. Copy the database backup from the existing server to the new server or another location which will be accessible from the new server.
  3. (Optional) Copy the JSS folder from the existing server to the new server or another location which will be accessible from the new server. This will make it easier to restore or reference previous configuration files on the new server should the need arise. The paths to the JSS folder are:

    • Linux: /usr/local/jss/

    • Windows: C:\Program Files\JSS\

  4. Update the DNS entry to point to the new server's IP address, or, if you are re-using the IP address of the existing server, shut down the existing server before configuring the new server.
  5. Install the same versions of MySQL, Java, and Jamf Pro on the new server that are installed on the existing server, and create the database on the new server. Follow the instructions in the Jamf Pro Installation and Configuration Guide for the version of Jamf Pro that you are installing:
  6. Stop Tomcat on the new server.
  7. Use Jamf Pro Server Tools to restore the backup on the new server. For instructions, see Restoring Database Backups Using Jamf Pro Server Tools.
    Note:

    You may need to use the legacy Jamf Pro database utility to restore the database depending on the version of Jamf Pro installed on the existing server.

  8. Start Tomcat on the new server.
  9. Re-upload or create the SSL certificate in the new Jamf Pro. For more information, see SSL Certificate in the Jamf Pro Documentation
    Note:

    You may also use the keystore file from the previous host server. See "Additional Information" below for details.

  10. Restart Tomcat.
  11. Verify the Jamf Pro web application can be accessed at the expected Jamf Pro URL.
  12. Upgrade the new host server to the most current MySQL, Java, and Jamf Pro following the instructions in the Incremental Upgrade Scenarios for Jamf Pro 10.0.0 or Later article.
  13. Verify the Jamf Pro web application can be accessed at the expected Jamf Pro URL.