Control-M for Hadoop Installation

The following procedures describe how to install Control-M for Hadoop on a UNIX Agent, 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 hosts using the same configuration, use the automatic installation, as described in these procedures.

Installing Control-M for Hadoop on a UNIX Agent

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

Before You Begin

• Verify that all jobs running on the Agent have ended.

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

Begin

1. Log in to the account where Control-M/Agent is installed.

2. Run the following command to stop the 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 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. Run 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 Installation: Continue with the on-screen instructions until the installation is complete.

   • Automatic Installation: 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 hosts where you want to perform an automatic installation.

     5. Run 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 Agent.

8. Log in and start the 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

• Verify that no jobs are executing on the Agent.

Begin

1. From an Agent host, log in to the account where Control-M/Agent is installed, and run the following command to shut down the Agent:

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

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

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

3. Navigate to the following directory:

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

4. Do one of the following:

   • Interactively Uninstall: Run the following command:

     ./uninstall.sh

   • Automatically Uninstall: Run the following command:

     ./uninstall.sh -silent

5. To restart the Agent, run 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.