Red Hat Summit Red Hat SummitApoyoConsolaDesarrolladoresIniciar una pruebaContacto

Este contenido no está disponible en el idioma seleccionado.

Chapter 4. Configuring insights-client

After you install Red Hat Lightspeed client, you must register your system with Red Hat Lightspeed. Registration enables you to use Red Hat Lightspeed services.

4.1. Registering your system with Red Hat Lightspeed
Copiar enlace

You can use the insights-client command to register a system with Red Hat Lightspeed.

You can assign a different display name for your host when you register your system by appending the --display-name option to the command. The display name identifies the system in the Red Hat Lightspeed UI. If you do not assign a display name when you register the system, Red Hat Lightspeed uses the default hostname for the system.

Prerequisites

You have completed the following steps on your system:

  • Logged in with root-level permissions
  • Installed the Red Hat Lightspeed client

Procedure

  1. Run the following subscription-manager commands in the CLI: 

    [root@rhlightspeed]# subscription-manager register
[root@rhlightspeed]# subscription-manager status
    Copy to Clipboard Toggle word wrap

  2. Run the following insights-client registration commands as follows: 

    [root@rhlightspeed]# insights-client --register
[root@rhlightspeed]# insights-client --status
    Copy to Clipboard Toggle word wrap

Examples

  • The following example shows how you can register a system with a display name that is different from the hostname: 

    [root@rhlightspeed01]# insights-client --register --display-name ITC-4
    Copy to Clipboard Toggle word wrap

    • Resulting output: 

      Successfully registered host rhlightspeed01-rhel9 as ITC-4 in group None
Automatic scheduling for Red Hat Lightspeed has been enabled.
Starting to collect Red Hat Lightspeed data for ITC-4
Writing RHSM facts to /etc/rhsm/facts/insights-client.facts ...
Uploading Red Hat Lightspeed data.
Successfully uploaded report from ITC-4 to account 1234567.
View the Red Hat Lightspeed console at https://console.redhat.com/insights/
      Copy to Clipboard Toggle word wrap

  • The following example shows how you can change the display name of a system that is already registered for Red Hat Lightspeed. 

    [root@rhlightspeed01]# insights-client --display-name ITC-5
    Copy to Clipboard Toggle word wrap

    • Resulting output: 

      System display name changed from ITC-4 to ITC-5
      Copy to Clipboard Toggle word wrap

For more information about the insights-client command options, see the Additional resources section.

Result

You can now access the cloud-based Red Hat Lightspeed services.

Important
  • It can take up to 15 minutes for your newly registered system to be listed on the Red Hat Lightspeed inventory page on the console.
  • Red Hat Satellite users: After registering a Satellite system with Red Hat Lightspeed, if you subsequently upgrade or rebuild your Satellite system by doing a fresh install, you must re-register the system in Red Hat Lightspeed. For more information about how to do that, see Re-registering your system with Red Hat Lightspeed.

Additional resources

This issue affects Red Hat Satellite users. If you are a Satellite user registering a host with Red Hat Lightspeed, after you run insights-client --register, the following output might display on the CLI:

Telemetry is not enabled for this host

This error can occur because the host_registration_insights parameter is set to false during host registration. It must be set to true for Satellite to accept the Red Hat Lightspeed client upload. To resolve this error message, you must do the following:

  • Change the host_registration_insights parameter to true
  • Run the insights-client --register command in the command line again after the parameter has been updated.

Additional resources

For detailed information about this issue and its resolution, see the following:

You can register a CentOS Linux 7 system to a RHEL 7 system, in order to convert to RHEL and leverage Red Hat Lightspeed. Before you begin the conversion process, it is recommended that you back up your system, satisfy prerequisites, and perform a pre-conversion analysis. Once that is complete, see the following for instructions on registering and converting:

Note

Conversions from CentOS Linux 8 and other Linux distributions must be performed in the command line interface or in Satellite.

Additional Resources

4.3. Unregistering your system with Red Hat Lightspeed
Copiar enlace

You can unregister your system with Red Hat Lightspeed. When you do so, your system information is no longer uploaded to Red Hat Lightspeed.

Prerequisites

  • Root-level access to your system.
  • Your system is registered with Red Hat Lightspeed.

Procedure

  1. Enter the insights-client command with the --unregister option. 

    [root@rhlightspeed]# insights-client --unregister
    Copy to Clipboard Toggle word wrap

Verification

Enter the following command to confirm the status and verify that the system has been successfully unregistered:

+ 

[root@rhlightspeed]# insights-client --status
Copy to Clipboard Toggle word wrap

If the command is successful, you will see the following output: 

This host is unregistered.
Copy to Clipboard Toggle word wrap

4.4. Re-registering your system with Red Hat Lightspeed
Copiar enlace

There are instances when you might need to re-register a system in Red Hat Lightspeed.

Re-registering a system in Red Hat Lightspeed by using the correct steps can help to prevent and fix duplicate host entries in the Red Hat Lightspeed inventory service. For example, one reason you might re-register a system in Red Hat Lightspeed is to clean up entries for a previously registered system that has been rebuilt with a clean install.

Important

If you are a Red Hat Satellite user and you plan to upgrade or rebuild your Satellite system by doing a fresh install, you must re-register that system in Red Hat Lightspeed. Ensure that you unregister the system in Red Hat Lightspeed before you begin the upgrade. After you have reinstalled the Satellite system, register it again with the Red Hat Lightspeed client. Otherwise, you might see duplicate host entries or other unexpected results.

To re-register a system in Red Hat Lightspeed, run the insights-client command twice by using the following two options:

  1. --unregister
  2. --register

Prerequisites

You have completed the following steps on your system:

  • Logged in with root-level permissions
  • Installed the Red Hat Lightspeed client

Procedure

  1. On the command line, enter the insights-client command with the --unregister option. 

    [root@rhlightspeed]# insights-client --unregister
    Copy to Clipboard Toggle word wrap

  2. Enter the insights-client command with the --register option. 

    [root@rhlightspeed]# insights-client --register
    Copy to Clipboard Toggle word wrap

Verification

When a system has been successfully re-registered by using the insights-client command with the —-unregister option followed by the insights-client command with the —-register option, a new Red Hat Lightspeed profile gets created and the following output is displayed: 

[root@rhlightspeed]# Successfully uploaded report for <machine name>
View the Red Hat Lightspeed console at https://console.openshiftusgov.com/insights/
Copy to Clipboard Toggle word wrap

4.5. Changing the host display name
Copiar enlace

You can change the host display name as it appears in the GUI. Make this change either when you register the system with Red Hat Lightspeed, or after registration. If you do not assign a display name when you register the system, Red Hat Lightspeed uses the value in /etc/hostname.

This procedure is optional. Determine if you want to use a display name in addition to the default hostname.

Note

Using the insights-client command to set the display name takes effect immediately, but does not run the Red Hat Lightspeed client.

Note

If you obfuscate the hostname, the hostname configured in /etc/hostname is obfuscated. Assign a display name so that you can identify a host even when its hostname is obfuscated.

Prerequisites

  • Root-level access to the system.

Procedure

  • Enter the insights-client command with the --display-name option and specify a display name. 

    [root@rhlightspeed]# insights-client --display-name ITC-4
System display name changed from None to ITC-4
    Copy to Clipboard Toggle word wrap

  • To create a display name that contains spaces, use double quotes. 

    [root@rhlightspeed]# insights-client --display-name "ITC-4 B9 4th floor"
System display name changed from None to ITC-4 B9 4th floor
    Copy to Clipboard Toggle word wrap

4.6. Displaying the client version
Copiar enlace

You can display the Red Hat Lightspeed client version and client core version.

Prerequisites

  • Root-level access to your system.

Procedure

  • Enter the insights-client command with the --version option. 

    [root@rhlightspeed]# insights-client --version
Client: 3.0.6-0
Core: 3.0.121-1
    Copy to Clipboard Toggle word wrap

Additional resources

Volver arriba
Red Hat logoGithubredditYoutubeTwitter

Aprender

Pruebe, compre y venda

Comunidades

Acerca de la documentación de Red Hat

Ayudamos a los usuarios de Red Hat a innovar y alcanzar sus objetivos con nuestros productos y servicios con contenido en el que pueden confiar. Explore nuestras recientes actualizaciones.

Hacer que el código abierto sea más inclusivo

Red Hat se compromete a reemplazar el lenguaje problemático en nuestro código, documentación y propiedades web. Para más detalles, consulte el Blog de Red Hat.

Acerca de Red Hat

Ofrecemos soluciones reforzadas que facilitan a las empresas trabajar en plataformas y entornos, desde el centro de datos central hasta el perímetro de la red.

Theme

© 2025 Red Hat