Dieser Inhalt ist in der von Ihnen ausgewählten Sprache nicht verfügbar.
Chapter 3. Installing Red Hat Discovery containers with the connected installation process
You use the connected installation process when you want to run Red Hat Discovery from a system that has internet access, also commonly referred to as a connected or online environment. During the Discovery connected installation process, you complete all steps from the system that you intend to use as the Red Hat Discovery server. You will enter commands to obtain, install, configure the environment for, and start the Discovery containers from the container images on the Red Hat Ecosystem Catalog website.
The connected installation process uses Podman to perform the container installation tasks for the Discovery server. You will need sudo permissions to install Podman on your system. However, you must not run the Discovery application using sudo or as the root user.
Prerequisites
- Before you begin, ensure that all hardware, software, and environment prerequisites are installed and configured. For more information about the prerequisites, see Installing prerequisites for Discovery.
3.1. Installing the Discovery database and server container images for the connected installation Link kopierenLink in die Zwischenablage kopiert!
During the connected installation of the Discovery database and server container images, you obtain the Discovery containers from the container images on the Red Hat Ecosystem Catalog website, configure the containers and configure Discovery, and start the containers.
Prerequisites
- The system on which you are downloading the Discovery container images must be connected to the internet.
- That system must be able to connect to the Red Hat Ecosystem Catalog.
Procedure
To install Discovery, use the following steps:
Run the following commands to get the
discoveryctlpackage that manages Discovery installation.sudo subscription-manager repos --enable <repository> sudo dnf install -y discoveryctl
sudo subscription-manager repos --enable <repository> sudo dnf install -y discoveryctlCopy to Clipboard Copied! Toggle word wrap Toggle overflow NoteIn the preceding command, replace <repository> with the following values:
-
For Red Hat Enterprise Linux 10, replace <repository> with
discovery-2-for-rhel-10-x86_64-rpms -
For Red Hat Enterprise Linux 9, replace <repository> with
discovery-2-for-rhel-9-x86_64-rpms -
For Red Hat Enterprise Linux 8, replace <repository> with
discovery-2-for-rhel-8-x86_64-rpms
-
For Red Hat Enterprise Linux 10, replace <repository> with
Run the following command to configure and install Discovery.
discoveryctl install
discoveryctl installCopy to Clipboard Copied! Toggle word wrap Toggle overflow NoteWhen you run the
discoveryctl installcommand for the first time, it may prompt you to provide multiple required values.-
discoveryctl installwill prompt you to define a new admin login username and password. You will use those values to log in to Discovery. -
discoveryctl installmay prompt you to enter your credentials for the Red Hat container registry (registry.redhat.io) so that it can pull Discovery’s container images. Discovery does not log, store, or use your Red Hat container registry credentials in any other way.
-
Start the Discovery application.
systemctl --user start discovery-app
systemctl --user start discovery-appCopy to Clipboard Copied! Toggle word wrap Toggle overflow NoteThe 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
# check if the service is running systemctl --user status discovery-appCopy to Clipboard Copied! Toggle word wrap Toggle overflow list all current containers podman ps -a
# list all current containers podman ps -aCopy to Clipboard Copied! Toggle word wrap Toggle overflow display service logs sudo journalctl -t discovery-app sudo journalctl -t discovery-server
# display service logs sudo journalctl -t discovery-app sudo journalctl -t discovery-serverCopy to Clipboard Copied! Toggle word wrap Toggle overflow display and follow service logs sudo journalctl -f -t discovery-app sudo journalctl -f -t discovery-server
# display and follow service logs sudo journalctl -f -t discovery-app sudo journalctl -f -t discovery-serverCopy to Clipboard Copied! Toggle word wrap Toggle overflow
3.2. Changing the Discovery username and password Link kopierenLink in die Zwischenablage kopiert!
You can change the Discovery server login username and password after installation, and your organization may require you to change them periodically. You should choose username and password values that align with common security best practices and your organization’s security standards.
The Discovery server password must meet the following requirements:
- must be at least ten characters long
- must contain at least one number
- must contain at least one letter
- cannot match the login username
- cannot match known weak passwords
- cannot match the previously provided Discovery default password
To reset the username, run the following command and follow the prompts to enter the new username:
discoveryctl reset_admin_username
discoveryctl reset_admin_username
To reset the password, run the following command and follow the prompts to enter the new password:
discoveryctl reset_admin_password
discoveryctl reset_admin_password
If Discovery is running when you change the username or password, you must restart Discovery for the new values to take effect.
To restart Discovery, run the following command:
systemctl --user restart discovery-app
systemctl --user restart discovery-app
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.
3.3. Setting other post-installation preferences Link kopierenLink in die Zwischenablage kopiert!
If you want to access Discovery on another computer in the same network, you must allow traffic on TCP port 9443 through any firewall to or on the system that is running the Discovery server.