Control-D External Java Installation

Control-D requires an external Java installation. To ensure that Java remain updated, Java library deliveries are decoupled from Control-D and not part of the installation. This reduces installation size and enables you to use the libraries that are common within your organization. You must ensure that Java 11 or 17 is available on the Control-D component host machines.

The installation process identifies the Java path and sets it accordingly when you install Java 11 or 17.

You must set the Java environment variable before the installation when you use an extracted version of Java that is not installed, as described in Setting the Java Environment Variable. For a list of supported Java vendors, see one of the following pages:

  • Both JRE and JDK are supported. However, BMC only requires JRE.

  • Java Standard Edition and Enterprise Edition are supported.

Setting the Java Environment Variable

This procedure describes how to set the Java environment variable, which points to an external Java installation. You must do this procedure for each Control-D component before you install or upgrade. After the installation, each component has its own Java location according to the temporary variable value. The values are saved in the BMCINSTALL directory in the external_java_path_9.0.21.200.dat file. For a list of supported Java vendors, see Control-D Compatibility with External Java Vendors.

  • You only need to do this procedure when you use an extracted version of Java, which is not installed.

  • (Windows Only): You cannot set the Java environment variable on a Network File System (NFS).

  • (UNIX Only): You might experience performance issues when you set the Java environment variable on a Network File System (NFS).

Before You Begin

Type the one of the following commands to find the Java home directory:

  • UNIX: sh -c "java -XshowSettings:properties -version 2>&1 > /dev/null | grep 'java.home'"

  • Windows: java -XshowSettings:properties -version 2>&1 > null | findstr "java.home"

Begin

  • Set the Java environment variable with one of the following operating systems:

    • UNIX: Do the following:

      1. From a command line, type one of the following commands:

        • sh/bash: export BMC_INST_JAVA_HOME=<java_directory>

        • csh/tcsh: setenv BMC_INST_JAVA_HOME <java_directory>

          • /usr/lib/jvm/java-11-openjdk-amd64

      2. Install the Control-D component from the same session where you set the variable.

    • Windows: Do the following:

      1. From a command line, type the following command:

        set BMC_INST_JAVA_HOME=<java_directory>

        C:\jdk-11.0.14.1+1-jre

      2. Install the Control-D component from the same session where you set the variable.

      If you are installing in automatic or console mode, set the Java environment variable in the command, as follows:

      • UNIX: setup.sh -silent <xml_path>/<filename.xml> -BMC_INST_JAVA_HOME <java_path>

      • Windows: setup.exe -silent <xml_path>\<filename.xml> -BMC_INST_JAVA_HOME <java_path>

      The Java environment variable is now established.

      If you change or upgrade Java after the installation of the Control-D component, do one of the following:

      • Use the same Java folder that you used in the original installation.

      • Update values of Java settings in the the external_java_path_9.0.21.200.dat file in the BMCINSTALL directory.