Upgrading Jamf Pro Using the Installer on Linux

  1. Review the following articles:
  2. Ensure that you have backed up the current database. For more information, see Backing Up the Database.
  3. 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.
  4. 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.
  5. Copy the latest version of the Jamf Pro Installer for Linux (jamfproinstaller.run) to the server.
    Note:

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

  6. Log in to the server as a user with superuser privileges.
  7. Initiate the installer by executing:
    sudo sh /path/to/jamfproinstaller.run
  8. Follow the onscreen instructions to complete the upgrade.
    Note:

    If your server has less available disk space than recommended to install Jamf Pro, you will be prompted to either continue or abort the installation process. Type “y” to proceed or “n” to abort.

    You can bypass the disk space check by executing the installer with the -d flag. Execute a command similar to the following:

    sudo sh /path/to/jamfproinstaller.run -- -d
  9. 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.
  10. If you modified the server.xml file, restart Tomcat.
  11. Configure Jamf Pro to start automatically when the server is rebooted:
    1. Check the state of the Tomcat service's “enabled on boot” setting by executing the following command:
      sudo systemctl is-enabled jamf.tomcat8.service
    2. If the result indicates the Tomcat service is “disabled”, enable the service permanently by executing the following command:
      sudo systemctl enable jamf.tomcat8
    3. Confirm the “enabled on boot” setting is "enabled" by executing the following command:
      sudo systemctl is-enabled jamf.tomcat8.service
    4. If the Tomcat service is not already running, you can start the Tomcat service manually by rebooting the server or by executing the following command:
      sudo systemctl start jamf.tomcat8
  12. (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 Disabling TLS 1.0 and 1.1 in Java 11 article.
  13. Log in to Jamf Pro and verify devices are checking in as expected.
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: /usr/local/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 3. Configuring MySQL" in the Creating the Jamf Pro Database Using the Jamf Pro Server Tools Command-Line Interface article for instructions.