4.3. Disconnected Satellite

Procedure 4.11. To Configure a Host to Synchronize and Export Content from the Red Hat CDN:

1. Use Red Hat Subscription Manager to register the synchronization host to RHN.
2. List all the available subscriptions to find the correct Red Hat Satellite product to allocate to your system:

   # subscription-manager list --available --all

   Copy to Clipboard Toggle word wrap
   This command displays output similar to the following:

   +-------------------------------------------+
       Available Subscriptions
   +-------------------------------------------+
   
   
   ProductName:        Red Hat Satellite
   ProductId:          SKU123456
   PoolId:             e1730d1f4eaa448397bfd30c8c7f3d334bd8b
   Quantity:           10
   Multi-Entitlement:  No
   Expires:            08/20/2013
   MachineType:        physical
   

   Copy to Clipboard Toggle word wrap

   Note

   The SKU and Pool ID depend on the Red Hat Satellite product type that corresponds to your system version and product type.
3. Subscribe to the pool using the following command:

   # subscription-manager subscribe --pool=Red_Hat_Satellite_Pool_Id
   # subscription-manager subscribe --pool=Red_Hat_Enterprise_Linux_Pool_Id
   # subscription-manager subscribe --pool=Red_Hat_Enterprise_Linux_Software_Collections_Pool_Id
   

   Copy to Clipboard Toggle word wrap
4. Disable all existing repositories:

   # subscription-manager repos --disable "*"
   

   Copy to Clipboard Toggle word wrap
5. Enable the Red Hat Satellite and Red Hat Enterprise Linux and Red Hat Software Collections repositories. Ensure the Red Hat Enterprise Linux repository matches the specific version you are using.

   # subscription-manager repos --enable rhel-6-server-rpms \
   --enable rhel-server-rhscl-6-rpms \
   --enable rhel-6-server-satellite-6.0-rpms
   

   Copy to Clipboard Toggle word wrap

   Note

   The commands above are based on Red Hat Enterprise Linux 6. If you are using a different version of Red Hat Enterprise Linux, change the repository based on your specific version.
6. Install katello-utils and associated RPMs:

   # yum install python-qpid-qmf python-qpid  qpid-cpp-server katello-utils
   

   Copy to Clipboard Toggle word wrap
   katello-utils includes the katello-disconnected utility that is required to set up repositories for import while qpid related packages are necessary for pulp configuration.
7. Generate a secret 32-character alphanumeric string for the oauth_secret entry in the /etc/pulp/server.conf file:

   # tr -dc "[:alnum:]" < /dev/urandom | head -c 32
   randomly_generated_value

   Copy to Clipboard Toggle word wrap
8. In the /etc/pulp/server.conf, uncomment the [oauth] entry and add the randomly generated value from the previous step as the oauth_secret value:

   [oauth]
   enabled: true
   oauth_key: katello
   oauth_secret: randomly_generated_value

   Copy to Clipboard Toggle word wrap
9. Disable authentication in /etc/qpid/qpidd.conf:

   # Configuration file for qpidd. Entries are of the form:
   #   name=value
   #
   # (Note: no spaces on either side of '=').
   # Run "qpidd --help" or see "man qpidd" for more details.
   
   auth=no
   

   Copy to Clipboard Toggle word wrap
   All incoming connections authenticate using the Satellite's default realm.
10. Configure the connection from katello-disconnected to Pulp with the previously generated value as your --oauth-secret option:

    # katello-disconnected setup --oauth-key=katello --oauth-secret=randomly_generated_value

    Copy to Clipboard Toggle word wrap
    This places a configuration value in ~/.katello-disconnected.
11. Configure Pulp on the Synchronization Server:

    sudo service qpidd start
    sudo chkconfig qpidd on
    sudo service mongod start
    sleep 10
    sudo chkconfig mongod on
    sudo -u apache pulp-manage-db
    sudo service httpd restart
    sudo chkconfig pulp_workers on
    sudo service pulp_workers start
    sudo chkconfig pulp_celerybeat on
    sudo service pulp_celerybeat start
    sudo chkconfig pulp_resource_manager on
    sudo service pulp_resource_manager start
    

    Copy to Clipboard Toggle word wrap
12. Import the manifest:

    # katello-disconnected import -m ./manifest.zip
    

    Copy to Clipboard Toggle word wrap
    Importing the manifest sets up the list of available repositories to synchronize to based on the subscriptions you selected.

1. Disable all repositories:

   # katello-disconnected disable --all
   

   Copy to Clipboard Toggle word wrap
   katello-disconnected enables all repositories by default.
2. Choose which repositories you wish to sync by listing all available repositories from the manifest:

   # katello-disconnected list --disabled
   rhel-5-server-debug-rpms-5Server-i386
   rhel-5-server-debug-rpms-5Server-ia64
   rhel-5-server-debug-rpms-5Server-x86_64
   rhel-5-server-debug-rpms-5_7-i386
   rhel-5-server-debug-rpms-5_7-ia64
   rhel-5-server-debug-rpms-5_7-x86_64
   rhel-5-server-debug-rpms-5_8-i386
   rhel-5-server-debug-rpms-5_8-ia64
   rhel-5-server-debug-rpms-5_8-x86_64
   rhel-5-server-debug-rpms-5_9-i386
   rhel-5-server-debug-rpms-5_9-ia64
   rhel-5-server-debug-rpms-5_9-x86_64
   rhel-5-server-isos-5Server-i386
   

   Copy to Clipboard Toggle word wrap
3. Enable the chosen repositories for synchronization:

   # katello-disconnected enable -r rhel-6-server-sam-rpms-6_4-x86_64
   

   Copy to Clipboard Toggle word wrap
4. Create the repositories and push them to Pulp to allow synchronization:

   # katello-disconnected configure
   

   Copy to Clipboard Toggle word wrap

   Note

   The configure option for katello-disconnected reads the manifest, creates pulp repositories, and generates scripts before synchronization. It needs to be run each time a repository is enabled or disabled.
5. Synchronize the repositories:

   # katello-disconnected sync
   

   Copy to Clipboard Toggle word wrap
   You can use the watch option to monitor the synchronization process.

   # katello-disconnected watch
   Watching sync... (this may be safely interrupted with Ctrl+C)
   running:
   rhel-6-server-sam-rpms-6_4-x86_64 
   
   running:
   rhel-6-server-sam-rpms-6_4-x86_64 
   ...
   finished:
   rhel-6-server-sam-rpms-6_4-x86_64 
   
   
   Watching finished
   

   Copy to Clipboard Toggle word wrap

1. Export the synchronized repositories:

   # katello-disconnected export -t /var/tmp/export
   

   Copy to Clipboard Toggle word wrap
   The output will look similar to:

   # katello-disconnected export -t /var/tmp/export
   # katello-disconnected watch
   Watching sync... (this may be safely interrupted with Ctrl+C)
   running:
   rhel-6-server-sam-rpms-6_4-x86_64
   
   finished:
   rhel-6-server-sam-rpms-6_4-x86_64
   Watching finished
   Done watching ...
    Copying content to /var/tmp/export
    Archiving contents of /var/tmp/export into 4600M tar archives.
    NOTE: This may take a while.
   tar: Removing leading `/' from member names
   
   Done exporting content, please copy /var/tmp/export/* to your disconnected host
   

   Copy to Clipboard Toggle word wrap
   This operation will create the following files in /var/tmp/export:

   # ls /var/tmp/export/
   content-export-00 content-export-01 content-export-02 expand_export.sh
   

   Copy to Clipboard Toggle word wrap
2. Copy the files from /var/tmp/export into the external media.

   Note

   If the files are too big for your external media, the files can be copied sequentially in a series of DVDs.

1. Copy ALL of the Satellite Content ISOs to a directory that the Satellite can access. This example uses /root/isos.
2. Create a local directory that will be shared via httpd on the Satellite. This example uses /var/www.html/sat-import/.

   # mkdir -p /var/www/html/sat-import/
   

   Copy to Clipboard Toggle word wrap
3. Recursively copy the contents of the first ISO to the local directory:

   # mount -o loop /root/isos/first iso /mnt/iso
   # cp -ruv /mnt/iso/* /var/www/html/sat-import/
   # umount /mnt/iso
   

   Copy to Clipboard Toggle word wrap
4. Repeat the above step for each ISO until you have copied all the data from the series of ISOs into the local directory /var/www/html/sat-import/.
5. Ensure that the SELinux contexts is correct:

   # restorecon -rv /var/www/html/sat-import/
   

   Copy to Clipboard Toggle word wrap
6. Change the CDN URL to reference the loaction that the ISOs were copied to. This example uses the Satellite fully qualified domain name (FQDN) server.example.com, so the URL is:

   http //server.example.com/sat-import/
   

   Copy to Clipboard Toggle word wrap

   Note

   The Satellite is now acting as its own CDN with the files located in http://localhost/content. This is not a requirement. The CDN can be hosted on a different machine inside the same disconnected network as long as it is accessible to the Satellite server via HTTP.
7. Add the CDN address to the Satellite web interface:
   1. Log in to the Satellite web interface.
   2. Click Content Red Hat Subscriptions and then click Manage Manifest.
   3. On the Subscription Manifest information screen, scroll to Red Hat Provider Details. Click the edit icon on the Repository URL entry and change the entry to the CDN's repository URL.
   4. Click Browse to choose the manifest file.
   5. Click Upload to import your manifest.
8. Enable the repositories from the local CDN:
   1. Click Content Red Hat Repositories
   2. Enable the repositories that were enabled and synchronized in the Synchronizing Content section.
9. Click Content Sync Status.
10. Select the repositories you want to synchronize and click Synchronize Now.