Configuring the TrueSight Server Automation connector

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


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. 









    Application Server (web services port) and Internet

    Communication with Application Server and Internet



    Application Server (web services port)


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

    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": ""
  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



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

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

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

Was this page helpful? Yes No Submitting... Thank you