Upgrading the on-premises gateway by using Podman containers

This topic describes how to upgrade the BMC Helix Intelligent Integrations on-premises gateway by using Podman 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 Podman 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-podman-images -<version>-<buildNo>.tgz
   • Utility file: hii-bmc-<version>-<buildNumber>.zip

3. Stop the podman-compose service.
   

   podman-compose down

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

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

6. Load the container images that you have downloaded.
   

   podman 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. (Optional) Perform the following steps if you want to upgrade the database

   1. Open the /opt/bmc/hii/podman -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 podman-compose service.
      

      podman-compose -f podman-compose.yaml up -d

   4. Open the /opt/bmc/hii/podman -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 podman-compose service.
      

      podman-compose down

9. Start the podman-compose service.
   

   podman-compose -f podman-compose.yaml up -d

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

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