跳至主要內容

从 RHEL 9 升级到 RHEL 10

大约 38 分钟

从 RHEL 9 升级到 RHEL 10

来源：官方文档 原始多页入口：从 RHEL 9 升级到 RHEL 10 内容规模：约 41,256 字符，33 个章节标题，67 个命令/代码块，33 条提示框

阅读提要

  • 副标题：从 Red Hat Enterprise Linux 9 原位升级到 Red Hat Enterprise Linux 10 的说明
  • 摘要：RHEL 原位升级使用 Leapp 工具从 Red Hat Enterprise Linux 9 升级到 Red Hat Enterprise Linux 10。在原位升级过程中，现有的 RHEL 9 操作系统将被 RHEL 10 版本替代。
  • 主要章节：从 Red Hat Enterprise Linux 9 原位升级到 Red Hat Enterprise Linux 10 的说明；对红帽文档提供反馈；主要迁移术语；第 1 章 支持的升级路径；第 2 章 计划到 RHEL 10 的升级；第 3 章 准备升级；第 4 章 查看升级前报告；第 5 章 执行升级；第 6 章 验证升级后状态；第 7 章 在 RHEL 10 系统上执行升级后任务；第 8 章 应用安全策略；第 9 章 故障排除
  • 推荐阅读顺序：先看“阅读提要”和目录，再按章节查看“关键点/命令/注意”；需要原文细节时点击来源链接。

章节笔记

概览

  • 该章节主要为下一级主题的入口。

从 Red Hat Enterprise Linux 9 原位升级到 Red Hat Enterprise Linux 10 的说明

  • 要点：摘要

对红帽文档提供反馈

  • 要点：我们感谢您对我们文档的反馈。让我们了解如何改进它。
  • 要点：通过 Jira 提交反馈（需要帐户）
  • 列表：登录到 Jira 网站。
  • 列表：在顶部导航栏中点 Create
  • 列表：在 Summary 字段中输入描述性标题。
  • 列表：在 Description 字段中输入您对改进的建议。包括文档相关部分的链接。
  • 列表：点对话框底部的 Create。

主要迁移术语

  • 要点：尽管以下与迁移相关的术语在软件业中常用，但这里的定义特定于 Red Hat Enterprise Linux (RHEL)。
  • 要点：Update（更新）
  • 列表：原位升级（In-place upgrade）：在原位升级过程中，您可以在不先删除旧版本的情况下将旧版本替换为新版本。安装的应用程序和实用程序，以及相关的配置和首选项都会融合到新版本中。
  • 列表：全新安装（Clean install）：干净安装会删除之前安装的操作系统、系统数据、配置和应用程序的所有数据，并安装最新版本的操作系统。如果您不需要之前的数据或应用程序，或者您要部署的新项目不依赖于以前的构建，则全新安装是一个理想的选择。
  • 列表：迁移到 RHEL：将现有操作系统转换到 RHEL
  • 列表：跨 RHEL 迁移：从一个 RHEL 升级到另一个版本

第 1 章 支持的升级路径

  • 要点：原位升级使用 RHEL 10 版本替换系统上的 RHEL 9 操作系统。
  • 要点：目前，您可以执行从以下源 RHEL 9 次版本到以下目标 RHEL 10 次版本的原位升级：
  • 列表：支持的 Red Hat Enterprise Linux 原位升级路径
  • 列表：原位升级支持策略
  • 列表：使用 Leapp 进行多个 RHEL 主版本的原位升级
  • 注意：重要 您可以只执行一个从主 RHEL 版本到下一个连续版本的原位升级，例如：从 RHEL 8 升级到 RHEL 9，或从 RHEL 9 升级到 RHEL 10。如果要跨多个版本（如从 RHEL 8 升级到 RHEL 10）升级系统，您必须执行多个原位升级，才能达到您的目标版本。
  • 注意：重要 这个表中的原位升级路径只对使用 Red Hat Subscription Manager (RHSM)的系统保证。对于使用 Red Hat Update Infrastructure (RHUI)的 Pay-As-You-Go (PAYG) RHEL 系统，只支持最新的可用升级路径。请注意，这不会影响安装了 SAP HANA 的 RHEL 系统。
  • 表格样本（共 3 行）：
    • 系统配置 | 源操作系统版本 | 目标操作系统版本
    • RHEL | RHEL 9.6 | RHEL 10.0 (EUS)
    • RHEL | RHEL 9.7 | RHEL 10.1

第 2 章 计划到 RHEL 10 的升级

  • 要点：原位升级允许您在不丢失现有配置和系统订阅的情况下升级到最新版本的 RHEL。通常，与全新 RHEL 安装相比，原位升级的成本要低得多。但是，并非所有系统都有资格进行原位升级。在开始从 RHEL 9 升级到 RHEL 10 之前，请查看系统要求、限制和其他注意事项。

2.1. 规划从 RHEL 9 到 RHEL 10 的升级

  • 要点：原位升级(in-place upgrade)是把系统升级到下一个主要 RHEL 版本的推荐并支持的方法。
  • 要点：升级到 RHEL 10 之前，请考虑以下几点：
  • 列表：应用程序 - 您可以使用 Leapp 工具迁移安装在系统上的应用程序。然而，在某些情况下，您必须创建自定义操作程序，它指定要在升级过程中 Leapp 要执行的操作，例如重新配置应用程序或安装特定的硬件驱动程序。如需更多信息，请参阅处理自定义应用程序和第三方应用程序的迁移。请注意，红帽不支持 custom actor。 重要 SHA-1 算法在 RHEL 9 中已弃用。如果您的系统具有 RSA/SHA-1 签名的任何软件包，则升级会被禁止。在升级前，删除这些软件包或联系具有 RSA/SHA-256 签名的软件包的厂商。如需更多信息，请参阅 Red Hat Enterprise Linux 9 中的 SHA-1 弃用。
  • 列表：引导装载程序 - 您不能在 RHEL 9 或 RHEL 10 中将引导装载程序从 BIOS 切换到 UEFI。如果您的 RHEL 9 系统使用 BIOS，而您希望 RHEL 10 系统使用 UEFI，请执行全新的 RHEL 9 安装，而不是原位升级。如需更多信息，请参阅 是否可以在预安装的 Red Hat Enterprise Linux 机器上将 BIOS 引导切换到 UEFI 引导？
  • 列表：自定义 - 要使用自定义存储库，请参阅 配置自定义存储库 知识库文章。
  • 列表：停机时间 — 升级过程可能会需要几分钟到几小时。
  • 列表：高可用性 - 如果您使用高可用性附加组件，请按照 对 RHEL 高可用性或弹性存储集群应用软件升级的推荐的实践 知识库文章。
  • 列表：语言 - 无论语言配置如何，所有 Leapp 报告、日志和其他生成的文档均为英语。
  • 注意：重要 SHA-1 算法在 RHEL 9 中已弃用。如果您的系统具有 RSA/SHA-1 签名的任何软件包，则升级会被禁止。在升级前，删除这些软件包或联系具有 RSA/SHA-256 签名的软件包的厂商。如需更多信息，请参阅 Red Hat Enterprise Linux 9 中的 SHA-1 弃用。
  • 注意：重要 对于 64 位 ARM 架构，只有运行 4k 页大小内核的系统上才支持原位升级。如果系统使用 64k 页大小内核引导，Leapp 不支持原位升级。

第 3 章 准备升级

  • 要点：要防止升级后出现问题，并确保您的系统已准备好升级到 RHEL 的下一个主要版本，请在升级前完成所有必要的准备步骤。
  • 要点：您必须在所有系统上执行 为升级准备一个 RHEL 9 系统 中描述的准备步骤。此外，在注册到 Satellite 服务器的系统上，您还必须执行 为升级准备一个注册了 Satellite 的系统 中描述的准备步骤。

3.1. 为升级准备一个 RHEL 9 系统

  • 要点：在原位升级到 RHEL 10 前，您必须安装与升级相关的文件，并为升级准备系统。跳过这些所需步骤可能会导致升级过程中出现严重的问题。
  • 要点：如果您不计划在升级过程中使用 Red Hat Subscription Manager (RHSM)，请参阅 不使用 Red Hat Subscription Manager 执行原位升级 中的说明。
  • 列表：系统满足 计划升级 中列出的条件。
  • 列表：如果系统之前已从 RHEL 8 升级到 RHEL 9，请确保所有必要的升级后步骤都已完成。如需更多信息，请参阅从 RHEL 8 升级到 RHEL 9 指南中的 执行升级后的任务。
  • 列表：可选：您已参阅了 使用 Leapp 执行 RHEL 升级的最佳实践和建议 知识库文章中的最佳实践。
  • 列表：您确保您的系统已成功使用 RHSM 注册到 Red Hat Content Delivery Network (CDN)或 Red Hat Satellite。
  • 列表：仅注册了 Satellite 的系统：您已完成了 为升级准备一个 Satellite 系统 中的步骤，以确保您的系统满足升级要求。
  • 列表：可选：卸载升级不需要的非系统操作系统文件系统，并从 /etc/fstab 文件中注释掉它们。例如，这包括只包含与系统本身不相关的数据文件的文件系统。这可减少升级过程所需的时间，并防止与自定义或第三方参与者在升级过程中未正确迁移的第三方应用程序相关的潜在问题。
  • 命令/配置摘录：
# subscription-manager status +-------------------------------------------+  System Status Details +-------------------------------------------+ Overall Status: Disabled Content Access Mode is set to Simple Content Access. This host has access to content, regardless of subscription status. System Purpose Status: Disabled
# subscription-manager repos --enable rhel-9-for-x86_64-baseos-rpms --enable rhel-9-for-x86_64-appstream-rpms
  • 注意：注意 可选：启用 CodeReady Linux Builder （也称为可选的）或补充存储库。有关这些存储库的内容的更多信息，请参阅 软件包清单。
  • 注意：重要 如果系统上没有提供 rhui-set-release 命令，您可以通过更新 /etc/dnf/vars/release 文件来设置期望的系统发行版本： # echo "9.7" > /etc/dnf/vars/releasever

3.2. 为升级准备注册了 Satellite 的系统

  • 要点：在您可以对注册到 Satellite 的系统执行 RHEL 10 的原位升级前，您必须准备您的系统。执行以下步骤在 Satellite 服务器上执行。
  • 要点：先决条件
  • 列表：您有对 Satellite 服务器的管理特权。
  • 列表：Satellite 是一个处于完全或维护支持的版本。如需更多信息，请参阅 Red Hat Satellite 产品生命周期 和 哪些 RHEL 版本和架构作为由 Red Hat Satellite 服务器管理的客户端系统被支持？
  • 列表：将带有 RHEL 9 存储库的订阅清单导入到 Satellite 服务器。如需更多信息，请参阅特定版本的 Red Hat Satellite 的管理内容指南中的管理红帽订阅一章。
  • 列表：使用源和目标操作系统版本的最新更新在 Satellite 服务器上启用并同步所有所需的 RHEL 9 和 RHEL 10 存储库。所需的存储库必须在内容视图中可用，并在关联的激活密钥中启用。 注意 对于 RHEL 10 存储库，启用每个存储库的目标操作系统版本，如 RHEL 10.0。如果您只启用存储库的 RHEL 10 版本，则会禁止原位升级。 例如，对于没有延长更新支持（EUS）订阅的 Intel 构架，至少启用以下软件仓库： Red Hat Enterprise Linux 9 for x86_64 - AppStream (RPMs) rhel-9-for-x86_64-appstream-rpms x86_64 <sou…
  • 列表：Red Hat Enterprise Linux 9 for x86_64 - AppStream (RPMs) rhel-9-for-x86_64-appstream-rpms x86_64 <source_os_version>
  • 列表：Red Hat Enterprise Linux 9 for x86_64 - BaseOS (RPMs) rhel-9-for-x86_64-baseos-rpms x86_64 <source_os_version>
  • 命令/配置摘录：
# hammer repository list --search 'content_label ~ rhel-9' --content-view <content_view_name> --organization <organization> --lifecycle-environment <lifecycle_environment> # hammer repository list --search 'content_label ~ rhel-10' --content-view <content_view_name> --organization <organization> --lifecycle-environment <lifecycle_environment>
# subscription-manager repos --list-enabled | grep "^Repo ID" Repo ID: rhel-9-for-x86_64-baseos-rpms Repo ID: rhel-9-for-x86_64-appstream-rpms
  • 注意：重要 Satellite 系统上的用户必须完成此流程和 为升级准备一个 RHEL 9 系统 中描述的步骤。
  • 注意：注意 对于 RHEL 10 存储库，启用每个存储库的目标操作系统版本，如 RHEL 10.0。如果您只启用存储库的 RHEL 10 版本，则会禁止原位升级。

3.3. 使用 LiveMode 配置从 RHEL 9.7 升级到 RHEL 10.1

  • 要点：LiveMode 是当从 RHEL 9.7 升级到 64 位 Intel 架构上的 RHEL 10.1 时准备和引导到升级环境的替代方法。LiveMode 使用标准引导过程。标准引导过程可能会阻止或帮助诊断升级过程中发生的某些问题，比如与存储初始化相关的问题。请注意，LiveMode 需要大约 700 MB 的额外磁盘空间，以便在重启前创建和存储升级环境。
  • 要点：使用 LiveMode 时，您还可以配置超过默认规格的升级体验。这在在升级过程中进行故障排除或者您要使用 SSH 连接查看升级进度时很有用。
  • 列表：如果要修改 LiveMode 的默认规格，请在 /etc/leapp/actor_conf.d/ 文件中创建一个 YAML 文件，如 livemode.yaml。
  • 列表：在 YAML 文件中输入所需的 LiveMode 配置。 Expand 表 3.1. LiveMode 配置 配置字段 值类型 default 描述 additional_packages List[str] [] 要安装到升级镜像中的其他软件包。 autostart_upgrade_after_reboot bool True 如果设置为 True，则升级重启后会自动启动。否则，需要手动触发器。 capture_strace_info_into str '' 如果设置为非空字符串，则 leapp 会在 strace 下执行，结果存储在提供的文件路径中。 dracut_network str…
  • 列表：Leapp 实用程序将 vim 软件包安装到升级环境中。
  • 列表：升级不会在重启后自动启动。您必须手动重启它。这可让您手动检查系统，并验证升级是否如预期完成，并在启动前系统已准备好使用。
  • 列表：Leapp 工具尝试使用源系统的网络配置集在升级环境中启用 NetworkManager。
  • 列表：Leapp 工具启用 opensshd 服务。如果系统成功建立网络访问，您可以使用 SSH 使用 root 帐户登录到升级环境，并与系统交互。
  • 命令/配置摘录：
livemode:  additional_packages : [ vim ]  autostart_upgrade_after_reboot : false  setup_network_manager : true  setup_opensshd_using_auth_keys : /root/.ssh/authorized_keys
  • 注意：重要 LiveMode 只是一个技术预览功能。技术预览功能不受红帽产品服务等级协议（SLA）支持，且功能可能并不完整。红帽不推荐在生产环境中使用它们。这些技术预览功能可以使用户提早试用新的功能，并有机会在开发阶段提供反馈意见。 有关红帽技术预览功能支持范围的更多信息，请参阅技术预览功能支持范围。
  • 表格样本（共 10 行）：
    • 配置字段 | 值类型 | default | 描述
    • additional_packages | List[str] | [] | 要安装到升级镜像中的其他软件包。
    • autostart_upgrade_after_reboot | bool | True | 如果设置为 True，则升级重启后会自动启动。否则，需要手动触发器。
    • capture_strace_info_into | str | '' | 如果设置为非空字符串，则 leapp 会在 strace 下执行，结果存储在提供的文件路径中。

第 4 章 查看升级前报告

  • 要点：要评估系统的可升级性，请使用 leapp preupgrade 命令启动预升级过程。在这个阶段中，Leapp 工具收集有关系统的数据，评估可升级性，并生成一个预升级报告。

4.1. 关于预升级报告

  • 要点：预升级报告总结了潜在的问题，并建议推荐的解决方案。报告还帮助您决定升级是否可行。
  • 要点：如果要执行 RHEL 9 系统的全新安装，而不是原位升级过程，查看预升级报告也很有用。
  • 列表：查看生成的 leapp-report.txt 文件中的预升级报告，并使用命令行手动解决报告的问题。
  • 列表：使用 Web 控制台查看报告，在可用的情况下应用自动修复，并使用推荐的修复提示修复剩余的问题。
  • 注意：重要 预升级评估不会修改系统配置，但它消耗 /var/lib/leapp 目录中不可忽略的空间。在大多数情况下，预升级评估最多需要 4 GB 空间，但实际大小取决于您的系统配置。如果在托管的文件系统上没有足够的空间，预升级报告可能无法显示分析的完整结果。要防止问题，请确定您的系统在 /var/lib/leapp 目录中有足够的空间，或者将目录移到一个专用的分区，以便空间消耗不会影响系统的其他部分。
  • 注意：注意 您可以使用自己的自定义脚本处理预升级报告，例如，比较不同环境中多个报告的结果。如需更多信息，请参阅自动 Red Hat Enterprise Linux 预升级报告工作流。

4.2. 从命令行评估从 RHEL 9 到 RHEL 10 的可升级性

  • 要点：您可以使用命令行在升级前识别预升级阶段潜在的升级问题。
  • 要点：先决条件
  • 列表：您完成了 准备升级过程中的。
  • 列表：您以具有 unconfined SELinux 角色的 root 用户身份登录。 注意 如果使用 sudo 命令，必须在输入每个 leapp 命令时使用 unconfined_r -t unconfined_t 选项，例如： $ sudo -r unconfined_r -t unconfined_t leapp preupgrade
  • 列表：在 RHEL 9 系统上，执行预升级阶段： # leapp preupgrade --target <target_os_version> 将 target_os_version 替换为目标操作系统版本，如 10.0。如果没有定义目标操作系统版本，Leapp 将使用 支持的升级路径 中表 1.1 中指定的默认目标操作系统版本。 如果您使用 /etc/yum.repos.d/ 目录中的 自定义存储库 进行升级，请启用所选的存储库，如下所示： # leapp preupgrade --enablerepo <repository_id1> --enablerepo <repository_id2> ... 使用存储库 ID 替换 …
  • 列表：如果您使用 /etc/yum.repos.d/ 目录中的 自定义存储库 进行升级，请启用所选的存储库，如下所示： # leapp preupgrade --enablerepo <repository_id1> --enablerepo <repository_id2> ... 使用存储库 ID 替换 repository_id。
  • 列表：如果您要 不使用 RHSM 进行升级，或使用 RHUI 进行升级，请添加 --no-rhsm 选项。
  • 列表：如果您有 延长升级支持(EUS) 或高级升级支持(AUS)订阅，请添加 --channel <channel> 选项。将 <channel> 替换为渠道名称，如 eus 或 aus。
  • 命令/配置摘录：
$ sudo -r unconfined_r -t unconfined_t leapp preupgrade
# leapp preupgrade --target <_target_os_version_>
  • 注意：注意 如果使用 sudo 命令，必须在输入每个 leapp 命令时使用 unconfined_r -t unconfined_t 选项，例如： $ sudo -r unconfined_r -t unconfined_t leapp preupgrade
  • 注意：注意 另外，您可以通过运行以下命令来回答 true 或 false 问题： # leapp answer --section <question_section>.<field_name>=<answer>

4.3. 评估从 RHEL 9 到 RHEL 10 的可升级性，并通过 web 控制台应用自动补救措施

  • 要点：您可以在升级前发现潜在的问题，并使用 web 控制台应用自动化补救方法。请参阅 RHEL web 控制台入门，以了解有关 web 控制台的更多信息。
  • 要点：先决条件
  • 列表：您完成了 准备升级过程中的。
  • 列表：您以具有 unconfined SELinux 角色的 root 用户身份登录。 注意 如果使用 sudo 命令，必须在输入每个 leapp 命令时使用 unconfined_r -t unconfined_t 选项，例如： $ sudo -r unconfined_r -t unconfined_t leapp preupgrade
  • 列表：安装 cockpit-leapp 插件： # dnf install cockpit-leapp
  • 列表：以 root 或有权使用 sudo 输入管理命令的用户身份登录到 web 控制台。
  • 列表：在 RHEL 9 系统上，从命令行或从 web 控制台终端执行预升级阶段： # leapp preupgrade --target <target_os_version> 将 target_os_version 替换为目标操作系统版本，如 10.0。如果没有定义目标操作系统版本，Leapp 将使用 支持的升级路径 中表 1.1 中指定的默认目标操作系统版本。 如果您使用 /etc/yum.repos.d/ 目录中的 自定义存储库 进行升级，请启用所选的存储库，如下所示： # leapp preupgrade --enablerepo <repository_id1> --enablerepo <repository_id2> ..…
  • 列表：如果您使用 /etc/yum.repos.d/ 目录中的 自定义存储库 进行升级，请启用所选的存储库，如下所示： # leapp preupgrade --enablerepo <repository_id1> --enablerepo <repository_id2> ...
  • 命令/配置摘录：
$ sudo -r unconfined_r -t unconfined_t leapp preupgrade
# dnf install cockpit-leapp
  • 注意：注意 如果使用 sudo 命令，必须在输入每个 leapp 命令时使用 unconfined_r -t unconfined_t 选项，例如： $ sudo -r unconfined_r -t unconfined_t leapp preupgrade
  • 注意：注意 您还可以手动编辑 /var/log/leapp/answerfile 文件，通过删除 # 符号取消对文件的确认行的注释，并确认您的回答为 True 或 False。如需更多信息，请参阅 故障排除提示。

第 5 章 执行升级

  • 要点：完成准备步骤并审核和解决了预升级报告中发现的问题后，您可以在系统上执行原位升级。

5.1. 执行从 RHEL 9.7 升级到 RHEL 10.1

  • 要点：您可以使用 Leapp 工具执行从 RHEL 9 升级到 RHEL 10。
  • 要点：先决条件
  • 列表：您完成了 准备升级过程， 包括完整系统备份。
  • 列表：您完成了 预升级报告 过程，以及所有报告的问题已解决。
  • 列表：您已临时禁用了防病毒软件，以防止升级失败。
  • 列表：确定您有一个完整的系统备份或虚拟机快照。您可以使用以下备份选项： 使用 Relax-and-Recover (ReaR)工具创建一个系统的完整备份。如需更多信息，请参阅 ReaR 文档 以及 什么是 Relax and Recover (ReaR)以及如何将其用于灾难恢复？ 使用 LVM 快照 或 RAID 分割 来创建系统的快照。如果升级虚拟机，您可以创建整个虚拟机的快照。您还可以使用 Boom 工具管理快照和回滚引导条目。如需更多信息，请参阅 什么是 BOOM 以及如何安装它？ 以及 使用快照管理系统升级。 注意 因为 LVM 快照不创建系统的完整备份，所以您可能无法在某些升级失败后恢复您的系统。因此，使用 ReaR 工具创建…
  • 列表：使用 Relax-and-Recover (ReaR)工具创建一个系统的完整备份。如需更多信息，请参阅 ReaR 文档 以及 什么是 Relax and Recover (ReaR)以及如何将其用于灾难恢复？
  • 列表：使用 LVM 快照 或 RAID 分割 来创建系统的快照。如果升级虚拟机，您可以创建整个虚拟机的快照。您还可以使用 Boom 工具管理快照和回滚引导条目。如需更多信息，请参阅 什么是 BOOM 以及如何安装它？ 以及 使用快照管理系统升级。 注意 因为 LVM 快照不创建系统的完整备份，所以您可能无法在某些升级失败后恢复您的系统。因此，使用 ReaR 工具创建完整备份是安全的。
  • 命令/配置摘录：
# leapp upgrade --target <_target_os_version_>
# leapp upgrade --enablerepo <repository_id1> --enablerepo <repository_id2> ...
  • 注意：注意 因为 LVM 快照不创建系统的完整备份，所以您可能无法在某些升级失败后恢复您的系统。因此，使用 ReaR 工具创建完整备份是安全的。
  • 注意：重要 LiveMode 只是一个技术预览功能。技术预览功能不受红帽产品服务等级协议（SLA）支持，且功能可能并不完整。红帽不推荐在生产环境中使用它们。这些技术预览功能可以使用户提早试用新的功能，并有机会在开发阶段提供反馈意见。 有关红帽技术预览功能支持范围的更多信息，请参阅技术预览功能支持范围。

5.2. 执行从 RHEL 9.6 升级到 RHEL 10.0

  • 要点：您可以使用 Leapp 工具执行从 RHEL 9 升级到 RHEL 10。
  • 要点：先决条件
  • 列表：您完成了 准备升级过程， 包括完整系统备份。
  • 列表：您完成了 预升级报告 过程，以及所有报告的问题已解决。
  • 列表：您已临时禁用了防病毒软件，以防止升级失败。
  • 列表：确定您有一个完整的系统备份或虚拟机快照。您可以使用以下备份选项： 使用 Relax-and-Recover (ReaR)工具创建一个系统的完整备份。如需更多信息，请参阅 ReaR 文档 以及 什么是 Relax and Recover (ReaR)以及如何将其用于灾难恢复？ 使用 LVM 快照 或 RAID 分割 来创建系统的快照。如果升级虚拟机，您可以创建整个虚拟机的快照。您还可以使用 Boom 工具管理快照和回滚引导条目。如需更多信息，请参阅 什么是 BOOM 以及如何安装它？ 以及 使用快照管理系统升级。 注意 因为 LVM 快照不创建系统的完整备份，所以您可能无法在某些升级失败后恢复您的系统。因此，使用 ReaR 工具创建…
  • 列表：使用 Relax-and-Recover (ReaR)工具创建一个系统的完整备份。如需更多信息，请参阅 ReaR 文档 以及 什么是 Relax and Recover (ReaR)以及如何将其用于灾难恢复？
  • 列表：使用 LVM 快照 或 RAID 分割 来创建系统的快照。如果升级虚拟机，您可以创建整个虚拟机的快照。您还可以使用 Boom 工具管理快照和回滚引导条目。如需更多信息，请参阅 什么是 BOOM 以及如何安装它？ 以及 使用快照管理系统升级。 注意 因为 LVM 快照不创建系统的完整备份，所以您可能无法在某些升级失败后恢复您的系统。因此，使用 ReaR 工具创建完整备份是安全的。
  • 命令/配置摘录：
# leapp upgrade --target <_target_os_version_>
# leapp upgrade --enablerepo <repository_id1> --enablerepo <repository_id2> ...
  • 注意：注意 因为 LVM 快照不创建系统的完整备份，所以您可能无法在某些升级失败后恢复您的系统。因此，使用 ReaR 工具创建完整备份是安全的。

第 6 章 验证升级后状态

  • 要点：执行到 RHEL 10 的原位升级后，请验证系统是否处于正确的状态。这样做可让您识别并更正可能会影响您系统的任何关键错误。

6.1. 验证 RHEL 10 系统的升级后状态

  • 要点：完成到 RHEL 10 的升级后，请确定系统是否处于所需状态。
  • 要点：先决条件
  • 列表：系统已根据 执行升级 中描述的步骤进行了升级，并能够登录到 RHEL 10。
  • 列表：验证 Leapp 工具是否完成了升级过程中的所有操作，且系统已就绪： # [ -e "/etc/systemd/system/leapp_resume.service" ] || ps -e | grep -q leapp && echo "Leapp has not finished the execution yet!" 重要 如果您在升级完成前尝试使用该系统，则会出现严重的问题。
  • 列表：验证当前操作系统版本是否为 RHEL 10。例如： # cat /etc/redhat-release Red Hat Enterprise Linux release 10.1 (Coughlan)
  • 列表：检查 OS 内核版本。例如： # uname -r 6.12.0-55.2.1.el10_0.x86_64 请注意，.el10 很重要，版本不应早于 6.12.0。
  • 列表：如果您使用 Red Hat Subscription Manager: 验证是否安装了正确的产品。例如： # subscription-manager list --installed +-----------------------------------------+ Installed Product Status +-----------------------------------------+ Product Name: Red Hat Enterprise Linux for x86_64 Product ID: 479 Version: 10.1 Arch: x86_64 Status: Subscribed …
  • 列表：验证是否安装了正确的产品。例如： # subscription-manager list --installed +-----------------------------------------+ Installed Product Status +-----------------------------------------+ Product Name: Red Hat Enterprise Linux for x86_64 Product ID: 479 Version: 10.1 Arch: x86_64 Status: Subscribed
  • 命令/配置摘录：
# [ -e "/etc/systemd/system/leapp_resume.service" ] || ps -e | grep -q leapp && echo "Leapp has not finished the execution yet!"
# cat /etc/redhat-release Red Hat Enterprise Linux release 10.1 (Coughlan)
  • 注意：重要 如果您在升级完成前尝试使用该系统，则会出现严重的问题。

第 7 章 在 RHEL 10 系统上执行升级后任务

  • 要点：原位升级后，通过删除不需要的软件包、禁用不兼容的存储库并更新救援内核和初始 RAM 磁盘来清理 RHEL 10 系统。

7.1. 执行升级后的任务

  • 要点：执行到 RHEL 10 的升级后，完成以下推荐的主要任务。
  • 要点：先决条件
  • 列表：您验证了原位升级的状态，如 验证升级后状态 中所述。这包括 Leapp 工具完成升级过程的验证。
  • 列表：从 /etc/dnf/dnf.conf 配置文件中的 exclude 列表中删除剩余的 Leapp 软件包，其中包括 snactor 软件包，这是升级扩展开发的工具。在原位升级过程中，使用 Leapp 工具安装的Leapp 软件包会自动添加到 排除列表中，以防止删除或更新重要的文件。在原位升级后，在从系统中删除 Leapp 软件包之前，必须将它们从排除列表中删除。 要从 exclude 列表中手动删除软件包，请编辑 /etc/dnf/dnf.conf 配置文件并从 exclude 列表中删除所需的 Leapp 软件包。 从 exclude 列表中删除所有软件包： # dnf config-manager --save --seto…
  • 列表：要从 exclude 列表中手动删除软件包，请编辑 /etc/dnf/dnf.conf 配置文件并从 exclude 列表中删除所需的 Leapp 软件包。
  • 列表：从 exclude 列表中删除所有软件包： # dnf config-manager --save --setopt exclude=''
  • 列表：删除剩余的 RHEL 9 软件包，包括剩余的 Leapp 软件包。 找到剩余的 RHEL 9 软件包： # rpm -qa | grep -e '.el[789]' | grep -vE '^(gpg-pubkey|libmodulemd|katello-ca-consumer)' | sort 从 RHEL 10 系统中删除剩余的 RHEL 9 软件包。要确保 RPM 依赖项被维护，请使用 dnf remove 命令。 例如： # dnf remove $(rpm -qa | grep .el[789] | grep -vE 'gpg-pubkey|libmodulemd|katello-ca-consumer') 重要 此…
  • 列表：找到剩余的 RHEL 9 软件包： # rpm -qa | grep -e '.el[789]' | grep -vE '^(gpg-pubkey|libmodulemd|katello-ca-consumer)' | sort
  • 命令/配置摘录：
# dnf config-manager --save --setopt exclude=''
# rpm -qa | grep -e '\.el[789]' | grep -vE '^(gpg-pubkey|libmodulemd|katello-ca-consumer)' | sort
  • 注意：重要 此步骤也可以删除第三方软件包。在接受之前检查交易，以确保没有任何软件包被意外删除。
  • 注意：重要 删除这些数据可能会限制红帽支持调查并故障排除升级后问题的能力。

第 8 章 应用安全策略

  • 要点：在原位升级过程中，Leapp 必须将 SELinux 策略切换到 permissive 模式。另外，安全配置集可能包含主要版本之间的更改。
  • 要点：要恢复系统安全性，请再次将 SELinux 切换到 enforcing 模式。您可能还希望修复系统，使其符合特定的安全配置文件。另外，一些与安全相关的组件需要正确升级的预更新步骤。

8.1. 将 SELinux 模式改为 enforcing

  • 要点：在原位升级过程中，Leapp 会将 SELinux 模式设置为 permissive。完成系统升级后，您必须手动将 SELinux 模式改为 enforcing。
  • 要点：先决条件
  • 列表：系统已升级，且您执行了 验证升级后状态 中描述的验证。
  • 列表：确保没有 SELinux denials，例如，使用 ausearch 工具程序： # ausearch -m AVC,USER_AVC -ts boot 请注意，上一步只涵盖最常见的情况。要检查所有可能的 SELinux 拒绝，请参阅使用 SELinux 标题中的 识别 SELinux 拒绝 部分，它提供了一个完整的流程。
  • 列表：在您选择的文本编辑器中打开 /etc/selinux/config 文件，例如： # vi /etc/selinux/config
  • 列表：配置 SELINUX=enforcing 选项： # This file controls the state of SELinux on the system. # SELINUX= can take one of these three values: # enforcing - SELinux security policy is enforced. # permissive - SELinux prints warnings instead of enforcing. # disabled - No SELinux policy is loaded. SELINUX=enforcing # SELINUXTYPE= can…
  • 列表：保存更改，重启系统： # reboot
  • 列表：系统重启后，确认 getenforce 命令返回 Enforcing: $ getenforce Enforcing
  • 命令/配置摘录：
# ausearch -m AVC,USER_AVC -ts boot
# vi /etc/selinux/config

8.2. 升级系统强化到安全基点

  • 要点：要在成功升级到 RHEL 10 后获得完全强化的系统，您可以使用 OpenSCAP 套件提供的自动补救功能。
  • 要点：OpenSCAP 修复使您的系统符合安全基线，如 PCI-DSS、OSPP 或 ACSC Essential Eight。由于安全产品的演进，配置合规性建议在 RHEL 的主要版本之间有所不同。
  • 列表：scap-security-guide 软件包已安装在 RHEL 10 系统上。
  • 列表：查找合适的安全合规数据流 .xml 文件： $ ls /usr/share/xml/scap/ssg/content/ … ssg-rhel10-ds.xml … 如需更多信息，请参阅 查看配置合规性的配置文件 部分。
  • 列表：根据从合适的数据流所选的配置文件来修复系统： # oscap xccdf eval --profile <profile_ID> --remediate /usr/share/xml/scap/ssg/content/ssg-rhel10-ds.xml 根据您要强化系统哪一部分，将 <profile_ID> 替换为配置文件的 ID。有关 RHEL 10 中支持的配置文件的完整列表，请参阅 RHEL 10 中支持的 SCAP 安全指南配置文件。 警告 如果没有谨慎使用，在启用 --remediate 选项的情况下运行系统评估可能会导致系统无法正常工作。红帽不提供任何自动的方法来恢复由强化安全的修复所做的更改。默认配置的 RHEL 系…
  • 列表：重启您的系统： # reboot
  • 列表：验证系统是否遵从配置文件，并将结果保存到 HTML 文件中： $ oscap xccdf eval --report pcidss_report.html --profile pci-dss /usr/share/xml/scap/ssg/content/ssg-rhel10-ds.xml
  • 列表：扫描系统以检查配置合规性
  • 命令/配置摘录：
$ ls /usr/share/xml/scap/ssg/content/ … ssg-rhel10-ds.xml …
# oscap xccdf eval --profile <profile_ID> --remediate /usr/share/xml/scap/ssg/content/ssg-rhel10-ds.xml
  • 注意：注意 您不能使用相同的 SCAP 内容来扫描 RHEL 9 和 RHEL 10。如果系统的合规性是由 Red Hat Satellite 或 Red Hat Lightspeed 等工具管理的，则更新管理平台。
  • 注意：重要 在默认配置中，自动化修复支持 RHEL 系统。因为升级后更改了系统配置，因此运行自动补救可能无法使系统完全与所需的安全配置集兼容。您可能需要手动修复一些要求。

第 9 章 故障排除

  • 要点：原位升级是一个复杂的过程，通常会遇到问题和障碍。有关解决这些问题的帮助，请参阅以下故障排除资源和提示。

9.1. 故障排除资源

  • 要点：您可以使用各种故障排除资源来诊断并排除升级过程中遇到的问题。
  • 要点：控制台输出
  • 列表：在 verbose 模式下，Leapp 会输出 info, warning, error 和 critical 消息。
  • 列表：在 debug 模式中，Leapp 打印 debug、info、warning、error 和 critical 消息。
  • 列表：/var/log/leapp/leapp-upgrade.log 文件列出了 initramfs 阶段里的问题。
  • 列表：/var/log/leapp/dnf-debugdata/ 目录包含了事务故障排除数据。只有在使用 --debug 选项执行 leapp upgrade 命令时，此目录才存在。
  • 列表：/var/log/leapp/answerfile 包含需要 Leapp 回答的问题。
  • 列表：journalctl 工具提供完整的日志。

9.2. 故障排除窍门

  • 要点：当诊断和故障排除在原位升级过程中出现的问题时，请确保检查这些频繁跳过的步骤并使用这些有用的资源。
  • 要点：预升级阶段
  • 列表：验证您的系统是否满足 规划升级 中列出的所有条件。
  • 列表：确定您已遵循了 准备升级 中描述的所有步骤，例如：您的系统没有使用多个其名称是基于内核使用的前缀(eth)的网络接口卡(NIC)，。
  • 列表：确保您已回答了 /var/log/leapp/answerfile 文件中 Leapp 要求的所有问题。如果缺少任何回答，Leapp 会阻止升级。例如： 系统中没有 VDO 设备？
  • 列表：系统中没有 VDO 设备？
  • 列表：请确定您解决了在预升级报告（位于 /var/log/leapp/leapp-report.txt ）中发现的所有问题。要达到此目的，您也可以使用 Web 控制台，如 评估可升级性并通过 web 控制台应用自动修复 中所述。
  • 列表：如果在下载 RPM 软件包时出现问题，请检查位于 /var/log/leapp/dnf-debugdata/ 目录的事务调试数据。 注意 如果没有生成事务调试数据，/var/log/leapp/dnf-debugdata/ 目录为空，则不存在。当所需的软件仓库不可用时，会出现这种情况。
  • 命令/配置摘录：
[check_vdo] # Title: None # Reason: Confirmation # ============================= check_vdo.confirm ============================= # Label: Are all VDO devices, if any, successfully converted to LVM management? # Description: Enter True if no VDO devices are present on the system or all VDO devices on the system have been successfully converted to LVM management. Entering True will circumvent check of failures and undetermined devices. Recognized VDO devices that have not been converted to LVM management can still block the upgrade despite the answer.All VDO devices must be converted to LVM management before upgrading. # Reason: To maximize sa…
[check_vdo] ... # Available choices: True/False # Unanswered question. Uncomment the following line with your answer confirm = True
  • 注意：注意 如果没有生成事务调试数据，/var/log/leapp/dnf-debugdata/ 目录为空，则不存在。当所需的软件仓库不可用时，会出现这种情况。

9.3. RHEL 9.7 升级到 RHEL 10.1 的已知问题

  • 要点：从 RHEL 9.7 升级到 RHEL 10.1 时，您可能会遇到各种已知问题。
  • 要点：如果不是红帽签名的第三方软件包的名称与红帽提供的软件包名称相同，则原位升级会失败。要临时解决这个问题，请在升级前选择以下选项之一：
  • 列表：如果您的 RHEL 9 系统使用红帽提供的、但在 RHEL 10 中未提供的设备驱动程序，Leapp 会阻止升级。但是，如果 RHEL 9 系统使用 Leapp 在 /etc/leapp/files/device_driver_deprecation_data.json 文件中没有数据的第三方设备驱动程序，Leapp 不会检测到这样的驱动程序，并继续执行升级。然后，该系统可能会在升级后无法引导。
  • 列表：如果不是红帽签名的第三方软件包的名称与红帽提供的软件包名称相同，则原位升级会失败。要临时解决这个问题，请在升级前选择以下选项之一： 删除第三方软件包 使用红帽提供的软件包替换第三方软件包
  • 列表：删除第三方软件包
  • 列表：使用红帽提供的软件包替换第三方软件包
  • 列表：在带有独立磁盘的软件冗余阵列(RAID)的系统上，原位升级可能会失败。(BZ#1957192)
  • 列表：在原位升级过程中，Leapp 工具通常会在 RHEL 9 和 RHEL 10 之间保留网络接口控制器(NIC)名称。但是，在某些系统上，如带有网络绑定的系统，可能需要在 RHEL 9 和 RHEL 10 之间更新 NIC 名称。在这些系统上，执行以下步骤： 设置 LEAPP_NO_NETWORK_RENAMING=1 环境变量，以防止 Leapp 程序错误地保留原始 RHEL 9 NIC 名称。 执行原位升级。 验证您的网络是否正常工作。如果需要，请手动更新网络配置。 (BZ#1919382)
  • 命令/配置摘录：
# mount -o remount --make-shared <mountpoint>

9.4. RHEL 9.6 到 RHEL 10.0 升级的已知问题

  • 要点：从 RHEL 9.6 升级到 RHEL 10.1 时，您可能会遇到各种已知问题。
  • 要点：如果不是红帽签名的第三方软件包的名称与红帽提供的软件包名称相同，则原位升级会失败。要临时解决这个问题，请在升级前选择以下选项之一：
  • 列表：如果您的 RHEL 9 系统使用红帽提供的、但在 RHEL 10 中未提供的设备驱动程序，Leapp 会阻止升级。但是，如果 RHEL 9 系统使用 Leapp 在 /etc/leapp/files/device_driver_deprecation_data.json 文件中没有数据的第三方设备驱动程序，Leapp 不会检测到这样的驱动程序，并继续执行升级。然后，该系统可能会在升级后无法引导。
  • 列表：如果不是红帽签名的第三方软件包的名称与红帽提供的软件包名称相同，则原位升级会失败。要临时解决这个问题，请在升级前选择以下选项之一： 删除第三方软件包 使用红帽提供的软件包替换第三方软件包
  • 列表：删除第三方软件包
  • 列表：使用红帽提供的软件包替换第三方软件包
  • 列表：在带有独立磁盘的软件冗余阵列(RAID)的系统上，原位升级可能会失败。(BZ#1957192)
  • 列表：在原位升级过程中，Leapp 工具通常会在 RHEL 9 和 RHEL 10 之间保留网络接口控制器(NIC)名称。但是，在某些系统上，如带有网络绑定的系统，可能需要在 RHEL 9 和 RHEL 10 之间更新 NIC 名称。在这些系统上，执行以下步骤： 设置 LEAPP_NO_NETWORK_RENAMING=1 环境变量，以防止 Leapp 程序错误地保留原始 RHEL 9 NIC 名称。 执行原位升级。 验证您的网络是否正常工作。如果需要，请手动更新网络配置。 (BZ#1919382)
  • 命令/配置摘录：
# mount -o remount --make-shared <mountpoint>

9.5. 获取支持

  • 要点：要开一个支持问题单，请选择 RHEL 9 作为产品，并提供您系统的 sosreport。
  • 要点：请注意：您可以将问题单 ID 留空。
  • 列表：要在您的系统中生成 sosreport，请运行：
  • 命令/配置摘录：
# sosreport

第 10 章 相关信息

  • 要点：您可以参考以下说明：
  • 列表：升级 Red Hat Enterprise Linux 基础架构
  • 列表：Red Hat Enterprise Linux 的技术功能及限制
  • 列表：支持的 Red Hat Enterprise Linux 原位升级路径
  • 列表：原位升级支持策略
  • 列表：采用 RHEL 10 时的注意事项
  • 列表：定制 Red Hat Enterprise Linux 原位升级

附录 A. RHEL 9 软件仓库

  • 要点：如果您的系统使用 Red Hat Subscription Manager(RHSM)注册到 Red Hat Content Delivery Network(CDN)，则 RHEL 9 软件仓库会在原位升级过程中自动启用。但是，在使用 RHSM 注册到 Red Hat Satellite 的系统上，在运行预升级报告之前，您必须手动启用并同步 RHEL 9 和 RHEL 10 存储库。
  • 要点：如果您计划在升级过程中使用 Red Hat Satellite，您必须在升级之前使用 Satellite Web UI 或 hammer repository-set enable 和 hammer product synchronize 命令来启用并同步至少以下 RHEL 9 存储库：
  • 注意：注意 确保启用每个存储库的源操作系统版本，如 9.6。如果您只启用了 RHEL 9 版本，则禁止原位升级。
  • 表格样本（共 9 行）：
    • 架构 | 存储库 | 存储库 ID | 存储名称 | 发行版本
    • 64 位 Intel 和 AMD | BaseOS | rhel-9-for-x86_64-baseos-rpms | Red Hat Enterprise Linux 9 for x86_64 - BaseOS (RPMs) | x86_64 <source_os_version>
    • AppStream | rhel-9-for-x86_64-appstream-rpms | Red Hat Enterprise Linux 9 for x86_64 - AppStream (RPMs) | x86_64 <source_os_version>
    • 64-bit ARM | BaseOS | rhel-9-for-aarch64-baseos-rpms | Red Hat Enterprise Linux 9 for ARM 64 - BaseOS (RPMs) | aarch64 <source_os_version>

附录 B. RHEL 10 存储库

  • 要点：如果您的系统已使用 Red Hat Subscription Manager (RHSM)注册到 Red Hat Content Delivery Network (CDN)，则 RHEL 10 存储库会在原位升级过程中自动启用。但是，在使用 RHSM 注册到 Red Hat Satellite 的系统上，您必须在运行预升级报告之前手动启用并同步 RHEL 9 和 RHEL 10 存储库。
  • 要点：如果您计划在升级过程中使用 Red Hat Satellite，则您必须在升级之前使用 Satellite Web UI 或 hammer repository-set enable 和 hammer product synchronize 命令来启用并同步以下 RHEL 10 存储库，：
  • 注意：注意 确保启用每个存储库的目标操作系统版本，如 10.0。如果您只启用了存储库的 RHEL 10 版本，则原位升级会被禁止。
  • 表格样本（共 9 行）：
    • 架构 | 存储库 | 存储库 ID | 存储名称 | 发行版本
    • 64 位 Intel 和 AMD | BaseOS | rhel-10-for-x86_64-baseos-rpms | Red Hat Enterprise Linux 10 for x86_64 - BaseOS (RPMs) | x86_64 <target_os_version>
    • AppStream | rhel-10-for-x86_64-appstream-rpms | Red Hat Enterprise Linux 10 for x86_64 - AppStream (RPMs) | x86_64 <target_os_version>
    • 64-bit ARM | BaseOS | rhel-10-for-aarch64-baseos-rpms | Red Hat Enterprise Linux 10 for ARM 64 - BaseOS (RPMs) | aarch64 <target_os_version>

完整目录

  • 从 Red Hat Enterprise Linux 9 原位升级到 Red Hat Enterprise Linux 10 的说明
  • 对红帽文档提供反馈
  • 主要迁移术语
  • 第 1 章 支持的升级路径
  • 第 2 章 计划到 RHEL 10 的升级
    • 2.1. 规划从 RHEL 9 到 RHEL 10 的升级
  • 第 3 章 准备升级
    • 3.1. 为升级准备一个 RHEL 9 系统
    • 3.2. 为升级准备注册了 Satellite 的系统
    • 3.3. 使用 LiveMode 配置从 RHEL 9.7 升级到 RHEL 10.1
  • 第 4 章 查看升级前报告
    • 4.1. 关于预升级报告
    • 4.2. 从命令行评估从 RHEL 9 到 RHEL 10 的可升级性
    • 4.3. 评估从 RHEL 9 到 RHEL 10 的可升级性，并通过 web 控制台应用自动补救措施
  • 第 5 章 执行升级
    • 5.1. 执行从 RHEL 9.7 升级到 RHEL 10.1
    • 5.2. 执行从 RHEL 9.6 升级到 RHEL 10.0
  • 第 6 章 验证升级后状态
    • 6.1. 验证 RHEL 10 系统的升级后状态
  • 第 7 章 在 RHEL 10 系统上执行升级后任务
    • 7.1. 执行升级后的任务
  • 第 8 章 应用安全策略
    • 8.1. 将 SELinux 模式改为 enforcing
    • 8.2. 升级系统强化到安全基点
  • 第 9 章 故障排除
    • 9.1. 故障排除资源
    • 9.2. 故障排除窍门
    • 9.3. RHEL 9.7 升级到 RHEL 10.1 的已知问题
    • 9.4. RHEL 9.6 到 RHEL 10.0 升级的已知问题
    • 9.5. 获取支持
  • 第 10 章 相关信息
  • 附录 A. RHEL 9 软件仓库
  • 附录 B. RHEL 10 存储库