search cancel

How do I install and configure the Automic Connector for AAI?

book

Article ID: 214384

calendar_today

Updated On:

Products

Automic Automation Intelligence

Issue/Introduction

How do I install and configure the Automic Connector for AAI?

Environment

Release : 6.2.0-2

Component : AUTOMIC AUTOMATION INTELLIGENCE ENGINE

Resolution

Beginning with AAI 6.1.0, the Automatic Workload Automation scheduler was added as a supported scheduler type.

This requires the installation of the Automic Connector.

The AAI 6.1.0 Release Notes provide some links for Prereqs and Setup.

 

The Automic Connector should be installed on a server close to the Automic Workload Automation Scheduler to cut down on any Network latency.

 

Below are some more details instructions for Linux than found in the links above.

 

1.  The AAI Automic Connector 2.0  from Support.broadcom.com, search for "Automic Automation Intelligence" and look for "AAI Automic Connector 2.0" and copy over to server.

2. For Windows, run the automic-connector-2.0.0.exe to install and follow the prompts.

When the installation finishes edit the application.yml file in the Automic Connector installation directory and update the URL to the AAI server, if on the same host you can use http://localhost:8080, otherwise use the server name in the URL.  Also update the AAI username, password, and Domain(Default is JAWS).

For Windows there will be a service created that can be Started or Stopped through services.msc called "automic-connector" 

If you installed on Windows go to Step 7 below.

If you are installing on linux go to Step 3 below.

3. For LInux - First create the /var/log/connector-framework directory before installation, this works around a permission denied message you may see in 6.1 GA, which is fixed in later builds.

mkdir /var/log/connector-framework

chmod 777 /var/log/connector-framework

 

4. Run rpm -i against the installation file.

rpm -i automic-connector-2.0.0.x86_64.rpm

 

Successful installation looks like:

rpm -i automic-connector-2.0.0.x86_64.rpm

 

Finish the installation by setting up your AAI-Server credentials. Run the following before starting the service:

cd /opt/broadcom/automic-connector
sudo -u automic-connector ./configure-automic-connector.sh

To start the service:

sudo systemctl start automic-connector

The service can be verified by running:

sudo systemctl status automic-connector

 

5. Run the configure script to configure the connector to point to your AAI installation.

cd /opt/broadcom/automic-connector

sudo -u automic-connector ./configure-automic-connector.sh

 

Follow prompts to enter the AAI URI, 

The example entries below are for the connector installed on the AAI server, running http, and on the default port.

** The connector name can be anything you want and will show up in the GUI when adding the scheduler**

[sudo -u automic-connector ./configure-automic-connector.sh
*** CONFIGURING CONNECTOR ***

Backing up configuration file to: application.yml.bak...
...Configuration file backed up to: application.yml.bak.

Please enter the following configuration parameters.

Enter AAI server URI (e.g., "https://localhost:4443"): http://localhost:8080
Enter connector name: automic
Enter host name: localhost
Enter connector key password (will not echo, required for HTTPS):
Enter AAI server username (required for HTTP): admin
Enter AAI server password (will not echo, required for HTTP): password
Enter connector domain: JAWS

 

If all is successful you will see 

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 ***

 

 

6. Start the service with the systemctl command, the below are examples of how to start, stop, restart and status commands. 

systemctl start automic-connector

systemctl stop automic-connector

systemctl restart automic-connector

systemctl status automic-connector

systemctl status automic-connector -l (Will provide more detail)

 

 

7. Add Automic Scheduler to Web UI v2

       Go to the Admin→Schedulers tab and add a new scheduler with the scheduler type "Automic Automation" then click on 'Add an Automic scheduler using the AAI web interface"

 

Or just go directly to http://<hostname>:8080/aai/web/v2/

Click on Home->System

 

 

 

Click on the + icon to add the Automic Scheduler

 

 

Enter Automic Scheduler details

 

For "Automic REST API Endpoint (URL)"
 
An example would be like below
http://<AutomicServer>:8088/ae/api/v1
 
 
 
 
For "Automic Web Interface (URL)"
 
An example could be:
http://<AutomicServer>:8080/awi/

 

 

Additional Information

Log file location:

/var/log/connector-framework/connector-framework.log

tail -f /var/log/connector-framework/connector-framework.log

 

greps for process status

ps -eaf | grep connector

 

Uninstall the connector

rpm -e automic-connector-2.0.0.x86_64

rm -rf /var/log/connector-framework

rm -rf /var/log/automic-connector

rm rf /opt/broadcom/automic-connector

Attachments