Chapter 2. Configuring Red Hat Insights client

The procedures in this section show you how to configure the Red Hat 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 Red Hat Insights client is deployed on your system.

2.1. Registering your system with Red Hat Insights

You must register your system with Red Hat Insights 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 uses the value in /etc/hostname.

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.

2.2. 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, or after registration. If you do not assign a display name when you register the system, Red Hat Insights 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.

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

2.3. 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: