Chapter 3. Installing Satellite Server

1. Register your Satellite Server, using your user name and password.

   # subscription-manager register
   Username:
   Password:
   The system has been registered with ID: 541084ff2-44cab-4eb1-9fa1-7683431bcf9a

   Copy to Clipboard Toggle word wrap

1. To identify your Satellite subscription, enter the following command:

   # subscription-manager list --all --available

   Copy to Clipboard Toggle word wrap

   The outputs displays something similar to the following:

   Subscription Name: Red Hat Satellite
   Provides:          Red Hat Satellite 6
                      Red Hat Enterprise Linux Server
                      Red Hat Satellite
                      Red Hat Enterprise Linux Load Balancer (for RHEL Server)
   SKU:               MCT0370
   Pool ID:           8a85f9874152663c0541943739717d11
   Available:         3
   Suggested:         1
   Service Level:     Premium
   Service Type:      L1-L3
   Multi-Entitlement: No
   Ends:              10/07/2014
   System Type:       Physical

   Copy to Clipboard Toggle word wrap
2. Make a note of the Pool ID so that you can attach it to your Satellite host. Your Pool ID will be different than the example provided.

3. To attach your subscription to your Satellite Server, enter the following command, using your Pool ID:

   # subscription-manager attach --pool=8a85f9874152663c0541943739717d11

   Copy to Clipboard Toggle word wrap

   The outputs displays something similar to the following:

   Successfully attached a subscription for: Red Hat Satellite

   Copy to Clipboard Toggle word wrap

4. To verify that the subscriptions are successfully attached, enter the following command:

   # subscription-manager list --consumed

   Copy to Clipboard Toggle word wrap

   The outputs displays something similar to the following:

   +-------------------------------------------+
      Consumed Subscriptions
   +-------------------------------------------+
   Subscription Name: Red Hat Satellite
   Provides:          Red Hat Satellite
                      Red Hat Enterprise Linux Server
                      Red Hat Software Collections (for RHEL Server)
                      Red Hat Satellite
                      Red Hat Satellite 6
                      Red Hat Software Collections (for RHEL Server)
                      Red Hat Satellite Capsule
                      Red Hat Enterprise Linux Load Balancer (for RHEL Server)
                      Red Hat Satellite with Embedded Oracle
                      Red Hat Satellite Capsule
                      Red Hat Enterprise Linux High Availability (for RHEL Server)
   SKU:               MCT0370
   Contract:          10293569
   Account:           5361051
   Serial:            1653856191250699363
   Pool ID:           8a85f9874152663c0541943739717d11
   Active:            True
   Quantity Used:     1
   Service Level:     Premium
   Service Type:      L1-L3
   Status Details:
   Starts:            10/08/2013
   Ends:              10/07/2014
   System Type:       Physical

   Copy to Clipboard Toggle word wrap

1. Disable all existing repositories.

   # subscription-manager repos --disable "*"

   Copy to Clipboard Toggle word wrap

2. Enable the Red Hat Satellite and Red Hat Enterprise Linux and Red Hat Software Collections repositories.

   The following example uses Red Hat Enterprise Linux 7.

   # subscription-manager repos --enable rhel-7-server-rpms \
                              --enable rhel-server-rhscl-7-rpms \
                              --enable rhel-7-server-satellite-6.2-rpms

   Copy to Clipboard Toggle word wrap
   Note

   If you are using a different version of Red Hat Enterprise Linux, change the repository based on your specific version.

3. Clear out any metadata.

   # yum clean all

   Copy to Clipboard Toggle word wrap

4. Verify that the repositories have been enabled.

   # yum repolist enabled

   Copy to Clipboard Toggle word wrap

1. Install the Satellite Server package.

   # yum install satellite

   Copy to Clipboard Toggle word wrap

2. Install Satellite Server and perform the initial configuration.

   # satellite-installer --scenario satellite \
   --foreman-initial-organization "$ORG" \
   --foreman-initial-location "$LOCATION" \
   --foreman-admin-password redhat \
   --capsule-puppet true \
   --foreman-proxy-puppetca true \
   --foreman-proxy-tftp true \
   --enable-foreman-plugin-discovery

   Copy to Clipboard Toggle word wrap

1. Create the ~/.hammer/cli_config.yml file if it does not already exist.

   # mkdir ~/.hammer
   # touch ~/.hammer/cli_config.yml

   Copy to Clipboard Toggle word wrap

2. To protect your password, make sure the file is only readable by the current user. For example, if you plan to issue hammer commands as root, execute the following command.

   # chmod 600 ~/.hammer/cli_config.yml

   Copy to Clipboard Toggle word wrap

3. Add the following content to the file.

   :foreman:
     :host: 'https://satellite.example.net/'
     :username: 'admin'
     :password: 'redhat'

   Copy to Clipboard Toggle word wrap
   Important

   Do not use tabs in your ~/.hammer/cli_config.yml file. Always use indentation by spaces.

4. Configure the admin user to default to logging in to the specified organization and location.

   # hammer user update --login admin \
   --default-location-id 1 \
   --default-organization-id 1 \
   --locations "$LOCATION" \
   --organizations "$ORG"

   Copy to Clipboard Toggle word wrap

1. Go to the Red Hat Customer Portal and log in.
2. Click SUBSCRIPTIONS.
3. In the Red Hat Subscription Management section, click Satellite.
4. Click Register a Satellite.
5. In the Name field, type Satellite_Server_example.
6. Select Satellite 6.2 as the version and click Register.
7. Click Attach a subscription.
8. Select the check box for each subscription that you want to attach and specify the number of subscriptions.

9. Click Attach Selected.

   It can take several minutes for all the subscriptions to attach.

10. Click Download Manifest and save the manifest file to a known location.

Uploading a Manifest Using the Web UI

1. Verify that you are in the correct Organization.
2. Click Content Red Hat Subscriptions.
3. Click Manage Manifest to open the Subscriptions page.
4. Click Browse, select the manifest file you created, and click Open.
5. Click Upload to upload the manifest to the Satellite Server.

Uploading a Manifest Using Hammer CLI

1. Upload a manifest to Satellite Server.

   # hammer subscription upload \
   --organization-label org_label \
   --file path_to_manifest

   Copy to Clipboard Toggle word wrap