Deploying Application Plug-ins

This procedure describes how to transfer the Application Pack installation packages to existing Control-M/Agents and install or upgrade Application Plug-ins on UNIX or Windows.

NOTE: You cannot upgrade more than one Application Plug-in activity on the same Windows computer simultaneously.

To deploy Application Plug-ins:

1. From the Manage tab, select Deployment.

   The Deployment window appears.

2. Click New Activity >Application Pack> Install/Upgrade.

   The Application Pack Upgrade/Install window appears.

3. Do the following:
   1. In the Activity Name field, type a name for this activity.
   2. In the Description field, describe the purpose of this activity (optional).
   3. In the E-Mail Notification Address 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:
   • Send Application Pack to Control-M/Agent(s): Transfers the Application Pack installation package to specific Control-M/Agent computers. After the package is transferred, you can manually start the upgrade process, at any time, from the Deployment window or upgrade with CLI, as described in ccmcli.
   • Send and Install Application Pack to Control-M/Agent(s): Transfers the Application Pack installation package to specific Control-M/Agent computers and begins the upgrade process automatically.

   NOTE:

   • The Application Pack installation package is deleted after a successful upgrade. If the upgrade failed, then the installation package remains on the Control-M/Agent computer until the next successful upgrade.
   • The Application Pack 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. Select the Control-M/Agent(s) to deploy Application Plug-ins.

   NOTE: If you selected a Control-M/Agent on Windows that is set to Logon as User, you need to define the Run As User for each Control-M/Agent.

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.

   NOTE: You can only define one Java home directory for this deployment activity. If you need to deploy Application Pack 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 grid. For more information about external Java, see Control-M External Java Installation.

8. Depending on which method you selected, click Transfer or Install.

   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 Deployment window. If you selected to transfer the installation package, you can upgrade or install the Application Pack any time after the transfer is complete. A job runs on the Control-M/Agent(s) to verify that it upgraded successfully.