Chapter 4. Install Red Hat Discovery containers in an air-gapped environment

Procedure

1. On the connected system:

   1. Install or update Podman on the connected system.

      sudo dnf install -y podman

   2. Log in to the Red Hat Ecosystem Catalog (the registry.redhat.io website). When prompted, supply your Red Hat Customer Portal account credentials.

      podman login registry.redhat.io

   3. Pull the Discovery container images and save them into a .tar.gz file.

      podman pull registry.redhat.io/discovery/discovery-ui-rhel9:2.8 registry.redhat.io/discovery/discovery-server-rhel9:2.8 registry.redhat.io/rhel9/postgresql-15:latest registry.redhat.io/rhel9/redis-7:latest
      podman save --multi-image-archive registry.redhat.io/discovery/discovery-ui-rhel9:2.8 registry.redhat.io/discovery/discovery-server-rhel9:2.8 registry.redhat.io/rhel9/postgresql-15:latest registry.redhat.io/rhel9/redis-7:latest | gzip > discovery-images.tar.gz

2. On the disconnected system:

   1. Transfer discovery-images.tar.gz to the disconnected system where Discovery will be installed.

   2. Install or update Podman on the disconnected system.

      sudo dnf install -y podman

   3. Load the container images into local storage for Podman.

      podman load -i discovery-images.tar.gz

   4. Enable the Discovery repository for the Red Hat Enterprise Linux version and system architecture, and install the discoveryctl package. Replace <repository> with the repository name from the prerequisites table.

      sudo subscription-manager repos --enable <repository>
      sudo dnf install -y discoveryctl

   5. Run the following command to configure and install Discovery.

      Warning

      Do not run any discoveryctl commands with sudo or as the root user. Doing so will result in a broken installation.

      discoveryctl install

      The Discovery application will automatically start after a successful installation.

      Note

      The first time discoveryctl install runs, it prompts for a new admin login username and password. Use those credentials to log in to Discovery.

      The initial startup of Discovery might take a long time to complete. To monitor startup progress, use the following commands:

      # check if the service is running
      systemctl --user status discovery-app

      # list all current containers
      podman ps -a

      # display service logs
      sudo journalctl -t discovery-app
      sudo journalctl -t discovery-server

      # display and follow service logs
      sudo journalctl -f -t discovery-app
      sudo journalctl -f -t discovery-server

      To access Discovery from another computer in the same network, allow traffic on TCP port 9443 through any firewall to or on the system that is running the Discovery server.