Control-M Application Pack Installation

The following procedures describe how to manually install and uninstall Control-M Application Pack on your Agent hosts in a self-hosted Control-M/Server environment:

• Installing Control-M Application Pack on UNIX

• Installing Control-M Application Pack on Windows

• Installing Control-M Application Pack on Control-M Desktop on Windows

• Uninstalling Control-M Application Pack from UNIX

• Uninstalling Control-M Application Pack from Windows

• Performing an Automatic Uninstall from Windows

You can also deploy Application Pack to multiple Agents from the CCM, as described in Application Pack Deployment.

Application Pack includes the following plug-ins:

• Control-M for Backup

• Control-M for Hadoop (Linux)

• Control-M for AWS

• Control-M for Informatica

The latest versions of Control-M for Hadoop, Control-M for Backup, and Control-M for Informatica are no longer included in Application Pack. BMC recommends that you install them separately.

Installing Control-M Application Pack on UNIX

This procedure describes how to install Control-M Application Pack on Control-M/Agent on UNIX.

Before You Begin

• Stop all jobs that are executing on the Agent.

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

Begin

1. Extract the files from the temporary directory that you created when you obtained the installation files.

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

   • (AIX only) Type the following command as a root user to remove unused libraries:

     /usr/sbin/slibclean

2. 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.

3. Activate the installation script with the following command:

   <source_path>/setup.sh

4. Do one of the following:

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

   • Automatic Install: Do the following:

     1. Follow the on-screen instructions until the Summary window appears.

     2. Click Generate, select a location to create the XML parameter file, and click Yes.

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

     4. Type the following command to run the installation script:

        <source_path>/setup.sh -silent <filename.xml>

5. End the session.

6. (Optional) To set the Job Output file authorizations, see Setting Job Output File Authorizations on UNIX.

Setting Job Output File Authorizations on UNIX

This procedure describes how to configure the Control-M Application Pack Job Output file permissions on UNIX.

Begin

1. Open the following file:

   <Control-M/Agent_home_dir>/ctm/data/AP.dat

2. Add the following line to Job Output file:

   SYSOUT_MODE <required file permission>

   SYSOUT_MODE 755

3. Restart the Agent.

   The Job Output file authorizations are updated.

Installing Control-M Application Pack on Windows

This procedure describes how to install Control-M Application Pack on Control-M/Agent on Windows.

Before You Begin

• Stop all jobs that are executing on the Agent.

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

Begin

1. Log in to Control-M/Agent as an Administrator.

2. From the directory that contains the installation files that you obtained, double-click setup.exe.

3. Do one of the following:

   • Interactive install: Follow the on-screen instructions until the installation is complete.

   • Automatic install: Do the following:

     1. Follow the on-screen instructions until the Summary window.

     2. Click Generate, select the location to create the XML file, and click Yes.

        The XML file is only relevant for computers with the same Agent instance name. For Agents that have a different instance name, create a separate XML file for each Agent.

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

     4. Run the following installation script:

        <source_path>\setup.exe -silent <silent.xml>

4. From the Services application, right click on Control-M Agent and click Start.

Installing Control-M Application Pack on Control-M Desktop on Windows

This procedure describes how to install Control-M Application Pack on Control-M Desktop on Windows.

Before You Begin

• Ensure that Control-M Application Pack installation files are accessible through your network.

• Close Control-M Desktopand the CCM.

Begin

1. Log in as an Administrator.

2. Navigate to the EM directory and click setup.exe.

3. Do one of the following:

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

   • Automatic Install: Do the following:

     1. Follow the on-screen instructions until the Summary window.

     2. Click Generate, select the location to create the XML file, and click Yes.

        The XML file is only relevant only for computers with the same Control-M/EM version. For computers with different Control-M/EM versions, a separate file must be created for each computer.

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

     4. Run the installation script with the following command:

        <source_path>\EM\setup.exe -silent <silent.xml>

   The installation log is saved to the following location or under the directory that contains the %temp% directory:

   %temp%\BMC_Control-M-CM_EM_Install_<date-time>.log

4. Restart Control-M Desktop and the CCM.

Uninstalling Control-M Application Pack from UNIX

This procedure describes how to uninstall Control-M Application Pack from UNIX.

Before You Begin

• Stop all jobs that are executing on the Agent.

• Verify that all jobs have ended.

Begin

1. (AIX only) Untar the JRE located at BMCINSTALL/uninstall/agent by running the following:

   cd $HOME/BMCINSTALL/uninstall/agent

   tar -xvf JRE.tar

2. 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 Agent throughout this procedure.

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

4. Navigate to the following directory:

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

5. Type one of the following commands:

   • Interactive Uninstall: ./uninstall.sh

   • Automatic Uninstall: ./uninstall.sh -silent

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

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

Uninstalling Control-M Application Pack from Windows

This procedure describes how to uninstall Control-M Application Pack from Windows.

Before You Begin

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

• Verify that all jobs have ended.

Begin

1. From the Start menu, select Control Panel.

2. Double-click Uninstall a program.

3. Select Control-M Application Pack.

4. Click OK to continue.

Performing an Automatic Uninstall from Windows

This procedure describes how to perform an automatic uninstall of Control-M Application Pack from Windows.

Before You Begin

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

• Verify that all jobs have ended.

Begin

1. Log in to the computer using a user ID that has Administrator authorizations.

2. Navigate to the following directory:

   <Agent Install Path>\BMCINSTALL\uninstall\DR1CM.<version>\

3. Open a command prompt window as an Administrator and type the following command:

   uninstall.exe -silent

Changing the JRE Package in Application Pack

This procedure describes how to change the JRE package in Application Pack. 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

• Do one of the following:

  • UNIX: Do the following:

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

    2. Define an alternative Java home directory by modifying the value of the parameter CM_AP_JAVA_HOME to the external Java path, as follows:

       CM_AP_JAVA_HOME={new JRE Path}

       • A relative path is not supported.

       • The path can only include alphanumeric characters, spaces, ., _, -, and +.

    3. Stop the Application Pack using the following command.

       $CONTROLM/cm/AP/exe/apmanager stop

       Application Pack restarts automatically.

  • Windows: Do the following:

    1. Edit the external_java_path.dat file in the <AGENT_HOME>\BMCINSTALL\ directory.

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

       CM_AP_JAVA_HOME={new JRE Path}

       • The path must be enclosed with " (quotation marks).

       • A network path is not supported.

       • A relative path is not supported.

       • The path can only include alphanumeric characters, spaces, ., _, -, and +.

    3. Stop the Application Pack using the following command.

       <AGENT_HOME>\cm\AP\exe\apmanager stop

       Application Pack restarts automatically.