Replacing Oracle JRE with AdoptOpenJDK for TrueSight Presentation Server

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

The script performs the following tasks:

1. Stopping the TrueSight Presentation Server.
2. Taking a backup of the Oracle JRE.
3. Replacing the Oracle JRE with AdoptOpenJDK.

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

   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. Starting the services (Windows) or processes (Linux).

Prerequisites

Ensure that:

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

To run the script

Do the following:

1. Download the 64-bit files of AdoptOpenJDK 8 from this location: AdoptOpenJDK

2. Extract the downloaded files to a temporary directory.
3. Navigate to the directory that contains the AdoptOpenJDK script:
   
   • Windows: <installer_directory>\Windows\utilities
   • Linux: <installer_directory>/Linux/utilities
4. Use one of the following commands to run the AdoptOpenJDK script:
   • (Windows) Update_Adopt_JRE_For_TSPS.bat
   • (Linux) ./Update_Adopt_JRE_For_TSPS.sh
5. When you are prompted to restart the component, type y to continue.
6. 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.
7. 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
8. 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.