Configuring Podman in RHEL 8

In v33.1.0 and later, Hyperscience gives you the possibility to deploy the application on RHEL 8.4 or later. RHEL 8.4 and later uses Podman instead of Docker. The sections below describe how you can configure Podman.

Prerequisites

Before you start configuring RHEL 8, you need to meet the following requirements, depending on whether you are installing or upgrading the Hyperscience application.

Installing the Hyperscience application on a new RHEL 8.4+ instance

If you are already running RHEL 8.4 or later, and you are installing Hyperscience for the first time, you may proceed directly to the steps outlined in Configuring Podman.

Upgrading from RHEL 7 to RHEL 8.4+ when Hyperscience is already installed

Before you start configuring RHEL 8, you need to upgrade Hyperscience to a RHEL-8-compatible version (v33.1.0 or later) by following these steps:

  1. To save space that is consumed by Docker images, clear the Docker containers.

  2. Upgrade your Hyperscience application to v33.1.0 or later by following the steps outlined in our Upgrading to v33 article.

  3. Check the application’s health status.

  4. Upgrade from RHEL 7.x to RHEL 8.4 or later by following the steps outlined in Red Hat’s Upgrading From RHEL 7 to RHEL 8 article.

Configuring Podman

To configure Podman, follow the steps below:

  1. Install the container-tools module using the following command:

    yum module install -y container-tools

    To learn more, see the “1.5. Getting container tools” section of Red Hat’s Building, running, and managing containers article.

  2. Install the podman-docker package using the following command:

    yum install -y podman-docker

    The podman-docker package replaces the Docker command-line interface and docker-api with the matching Podman commands. Every time you run a Docker command, the system will actually run a Podman command. To learn more, see the “1.3 Running containers without Docker” section of Red Hat’s Building, running, and managing containers article.

  3. Enable Podman API using the following commands:

    yum install podman-remote
    systemctl enable --now podman.socket

    To learn more, see the “15.1. Enabling the Podman API using systemd in root mode” section of Red Hat’s Building, running, and managing containers article.

  4. Enable the Podman restart service using the following command:

    systemctl enable --now podman-restart.service

    Enabling this option allows Podman to restart the Hyperscience application automatically upon OS restart.

  5. Give sudo access, as it is a requirement for installations, upgrades, and running the run.sh command on RHEL 8. To learn how to give sudo access, see Red Hat’s Managing sudo access.

  6. If you are upgrading the Hyperscience application, you also need to recreate the database container.