Upgrading Control-M/Agents

This procedure describes how to transfer installation packages to existing Control-M/Agents and upgrade them to the current base version or fix pack on UNIX, Windows, or AS400.

NOTE: (Windows only) An upgrade does not begin until all jobs have ended, unless you selected Force Upgrade in a Retry.

NOTE: You cannot upgrade more than one Control-M/Agent on the same Windows computer simultaneously.

To upgrade Control-M/Agents:

1. From the Manage tab, select Deployment.

   The Deployment window appears.

2. Click New Activity > Agent> Upgrade.

   The Upgrade Control-M Agents Activity window appears.

3. Do the following:
   1. In the Activity Name field, accept the default or type a new name for this activity.
   2. In the Description field, describe the purpose of this activity (optional).
   3. In the E-Mail Notification field, type the email address(es) that you want to receive notifications about this activity (optional).

      To receive email notification, you need to define the email server parameters, as described in SMTP parameters.

4. Select one of the following:
   • Transfer Package: Transfers the installation package to specific Control-M/Agent computers. After the package is transfered, you can manually start the upgrade process, at any time, from the Agent Deployment window or upgrade with CLI, as described in ccmcli.
   • Transfer and Automatically Install Package: Transfers the installation package to specific Control-M/Agent computers and begins the upgrade process automatically.

   NOTE:

   • The Control-M/Agent installation package is deleted after a successful upgrade. If the upgrade failed or you performed a transfer only, then the installation package remains on the Control-M/Agent computer for 30 days. If you want to change this setting, define the Control-M/Agent system parameter AD_RETAIN_PACKAGES, as described in Defining Control-M/Agent system parameters.
   • The Control-M/Agent installation package remains on the Control-M/Server computer for 30 days. If you want to change this setting, define the Control-M/Server AD_RETAIN_PACKAGES, as described in Defining Control-M/Server system parameters.
5. Click Next.
6. From the Upgrade Agents to Version drop-down list, select the version or fix pack that you want to upgrade to and then select the Control-M/Agent(s) that you want to upgrade.

   The list of values depends on the Agent installation packages in your repository. For more information, see Copying Control-M/Agent installation packages.

7. Depending on which method you selected, click Transfer or Upgrade.

   The transfer process starts and progress messages appear in the right pane of the deployment activity. To view and troubleshoot the internal stages of the upgrade, click Log from the Agent Deployment window. If you selected to transfer the installation package, you can upgrade the Control-M/Agent(s) any time after the transfer is complete. A job runs on the Control-M/Agent(s) to verify that it upgraded successfully.