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:

ComponentRequired binariesLink to download files from the FTP server or EPD

TrueSight Presentation Server

Only 64-bit

TrueSight Presentation Server Version 11.3.02

TrueSight Infrastructure Management

For Linux, only 64-bit

For Windows, 32-bit and 64-bit

TrueSight Infrastructure Management Version 11.3.02

TrueSight IT Data AnalyticsOnly 64-bit

TrueSight IT Data Analytics Version 11.3.02

TrueSight App Visibility Manager

Only 64-bit

TrueSight App Visibility Manager Version 11.3.02

Impact Integration Web ServicesOnly 32-bit

TrueSight Infrastructure Management Version 11.3.02

Integration Services32-bit and 64-bit

TrueSight Infrastructure Management Version 11.3.02

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.

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.

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

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:

    ProductCommand for WindowsCommand for LinuxLocation 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 ServicesUpdate_JRE_For_IIWS.bat./Update_JRE_For_IIWS.sh
    • Windows: <installer_directory>\Windows\Utilities
    • Linux: <installer_directory>/Linux/Utilities
    Integration ServicesUpdate_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:

    ComponentJRE 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:

    ProductCommand for WindowsCommand for LinuxLocation 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 ServicesUpdate_JRE_For_IIWS.bat./Update_JRE_For_IIWS.sh
    • Windows: <installer_directory>\Windows\Utilities
    • Linux: <installer_directory>/Linux/Utilities
    Integration ServicesUpdate_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 (Windowsjava.exe -version or (Linux./java -version command from the appropriate directory in the following table:

    ComponentJRE 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.
Was this page helpful? Yes No Submitting... Thank you

Comments

  1. Sabari Yadavilli

    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

    Aug 30, 2019 03:19
    1. Mukta Kirloskar

      Hello, Sabari. Thank you for the comment. I will update the content as soon as possible.


      Aug 30, 2019 07:07