Chapter 11. Registering clients to the load balancer
Chapter 11. Registering clients to the load balancer To balance the load of network traffic from clients, you must register the clients to the load balancer. To register clients, proceed with one of the following procedures: Section 11.1, "Registering clients using host registration" Section 11.2, " (Deprecated) Registering clients using the bootstrap script" 11.1. Registering clients using host registration You can register hosts with Satellite using the host registration feature in the Satellite web UI, Hammer CLI, or the Satellite API. For more information, see Registering hosts and setting up host integration in Managing hosts . Prerequisites You have set the load balancer for host registration. For more information, see Chapter 8, Setting the load balancer for host registration . Procedure In the Satellite web UI, navigate to Hosts > Register Host . From the Capsule dropdown list, select the load balancer. Select Force to register a host that has been previously registered to a Capsule Server. From the Activation Keys list, select the activation keys to assign to your host. Click Generate to create the registration command. Click on the files icon to copy the command to your clipboard. Connect to your host using SSH and run the registration command. Check the /etc/yum.repos.d/redhat.repo file and ensure that the appropriate repositories have been enabled. CLI procedure Generate the host registration command using the Hammer CLI: 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. Include the --smart-proxy-id My_Capsule_ID option. You can use the ID of any Capsule Server that you configured for host registration load balancing. Satellite will apply the load balancer to the registration command automatically. Include the --force option to register a host that has been previously registered to a Capsule Server. Connect to your host using SSH and run the registration command. Check the /etc/yum.repos.d/redhat.repo file and ensure that the appropriate repositories have been enabled. API procedure Generate the host registration command using the Satellite API: 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. Use an activation key to simplify specifying the environments. For more information, see Managing Activation Keys in Managing content . Include { "smart_proxy_id": My_Capsule_ID } . You can use the ID of any Capsule Server that you configured for host registration load balancing. Satellite will apply the load balancer to the registration command automatically. Include { "force": true } to register a host that has been previously registered to a Capsule Server. To enter a password as a command line argument, use username:password syntax. Keep in mind this can save the password in the shell history. Alternatively, you can use a temporary personal access token instead of a password. To generate a token in the Satellite web UI, navigate to My Account > Personal Access Tokens . Connect to your host using SSH and run the registration command. Check the /etc/yum.repos.d/redhat.repo file and ensure that the appropriate repositories have been enabled. 11.2. (Deprecated) Registering clients using the bootstrap script To register clients, enter the following command on the client. You must complete the registration procedure for each client. Prerequisites Ensure that you install the bootstrap script on the client and change file permissions of the script to executable. For more information, see Registering Hosts to Red Hat Satellite Using The Bootstrap Script in Managing hosts . Procedure On Red Hat Enterprise Linux 8, enter the following command: 1 Replace <arch> with the client architecture, for example x86 . 2 Include the --force option to register the client that has been previously registered to a standalone Capsule. 3 Include the --puppet-ca-port 8141 option if you use Puppet. On Red Hat Enterprise Linux 7 or 6, enter the following command: 1 Include the --force option to register the client that has been previously registered to a standalone Capsule. 2 Include the --puppet-ca-port 8141 option if you use Puppet. The script prompts for the password corresponding to the Satellite user name you entered with the --login option.
hammer host-registration generate-command --activation-keys " My_Activation_Key " hammer host-registration generate-command --activation-keys " My_Activation_Key " --insecure true 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 "] }}' 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 }}' /usr/libexec/platform-python bootstrap.py --activationkey=" My_Activation_Key " --enablerepos=satellite-client-6-for-rhel-8-<arch>-rpms \ 1 --force \ 2 --hostgroup=" My_Host_Group " --location=" My_Location " --login= admin --organization=" My_Organization " --puppet-ca-port 8141 \ 3 --server loadbalancer.example.com python bootstrap.py --login= admin --activationkey=" My_Activation_Key " --enablerepos=rhel-7-server-satellite-client-6-rpms --force \ 1 --hostgroup=" My_Host_Group " --location=" My_Location " --organization=" My_Organization " --puppet-ca-port 8141 \ 2 --server loadbalancer.example.com