검색

이 콘텐츠는 선택한 언어로 제공되지 않습니다.

Chapter 13. Renaming Satellite Server or Capsule Server

download PDF

To rename Satellite Server or Capsule Server, use the satellite-change-hostname script.

Important

When changing the domain name of your Satellite Server or Capsule Server, update the hostname using satellite-change-hostname to avoid networking issues.

13.1. Renaming Satellite Server

The host name of Satellite Server is used by Satellite Server components, all Capsule Servers, and hosts registered to it for communication. This procedure ensures that in addition to renaming Satellite Server, you also update all references to point to the new host name.

Warning

Renaming your Satellite Server host shuts down all Satellite services on that host. The services restart after the renaming is complete.

Prerequisites

  • Back up your Satellite Server before changing its host name. If you fail to successfully rename it, restore it from the backup. For more information, see Chapter 11, Backing up Satellite Server and Capsule Server.
  • Run the hostname and hostname -f commands on Satellite Server. If both commands do not return the FQDN of Satellite Server, the satellite-change-hostname script will fail to complete.

    If the hostname command returns the shortname of Satellite Server instead of the FQDN, use hostnamectl set-hostname My_Old_FQDN to set the old FQDN correctly before using the satellite-change-hostname script.

  • If Satellite Server has a custom SSL certificate installed, obtain a new certificate for the new FQDN of the host. For more information, see Configuring Satellite Server with a Custom SSL Certificate in Installing Satellite Server in a connected network environment.

Procedure

  1. On Satellite Server, run the satellite-change-hostname script, and provide the new host name. Choose one of the following methods:

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

      # satellite-change-hostname new-satellite \
      --username My_Username \
      --password My_Password
    • If your Satellite Server is installed with custom SSL certificates:

      # satellite-change-hostname new-satellite \
      --username My_Username \
      --password My_Password \
      --custom-cert "/root/ownca/test.com/test.com.crt" \
      --custom-key "/root/ownca/test.com/test.com.key"
  2. 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 in a connected network environment.
  3. Reregister all hosts and Capsule Servers that are registered to Satellite Server. For more information, see Registering Hosts in Managing hosts.
  4. On all Capsule Servers, run the Satellite installation script to update references to the new host name:

    # satellite-installer \
    --foreman-proxy-foreman-base-url https://new-satellite.example.com \
    --foreman-proxy-trusted-hosts new-satellite.example.com
  5. On Satellite Server, list all Capsule Servers:

    # hammer capsule list
  6. On Satellite Server, synchronize content for each Capsule Server:

    # hammer capsule content synchronize \
    --id My_capsule_ID
  7. If you use the virt-who agent, update the virt-who configuration files with the new host name. For more information, see Modifying a virt-who Configuration in Configuring virtual machine subscriptions.
  8. If you use external authentication, reconfigure Satellite Server for external authentication after you run the satellite-change-hostname script. For more information, see Configuring External Authentication in Installing Satellite Server in a connected network environment.

13.2. Renaming Capsule Server

The host name of Capsule Server is referenced by Satellite Server components and all hosts registered to it. This procedure ensures that in addition to renaming Capsule Server, you also update all references to the new host name.

Warning

Renaming your Capsule Server host shuts down all Satellite services on that host. The services restart after the renaming is complete.

Prerequisites

  • Back up your Capsule Server before renaming. If you fail to successfully rename it, restore it from the backup. For more information, see Chapter 11, Backing up Satellite Server and Capsule Server.
  • Run the hostname and hostname -f commands on Capsule Server. If both commands do not return the FQDN of Capsule Server, the satellite-change-hostname script will fail to complete.

    If the hostname command returns the shortname of Capsule Server instead of the FQDN, use hostnamectl set-hostname My_Old_FQDN to set the old FQDN correctly before attempting to use the satellite-change-hostname script.

Procedure

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

    • If you are using the default SSL certificate, regenerate the default SSL certificates:

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

      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 your Capsule Server. For more information, see Configuring Capsule Server with a Custom SSL Certificate in Installing Capsule Server.
  2. On your Satellite Server, copy the certificates archive file to your Capsule Server. For example, to copy the archive file to the root user’s home directory:

    # scp /root/new-capsule.example.com-certs.tar root@capsule.example.com:
  3. On your Capsule Server, run the satellite-change-hostname script and provide the host’s new name, Satellite credentials, and certificates archive file name.

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

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

  4. If you have created a custom certificate for your Capsule Server, deploy the certificate to your Capsule Server by entering the satellite-installer command that the capsule-certs-generate command returned in a previous step. For more information, see Deploying a Custom SSL Certificate to Capsule Server in Installing Capsule Server.
  5. On all hosts registered to your Capsule Server, enter the following commands to reinstall the bootstrap RPM, reregister clients, and refresh their subscriptions.

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

    # dnf remove katello-ca-consumer*
    
    # dnf install http://new-capsule.example.com/pub/katello-ca-consumer-latest.noarch.rpm
    
    # subscription-manager register \
    --environment="My_Lifecycle_Environment" \
    --force \
    --org="My_Organization"
    
    # subscription-manager refresh
  6. Update the Capsule host name in the Satellite web UI.

    1. In the Satellite web UI, navigate to Infrastructure > Capsules.
    2. Locate Capsule Server in the list, and click Edit.
    3. Edit the Name and URL fields to match Capsule Server’s new host name, then click Submit.
    4. On your DNS server, add a record for the new hostname of your Capsule Server, and delete the record of the previous host name.
Red Hat logoGithubRedditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

Red Hat을 사용하는 고객은 신뢰할 수 있는 콘텐츠가 포함된 제품과 서비스를 통해 혁신하고 목표를 달성할 수 있습니다.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

© 2024 Red Hat, Inc.