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.

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 upgrade

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.