第 4 章 排除更新
要对 MicroShift 更新进行故障排除，请使用以下指南。
4.1. MicroShift 更新故障排除
在某些情况下，MicroShift 可能无法更新。在这些事件中，了解失败类型以及如何对它们进行故障排除很有帮助。
4.1.1. 更新路径会因为版本不兼容而阻止
如果 MicroShift 更新与 Red Hat Enterprise Linux for Edge (RHEL for Edge)或 Red Hat Enterprise Linux (RHEL)的版本不兼容，则 RPM 依赖项错误会导致。
4.1.1.1. 兼容性表
检查以下兼容性表：
Red Hat Device Edge 发行版本兼容性列表
Red Hat Enterprise Linux (RHEL)和 MicroShift 可以一起工作，作为设备边缘计算的单一解决方案。您可以单独更新每个组件，但产品版本必须兼容。例如，将 MicroShift 从 4.14 更新至 4.16 需要 {op-system} 更新。如下表所示，Red Hat Device Edge 的支持的配置为每个 Red Hat Device Edge 使用验证的版本：
| RHEL for Edge 版本 | MicroShift 版本 | MicroShift 发行版本状态 | 支持的 MicroShift 版本→MicroShift 版本更新 |
| 9.4 | 4.16 | 正式发布 | 4.16.0→4.16.z, 4.14→4.16 和 4.15→4.16 |
| 9.2, 9.3 | 4.15 | 正式发布 | 4.15.0→4.15.z, 4.14→4.15 和 4.15→4.16 |
| 9.2, 9.3 | 4.14 | 正式发布 | 4.14.0→4.14.z, 4.14→4.15 和 4.14→4.16 |
| 9.2 | 4.13 | 技术预览 | None |
| 8.7 | 4.12 | 开发者预览 | None |
4.1.1.2. 版本兼容性
检查以下更新路径：
红帽 MicroShift 更新路径的构建
- RHEL for Edge 9.4 上正式发布版本 4.16.0 到 4.16.z
- RHEL 9.4 上正式发布版本 4.15.0 从 RHEL 9.2 升级到 4.16.0
- 通常 Available Version 4.14.0 从 RHEL 9.2 到 4.16.0 on RHEL 9.4
4.1.2. ostree 更新失败
如果您在 OSTree 系统上更新，Greenboot 健康检查会自动日志并处理系统健康状况。通过 Greenboot 的系统回滚可以指示失败。如果更新失败，但 Greenboot 没有完成系统回滚，您可以使用此内容"Additional resources"部分中的 RHEL for Edge 文档进行故障排除。
- 手动检查 Greenboot 日志
运行以下命令，手动检查 Greenboot 日志以验证系统健康状况：
$ sudo systemctl restart --no-block greenboot-healthcheck && sudo journalctl -fu greenboot-healthcheck
4.1.3. 手动 RPM 更新失败
如果您在非 OSTree 系统上使用 RPM 更新，则 Greenboot 可以指示更新失败，但健康检查仅以信息形式表示。检查系统日志是手动 RPM 更新故障故障排除的下一步。您可以使用 Greenboot 和 sos report 检查 MicroShift 更新和主机系统。
