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

This procedure describes how to install Control-M for SAP on Control-M/Agent on UNIX interactively or automatically. If you want to install multiple instances of Control-M for SAP on several computers using the same configuration, use the automatic installation, as described in this procedure.

NOTE: The default installation is interactive and uses a GUI display. XServer must be running and configured using the DISPLAY environment variable. If you do not have XServer available, BMC recommends that you continue with the console installation or perform an automatic installation.

Before You Begin

Ensure the following:

• Verify that all jobs running on Control-M/Agent have ended.
• If you are using Linux x86_64 platform that runs 32bit version of the Control-M/Agent, install the following 32bit libraries: libXtst.so.6 and libXi.so.6.

To install Control-M for SAP on Control-M/Agent on UNIX:

1. Log in as the Control-M/Agent user, and stop the Control-M/Agent by typing the following command:

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

   NOTE: 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.

   If you are using an AIX operating system, you must remove unused libraries from memory, by typing the following command as a root user:

   /usr/sbin/slibclean

2. Do one of the following:
   • Mount the installation DVD.
   • Extract the files from the temporary directory that you created when obtaining the installation files via EPD (see Control-M for SAP Release Notes).
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. From the installation DVD or from the installation files via EPD, activate the installation script with the following command:

   <source_path>/setup.sh

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. To run the installation script, type the following command:

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

   The installation logs can be found at the following location:

   $HOME/BMCINSTALL/log/cmsap/BMC_Control-M_For_For_SAP_Install_<date-time>.log

6. Log out of the Control-M/Agent account.
7. Log in and start the Control-M/Agent by running the following command:

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

8. To use the Control-M for SAP utilities in Control-M Configuration Manager, run the ctmgetcm utility in the Control-M/Server, as described in ctmgetcm in Control-M Utilities.