Dieser Inhalt ist in der von Ihnen ausgewählten Sprache nicht verfügbar.
Chapter 1. Client tools and components
Red Hat Enterprise Linux (RHEL) client tools are a collection of utilities that you can use to connect, register, and manage RHEL systems. These tools, such as the insights-client, subscription-manager, and the remote host configuration client (rhc), facilitate system registration, entitlement management, and proactive remediation. By integrating RHEL and the correct User Access permissions for your needs with Red Hat Lightspeed and other Red Hat services, these clients streamline the deployment, troubleshooting, and optimization of your hybrid cloud environment.
1.1. Understanding the client tools and components Link kopierenLink in die Zwischenablage kopiert!
Before you register or manage your system, you should understand the client tools that are available. Red Hat Enterprise Linux (RHEL) includes several client tools:
- The rhc client
- The subscription-manager
- The insights-client
Learning the purpose of each tool helps you understand how they integrate to connect your RHEL system to Red Hat services. After learning about the clients and their components, make sure that you have the correct Hybrid Cloud Console User Access roles and permissions required for a successful connection. After you complete the steps, you can register your systems.
1.1.1. The rhc client Link kopierenLink in die Zwischenablage kopiert!
The rhc client is the recommended tool to register and manage your RHEL systems that are connected to the Red Hat Hybrid Cloud Console. Use the rhc client to register and connect systems directly to Red Hat services.
To register and connect systems with Red Hat Satellite or Capsule, see Red Hat Satellite product documentation.
The rhc client works in conjunction with insights-client and subscription-manager to offer a unified client experience including the registration of the system to Red Hat, and the configuration of feature levels and the remote management capabilities.
The remote host configuration service includes the following two main components:
- The rhc client remote host configuration client (a client-side daemon)
- The remote host configuration manager (a server-side service)
The remote host configuration (rhc) client enables the following capabilities:
- Easy registration. With the rhc client, you can register systems to Red Hat Subscription Management (RHSM) and Red Hat Lightspeed.
- Remediations and Tasks from Red Hat Lightspeed. When you connect systems to Red Hat Lightspeed with the rhc client, you can manage the end-to-end experience of finding and fixing issues. Registered systems can directly use tasks and remediation playbooks that are automatically generated from remediation plans and executed from within the Red Hat Lightspeed Automation Toolkit.
RHC client components and support. The rhc client is preinstalled and fully supported with all Red Hat Enterprise Linux (RHEL) 8.6 and later installations, with the exception of minimal installations. The rhc client consists of the following utility programs:
-
The
yggdrasil(rhcdon version RHEL 9 and earlier) daemon runs on the system and listens for messages from the Hybrid Cloud Console. On properly configured systems, theyggdrasildaemon can receive and execute playbooks that are generated by Red Hat Lightspeed remediation plans. -
The
rhccommand-line utility for RHEL.
Remote remediation using the remote host configuration manager. To enable or disable Red Hat Lightspeed remediation capabiliities for systems that connect using the rhc client and that are also running the yggdrasil daemon, use the remote host configuration manager.
You can access the remote host configuration manager, by logging in to the Red Hat Hybrid Cloud Console as a user with RHC user privileges. To make changes to settings in the remote host configuration manager, located at Red Hat Hybrid Cloud Console > Red Hat Lightspeed > Inventory > System Configuration > Remote Host Configuration (RHC), you need RHC administrator privileges.
1.1.2. The subscription-manager client Link kopierenLink in die Zwischenablage kopiert!
As an option, you can use the subscription-manager client to directly register your RHEL systems, but the available RHSM features will be limited with Red Hat Lightspeed. Registering with only the subscription-manager client will establish your system’s identity and provide access to the Red Hat Content Delivery Network (CDN) for updates and packages. For additional features provided by Red Hat Lightspeed, consider using the rhc client.
1.1.3. The insights-client Link kopierenLink in die Zwischenablage kopiert!
The insights-client is mainly responsible for collecting data for analytics provided by Red Hat Lightspeed. The insights-client relies on the subscription-manager client to establish the identity of the system.
The insights-client is available for the following releases of Red Hat Enterprise Linux (RHEL).
| RHEL release | Comments |
|---|---|
| RHEL 10 | Distributed with insights-client pre-installed. |
| RHEL 9 | Distributed with insights-client pre-installed. |
| RHEL 8 | Distributed with insights-client pre-installed, unless RHEL 8 was installed as a minimal installation. |
| RHEL 7 | Distributed with the insights-client RPM package loaded but not installed. |
Additional resources
1.2. User Access settings in the Red Hat Hybrid Cloud Console Link kopierenLink in die Zwischenablage kopiert!
User Access is the Red Hat implementation of role-based access control (RBAC). Your Organization Administrator uses User Access to configure what users can see and do on the Red Hat Hybrid Cloud Console (the console):
- Control user access by organizing roles instead of assigning permissions individually to users.
- Create groups that include roles and their corresponding permissions.
- Assign users to these groups, allowing them to inherit the permissions associated with their group’s roles.
1.2.1. Predefined User Access groups and roles Link kopierenLink in die Zwischenablage kopiert!
To make groups and roles easier to manage, Red Hat provides two predefined groups and a set of predefined roles:
Predefined groups
The Default access group contains all users in your organization. Many predefined roles are assigned to this group. It is automatically updated by Red Hat.
NoteIf the Organization Administrator makes changes to the Default access group its name changes to Custom default access group and it is no longer updated by Red Hat.
The Default admin access group contains only users who have Organization Administrator permissions. This group is automatically maintained and users and roles in this group cannot be changed.
On the Hybrid Cloud Console navigate to Red Hat Hybrid Cloud Console > the Settings icon (⚙) > Identity & Access Management > User Access > Groups to see the current groups in your account. This view is limited to the Organization Administrator.
Predefined roles assigned to groups
The Default access group contains many of the predefined roles. Because all users in your organization are members of the Default access group, they inherit all permissions assigned to that group.
The Default admin access group includes many (but not all) predefined roles that provide update and delete permissions. The roles in this group usually include administrator in their name.
On the Hybrid Cloud Console navigate to Red Hat Hybrid Cloud Console > the Settings icon (⚙) > Identity & Access Management > User Access > Roles to see the current roles in your account. You can see how many groups each role is assigned to. This view is limited to the Organization Administrator.
1.2.2. Access permissions Link kopierenLink in die Zwischenablage kopiert!
The Prerequisites for each procedure list which predefined role provides the permissions you must have. As a user, you can navigate to Red Hat Hybrid Cloud Console > the Settings icon (⚙) > My User Access to view the roles and application permissions currently inherited by you.
If you cannot access Red Hat Lightspeed because of permissions issues, contact your Organization Administrator or the User Access administrator for your organization.
Use the Red Hat Hybrid Cloud Console Virtual Assistant to ask "Contact my Organization Administrator". The assistant sends an email to the Organization Administrator on your behalf.
Additional resources
For more information about user access and permissions, see User Access configuration guide for role-based access control (RBAC).
1.2.3. User Access roles for remote host configuration manager Link kopierenLink in die Zwischenablage kopiert!
There are several User Access roles that are relevant for Red Hat Lightspeed users. These roles determine if a Red Hat Lightspeed user can simply view settings or change them, and use remediation features.
User Access roles for using the remote host configuration manager in the Red Hat Hybrid Cloud Console
- RHC administrator. Members in a group with this role can perform any operations in the remote host configuration manager.
- RHC user. A default permission for all users on your organization’s Red Hat Hybrid Cloud Console account that allows anyone to see the current status of the configuration.
User Access roles for using remediations features in the Red Hat Hybrid Cloud Console.
- Remediations administrator. Members in a group with this role can perform any available operation against any remediations resource, including direct remediations.
- Remediations user. Members in a group with this role can create, view, update, and delete operations against any remediations resource. This is a default permission given to all Hybrid Cloud Console users on your account.
1.3. Install the insights-client Link kopierenLink in die Zwischenablage kopiert!
The insights-client is automatically installed when you install a new RHEL system with the default settings. Certain types of RHEL deployments, such as minimal installation or RHEL instances deployed from pre-built images provided by the Red Hat Certified Cloud and Service Providers (CCSP), might not install the insights-client. Installation steps vary slightly depending on your RHEL version and installation type, either standard or minimal.
After you install the insights-client, register your system. Registering your system might require activation keys. For more information about registering systems and activation keys, see: Getting started with activation keys on the Hybrid Cloud Console.
1.3.1. Install the insights-client on an existing system managed by Red Hat Cloud Access Link kopierenLink in die Zwischenablage kopiert!
You can install insights-client on an existing Red Hat Enterprise Linux (RHEL) system connected to Red Hat Cloud Access to get automated system health checks and other services to find and fix problems before they cause problems with systems in your organization.
Additional resources
1.3.2. Install insights-client on an existing system managed by Red Hat Update Infrastructure Link kopierenLink in die Zwischenablage kopiert!
You can install the insights-client on an existing, cloud marketplace-purchased Red Hat Enterprise Linux system that is managed by Red Hat Update Infrastructure (RHUI) to get automated system health checks and other services to find and fix issues before they cause problems with systems in your organization.
Prerequisites
- Root-level access for the system.
Procedure
Enter the following command to install the current version of the insights-client package:
RHEL versions 6 and 7
yum install insights-client
[root@server ~]# yum install insights-clientCopy to Clipboard Copied! Toggle word wrap Toggle overflow RHEL version 8 and later
dnf install insights-client
[root@server ~]# dnf install insights-clientCopy to Clipboard Copied! Toggle word wrap Toggle overflow Verification step
Run the following command to confirm successful installation of the insights-client:
insights-client --version
[root@server ~]# insights-client --versionCopy to Clipboard Copied! Toggle word wrap Toggle overflow
1.4. Client command-line interface and configuration interaction Link kopierenLink in die Zwischenablage kopiert!
The insights-client runs automatically based on its scheduler settings. By default, it runs every 24 hours. To run the client interactively, enter the insights-client command.
When you run insights-client, the following values and settings determine the results:
-
Values that you enter when you run
insights-clientfrom the command line temporarily override the preset configuration file settings and system environment settings. Any values that you enter for options in theinsights-clientcommand are used only for that instance of insights-client. -
Settings in the configuration file (
/etc/insights-client/insights-client.conf) override system environment settings. -
Values of any system environment variables (
printenv) are not affected by the commands entered on the command line or the client configuration files.