Reverting to a Previous Version of Jamf Pro after a Failed Upgrade

This article explains how to revert to a previous version of Jamf Pro after a failed upgrade.
Note:

The instructions in this article should only be used for a failed upgrade. If you revert a Jamf Pro installation that has been in production to a previous version of Jamf Pro, you will lose all management tasks, such as policies, in your environment.

Warning:
You must use Jamf Pro Server Tools 2.7.7 or later to perform database backups with Jamf Pro 10.27.0 or later. Using an earlier version of Jamf Pro Server Tools to back up your database will result in an unrestorable backup. After installing or upgrading to Jamf Pro 10.27.0 or later, confirm which version of Jamf Pro Server Tools you have installed by doing one of the following:
  • CLI: Execute the following command: jamf-pro --version

  • GUI: Verify the installed versions of the GUI and CLI displayed on the Preferences pane.

If you do not have Jamf Pro Server Tools 2.7.7 or later installed, see the installation instructions in the following articles:

Reverting to a Previous Version of Jamf Pro after a Failed Upgrade on Linux

  1. Ensure your database is backed up. See Backing Up the Database in the Jamf Pro Installation and Configuration Guide for Linux for complete instructions.
  2. On the Jamf Pro host server, stop Tomcat. See Starting and Stopping Tomcat for complete instructions.
  3. Open a command prompt.
  4. If you have set the value of the PATH environment to include the MySQL directory, access the MySQL command line as "root" by executing the following command:
    mysql -u root -p
    If you have not set the value of the PATH environment to include the MySQL directory, access the MySQL command line as "root" by executing a command similar to the following:
    <path-to-mysql>/mysql -u root -p
    Note:

    Replace <path-to-mysql> above with the path to MySQL. The default path for MySQL is usually /usr/bin/mysql. You may need to use a custom path if it is installed in a different location.

  5. When prompted, enter the password for the MySQL "root" user.
  6. Drop the database by executing the following command:
    drop database jamfsoftware;
  7. Create a database by executing the following command:
    create database jamfsoftware;
  8. Exit MySQL by executing the following command:
    exit
  9. Open a command prompt and execute the following command to back up your JSS folder:
    sudo mv /usr/local/jss /desired/path/for/backup
    Note:

    If a large number of backups exist in the /usr/local/jss/backups directory, backing up or copying the JSS folder could take a long time. You may want to move the backups folder out of the JSS folder, make a copy of the JSS folder, and then put the backups folder back where it was. It is also recommended that you have a copy of the most recent backup files from the backups folder stored in a secure, off-server location.

  10. Download a previous version of the Jamf Pro Installer for Linux from Jamf Account and install a previous version of Jamf Pro.
  11. Restore your database backup. See Restoring Database Backups in the Jamf Pro Installation and Configuration Guide for Linux for complete instructions.
  12. Create or upload an SSL certificate. See SSL Certificate in the Jamf Pro Administrator's Guide for complete instructions.

Reverting to a Previous Version of Jamf Pro after a Failed Upgrade on Windows

  1. Ensure your database is backed up. See Backing Up the Database in the Jamf Pro Installation and Configuration Guide for Windows for complete instructions.
  2. On the Jamf Pro host server, stop Tomcat. See Starting and Stopping Tomcat for complete instructions.
  3. Uninstall Jamf Pro:
    1. Navigate to the Control Panel, and then click Uninstall a Program under the Programs heading.
    2. Select Jamf Pro from the list of installed programs, and then click Uninstall.
    3. Click Yes when prompted.
  4. Open the MySQL Command Line Client.
  5. When prompted, enter the password for the MySQL "root" user.
  6. Drop the database by executing the following command:
    drop database jamfsoftware;
  7. Create a database by executing the following command:
    create database jamfsoftware;
  8. Exit MySQL by executing the following command:
    exit
  9. Backup the Jamf Pro folder, located at C:\Program Files\JSS\, by copying it to a secure location.
    Note:

    If a large number of backups exist in the C:\Program Files\JSS\Backups directory, backing up or copying the JSS folder could take a long time. You may want to move the Backups folder out of the JSS folder, make a copy of the JSS folder, and then put the Backups folder back where it was. It is also recommended that you have a copy of the most recent backup files from the Backups folder stored in a secure, off-server location.

  10. Download a previous version of the Jamf Pro Installer for Windows from Jamf Nation and install a previous version of Jamf Pro.
  11. Restore your database backup. See Restoring Database Backups in the Jamf Pro Installation and Configuration Guide for Windows for complete instructions.
  12. Create or upload an SSL certificate. See SSL Certificate in the Jamf Pro Administrator's Guide for complete instructions.

Reverting to a Previous Version of Jamf Pro after a Failed Upgrade on macOS

  1. Ensure your database is backed up. See Backing Up the Database in the Jamf Pro Installation and Configuration Guide for Mac for complete instructions.
  2. On the Jamf Pro host server, stop Tomcat. See Starting and Stopping Tomcat for complete instructions.
  3. Open Terminal.
  4. If you have set the value of the PATH environment to include the MySQL directory, access the MySQL command line as "root" by executing the following command:
    mysql -u root -p
    If you have not set the value of the PATH environment to include the MySQL directory, access the MySQL command line as "root" by executing a command similar to the following:
    <path-to-mysql>/mysql -u root -p
  5. When prompted, enter the password for the MySQL "root" user.
  6. Drop the database by executing the following command:
    drop database jamfsoftware;
  7. Create a database by executing the following command:
    create database jamfsoftware;
  8. Exit MySQL by executing the following command:
    exit
  9. Back up the Jamf Pro folder, located at /Library/JSS/, by copying it to a secure location.
    Note:

    If a large number of backups exist in the /Library/JSS/Backups directory, backing up or copying the JSS folder could take a long time. You may want to move the Backups folder out of the JSS folder, make a copy of the JSS folder, and then put the Backups folder back where it was. It is also recommended that you have a copy of the most recent backup files from the Backups folder stored in a secure, off-server location.

  10. Download a previous version of Jamf Pro from Jamf Account, and then run the Jamf Pro Installer for Mac to install a previous version of Jamf Pro.
  11. Restore your database backup. See Restoring Database Backups in the Jamf Pro Installation and Configuration Guide for Mac for complete instructions.
  12. Create or upload an SSL certificate. See SSL Certificate in the Jamf Pro Administrator's Guide for complete instructions.