New docs portal launching December 21st! All Exabeam, LogRhythm, and API documentation is moving to docs.exabeam.com. Existing links will redirect automatically, but we recommend updating your bookmarks.
7.26.0 7.25.0 7.24.0 7.23.0 7.22.0 7.21.0 7.20.0 7.19.0 7.18.0
7.26.0 7.25.0 7.24.0 7.23.0 7.22.0 7.21.0 7.20.0 7.19.0 7.18.0

Upgrade Java Runtime

In certain situations, a software scan may determine that a vulnerability can be solved by updating the version of Java shipped with the LogRhythm platform. Different services on different version of the LogRhythm SIEM platform may be running different Java versions. Customers should upgrade only within the same major release family and the same version (i.e., upgrading a LogRhythm SIEM version 7.26 Web Indexer uses Amazon Corretto 21 and should only be upgraded to a minor version within that same family, such as 21.0.10.0 to 21.0.13.1; upgrading to Amazon Corretto 27 will break the service).

The version of Java released with each LogRhythm version by default is the version upon which LogRhythm has performed full testing and validation. Versions outside of the release version but within the same major version (i.e., any version downloaded using the steps in this guide) should be compatible, but this is not guaranteed.

Windows Update Instructions

Multiple LogRhythm services ship with Java dependencies on Windows. The following sections describe the process for updating Java on Windows devices.

Windows DX Java Services Instructions (Columbo/Carpenter)

To update Amazon Corretto for Windows DX:

  1. Verify the current version of Java by running the following command in a Command Prompt window; this should be a variant of Java 11.0.XX.X:

    "C:\Program Files\LogRhythm\Data Indexer\dependencies\jdk-11\bin\java" -version
    

Make note of the version before updating so that a successful update can be verified later.

  1. Download the latest version of Java 11 Windows x64 JDK ZIP from Amazon at the following link:
    Amazon Corretto Java 11 for Windows

  2. Stop all LogRhythm DX services via the Services window, or by running the following in an admin Command Prompt window:

    "C:\Program Files\LogRhythm\Data Indexer\tools\stop-all-services.bat"
    
  3. Locate the zip file downloaded in step 2 in your Downloads folder, then right-click the file and select “Extract All…”

  4. Navigate to C:\Program Files\LogRhythm\Data Indexer\dependencies.

  5. Rename the existing jdk-11 folder to “jdk-11.bak”.

  6. Copy the folder that you extracted in step 4 into “jdk-11”.

  7. Verify the updated Java version using the following command:

    "C:\Program Files\LogRhythm\Data Indexer\dependencies\jdk-11\bin\java" -version
    
  8. Restart all LogRhythm DX services via the Services window, or by running the following command:

    "C:\Program Files\LogRhythm\Data Indexer\tools\start-all-services.bat"
    

Windows DX OpenSearch Instructions

To update Adoptium Temurin for Windows DX:

  1. Verify the current version of Java by running the following command in a Command Prompt window; this should be a variant of Java 21.0.XX.X:

    "C:\Program Files\LogRhythm\Data Indexer\opensearch\jdk\bin\java.exe" -version
    

Make note of the version before updating so that a successful update can be verified later.

  1. Download the latest version of Java 21 Windows JDK x64 ZIP from Adoptium at the following link: Adoptium JDK 21

  2. Stop the “LogRhythm DX - OpenSearch Service” via the Services window.

  3. Locate the zip file downloaded in step 2 in your Downloads folder, then right-click the file and select “Extract All…”

  4. Navigate to C:\Program Files\LogRhythm\Data Indexer\opensearch.

  5. Rename the existing “jdk” folder to “jdk.bak”.

  6. Copy the folder that you extracted in step 4 into “jdk”.

  7. Verify the updated Java version using the following command:

    "C:\Program Files\LogRhythm\Data Indexer\opensearch\jdk\bin\java.exe" -version
    
  8. Start the “LogRhythm DX - OpenSearch Service” via the Services window.

Windows Web Console Instructions

To update Amazon Corretto for Web Console:

  1. Verify the current version of Java by running the following command in a Command Prompt window:

    "C:\Program Files\LogRhythm\LogRhythm Web Services\LogRhythm Web Indexer\dependencies\jdk\bin\java" -version
    

Make note of the version before updating so that a successful update can be verified later.

  1. Download the latest version of JDK 21 Windows x64 JRE ZIP from Amazon at the following link:
    Amazon Corretto Java 21 for Windows

  2. Stop the LogRhythm Web Indexer service via the Services window.

  3. Locate the zip file downloaded in step 2 in your Downloads folder, then right-click the file and select “Extract All…”

  4. Navigate to C:\Program Files\LogRhythm\LogRhythm Web Services\LogRhythm Web Indexer\dependencies.

  5. Rename the existing jdk folder to “jdk.bak”.

  6. Copy the jdk folder that you extracted in step 4 to the dependencies folder.

  7. Verify the updated Java version using the following command:

    "C:\Program Files\LogRhythm\LogRhythm Web Services\LogRhythm Web Indexer\dependencies\jre\bin\java" -version
    
  8. Restart the LogRhythm Web Indexer service via the Services window.

Linux Update Instructions

Linux DX Java Services Instructions (Columbo/Carpenter):

  1. Verify the current version of Java by running the following command:

    java -version
    

Make note of the version before updating so that a successful update can be verified later.

  1. Download the latest version of Java 11 Linux x64 JDK RPM from Amazon at the following link:
    Amazon Corretto Java for Linux

  2. Save this file to the /home/logrhythm/ directory using WinSCP or a similar tool.

  3. Stop Data Indexer services using the following command:

    sudo sh /usr/local/logrhythm/tools/stop-all-services-linux.sh
    
  4. Install the updated Corretto version using yum as a local install:

    cd /home/logrhythm
    sudo dnf java-11-amazon-corretto-devel-11.0.xx.xx-x.x86_64.rpm
    

    Yum will ask to validate dependencies and whether to proceed with the installation.

  5. Input Y and then press Enter to proceed.
    The installation completes successfully.

  6. Verify the updated Java version using the following command:

    java -version
    
  7. Restart all Data Indexer services using the following command:

    sudo sh /usr/local/logrhythm/tools/start-all-services-linux.sh
    

Linux DX OpenSearch Instructions

To update Adoptium Temurin for Linux DX:

  1. Verify the current version of Java by running the following command in a terminal window; this should be a variant of Java 21.0.XX.X:

    /usr/share/opensearch/jdk/bin/java -version
    

Make note of the version before updating so that a successful update can be verified later.

  1. Download the latest version of Java 21 Linux x64 TAR.GZ from Adoptium at the following link: Adoptium JDK 21

  2. Stop the OpenSearch Service(s).
    The opensearch-data service may not be present depending on your DX model.

    systemctl stop opensearch-data
    systemctl stop opensearch
    
  3. Backup the existing JDK:

    cd /usr/share/opensearch
    mv jdk jdk.bak
    
  4. Copy the “OpenJDK21U-jdk_x64_linux_hotspot_21.0.XX.XX_X.tar.gz” to your user's home directory, usually /home/logrhythm.

  5. Extract the new JDK into the fresh jdk folder:

    mkdir jdk
    tar -xzf ~/OpenJDK21U-jdk_x64_linux_hotspot_21.0.XX.X_X.tar.gz -C jdk --strip-components=1 --no-same-owner
    chown -R root:root jdk
    restorecon -R jdk
    
  6. Verify the updated Java version using the following command:

    /usr/share/opensearch/jdk/bin/java -version
    
  7. Start the OpenSearch Service(s).
    The opensearch-data service may not be present depending on your DX model.

    systemctl start opensearch
    systemctl start opensearch-data
    
  8. After you have confirmed the node is healthy, remove /usr/share/opensearch/jdk.bak.