Chapter 3. Install Red Hat Discovery containers in a connected environment

Procedure

1. Install or update Podman.

   sudo dnf install -y podman

2. 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

3. 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 automatically starts after a successful installation.

   Note

   When you run the discoveryctl install command for the first time, it might prompt you to provide multiple required values.

   • discoveryctl install prompts you to define a new admin login username and password. You use those values to log in to Discovery.
   • discoveryctl install might prompt you to enter your credentials for the Red Hat container registry (registry.redhat.io) so that it can pull the Discovery container images. Discovery does not log, store, or use your Red Hat container registry credentials in any other way.

   • The first time you start Discovery, the initial startup procedure for the application might take a long time to complete. To obtain more verbose data during the initial startup of the Discovery application, 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

     If you want to access Discovery on another computer in the same network, you must allow traffic on TCP port 9443 through any firewall. This applies to any firewall to or on the system that is running the Discovery server.

Procedure

1. To reset the username, run the following command and follow the prompts to enter the new username:

   discoveryctl reset_admin_username

2. To reset the password, run the following command and follow the prompts to enter the new password:

   discoveryctl reset_admin_password

   Note

   If Discovery is running when you change the username or password, you must restart Discovery for the new values to take effect.

3. To restart Discovery, run the following command:

   systemctl --user restart discovery-app

   Important

   Red Hat does not provide support for lost passwords for Discovery, and Discovery does not offer a method to recover passwords. However, you can reset your username or password at any time after installation completes.

Verification

1. Log in to Discovery with the new username or password to verify that the change was applied successfully.