Chapter 4. Configuring automatic registration and management

Procedure

1. In your host, create a working directory and change to that directory. This example uses myisodir as the directory name.

   $ mkdir myisodir
   $ cd myisodir

2. Download the ISO image that you created:

   1. In the console, click Red Hat Insights > RHEL > Inventory > Images.
   2. In the Immutable (OSTree) tab, click the More options icon (⋮) for the image you want to download and click Download.
3. Copy the ISO into the myisodir directory you created.

4. Rename your ISO to fleet_source.iso. In this example, mydownloaded.iso is an example name of the ISO you downloaded.

   $ mv mydownloaded.iso fleet_source.iso

5. Using a text editor, create a plain text file in the working directory named fleet_rhc_vars.

6. Paste the following example and replace YOUR_RHC_ORG_ID and YOUR_RHC_ACTIVATION_KEY with your credentials. Contact the Organization Administrator for your account, or check the Activation keys page to find your credentials.

   RHC_ORGID=YOUR_RHC_ORG_ID
   RHC_ACTIVATION_KEY=YOUR_RHC_ACTIVATION_KEY
   RHC_FIRSTBOOT=true

7. Use Podman to pull the Fleet Utility app container.

   $ podman pull quay.io/fleet-management/fleet-iso-util:latest

8. Run the fleet utility tool with Podman to create a new ISO with your RHC credentials embedded. Replace /full/path/to/myisodir with the full path to your myisodir directory. Enter the pwd command in your terminal in your myisodir directory to get the full path to your myisodir directory.

   $ podman run -it --rm -v /full/path/to/myisodir:/isodir:z quay.io/fleet-management/fleet-iso-util:latest

9. Copy the new ISO fleet_out.iso to a location used by your deployment process such as a USB drive. For example, when using libvirt and the default image directory setting, move the ISO to /var/lib/libvirt/images.
10. Install RHEL for Edge onto your device using the new ISO.

11. Log in to the system using the SSH username and key you provided when you created your image.

    $ ssh username@ipaddress -i /path/to/private_key

12. To verify the registration, enter the following command:

    $ rhc status

    Example output

    Connection status for localhost.localdomain:
    - Connected to Red Hat Subscription Management
    - The Remote Host Configuration and Management daemon is active
    
    Manage your Remote Host Configuration and Management systems: https://red.ht/connector

13. Verify the registration of the new system in the Red Hat Hybrid Cloud Console platform. Click Edge Management > Inventory > Systems.

14. (Optional) To make the system more recognizable during development or testing, you can add a prefix to the fleet_rhc_vars file and it will be added to the Insights display name at install. Otherwise, if the system hostname is localhost.localdomain, the auto-registration process only sets the Insights display name to the subscription-manager ID.

    RHC_ORGID=YOUR_RHC_ORG_ID
    RHC_ACTIVATION_KEY=YOUR_RHC_ACTIVATION_KEY
    DISPLAY_NAME_PREFIX=myprefix-