Dieser Inhalt ist in der von Ihnen ausgewählten Sprache nicht verfügbar.
Chapter 2. Connect and register systems to Red Hat services
To register your RHEL system to Red Hat services, you must establish your system’s identity in the Hybrid Cloud Console. One of the ways that you can do that is by using the recommended rhc client.
2.1. System registration with the rhc client Link kopierenLink in die Zwischenablage kopiert!
Before configuring your system to connect using the rhc client, review the configuration in Red Hat Hybrid Cloud Console > Red Hat Lightspeed > Inventory > System Configuration > Remote Host Configuration (RHC). The remote host configuration manager settings affect how Red Hat Lightspeed remediations function with the system.
2.2. Register RHEL 10 systems Link kopierenLink in die Zwischenablage kopiert!
You can register your RHEL 10 system by using the remote host configuration (rhc) client to connect to Red Hat services with the default feature levels.
This connection enables all available features: access to Red Hat content, analytics for Red Hat Lightspeed, and remote management. You can also disable any of the default feature levels.
Prerequisites
- You are logged in to the system as root or have sudo permissions.
- You have an activation key and an organization ID to register your system. For more information, see the Red Hat Knowledgebase solution, Creating Red Hat Customer Portal Activation Keys.
- You have completed the steps to Manage system connectivity and networking.
- (Optional) You have completed steps to Minimize data collection and control data privacy.
Procedure
- Open a terminal window.
To register the system with the default feature levels and ensure the system can execute remediations and tasks from Red Hat Lightspeed, enter the following commands:
rhc connect --activation-key=<activation_key> --organization=<organization_ID>
# rhc connect --activation-key=<activation_key> --organization=<organization_ID>Copy to Clipboard Copied! Toggle word wrap Toggle overflow dnf install -y rhc-worker-playbook
# dnf install -y rhc-worker-playbookCopy to Clipboard Copied! Toggle word wrap Toggle overflow Optional: To disable any of the features while you register your system, enter the following command:
rhc connect --activation-key=<activation_key_name> --organization=<organization_ID> --disable-feature <feature>
# rhc connect --activation-key=<activation_key_name> --organization=<organization_ID> --disable-feature <feature>Copy to Clipboard Copied! Toggle word wrap Toggle overflow Where you can replace feature with:
- content - Provides access to Red Hat CDN repositories.
- analytics - Enables data collection for Red Hat Lightspeed.
remote-management - Establishes an additional MQTT network connection to Red Hat services for remote execution of certain actions from the Red Hat Hybrid Cloud Console.
Example
To register your system with remote management disabled, but allow the system access to RHEL content and data for Red Hat Lightspeed analytics, enter:
rhc connect --activation-key=<activation_key_name> --organization=<organization_ID> --disable-feature remote-management
# rhc connect --activation-key=<activation_key_name> --organization=<organization_ID> --disable-feature remote-managementCopy to Clipboard Copied! Toggle word wrap Toggle overflow
Verification
To confirm the active features when registering with default options:
rhc status
# rhc statusCopy to Clipboard Copied! Toggle word wrap Toggle overflow Connection status for hostname.example.com: ✓ Connected to Red Hat Subscription Manager ✓ Content ... Red Hat repository file generated ✓ Analytics ... Connected to Red Hat Lightspeed ✓ Remote Management ... The yggdrasil service is active
Connection status for hostname.example.com: ✓ Connected to Red Hat Subscription Manager ✓ Content ... Red Hat repository file generated ✓ Analytics ... Connected to Red Hat Lightspeed ✓ Remote Management ... The yggdrasil service is activeCopy to Clipboard Copied! Toggle word wrap Toggle overflow To confirm the active features with
remote-managementdisabled:rhc status
# rhc statusCopy to Clipboard Copied! Toggle word wrap Toggle overflow Connection status for hostname.example.com: ✓ Connected to Red Hat Subscription Manager ✓ Content ... Red Hat repository file generated ✓ Analytics ... Connected to Red Hat Lightspeed [ ] Remote Management ... The yggdrasil service is inactive
Connection status for hostname.example.com: ✓ Connected to Red Hat Subscription Manager ✓ Content ... Red Hat repository file generated ✓ Analytics ... Connected to Red Hat Lightspeed [ ] Remote Management ... The yggdrasil service is inactiveCopy to Clipboard Copied! Toggle word wrap Toggle overflow ImportantTo use remote management, you must enable the
yggdrasildaemon. Whenyggdrasilis inactive, remote management is also inactive.
2.2.1. Customize feature levels for RHEL 10 systems Link kopierenLink in die Zwischenablage kopiert!
If you have a RHEL 10 system, you can use remote host configuration (rhc) to set feature levels when registering with the Red Hat Hybrid Cloud Console.
By default, rhc connects your systems with the remote management feature level. This feature level includes access to RHEL content, analytics for Red Hat Lightspeed, and remote management (remediations and tasks services). If you want to opt out of any of these features, you can disable them when you register your systems.
Customizing feature levels functionality is only available with Red Hat Enterprise Linux version 10.
See the following table for more details about feature levels:
| Feature Level | Feature Level Name in the Command Line Interface | Description |
|---|---|---|
| Access to Red Hat content | Content | This feature level provides access to content in the Red Hat Content Delivery Network (CDN). With this feature level enabled, you can install and update packages. |
| Analytics for Red Hat Lightspeed | Analytics | This feature level collects data from your system using the insights-client and sends it to the Red Hat Hybrid Cloud Console. Then, Red Hat Lightspeed analyzes your data and returns recommendations. You must have the content feature enabled to use the analytics feature. |
| Remote Management (Default) | remote-management | With this feature level enabled, you can use the remediations and tasks services. You must have the content and analytics features enabled to use the remote management feature. |
2.3. Register RHEL 9 systems Link kopierenLink in die Zwischenablage kopiert!
If you have a Red Hat Enterprise Linux version 9 system, you can use remote host configuration (rhc) to register your system:
Prerequisites
- You are logged in to the system as root or have sudo permissions.
- You have an activation key and an organization ID to register your system.
- You have completed the steps to Manage system connectivity and networking.
- (Optional) You have completed steps to Minimize data collection and controlling data privacy.
Procedure
Open your command-line interface (CLI), and run the following commands on your client system:
rhc connect --activation-key=<activation_key_name> --organization=<organization_ID>
# rhc connect --activation-key=<activation_key_name> --organization=<organization_ID>Copy to Clipboard Copied! Toggle word wrap Toggle overflow dnf install -y rhc-worker-playbook
# dnf install -y rhc-worker-playbookCopy to Clipboard Copied! Toggle word wrap Toggle overflow
Verification
Enter the following command in your CLI:
rhc status
# rhc status
If the procedure is successful, you will see the following output:
Connection status: ✓ Connected to Red Hat Lightspeed ✓ Connected to Red Hat Subscription Manager ✓ The remote host configuration daemon is active
Connection status: ✓ Connected to Red Hat Lightspeed ✓ Connected to Red Hat Subscription Manager ✓ The remote host configuration daemon is activeCopy to Clipboard Copied! Toggle word wrap Toggle overflow
2.4. Register RHEL 8 systems Link kopierenLink in die Zwischenablage kopiert!
If you have a Red Hat Enterprise Linux 8 system, you can use remote host configuration (rhc) to register your system.
Prerequisites
- RHEL version is 8.6 or later.
- You are logged in to the system as root or have sudo permissions.
- You have an activation key and an organization ID to register your system.
- You have completed the steps to Manage system connectivity and networking.
- (Optional) You have completed steps to Minimize data collection and control data privacy.
Procedure
Open your command-line interface (CLI), and run the following commands on your client system:
rhc connect --activation-key=<activation_key_name> --organization=<organization_ID>
# rhc connect --activation-key=<activation_key_name> --organization=<organization_ID>Copy to Clipboard Copied! Toggle word wrap Toggle overflow dnf install -y rhc-worker-playbook
# dnf install -y rhc-worker-playbookCopy to Clipboard Copied! Toggle word wrap Toggle overflow Run the following command:
rhc status
# rhc statusCopy to Clipboard Copied! Toggle word wrap Toggle overflow If the registration is successful, you will see the following output:
Connection status: ✓ Connected to Red Hat Subscription Manager ✓ Connected to Red Hat Lightspeed ✓ The remote host configuration daemon is active
Connection status: ✓ Connected to Red Hat Subscription Manager ✓ Connected to Red Hat Lightspeed ✓ The remote host configuration daemon is activeCopy to Clipboard Copied! Toggle word wrap Toggle overflow
Additional Resources
2.5. Handle legacy and conversion registrations Link kopierenLink in die Zwischenablage kopiert!
Register and connect RHEL 8.7 and earlier systems, or convert specialized systems like CentOS 7 to RHEL, by using legacy clients (subscription-manager, insights-client). You can still ensure all your non-standard hosts are reporting to Red Hat Services without using the rhc client.
2.5.1. Considerations for using the legacy client for registration Link kopierenLink in die Zwischenablage kopiert!
The main reason to use the legacy client to register a RHEL system to Red Hat Services is to have more control over the features and the data collected from the system. With RHEL 10.0, the rhc client has a concept of “feature level” that allows it to control the level of information collected from the system. However, for RHEL 8.0 and RHEL 9.0, achieving a registration by using the rhc client enables all the features with no command-line options needed to make adjustments. Using only the subscription-manager or a combination of subscription-manager and insights-client remains a supported route.
2.5.2. Register your legacy RHEL systems using subscription-manager and insights-client Link kopierenLink in die Zwischenablage kopiert!
To register a system running a version of RHEL 8.7 or earlier, or to manually control feature levels by using Red Hat Lightspeed, use the following two-step process:
- Register to Red Hat Subscription Manager (RHSM) with the subscription-manager client.
- Register the system with insights-client.
Prerequisites
- You have access to the system as root or have sudo permissions.
- You have an activation key and an organization ID to register your system.
- You have completed the steps to Manage system connectivity and networking.
- (Optional) You have completed steps to Minimize data collection and control data privacy.
Procedure
To register a system running Red Hat Enterprise Linux version 7 or 8, use an activation key and your Organization ID to register with RHSM.
subscription-manager register --activationkey=_activation_key_name_ --org=_organization_ID_
# subscription-manager register --activationkey=_activation_key_name_ --org=_organization_ID_Copy to Clipboard Copied! Toggle word wrap Toggle overflow Enter the
insights-clientcommand to complete registration for the Red Hat Lightspeed service.insights-client --register
# insights-client --registerCopy to Clipboard Copied! Toggle word wrap Toggle overflow
2.5.3. Register and convert a CentOS Linux 7 system to a RHEL 7 system Link kopierenLink in die Zwischenablage kopiert!
To convert a CentOS Linux 7 system to a RHEL, first register it with Red Hat to connect to Red Hat Lightspeed. After completing backups and other prerequisites, perform a pre-conversion analysis to identify risks for the conversion. You can then use the Red Hat Lightspeed conversion task for converting the system to a fully-supported RHEL 7 environment.
2.6. System remediation and automation with Red Hat Lightspeed Link kopierenLink in die Zwischenablage kopiert!
To prepare your RHEL system to automatically run tasks and remediation plans, you must use both the rhc client and the insights-client. Together, these tools allow Red Hat Lightspeed to automatically generate and execute Ansible Playbooks to address identified issues. To enable your system with automated remediation, install and activate core components, complete system registration and enable remote management with the yggdrasil daemon. Your systems can directly use tasks and remediation playbooks from the Red Hat Lightspeed Automation Toolkit after registration.