Agent Installation

The Agent installation installs Control-M/Agent, Application Integrator, and Automation API CLI. Additional Agents enable you to run jobs on multiple computers. This enhances performance and creates greater load balancing control.

If you are installing an Agent on UNIX/Linux, complete the pre-install procedures, as described in Agent Pre-installation Procedures for Linux and the post install procedures, as described in Agent Post-installation Procedures.

Control-M/Agent requires an external Java library. To ensure that Java libraries remain updated, Java library deliveries are decoupled from Control-M/Agent and not part of the installation. For more information, see Control-M External Java Installation.

Before you install an Agent, verify that your operating system and processor are supported and that your minimum requirements for memory and diskspace are met. Depending on your operating system, verify that your system meets one of the following requirements:

You can install multiple Agents (including Agent and Helix Agent together) on the same host machine, but the following requirements must be met:

  • (Linux only) Each Agent must be installed on a separate account.

  • Each Agent must have a unique name.

  • Each Agent or Helix Agent must be version 9.0.21.100 or higher.

The following procedures describe how to install Control-M/Agent on UNIX and Windows in a Control-M/Server self-hosted environment.

  • If you upgrade the Agent, Application Integrator that was part of Application Pack is upgraded as well. If you roll back the Agent, then Application Integrator cannot work. To re-enable Application Integrator, you must uninstall and then reinstall Application Pack.

  • If Application Pack is installed, verify that all Application Integrator jobs have completed before upgrading the Agent.

  • If you have Control-M for Databases connection profiles, you cannot upgrade Application Pack to version 9.0.21.100 or higher until you have upgraded Control-M for Databases to version 9.0.21.100 or higher.

  • If you are using Agent 9.0.21.100 or higher with a Java version that is higher than 11 with Application Pack lower than version 9.0.21, you might encounter issues in Application Pack plug-ins. To ensure that Application Pack functions properly, BMC recommends to set the Agent to use Java version 11 or lower, or upgrade Application Pack to version 9.0.21 or higher.

Agent System Requirements for Windows

The following table lists the prerequisite requirements for a Windows platform. These values represent the minimum requirement for an entry level deployment. For higher capacity workloads, add resources.

Resource

Specification

Compatible Processors

x86_64

CPU and Memory

100 concurrent jobs or less: 

  • CPU: 2

  • Memory: 4 GB

  • CPU SPEC: 90

100–200 concurrent jobs:

  • CPU: 4

  • Memory: 6 GB

  • CPU SPEC: 180

Disk Space

1,150 MB

BMC Software recommends that you reserve three times the amount of RAM in the system for swap space.

Agent System Requirements for UNIX/Linux

The following table lists the prerequisite requirements for Agent on a Linux platform. These values represent the minimum requirement for an entry level deployment. For higher capacity workloads, add resources.

Resource

Requirement

Hardware

For an up-to-date list of supported operating systems and requirements, see Control-M Compatibility for Version 9.0.21.

Memory

500 concurrent jobs or less:

  • CPU: 2

  • Memory: 4 GB

  • CPU SPEC: 90

500–1,000 concurrent jobs:

  • CPU: 4

  • Memory: 8 GB

  • CPU SPEC: 180

Disk Space

1,150 MB

BMC Software recommends that you reserve three times the amount of RAM in the system for swap space.