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

Site typeDescription
Production

Use this type of site to deploy a connector to BMC Helix Integration Studio. A production site connects to on-premises applications that are located in a company network.

Development

Use this type of site to develop connectors in BMC Helix Connector Designer. For more information about developing connectors, see Developing connectors.


To add a production or development site

  1. In BMC Helix Integration Studio, go 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.

Note

After you add a production site, you must configure it. The site specifies which Integration Controller runs the connector and includes other relevant information that depends on the connector. Typically, the configuration includes the following information:

  • The host where the target application is located.
  • The port used to connect to the application.
  • The protocol used to connect to the application.

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:

IC-architecture

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

Note

The BMC Helix Integration Service cloud does not establish any inbound connection to Integration Controller. You do not need to open any inbound ports in your corporate firewall.

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

Tip

To check the system requirements for Integration Controller, see Installing and setting up the connector development environment


To increase the stability of BMC Helix Integration Service performance, BMC recommends that you install primary and secondary Integration Controllers. These controllers are configured as an active-active pair—if one of the controllers goes down, the other one continues processing.

Note

Installation of the the secondary Integration Controller and the sequence of installation are optional. You can install only primary, only secondary, or both Integration Controllers.

  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.

    Note

    Integration Controller is installed in your current directory. BMC recommends 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.

Note

If you have both primary and secondary Integration Controllers installed, and one of them is Offline or Impaired, the flows continue to run as expected until one of the controllers is Online.

To update a production site

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

You can update a site only if it is Online.

  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. Go to https://localhost:3000/  to open BMC Helix Connector Designer.
  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.

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

Comments

  1. Rainer Noeth

    Hello, we have an proxy for outgoing communication and this can only work over port 80 and 443. Is it possible to configure the port 61600 to port 80

    May 25, 2018 07:43
    1. Kevin Goerlitz

      No, an HTTP proxy cannot be used for the TCP port 61600.

      Sep 17, 2018 09:56