Control-M External Java Installation

Control-M requires an external Java installation. To ensure that Java remain updated, Java library deliveries are decoupled from Control-M 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 is available on the Control-M component host machines.

To set Java using an external location prior to installation, see Setting the Java Environment Variable. For a list of supported Java vendors, see Control-M Compatibility with External Java Vendors.

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

  • Java Standard Edition and Enterprise Edition are supported.

  • If the Java path is changed, you must update it in all Control-M components. Otherwise, Control-M does not function.

The following procedures describe how to change the Java package for each component after a new installation or after an upgrade on UNIX and Windows:

Setting the Java Environment Variable

This procedure describes how to set the Java environment variable, which points to an external Java installation. You must perform this procedure for each Control-M 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_.dat file. For a list of supported Java vendors, see Control-M Compatibility with External Java Vendors.

  • The Java installation directory must contain the bin directory and the Release file.

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

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

Before You Begin

If Java is installed, run the following command to find the Java home directory:

  • Linux: 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:

    • Linux: 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-M 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-M 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:

    • Linux: 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>