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, complete the pre-install procedures, as described in Agent Pre-installation Procedures for UNIX 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, but the following requirements must be met:

  • (UNIX 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.

To install a self-hosted Agent on a self-hosted Control-M/Server, see one of the following procedures:

  • If you use a proxy server to connect to the Internet, ensure that the proxy server settings are defined, as described in Proxy Server Configuration.

  • 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 you upgrade 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.

  • Security troubleshooting and best practices are described in Control-M/Agent Security Updates for UNIX and Windows.

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 2017 Int rate: 10

100–200 concurrent jobs:

  • CPU: 4

  • Memory: 6 GB

  • CPU SPEC 2017 Int rate: 20

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

The following table lists the prerequisite requirements for Agent on a UNIX 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 2017 Int rate: 10

500–1,000 concurrent jobs:

  • CPU: 4

  • Memory: 8 GB

  • CPU SPEC 2017 Int rate: 20

Disk Space

1,150 MB

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

Control-M/Agent and Plug-ins Java Support

From version 9.0.21.000, Java library deliveries are decoupled from Control-M and not part of the installation. You must ensure that Java is available on the Control-M component host machines.

  • Control-M Application pack, Control-M for Airflow, Control-M for SAP version 9.0.21.000 cannot be installed on Control-M/Agent 9.0.21.100 or higher with Java 17 or higher.

  • You can use Java 21.0.0 with Control-M Application pack, Control-M for Airflow, Control-M for SAP version 9.0.21.200 only if Control-M/Agent is 9.0.21.300 or higher.

  • You can use Java 17.0.1 or 21.0.0 with Control-M for OEBS and Control-M for PeopleSoft version 9.0.21.000 only if Control-M/Agent is 9.0.21.300 or higher.

The following table lists the supported versions of Java for Control-M/Agent and and Control-M plug-ins.

Component

Previous Version

9.0.20.200

9.0.21.000

9.0.21.100

9.0.21.200

9.0.21.300

Control-M/Agent

11.0.5

11.0.5

11.0.12 or higher

  • 11.0.12 or higher

  • 17.0.1 or higher

  • 11.0.16 or higher

  • 17.0.1 or higher

  • 11.0.16 or higher

  • 17.0.1 or higher

  • 21.0.0 or higher

Airflow

N/A

 

11.0.12 or higher

 

  • 11.0.16 or higher

  • 17.0.1 or higher

 

SAP

(9.0.01)

1.8

 

11.0.12 or higher

 

  • 11.0.16 or higher

  • 17.0.1 or higher

 

Application Pack

11

 

11.0.12 or higher

  • 11.0.12 or higher

  • 17.0.1 or higher

  • 11.0.16 or higher

  • 17.0.1 or higher

 

Application Integrator

See Application Pack

See Application Pack

See Control-M/Agent

See Control-M/Agent

See Control-M/Agent

See Control-M/Agent

Databases

See Application Pack

See Application Pack

See Application Pack

See Application Pack

  • 11.0.16 or higher

  • 17.0.1 or higher

  • 11.0.16 or higher

  • 17.0.1 or higher

  • 21.0.0 or higher

Informatica

See Application Pack

See Application Pack

See Application Pack

See Application Pack

 

  • 11.0.16 or higher

  • 17.0.1 or higher

  • 21.0.0 or higher

Backup

See Application Pack

See Application Pack

See Application Pack

See Application Pack

 

  • 11.0.16 or higher

  • 17.0.1 or higher

  • 21.0.0 or higher

Hadoop

See Application Pack

See Application Pack

See Application Pack

See Application Pack

 

  • 11.0.16 or higher

  • 17.0.1 or higher

  • 21.0.0 or higher

PeopleSoft

(9.0.01)

1.8

 

11

 

 

 

OEBS

(9.0.01)

1.8

 

11

 

 

 

WJM

(9.0.00)

1.8

 

 

 

 

 

DataStage

(8.0.00)

1.6

 

 

 

 

 

Cognos

(7.0.00)

1.6