Replacing Oracle JRE with AdoptOpenJDK for TrueSight Presentation Server

Starting from TrueSight Capacity Optimization 11.5 release, the Application Server installer includes AdoptOpenJDK. Therefore, it is not required to download and configure AdoptOpenJDK for the Application Server. 

TrueSight Presentation Server 11.3.02 or 11.3.03 uses Oracle JRE. If you are using any of these versions with TrueSight Capacity Optimization, use the instructions in this topic to replace Oracle JRE with AdoptOpenJDK for TrueSight Presentation Server. 

Related topic

Compatibility-matrix

Using Truesight Presentation Server 11.3.04 and later

Starting from TrueSight Presentation Server11.3.04, the installer includes AdoptOpenJDK. Therefore, it is not required to download and configure AdoptOpenJDK for TrueSight Presentation Server.

You can configure TrueSight Presentation Server to use AdoptOpenJDK 8. Download AdoptOpenJDK 8 and use the script that is packaged with the TrueSight Presentation Server 11.3.02 or 11.3.03 installer to replace Oracle JRE with AdoptOpenJDK 8.

The script performs the following tasks:

  1. Stop the TrueSight Presentation Server.
  2. Take a backup of the Oracle JRE.
  3. Replace the Oracle JRE with AdoptOpenJDK.

  4. Copy the jre\lib\security\cacerts file from Oracle JRE to AdoptOpenJDK.

    Note

    The script restores the <product_home>/jre/lib/security/cacerts file from the Oracle JRE. However, ensure that you manually copy any other customizations for the Oracle JRE to AdoptOpenJDK.

  5. Start the services (Windows) or processes (Linux).

TrueSight Presentation Server supports only 64-bit AdoptOpenJDK.

Prerequisites

Ensure that:

  • The product home environment variable is set.
  • The user who installed the product runs the AdoptOpenJDK script.

  • You have downloaded the 64-bit files of AdoptOpenJDK 8 from AdoptOpenJDK and extracted the downloaded files to a temporary directory.

To run the script

Do the following:

BMC recommends to run the AdoptOpenJDK script using the command prompt. Do not double-click the script file.

  1. Navigate to the TrueSight Presentation Server installation directory that contains the AdoptOpenJDK script:
    • Windows: <presentation_server_installer_directory>\Windows\utilities
    • Linux: <presentation_server_installer_directory>/Linux/utilities
  2. Use the following command to run the AdoptOpenJDK script:
    • (Windows) Update_Adopt_JRE_For_TSPS.bat
    • (Linux) ./Update_Adopt_JRE_For_TSPS.sh
  3. When you are prompted to restart the component, type y to continue.
  4. When prompted, specify the path where you extracted the AdoptOpenJDK files. For example, C:\AdoptOpenJDK
    The script replaces the Oracle JRE with the Adopt JRE and starts the services or processes.
  5. To verify the changes, perform these steps:
    1. Navigate to the following directory:
      • Windows: %TRUESIGHTPSERVER_HOME%\truesightpserver\modules\jre
      • Linux: $TRUESIGHTPSERVER_HOME/truesightpserver/modules/jre
    2. Run the following command:
      • Windows: java.exe -version
      • Linux: java -version
  6. Verify that your TrueSight Presentation Server is up and running.

To troubleshoot issues that might occur while running the script, see Troubleshooting-issues-with-the-OpenJDK-script.

To restore the backed up Oracle JRE

If the AdoptOpenJDK script runs into an error and cannot create the AdoptOpenJDK JRE folder, do the following to restore the Oracle JRE:

  1. Stop all services or processes if they are running.
  2. Take a backup of the current JRE folder.
  3. Rename the jre_oracle_* folder as jre.
  4. Start the services and processes.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*