Migrating to Java 11 on Jamf Infrastructure Manager Servers

Beginning with Jamf Infrastructure Manager 2.1.0, Java 11 is required for server environments. You will need to ensure your Infrastructure Manager server is running one of the supported distributions of Java 11 before upgrading. When you are ready to upgrade, you can migrate to a supported distribution of Java 11 on your Infrastructure Manager server. This migration consists of the following steps:

  1. Stopping the Jamf Infrastructure Manager service

  2. Uninstalling Java 8

  3. Installing Java 11

  4. Updating the Jamf Infrastructure Manager service

Stopping the Jamf Infrastructure Manager Service

Stopping the Service on Linux

  1. Open a terminal.

  2. Execute the following command.

    sudo service jamf-im stop

Stopping the Service on Windows

  1. Open Services.

  2. Locate Jamf Infrastructure Manager in the list of services and click it.

  3. Click Stop the service.

Uninstalling Java 8

To uninstall Java 8, refer to the instructions below for your server platform and currently installed distribution of Java.

Uninstalling Java 8 on Ubuntu

Java 8

  1. Open a terminal.

  2. Execute the following commands:

    sudo update-alternatives --remove "java" "/usr/lib/jvm/jdk1.8.0/bin/java"
    sudo update-alternatives --remove "javac" "/usr/lib/jvm/jdk1.8.0/bin/javac"    
    sudo update-alternatives --remove "javaws" "/usr/lib/jvm/jdk1.8.0/bin/javaws"
    sudo rm -r /usr/lib/jvm/jdk1.8.0
    
    Note:

    Replace "jdk1.8.0" in each of the above commands with the path to the jdk on your server.

Amazon Corretto (OpenJDK) 8:

See the following documentation from Amazon for instructions:

https://docs.aws.amazon.com/corretto/latest/corretto-8-ug/generic-linux-install.html

OpenJDK 8:

  1. Open a terminal.

  2. Execute the following command:

    sudo apt remove openjdk-8-jdk
    

Uninstalling Java 8 on Windows

To uninstall Java 8 on Windows, refer to the following instructions for your server's currently installed distribution of Java.

Uninstalling Java 8

To uninstall Java 8, see the following documentation from Oracle for instructions:

https://www.java.com/en/download/help/uninstall_java.xml

Uninstalling Amazon Corretto (OpenJDK) 8

See the following documentation from Amazon for instructions:

https://docs.aws.amazon.com/corretto/latest/corretto-8-ug/windows-7-install.html

To Uninstall Red Hat OpenJDK 8

  1. Open Control Panel.

  2. Click Uninstall a program.

  3. Select Java from the list of programs.

  4. Click Uninstall.

  5. When the confirmation message appears, click Yes.

  6. Repeat steps three through five for any additional iterations of Java appearing in the list of programs.

Installing Java 11

See the Installing Java and MySQL for Jamf Pro 10.14.0 or Later article for instructions on installing Java 11 on your Jamf Pro server or Infrastructure Manager server.
Important:

Install Java only. Do not reinstall MySQL on your Jamf Pro Server.

Note:

(For Windows server environments migrating to Amazon Corretto and running Jamf Pro 10.14.0, 10.15.0, or 10.16.0) After Amazon Corretto (OpenJDK) 11 and Jamf Pro are installed, incompatible Tomcat settings from the older version of Java may remain and prevent Jamf Pro from starting. As a workaround, open the Tomcat Properties window, click the Java tab, and remove the following line from the Java Options field:

-Djava.endorsed.dirs=C:\Program Files\JSS\Tomcat\endorsed

Then, start Tomcat. For assistance with this issue, contact Jamf Support.

Updating the Jamf Infrastructure Manager Service

Refer to the following steps for your server's operating system to update your Infrastructure Manager service and configure it to work with Java 11.

Updating the Service on Windows

  1. Verify the environment variables are set correctly by doing the following:

    1. Navigate to the Advanced System Settings section of the Control Panel.

    2. In the System Properties window, click the Environment Variables button.

    3. In the System variablessection of the Environment Variables window, ensure that the JIM_HOME, JAVA_HOME, and JRE_HOME environment variables are pointed to locations similar to the following:

      JIM_HOME

      C:\Program Files\Jamf\Infrastructure Manager

      JAVA_HOME

      C:\Program Files\Java\jdk<version>

      JRE_HOME

      C:\Program Files\Java\jre<version>

      Note:

      Replace the "jdk<version>" and "jre<version>" in the above examples with the paths to the jdk and jre folders on your server.

  2. Install Infrastructure Manager 2.1.0 or later.

    For instructions, see the Installing a Jamf Infrastructure Manager Instance section of the Jamf Infrastructure Manager Installation Guide.

Updating the Service on Linux

  1. Install Infrastructure Manager 2.1.0 or later.

    For instructions, see the Installing a Jamf Infrastructure Manager Instance section of the Jamf Infrastructure Manager Installation Guide.

  2. Start the Jamf Infrastructure Manager service by executing the following command:

    sudo service jamf-im start