Control-M MFT Deployment

The Control-M MFT Deployment tool enables you to automatically install and upgrade Control-M MFT on multiple Agents from a single point of access.

From the CCM, you can copy Control-M MFT installation packages to multiple Agents. You can then install or upgrade Control-M MFT on the Agents to version 9.0.21 and higher on UNIX and Windows.

The following procedures describe how to deploy and roll back Control-M MFT on one or more Agents:

Deploying Control-M MFT

This procedure describes how to transfer Control-M MFT installation packages to existing Agents and install or upgrade Control-M MFT on UNIX or Windows.

  • You can only upgrade to Control-M MFT 9.0.21 or higher on Control-M/Agent and Control-M MFT, versions 9.0.18 and higher.

  • You cannot simultaneously upgrade Control-M MFT on multiple Agents on the same computer.

Before You Begin

  • Verify that the Control-M MFT installation package that you obtained from EPD has been installed on the Control-M/EM Server, as described in Control-M MFT Deployment Package Installation.

  • Verify that you have Full access to the Configuration and Operation categories in Admin Management in the Configuration domain, as described in Role Authorizations.

  • (Windows only) If the Control-M/Agent Windows service is set to Log on as > This account, you must upgrade with this user account.

Begin

  1. From the Manage tab in the CCM, select Deployment.

    The Deployment window appears.

  2. Click New Activity, click Managed File Transfer, and then click Install/Upgrade.

    The Upgrade Control-M/Agents Activity window appears.

  3. Do the following:

    1. In the Activity Name field, type a new name for this deployment activity.

    2. (Optional) In the Description field, describe the purpose of this activity.

    3. (Optional) In the E-Mail Notification field, type one or more email addresses where notifications about this activity are sent.

      You must also define the email server parameters, as described in SMTP Parameters.

  4. Select one of the following actions:

    • Send MFT to Control-M/Agent(s): Transfers the MFT installation package to specific Agents. After the package is transferred, you can manually start the upgrade process at any time from the Agent Deployment window or upgrade with the CLI, as described in ccmcli.

    • Send and Install MFT to Control-M/Agent(s): Transfers the MFT installation package to specific Agents and starts the upgrade process.

    • The Control-M MFT installation package is deleted after it successfully upgrades. If the upgrade fails, the installation package remains on the Agent until the next successful upgrade.

    • The Control-M MFT installation package remains on the Control-M/Server computer for 30 days. To change this limit, redefine the Control-M/Server system parameter AD_RETAIN_PACKAGES, as described in Deployment Parameters.

  5. Click Next.

  6. Select the Agents to deploy Control-M MFT.

    (Windows only) If you select an Agent that is set to Logon as User, you must define the Run as User for each Agent, as described in Adding a Run as User.

  7. In the Set Java Home Directory Location for the Selected Agents field, type the path that points to the external Java installation for all selected Agents.

    If the path is incorrect and the deploy fails, you can update the path in the Properties pane.

    You can only define one Java home directory for this deployment activity. If you need to deploy MFT to platforms with different Java paths, you must create a separate deployment activity for each platform. To view the OS type for each Agent, see the Operating System column in the Components table. For more information, see Control-M External Java Installation.

Rolling Back Control-M MFT

This procedure describes how to roll back the Control-M MFT upgrade from multiple Agents. You can only roll back Control-M MFT if it was upgraded with the Deployment tool.

Before You Begin

  • Verify that all jobs on the selected Agents have ended. Jobs that are still running during the rollback might fail.

  • Verify that you have Full access to the Configuration and Operation categories in Admin Management in the Configuration domain, as described in Role Authorizations.

  • (Windows only) If the Control-M/Agent Windows service is set to Log on as > This account, you must upgrade with this user account.

Begin

  1. From the Manage tab in the CCM, select Deployment.

    The Deployment window appears.

  2. Click New Activity, click Managed File Transfer, and then click Rollback.

    The MFT Rollback window appears.

  3. Do the following:

    1. In the Activity Name field, type a new name for this deployment activity.

    2. (Optional) In the Description field, describe the purpose of this activity.

    3. (Optional) In the E-Mail Notification field, type one or more email addresses where notifications about this activity are sent.

      You must also define the email server parameters, as described in SMTP Parameters.

  4. Click Next.

  5. Select the Agents with Control-M MFT to roll back.

  6. Click Rollback.

    The rollback process begins immediately and Control-M MFT rolls back to its previous version. To view and troubleshoot the internal stages of the rollback, click Log from the Deployment window.