第 4 章 使用 Leapp 将 Satellite 或 Capsule 升级到 Red Hat Enterprise Linux 8

流程

1. 配置软件仓库以获取 Leapp。

   在 Red Hat Enterprise Linux 上，启用 rhel-7-server-extras-rpms 存储库：

   # subscription-manager repos --enable=rhel-7-server-extras-rpms

   Copy to Clipboard Toggle word wrap

2. 安装所需的软件包：

   # satellite-maintain packages install leapp leapp-repository

   Copy to Clipboard Toggle word wrap
3. 要使 Leapp 在断开连接的环境中执行升级，请下载元数据并手动提取，如 Leapp 实用程序元数据 RHEL for disconnected 升级 所述。

4. 设置以下软件仓库以便在断开连接的环境中执行升级：

   1. /etc/yum.repos.d/rhel8.repo:

      [BaseOS]
      name=rhel-8-for-x86_64-baseos-rpms
      baseurl=http://server.example.com/rhel8/BaseOS/
      
      [AppStream]
      name=rhel-8-for-x86_64-appstream-rpms
      baseurl=http://server.example.com/rhel8/AppStream/

      Copy to Clipboard Toggle word wrap

   2. /etc/yum.repos.d/satellite.repo:

      [satellite-6.11-for-rhel-8-x86_64-rpms]
      name=satellite-6.11-for-rhel-8-x86_64-rpms
      baseurl=http://server.example.com/sat6/Satellite/
      
      [satellite-maintenance-6.11-for-rhel-8-x86_64-rpms]
      name=satellite-maintenance-6.11-for-rhel-8-x86_64-rpms
      baseurl=http://server.example.com/sat6/Maintenance/

      Copy to Clipboard Toggle word wrap

5. 配置 Leapp 以保留 Tomcat 软件包以确保升级不会失败：

   # echo tomcat >> /etc/leapp/transaction/to_keep
   # echo tomcat-lib >> /etc/leapp/transaction/to_keep

   Copy to Clipboard Toggle word wrap

6. 使 Leapp 分析您的系统：

   # leapp preupgrade

   Copy to Clipboard Toggle word wrap

   如果您在断开连接的环境中运行 Satellite，请添加 --no-rhsm 和 --enablerepo 参数：

   # leapp preupgrade \
   --no-rhsm \
   --enablerepo BaseOS \
   --enablerepo AppStream \
   --enablerepo satellite-6.11-for-rhel-8-x86_64-rpms \
   --enablerepo satellite-maintenance-6.11-for-rhel-8-x86_64-rpms

   Copy to Clipboard Toggle word wrap

   第一个运行应该失败，但报告问题并禁止升级。检查 /var/log/leapp/leapp-report.txt 文件中的报告，回答所有问题（使用 leapp 回答），并手动解决问题。

   以下命令显示所需的最常见的步骤：

   # rmmod pata_acpi
   # echo PermitRootLogin yes | tee -a /etc/ssh/sshd_config
   # leapp answer --section remove_pam_pkcs11_module_check.confirm=True

   Copy to Clipboard Toggle word wrap

   如果 leapp preupgrade 禁止带有不被支持的网络配置的升级，因为存在多个旧的命名网络接口，请按照 Leapp 重命名接口的说明，然后运行安装程序来重新配置 Satellite 或 Capsule 以使用新的接口名称：

   # satellite-installer --help |grep 'interface.*eth'
       --foreman-proxy-dhcp-interface  DHCP listen interface (current: "eth0")
       --foreman-proxy-dns-interface  DNS interface (current: "eth0")

   Copy to Clipboard Toggle word wrap

   如果 eth0 被重命名为 em0，请调用安装程序以使用新接口名称：

   # satellite-installer --foreman-proxy-dhcp-interface=em0 --foreman-proxy-dns-interface=em0

   Copy to Clipboard Toggle word wrap
7. 确保 leapp 预升级 没有问题。

8. 运行：

   # leapp upgrade

   Copy to Clipboard Toggle word wrap

   如果您在断开连接的环境中运行 Satellite，请添加 --no-rhsm 和 --enablerepo 参数：

   # leapp upgrade \
   --no-rhsm \
   --enablerepo BaseOS \
   --enablerepo AppStream \
   --enablerepo satellite-6.11-for-rhel-8-x86_64-rpms \
   --enablerepo satellite-maintenance-6.11-for-rhel-8-x86_64-rpms

   Copy to Clipboard Toggle word wrap

9. 重启系统。

   系统重启后，实时系统执行升级，重启以修复 SELinux 标签，然后重启到最终的 Red Hat Enterprise Linux 8 系统。

10. Leapp 完成升级，使用以下方法观察升级：

    # journalctl -u leapp_resume -f

    Copy to Clipboard Toggle word wrap

11. 完成 从 RHEL 7 升级到 RHEL 8 中的这些步骤：

    1. 解锁软件包：

       # satellite-maintain packages unlock

       Copy to Clipboard Toggle word wrap
    2. 验证 RHEL 8 系统升级后的状态
    3. 执行升级后的任务

    4. 锁定软件包：

       # satellite-maintain packages lock

       Copy to Clipboard Toggle word wrap

12. 对于仅限 Satellite 而不是 Capsule，如果您需要 SELinux 处于 enforcing 模式，请在将 SELinux 更改为 enforcing 模式前运行以下命令：

    # dnf reinstall foreman-selinux katello-selinux --disableplugin=foreman-protector

    Copy to Clipboard Toggle word wrap
13. 完成将 SELinux 更改为 enforcing 模式 的步骤，如 从 RHEL 7 升级到 RHEL 8 指南中的将 SELinux 模式改为 enforcing。

14. 取消设置 subscription-manager 发行版本：

    # subscription-manager release --unset

    Copy to Clipboard Toggle word wrap