Installing Control-M/EM API

This procedure describes how to install Control-M/EM API on Windows and UNIX.

Due to Java limitations, BMC Software recommends that you do not install Control-M/EM API in a directory with a path that contains spaces or other special characters. If you install Control‑M/EM API on an account where an earlier version of Control-M/EM API is installed, see Control-M/EM API upgrade before continuing.

Before you begin

Ensure the following is installed:

• Control‑M/EM in your network environment
• Java Developer's Kit (JDK) version 1.6.x or later or Java Runtime Environment (JRE) version 1.6.x or later on the computer hosting your project's working directory. JAVA_HOME environment variable should point to the JDK/JRE directory/library.

  The JAVA_HOME environment refers to the directory where the JRE is installed. The JDK contains the JRE, but at a different level in the file hierarchy. For example, if the Java 2 SDK or JRE was installed in /ctm_em/user1, JAVA_HOME would be either:/ctm_em/user1/jdk1.6.x/jre [JDK] or /ctm_em/user1/jre1.6.x [JRE].

To Install Control-M/EM API:

• Do one of the following to create the emapi-800 directory:
  • Microsoft Windows: Unzip the emapi-800-nt.zip file from the cdPath\Setup_files\TOOLS\EMAPI_FILES directory on the Control-M/EM installation CD to any location.
  • UNIX:
    • Solaris, AIX, HP-UX or HP-UX Itanium: Locate the emapi-800-UNIX.TAR.Z tar file in the cdPath/Setup_files/TOOLS/EMAPI_FILES directory on the Control-M/EM installation CD and type the following command to open and uncompress the file to any directory:

      uncompress -c cdPath/TOOLS/EMAPI_FILES/emapi-800-UNIX.TAR.Z | tar xvf

    • RedHat or Suse: Locate the emapi-800-UNIX.TAR.gz tar file in the cdPath/Setup_files/TOOLS/EMAPI_FILES directory on the Control-M/EM installation CD and type the following command to open and uncompress the file to any directory:

      gunzip -c cdPath/TOOLS/EMAPI_FILES/emapi-800-UNIX.TAR.gz | tar xvf-

  All Control-M/EM API files and sub-directories are located in this directory. See: Control-M/EM API primary subdirectories.

  To uninstall Control‑M/EM, delete the Control‑M/EM API directory according to your version. For example, for version 8.0.00 delete the emapi-800 directory. Do not copy the Control‑M/EM API version 8.0.00 files directly over the previous installation This may cause unpredictable behavior.