Chapter 2. Installing Capsule Server

Procedure

1. In the Satellite web UI, navigate to Hosts > Register Host.
2. From the Activation Keys list, select the activation keys to assign to your host.
3. Click Generate to create the registration command.
4. Click on the files icon to copy the command to your clipboard.
5. Connect to your host using SSH and run the registration command.
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. Connect to your host using SSH and run the registration 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"] }}'

   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 Managing content.

   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.

2. Connect to your host using SSH and run the registration 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'

   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 Satellite Capsule
                        Red Hat Ansible Engine
                        Red Hat Satellite with Embedded Oracle
                        Red Hat Satellite 5 Managed DB
                        Red Hat Enterprise Linux Load Balancer (for RHEL Server)
                        Red Hat Beta
                        Red Hat Software Collections Beta (for RHEL Server)
                        Red Hat Enterprise Linux Server
                        Red Hat Enterprise Linux for x86_64
                        Red Hat Satellite Proxy
                        Red Hat Enterprise Linux High Availability for x86_64
                        Red Hat Discovery
   SKU:                 MCT3718
   Contract:
   Pool ID:             8aca43dd771bf31101771c0231f906a5
   Provides Management: Yes
   Available:           10
   Suggested:           1
   Service Type:        L1-L3
   Roles:
   Service Level:       Premium
   Usage:
   Add-ons:
   Subscription Type:   Standard
   Starts:              11/11/2020
   Ends:                11/11/2023
   Entitlement Type:    Physical

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

   The command displays output similar to the following:

   Successfully attached a subscription for: Red Hat Satellite Infrastructure Subscription

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

   # subscription-manager list --consumed

1. Disable all repositories:

   # subscription-manager repos --disable "*"

2. Enable the following repositories:

   # subscription-manager repos --enable=rhel-8-for-x86_64-baseos-rpms \
   --enable=rhel-8-for-x86_64-appstream-rpms \
   --enable=satellite-capsule-6.15-for-rhel-8-x86_64-rpms \
   --enable=satellite-maintenance-6.15-for-rhel-8-x86_64-rpms

3. Enable the module:

   # dnf module enable satellite-capsule:el8

   Note

   If there is any warning about conflicts with Ruby or PostgreSQL while enabling satellite-capsule:el8 module, see Troubleshooting DNF modules. For more information about modules and lifecycle streams on Red Hat Enterprise Linux 8, see Red Hat Enterprise Linux Application Streams Lifecycle.

   Note

   If you are installing Capsule Server as a virtual machine hosted on Red Hat Virtualization, you must also enable the Red Hat Common repository and then install Red Hat Virtualization guest agents and drivers. For more information, see Installing the Guest Agents and Drivers on Red Hat Enterprise Linux in the Virtual Machine Management Guide.

4. Optional: Verify that the required repositories are enabled:

   # dnf repolist enabled

1. Update all packages:

   # dnf update

2. Install the Satellite Server packages:

   # dnf install satellite-capsule

Procedure

1. Install the chrony package:

   # dnf install chrony

2. Start and enable the chronyd service:

   # systemctl enable --now chronyd

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.