Technical bulletin — Announcing Azul 8 Java support for TrueSight Operations Management 11.3.01

The TrueSight Operations Management products can now be configured to use Azul 8 Java. You can download the Azul 8 Java files from FTP:

FTP link to download the patch (ftp://ftp.bmc.com/pub/TSOM/PATCHES/11.3.01/Azul8)

Azul 8 Java is supported on the following components:

  • TrueSight Presentation Server - Only 64-bit
  • TrueSight Infrastructure Management - (Linux) - Only 64-bit and (Windows) - 32-bit and 64-bit
  • TrueSight IT Data Analytics - Only 64-bit
  • TrueSight App Visibility Manager - Only 64-bit
  • Impact Integration Web Services - Only 32-bit
  • Integration Services - 32-bit and 64-bit
  • Remote Administration Console - 32-bit and 64-bit

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.

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 FTP site.
  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:

  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.

  • To verify the changes, run the (Windows) java.exe -version or (Linux) ./java -version command from the appropriate directory in the following table:

Note: With Azul, the Show graph functionality does not work on the TrueSight Infrastructure Management server

On TrueSight Infrastructure Management, the Show graph functionality does not work with Azul 8 JRE. To resolve this issue, apply the TrueSight Infrastructure Management 11.3.01.000.005 hotfix or later. You can download the hotfix from the FTP site (ftp://ftp.bmc.com/pub/TSIM/PATCHES/11.3.01/GA/).

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:
    Failed to execute the [excerpt-include] macro. Cause: [Error number 2 in 0: No wiki with id [confluencePage:page] could be found]. Click on this message for details.
  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:
    Failed to execute the [excerpt-include] macro. Cause: [Error number 2 in 0: No wiki with id [confluencePage:page] could be found]. Click on this message for details.
  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.


 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*