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