이 콘텐츠는 선택한 언어로 제공되지 않습니다.
Installing Red Hat Edge Manager on Red Hat Enterprise Linux
Installing Red Hat Edge Manager on Red Hat Enterprise Linux
Abstract
Chapter 1. Installing Red Hat Edge Manager on Red Hat Enterprise Linux 링크 복사링크가 클립보드에 복사되었습니다!
Install Red Hat Edge Manager on Red Hat Enterprise Linux to manage edge devices and applications at scale.
To get started using Red Hat Edge Manager on Red Hat Enterprise Linux, you must first:
1.1. Installing the Red Hat Edge Manager RPM package 링크 복사링크가 클립보드에 복사되었습니다!
Prepare your Red Hat Enterprise Linux host for the installation of the Red Hat Edge Manager by enabling the necessary repositories, installing the flightctl-services package, and then starting and verifying the running services.
Prerequisites
- An active Red Hat Edge Manager subscription enabled for your Red Hat account
A Red Hat Enterprise Linux host with:
- Minimal installation
- 4 cores and 16GB RAM (recommended)
- Administrative access (root or sudo-capable user)
- SSH access
- Podman installed for managing containers
- A DNS name that resolves to the Red Hat Edge Manager host’s IP address
Procedure
- SSH into your Red Hat Enterprise Linux host.
Authenticate and log in to the Red Hat Container Registry:
sudo podman login registry.redhat.io
sudo podman login registry.redhat.ioCopy to Clipboard Copied! Toggle word wrap Toggle overflow Install the necessary repositories and packages:
Ensure that the Red Hat Edge Manager repositories are enabled by running the following example command based on the version of Red Hat Enterprise Linux and architecture of your host:
sudo subscription-manager repos --enable edge-manager-1.0-for-rhel-9-x86_64-rpms
sudo subscription-manager repos --enable edge-manager-1.0-for-rhel-9-x86_64-rpmsCopy to Clipboard Copied! Toggle word wrap Toggle overflow Install the Red Hat Edge Manager service by running:
sudo dnf install -y flightctl-services
sudo dnf install -y flightctl-servicesCopy to Clipboard Copied! Toggle word wrap Toggle overflow
Enable and start the services:
WarningThis command may take a few minutes to fully initialize all background services.
sudo systemctl enable --now flightctl.target
sudo systemctl enable --now flightctl.targetCopy to Clipboard Copied! Toggle word wrap Toggle overflow Execute the following command to verify the status of the required services:
sudo systemctl list-units flightctl-*.service
sudo systemctl list-units flightctl-*.serviceCopy to Clipboard Copied! Toggle word wrap Toggle overflow
Ensure that all listed services show a status of active.
Some services are one-time initialization tasks (such as flightctl-db-migrate.service) and will correctly display a status of active (exited). Persistent background services will display as active (running).
Troubleshooting
If your services do not run correctly, use the following log command to troubleshoot further and remediate:
sudo journalctl -u <impacted service> -b --no-pager
sudo journalctl -u <impacted service> -b --no-pager
Once the operational status of the Flight Control services has been verified, the management server is ready to process requests.
You may now access the Web UI at https://<DNS_Name>; however, you must first configure valid authentication credentials to gain entry to the dashboard.
1.1.1. Configure authentication credentials 링크 복사링크가 클립보드에 복사되었습니다!
By default, Red Hat Edge Manager on Red Hat Enterprise Linux uses the PAM Issuer to provide OIDC-compliant authentication backed by local system credentials.
Procedure
Create the
flightctl-adminrole group for global administrators:sudo podman exec -i flightctl-pam-issuer groupadd flightctl-admin
sudo podman exec -i flightctl-pam-issuer groupadd flightctl-adminCopy to Clipboard Copied! Toggle word wrap Toggle overflow Create a new user:
sudo podman exec flightctl-pam-issuer adduser <USER>
sudo podman exec flightctl-pam-issuer adduser <USER>Copy to Clipboard Copied! Toggle word wrap Toggle overflow Set the user’s password using
chpasswd:sudo podman exec -i flightctl-pam-issuer sh -c 'echo "<USER>:<PASSWORD>" | chpasswd'
sudo podman exec -i flightctl-pam-issuer sh -c 'echo "<USER>:<PASSWORD>" | chpasswd'Copy to Clipboard Copied! Toggle word wrap Toggle overflow Add the user to a role group (in this example, user is being added to the `flightctl-admin' role group):
sudo podman exec -i flightctl-pam-issuer usermod -aG flightctl-admin <USER>
sudo podman exec -i flightctl-pam-issuer usermod -aG flightctl-admin <USER>Copy to Clipboard Copied! Toggle word wrap Toggle overflow
1.1.2. Installing the Flight Control CLI 링크 복사링크가 클립보드에 복사되었습니다!
You can install the Flight Control CLI via the RPM package or by downloading the binary from the UI.
1.1.2.1. Installing the Flight Control CLI RPM package 링크 복사링크가 클립보드에 복사되었습니다!
To install the Flight Control CLI using the RPM, complete the following steps:
Procedure
Install the
flightctlCLI with your package manager by running the following command:sudo dnf install -y flightctl-cli
sudo dnf install -y flightctl-cliCopy to Clipboard Copied! Toggle word wrap Toggle overflow Verify that the
flightctlCLI is working correctly by running the following command:flightctl version
flightctl versionCopy to Clipboard Copied! Toggle word wrap Toggle overflow NoteThe output displays the Client Version. The Server Version is only available after you authenticate. Use the
flightctl logincommand to log into the CLI for the first time to enable server version access.Run the following command to initiate the authentication process for the web UI.
NoteIf you are using self-signed certificates, you will be prompted to allow an insecure connection.
flightctl login https://<DNS_Name>:3443 --username <user_name> --password <password>
flightctl login https://<DNS_Name>:3443 --username <user_name> --password <password>Copy to Clipboard Copied! Toggle word wrap Toggle overflow
The CLI is now successfully authenticated and configured to communicate with the Flight Control API. It establishes a secure link between your local environment and the management server, allowing you to issue subsequent commands to manage your fleets and devices.
1.1.2.2. Installing the Flight Control CLI binary from the UI 링크 복사링크가 클립보드에 복사되었습니다!
To install the Flight Control CLI binary from the UI, complete the following steps:
Procedure
-
Navigate to the UI at
https://<DNS_Name>/and log in using the credentials you created in the Configure authentication credentials section. - Click the ❔ (question mark) icon in the upper part of the Red Hat Edge Manager UI.
Select and click the downloadable archive file based on your Red Hat Enterprise Linux processor architecture.
The
<flightctl-os-arch>.tar.gzfile is downloaded to your default download location.Extract the
flightctlbinary file from the downloaded archive.tar -xvf <flightctl-os-arch>.tar.gz
$ tar -xvf <flightctl-os-arch>.tar.gzCopy to Clipboard Copied! Toggle word wrap Toggle overflow Run the following command to make the
flightctlbinary executable:chmod +x flightctl
chmod +x flightctlCopy to Clipboard Copied! Toggle word wrap Toggle overflow Move the
flightctlbinary file to a directory in your execution path. In the following example, the/usr/local/bindirectory is included in the path of the user:sudo mv flightctl /usr/local/bin/
$ sudo mv flightctl /usr/local/bin/Copy to Clipboard Copied! Toggle word wrap Toggle overflow Verify that the
flightctlis working correctly by running the following command:flightctl version
flightctl versionCopy to Clipboard Copied! Toggle word wrap Toggle overflow