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:

ComponentRequired binariesLink to download files from the FTP server or EPD

TrueSight Presentation Server

64-bit only

TrueSight Presentation Server Version 11.3.02

TrueSight Infrastructure Management

For Linux, 64-bit only

For Windows, 32-bit and 64-bit

TrueSight Infrastructure Management Version 11.3.02

TrueSight IT Data Analytics64-bit only

TrueSight IT Data Analytics Version 11.3.02

TrueSight App Visibility Manager

64-bit only

TrueSight App Visibility Manager Version 11.3.02

Impact Integration Web Services32-bit only

TrueSight Infrastructure Management Version 11.3.02

Integration Services32-bit and 64-bit

TrueSight Infrastructure Management Version 11.3.02


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:

ComponentRequired binariesLink to download binaries from the EPD

TrueSight Presentation Server

64-bit only


TrueSight Presentation Server Version 11.3.03

TrueSight Infrastructure Management

For Linux, 64-bit only

For Windows, 32-bit and 64-bit

TrueSight Infrastructure Management Version 11.3.03

TrueSight App Visibility Manager

64-bit only

TrueSight App Visibility Manager Version 11.3.03

Integration Services32-bit and 64-bit

Integration Services Version 11.3.03

Running the Azul 8 Java scripts for version 11.3.xx

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

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:

  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 (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 ServicesUpdate_JRE_For_IS.bat./Update_JRE_For_IS.sh
    • Windows: <installer_directory>\Windows\Utilities
    • Linux: <installer_directory>/Linux/Utilities

  4. When the script prompts for confirmation to restart the component, type y to continue.
  5. 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.
  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 (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

  1. Copy Azul JRE 64-bit or 32-bit binaries 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 (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 ServicesUpdate_JRE_For_IS.bat./Update_JRE_For_IS.sh
    • Windows: <installer_directory>\Windows\Utilities
    • Linux: <installer_directory>/Linux/Utilities

  5. When the script prompts for confirmation to restart the component, type y to continue.
  6. 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.
  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 (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

  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.

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:

  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.

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

        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!

        May 27, 2020 10:03
  2. Ramon Dio

    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

    Feb 10, 2020 02:59
    1. Mukta Kirloskar

      Hi Ramon,

      Thank you for letting us know. I have updated the links. They should work now.

      Regards,

      Mukta

      Feb 10, 2020 11:34
  3. Ramon Dio

    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.

    Feb 10, 2020 05:52
    1. Mukta Kirloskar

      Hello Ramon,

      Thank you for letting us know. I have fixed the issue.

      Regards,

      Mukta

      Feb 10, 2020 11:29
  4. Roland Pocek

    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

    Feb 12, 2020 04:54
    1. Mukta Kirloskar

      Hello,

      This is correct. For AppVisibility, the 11.3.03 scripts are embedded in the installation files.

      Thank you.

      Apr 30, 2020 04:05
  5. Betty Neumann

    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


    Jun 09, 2020 05:53
    1. Mukta Kirloskar

      Azul scripts are not applicable for RSSO. We got this clarified from R&D.

      Thanks.

      Jun 26, 2020 01:59
    1. Niyati Shah

      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

      Jun 26, 2020 02:06
  6. Dony Sheppard

    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.



    Jun 26, 2020 08:25