Upgrading the on-premises gateway by using Docker containers

This topic describes how to upgrade the BMC Helix Intelligent Integrations on-premises gateway by using Docker containers. 

Upgrading the BMC Helix Intelligent Integrations on-premises gateway involves the following tasks: 

• Upgrade the container images
• (Optional) Upgrade the database

Before you begin

• Review the system requirements and download the container images and utility files.
• Back up the connector configurations, see Backing-up-and-restoring-connector-configurations.

To upgrade the on-premises gateway by using Docker containers

1. Go to the server  where you want to upgrade the on-premises gateway.
2. Copy the following files that you have downloaded to the  /opt/bmc  directory: 
   • Container images: bmc-hii-docker-images -<version>-<buildNo>.tgz
   • Utility file: hii-bmc-<version>-<buildNumber>.zip

3. Stop the docker-compose service.
   

   docker-compose down

4. Delete and purge the existing container images from the local repository. 
   

   docker image prune -a
5. When prompted to purge all containers, enter Y.

6. Load the container images that you have downloaded.
   

   docker load --input /opt/bmc/bmc-hii-docker-images-<version>-<buildNo>.tgz
7. Unzip hii-bmc-<version>-<buildNumber>.zip   and overwrite the existing files in the /opt/bmc/hii directory.
   
8. Perform the following steps if you want to upgrade the database:

   1. Open the /opt/bmc/hii/ docker-compose.yaml file with a text editor and search for the following line:

      #      - --database.auto-upgrade

   2. Uncomment the line as follows:

      - --database.auto-upgrade

   3. Start the docker-compose service.
      

      docker-compose up -d

   4. Open the /opt/bmc/hii/ docker-compose.yaml file with a text editor and search for the following line:

      - --database.auto-upgrade

   5. Comment the line as follows:

      #      - --database.auto-upgrade

   6. Stop the docker-compose service.
      

      docker-compose down

9. Start the docker-compose service.
   

   docker-compose up -d

10. Verify that all the services are running depicting all containers are up without a restart.

    docker ps
11. Access the  BMC Helix Intelligent Integrations  UI by using the following URL:
    http://<hostName>:80/swpui