Documentation forWeb Help Desk

(Optional) Update OpenJDK to another version

Beginning in version 12.7.1, Web Help Desk includes the Open Java Development Kit (OpenJDK). This software is a free and open-source implementation of the Oracle Java Platform.

OpenJDK replaces Oracle Java SE 8, which requires a commercial license. By default, Web Help Desk includes a supported OpenJDK version with each release.

If you are running Web Help Desk 12.7.8 or later on a Windows-based server, you can download and install another OpenJDK version, replacing the version included with your release.

Both versions must be identical. For example, if you are running OpenJDK 11.0.22, you can download and install another OpenJDK 11 version. Upgrading from OpenJDK 11 to a later version (such as OpenJDK 13) is not supported.

This procedure is not supported on Linux and macOS deployments.

Identify your OpenJDK version

  1. Log in to Web Help Desk as an administrator.

  2. Click Setup > General > System Information.

  3. In the System Environment screen, record the Java version and Java home path for your deployment.

  4. Close Web Help Desk.

Download the Java Platform SE Development Kit

  1. Log in to the Web Help Desk server as an administrator.

  2. Open a Web browser and navigate to the Microsoft Docs website.

  3. Locate and download an OpenJDK version that matches your current version. For example, if you are running OpenJDK 11.0.22, you can download another OpenJDK 11 version.

  4. Run the installer on the Web Help Desk server.

Update Web Help Desk with the new OpenJDK version for Windows

  1. Open File Explorer and navigate to the directory that contains the bin\java.exe file.

    For example:

    C:\Program Files\Microsoft\jdk-11.0.22-hotspot

  2. Open a second File Explorer window and navigate to:

    <WebHelpDesk>\conf

    where <WebHelpDesk> is the location of your Web Help Desk home folder.

    For example:

    C:\Program Files\WebHelpDesk

  3. Open the whd.conf file using a text editor (such as Notepad).

  4. Scroll down to:

    # Java home location

  5. Set the JAVA_HOME property with the full path to the Java executable mentioned in step 1.

    For example:

    JAVA_HOME=C:\Program Files\Microsoft\jdk-11.0.22-hotspot

  6. Stop and then start the Web Help Desk Services.

  7. Log in to Web Help Desk as an administrator.

  8. Click Setup > General > System Information.

  9. In the System Environment screen, locate Java Version.

  10. Verify that the new Java platform and Java home path displays on the screen.

    The OpenJDK update is completed.

Update Web Help Desk with the new OpenJDK version for Linux

  1. Install OpenJDK with latest version.( java-11-openjdk-11.0.21.0.9-1.el7_9.x86_64)

    sudo yum install java-11-openjdk-devel

  2. Locate the path to jdk usually reside in /usr/lib/jvm

    For example:

    $cd /usr/lib/jvm

  3. Check the latest installed JRE

    /usr/lib/jvm/jre-11-openjdk

  4. Open the whd.conf file using a vim editor

  5. Scroll down to:

    # Java home location

  6. Set the JAVA_HOME property with the full path to the Java executable mentioned in Step 1.

    For example:

    JAVA_HOME= /usr/lib/jvm/jre-11-openjdk

  7. Stop and then start the Web Help Desk Services.

  8. Log in to Web Help Desk as an administrator.

  9. Click Setup > General > System Information.

  10. In the System Environment screen, locate Java Version.

  11. Verify that the new Java platform and Java home path displays on the screen.
    The OpenJDK update is completed.

Update Web Help Desk with the new OpenJDK version for MacOS

  1. Open File location and navigate to the directory that contains the

    jre

    For example:

    /Library/Java/JavaVirtualMachines/

  2. Open a second File location and navigate to:

    <WebHelpDesk>\conf
    where <WebHelpDesk> is the location of your Web Help Desk home folder.

    For example:

    /Library/WebHelpDesk

  3. Open the whd.conf file using a text editor

  4. Scroll down to:

    # Java home location

  5. Set the JAVA_HOME property with the full path to the Java executable mentioned in Step 1.

    For example:

    /Library/Java/JavaVirtualMachines/mircosoft-11.jdk/Contents/Home

    JAVA_HOME=/Library/Java/JavaVirtualMachines/mircosoft-11.jdk/Contents/Home

  6. Stop and then start the Web Help Desk Services.

  7. Log in to Web Help Desk as an administrator.

  8. Click Setup > General > System Information.

  9. In the System Environment screen, locate Java Version.

  10. 10. Verify that the new Java platform and Java home path displays on the screen.

    The OpenJDK update is completed.