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 服务器

  1. 在服务器上,运行 katello-change-hostname 脚本,提供主机的新名称和 Satellite 凭据。
    Copy to Clipboard Toggle word wrap
    # katello-change-hostname new_satellite --username admin \
    --password password
    消息 **** Hostname change complete! **** 确认重命名已成功完成。
  2. (可选)如果您为 Satellite 服务器的新主机名获取一个新的 X.509 证书,请运行 Satellite 安装脚本来安装证书。有关安装自定义 X.509 证书的更多信息,请参阅安装指南中的使用自定义 服务器证书配置 Satellite 服务器
  3. 在注册到 Satellite 服务器的所有胶囊服务器和主机上,重新安装 bootstrap RPM 并将其重新注册到 Satellite 服务器中。将示例 organization 和 environment 值替换为与您环境匹配的值。
    1. Copy to Clipboard Toggle word wrap
      # yum remove -y katello-ca-consumer*
      
    2. Copy to Clipboard Toggle word wrap
      # rpm -Uvh http://new-satellite.example.com/pub/katello-ca-consumer-latest.noarch.rpm
      
    3. Copy to Clipboard Toggle word wrap
      # subscription-manager register --org="Default_Organization" \
      --environment="Library" \
      --force
      
    此步骤建议使用 Red Hat Satellite 远程执行功能。详情请参阅 主机配置指南中的在 Satellite 主机上运行作业。
  4. 将订阅重新附加到注册到 Satellite 服务器的所有胶囊服务器和主机,然后刷新订阅。
    1. Copy to Clipboard Toggle word wrap
      # subscription-manager refresh
      
    2. Copy to Clipboard Toggle word wrap
      # yum repolist
      
    此步骤建议使用 Red Hat Satellite 远程执行功能。详情请参阅 主机配置指南中的在 Satellite 主机上运行作业。
  5. 在所有胶囊服务器上,重新运行 Satellite 安装脚本,以更新对新主机名的引用。
    Copy to Clipboard Toggle word wrap
    # 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. 重命名胶囊服务器

  1. 在服务器上,创建一个新的证书存档文件。
    1. 如果您使用默认的 Satellite 服务器证书:
      Copy to Clipboard Toggle word wrap
      # capsule-certs-generate --capsule-fqdn "new-capsule.example.com" \
      --certs-tar "new-capsule.example.com-certs.tar"
      
    2. 如果您在 Capsule 服务器上使用自定义 X.509 证书,请参阅安装指南中的 创建胶囊服务器的证书存档文件
  2. 在服务器上,将证书存档文件复制到胶囊服务器,并在提示时提供 root 用户的密码。在本例中,存档文件被复制到 root 用户的主目录,但您可能希望将其复制到其他位置。
    Copy to Clipboard Toggle word wrap
    # scp /root/new-capsule.example.com-certs.tar root@capsule.example.com:
    
  3. 在胶囊服务器上,运行 katello-change-hostname 脚本,提供主机的新名称、Satellite 凭据和证书存档文件名。
    Copy to Clipboard Toggle word wrap
    # katello-change-hostname new_capsule --username admin \
    --password password \
    --certs-tar new-capsule.example.com-certs.tar
    消息 **** Hostname change complete! **** 确认重命名已成功完成。
  4. (可选) 如果您在 Capsule 服务器的新主机名中获取了新的 X.509 证书,请运行 Satellite 安装脚本来安装证书。有关安装自定义 X.509 证书的更多信息,请参阅安装指南中的使用自定义 服务器证书配置 Satellite 服务器
  5. 在注册到 Capsule 服务器的所有主机中,重新安装 bootstrap RPM 并将其重新注册到 Capsule 服务器。将示例 organization 和 environment 值替换为与您环境匹配的值。
    1. Copy to Clipboard Toggle word wrap
      # yum remove -y katello-ca-consumer*
      
    2. Copy to Clipboard Toggle word wrap
      # rpm -Uvh http://new-capsule.example.com/pub/katello-ca-consumer-latest.noarch.rpm
      
    3. Copy to Clipboard Toggle word wrap
      # subscription-manager register --org="Default_Organization" \
      --environment="Library" \
      --force
      
    此步骤建议使用 Red Hat Satellite 远程执行功能。详情请参阅 主机配置指南中的在 Satellite 主机上运行作业。
  6. 将订阅重新关联到注册到胶囊服务器的所有主机,然后刷新订阅。
    1. Copy to Clipboard Toggle word wrap
      # subscription-manager refresh
      
    2. Copy to Clipboard Toggle word wrap
      # yum repolist
      
    此步骤建议使用 Red Hat Satellite 远程执行功能。详情请参阅 主机配置指南中的在 Satellite 主机上运行作业。
  7. 编辑胶囊服务器的名称。
    1. 在卫星 Web UI 中,前往 Infrastructure Capsules
    2. 在列表中找到胶囊服务器,再单击此行中的 Edit
    3. 编辑 NameURL 字段,使其与胶囊服务器的新主机名匹配,然后单击 Submit
  8. 在您的 DNS 服务器上,为胶囊服务器的新主机名添加记录,然后删除前一个主机名的记录。
返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

Theme

© 2025 Red Hat, Inc.