Installing Control-M/Agent on UNIX

This procedure describes how to install Control-M/Agent on UNIX, which includes Application Integrator and Control-M Automation API CLI. If a previous version of Control-M/Agent is detected, the Agent is automatically upgraded and the previous version parameter values are saved. You can automatically or interactively install Control-M with its default settings or custom define its database server and name, along with the component usernames, hostnames, and port settings.

Before You Begin

  • Complete all Agent Pre-installation Procedures for UNIX.

  • Verify that you meet the system requirements, as described in Agent System Requirements for UNIX.

  • Verify that an external Java package is installed outside of the <Control-M/Agent_Home> directory, as described in External Java Installation.

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

  • Verify that your operating system locale is set to English.

  • Download the installation package, as described in Obtaining Control-M Installation Files.

  • (Control-M Automation API CLI only) Verify the following:

    • Python 3.8.4 or higher and pip 20.1.1 or higher is installed.

    • Your system path includes the required Python executable pathname. Or, to use a different Python installation, point the CLI_INSTALL_PYTHON_EXE environment variable to the relevant Python installation.

    If you want to use Automation API CLI at a later time, you must install Python and pip, run the ctm command, and then follow the prompts.

  • (RedHat Linux only) BMC recommends that you define the maxproc parameter to at least 4,096.

  • (AIX only) run the following command to define the tcp_nodelayack parameter to 1:

    /usr/sbin/no -p -o tcp_nodelayack=1

Begin

  1. Log in to the host.

  2. Copy the installation files to the home directory.

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

  4. Navigate to the home directory and run the following command:

    <source_path>/setup.sh

  5. Do one of the following:

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

    • Automatic Installation: Create a parameter file and then do the following:

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

      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 hosts where you want to perform an automatic installation.

      6. Run the following command:

        <Source_Path>/setup.sh -silent <xml_path>/<Filename.xml>

      To encrypt a password in the installation, run the following command:

      <Source_Path>/setup.sh -encrypt <Password>

      The installation log and backup file are available in the following directories:

      • Installation Log: <$HOME>/BMCINSTALL/log/BMC_Control-M_AGENT_Install<date-time>.log

      • Backup File: $HOME/BMCINSTALL/uninstall/DRKAI.9.0.02/backup_area

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