> 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/run-the-platform/zh/yun-wei/drive-replacement.md).

# 更换故障或寿命终止的磁盘

及时更换失效或已到寿命终点的 vSAN 驱动器，对于维护数据保护至关重要。本页介绍如何识别有问题的驱动器并安全完成更换。

{% hint style="danger" %}
**开始之前**

* **请使用兼容的替换驱动器。** 替换件必须是相同型号或等效型号——在容量、接口类型和规格上与原驱动器一致。使用容量不足或不兼容的驱动器可能导致数据丢失或 vSAN 不稳定。
* **替换驱动器必须是空的。** 请确认其中没有任何数据——尤其不能有 VergeOS vSAN 数据。曾用于 VergeOS vSAN、但尚未擦除的驱动器，如果被重新用作替换件，可能会导致严重的系统问题。如有疑问，请在另一台系统上先擦除该驱动器再使用。
* **在执行任何驱动器更换操作之前，务必先将节点置于维护模式。** 这是确保 vSAN 在更换过程中能够正确保护数据的关键。
  {% endhint %}

## 什么时候需要更换驱动器？

当物理驱动器出现问题时，VergeOS 界面会提供通知。驱动器警告和错误会在 VergeOS 用户界面的多个位置显示。

### 告警

当节点驱动器出现警告或错误时，会触发告警。

**查看详细信息：**

* 点击右上角的“告警”快捷链接，或转到 **系统 > 告警**.
* 双击驱动器警告或错误条目。
* 这将带您进入节点仪表盘。点击 *驱动器* 以访问节点驱动器列表。
* 双击带有错误/警告的驱动器，即可查看其显示更多详细信息的仪表盘。

### 系统仪表盘

该 *节点驱动器* 当任何物理驱动器处于警告或错误状态时，系统仪表盘上的该卡片会显示为黄色或红色。

**查看详细信息：**

* 导航到 **系统 > 仪表盘**.
* 点击 *节点驱动器* 卡片中的任意位置，即可访问完整驱动器列表。
* 双击带有错误/警告的驱动器，即可查看其显示更多详细信息的仪表盘。

### 警告/错误状态示例

* **警告** - 磨损级别超过最大阈值
* **警告** - 重新分配扇区超过最大阈值
* **错误** - 驱动器无响应；已达到读写错误阈值
* **缺失** - 系统不再检测到该驱动器（已失效或已物理移除）

{% hint style="warning" %}
**配置主动驱动器告警**

尽早发现驱动器问题至关重要。一个未被察觉的降级或失效驱动器，可能会进一步发展为威胁 vSAN 冗余的故障。 **强烈建议：至少设置一种启用中的通知方式，以便在 VergeOS 检测到驱动器问题时立即提醒管理员。**

可用的选项有：

* **仪表盘与告警** — VergeOS UI 会触发告警，并在系统仪表盘上显示驱动器警告/错误。定期查看仪表盘可以发现问题，但这依赖于有人主动查看。
* **任务引擎 + Webhook** — 使用 VergeOS 任务引擎在发生驱动器事件时自动触发操作（webhook、电子邮件、API 调用）。这使得可以向外部系统（如 Slack 频道、Prometheus Alertmanager、Zluri 或任何兼容 webhook 的平台）推送通知，从而提供近乎即时、免操作的告警。
* **订阅** — 配置订阅，以便在 VergeOS 检测到驱动器问题时按需发送电子邮件通知，和/或安排定期报告（例如每日系统仪表盘摘要）以便日常查看。请参阅 [订阅概览](/run-the-platform/zh/xi-tong-guan-li/subscriptions-overview.md) 了解设置详情。
  {% endhint %}

## 我应该使用哪种更换流程？

更换流程取决于驱动器当前状态：

| 驱动器状态                         | 条件               | 流程                                                                   |
| ----------------------------- | ---------------- | -------------------------------------------------------------------- |
| **缺失** 或 **错误** （无响应）或 **离线** | 驱动器已失效且无响应       | [场景 1：更换已失效/缺失的驱动器](#scenario-1-replace-a-failedmissing-drive)       |
| **警告** 或 **降级**               | 驱动器仍可运行，但已出现故障迹象 | [场景 2：主动更换正常工作的驱动器](#scenario-2-proactively-replace-a-working-drive) |

{% hint style="success" %}
**如何判断驱动器是否缺失**

缺失的驱动器在驱动器列表中会显示状态为 **缺失** 。这种情况发生在驱动器完全失效、失去连接或已被物理移除时。驱动器条目会保留在 UI 中，以便您启动更换流程。
{% endhint %}

## 确定用于更换的正确物理驱动器

1. 导航到 **节点仪表盘**.
2. 找到 *LED 状态* 字段，位于状态卡片中。
3. 尝试 **激活驱动器 LED**:

   * 如果 ***LED 状态*** 显示 **关闭**，单击 **打开 LED** 左侧菜单中的。
   * 如果 ***LED 状态*** 显示 **不支持**，单击 **定位 LED** 在左侧菜单中。诊断窗口将出现，并预先填充好设置——点击 **发送 ->** 以激活驱动器 LED。

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>LED 定位需要硬件支持</strong></p><p>LED 定位仅在硬件支持时可用。如果 LED 状态显示为不支持且定位功能没有响应，请改用下面的识别技巧。</p></div>
4. 一旦 LED 被激活，通过找到那个持续亮着或闪烁定位灯的驱动器来定位物理驱动器。
5. 识别出驱动器后， **关闭 LED**：选择 **关闭 LED** 或 **定位 LED**；将状态改为关闭；发送。

### 如果 LED 定位不可用

如果您的硬件不支持 LED 定位，请使用以下技巧识别正确的物理驱动器：

* **对于失效驱动器** （状态 **缺失** 或 **离线**）：失效的驱动器通常不会有任何活动——没有闪烁的活动指示灯。正常工作的驱动器会有闪烁的活动灯；失效的驱动器则会熄灭，或显示稳定的错误指示。
* **匹配序列号**：VergeOS 驱动器仪表盘中显示的驱动器序列号，可以与物理驱动器标签上的序列号进行匹配。

## 热插拔与关机更换

**大多数生产系统** 使用热插拔驱动器槽位，允许在节点保持通电（处于维护模式）时移除并更换驱动器。以下流程假定支持热插拔。

**某些系统** ——例如 POC 环境、家庭实验室，或驱动器安装在 PCIe 槽中的节点——在更换驱动器之前需要先关闭节点电源。如果您的系统不支持热插拔：

1. 将节点置于 **维护模式** 中，如所示。
2. **在移除任何驱动器之前，先通过 VergeOS UI 优雅地关闭节点** （不要强制断电）。
3. 进行物理驱动器更换。
4. 重新开启节点电源，并等待其重新加入集群。
5. 继续执行剩余步骤。

{% hint style="warning" %}
**如果您拔错了驱动器**

如果您不小心移除了错误的驱动器，请立即将其重新插回。对于热插拔系统，无需重启。对于需要关闭节点的系统，在重新插回驱动器后再重新开启节点电源。无论哪种情况，由于节点已按要求处于维护模式，vSAN 会受到保护，不会发生数据丢失。节点重新上线后，您可以重新开始此流程并移除正确的驱动器。
{% endhint %}

## 相同槽位与不同槽位：预期差异

在 VergeOS 中完成更换的步骤，取决于您是将新驱动器插入 **相同槽位** ，还是 **不同槽位**。以下两种场景都适用。

| 替换槽位     | UI 显示内容                                         | 所需步骤                                  |
| -------- | ----------------------------------------------- | ------------------------------------- |
| **相同槽位** | VergeOS 会识别该槽位，并将新驱动器报告为 **离线** （将其视为原始成员但没有数据） | 选择新的（离线）驱动器 → **格式化** → **初始化**       |
| **不同槽位** | 原始驱动器条目会保留（作为 **缺失** 或 **离线**），而新驱动器会单独显示       | 选择 **原始驱动器条目** → **替换** → 选择新驱动器作为替换件 |

***

## 场景 1：更换已失效/缺失的驱动器

当驱动器已经失效且不再响应，或者驱动器显示 **缺失** 状态时，请使用此流程。

{% hint style="danger" %}
**注意：在开始驱动器修复操作之前，请确认：**

1. 包含失效驱动器的节点处于 **维护模式**。所有其他节点必须在线且完全正常运行。

2. 同一存储层中的其他节点上没有正在进行的驱动器修复 *（同一物理节点上的修复是允许的）*.

3. 您已经准确识别出正确的物理驱动器（请参见 [确定用于更换的正确物理驱动器](#determine-the-correct-physical-drive-for-replacement) 上文）。

4. 替换驱动器是空的且兼容的（请参见本页顶部的警告）。
   {% endhint %}

5. **将** 包含失效驱动器的节点 **置于维护模式。**

6. 如果失效驱动器仍然物理存在， **将其移除** 出节点。

7. **插入替换驱动器。** （如果您的系统需要先关闭节点，请遵循上面的 [热插拔与关机](#hot-swap-vs-shutdown-replacement) 步骤。）

8. **等待** 系统检测到新驱动器。

9. 在节点仪表盘中，点击 **驱动器**.

10. 使用与您安装驱动器位置相匹配的方法完成更换：

    **如果驱动器位于与原始驱动器相同的槽位：**

    1. 单击以 **选择新的（离线）驱动器**.
    2. 单击 **格式化** 位于左侧菜单中，然后确认。
    3. **等待** 直到格式化完成。
    4. 单击 **初始化** 位于左侧菜单中，然后确认。

    **如果驱动器位于不同槽位：**

    1. 单击以 **选择原始失效/缺失的驱动器条目** 列表中。
    2. 单击 **替换** 左侧菜单中的。
    3. 在对话框中， **从可用驱动器列表中选择新驱动器。** 从可用驱动器列表中选择新驱动器。
    4. 单击 **提交** 以确认。

{% hint style="success" %}
系统将开始修复过程。驱动器状态将变为“修复中”，仪表盘将显示一个 **预计修复完成日期和时间。**
{% endhint %}

***

## 场景 2：主动更换正常工作的驱动器

当驱动器仍可运行，但已显示警告迹象（例如磨损级别警告或重新分配扇区）且您希望在其失效前更换时，请使用此流程。

{% hint style="danger" %}
**注意：在开始驱动器修复操作之前，请确认：**

1. 包含待更换驱动器的节点处于 **维护模式**。所有其他节点必须在线且完全正常运行。

2. 同一存储层中的其他节点上没有正在进行的驱动器修复 *（同一物理节点上的修复是允许的）*.

3. 您已经准确识别出正确的物理驱动器（请参见 [确定用于更换的正确物理驱动器](#determine-the-correct-physical-drive-for-replacement) 上文）。

4. 替换驱动器是空的且兼容的（请参见本页顶部的警告）。
   {% endhint %}

5. **将** 包含故障驱动器的节点 **置于维护模式。**

6. 在节点仪表盘中，点击 **驱动器**.

7. **双击驱动器** 待更换。这样会进入该驱动器的仪表盘。

8. 单击 **关闭/下线** 在左侧菜单中。点击 *是*.

9. 当驱动器状态显示 **离线**, **物理移除** 该驱动器。

10. **验证** UI 会将驱动器显示为 *缺失*，以确认移除的是正确的驱动器。

11. **插入替换驱动器。** （如果您的系统需要先关闭节点，请遵循上面的 [热插拔与关机](#hot-swap-vs-shutdown-replacement) 步骤。）

12. **等待** 等待系统检测到新驱动器。新驱动器将显示为“离线”。

13. 使用与您安装驱动器位置相匹配的方法完成更换：

    **如果驱动器位于与原始驱动器相同的槽位：**

    1. 单击以 **选择新的（离线）驱动器**.
    2. 单击 **格式化** 位于左侧菜单中，然后确认。
    3. **等待** 直到格式化完成。
    4. 单击 **初始化** 位于左侧菜单中，然后确认。

    **如果驱动器位于不同槽位：**

    1. 单击以 **选择原始驱动器条目** （显示为 **缺失** 或 **离线**).
    2. 单击 **替换** 左侧菜单中的。
    3. 在对话框中， **从可用驱动器列表中选择新驱动器。** 从可用驱动器列表中选择新驱动器。
    4. 单击 **提交** 以确认。

{% hint style="success" %}
在 vSAN 完成一次完整遍历后，修复过程将开始，驱动器状态将变为“修复中”。驱动器仪表盘将指示一个 **预计修复完成日期和时间。**
{% endhint %}

***

## 在修复过程中

{% hint style="warning" %}
**重要**

以下内容适用于 **两者都** 更换场景：

* **在驱动器状态变为“在线”之前，切勿重启、重置或关闭任何节点** 。在修复过程中，所有其他节点必须保持完全正常运行。
* **不要发起其他驱动器替换/修复操作** ，直到本次操作完全完成，除非额外的驱动器位于同一节点或不同的存储层。
* **考虑继续保持维护模式：** 一旦驱动器开始修复，节点即可退出维护模式；不过，在整个期间保持维护模式开启可以加快修复过程。
  {% endhint %}

## 故障排除

如果 **替换** 选项不起作用，或者更换过程失败：

1. **重启节点电源** - 这有助于系统正确检测新驱动器并清除任何残留状态。
2. **验证驱动器兼容性** - 确保替换驱动器满足与原驱动器相同的规格（容量、接口类型、性能级别）。
3. **检查驱动器安装是否到位** - 确保新驱动器已正确安装在槽位中。
4. **联系支持** - 如果在重启电源后问题仍然存在，请联系 VergeOS 支持以获取帮助。


---

# 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/run-the-platform/zh/yun-wei/drive-replacement.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.