Chapter 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

   • 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
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 Running Remote Commands 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

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

   Copy to Clipboard

5. On Satellite Server, list all Capsule Servers:

   # hammer capsule list

   Copy to Clipboard

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

   # hammer capsule content synchronize \
   --id capsule_id_number

   Copy to Clipboard

Procedure

1. On Satellite Server, generate a new certificates archive file for Capsule Server.

   • If you are using the default SSL certificate, enter the following command:

     # capsule-certs-generate \
     --foreman-proxy-fqdn new-capsule.example.com \
     --certs-tar /root/new-capsule.example.com-certs.tar

     Copy to Clipboard

     Ensure that you enter the full path to the .tar file.

   • If you are using a custom SSL certificate, create a new SSL certificate for Capsule Server. For more information, see Configuring Capsule Server with a Custom SSL Certificate in Installing Capsule Server.

2. On Satellite Server, copy the certificates archive file to Capsule Server, providing the root user’s password when prompted. In this example the archive file is copied to the root user’s home directory, but you may prefer to copy it elsewhere.

   # scp /root/new-capsule.example.com-certs.tar root@capsule.example.com:

   Copy to Clipboard

3. On Capsule Server, run the satellite-change-hostname script, providing the host’s new name, Satellite credentials, and certificates archive filename.

   # satellite-change-hostname new_capsule --username admin \
   --password password \
   --certs-tar /root/new-capsule.example.com-certs.tar

   Copy to Clipboard

   Ensure that you enter the full path to the .tar file.

4. Optional: If you have created a custom certificate for Capsule Server, on Capsule Server, to deploy the certificate, enter the satellite-installer command that the capsule-certs-generate command returns. For more information, see Deploying a Custom SSL Certificate to Capsule Server in Installing Capsule Server.

5. On all Capsule 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 Running Remote Commands in Managing Hosts.

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

   Copy to Clipboard
6. In the Satellite web UI, navigate to Infrastructure > Capsules.
7. Locate Capsule Server in the list, and click Edit to the right of it.
8. Edit the Name and URL fields to match the Capsule Server’s new host name, then click Submit.
9. On your DNS server, add a record for the Capsule Server’s new host name, and delete the record for the previous host name.