Installing Control-M/Agent on UNIX

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

NOTE: If a previous version of Control-M/Agent is detected, an upgrade is automatically performed and the parameters values from the previous version are used. You do not need to shut down the Control-M/Agent before the upgrade process begins if your Control-M/Agent is connected to Control-M/Server version 8.0.00 or higher.

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 that you have met the following requirements:

• Ensure that your operating system and database software is compatible with the current version of Control-M/Agent, as described in Control-M/Agent system requirements.
• Successful completion of Control-M/Agent pre-installation procedures on UNIX.
• Ensure that the Internal Process Communication (IPC) subsystem is enabled.
• Verify that your locale is set to English before beginning the installation.

To install Control-M/Agent on UNIX:

1. Log in as a Control-M/Agent user and then switch to user root.
2. Do one of the following:
   • Mount the installation DVD.
   • From the temporary directory that you created (see Product Distribution in the Control-M version 8.0.00 Release Notes), extract the .tar.Z file.

   If you are installing Control-M/Agent in non-root mode, log out user root and log in as the Control-M/Agent user.

3. Set your DISPLAY environment variable, as described in Setting environment variables in UNIX.

   NOTE: If you are installing Control-M/Agent on Linux 64 bit, and you are not installing any Application Plug-ins, you need to set the INSTALL_AGENT_LINUX_X86_64 environment variable to Y. For more information see 000085258.

4. Type the following command:

   <source_path>/setup.sh

5. Do one of the following:
   • Interactive install: Select the Control-M/Agent option and continue with the on-screen instructions until the installation is complete.
   • Automatic install: Do the following:
     1. Select the Control-M/Agent option and 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 to quit the installation.

        A confirmation message appears.

     4. Click Yes.
     5. Copy the automatic installation parameters file to a network location that is accessible to all computers where you want to perform an automatic installation.
     6. To run the installation script, type the following command:

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

   The installation log can be found at the following location:

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