第10章 Renaming Satellite Server or Capsule Server

Procedure

1. On Satellite Server, choose the appropriate method to run the satellite-change-hostname script, providing the new host name and Satellite credentials:

   • If your Satellite Server is installed with default self-signed SSL certificates, enter the following command:

     # satellite-change-hostname new-satellite \
     --username admin \
     --password password

     Copy to Clipboard Toggle word wrap

   • If your Satellite Server is installed with custom SSL certificates:

     # satellite-change-hostname new-satellite \
     --username admin \
     --password password \
     --custom-cert "/root/ownca/test.com/test.com.crt" \
     --custom-key "/root/ownca/test.com/test.com.key"

     Copy to Clipboard Toggle word wrap
2. Optional: If you have created a custom SSL certificate for the new Satellite Server host name, run the Satellite installation script to install the certificate. For more information about installing a custom SSL certificate, see Deploying a Custom SSL Certificate to Satellite Server in Installing Satellite Server from a Connected Network.

3. On all Satellite clients, enter the following commands to reinstall the bootstrap RPM, reregister clients, and refresh their subscriptions.

   You can use remote execution feature to perform this step. For more information, see Configuring and Setting up Remote Jobs in Managing Hosts.

   # yum remove -y katello-ca-consumer*
   
   # rpm -Uvh http://new-satellite.example.com/pub/katello-ca-consumer-latest.noarch.rpm
   
   # subscription-manager register \
   --org="Default_Organization" \
   --environment="Library" \
   --force
   
   # subscription-manager refresh

   Copy to Clipboard Toggle word wrap

4. On all Capsule Servers, run the Satellite installation script to update references to the new host name:

   # satellite-installer \
   --foreman-proxy-content-parent-fqdn new-satellite.example.com \
   --foreman-proxy-foreman-base-url https://new-satellite.example.com \
   --foreman-proxy-trusted-hosts new-satellite.example.com \
   --puppet-server-foreman-url new-satellite.example.com

   Copy to Clipboard Toggle word wrap

5. On Satellite Server, list all Capsule Servers:

   # hammer capsule list

   Copy to Clipboard Toggle word wrap

6. On Satellite Server, synchronize content for each Capsule Server:

   # hammer capsule content synchronize \
   --id capsule_id_number

   Copy to Clipboard Toggle word wrap