第 12 章 重命名 Satellite Server 或 Capsule Server

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

重要

在更改 Satellite 服务器或 Capsule 服务器的域名时,使用 satellite-change-hostname 更新主机名,以避免网络问题。

12.1. 重命名卫星服务器

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

警告

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

先决条件

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

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

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

流程

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

    • 如果您的 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"
  2. 如果您已经为新的 Satellite 服务器主机名创建了自定义 SSL 证书,请运行 Satellite 安装脚本来安装证书。有关安装自定义 SSL 证书的更多信息,请参阅 在连接的网络环境中安装 Satellite 服务器 中的 向 Satellite 服务器部署自定义 SSL 证书
  3. 重新注册所有 Satellite 主机。如需更多信息,请参阅 管理主机 中的 注册主机
  4. 在所有胶囊服务器中,运行 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 https://new-satellite.example.com
  5. 在卫星服务器上,列出所有胶囊服务器:

    # hammer capsule list
  6. 在卫星服务器上,同步每个胶囊服务器的内容:

    # hammer capsule content synchronize \
    --id My_capsule_ID
  7. 如果使用 virt-who 代理,请使用新的主机名更新 virt-who 配置文件。如需更多信息,请参阅在 Red Hat Satellite 中配置虚拟机订阅中的 修改 virt-who 配置
  8. 如果使用外部身份验证,请在运行 satellite-change-hostname 脚本后重新配置 Satellite 服务器以进行外部身份验证。如需更多信息,请参阅 在连接的网络环境中安装 Satellite 服务器中的 配置 外部身份验证。