第 12 章 重命名 Satellite 服务器或 Capsule 服务器
要重命名 Satellite 服务器或胶囊服务器,请使用 satellite-change-hostname
脚本。
如果更改 Satellite 服务器或 Capsule 服务器的域名,您必须使用 satellite-change-hostname
脚本更新主机名,以避免网络问题。
12.1. 重命名 Satellite 服务器
Satellite 服务器的主机名供 Satellite 服务器组件、所有胶囊服务器和注册到它的主机用于通信。此流程可确保除了重命名 Satellite 服务器外,您还可以更新所有引用以指向新主机名。
重命名您的 Satellite 服务器主机会关闭该主机上的所有 Satellite 服务。重命名完成后服务会重启。
先决条件
- 在更改其主机名前备份您的 Satellite 服务器。如果您无法成功重命名它,请从备份中恢复。如需更多信息,请参阅 第 10 章 备份 Satellite 服务器和 Capsule 服务器。
在 Satellite 服务器上运行主机名和
hostname
-fsatellite-change-hostname
脚本将无法完成。如果
hostname
命令返回 Satellite 服务器的短名称而不是 FQDN,请在使用satellite-change-hostname
脚本前,使用hostnamectl set-hostname My_Old_FQDN
正确设置旧 FQDN。- 如果 Satellite 服务器安装了自定义 SSL 证书,请为主机的新 FQDN 获取新证书。如需更多信息,请参阅在连接的网络环境中安装 Satellite 服务器 中的 使用自定义 SSL 证书配置 Satellite 服务器。
流程
在服务器上,运行
satellite-change-hostname
脚本,并提供新的主机名。选择以下任一方法:如果您的 Satellite 服务器安装了默认的自签名 SSL 证书:
# satellite-change-hostname new-satellite \ --username My_Username \ --password My_Password
如果您的 Satellite 服务器安装了自定义 SSL 证书:
# 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"
- 如果您已为新的 Satellite 服务器主机名创建了自定义 SSL 证书,请运行 Satellite 安装脚本来安装证书。有关安装自定义 SSL 证书的更多信息,请参阅在连接的网络环境中安装 Satellite 服务器中的将自定义 SSL 证书部署到 Satellite 服务器。
- 重新注册注册到 Satellite 服务器的所有主机和胶囊服务器。如需更多信息, 请参阅管理主机中的注册主机 。
在所有 Capsule 服务器上,运行 Satellite 安装脚本来更新对新主机名的引用:
# satellite-installer \ --foreman-proxy-foreman-base-url https://new-satellite.example.com \ --foreman-proxy-trusted-hosts new-satellite.example.com
在 Satellite 服务器上,列出所有 Capsule 服务器:
# hammer capsule list
在 Satellite 服务器上,同步每个 Capsule 服务器的内容:
# hammer capsule content synchronize \ --id My_capsule_ID
- 如果您使用 virt-who 代理,请使用新主机名更新 virt-who 配置文件。如需更多信息,请参阅配置虚拟机订阅 中的 修改 virt-who 配置。
-
如果使用外部身份验证,请在运行
satellite-change-hostname
脚本后重新配置 Satellite 服务器以进行外部身份验证。如需更多信息,请参阅 在 连接的网络环境中安装 Satellite 服务器 中的 配置 外部身份验证。