第 13 章 重命名 Satellite 服务器或 Capsule 服务器


要重命名 Satellite 服务器或胶囊服务器,请使用 satellite-change-hostname 脚本。

重要

如果更改 Satellite 服务器或 Capsule 服务器的域名,您必须使用 satellite-change-hostname 脚本更新主机名,以避免网络问题。

13.1. 重命名 Satellite 服务器

Satellite 服务器的主机名供 Satellite 服务器组件、所有胶囊服务器和注册到它的主机用于通信。此流程可确保除了重命名 Satellite 服务器外,您还可以更新所有引用以指向新主机名。

警告

重命名您的 Satellite 服务器主机会关闭该主机上的所有 Satellite 服务。重命名完成后服务会重启。

先决条件

  • 在更改其主机名前备份您的 Satellite 服务器。如果您无法成功重命名它,请从备份中恢复。如需更多信息,请参阅 第 11 章 备份 Satellite 服务器和 Capsule 服务器
  • 在 Satellite 服务器上运行主机名和 hostname -f 命令。如果这两个命令都没有返回 Satellite 服务器的 FQDN,satellite-change-hostname 脚本将无法完成。

    如果 hostname 命令返回 Satellite 服务器的短名称而不是 FQDN,请在使用 satellite-change-hostname 脚本前,使用 hostnamectl set-hostname My_Old_FQDN 正确设置旧 FQDN。

  • 如果 Satellite 服务器安装了自定义 SSL 证书,请为主机的新 FQDN 获取新证书。如需更多信息,请参阅在连接的网络环境中安装 Satellite 服务器 中的 使用自定义 SSL 证书配置 Satellite 服务器

流程

  1. 在服务器上,运行 satellite-change-hostname 脚本,并提供新的主机名。选择以下任一方法:

    • 如果您的 Satellite 服务器安装了默认的自签名 SSL 证书:

      # satellite-change-hostname new-satellite \
      --username My_Username \
      --password 'My_Password'
      Copy to Clipboard Toggle word wrap
    • 如果您的 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"
      Copy to Clipboard Toggle word wrap
  2. 如果您已为新的 Satellite 服务器主机名创建了自定义 SSL 证书,请运行 Satellite 安装脚本来安装证书。有关安装自定义 SSL 证书的更多信息,请参阅在连接的网络环境中安装 Satellite 服务器中的将自定义 SSL 证书部署到 Satellite 服务器
  3. 重新注册注册到 Satellite 服务器的所有主机和胶囊服务器。如需更多信息,请参阅 管理主机 中的 使用全局注册注册主机
  4. 在所有 Capsule 服务器上,运行 Satellite 安装脚本来更新对新主机名的引用:

    # satellite-installer \
    --foreman-proxy-foreman-base-url https://new-satellite.example.com \
    --foreman-proxy-trusted-hosts new-satellite.example.com
    Copy to Clipboard Toggle word wrap
  5. 在 Satellite 服务器上,列出所有 Capsule 服务器:

    # hammer capsule list
    Copy to Clipboard Toggle word wrap
  6. 在 Satellite 服务器上,同步每个 Capsule 服务器的内容:

    # hammer capsule content synchronize \
    --id My_Capsule_ID
    Copy to Clipboard Toggle word wrap
  7. 如果您使用 virt-who 代理,请使用新主机名更新 virt-who 配置文件。如需更多信息,请参阅 为虚拟机订阅 配置 virt-who 中的 修改 virt-who 配置
  8. 如果使用外部身份验证,请在运行 satellite-change-hostname 脚本后重新配置 Satellite 服务器以进行外部身份验证。如需更多信息,请参阅为 Red Hat Satellite 用户配置身份验证
返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

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

让开源更具包容性

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

關於紅帽

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

Theme

© 2025 Red Hat