VergeOS 版本更新指南

将 VergeOS 系统安全更新到新的点版本的标准操作流程，包括准备、预演、执行、更新后验证和回滚指导。

本指南提供将 VergeOS 系统安全更新到新的点版本的最佳实践。它通过循序渐进的方法，重点关注数据安全和系统韧性。

概述

更新您的 VergeOS 系统需要周密的规划和执行，以确保对服务的影响降到最低。本指南将该过程分为以下主要阶段：

1. 准备 - 在计划维护窗口之前要执行的步骤
2. 更新前验证 - 在开始更新前立即进行的最终检查
3. 执行更新 - 安装更新的过程
4. 更新后验证 - 确保更新已成功

特定环境要求

本指南涵盖一般最佳实践。您可能需要根据您的具体环境和需求调整这些步骤。

前提条件

• 对 VergeOS 系统的管理访问权限
• 集群中所有节点的 IPMI 访问权限
• 用于下载更新的网络连接
• 预计时间： 1-2 小时，具体取决于集群大小和更新复杂度

准备阶段

请在计划维护窗口之前充分提前完成以下步骤：

系统就绪性

• 确保系统快照保留足够，以便在需要时回滚
• 为您的工作负载设定明确的成功和验证标准
• 确定您的特定用例所需的 VM、服务等群组

用例示例

VDI 可能有多个不同的镜像或资源池。VPS 可能更侧重于网络功能和连通性。

• 梳理任何必须持续运行的对时间敏感的系统和客户机事件

文档与规划

• 在平台文档中更新计划维护窗口
• 审查任何可能需要同时执行的协同更新/升级

  • 避免合并不必要的更新
• 查看版本发布说明，并规划任何特定影响
• 记录当前系统配置，以便回滚参考
• 为受影响用户规划沟通时间表

资源验证

• 检查集群资源利用率

  • 确保您的系统有足够的冗余资源，即使失去最大节点也能运行
• 确认主机之间的网络路径

  • 从每个节点：节点诊断 -> Fabric 配置（所有节点中的所有路径都应为 "confirmed:true"）
• 如果近期尚未测试网络冗余，请在更新前安排测试
• 通过一种在紧急情况下允许控制台访问的方法，确认可访问所有主机的 IPMI

更新预演

1. 在 VergeOS 中，导航到 系统 > 更新
2. 单击 检查更新
3. 下载更新（在点击“安装”之前不会开始）
4. 记录当前版本和目标版本以便文档记录

更新前验证

请在计划维护当天、开始更新前执行以下检查：

当前状态验证

• 确认当前运行版本为预期版本
• 检查日志中近期错误

  • 记录任何非关键问题
  • 如果发现关键错误，请取消
• 验证资源可用性满足 N+1 要求

  • 确认 RAM 使用情况允许在一个节点离线时工作负载继续运行
• 验证系统快照是最近的且可用

  • 将最近的快照设置为在未来几天后过期，以便额外保留
• 确认多站点同步功能正常且已更新到最新
• 验证所有 vSAN 层都处于健康状态（绿色状态）
• 确认没有节点正在等待重启
• 记录系统性能基线，以便更新后进行比较

更新验证

• 在以下位置确认您的预演更新 系统 > 更新
• 再次检查更新

  • 如果还有另一个更新，请在继续前仔细评估
• 验证更新过程有足够的磁盘空间
• 确认所有节点均可访问且有响应

执行阶段

安装更新

实际更新过程：

1. 导航到 系统 > 更新
2. 单击 安装 以开始更新过程
3. 监控节点 1 因为它会自动：

   • 自动进入维护模式
   • 重启并应用更新
   • 恢复服务
4. 观察后续节点 因为系统会继续更新并重启各节点
5. 监控工作负载 并在整个过程中监控系统资源使用情况
6. 跟踪进度 - 每个节点将按顺序更新，以保持服务可用性

更新监控

在更新过程中，您可以在 系统 > 更新 部分监控进度。每个节点都会显示其当前状态以及在各更新阶段中的进度。

请勿中断

更新一旦开始，请不要关闭节点或中断更新过程。让每个节点自然完成其更新周期。

更新后验证

更新完成后，验证系统是否正常运行：

版本确认

• 在以下位置确认预期版本 系统 > 更新

  • 验证以下软件包处于预期版本：

    • osm （Open Street Maps 数据）
    • yb （Verge.io 云软件栈）
    • yb-help （集成帮助与文档）
    • ybos （Verge.io 操作系统）

系统健康检查

• 确认以下位置中的“Nodes Updated”磁贴： 系统 > 更新 为绿色且所有节点已完成
• 确保所有 vSAN 层显示绿色状态
• 验证所有节点均显示绿色“Running”状态

  • 确认节点没有任何待处理重启
• 根据您的成功标准按需测试/确认来宾系统
• 手动创建一个保留数天的快照
• 检查日志中是否有新的或意外的事件
• 验证准备步骤中概述的所有成功标准
• 确认系统性能与基线相当或更好

功能测试

• 测试关键 VM 操作（启动、停止、迁移）
• 验证网络连通性和性能
• 确认备份和快照操作正常
• 测试任何自定义集成或自动化

故障排除

常见问题

更新过程在某个节点上停滞

• 通过 IPMI 检查节点可访问性
• 查看系统日志中的错误消息
• 验证到停滞节点的网络连通性
• 如果节点仍无响应，请联系支持

更新后版本不匹配

• 允许额外时间让所有组件同步
• 检查是否有软件包安装失败
• 验证节点之间的网络连接
• 查看更新日志中的具体错误

更新后性能下降

• 与更新前基线进行比较
• 检查是否出现新的资源限制
• 查看 vSAN 层的健康状况和性能
• 监控 24-48 小时以建立新的基线

更新后 VM 无法启动

• 检查 VM 配置兼容性
• 验证存储层可访问性
• 查看特定于 VM 的日志中的错误
• 逐个测试 VM 操作

回滚流程

回滚注意事项

如果出现问题，最安全的方法是暂停、调查异常行为，然后在清楚了解问题后再继续。VergeOS 更新旨在向前兼容，因此回滚并不总是可行。

如果出现问题

1. 记录问题 通过截图和日志进行详细记录
2. 识别并隔离问题 - 确定它是影响所有节点还是特定组件
3. 联系支持 在尝试任何回滚步骤之前
4. 保留系统状态 以便进行故障排查分析
5. 遵循支持建议 以进行修复或回滚操作

下一步

更新成功完成后：

• 在系统文档中更新新版本信息
• 安排例行监控以确保稳定性
• 查看更新中引入的任何新功能或变更
• 根据发布计划规划未来的更新
• 如有需要，更新备份和灾难恢复流程

紧急支持

如果您的 VergeOS 软件更新有任何问题，请联系 我们的支持团队 以获取即时协助。