The Control-M/Agent Deployment tool enables you to automatically upgrade multiple Control-M/Agents from one single point of access.Control-M/Agent upgrade includes Application Integrator and Automation API CLI.
From the CCM, you can transfer Control-M/Agent software packages to multiple Control-M/Agents. After the transfer, you can then upgrade the Control-M/Agents to version 9.0.21 and higher on UNIX and Windows, and to version 7.0.01 and higher on AS400.
The following procedures describe how to set up the software packages, upgrade, and downgrade Control-M/Agents:
Control-M/Agent 9.0.21 supports Control-M/Sever 9.0.19 and higher. This enables you to upgrade Control-M/Agents to version 9.0.21 before upgrading Control-M/Server. However, there are additional Control-M/Server patches that you need to install to enable this functionality. For more information and the list of patches, see 000393589.
If Compatibility Mode is on, you cannot deploy Control-M/Agent 9.0.21 packages.
Control-M/EM 9.0.21 must be installed.
You cannot use Agent deployment on a Network Load Balancer that represents an Agent or a group of Agents.
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 the Control-M/Agent windows service is set to Log on as > This account, the upgrade must be performed with this user.
To run a deploy activity in the CCM or in a CLI, you must have full access level in the Configuration and Operation privileges, as described in Privileges .
To upgrade to Control-M/Agent 9.0.21, Control-M/Agent 9.0.00.300 or higher must be installed.
You cannot upgrade more than one Control-M/Agent on the same Windows computer simultaneously.
BMC recommends to perform the Agent deployment in groups. By default, you can upgrade/downgrade 5 Control-M/Agents simultaneously. To change this configuration, see the DEPLOYMENT_THREADS parameter, as described in Deployment parameters.
In Windows, when deploying on Control-M/Agent with a very high load of jobs, deployment may fail. You must run the upgrade at a later stage, when the Control-M/Agent is not loaded or install with downtime. If you deploy, upgrade fails with the following message:
Installation with no downtime cannot be executed at this moment.
1. Check communication between Control-M/Agent and Control-M/Server.
2. Run the ctmagcfg utility. In Advanced parameters, verify that the Logical Agent Name value matches the Control-M/Agent Name defined in the Control-M/Server and rerun the installation again.
3. To install with downtime, shut down the Control-M/Agent processes and rerun the installation again.