이 콘텐츠는 선택한 언어로 제공되지 않습니다.

Installing Red Hat Edge Manager on Red Hat Enterprise Linux


Red Hat Edge Manager 1.0

Installing Red Hat Edge Manager on Red Hat Enterprise Linux

Red Hat Edge Manager Documentation Team

Abstract

This document provides information about installing Red Hat Edge Manager on Red Hat Enterprise Linux

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

  1. SSH into your Red Hat Enterprise Linux host.
  2. Authenticate and log in to the Red Hat Container Registry:

    sudo podman login registry.redhat.io
    Copy to Clipboard Toggle word wrap
  3. 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
      Copy to Clipboard Toggle word wrap
    • Install the Red Hat Edge Manager service by running:

      sudo dnf install -y flightctl-services
      Copy to Clipboard Toggle word wrap
  4. Enable and start the services:

    Warning

    This command may take a few minutes to fully initialize all background services.

    sudo systemctl enable --now flightctl.target
    Copy to Clipboard Toggle word wrap
  5. Execute the following command to verify the status of the required services:

    sudo systemctl list-units flightctl-*.service
    Copy to Clipboard Toggle word wrap

Ensure that all listed services show a status of active.

Note

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
Copy to Clipboard Toggle word wrap

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

  1. Create the flightctl-admin role group for global administrators:

    sudo podman exec -i flightctl-pam-issuer groupadd flightctl-admin
    Copy to Clipboard Toggle word wrap
  2. Create a new user:

    sudo podman exec flightctl-pam-issuer adduser <USER>
    Copy to Clipboard Toggle word wrap
  3. Set the user’s password using chpasswd:

    sudo podman exec -i flightctl-pam-issuer sh -c 'echo "<USER>:<PASSWORD>" | chpasswd'
    Copy to Clipboard Toggle word wrap
  4. 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>
    Copy to Clipboard Toggle word wrap

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

  1. Install the flightctl CLI with your package manager by running the following command:

    sudo dnf install -y flightctl-cli
    Copy to Clipboard Toggle word wrap
  2. Verify that the flightctl CLI is working correctly by running the following command:

    flightctl version
    Copy to Clipboard Toggle word wrap
    Note

    The output displays the Client Version. The Server Version is only available after you authenticate. Use the flightctl login command to log into the CLI for the first time to enable server version access.

  3. Run the following command to initiate the authentication process for the web UI.

    Note

    If 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>
    Copy to Clipboard Toggle word wrap

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

  1. Navigate to the UI at https://<DNS_Name>/ and log in using the credentials you created in the Configure authentication credentials section.
  2. Click the (question mark) icon in the upper part of the Red Hat Edge Manager UI.
  3. Select and click the downloadable archive file based on your Red Hat Enterprise Linux processor architecture.

    The <flightctl-os-arch>.tar.gz file is downloaded to your default download location.

  4. Extract the flightctl binary file from the downloaded archive.

    $ tar -xvf <flightctl-os-arch>.tar.gz
    Copy to Clipboard Toggle word wrap
  5. Run the following command to make the flightctl binary executable:

    chmod +x flightctl
    Copy to Clipboard Toggle word wrap
  6. Move the flightctl binary file to a directory in your execution path. In the following example, the /usr/local/bin directory is included in the path of the user:

    $ sudo mv flightctl /usr/local/bin/
    Copy to Clipboard Toggle word wrap
  7. Verify that the flightctl is working correctly by running the following command:

    flightctl version
    Copy to Clipboard Toggle word wrap

1.2. Next steps

Operating system images for using with Red Hat Edge Manager

Legal Notice

Copyright © Red Hat.
Except as otherwise noted below, the text of and illustrations in this documentation are licensed by Red Hat under the Creative Commons Attribution–Share Alike 3.0 Unported license . If you distribute this document or an adaptation of it, you must provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, the Red Hat logo, JBoss, Hibernate, and RHCE are trademarks or registered trademarks of Red Hat, LLC. or its subsidiaries in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
XFS is a trademark or registered trademark of Hewlett Packard Enterprise Development LP or its subsidiaries in the United States and other countries.
The OpenStack® Word Mark and OpenStack logo are trademarks or registered trademarks of the Linux Foundation, used under license.
All other trademarks are the property of their respective owners.
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

Red Hat을 사용하는 고객은 신뢰할 수 있는 콘텐츠가 포함된 제품과 서비스를 통해 혁신하고 목표를 달성할 수 있습니다. 최신 업데이트를 확인하세요.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

Theme

© 2026 Red Hat
맨 위로 이동