Red Hat Summit Red Hat SummitSupportConsoleDevelopersStart a trialContact

Chapter 2. Enabling host communication with Red Hat Lightspeed

Before you can execute the playbooks in your remediation plans on remote systems from Red Hat Lightspeed, your systems have to be able to communicate with Red Hat Lightspeed.

  • For Red Hat Enterprise Linux systems that are not managed by Red Hat Satellite, you should follow the procedure below to enable the rhc client on those systems.
  • For systems that are managed by Satellite, you will configure Cloud Connector on the host servers for those systems.

To be able to execute Ansible Playbooks from Red Hat Lightspeed, the rhc client must be enabled on the systems in your infrastructure. The rhc connect command does this by registering (RHEL8.6 and later, and 9.0 and later) systems with Red Hat Subscription Manager and Red Hat Lightspeed, and enabling remote host configuration (rhc) features in Red Hat Lightspeed.

Prerequisites

  • Sudo access on the Red Hat Enterprise Linux host system

Connect rhc on RHEL 8.5 systems

Remote host configuration on RHEL 8.5 has dependencies on ansible and rhc-worker-playbook. To install the dependencies, you must first register with Subscription Manager.

  • Use the following commands to enable rhc on RHEL 8.5 systems. 

    [root]# subscription-manager repos --enable ansible-2.9-for-rhel-8-x86_64-rpms
[root]# dnf -y install ansible rhc-worker-playbook-0.1.5-3.el8_4
[root]# rhc connect
    Copy to Clipboard Toggle word wrap

Connect rhc on RHEL8.6 and later systems

  • Use the following commands to enable rhc on RHEL8.6 and later systems. 

    [root]# dnf -y update rhc
[root]# dnf -y install rhc-worker-playbook
[root]# rhc connect
    Copy to Clipboard Toggle word wrap

Connect rhc on RHEL9.0 and later systems

  • Use the following commands to enable rhc on RHEL9.0 and later systems. 

    [root]# dnf -y install rhc rhc-worker-playbook
[root]# rhc connect
    Copy to Clipboard Toggle word wrap

More information

To allow users to execute a remediation plan on a remote system from Red Hat Lightspeed, you must configure the Remote Host Configuration Manager settings in the Red Hat Lightspeed UI.

Prerequisites

  • You have the RHC Administrator and Inventory Hosts Administrator roles. If not, contact your Organization Administrator to obtain these permissions.

Procedure

  1. Navigate to Remote Host Configuration Manager.
  2. Under Permission, set the option Allow permitted Red Hat Lightspeed users to execute remediation playbooks on rhc-connected systems to Enabled.
  3. Click Save changes.

Results

A confirmation box with the message Changes saved displays at the top right corner of the UI.

After setting up the Remote Host Configuration client (rhc connect) and enabling host communication, from the Red Hat Lightspeed UI, verify that the host system is connected.

Prerequisites

  • You are logged in to the Red Hat Hybrid Cloud Console.

  • You have the RHC Administrator and Inventory Hosts Administrator roles. If not, contact your Organization Administrator to obtain these permissions.

    Note

    To execute a remediation plan on remote hosts from Red Hat Lightspeed, you also need the Remediations administrator role.

Procedure

  1. Navigate to Automation Toolkit > Remediation Plans.
  2. On the Remediation Plans page, choose a remediation plan that includes the system you are interested in checking. The General tab opens.
  3. Open the Systems tab, and locate the system in the table.
  4. Check the Connection Status value for the system.
Note

If the Connection Status value is Unknown, this means you do not have the correct User Access permissions to view the status, as outlined in the prerequisites.

You can remediate issues on Satellite-managed content hosts remotely from the Red Hat Lightspeed UI in the Red Hat Hybrid Cloud Console. Remote remediation from Red Hat Lightspeed requires that you first configure the Cloud Connector plugin on the Satellite Server.

Important

If you want to manage and execute host remediations entirely from the Satellite web console, you do not need to enable the Cloud Connector plugin.

The following prerequisites are comprehensive for Satellite Server configuration:

Prerequisites

  • Satellite must be version 6.9 or later.
  • You have root access to the Satellite server.
  • The content hosts that are managed by the satellite should have the Red Hat Lightspeed client installed and turned on. See the reference section of this documentation for Red Hat Lightspeed client installation and enablement procedures.
  • Import a Subscription Manifest into Satellite. For more information, see Importing a Subscription Manifest into Satellite Server in the Red Hat Satellite Content Management Guide.
  • Register your hosts to Satellite using an activation key to attach Red Hat subscriptions. For more information, see Registering Hosts in the Red Hat Satellite Managing Hosts guide.

Before you can run the playbooks in your remediation plans remotely from within Red Hat Lightspeed, you must install and configure the Cloud Connector plugin on the Satellite Server.

Complete the following tasks to install, configure, and verify the configuration of Cloud Connector.

Prerequisites

  • You are logged in to the Red Hat Hybrid Cloud Console.

  • You have the RHC Administrator and Inventory Hosts Administrator roles. If not, contact your Organization Administrator to obtain these permissions.

    Note

    To execute a remediation plan on remote hosts from Red Hat Lightspeed, you also need the Remediations administrator role.

Procedure

  1. On Satellite Server, enable the remote-execution plugin by entering one of the following commands, based on your version of Satellite Server.

    1. On Satellite Server 6.12 and later. 

      [root]# satellite-installer --foreman-proxy-plugin-remote-execution-script-install-key true
      Copy to Clipboard Toggle word wrap

    2. *On Satellite Server 6.9 - 6.11 

      [root]# satellite-installer --foreman-proxy-plugin-remote-execution-ssh-install-key true
      Copy to Clipboard Toggle word wrap
      Note

      Configuring Cloud Connector requires that the satellite perform a remote execution on itself. This is why the first step is to enable the remote-execution script or plugin.

  2. In the Satellite Server web UI, navigate to Configure > Red Hat Cloud > Inventory Upload. Verify that the Automatic Inventory Upload switch is turned ON, which is the default setting.

  3. Optionally: Toggle the Obfuscate host names switch to the ON position to hide hostnames that Satellite Server reports to the Hybrid Cloud Console.

    Note

    The Obfuscate host names setting only affects rh_cloud reports. If you want to obfuscate hostnames, IP addresses, or Media Access Control (MAC) addresses, configure obfuscation in the Red Hat Lightspeed client configuration. Satellite Server observes the Red Hat Lightspeed obfuscation configuration settings. For more information, see the following resources:

    • Obfuscating hostnames
    • Obfuscating IP addresses.
    • Obfuscating MAC addresses.

    Automatic inventory upload and Obfuscate host names are global settings. They affect content hosts that belong to all organizations.

  4. Click Configure Cloud Connector. A Notice dialog box warns you that this action also enables auto reports upload.
  5. Click Confirm, and then wait for the task to finish. This should take about one minute.

  6. Go to Monitor > Jobs > Configure Cloud Connector to see the job.

  7. Click Generate and upload report to generate a data payload from each of the content hosts that have Red Hat Lightspeed client running, and upload your host inventory to Red Hat Lightspeed.
  8. Repeat the previous step for each organization for which you want to upload a content host inventory.
  9. Under Configure > Red Hat Cloud (after Sat 6.11) > Red Hat Lightspeed, set Auto sync for the organization by using the toggle in the upper right corner of the screen.

Verification steps

To verify that the upload was successful, log in to Red Hat Hybrid Cloud Console > Red Hat Enterprise Linux > Red Hat Lightspeed > Inventory and search for the satellite_id tag for your content hosts.

Optional: Click Sync all inventory status and wait for the task to finish. It will show you the number of content hosts recognized by Red Hat Lightspeed inventory.

Back to top
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2025 Red Hat