Control-M External Java Installation

Control-M requires an external Java library. To ensure that Java libraries 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/Agent 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.

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 Agent before you install or upgrade. After the installation, each Agent 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 NFS.

  • (UNIX only): If you set the Java environment variable on NFS, you might experience performance issues.

Before You Begin

If you installed Java, 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:

    • Linux: Do the following:

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

        • sh/bash: export BMC_INST_JAVA_HOME=<java_11_directory>

        • csh/tcsh: setenv BMC_INST_JAVA_HOME <java_11_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:

        set BMC_INST_JAVA_HOME=<java_11_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>