Control-M Automation API Provisioning

Control-M Automation API provides a Provision service for installation and setup of Control-M/Agents and several agent plug-ins and integration plug-ins, as well as for installation of Control-M/Servers.

Provisioning of Control-M/Servers or of new Control-M/Agents is based on images, which are json files that list the installation packages in the order that they are installed. Several default images are provided by the API, and you can create additional custom images (for example, for a newer version of the Control-M/Agent).

To prepare for provisioning, you must obtain the installation packages that are referenced within the images. You can also (optionally) customize the location in which to save these packages.

The following procedures describe the preparatory tasks for enabling provisioning:

Obtaining Installation Packages for Provisioning
Changing the Location of the Provision Service Installation Files
Creating a Custom Image for Provisioning

The Provision service in Control-M Automation API also enables you to upgrade an existing Control-M/Agent, by deploying a new version of the Control-M/Agent or installing/upgrading Control-M Managed File Transfer (MFT) or Control-M Application Pack. To prepare for this type of provisioning, see Preparing Installation Packages for Agent Upgrades

Obtaining Installation Packages for Provisioning

This procedure describes how to obtain the installation packages that are referenced from the provisioning images.

For a list of installation packages that you must set up for the default provisioning images, see Installation Packages Referenced by Default Images.

You might need additional installation packages that you reference from your own custom images, as discussed in Creating a Custom Image for Provisioning.

Begin

For each package that you want to download from the EPD site, perform the following steps:
1. Click https://www.bmc.com/available/epd.html and follow the instructions on the EPD site until you reach the Download Files page for the relevant product, version, and platform.
2. From the Products tab, click the relevant installation file and save it in the <EM_HOME>/AUTO_DEPLOY directory.
  
  If you choose to save installation packages in a different location, ensure that you perform the procedure described in Changing the Location of the Provision Service Installation Files.
Prepare the installation package for Control-M for Advanced File Transfer (provided that you have installed Control-M Managed File Transfer), by copying the relevant DRAFT*.zip or DRAFT*.tar.Z file from <EM_HOME>/CM_DEPLOY to <EM_HOME>/AUTO_DEPLOY.

Installation Packages Referenced by Default Images

The following table lists the installation packages that are referenced by the default provisioning images provided in Control-M Automation API.

Package Name	Product Component	Version	Referencing Images
DRKAI.9.0.20.000_Linux-x86_64.tar.Z	Control-M/Agent	9.0.20.000	Agent_20.Linux
DRFZ4.9.0.21.000_Linux-x86_64.tar.Z	Control-M/Agent	9.0.21.000	Agent.Linux ApplicationsAgent.Linux BigDataAgent.Linux
DR1CM.9.0.21.000_Linux-x86_64.tar.Z	Control-M for Databases	9.0.21.000	ApplicationsAgent.Linux BigDataAgent.Linux
DRAFT.9.0.21.000_Linux-x86_64.tar.Z	Control-M for Advanced File Transfer	9.0.21.000	ApplicationsAgent.Linux
DR1CM.9.0.21.000_Linux-x86_64.tar.Z	Control-M for Hadoop	9.0.21.000	ApplicationsAgent.Linux BigDataAgent.Linux
DRCTV.9.0.20.000_Linux-x86_64.tar.Z	Control-M/Server	9.0.20.000	Server_20.Linux
DRCTV.9.0.21.000_Linux-x86_64.tar.Z	Control-M/Server	9.0.21.000	Server.Linux
DRKAI.9.0.20.000_windows_x86_64.zip	Control-M/Agent	9.0.20.000	Agent_20.Windows
DRFZ4.9.0.21.000_windows_x86_64.zip	Control-M/Agent	9.0.21.000	Agent.Windows ApplicationsAgent.Windows
DR1CM.9.0.21.000_windows_x86_64.zip	Control-M for Databases	9.0.21.000	ApplicationsAgent.Windows
DRAFT.9.0.21.000_windows_x86_64.zip	Control-M for Advanced File Transfer	9.0.21.000	ApplicationsAgent.Windows
DRCTV.9.0.20.000_windows_x86_64.zip	Control-M/Server	9.0.20.000	Server_20.Windows
DRCTV.9.0.21.000_windows_x86_64.zip	Control-M/Server	9.0.21.000	Server.Windows

Changing the Location of the Provision Service Installation Files

This procedure describes how to change the default location of the Provision service installation files that are used in a fresh installation.

If you are using the Control-M Automation CLI and do not want to communicate with the server, you can, alternatively, use local Automation CLI parameters for the location of the images and other installation artifacts. For information about these parameters, see the description of the environment configure command of the Environment service.

Begin

Navigate to the following directory:
- UNIX: $HOME/ctm_em/etc/emweb/automation-api/downloads/descriptors
- Windows: <EM_HOME>\ctm_em\emweb\automation-api\downloads\descriptors
Open the ProvisionConfig.json file and change the ImagesLocation parameter to the new URI location.

By default, the string is empty, which means it is set to <EM_HOME>/AUTO_DEPLOY.

https://somewhere.someplace.com/

file:///home/controlm/installers

Creating a Custom Image for Provisioning

This procedure describes how to create a custom image by copying and editing one of the provided default images. This procedure is useful, for example, if you want to install a newer version of the Control-M/Agent or Control-M/Server during provisioning, or if you want to install a new fix pack on top of the base version.

Begin

Navigate to the following directory:
- UNIX: $HOME/ctm_em/etc/emweb/automation-api/downloads/descriptors
- Windows: <EM_HOME>\ctm_em\emweb\automation-api\downloads\descriptors
Create a copy of one of the existing images and store it within the same directory.

Give your new image file a name according to its objective, followed by .Linux or .Windows, and then the file extension .json.
Using any text editor, open the new image file that you created and edit the list of installation packages within it. Then save the file.
Download any new installation packages that you referenced within your new image and have not yet obtained. Store them in the proper location, as discussed in Obtaining Installation Packages for Provisioning.

For a list of installation packages that are referenced by the default images, see Installation Packages Referenced by Default Images.
To prepare for provisioning of Control-M/Agent version 9.0.20.000 with Patch 1 (PAKAI.9.0.20.001) on a Windows host, a copy of the Agent.Windows.json image is named Agent_9020001.Windows.json. The PAKAI.9.0.20.001_windows_x86_64.zip file is downloaded from the EPD site and the image file is edited to contain the following JSON code:
Copy
```
{
"OS": "windows-x86_64",
"Installers":
[
"DRKAI.9.0.20.000_windows_x86_64.zip",
"PAKAI.9.0.20.001_windows_x86_64.zip"
]
}
```
The above samples are overwritten by each new Automation API monthly release. You must copy the samples and make your own as indicated in step 2.
Ensure that your new image is detected by the API, by running the ctm provision images command. Ensure that your new image is returned by the API command.

For more information about this command, see Automation API Services.

Preparing Installation Packages for Agent Upgrades

This procedure describes how to prepare the installation packages that you need for Control-M/Agent upgrades using the Control-M Automation API Provision service.

Begin

Ensure that the <EM_HOME>/AUTO_DEPLOY directory contains the relevant Control-M/Agent packages to which you plan to upgrade.

If a package that you need is not yet located in this directory, obtain it from the EPD site:
1. Click https://www.bmc.com/available/epd.html and follow the instructions on the EPD site until you reach the download page for the relevant version and platform of the Control-M/Agent.
2. From the Products tab or the Patches tab, click the relevant Control-M/Agent package (DRKAI* or PAKAI* file, respectively) and save it in the <EM_HOME>/AUTO_DEPLOY directory.
Ensure that the <EM_HOME>/CM_DEPLOY directory contains the relevant installation packages for the following components:
- Control-M Managed File Transfer (MFT) Add-on: MFT installation packages for the Agent (DRAFT* or PAAFT*) are copied to the CM_DEPLOY directory during installation of Control-M MFT on the Control-M/EM server. If this directory does not yet contain the relevant package for Control-M MFT, download the relevant installation package (DRAFP* or PAAFP*) from the EPD site and perform the installation on the Control-M/EM server, as described in Control-M Managed File Transfer Installation.
- Control-M Application Pack Plug-in: Installation packages for this plug-in (DR1CM* or PA1CM*) are stored in the CM_DEPLOY directory during installation of Control-M/EM.