Setting Up the Control-M Connector

AAI for Control-M allows you to put the runtime information of executions from different Clients in multiple Control-M systems into a single view. This means that you can see running executions (and possible failed ones) of more than one Control-M system in a single interface, without having to switch from one Control-M interface to another.

This topic gives you an overview of the AAI integration for Control-M and instructions on how to setup and configure your Control-M Connector.

Overview

Click the image to expand it.

Each Control-M datacenter that you want to add to your AAI environment requires its own Control-M scheduler configuration. Several schedulers can be linked to one Connector. However, only one Connector can be linked to an AAI environment.

Before adding a Control-M instance to your AAI system, you must have AAI up and running. For more information, see Installation and Upgrade.

If you need help with the installation, please contact our support team at https://support.broadcom.com/.

The naming conventions for Control-M connectors (mainframe and distributed) .zip files are AAI.Control.M.Connector.<product_version>.zip and AAI.Control.M.Connector.Z<product_version>.zip, respectively.

Also, you can secure your Connectors using TLS 1.2 based secure connections. For more information, see Securing AAI

Installing/Upgrading the Control-M Connector on Windows

To install or upgrade the Control-M Connector on Windows:

1. Go to https://downloads.automic.com/, log in with your Broadcom account and download the relevant version of the Connector. For more information ,see Downloads.

2. Run the connector.control-m.exe file to setup the installer.

3. Follow the instructions in the setup wizard. You can define a destination directory, if you want to create a Start Menu folder and / or shortcuts for all users.

   Make sure you enter the information required:

   • AAI server URI

     You must specify the protocol, domain host name or IP address, and a listening port number of the AAI server. This information should be captured during the AAI server installation.

     If you are using the Connector certificate, this URI may use HTTPS and port 4443. Otherwise, it will likely be the same port that is used to launch the AAI client from a browser, for example http{s}://hostname:port.

   • Connector name

     Name of your choice. This name will be selected from the web UI when adding a scheduler to AAI.

   • Host name

     Domain name or IP address of the host where the Connector runs

   • Connector key password

     This is only required if an HTTPS connection is used between the Connector and the AAI server. If HTTP is used, leave this empty and hit Enter.

   • AAI server user name

     Only required when using HTTP.

     Name of the user ID that will be used to establish a connection to the AAI server. The user must be authorized to add new schedulers.

   • AAI server password

     This is required only if a HTTP connection is used between the Connector and the AAI server. If HTTPS is used, this can be omitted.

   • Connector domain

     Typically this is JAWS. This is the login domain for the user/password provided and it can be any of the list of domains that have been set up in AAI. For more information about domains, see Domains.

   • Log file output path

     The path to the location of the log files. The directory must exist and be writable for the connector user account.

   • Max log file size

     The maximum size of the log files. Must be defined as an integer in MB and must be 1 or larger.

   • Max log file count

     The number of log files to be retained. Must be defined as an integer in MB and must be 5 or larger.

   When you are done with the wizard, you can find the Control-M Connector folder in the directory that you defined.

   The Connector starts as a Service (connector.control-m). You can use the services.msc to start and stop the service or to check its status.

   If the connection is successful, the application.yml file is created in the folder where you have installed the Connector. This is a configuration file that contains the configuration values that you have just entered. At the same time, a backup copy of the application.yml is automatically created and renamed to application.yml.bak.

   In the case of a failure, the application.yml file is not populated with the values you entered. You would have to manually repeat the configuration process.

You also have to add Control-M schedulers to your AAI environment. To do so, go to System > Schedulers in your web interface and follow the steps in the dialog to add a Control-M scheduler. For more information, see Configuring Control-M / Control-M (z) Schedulers.

If the process was successful, the new schedulers are listed with all the schedulers available in your system.

Starting, Stopping, and Connector Status

You can also run the installation file to start or stop the connector or to check its status.

.\aai-control-m-connector.exe /start

.\aai-control-m-connector.exe /stop

.\aai-control-m-connector.exe /status

Expected output if the service is running:

Running.

Auto-start.

Expected status if the service is not running:

Not running.

Auto-start.

For details, refer to the output.log file that is created in the folder where the Connector was installed.

Installing the Control-M Connector on UNIX

To install the Control-M Connector on UNIX:

1. Go to https://downloads.automic.com/, log in with your Broadcom account and download the relevant version of the Connector. For more information ,see Downloads.

2. Unzip the .zip file that you downloaded and unpack the .tar.gz file within to get the connector-install.sh and connector.control-m-<version>.rpm files.

3. Run connector-install.sh to start the installation, for example:

   ./connector-install.sh install

   The Connector is installed using the .rpm file provided.

4. Configure the Connector to point to your AAI installation. To do so, run the configure script:

   cd /opt/broadcom/connector.control-m

   sudo -u connector.control-m ./configure-connector.control-m.sh

   Follow the prompts and make sure you enter the information required:

   • AAI server URI

     You must specify the protocol, domain host name or IP address, and a listening port number of the AAI server. This information should be captured during the AAI server installation.

     If you are using the Connector certificate, this URI may use HTTPS and port 4443. Otherwise, it will likely be the same port that is used to launch the AAI client from a browser, for example http{s}://hostname:port.

   • Connector name

     Name of your choice. This name will be selected from the web UI when adding a scheduler to AAI.

   • Host name

     Domain name or IP address of the host where the Connector runs

   • Connector key password

     This is only required if an HTTPS connection is used between the Connector and the AAI server. If HTTP is used, leave this empty and hit Enter.

   • AAI server user name

     Only required when using HTTP.

     Name of the user ID that will be used to establish a connection to the AAI server. The user must be authorized to add new schedulers.

   • AAI server password

     This is required only if a HTTP connection is used between the Connector and the AAI server. If HTTPS is used, this can be omitted.

   • Connector domain

     Typically this is JAWS. This is the login domain for the user/password provided and it can be any of the list of domains that have been set up in AAI. For more information about domains, see Domains.

   • Log file output path

     The path to the location of the log files. The directory must exist and be writable for the connector user account.

   • Max log file size

     The maximum size of the log files. Must be defined as an integer in MB and must be 1 or larger.

   • Max log file count

     The number of log files to be retained. Must be defined as an integer in MB and must be 5 or larger.

   Example

   This example shows the Connector installed running HTTPS and on the default port. The Connector name can be freely defined and shows up in the UI when adding the scheduler.

   [sudo -u connector.control-m ./configure-connector.control-m.sh
   If you are planning to make a TLS based connection to AAI then before proceeding
   please obtain the connector certificate package from the AAI server
   and copy it to ./secure/
   Press ENTER to continue...
   
   *** CONFIGURING CONNECTOR ***
   
   Backing up configuration file to: application.yml.bak...
   ...Configuration file backed up to: application.yml.bak.
   
   Please enter the following configuration parameters.
   
   AAI server URI [https://localhost:4443]: https://<host>:4443
   Connector name: control-m
   Host name: host
   Connector key password (will not echo, required for HTTPS):
   AAI server username (required for HTTP):
   AAI server password (will not echo, required for HTTP):
   Connector domain: JAWS
   Log file output path. The directory must exist and be writable for the connector user account. [./logs]:
   Max log file size. An integer, in MB. Must be >= 1. [10]:
   Max log file count. An integer, in MB. Must be >= 5. [5]:

   If the installation ended successfully you see the following:

   Verifying AAI server connectivity (please stand by)...2020-12-08 23:54:55,708 INFO [ApiCallerUtil] Attempting HTTP connection to AAI
   
   ...AAI server connectivity verified.
   
   Saving connector configuration to: application.yml...
   ...connector configuration saved to: application.yml.
   
   *** CONNECTOR CONFIGURED ***

5. Start the service using the following command:

   sudo systemctl start connector.control-m

You also have to add Control-M schedulers to your AAI environment. To do so, go to System > Schedulers in your web interface and follow the steps in the dialog to add a Control-M scheduler. For more information, see Configuring Control-M / Control-M (z) Schedulers.

If the process was successful, the new schedulers are listed with all the schedulers available in your system.

Starting, Stopping, Upgrading, Uninstalling and Connector Status

You can verify the service by running the following command:

sudo systemctl status connector.control-m

You can also use the systemclt command to stop or to restart the connector, or to get its status. For example:

sudo systemctl stop connector.control-m

sudo systemctl restart connector.control-m

sudo systemctl status connector.control-m

If for any reason the service is disabled, you can use the following systemctl command to enable it:

sudo systemctl enable connector.control-m

This is recommended to have the Connector restart automatically as part of the server reboot process.

You can also run the connector-install.sh to upgrade or uninstall the connector, or to get its status using the following commands:

./connector-install.sh upgrade

./connector-install.sh uninstall

./connector-install.sh status

If the current status of your system does not allow you to run a specific command, you get a corresponding error message. For example, you cannot upgrade a package that has not yet been installed.

./connector-install.sh upgrade

Can't upgrade the connector 'connector.control-m" isn't installed. Please 'install' instead.

See also:

• Connectors for Universal Schedulers

• Configuring the Connectors for TLS Authentication

• Configuring Control-M / Control-M (z) Schedulers