5.4. 重命名 Satellite 服务器或 Capsule 服务器
重命名 Satellite 服务器或胶囊服务器需要使用 katello-change-hostname 脚本。Red Hat Satellite 包含对主机名的引用,这些更改则通过 脚本进行。重命名 Satellite 服务器会影响自身、所有胶囊服务器以及注册到它的所有主机。重命名胶囊服务器会影响其自身和对其注册的所有主机。
警告
重命名过程会关闭被重命名的主机上的所有 Satellite 服务器服务。重命名完成后,所有服务都会重启。
警告
在运行 katello-change-hostname 脚本前,不要更改 Satellite 服务器的系统主机名。如果在运行此脚本前更改了系统主机名,在搜索旧主机名时脚本将失败。
5.4.1. 重命名 Satellite 服务器
Satellite 服务器的主机名供 Satellite 服务器组件、所有胶囊服务器和注册到它的主机用于通信。重命名 Satellite 服务器需要更新这些引用。
先决条件
- (可选)如果 Satellite 服务器安装了自定义 X.509 证书,则必须在主机的新名称中获取新证书。当所有主机重新注册到 Satellite 服务器时,会安装新证书。有关获取自定义 X.509 证书的更多信息,请参阅安装指南中的使用自定义 服务器证书配置 Satellite 服务器。
- 在运行 katello-change-hostname 脚本前,请确保系统主机名尚未更改。如果系统主机名已更改,则必须使用 hostnamectl set-hostname 命令将其恢复到原始主机名。
- 备份 Satellite 服务器。katello-change-hostname 脚本会更改 Satellite 服务器。如果重命名过程不成功,则必须从备份中恢复它。如需更多信息,请参阅 第 5 章 备份和恢复。
过程 5.8. 重命名 Satellite 服务器
- 在服务器上,运行 katello-change-hostname 脚本,提供主机的新名称和 Satellite 凭据。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow katello-change-hostname new_satellite --username admin \ --password password
# katello-change-hostname new_satellite --username admin \ --password password
消息**** Hostname change complete! ****
确认重命名已成功完成。 - (可选)如果您为 Satellite 服务器的新主机名获取一个新的 X.509 证书,请运行 Satellite 安装脚本来安装证书。有关安装自定义 X.509 证书的更多信息,请参阅安装指南中的使用自定义 服务器证书配置 Satellite 服务器。
- 在注册到 Satellite 服务器的所有胶囊服务器和主机上,重新安装 bootstrap RPM 并将其重新注册到 Satellite 服务器中。将示例 organization 和 environment 值替换为与您环境匹配的值。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow yum remove -y katello-ca-consumer*
# yum remove -y katello-ca-consumer*
Copy to Clipboard Copied! Toggle word wrap Toggle overflow rpm -Uvh http://new-satellite.example.com/pub/katello-ca-consumer-latest.noarch.rpm
# rpm -Uvh http://new-satellite.example.com/pub/katello-ca-consumer-latest.noarch.rpm
Copy to Clipboard Copied! Toggle word wrap Toggle overflow subscription-manager register --org="Default_Organization" \ --environment="Library" \ --force
# subscription-manager register --org="Default_Organization" \ --environment="Library" \ --force
此步骤建议使用 Red Hat Satellite 远程执行功能。详情请参阅 主机配置指南中的在 Satellite 主机上运行作业。 - 将订阅重新附加到注册到 Satellite 服务器的所有胶囊服务器和主机,然后刷新订阅。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow subscription-manager refresh
# subscription-manager refresh
Copy to Clipboard Copied! Toggle word wrap Toggle overflow yum repolist
# yum repolist
此步骤建议使用 Red Hat Satellite 远程执行功能。详情请参阅 主机配置指南中的在 Satellite 主机上运行作业。 - 在所有胶囊服务器上,重新运行 Satellite 安装脚本,以更新对新主机名的引用。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow satellite-installer --capsule-parent-fqdn new-satellite.example.com \ --foreman-proxy-foreman-base-url https://new-satellite.example.com \ --foreman-proxy-trusted-hosts new-satellite.example.com
# satellite-installer --capsule-parent-fqdn new-satellite.example.com \ --foreman-proxy-foreman-base-url https://new-satellite.example.com \ --foreman-proxy-trusted-hosts new-satellite.example.com
5.4.2. 重命名胶囊服务器
胶囊服务器的主机名由 Satellite 服务器组件引用,并且所有主机都注册到其中。重命名胶囊服务器需要更新这些引用。
先决条件
- (可选) Capsule 服务器的新 X.509 自定义证书文件。有关获取自定义 X.509 证书的更多信息,请参阅安装指南中的使用自定义 服务器证书配置 Capsule 服务器。
- 备份胶囊服务器。katello-change-hostname 脚本对胶囊服务器进行不可逆的更改。如果重命名过程不成功,则必须从备份中恢复它。Red Hat Satellite 不为胶囊服务器提供原生备份方法。如需更多信息,请参阅 第 5 章 备份和恢复。
过程 5.9. 重命名胶囊服务器
- 在服务器上,创建一个新的证书存档文件。
- 如果您使用默认的 Satellite 服务器证书:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow capsule-certs-generate --capsule-fqdn "new-capsule.example.com" \ --certs-tar "new-capsule.example.com-certs.tar"
# capsule-certs-generate --capsule-fqdn "new-capsule.example.com" \ --certs-tar "new-capsule.example.com-certs.tar"
- 如果您在 Capsule 服务器上使用自定义 X.509 证书,请参阅安装指南中的 创建胶囊服务器的证书存档文件。
- 在服务器上,将证书存档文件复制到胶囊服务器,并在提示时提供
root
用户的密码。在本例中,存档文件被复制到root
用户的主目录,但您可能希望将其复制到其他位置。Copy to Clipboard Copied! Toggle word wrap Toggle overflow scp /root/new-capsule.example.com-certs.tar root@capsule.example.com:
# scp /root/new-capsule.example.com-certs.tar root@capsule.example.com:
- 在胶囊服务器上,运行 katello-change-hostname 脚本,提供主机的新名称、Satellite 凭据和证书存档文件名。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow katello-change-hostname new_capsule --username admin \ --password password \ --certs-tar new-capsule.example.com-certs.tar
# katello-change-hostname new_capsule --username admin \ --password password \ --certs-tar new-capsule.example.com-certs.tar
消息**** Hostname change complete! ****
确认重命名已成功完成。 - (可选) 如果您在 Capsule 服务器的新主机名中获取了新的 X.509 证书,请运行 Satellite 安装脚本来安装证书。有关安装自定义 X.509 证书的更多信息,请参阅安装指南中的使用自定义 服务器证书配置 Satellite 服务器。
- 在注册到 Capsule 服务器的所有主机中,重新安装 bootstrap RPM 并将其重新注册到 Capsule 服务器。将示例 organization 和 environment 值替换为与您环境匹配的值。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow yum remove -y katello-ca-consumer*
# yum remove -y katello-ca-consumer*
Copy to Clipboard Copied! Toggle word wrap Toggle overflow rpm -Uvh http://new-capsule.example.com/pub/katello-ca-consumer-latest.noarch.rpm
# rpm -Uvh http://new-capsule.example.com/pub/katello-ca-consumer-latest.noarch.rpm
Copy to Clipboard Copied! Toggle word wrap Toggle overflow subscription-manager register --org="Default_Organization" \ --environment="Library" \ --force
# subscription-manager register --org="Default_Organization" \ --environment="Library" \ --force
此步骤建议使用 Red Hat Satellite 远程执行功能。详情请参阅 主机配置指南中的在 Satellite 主机上运行作业。 - 将订阅重新关联到注册到胶囊服务器的所有主机,然后刷新订阅。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow subscription-manager refresh
# subscription-manager refresh
Copy to Clipboard Copied! Toggle word wrap Toggle overflow yum repolist
# yum repolist
此步骤建议使用 Red Hat Satellite 远程执行功能。详情请参阅 主机配置指南中的在 Satellite 主机上运行作业。 - 编辑胶囊服务器的名称。
- 在卫星 Web UI 中,前往
。 - 在列表中找到胶囊服务器,再单击此行中的。
- 编辑 Name 和 URL 字段,使其与胶囊服务器的新主机名匹配,然后单击 。
- 在您的 DNS 服务器上,为胶囊服务器的新主机名添加记录,然后删除前一个主机名的记录。