Control-M Application Pack Installation

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

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

  • You cannot install Application Pack version 9.0.21.000 or lower on Control-M/Agent version 9.0.21.200 and higher.

  • Application Pack 9.0.21.100 requires Control-M/Agent 9.0.20 or higher.

  • If you are using Control-M for Databases, you must install it separately, as described in Control-M for Databases Installation.

  • If you upgrade the Agent, Application Integrator, which is part of the Application Pack, is upgraded as well. If you roll back the Agent, Application Integrator cannot work. To re-enable Application Integrator, you must uninstall and then reinstall the Application Pack.

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

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 Control-M/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.

The installation log is saved to the following location:

$HOME/BMCINSTALL/log/cmone/BMC_Control-M_Application_Pack_Install_<date-time>.log

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

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.

  • The installation log is saved to the following location:

    BMCINSTALL\log\cmone\BMC_ControlM_Application_Pack_Install_<timestamp>.log

  • If the installation fails, the log file is saved to the following location:

    %temp%\BMC_Control-M_Application_Pack_Install_<timestamp>.log

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.

You must perform this procedure if your Control-M Desktop is version 9.0.20.000, 9.0.20.100, or 9.0.20.200.

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 running on Control-M/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 Control-M/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

The uninstallation logs are saved to the following location:

$HOME/BMCINSTALL/log/cmone/BMC_ControlM_Application_Pack_Uninstall_<timestamp>.log

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.

The uninstallation log is saved to the following location:

BMCINSTALL\log\cmone\BMC_ControlM_Application_Pack_Uninstall_<timestamp>.log

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

The uninstallation log is saved to the following location:

BMCINSTALL\log\cmone\BMC_ControlM_Application_Pack_Uninstall_<timestamp>.log

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.