Configuring the TrueSight Orchestration connector

As an administrator, you configure a connector to enable integration with TrueSight Orchestration for change management. For any remediation operation (patch, vulnerability, compliance, and template-based), you can now create a change ticket with an approval process in BMC Remedy IT Service Management and ServiceNow. The TrueSight Orchestration connector establishes a connection and enables communication between TrueSight Orchestration and Automation Console. For more details about the integration, see Change 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:

  • AdoptOpenJDK Runtime Environment 18.9 (build 11.0.19+7) is installed on the connector host
  • Port requirement as below -

    Port

    Protocol

    Source

    Destination

    Inbound / Outbound

    open and usable port on connector VM

    HTTPS

    Connector

    HAC Saas and Internet

    Outbound

    38080

    HTTPS

    Connector

    Orchestration Server

    Outbound

    open and usable port on connector VM

    HTTPS

    Orchestration Server

    Connector

    Inbound

Configuring the connector

To configure the connector, do these steps: 

  1. Login to BMC Helix Automation Console.
  2. Go to the briefcase menu on the top right, and click Connectors > Add a Connector.
  3. From the on-premises connectors, select the TrueSight Orchestration connector, and click Configure.
  4. On the Add a connector page, provide the following details:

    1. Select Make Change approval mandatory to make change request creation and approval is mandatory when an operation is created.  
    2. Enter the host name where TrueSight Orchestration Grid Manager is installed in the https://<FQDN> format, and provide the port number. 
    3. Enter the username, and password required to log on to the Grid Manager. 
    4. After entering the password, click Save.
    5. Specify the name of the grid and save changes. 
  5. Click Continue and download the connector zip file on a local host. 
  6. On the server where the connector file is downloaded and extracted, go to the connector location, and run the following command to install and start the connector: 
    • Windows: run.bat
    • Linux: run.sh

    The connector starts running successfully. You can view the connector status on the Connectors page. 


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, if its already running
  2. Go to <ConnectorLocation>/config, open the application.properties file, add the following parameter and set it to debug, save the file

    #
    #Logging related Properties
    logging.level.com.bmc.connector.plugin.aoconnector=debug 
  3. Restart the connector.

Where to go next?

After successfully configuring the connector, you can now complete the tasks required to enable change automation. See Enabling change automation.


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

Comments