Configuring the TrueSight Server Automation connector

This topic provides an overview of and instructions to install and configure TrueSight Server Automation Connector. 

Overview

TrueSight Server Automation connector is used to establish connection between BMC Helix Automation Console with the on-premises TrueSight Server Automation Application Server. Automation Console sends notifications for jobs such as updating catalogs, and running patching jobs to the connector, which sends it to the Automation Console. The connector ensures that even if the application server is in an air-gapped environment, communication between Automation Console and the application server is uninterrupted. 

By default, the connector establishes a connection over the HTTPS protocol using out-of-the-box self-signed certificates. To ensure seamless communication, you must provide the connector information in the hosts file on Server Automation. 

Before you begin

Before running the connector, ensure that the connector is installed and run on Windows and Linux operating systems that match the following criteria:

• OpenJDK Runtime Environment 18.9 (build 11.0.2+9) is installed on the connector host.

• Port number 443 is open. 

  Port	Protocol	From	To	Notes
  443	HTTPS	Connector	Application Server (web services port) and Internet	Communication with Application Server and Internet
  443	HTTPS	Application Server (web services port)	Connector	Communication between Application Server and Connector

Installing the Server Automation connector

1. Download the connector file from the location provided in the email message when you complete the activation. 

2. Extract the tssa_connector.zip file on an internet-enabled server (inbound and outbound). 
   The host where the connector is installed must be accessible to the Server Automation application server. 

3. Go to /config/creds.json file and add the connector token provided by BMC.

   "connectorToken":<connector-token-value>

   Sample creds.json file with connector token information

   {
         "user": "ddf4c38e-202c-48f8-9fb5-be8a9168d2b0",
         "password": "",
         "deployment": "private",
         "connectorToken": "<connector-token-value>",
          "workerId": "ddf4c38e-202c-48f8-9fb5-be8a9168d2b0",
          endpoints": {
                    "pls": "POLICY_ENDPOINT",
                    "ifi": "",
                    "ifm": "",
                    "wmw": "https://tenant-app-url.bmc.com"
           }
   }

4. On the Server Automation application server, go to the hosts file and add the following:

   Hosts file location

   - Windows: C:\Windows\System32\drivers\etc\hosts

   - Linux: /etc/hosts

   <connector-ip>  tssa.connector.bmc.com

   Note

   If you choose to use DNS, you must register the connector server in the DNS as tssa.connector.bmc.com. No other name is currently supported.

5. On the server where the connector.zip is extracted, go to the connector location, and run the following command to install  and start the connector: 
   • Windows: run.bat
   • Linux: run.sh

   The Server Automation connector starts running successfully. 

Enabling debug mode

BMC recommends that you do not modify any other configuration files available in the /config directory. However, you can enable the debug mode on the connector to obtain detailed logging information.

Do this:

1. Press CTRL+C twice to stop the connector.

2. Go to <ConnectorLocation>/config, open the log4j.properties file, and change the logging option to debug.

   # Root logger option
   log4j.rootLogger=debug, file

3. Start the connector.

Where to go next?

Log in to BMC Helix Automation Console with the appropriate credentials to successfully verify the connector installation. See Logging in.