第 10 章 重命名 Satellite Server 或 Capsule Server
若要重命名卫星服务器或胶囊服务器,您必须使用 satellite-change-hostname
脚本。
如果重命名了卫星服务器,您必须重新注册所有 Satellite 客户端,并将每个胶囊服务器配置为指向新的 Satellite 主机名。如果您使用自定义 SSL 证书,则必须使用新主机名重新生成它们。如果使用 virt-who,您必须更新具有新主机名的 virt-who 配置文件。
如果重命名了胶囊服务器,您必须重新注册所有胶囊客户端,并在卫星 Web UI 中更新胶囊主机名。如果您使用自定义 SSL 证书,则必须使用新主机名重新生成它们。
重命名过程将关闭要重命名的主机上的所有卫星服务器服务。重命名完成后,所有服务都会重启。
10.1. 重命名卫星服务器
卫星服务器的主机名供卫星服务器组件、所有胶囊服务器以及注册给它通信的主机使用。此流程确保您更新新主机名的所有引用。
如果使用外部身份验证,您必须在运行 satellite-change-hostname
脚本后重新配置卫星服务器以进行外部身份验证。satellite-change-hostname
脚本会破坏卫星服务器的外部身份验证。有关配置外部验证的详情,请参考 第 13 章 配置外部身份验证。
如果使用 virt-who,您必须在运行 satellite-change-hostname
脚本后更新带有新主机名的 virt-who 配置文件。如需更多信息,请参阅在 Red Hat Satellite 中配置虚拟机订阅中的 修改 virt-who 配置 。
先决条件
-
hostname
和hostname -f
命令必须返回 Satellite Server 的 FQDN 或satellite-change-hostname
脚本将无法完成。如果hostname
命令返回 Satellite Server 的短名称,则使用hostnamectl set-hostname old_fqdn
在尝试使用satellite-change-hostname
脚本前正确设置旧 FQDN。 - 在更改主机名前,执行卫星服务器的备份。如果重命名过程不成功,您必须从备份中恢复它。更多信息请参阅 第 8 章 备份 Satellite 服务器和胶囊服务器。
- 可选:如果卫星服务器安装了自定义 SSL 证书,则必须为主机的新名称获取新证书。如需更多信息,请参阅 从连接的网络安装卫星服务器中的使用自定义 SSL 证书配置 Satellite 服务器。
流程
在卫星服务器上,选择运行
satellite-change-hostname
脚本的适当方法,提供新的主机名和 Satellite 凭证:如果您的 Satellite 服务器安装有默认自签名 SSL 证书,请输入以下命令:
# satellite-change-hostname new-satellite \ --username admin \ --password password
如果您的 Satellite 服务器使用自定义 SSL 证书安装:
# 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"
- 可选:如果您为新的 Satellite 服务器主机名创建了自定义 SSL 证书,请运行 Satellite 安装脚本来安装证书。有关安装自定义 SSL 证书的更多信息,请参阅 从连接的网络安装卫星服务器中的部署自定义 SSL 证书 到卫星服务器。
在所有 Satellite 客户端上,输入以下命令重新安装 bootstrap RPM、重新注册客户端并刷新其订阅。
您可以使用远程执行功能来执行此步骤。如需更多信息,请参阅 管理主机中的配置和设置远程作业 。
# 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
在所有胶囊服务器中,运行 Satellite 安装脚本来更新对新主机名的引用:
# satellite-installer \ --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
在卫星服务器上,列出所有胶囊服务器:
# hammer capsule list
在卫星服务器上,同步每个胶囊服务器的内容:
# hammer capsule content synchronize \ --id capsule_id_number