Red Hat Summit Red Hat SummitSupportConsoleDevelopersStart a trialContact

Chapter 2. Installing Red Hat Lightspeed

This document provides starting points and resources for registering systems to Red Hat Lightspeed.

Installation of Red Hat Lightspeed typically involves installing the Red Hat Lightspeed client, then registering systems for use with Red Hat Lightspeed. You can use different methods to register and install Red Hat Lightspeed. A registration assistant is also available to guide you through the process of registering and installing Red Hat Lightspeed. You can also use the Remote Host Configuration (RHC) tool. The installation method you use can depend on conditions such as,

  • Whether you are connecting to Red Hat for the first time
  • Whether you use a certain version of RHEL
  • Whether you want to do an automated installation or manual install
  • Other factors

To install Red Hat Lightspeed on Red Hat Enterprise Linux hosts managed by Red Hat Satellite, see:

Before you can use Red Hat Lightspeed with your server, you need to connect your servers to the Satellite Server. The Satellite Server enables your servers to communicate with Red Hat Lightspeed.

An IP address-based allow list restricts network access to the Red Hat Lightspeed service. This ensures that only the servers and ports that you specify can connect to the Satellite Server.

Note

Red Hat Lightspeed subscription services are currently not available in the FedRAMP environment. Red Hat continuously evaluates service offerings, and will announce any updates or expansions to the FedRAMP environment as they become available.

Note

The following requirements are in addition to existing Satellite Server connectivity requirements to the Red Hat Content Delivery Network and Red Hat Subscription Management (RHSM) for software updates. For more information about connectivity requirements, refer to How to access Red Hat Subscription Manager (RHSM) through a firewall or proxy.

Prerequisites

  • The Satellite Server must be able to connect to the domain mtls.console.stage.openshiftusgov.com, using the HTTPS protocol on port 443.

  • You must provide a static public egress IP address (or address range) from which Satellite traffic will originate.

    Note

    Contact Red Hat Support to set up the public egress IP address.

    The public egress IP address is an additional IP address on the primary network interface of your server.

  • You are logged in to the Hybrid Cloud Console (https://console.openshiftusgov.com) as an Organization Administrator.
  • You have administrator ssh access to the Satellite server.
  • You are logged in to the Satellite Server using ssh.

Procedure

  1. From the main menu, navigate to Inventory > Configure Satellites. The Configure Satellites page displays.
  2. Click Generate Token to create the registration token for your organization.
  3. Copy the token.

  4. Open a terminal window on your Satellite Server and enter the following command: 

    # hammer organization list
    Copy to Clipboard Toggle word wrap

    The system returns your organization ID. Make note of it for the next step.

  5. Copy the command shown in Step 3 on the Configure Satellites page. Paste it into the terminal. Substitute the organization ID for <organization_id>. 

    # SATELLITE_RH_CLOUD_URL=https://mtls.console.openshiftusgov.com org_id=<organization_id> foreman-rake rh_cloud:hybridcloud_register
    Copy to Clipboard Toggle word wrap

    The system returns a prompt for the token that you generated.

  6. Paste the generated token that you copied at the prompt and press Enter.

    The system returns a success message. You can now register the system with Satellite and run insights-client.

Additional resources

Before you can connect Red Hat Lightspeed to your Satellite servers, you need to configure an allowlist that contains a trusted IP address (or range of IP addresses). You can configure the allowlist in two ways:

  • Provide the trusted IP address (or addresses) to Red Hat stateside support during onboarding. Support uses the IP addresses to configure an allowlist for Red Hat Lightspeed. This allowlist allows network traffic from your Satellite-controlled environment into Red Hat Lightspeed. To configure the allowlist, contact stateside support through ServiceNow and mention that you want to connect your satellite servers to Red Hat Lightspeed.
  • If you have not created the allowlist during onboarding, use the IP allowlist in the Manage Satellites page in the Red Hat Hybrid Cloud Console to manually add trusted IP addresses.

2.3.1. Adding trusted IP addresses to an allowlist
Copy link

You can use Manage Satellites to create an allowlist, or add an IP address (or a range of IP addresses) to an existing allowlist. Adding IP addresses enables additional FedRAMP users in your organization to access the Red Hat Hybrid Cloud Console.

Note

Manage Satellites allows only IPv4 addresses. It does not support IPv6 addresses.

To add a range of IP addresses, use CIDR notation (for example, 226.167.71.76/32).

Prerequisites

  • You have Organization Administrator permissions.
  • You are logged in to the Hybrid Cloud Console.

Procedure

  1. Click Manage Satellites. The Manage Satellites page displays.

  2. Scroll down the page to the IP Address Allowlist section at the bottom.

    IP Address Allowlist on Managed Satellites page
    View larger image
    IP Address Allowlist on Managed Satellites page

  3. Click Add IP Addresses. The Add IP Addresses to Allowlist dialog box displays.

    Add IP Addresses to Allowlist dialog box
    View larger image
    Add IP Addresses to Allowlist dialog box

  4. Type an IP address (or range of IP addresses) and click Submit. The IP addresses appear on the allowlist.

    IP address range shown in allowlist
    View larger image
    IP address range shown in allowlist

2.3.2. Removing IP addresses from the allowlist
Copy link

Prerequisites

  • You have Organization Administrator permissions.
  • You are logged in to the Hybrid Cloud Console.
  • You have an IP allowlist configured.
  • You have added at least one IP address (or range of IP addresses) to the allowlist.

Procedure

  1. Click Manage Satellites. The Manage Satellites page displays.
  2. Scroll down the page to the IP Address Allowlist section at the bottom.

  3. Select the IP address you want to remove, and then click Remove. The Remove IP Addresses from Allowlist dialog box displays.

    Remove IP Addresses dialog box
    View larger image
    Remove IP Addresses dialog box
  4. Click Remove, and then click Submit.

Additional resources

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