Replacing Oracle JRE with Azul 8 Java
The TrueSight Operations Management products can now be configured to use Azul 8 Java. The Azul 8 Java licence is included in the BMC license for TrueSight Operations Management. A separate license for Azul is not required.
Note: Java applets not supported
The Azul JRE does not support Java applets. If you are using Java applets, you must use the Oracle JRE 8 on the client browser to access SNMP Adapter Configuration Manager.
Downloading the Azul 8 Java files
This section provides information about downloading the Azul 8 Java files.
About copying Azul libraries and scripts
You must copy the Azul library and script files in the same drive where the product is installed.
Downloading files for version 11.3.01
For TrueSight Operations Management version 11.3.01, see Technical bulletin — Announcing Azul 8 Java support for TrueSight Operations Management 11.3.01.
Downloading files for version 11.3.02
You can download the Azul 8 Java files that are available at the following locations:
- On the FTP server for TrueSight Presentation Server, TrueSight Infrastructure Management, and Integration Services
- On the BMC Electronic Product Distribution (EPD) website for all other components
Azul 8 Java is supported on the following components:
Component | Required binaries | Link to download files from the FTP server or EPD |
---|---|---|
TrueSight Presentation Server | 64-bit only | |
TrueSight Infrastructure Management | For Linux, 64-bit only For Windows, 32-bit and 64-bit | |
TrueSight IT Data Analytics | 64-bit only | |
TrueSight App Visibility Manager | 64-bit only | |
Impact Integration Web Services | 32-bit only | |
Integration Services | 32-bit and 64-bit |
Using Azul JRE for Integration Service and Remote Administrator Console 11.3.02
If you want to use the Azul JRE for Integration Service or Remote Administrator Console 11.3.02, before installing these products, ensure that you set the JAVA_HOME
environment variable to the 64-bit Azul JRE folder.
Note: Recommendation to use the command prompt
It is recommended that you run the Azul script by using the command prompt. Do not double-click the script file to run it.
Downloading files for version 11.3.03
For version 11.3.03, the Azul 8 Java scripts are available with the installer files, and the Azul binaries are available on the EPD.
Azul 8 Java is supported on the following components:
Component | Required binaries | Link to download binaries from the EPD |
---|---|---|
TrueSight Presentation Server | 64-bit only | |
TrueSight Infrastructure Management | For Linux, 64-bit only For Windows, 32-bit and 64-bit | |
TrueSight App Visibility Manager | 64-bit only | |
Integration Services | 32-bit and 64-bit |
Running the Azul 8 Java scripts for version 11.3.xx
Running the Azul script performs the following tasks:
- Stops the relevant component.
- Takes a backup of the Oracle JRE.
- Replaces the Oracle JRE with the Azul JRE.
(Not applicable to TrueSight App Visibility Manager) Copies the jre\lib\security\cacerts file from Oracle JRE to Azul JRE.
Important: Restoring customized security files
The script restores the <product_home>/jre/lib/security/cacerts file from the Oracle JRE. However, ensure that other customizations to the Oracle JRE are manually copied to the Azul JRE.
- Starts the services (Windows) or processes (Linux) for the relevant component.
Replacing with the Azul 8 Java
This section provides instructions to replace the Oracle JRE with Azul 8 Java.
Prerequisites
Ensure that:
- The product home environment variable is set.
- The user who installed the product runs the Azul script.
- If you are using a PATROL Agent to monitor a server component on the same computer where you are running the Azul script, stop the PATROL Agent before you run the script.
To run the script in a standalone environment
Do the following:
Depending on your component and the operating system, obtain the Azul 32-bit or 64-bit directories from the BMC Electronic Product Distribution (EPD) portal
Unzip (Windows) or gunzip and untar (Linux) the Azul directory.
Use one of the following commands to run the Azul script depending on your component and operating system:
Product Command for Windows Command for Linux Location of the Azul script TrueSight Infrastructure Management
Update_JRE_For_TSIM.bat
./Update_JRE_For_TSIM.sh
- Windows: <installer_directory>\Windows\Utilities\Azul_Scripts
- Linux: <installer_directory>/Linux/Utilities/Azul_Scripts
TrueSight Presentation Server
Update_JRE_For_TSPS.bat
./Update_JRE_For_TSPS.sh
- Windows: <installer_directory>\Windows\Utilities
- Linux: <installer_directory>/Linux/Utilities
TrueSight IT Data Analytics (not applicable for version 11.3.03)
Update_JRE_For_ITDA.bat
./Update_JRE_For_ITDA.sh
- Windows: <installer_directory>\utility
- Linux: <installer_directory>/utility
TrueSight App Visibility Manager
Update_JRE_For_AppVis.bat
./Update_JRE_For_AppVis.sh
- Windows: <installer_directory>\utility
- Linux: <installer_directory>/utility
Impact Integration Web Services (not applicable for version 11.3.03) Update_JRE_For_IIWS.bat
./Update_JRE_For_IIWS.sh
- Windows: <installer_directory>\Windows\Utilities
- Linux: <installer_directory>/Linux/Utilities
Integration Services Update_JRE_For_IS.bat
./Update_JRE_For_IS.sh
- Windows: <installer_directory>\Windows\Utilities
- Linux: <installer_directory>/Linux/Utilities
- When the script prompts for confirmation to restart the component, type y to continue.
- When prompted, enter the directory path where the Azul JRE is located. For example,
c:\azul8
.
The script replaces the Oracle JRE with the Azul JRE and starts the services or processes for the relevant component. - Verify that your TrueSight Operations Management component is up and running.
To verify the changes, run the (Windows)
java.exe -version
or (Linux)./java -version
command from the appropriate directory in the following table:Component JRE directory TrueSight Infrastructure Management
- Windows: %BMC_PROACTIVENET_HOME%\jre\bin
- Linux: $BMC_PROACTIVENET_HOME/jre/bin
TrueSight Presentation Server
- Windows: %TRUESIGHTPSERVER_HOME%\truesightpserver\modules\jre
- Linux: $TRUESIGHTPSERVER_HOME/truesightpserver/modules/jre
TrueSight IT Data Analytics (not applicable for version 11.3.03)
- Windows: %BMC_ITDA_HOME%\jre\bin
- Linux: $BMC_ITDA_HOME/jre/bin
TrueSight App Visibility Manager
- Windows: %ADOPSSERVER_HOME%\ADOP_JRE\bin
- Linux: $ADOPSSERVER_HOME/ADOP_JRE/bin
Impact Integration Web Services (not applicable for version 11.3.03) - Windows: $IIWS_HOME/BMCIIWSJVM/bin
- Linux: %IIWS_HOME%BMCIIWSJVM\bin
Integration Services - Windows: %BPPM_AGENT_HOME%\jre\bin
- Linux: $BPPM_AGENT_HOME/jre/bin
If you face an error while running the script, see To troubleshoot Azul script issues.
To run the Azul script in a high-availability environment
- Copy Azul JRE 64-bit or 32-bit binaries on every computer in the high-availability environment.
- Stop the standby node.
- On the primary node, unzip (Windows) or gunzip and untar (Linux) the Azul directory.
Use one of the following commands to run the Azul script depending on your component and operating system:
Product Command for Windows Command for Linux Location of the Azul script TrueSight Infrastructure Management
Update_JRE_For_TSIM.bat
./Update_JRE_For_TSIM.sh
- Windows: <installer_directory>\Windows\Utilities\Azul_Scripts
- Linux: <installer_directory>/Linux/Utilities/Azul_Scripts
TrueSight Presentation Server
Update_JRE_For_TSPS.bat
./Update_JRE_For_TSPS.sh
- Windows: <installer_directory>\Windows\Utilities
- Linux: <installer_directory>/Linux/Utilities
TrueSight IT Data Analytics (not applicable for version 11.3.03)
Update_JRE_For_ITDA.bat
./Update_JRE_For_ITDA.sh
- Windows: <installer_directory>\utility
- Linux: <installer_directory>/utility
TrueSight App Visibility Manager
Update_JRE_For_AppVis.bat
./Update_JRE_For_AppVis.sh
- Windows: <installer_directory>\utility
- Linux: <installer_directory>/utility
Impact Integration Web Services (not applicable for version 11.3.03) Update_JRE_For_IIWS.bat
./Update_JRE_For_IIWS.sh
- Windows: <installer_directory>\Windows\Utilities
- Linux: <installer_directory>/Linux/Utilities
Integration Services Update_JRE_For_IS.bat
./Update_JRE_For_IS.sh
- Windows: <installer_directory>\Windows\Utilities
- Linux: <installer_directory>/Linux/Utilities
- When the script prompts for confirmation to restart the component, type y to continue.
- When prompted, enter the directory path where the Azul JRE is located. For example,
c:\azul8
.
The script replaces the Oracle JRE with the Azul JRE and starts the services or processes for the relevant component. - Verify that your TrueSight Operations Management component is up and running.
- To verify the changes, run (Windows)
java.exe -version
or (Linux)./java -version
command from the appropriate directory in the following table:Component JRE directory TrueSight Infrastructure Management
- Windows: %BMC_PROACTIVENET_HOME%\jre\bin
- Linux: $BMC_PROACTIVENET_HOME/jre/bin
TrueSight Presentation Server
- Windows: %TRUESIGHTPSERVER_HOME%\truesightpserver\modules\jre
- Linux: $TRUESIGHTPSERVER_HOME/truesightpserver/modules/jre
TrueSight IT Data Analytics (not applicable for version 11.3.03)
- Windows: %BMC_ITDA_HOME%\jre\bin
- Linux: $BMC_ITDA_HOME/jre/bin
TrueSight App Visibility Manager
- Windows: %ADOPSSERVER_HOME%\ADOP_JRE\bin
- Linux: $ADOPSSERVER_HOME/ADOP_JRE/bin
Impact Integration Web Services (not applicable for version 11.3.03) - Windows: $IIWS_HOME/BMCIIWSJVM/bin
- Linux: %IIWS_HOME%BMCIIWSJVM\bin
Integration Services - Windows: %BPPM_AGENT_HOME%\jre\bin
- Linux: $BPPM_AGENT_HOME/jre/bin
- Wait till the primary node is active, and perform steps 3 to 8 on the standby node.
If you face an error while running the script, see To troubleshoot Azul script issues.
Restoring the backed up Oracle JRE on version 11.3.xx
If the Azul script runs into an error and cannot create the Azul JRE folder, do the following to restore the Oracle JRE:
- Stop all services or processes if they are running.
- Take a backup of the current JRE folder.
- Rename the jre_oracle_* folder as jre.
For TrueSight Infrastructure Management, repeat this step for the jre_32bit folder. - Start the services and processes.
Troubleshooting Azul script issues for version 11.3.xx
This section provides information about the solutions for some issues that you might face while using the Azul script.
Issue: The Oracle backup folder is not created.
This issue might occur because of any of the following reasons:
- The JRE folder is open.
- The computer does not have enough disk space.
Solution
Do the following and run the script again:
- Close the JRE folder and all command prompt windows.
- (Windows) Go to the Task Manager and ensure that all Java processes are closed.
- Ensure that there is enough disk space on the computer where you are running the script.
Comments
Hi, Seems small update needed. Include the step like first enter the location for Java 64 bit location after executing the Update_Java_For_TSIM. bat file, then mention the Java 32 Bit as well then only script will work. this need to be updated and mentioned as Note to the users. Thanks & Regards Sabari Yadavilli
Hello, Sabari. Thank you for the comment. I will update the content as soon as possible.
Hello, Sabari.
We have already asked to download both 32- and 64-bit files (as per your environment) in the first step of the procedure. Please let us know if you need more information on this.
Thank you!
Hi. The "Link to download binaries from the EPD" do not work. They all direct you to https://docs.bmc.com/docs/TSOperations/113/TBD
Hi Ramon,
Thank you for letting us know. I have updated the links. They should work now.
Regards,
Mukta
Step 8 for the HA environment script does not have the required information.
To verify the changes, run (Windows) java.exe -version or (Linux) ./java -version command from the appropriate directory in the following table: Page not found for multiexcerpt macro.
Hello Ramon,
Thank you for letting us know. I have fixed the issue.
Regards,
Mukta
EPD site for 11.3.03 does not contain the script zip file, only the azul binaries. when using the 11.3.02 scripts zip file for AppVisibility it checks for 11.3.02 azul binaries, TSPS does use the 11.3.03 binaries
please clarify
Hello,
This is correct. For AppVisibility, the 11.3.03 scripts are embedded in the installation files.
Thank you.
Hi team,
What do we do for upgrading RSSO to Azul Java? There is no reference here on this page to RSSO? If the user run the TSIM Integration with RSSO installer, the issue will be on the TS side correct? What instructions are needed to upgrade Oracle Java to Azul Java for RSSO?
Thanks
Azul scripts are not applicable for RSSO. We got this clarified from R&D.
Thanks.
Hi Betty, We have Azul JRE is license for TrueSight products and not for RSSO and that is the reason RSSO is not tested and documented with Azul JRE. RSSO documentation recommends to use Oracle JRE. We are currently checking with legal team if there is any customer who is using just TrueSight products then can they use Azul JRE. Will keep you updated once we will have an update.
@Ashish Kumar
Since Azul scripts are not certified and Truesight layed down the JAVA as part of the deployment of the RSSO we should have a documented process for upgrading the JAVA.
RSSO supports OpenJDK and we should be able to document replacing the JAVA with the latest version of OpenJDK that RSSO installer has been tested with.
The issue with replacing JAVA is insuring that the SSL connectors are properly configured and that the cacerts certificate file is correctly referenced to support the customers SSL Certs.
Comment handled over email.