Installing and configuring sites to run on-premises connectors

Connectors can run in a cloud or in an on-premises environment. Connectors that run in an on-premises environment require a local connector runtime environment to be installed. As the BMC Helix Integration Service Tenant administrator, you can install one or more local connector runtime environments, referred to as sites.

A site specifies where to host the connector service and includes information that the connector needs to operate. It enables your applications to securely connect to the third-party systems.

BMC Helix Integration Service supports the following types of sites:

To add a production or development site

1. Log in to BMC Helix Integration Studio, as a tenant administrator and navigate to Sites.

2. Click Add New Site, and select the type of site you want to add.

3. Enter a name and a description for the site, and click Save.

Integration Controller communication connections

After you add a site, you must install Integration Controller on a virtual machine to connect to on-premises applications. The purpose of Integration Controller is to run connectors to execute flows and perform actions that involve other applications and services that run within your data center. The following illustration shows how Integration Controller interacts with on-premises applications and the BMC Helix Integration Service cloud:

Integration Controller safely and securely communicates with the BMC Helix Integration Service cloud by establishing an outbound connection to the cloud on port 61600. The connection from Integration Controller to the BMC Helix Integration Service cloud is encrypted via Transport Layer Security (TLS).

Integration Controller connects to the message queue that runs in the cloud, and receives configuration information and instructions on the actions to be performed. The protocol that runs over this connection is the Open Wire protocol.

To install Integration Controllers for high availability

1. In BMC Helix Integration Studio, go to Sites.
2. Next to a newly created production site, click Get Controller.
   

3. Next to a newly added site, click Get Controller. 

4. From the Install Integration Controller field, copy the installation command and run the command in a command shell.

   

   Best practice

   Integration Controller is installed in your current directory. We recommend that you create a new directory for the controller, and run the cURL command from the new directory. The installation process creates a number of files in the directory, such as docker-compose.yml, base-services.yml, reinitController, and panama-on-premise.env. You might need to use these files to troubleshoot.

5. In the command shell, follow the instructions, and enter a host password for your user account. 

6. Enter the controller instance you are installing: primary or secondary.

7. Refresh the Sites page in your browser. 

   The status of the installed controller is Online, as shown in the following image:

   

Integration Controller status

To verify the performance of either primary or secondary Integration Controller, check their statuses on the Sites tab in BMC Helix Integration Studio.

Integration Controllers can have the following statuses:

• Not Installed: Integration Controller is not installed for a site.
• Online: Integration Controller is installed and working.
• Offline: Integration Controller is stopped, or its connectivity is lost.
• Impaired: A connector that is configured for the site is not running.
  
  

To update a production site

The Update button appears for the production sites when updates to one or more base controller components become available.

1. In BMC Helix Integration Studio, go to Sites.

2. Next to a required production site, click Update.
   The primary and secondary Integration Controllers installed for the site restart, and then the site is updated.

3. Refresh any BMC Helix Integration Studio instances that are open in your browser.

To update a development site

When an update becomes available for a production site, you might want to update your development site as well.

1. To open BMC Helix Connector Designer in your browser, navigate to https://localHost:3000/.
2. From the top menu, select Integration Controller.
3. Click Stop, and then click Start.
   
   
   
   The Integration Controller installed for the site restarts, and then the site is updated.
4. Refresh any BMC Helix Integration Studio instances that are open in your browser.

To restart a connector

If an on-premises connector is down, as a part of the troubleshooting process, you can restart it as follows:

1. In BMC Helix Integration Studio, go to Sites.
2. Next to the required site, view Site Details.
3. In the Connector Status by Controller section, next to the required connector, click Restart connector.

For more information about troubleshooting a connector configuration, see Troubleshooting connector configuration issues