Menu Close
Settings Close

Language and Page Formatting Options

Chapter 3. Configuring Insights client

The procedures in this section show you how to configure the Insights client on your system.

Prerequisites

  • You have root permissions or their equivalent. Making changes to configuration files or adding configuration files requires root permissions.
  • The Insights client is deployed on your system.

3.1. Registering your system with Red Hat Insights for Red Hat Enterprise Linux

You must register your system with Red Hat Insights for Red Hat Enterprise Linux before you can use its services. Optionally, you can assign a display name for your host when you register your system.

Note

If you do not assign a display name when you register the system, Red Hat Insights for Red Hat Enterprise Linux uses the value in /etc/hostname.

Note

Insights client installation on older versions

RHEL versions 6 and 7 do not come with the Insights client pre-installed. If you have one of these versions, run the following commands in your terminal:

[root@server ~]# yum install insights-client

Then, register the system to Red Hat Insights for Red Hat Enterprise Linux:

[root@server ~]# insights-client --register

Procedure

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

    [root@insights]# insights-client --register
  2. Optionally, enter the insights-client command with the --register option and the --display-name option to specify the name you want to appear in the GUI.

    [root@insights]# insights-client --register --display-name ITC-4
    System display name changed from None to ITC-4

Verification steps

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

    [root@insights]# insights-client --status
    System is registered locally via .registered file. Registered at 2019-08-20T12:56:48.356814
    Insights API confirms registration.

3.2. Unregistering your system with Red Hat Insights for Red Hat Enterprise Linux

You can unregister your system with Red Hat Insights for Red Hat Enterprise Linux. When you do so, your system information is no longer uploaded to Insights for RHEL.

Prerequisites

  • Your system is registered with Insights for RHEL.

Procedure

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

    [root@insights]# insights-client --unregister
    Successfully unregistered from the Red Hat Insights Service

Verification steps

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

    [root@insights]# insights-client --status
    System is NOT registered locally via .registered file. Unregistered at 2021-03-12T10:36:39.257300
    Insights API says this machine was unregistered at 2021-03-12T00:36:39.000Z

3.3. Changing the host display name

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 Insights for Red Hat Enterprise Linux, or after registration. If you do not assign a display name when you register the system, Red Hat Insights for Red Hat Enterprise Linux uses the value in /etc/hostname.

Note

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

Note

The Red Hat Insights for Red Hat Enterprise Linux compliance service uses OpenSCAP tools to generate compliance reports based on information from the host system. The collaboration with OpenSCAP prevents the compliance service’s ability to completely obfuscate or redact host name and IP address data. Also, host information is sent to Insights for RHEL when a compliance data collection job launches on the host system. Red Hat Insights for Red Hat Enterprise Linux is working to improve obfuscation options for host information.

For information about how Red Hat handles data collection, see Red Hat Insights Data & Application Security.

Prerequisites

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

Procedure

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

    [root@insights]# insights-client --display-name ITC-4
    System display name changed from None to ITC-4
  2. To create a display name that contains spaces, use double quotes.

    [root@insights]# insights-client --display-name "ITC-4 B9 4th floor"
    System display name changed from None to ITC-4 B9 4th floor

3.4. Displaying the client version

You can display the client version and client core version.

Procedure

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

    [root@insights]# insights-client --version
    Client: 3.0.6-0
    Core: 3.0.121-1

Additional resources

These links provide client changelog information: