Red Hat Summit Red Hat SummitSupportConsoleDevelopersStart a trialContact

Chapter 2. Installing Satellite Server

2.1. Preparing for Satellite Server Installation
Copy link

Ensure that you meet all the prerequisites before installing Satellite Server.

Prerequisites

  • You must create a Red Hat Enterprise Linux 7 host before you can install and configure Satellite Server. Red Hat Enterprise Linux version 7.5 or later is supported. For more information about installing Red Hat Enterprise Linux 7, see the Red Hat Enterprise Linux 7 Installation Guide.
  • Ensure that your environment meets the requirements for installation, including meeting storage requirements, and ensuring that network ports and firewalls are open and configured. For more information, see the Preparing your Environment for Installation in Installing Satellite Server from a Connected Network.

Registering the host to Red Hat Subscription Management enables the host to subscribe to and consume content for any subscriptions available to the user. This includes content such as Red Hat Enterprise Linux, Red Hat Software Collections (RHSCL), and Red Hat Satellite.

  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

After you have registered your host, you must identify your subscription Pool ID and attach an available subscription. The Red Hat Satellite Infrastructure subscription provides access to the Red Hat Satellite, Red Hat Enterprise Linux, and Red Hat Software Collections (RHSCL) content. This is the only subscription required.

Red Hat Satellite Infrastructure is included with all subscriptions that include Smart Management. For more information, see the Red Hat Knowledgebase solution Satellite Infrastructure Subscriptions MCT3718 MCT3719.

  1. Identify your Satellite subscription. 

    # subscription-manager list --all --available --matches 'Red Hat Satellite Infrastructure Subscription'
    Copy to Clipboard Toggle word wrap

    Subscriptions are classified as available if they are not already attached to a system. If you are unable to find an available Satellite subscription, see the Red Hat Knowledgebase solution How do I figure out which subscriptions have been consumed by clients registered under Red Hat Subscription Manager? to run a script to see if your subscription is being consumed by another system.

    Your output should be similar to the following: 

    Subscription Name:   Red Hat Satellite Infrastructure Subscription
Provides:            Red Hat Beta
                     Red Hat Satellite
                     Red Hat Satellite with Embedded Oracle
                     Red Hat Satellite 5 Managed DB
                     Red Hat Satellite Proxy
                     Red Hat Software Collections (for RHEL Server)
                     Red Hat Satellite Capsule
                     Red Hat Software Collections Beta (for RHEL Server)
                     Red Hat Enterprise Linux High Availability for x86_64
                     Red Hat Ansible Engine
                     Red Hat Enterprise Linux Load Balancer (for RHEL Server)
                     Red Hat Enterprise Linux Server
SKU:                 MCT3718
Contract:
Account:             540155
Serial:              6960416325892182336
Pool ID:             8a85f999655dc45a01658350d80d7164
Provides Management: Yes
Active:              True
Quantity Used:       1
Service Level:       Premium
Service Type:        L1-L3
Status Details:      Subscription is current
Subscription Type:   Standard
Starts:              08/28/2018
Ends:                09/19/2019
System Type:         Physical
    Copy to Clipboard Toggle word wrap
  2. Note the Pool ID so that you can attach it to your Satellite host. Your Pool ID is 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=pool_id
    Copy to Clipboard Toggle word wrap

    The output should be 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 Infrastructure Subscription
Provides:            Red Hat Beta
                     Red Hat Satellite
                     Red Hat Satellite with Embedded Oracle
                     Red Hat Satellite 5 Managed DB
                     Red Hat Satellite Proxy
                     Red Hat Software Collections (for RHEL Server)
                     Red Hat Satellite Capsule
                     Red Hat Software Collections Beta (for RHEL Server)
                     Red Hat Enterprise Linux High Availability for x86_64
                     Red Hat Ansible Engine
                     Red Hat Enterprise Linux Load Balancer (for RHEL Server)
                     Red Hat Enterprise Linux Server
SKU:                 MCT3718
Contract:
Account:             540155
Serial:              6960416325892182336
Pool ID:             8a85f999655dc45a01658350d80d7164
Provides Management: Yes
Active:              True
Quantity Used:       1
Service Level:       Premium
Service Type:        L1-L3
Status Details:      Subscription is current
Subscription Type:   Standard
Starts:              08/28/2018
Ends:                09/19/2019
System Type:         Physical
    Copy to Clipboard Toggle word wrap

2.4. Configuring Repositories
Copy link

  1. Disable all existing repositories. 

    # subscription-manager repos --disable "*"
    Copy to Clipboard Toggle word wrap

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

    # subscription-manager repos --enable=rhel-7-server-rpms \
--enable=rhel-server-rhscl-7-rpms \
--enable=rhel-7-server-satellite-6.5-rpms \
--enable=rhel-7-server-satellite-maintenance-6-rpms \
--enable=rhel-7-server-ansible-2.6-rpms
    Copy to Clipboard Toggle word wrap

  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

2.5. Installing Satellite Server
Copy link

  1. Update all packages: 

    # yum update
    Copy to Clipboard Toggle word wrap

  2. Install the Satellite Server package: 

    # yum install satellite
    Copy to Clipboard Toggle word wrap

  3. Install Satellite Server and perform the initial configuration: 

    # satellite-installer --scenario satellite \
--foreman-admin-username admin \
--foreman-admin-password redhat \
--foreman-proxy-puppetca true \
--foreman-proxy-tftp true \
--enable-foreman-plugin-discovery
    Copy to Clipboard Toggle word wrap

To create a manifest, you must first create an allocation and then export the manifest from the allocation.

You can access your subscription information on the Red Hat Customer Portal. You can also assign subscriptions for use in on-premise management applications, such as Red Hat Satellite, using subscription allocations.

  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.

2.6.1. Adding Subscriptions to an Allocation
Copy link

The following procedure explains how to add subscriptions to an allocation.

  1. Open https://access.redhat.com/ in your browser and log in to the Red Hat account that you used to register the system to Red Hat Subscription Management.
  2. Navigate to Subscriptions in the upper-left corner of the Customer Portal.
  3. Navigate to Subscription Allocations.
  4. Click the allocation that you want to update.
  5. Click the Subscriptions tab.
  6. Click Add Subscriptions.
  7. A list of your Red Hat product subscriptions appears. Enter the Entitlement Quantity for each product.
  8. Click Submit to complete the assignment.

When you have added subscriptions to the allocation, export the manifest file.

While viewing a subscription allocation that has at least one subscription, you can export a manifest in either of two places:

  • From the Details tab, under the Subscription section, by clicking the Export Manifest button.
  • From the Subscriptions tab, by clicking the Export Manifest button.

When the manifest is exported, the Customer Portal encodes the selected subscriptions certificates and creates a .zip archive. This is the Subscription Manifest, which can be uploaded into Satellite Server.

2.8. Uploading a Manifest to Your Satellite Server
Copy link

Uploading a Manifest Using the Web UI

  1. Verify that you are in the correct organization.
  2. Click Content > Subscriptions.
  3. Click Manage Manifest to open the Subscriptions page.
  4. Click Choose file and select the manifest archive in a .zip format that you have exported from the Customer Portal.
Back to top
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2025 Red Hat