Installing Control-M/Agent on UNIX

This procedure describes how to install Control-M/Agent on UNIX. This installation includes Application Integrator and Automation API CLI. 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.

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

  • 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 is compatible with the current version of Control-M/Agent, as described in Agent System Requirements for Linux.

  • Successful completion of Agent Pre-Installation Procedures for Linux.

  • Define the external Java location, as described in Setting the Java Environment Variable.

  • Ensure that the Internal Process Communication (IPC) subsystem is enabled.

  • Verify that your locale is set to English before beginning the installation.

  • (Red Hat Linux 6) BMC recommends that you define maxproc parameter to at least 4096 before installing.

  • (AIX only) You must set the tcp_nodelayack to 1 as a root user, as follows:

    /usr/sbin/no -o tcp_nodelayack=1

Begin

  1. Log in as a Control-M/Agent user.

  2. Copy the installation files from the temporary directory that you created in Obtaining Control-M installation files, to the home directory.

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

  4. From your home directory, type the following command:

  5. <source_path>/setup.sh

  6. Do one of the following:

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

    • Automatic install: Create a parameter file and then run the automatic install in a non-interactive mode, as follows:

      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 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 <xml_path>/<filename.xml>

      If you want to encrypt a password in the installation, run the following command:

      <source_path>/setup.sh -encrypt <password>

      The installation log can be found at the following location:

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

  7. After Agent installation, jobs can run under the Agent user account only. To allow jobs to run under other Run As users, you must change the Agent mode, as described in set_agent_mode.