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

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

   # subscription-manager list --all --available

   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

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

   The outputs displays something similar to the following:

   Successfully attached a subscription for: Red Hat Satellite

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

   # subscription-manager list --consumed

   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

1. Disable all existing repositories.

   # subscription-manager repos --disable "*"

2. Enable the Red Hat Enterprise Linux Server, Red Hat Software Collections, and the Red Hat Satellite 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.3-rpms

   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

4. Verify that the repositories have been enabled.

   # yum repolist enabled

1. Install the Satellite Server package.

   # yum install satellite

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 \
   --foreman-proxy-puppetca true \
   --foreman-proxy-tftp true \
   --enable-foreman-plugin-discovery

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

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

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

3. Add the following content to the file.

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

   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"

1. Open https://access.redhat.com/ in your browser and log in to your Red Hat account.
2. Navigate to Subscriptions in the upper-left corner of the Customer Portal.
3. Navigate to Subscription Allocations.
4. Click Create New subscription allocation
5. In the Name field, enter a name.
6. From the Type list, select the type and version that corresponds to your Satellite Server.
7. Click Create.

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 Choose file and select the manifest you created.
5. Click Upload to upload the manifest to Satellite Server.

Uploading a Manifest Using Hammer CLI

1. Upload a manifest to Satellite Server.

   # hammer subscription upload \
   --file ~/manifest_file.zip \
   --organization "organization_name"