Installing Control-M/Agent on Windows

This procedure describes how to install Control-M/Agent on a Windows host. This installation includes Application Integrator and 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.

To install multiple instances of Control-M/Agent on several hosts with the same configuration, use the automatic installation, as described in this procedure.

You can install up to three Agents on a single host.

Before You Begin

  • Verify that your operating system is compatible with the current version of Control-M/Agent, as described in Agent System Requirements for Windows.

  • Verify that you meet the Java requirements, as described in Control-M External Java Installation.

  • If you plan to use Automation API CLI, verify that Python version 3.8.4 or later and pip version 20.1.1 or later are installed.

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

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

Begin

  1. Log in to the host with user ID that has Administrator permissions.

  2. Copy the installation files to the home directory.

  3. From a command prompt, run the following command:

    <Source_Path>\setup.exe

  4. Do one of the following:

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

    • Automatic Installation: 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.

        The automatic installation XML parameters file that is created (<Filename>.xml) is relevant only for hosts with the same Agent instance name. Otherwise, a separate <Filename>.xml file must be created for each host, or modified manually for each host.

      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. Log in using a user ID that has Administrator permissions on the current host.

      7. Run the following installation script:

        <Source_Path>\setup.exe -silent <xml_path>\<Filename.xml>

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

        <Source_Path>\setup.exe -encrypt <Password>

        The installation log can be found at the following location:

        <Installation_Folder>\BMCINSTALL\log\BMC_Control-M_AGENT_Install<date-time>.log

        The backup file is available in the following location:

        <Installation_Directory>\BMCINSTALL\uninstall\DRKAI.SaaS\backup_area

        By default, Control-M/Agent is configured to work with TCP. To secure your environment, BMC recommends to change your configuration to SSL, as described in Zone 2 and 3 SSL Configuration.