Control-M for Ansible AWX

Ansible AWX jobs enable you to manage Ansible playbooks, inventories, and job scheduling.

Control-M for Ansible AWX enables you to do the following:

Execute any of the following Ansible AWX job actions:
- Launch job templates
- Launch workflow templates
- Synchronize inventory sources
- Synchronize projects
Manage Ansible AWX credentials in a secure connection profile.
Connect to any Ansible AWX endpoint.
Introduce all Control-M capabilities to Control-M for Ansible AWX, including advanced scheduling criteria, complex dependencies, Resource Pools, Lock Resources, and variables.
Integrate Ansible AWX jobs with other Control-M jobs into a single scheduling environment.
Monitor the status, results, and output of Ansible AWX jobs.
Attach an SLA job to the Ansible AWX jobs.

Control-M for Ansible AWX Compatibility

The following table lists the prerequisites that are required to use the Ansible AWX plug-in, each with its minimum required version.

Component	Version
Control-M/EM	9.0.21.200
Control-M/Agent	9.0.21.200
Control-M Application Integrator	9.0.21.200
Control-M Automation API	9.0.21.200

Control-M for Ansible AWX is supported on Control-M Web and Control-M Automation API, but not on the Control-M client.

To download the required installation files for each prerequisite, see Obtaining Control-M Installation Files.

Setting up Control-M for Ansible AWX

This procedure describes how to deploy the Ansible AWX plug-in, create a connection profile, and define an Ansible AWX job in Control-M Web and Automation API.

Integration plug-ins released by BMC require an Application Integrator installation. However, these plug-ins are not editable and you cannot import them into Application Integrator. To deploy these integrations to your Control-M environment, import them directly into Control-M with Control-M Automation API.

Before You Begin

Verify that Automation API is installed, as described in Automation API Installation.

Begin

Create a temporary directory to save the downloaded files.
Download the Ansible AWX plug-in from the Control-M for Ansible AWX download page in the EPD site.
Install the Ansible AWX plug-in with the Automation API Provision service:
1. Log in to the Control-M/EM Server machine as an Administrator and store the downloaded zip file in the one of the following locations:
  - Linux: $HOME/ctm_em/AUTO_DEPLOY
  - Windows: <EM_HOME>\AUTO_DEPLOY
2. Log in to the Control-M/Agent machine and run the provision image command, as follows:
  - Linux: ctm provision image Ansible_AWX_plugin.Linux
  - Windows: ctm provision image Ansible_AWX_plugin.Windows
Create an Ansible AWX connection profile in Control-M Web or Automation API, as follows:
- Web: Create a Centralized Connection Profile with Ansible AWX Connection Profile Parameters
- Automation API: ConnectionProfile:Ansible AWX
Define an Ansible AWX job in Control-M Web or Automation API, as follows:
- Web: Create a Job with Ansible AWX Job parameters
- Automation API: Job:Ansible AWX

To remove this plug-in from an Agent, see Removing a Plug-in. The plug-in ID is AWX122024.

Change Log

The following table provides details about changes that were introduced in new versions of this plug-in:

Plug-in Version	Details
1.0.02	Improved handling of Template workflow and run by ID
1.0.01	Improve handling of templates launched with non-unique names in the system
1.0.00	Initial version