将 Red Hat Satellite 升级到 6.14

1. 将 Satellite 服务器升级到 6.14。更多信息请参阅 第 2.1 节 “升级 Satellite 服务器”。
2. 将所有胶囊服务器升级到 6.14。如需更多信息，请参阅 第 2.6 节 “升级 Capsule 服务器”。

1. 如果您希望有多个较小的中断窗口，而不是一个较大的窗口。
2. 如果您的组织中的 Capsules 由多个团队管理，且位于不同的位置。
3. 如果使用负载均衡配置，您可以升级一个负载均衡的 Capsule，并将其他负载均衡的 Capsules 保持较低版本。这可让您在不中断任何中断的情况下，升级所有 Capsules。

升级 Satellite 服务器

1. 停止所有 Satellite 服务：

   # satellite-maintain service stop

2. 创建快照或创建备份：

   • 在虚拟机上，生成快照。
   • 在物理机上，创建备份。

3. 启动所有 Satellite 服务：

   # satellite-maintain service start

4. 可选：如果您手动编辑 /etc/zones.conf 或 /etc/dhcp/dhcpd.conf 文件中的 DNS 或 DHCP 配置，请备份配置文件，因为安装程序只支持一个域或子网，因此可能需要从这些备份中恢复更改。

5. 可选：如果您手动编辑 DNS 或 DHCP 配置文件，且不想覆盖更改，请输入以下命令：

   # satellite-installer --foreman-proxy-dns-managed=false \
   --foreman-proxy-dhcp-managed=false

6. 可选：如果使用 PostgreSQL 作为外部数据库

   1. 在 PostgreSQL 服务器上安装 postgresql-contrib 软件包：

      # dnf install postgresql-contrib

   2. 连接到 Pulp 数据库：

      # su - postgres -c "psql pulpcore"

   3. 创建 hstore 扩展：

      pulpcore=# CREATE EXTENSION IF NOT EXISTS "hstore";
      CREATE EXTENSION

7. 在 Satellite Web UI 中，进入到 Hosts > Discovered hosts。在 Discovered Hosts 页面上，关闭并删除发现的主机。在 Select an Organization 菜单中，选择每个机构，再重复该过程以关闭并删除发现的主机。升级完成后，请注意要重新启动这些主机。

8. 确保启用了 Satellite 维护存储库：

   # subscription-manager repos --enable \
   satellite-maintenance-6.14-for-rhel-8-x86_64-rpms

9. 启用维护模块：

   # dnf module enable satellite-maintenance:el8

10. 检查可用的版本，以确认列出了您想要的版本：

    # satellite-maintain upgrade list-versions

11. 使用健康检查选项来确定系统是否已准备好升级。出现提示时，输入 hammer admin 用户凭证，以使用 hammer 凭证配置 satellite-maintain。这些更改应用于 /etc/foreman-maintain/foreman-maintain-hammer.yml 文件。

    # satellite-maintain upgrade check --target-version 6.14

    检查结果，并在执行升级前解决任何突出显示的错误条件。

12. 由于升级时间较长，请使用 tmux 等工具来挂起并重新附加通信会话。然后，您可以检查升级进度，而不会持续连接到命令 shell。

    如果您丢失了与运行 upgrade 命令的命令 shell 的连接，您可以看到 /var/log/foreman-installer/satellite.log 文件中的日志信息，以检查进程是否已成功完成。

13. 执行升级：

    # satellite-maintain upgrade run --target-version 6.14

14. 确定系统是否需要重启：

    # dnf needs-restarting --reboothint

15. 可选：如果上一个命令告诉您重启，请重启系统：

    # reboot

升级断开连接的 Satellite 服务器

1. 停止所有 Satellite 服务：

   # satellite-maintain service stop

2. 创建快照或创建备份：

   • 在虚拟机上，生成快照。
   • 在物理机上，创建备份。

3. 启动所有 Satellite 服务：

   # satellite-maintain service start

4. 可选：如果您手动编辑 /etc/zones.conf 或 /etc/dhcp/dhcpd.conf 文件中的 DNS 或 DHCP 配置，请备份配置文件，因为安装程序只支持一个域或子网，因此可能需要从这些备份中恢复更改。

5. 可选：如果您手动编辑 DNS 或 DHCP 配置文件，且不想覆盖更改，请输入以下命令：

   # satellite-installer --foreman-proxy-dns-managed=false \
   --foreman-proxy-dhcp-managed=false

6. 可选：如果使用 PostgreSQL 作为外部数据库

   1. 在 PostgreSQL 服务器上安装 postgresql-contrib 软件包：

      # dnf install postgresql-contrib

   2. 连接到 Pulp 数据库：

      # su - postgres -c "psql pulpcore"

   3. 创建 hstore 扩展：

      pulpcore=# CREATE EXTENSION IF NOT EXISTS "hstore";
      CREATE EXTENSION

7. 在 Satellite Web UI 中，进入到 Hosts > Discovered hosts。如果有发现的主机可用，请将其关闭，然后删除 Discovered hosts 页面下的所有条目。依次选择所有其他机构，使用机构设置菜单并根据需要重复此操作。升级完成后重启这些主机。

8. 删除旧的软件仓库：

   # rm /etc/yum.repos.d/*

9. 按照 在断开连接的网络环境中安装 Satellite 服务器中的 下载 Binary DVD 镜像 流程来获取最新的 ISO 文件。

10. 按照 在断开连接的网络环境中安装 Satellite 服务器中的在 RHEL 8 中使用离线存储库配置基本操作系统 流程，创建用作挂载点、挂载 ISO 镜像和配置 rhel8 存储库 的目录。

    不要在此阶段安装或更新任何软件包。

11. 从 ISO 文件配置 Satellite 6.14 存储库。

    1. 为 Red Hat Satellite 软件包复制 ISO 文件的仓库数据文件：

       # cp /media/sat6/Satellite/media.repo /etc/yum.repos.d/satellite.repo

    2. 编辑 /etc/yum.repos.d/satellite.repo 文件：

       # vi /etc/yum.repos.d/satellite.repo

       1. 将默认的 InstallMedia 存储库名称更改为 Satellite-6.14 ：

          [Satellite-6.14]

       2. 添加 baseurl 指令：

          baseurl=file:///media/sat6/Satellite

12. 从 ISO 文件配置 Red Hat Satellite Maintenance 存储库。

    1. 为 Red Hat Satellite 维护软件包复制 ISO 文件的仓库数据文件：

       # cp /media/sat6/Maintenance/media.repo /etc/yum.repos.d/satellite-maintenance.repo

    2. 编辑 /etc/yum.repos.d/satellite-maintenance.repo 文件：

       # vi /etc/yum.repos.d/satellite-maintenance.repo

       1. 将默认的 InstallMedia 存储库名称更改为 Satellite-Maintenance ：

          [Satellite-Maintenance]

       2. 添加 baseurl 指令：

          baseurl=file:///media/sat6/Maintenance/

13. 启用维护模块：

    # dnf module enable satellite-maintenance:el8

14. 由于升级时间较长，请使用 tmux 等工具来挂起并重新附加通信会话。然后，您可以检查升级进度，而不会持续连接到命令 shell。

    如果您丢失了与运行 upgrade 命令的命令 shell 的连接，您可以在 /var/log/foreman-installer/satellite.log 中看到日志，以检查进程是否已成功完成。

15. 检查可用的版本，以确认列出了您想要的版本：

    # satellite-maintain upgrade list-versions

16. 使用健康检查选项来确定系统是否已准备好升级。出现提示时，输入 hammer admin 用户凭证，以使用 hammer 凭证配置 satellite-maintain。这些更改应用于 /etc/foreman-maintain/foreman-maintain-hammer.yml 文件。

    # satellite-maintain upgrade check --target-version 6.14 \
    --whitelist="repositories-validate,repositories-setup"

    检查结果，并在执行升级前解决任何突出显示的错误条件。

17. 执行升级：

    # satellite-maintain upgrade run --target-version 6.14 \
    --whitelist="repositories-validate,repositories-setup"

    如果因为缺少或过时的软件包而导致脚本失败，您必须单独下载并安装它们。如需更多信息，请参阅 在断开连接的网络环境中安装 Satellite 服务器中的解决软件包依赖 错误。

18. 确定系统是否需要重启：

    # dnf needs-restarting --reboothint

19. 可选：如果上一个命令告诉您重启，请重启系统：

    # reboot

20. 可选：如果您手动编辑 DNS 或 DHCP 配置文件，请使用您所做的备份检查并恢复 DNS 和 DHCP 配置文件所需的任何更改。

21. 如果您在上一步中进行更改，重启 Satellite 服务：

    # satellite-maintain service restart

22. 如果您安装了 OpenSCAP 插件，但没有可用的默认 OpenSCAP 内容，请输入以下命令。

    # foreman-rake foreman_openscap:bulk_upload:default

23. 在 Satellite Web UI 中，进入 Configure > Discovery Rules，并将所选机构和位置与发现规则相关联。

流程

1. 在 Satellite Web UI 中，进入到 Content > Red Hat Repositories。
2. 将 Recommended Repositories 切换到 On 位置。

3. 在结果列表中，展开以下软件仓库并点击 Enable 图标启用存储库：

   • 要升级 Satellite 客户端，请为客户端使用的所有 Red Hat Enterprise Linux 版本启用 Red Hat Satellite Client 6 软件仓库。

   • 如果您有 Capsule 服务器，要升级它们，还要启用以下存储库：

     Red Hat Satellite Capsule 6.14 (for RHEL 8 x86_64) (RPMs)

     Red Hat Satellite Maintenance 6.14 (for RHEL 8 x86_64) (RPMs)

     Red Hat Enterprise Linux 8 (for x86_64 - BaseOS) (RPMs)

     Red Hat Enterprise Linux 8 (for x86_64 - AppStream) (RPMs)

   注意

   如果 6.14 存储库不可用，请刷新 Red Hat Subscription Manifest。在 Satellite Web UI 中，进入到 Content > Subscriptions，点 Manage Manifest，然后点 Refresh。

4. 在 Satellite Web UI 中，进入到 Content > Sync Status。
5. 单击产品旁边的箭头，以查看可用的存储库。
6. 为 6.14 选择存储库。请注意，Red Hat Satellite Client 6 没有 6.14 版本。选择 Red Hat Satellite Client 6 替代。

7. 点 Synchronize Now。

   重要

   如果您尝试同步存储库时发生错误，请刷新清单。如果问题仍然存在，请引发支持请求。不要从客户门户网站或 Satellite Web UI 中删除清单；这将删除您的内容主机的所有权利。

8. 如果您使用内容视图来控制对胶囊服务器的基本操作系统的更新，请使用新存储库更新这些内容视图，发布并提升其更新版本。如需更多信息，请参阅管理内容 中的 管理内容视图 。

升级 Capsule 服务器

1. 创建备份。

   • 在虚拟机上，生成快照。

   • 在物理机上，创建备份。

     有关备份的详情，请参考 管理 Red Hat Satellite 中的 备份 Satellite 服务器和 Capsule 服务器。

2. 清理 yum 缓存：

   # yum clean metadata

3. 同步 Satellite -capsule-6.14-for-rhel-8-x86_64-rpms 存储库。
4. 发布并提升胶囊注册到的内容视图的新版本。

5. rubygem-foreman_maintain 从 Satellite 维护存储库安装，或者从 Satellite Maintenance 存储库（如果当前安装）升级。

   确保 Capsule 有权访问 satellite-maintenance-6.14-for-rhel-8-x86_64-rpms 并执行：

   # satellite-maintain self-upgrade

6. 在 Capsule 服务器上，验证 foreman_url 设置是否指向 Satellite FQDN：

   # grep foreman_url /etc/foreman-proxy/settings.yml

7. 检查可用的版本，以确认列出了您想要的版本：

   # satellite-maintain upgrade list-versions

8. 由于升级时间较长，请使用 tmux 等工具来挂起并重新附加通信会话。然后，您可以检查升级进度，而不会持续连接到命令 shell。

   如果您丢失了与运行 upgrade 命令的命令 shell 的连接，您可以看到 /var/log/foreman-installer/capsule.log 文件中的日志信息，以检查进程是否已成功完成。

9. 使用健康检查选项来确定系统是否已准备好升级：

   # satellite-maintain upgrade check --target-version 6.14

   检查结果，并在执行升级前解决任何突出显示的错误条件。

10. 执行升级：

    # satellite-maintain upgrade run --target-version 6.14

11. 确定系统是否需要重启：

    # dnf needs-restarting --reboothint

12. 可选：如果上一个命令告诉您重启，请重启系统：

    # reboot

13. 可选：如果您手动编辑 DNS 或 DHCP 配置文件，请检查并恢复之前进行的 DNS 和 DHCP 配置文件所需的任何更改。
14. 可选：如果您使用自定义软件仓库，请确保在升级完成后启用这些自定义软件仓库。

使用远程执行升级 Capsule 服务器

1. 创建备份或创建快照。

   有关备份的更多信息，请参阅 管理 Red Hat Satellite 中的 备份 Satellite 服务器和 Capsule 服务器。

2. 在 Satellite Web UI 中，进入到 Monitor > Jobs。
3. 单击 Run Job。
4. 从 Job category 列表中，选择 Maintenance Operations。
5. 从 Job template 列表中，选择 Capsule Upgrade Playbook。
6. 在 Search Query 字段中，输入 Capsule 的主机名。
7. 确保在 Resolves to 字段中显示 Apply to 1 主机。
8. 在 target_version 字段中，输入 Capsule 的目标版本。
9. 在 whitelist_options 字段中，输入选项。
10. 在 Schedule 中，选择作业执行的计划。
11. 在 查询部分的 Type 中，点 Static Query。

流程

1. 创建备份。
2. 在新服务器上恢复备份。

3. 如果 Satellite 通过旧名称到达新的数据库服务器，则不需要进行进一步的更改。否则，重新配置 Satellite 以使用新名称：

   # satellite-installer \
   --foreman-db-host newpostgres.example.com \
   --katello-candlepin-db-host newpostgres.example.com \
   --foreman-proxy-content-pulpcore-postgresql-host newpostgres.example.com