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 third-party systems.

To add a site in development or production

  1. Log in to BMC Helix Integration Studio.
  2. Navigate to Sites, click Add New Site, and select the type of site you want to add.

    Site typeDescription
    ProductionSelect this type if you want to deploy a connector in Integration Studio.

    A production site connects to on-premises applications that are located in a company network.

    Note: After you add a production site, you must configure it. The site specifies which Integration Controller will run the connector and includes relevant information that depends on the connector. Typically, the configuration includes information related to the connection:
    • The host where the target application is located.
    • The port used to connect to the application.
    • The protocol used to connect to the application.
    DevelopmentSelect this type if you want to develop a connector by using the Connector Designer. See Developing connectors.
  3. Enter a name and 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).


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.

Integration Controller system requirements

For a successful installation of Integration Controller, your system must match the following requirements:

  • Operating system—Linux (physical or virtual machine):
    • CentOS 7.1 or later (7.3 preferred)
    • Ubuntu 14.04.5 or later (16.04.x preferred)
    • Red Hat Enterprise Linux 7.3 or later (7.4 preferred); note that Docker-EE must be installed as Red Hat Enterprise Linux no longer supports Docker-CE

  • Processor—Minimum 4 cores, 2.5 GHz processor speed
  • RAM—Minimum 8 GB
  • Disk space—Minimum 30 GB of free space
  • Network—Allow egress (outbound from one network to another) on port 61600 for bidirectional TCP traffic
  • (Optional) Container software:
    • Docker Engine 1.12 or later (included in Docker)
    • Docker Compose 1.9 or later (which might not be included in Docker, depending on the OS)

To install Integration Controllers for high availability

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.


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. Log in to BMC Integration Studio as a tenant administrator.
  2. Navigate to Sites, and on the new production site that you have created, click Get Controller

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


    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 while troubleshooting Integration Controller.

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

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

  6. Refresh the Sites page in your browser. 

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

Integration Controller status

You can verify the performance of either primary, or secondary Integration Controller by checking 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.


If you have both primary and secondary Integration Controllers installed, and one of them is in Down or Impaired status, flows will continue to run as expected until either controller is Online.

To update a production site

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

You can update a site only if it is Online.

  1. Log in to BMC Helix Integration Studio.
  2. Navigate to Sites, and click Update to update the intended production site.
    Any primary and secondary Integration Controllers installed for the site restart (this may take a few minutes), and 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 production sites (see previous section), you may want to update your development sites as well.

  1. Go to https://localhost:3000/ in your browser to open BMC Helix Connector Designer.
  2. Click Integration Controller in the top menu.
  3. Click Stop, and then click Start.

    The Integration Controller installed for the site restarts (this may take a few minutes), and 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


  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