Upgrading Jamf Pro Using the Installer

Upgrading Jamf Pro involves the following steps:

  1. Prepare to upgrade.

  2. Run the Jamf Pro Installer.

    Note: The Jamf Pro Installer cannot be used to upgrade Jamf Pro 8.1 or earlier.

  3. Verify server settings.

  4. (Optional) Disable TLS 1.0 and 1.1 in Java 11.

  5. Complete the upgrade.

Step 1: Prepare to Upgrade

  1. Review the following articles:

  2. Ensure that you have backed up the current database.
    For more information, see Backing Up the Database.

  3. On Windows, ensure the following:

    • You are logged in as a local administrator, not as a domain administrator.

      Note: Full local administrator privileges are required to install Jamf Pro on Windows Server. If you are unable to install Jamf Pro, Group Policy Object restrictions may be the cause. Check the GPO settings or contact someone in your organization who can ensure that GPO restrictions allow you full administrator privileges.

    • Apache Tomcat is stopped.
      For instructions, see the following article:
      Starting and Stopping Tomcat

  4. If you are upgrading from Jamf Pro 10.15.0 or earlier and currently have MySQL 5.7.7 or earlier installed, follow the instructions in the Upgrading to MySQL 8.0 article to upgrade to MySQL 8.0.

  5. If you are upgrading from Jamf Pro 10.13.0 or earlier, follow the instructions in the Migrating to Java 11 article to migrate from Java 8 to Java 11.

Step 2: Run the Jamf Pro Installer

Important: If an upgrade fails, do not click OK . Contact your Jamf account representative immediately.

  1. Copy the most current version of the Jamf Pro Installer for Windows (Jamf Pro Installer.msi) to the server.

  2. To obtain the Jamf Pro Installer for Windows, log in to Jamf Account and navigate to the Products page for Jamf Pro.

  3. Double-click the installer and follow the onscreen instructions to complete the upgrade.

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. The log4j.properties file is backed up to the following location: C:\Program Files\JSS\Backups

Important: If you are upgrading to Jamf Pro 10.6.0 or later, you must make a one-time change to the MySQL configuration to avoid performance issues. See "Step 2. Configure MySQL" in the Creating the Jamf Pro Database Using the Jamf Pro Server Tools Command-Line Interface article for instructions.

Step 3: Verify Server Settings

  1. Verify that the Connector settings for port 8443 in the server.xml file match the settings listed in the Configuring Supported Ciphers for Tomcat HTTPS Connections article, and modify them if needed.

  2. If you modified the server.xml file, restart Tomcat.

Step 4: (Optional) Disable TLS 1.0 and 1.1 in Java 11

(Optional) If you are using the TLS 1.0 or 1.1 protocols in Java 11 for any existing workflows, it is recommended that you disable them since they are deprecated. For instructions, see the following article: Disabling TLS 1.0 and 1.1 in Java 11.

Step 5: Complete the Upgrade

Log in to Jamf Pro and verify devices are checking in as expected.

Note: Due to a display issue that occurs with Internet Explorer, it is recommended that you use Firefox, Chrome, or Safari.

Copyright     Privacy Policy     Terms of Use     Security
© copyright 2002-2022 Jamf. All rights reserved.