Deploying the BMC Helix Intelligent Integrations Gateway

Deploy the BMC Helix Intelligent Integrations Gateway in your on-premises environment to collect data from your on-premise tools and environments, and send the data to BMC Helix applications.

System requirements

Before you deploy BMC Helix Intelligent Integrations Gateway, ensure that your environment meets the hardware and software requirements.

Supported operating systems

BMC Helix Intelligent Integrations Gateway is supported on the following operating systems:

CentOS 7.x
Red Hat Enterprise Linux 8.x

Repository requirements

Make sure that your system meets the following requirements to access images from a local repository:

Requirement	Description
Hardware	Minimum 8 CPU with 32 GB memory and 120 GB disk space
Software	docker-ce-cli version 20 containerd.io version 1.6 docker version 20 docker-compose version 1.29
Port	The system must be reachable to the third-party connector port and it should be able to post data to BMC Helix Intelligent Integrations (SaaS deployment) on port 443.

Before you begin

Obtain the container images and utility from BMC Customer Support.
Ensure that you can access SaaS deployment of BMC Helix Intelligent Integrations.

To deploy the BMC Helix Intelligent Integrations Gateway

Log on to SaaS deployment of BMC Helix Intelligent Integrations and click the Download Installer link.
The installation script (Intelligent_Integrations_Installation_script.sh) is downloaded.
Copy both the container images, utility, and installation script to the same directory on the computer where you want to deploy BMC Helix Intelligent Integrations Gateway.
Provide execute permissions on the Intelligent_Integrations_Installation_script.sh script:
chmod +x Intelligent_Integrations_Installation_script.sh
Run the installation script:
./Intelligent_Integrations_Installation_script.sh
If the script is executed successfully, an output similar to the following is displayed:
------------ BMC Helix Intelligent Integrations Installation Script -------------
=================================================================================
Checking for prerequisites...
[Importing Docker images...] /

Docker image 'docker-images-bmc-22.4.00-RC2SHA1c56f3dcBUILD14.tgz' successfully imported.
Extracting the Docker utility file swp-bmc-22.4.00-RC2SHA1c3878dcBUILD14.zip
Starting Docker containers...
Creating swp-fluentd   ... done
Creating swp-zookeeper ... done
Creating swp-ui        ... done
Creating swp-arangodb ... done
Creating swp-broker    ... done
Creating swp-mediator ... done
Creating swp-backup    ... done
Creating swp-nginx     ... done
Waiting for Docker containers to start.
BMC Helix Intelligent Integrations is up and running.
Use URL http://<hostName>/swpui to access BMC Helix Intelligent Integrations.
The output includes the container names and the URL that you can use to access BMC Helix Intelligent Integrations.

To enable HTTPS

Use the following instructions to configure BMC Helix Intelligent Integrations to allow the UI and REST to use both use HTTPS for configuration.

Open the docker-compose.yaml file with a text editor.
Uncomment the following lines:
  nginx-proxy:
    image: nginxproxy/nginx-proxy
    ports:
      - "80:80"
      # - "443:443"

…
    volumes:
      - /var/run/docker.sock:/tmp/docker.sock:ro
      # - ./conf/certs:/etc/nginx/certs:ro
Update the VIRTUAL_HOST parameter with the host name that corresponds to the certificate, as shown in the following example:
VIRTUAL_HOST: localhost #,host.youcompany.com
Create a directory in the conf/certs directory and copy the *.crt and *.key certificates to this directory.

Where to go from here

Start configuring integrations with third-party sources. For more information, see Integrating-by-using-BMC-Helix-Intelligent-Integrations.