> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/knowledge-base/zh/troubleshooting/vergeos-update-instructions.md).

# VergeOS 更新说明

{% hint style="danger" %}
**警告：不要跳过主要版本**

例如，如果您当前使用的是 4.8 版本，请先更新到 4.9 版本，然后再更新到 4.10。 **跳过版本可能会导致严重的数据库和配置问题。**
{% endhint %}

VergeOS 平台支持“零停机”更新。这意味着在常规更新过程中，来宾工作负载（虚拟机和租户环境）可以保持开启并照常运行。

> 有关更新流程的更多信息，请参阅我们的 [产品指南](/run-the-platform/system-administration/licensing-and-updates.md).

完成更新所需的时间取决于以下因素：

* 系统中的节点数量
* vSAN 上已消耗的存储空间
* 更新期间工作负载产生的数据变更率
* 硬件性能（处理器速度、磁盘类型、网络速度）

{% hint style="warning" %}
**在更新过程中，您可能会看到各层和驱动器在“在线”、“验证中”或“修复中”状态之间切换。这是正常现象，因为系统正在验证数据完整性。**
{% endhint %}

{% hint style="warning" %}
**在执行更新之前，请确认系统内存使用率在限制范围内。例如，在双节点配置中，总系统内存应低于 50% 的使用率，以便剩余节点能够处理 100% 的工作负载。**
{% endhint %}

{% hint style="warning" %}
**在继续更新之前，请确保没有任何节点处于维护模式。**
{% endhint %}

## 更新步骤

1. 登录 VergeOS UI。
2. 导航到 **系统 > 更新**，然后选择 **检查更新** 在左侧菜单中。
   * 弹出窗口会提示“是”或“否”，请选择 **是**.
   * 如果出现横幅，提示“在其他分支上有一个新的小版本可用”，请按照提示通过选择 **更改分支** 在左侧菜单中。通过以下方式确认 **是**. ![VergeOSupgrade-new-img2.png](/files/b5ac2386242d9d327d6356aa5b885815c5f0b801)
3. 现在将突出显示要下载的软件包。 ![VergeOSupgrade-new-img3.png](/files/29d37aa45136cdf93d47f3d1401c97a64bae9f06)
   * 选择 **下载** 在左侧菜单中。
   * 弹出窗口会提示“是”或“否”，请选择 **是**.
   * 下载过程将在仪表板上的 **当前更新服务器** 磁贴中显示。
4. 下载完成后， **安装** 操作将变为可用。
   * 选择 **安装** 准备好后。
   * 通过以下方式确认 **是** 以开始安装。
5. 安装完成后，将出现重启系统的请求。
   * 选择 **重新启动** 在左侧菜单中，以启动跨所有节点的滚动重启。

{% hint style="info" %}
**注意**

更新将从 **节点 1**开始，使其进入维护模式并将工作负载迁移到其他节点。在小版本更改期间，当系统回退到节点 1 时，您可能会短暂失去对 UI 的访问。这是正常的，持续时间不应超过一两分钟。工作负载不应出现网络问题。
{% endhint %}

## 故障排除步骤

### 工作负载迁移失败

* 此错误通常是由于集群中的资源（RAM）不足所致。请尝试迁移其他工作负载或调整 RAM 使用量。更多原因和解决方案详见 [这里](/knowledge-base/zh/virtual-machines/workloads-failing-to-migrate.md).

### vSAN 验证耗时过长

* 验证过程取决于网络速度、磁盘类型和已消耗数据等因素。HDD 会比 NVMe 或 SSD 花费更长时间。在 VergeOS 4.9.0 及更高版本中，请查看 **完整遍历进度** 在分层仪表板上查看，以了解验证进度。

  ![walk-percentage.png](/files/12574831776d9d82829d3d865f910b037219e3cc)

{% hint style="danger" %}
**警告**

在重启任何其他节点之前，此过程必须完成。否则可能会导致 **双重故障**，从而导致工作负载崩溃。
{% endhint %}

### 无法连接到更新服务器

* 请确保系统在其外部（UI）网络上有可用的 DNS 服务器：
  1. 导航到外部网络仪表板。
  2. 选择 **诊断** 在左侧菜单中。
  3. 将查询设置为 **DNS 查询** 并在 **发送**.
  4. 如果 DNS 配置正确，响应将显示 Verge.io 的 IP 地址。如果没有，请检查 DNS 设置并重试查询。
* 过期的更新服务器凭据也可能导致此问题。这些凭据与系统许可证绑定，应通过您的 VergeOS 销售代表续订。

***

{% hint style="info" %}
**文档信息**

* 最后更新：2024-09-03
* VergeOS 版本：4.12.6
  {% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.verge.io/knowledge-base/zh/troubleshooting/vergeos-update-instructions.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.