Chapter 2. Installing Capsule Server

1. Download the katello-ca-consumer-latest.noarch.rpm package on the base operating system on which you want to install Capsule. The consumer RPM configures the host to download content from the content source that is specified in Satellite.

   # curl --insecure --output katello-ca-consumer-latest.noarch.rpm https://satellite.example.com/pub/katello-ca-consumer-latest.noarch.rpm

2. Install the katello-ca-consumer-latest.noarch.rpm package:

   # yum localinstall katello-ca-consumer-latest.noarch.rpm

3. Register the Capsule base operating system with the environments that you want Capsule to belong to. Use an activation key to simplify specifying the environments. For more information about activation keys, see Managing Activation Keys in the Content Management Guide.

   # subscription-manager register --org=organization_name --activationkey=example_activation_key

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

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:

   # 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-7-server-rpms \
   --enable=rhel-7-server-satellite-capsule-6.9-rpms \
   --enable=rhel-7-server-satellite-maintenance-6-rpms \
   --enable=rhel-7-server-satellite-tools-6.9-rpms \
   --enable=rhel-server-rhscl-7-rpms \
   --enable=rhel-7-server-ansible-2.9-rpms

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

3. Clear any metadata:

   # yum clean all

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

   # yum repolist enabled

1. Update all packages:

   # yum update

2. Install the satellite-capsule package:

   # yum install satellite-capsule

Procedure

1. Install the chrony package:

   # yum install chrony

2. Start and enable the chronyd service:

   # systemctl start chronyd
   # systemctl enable 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. Navigate to Hosts > All Hosts and select the 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 the 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. Navigate to Administer > Organizations and click the organization to which you have assigned Capsule.
14. Click the Capsules tab and ensure that the Capsule Server is listed under the Selected items list, then click Submit.
15. Navigate to Administer > Locations and click the location to which you have assigned Capsule.
16. Click the Capsules tab and ensure that the 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. Navigate to Hosts > All Hosts.
4. Navigate to Infrastructure > Capsules.