Replacing Oracle JRE with Azul 8 Java

The TrueSight Operations Management products can now be configured to use Azul 8 Java. 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:

The Azul script performs the following tasks:

1. Stops the relevant component.
2. Takes a backup of the Oracle JRE.
3. Replaces the Oracle JRE with the Azul JRE.

4. (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 any other customizations to the Oracle JRE are manually copied to the Azul JRE.

5. Starts the services (Windows) or processes (Linux) for the relevant component.

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.

Prerequisites

Ensure that:

• The product home environment variable is set.
• The user who installed the product runs the Azul script.
• If you are using the 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 non-high availability environment

Do the following:

1. 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

2. Unzip (Windows) or gunzip and untar (Linux) the Azul directory.

3. 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	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	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

4. When the script asks for confirmation to restart the component, type y to continue.
5. When asked, 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.
6. Verify that your TrueSight Operations Management component is up and running.

7. 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	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	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

1. Copy Azul JRE 64-bit or 32-bit on every computer in the high-availability environment.
2. Stop the standby node.
3. On the primary node, unzip (Windows) or gunzip and untar (Linux) the Azul directory.

4. 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	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	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

5. When the script asks for confirmation to restart the component, type y to continue.
6. When asked, 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.
7. Verify that your TrueSight Operations Management component is up and running.
8. 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	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	Windows: $IIWS_HOME/BMCIIWSJVM/bin Linux: %IIWS_HOME%BMCIIWSJVM\bin
   Integration Services	Windows: %BPPM_AGENT_HOME%\jre\bin Linux: $BPPM_AGENT_HOME/jre/bin

9. 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.

To troubleshoot Azul script issues

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.

To restore the backed up Oracle JRE

If the Azul script runs into an error and cannot create the Azul 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.
   For TrueSight Infrastructure Management, repeat this step for the jre_32bit folder.
4. Start the services and processes.