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

   Copy to Clipboard Toggle word wrap
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"

   Copy to Clipboard Toggle word wrap

   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

   Copy to Clipboard Toggle word wrap
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

   Copy to Clipboard Toggle word wrap
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"] }}'

   Copy to Clipboard Toggle word wrap

   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 }}'

   Copy to Clipboard Toggle word wrap

   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

   Copy to Clipboard Toggle word wrap
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*'

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

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

   Copy to Clipboard Toggle word wrap