Chapter 2. Installing Capsule Server

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. 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. 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. Check the /etc/yum.repos.d/redhat.repo file and ensure that the appropriate repositories have been enabled.

Procedure

1. Identify the Pool ID of the Satellite Infrastructure subscription:

   # subscription-manager list --all --available --matches 'Red Hat Satellite Infrastructure Subscription'

   Copy to Clipboard Toggle word wrap

   The command displays output similar to the following:

   Subscription Name:   Red Hat Satellite Infrastructure Subscription
   Provides:            Red Hat Satellite
                         Red Hat Software Collections (for RHEL Server)
                         Red Hat CodeReady Linux Builder for x86_64
                         Red Hat Ansible Engine
                         Red Hat Enterprise Linux Load Balancer (for RHEL Server)
                         Red Hat
                         Red Hat Software Collections (for RHEL Server)
                         Red Hat Enterprise Linux Server
                         Red Hat Satellite Capsule
                         Red Hat Enterprise Linux for x86_64
                         Red Hat Enterprise Linux High Availability for x86_64
                         Red Hat Satellite
                         Red Hat Satellite 5 Managed DB
                         Red Hat Satellite 6
                         Red Hat Discovery
   SKU:                 MCT3719
   Contract:            11878983
   Pool ID:             8a85f99968b92c3701694ee998cf03b8
   Provides Management: No
   Available:           1
   Suggested:           1
   Service Level:       Premium
   Service Type:        L1-L3
   Subscription Type:   Standard
   Ends:                03/04/2020
   System Type:         Physical

   Copy to Clipboard Toggle word wrap
2. Make a note of the subscription Pool ID. Your subscription Pool ID is different from the example provided.

3. Attach the Satellite Infrastructure subscription to the base operating system that your Capsule Server is running on. If SCA is enabled on Satellite Server, you can skip this step:

   # subscription-manager attach --pool=pool_id

   Copy to Clipboard Toggle word wrap

   The command displays output similar to the following:

   Successfully attached a subscription for: Red Hat Satellite Infrastructure Subscription

   Copy to Clipboard Toggle word wrap

4. Optional: Verify that the Satellite Infrastructure subscription is attached:

   # subscription-manager list --consumed

   Copy to Clipboard Toggle word wrap

Procedure

1. Install the chrony package:

   # yum install chrony

   Copy to Clipboard Toggle word wrap

2. Start and enable the chronyd service:

   # systemctl start chronyd
   # systemctl enable chronyd

   Copy to Clipboard Toggle word wrap

Procedure

1. Log into the Satellite web UI.
2. From the Organization list in the upper-left of the screen, select Any Organization.
3. From the Location list in the upper-left of the screen, select Any Location.
4. In the Satellite web UI, navigate to Hosts > All Hosts and select Capsule Server.
5. From the Select Actions list, select Assign Organization.
6. From the Organization list, select the organization where you want to assign this Capsule.
7. Click Fix Organization on Mismatch.
8. Click Submit.
9. Select Capsule Server. From the Select Actions list, select Assign Location.
10. From the Location list, select the location where you want to assign this Capsule.
11. Click Fix Location on Mismatch.
12. Click Submit.
13. In the Satellite web UI, navigate to Administer > Organizations and click the organization to which you have assigned Capsule.
14. Click Capsules tab and ensure that Capsule Server is listed under the Selected items list, then click Submit.
15. In the Satellite web UI, navigate to Administer > Locations and click the location to which you have assigned Capsule.
16. Click Capsules tab and ensure that Capsule Server is listed under the Selected items list, then click Submit.

1. Select the organization from the Organization list.
2. Select the location from the Location list.
3. In the Satellite web UI, navigate to Hosts > All Hosts.
4. In the Satellite web UI, navigate to Infrastructure > Capsules.