Control-M for Hadoop Installation

The following procedures describe how to install Control-M for Hadoop on Control-M/Agent on UNIX, interactively or automatically, in a Control-M/Server self-hosted environment.

If you want to install multiple instances of Control-M for Hadoop on several computers using the same configuration, use the automatic installation, as described in these procedures.

Installing Control-M for Hadoop on Control-M/Agent on UNIX

This procedure describes how to install Control-M for Hadoop on Control-M/Agent on UNIX.

Before You Begin

• Verify that all jobs running on the Control-M/Agent have ended.

• Verify that you have met Java requirements, as described in Control-M External Java Installation.

Begin

1. Log in as the Control-M/Agent user.

2. Type the following command to stop the Control-M/Agent:

   $CONTROLM/scripts/shut-ag -u <agentUser> -p all

   If the Control-M/Agent was installed with user root, then log in as user root every time you start up or shut down the Control-M/Agent throughout this procedure.

3. Use one of the following modes:

   • Display: If you install using GUI (or XServer), set your DISPLAY environment variable, as described in Setting Environment Variables in UNIX.

   • Console: It is not necessary to set DISPLAY.

4. Type the following commands to activate the installation script:

   <install_source_path>/CBD.9.0.21.300_Linux-x86_64.BIN

5. Do one of the following:

   • Interactive Install: Continue with the on-screen instructions until the installation is complete.

   • Automatic Install: Do the following:

     1. Continue with the on-screen instructions until the Summary window.

     2. Click Generate and select the location to create the XML parameter file.

     3. Click Yes.

     4. Copy the automatic installation parameters file to a network location that is accessible to all computers where you want to perform an automatic installation.

     5. Type the following command to activate the installation script:

        <install_source_path>/<CBD.9.0.21.300_Linux-x86_64.BIN> -silent<filename.xml>

6. The installation log is saved to the following location:

   $HOME/<username>/BMCINSTALL/log/cmhadoop/BMC_Plugin_For_Hadoop_Install_<date-time>.log

7. Log out of the Control-M/Agent.

8. Log in and start the Control-M/Agent with the following command:

   $CONTROLM/scripts/start-ag -u <agentUser> -p all

Uninstalling Control-M for Hadoop from UNIX

This procedure describes how to uninstall Control-M for Hadoop from UNIX.

Before You Begin

• Stop all jobs running on Control-M/Agent.

• Verify that all jobs have ended.

Begin

1. From a Control-M/Agent computer, log in as a Control-M/Agent user, and type the following command to shut down Control-M/Agent:

   $CONTROLM/scripts/shut-ag -u <agentUser> -p all

   If the Control-M/Agent was installed with user root, then log in as user root every time you start up or shut down the Control-M/Agent throughout this procedure.

2. Set your DISPLAY environment variable according to the computer name, as described in Setting Environment Variables in UNIX.

3. Navigate to the following directory:

   $HOME/BMCINSTALL/uninstall/DRCBD.<version>/

4. Type one of the following commands:

   • Interactive: ./uninstall.sh

   • Automatic: ./uninstall.sh -silent

5. To restart Control-M/Agent, type the following command:

   $CONTROLM/scripts/start-ag -u <agentUser> -p all

Changing the JRE Package in Control-M for Hadoop

This procedure describes how to change the JRE package in Control-M for Hadoop. The use of JRE is supported only where the major release version is the same as the tested version. For more information about Java, see Control-M External Java Installation.

Begin

1. Edit the external_java_path_9.0.21.300.dat file in the <HOME>/BMCINSTALL/ directory.

2. Define an alternative Java home directory by modifying the value of the parameter CM_HADOOP_JAVA_HOME to the external Java path.

   CM_HADOOP_JAVA_HOME={new JRE Path}

   • A relative path is not supported.

   • The path can only include alphanumeric, period, underscore, hyphen and plus characters.

3. Stop Control-M for Hadoop using the following command.

   $CONTROLM/cm/HADOOPCM/exe/cm_container.sh stop

   Control-M for Hadoop restarts automatically.