Installing Control-M/Agent on Windows

This procedure describes how to install Control-M/Agent on Windows in a Control-M/Server self-hosted environment. This installation includes Application Integrator and Automation API CLI.

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.

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. You can install up to three Agents on a single host.

Before You Begin

Ensure that your operating system is compatible with the current version of Control-M/Agent, as described in Agent Installation.
Verify that you have met Java requirements, as described in Control-M External Java Installation.

Begin

Log in to the computer using a user ID that has Administrator permissions.
Copy the installation files from the temporary directory that you created in Obtaining Control-M Installation Files, to the home directory.
From a command prompt window, run the following command:

<source_path>\setup.exe
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:

Continue with the on-screen instructions until the Summary window.
Click Generate and select the location to create the XML parameter file.
Click Yes to quit the installation.

A confirmation message appears.
Click Yes.

The automatic installation XML parameters file that is created (<filename>.xml) is relevant only for computers with the same agent instance name. Otherwise, a separate <filename>.xml file must be created for each computer, or modified manually for each computer.
Copy the automatic installation parameters file to a network location that is accessible to all computers where you want to perform an automatic installation.
Log in using a user ID that has Administrator permissions on the current computer.
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:

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

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.