Chapter 6. Registering Clients

Procedure

1. In the Satellite web UI, navigate to Hosts > Register Host.
2. Click Generate to create the registration command.
3. Click on the files icon to copy the command to your clipboard.
4. Log in to the host you want register and run the previously generated command.

5. Update subscription manager configuration for rhsm.baseurl and server.hostname:

   # subscription-manager config \
   --rhsm.baseurl=https://loadbalancer.example.com/pulp/content \
   --server.hostname=loadbalancer.example.com

6. Check the /etc/yum.repos.d/redhat.repo file and ensure that the appropriate repositories have been enabled.

CLI procedure

1. Generate the host registration command using the Hammer CLI:

   # hammer host-registration generate-command \
   --activation-keys "My_Activation_Key"

   If your hosts do not trust the SSL certificate of Satellite Server, you can disable SSL validation by adding the --insecure flag to the registration command.

   # hammer host-registration generate-command \
   --activation-keys "My_Activation_Key" \
   --insecure true

2. Log in to the host you want register and run the previously generated command.

3. Update subscription manager configuration for rhsm.baseurl and server.hostname:

   # subscription-manager config \
   --rhsm.baseurl=https://loadbalancer.example.com/pulp/content \
   --server.hostname=loadbalancer.example.com

4. Check the /etc/yum.repos.d/redhat.repo file and ensure that the appropriate repositories have been enabled.

API procedure

1. Generate the host registration command using the Satellite API:

   # curl -X POST https://satellite.example.com/api/registration_commands \
   --user "My_User_Name" \
   -H 'Content-Type: application/json' \
   -d '{ "registration_command": { "activation_keys": ["My_Activation_Key_1, My_Activation_Key_2"] }}'

   If your hosts do not trust the SSL certificate of Satellite Server, you can disable SSL validation by adding the --insecure flag to the registration command.

   # curl -X POST https://satellite.example.com/api/registration_commands \
   --user "My_User_Name" \
   -H 'Content-Type: application/json' \
   -d '{ "registration_command": { "activation_keys": ["My_Activation_Key_1, My_Activation_Key_2"], "insecure": true }}'

   Use an activation key to simplify specifying the environments. For more information, see Managing Activation Keys in the Content Management guide.

   To enter a password as command line argument, use username:password syntax. Keep in mind this can save the password in the shell history.

   For more information about registration see Registering a Host to Red Hat Satellite in Managing Hosts.

2. Log in to the host you want register and run the previously generated command.

3. Update subscription manager configuration for rhsm.baseurl and server.hostname:

   # subscription-manager config \
   --rhsm.baseurl=https://loadbalancer.example.com/pulp/content \
   --server.hostname=loadbalancer.example.com

4. Check the /etc/yum.repos.d/redhat.repo file and ensure that the appropriate repositories have been enabled.

Procedure

1. Remove the katello-ca-consumer package if it is installed:

   # yum remove 'katello-ca-consumer*'

2. Install the katello-ca-consumer package from the load balancer:

   # rpm -Uvh http://loadbalancer.example.com/pub/katello-ca-consumer-latest.noarch.rpm

3. Register the client and include the --serverurl and --baseurl options:

   # subscription-manager register \
   --activationkey=My_Activation_Key \
   --baseurl=https://loadbalancer.example.com/pulp/content/ \
   --org=Your_Organization \
   --serverurl=https://loadbalancer.example.com/rhsm