> 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/vsan-scale-up-sop.md).

# VergeOS vSAN 横向扩展指南

本指南提供在 VergeOS 系统中通过向现有节点添加驱动器来安全扩展存储容量的最佳实践。它通过一种系统化的方法，重点关注数据安全和系统韧性。

{% hint style="warning" %}
**缩减 vSAN 存储需要支持**

本指南涵盖 **添加** 驱动器以增加容量。 **移除驱动器以减少 vSAN 容量并不是一个自助操作。** 由于安全重新分配数据的复杂性，移除驱动器必须与 VergeOS 支持团队协调。 [提交支持工单](/overview/zh/support-and-services.md) 以发起缩减请求。
{% endhint %}

{% hint style="info" %}
**概述**

扩展 vSAN 需要仔细规划和执行，以确保对您的服务影响最小。本指南将该过程分为以下主要阶段：

1. **准备** - 在计划维护窗口之前要执行的步骤
2. **扩容前验证** - 在开始扩容前立即进行的最终检查
3. **扩容执行** - 添加和配置新存储的过程
4. **扩容后验证** - 确保扩容成功
   {% endhint %}

{% hint style="info" %}
**特定环境要求**

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

## 前提条件

* 对 VergeOS 系统的管理访问权限
* 集群中所有节点的 IPMI 访问权限
* 已正确测试和验证的新存储驱动器
* 用于安装驱动器的节点物理访问权限

## 准备阶段

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

### 系统就绪性

* [ ] 确保系统快照保留足够，以便在需要时回滚
* [ ] 为您的工作负载设定明确的成功和验证标准

### 硬件准备

* [ ] 在非生产硬件上预先测试磁盘
* [ ] 新磁盘的容量与现有磁盘相同或更大
  * 且性能相同
* [ ] 验证驱动器与现有硬件的兼容性
* [ ] 确保您为存储层的每个成员节点准备了足够的新驱动器

### 文档与规划

* [ ] 更新平台文档，记录计划中的驱动器添加
* [ ] 记录当前 vSAN 配置以供参考
* [ ] 为受影响用户规划沟通时间表
* [ ] 确保在需要使用存储之前，有足够的时间让 vSAN 完成修复

### 资源验证

* [ ] 检查集群资源利用率
  * 对于 HCI 系统（存储+计算合并节点），请确保有足够的空闲内存来重启 1 个节点
  * 对于 UCI 系统（专用存储节点），请确保存储集群上没有运行任何工作负载
* [ ] 确认节点之间的网络路径
  * 从 Node1：Node Diagnostics -> 'Fabric Configuration' 报告所有节点的 Core1 和 Core2 路径为 'confirmed:true'
  * 从 Node2 验证相同结果
* [ ] 通过一种允许在紧急情况下进行控制台访问的方法，确认所有节点的 IPMI 访问权限

## 扩容前验证

在计划维护当天、开始扩容之前执行这些检查：

### 当前状态验证

* [ ] 确保没有大型存储操作正在进行（VMware 备份、导入、NAS 文件复制、站点同步）
* [ ] 资源可用性 - 系统为 N+1
  * 验证 RAM 使用量足以在有 1 个节点离线时运行工作负载（HCI 系统）
  * 验证正在扩容的 vSAN 层使用率低于 70%
* [ ] 系统快照是最新且可用的
  * 将最近的快照设置为在未来几天后过期，以增加保留时间
* [ ] 确认出站同步（如已配置）是最新的
  * 将最近的远程快照设置为在未来几天后过期，以增加保留时间
* [ ] 验证所有 vSAN 层都处于健康状态（绿色状态）
* [ ] 确认没有节点正在等待重启
* [ ] 验证 Node1 的 'Fabric Configuration' 诊断报告所有节点的 Core1 和 Core2 路径为 'confirmed:true'
* [ ] 验证 Node2 的 'Fabric Configuration' 诊断报告所有节点的 Core1 和 Core2 路径为 'confirmed:true'

## 执行阶段

### 添加新存储

有关执行 vSAN 扩容的详细分步说明，请参阅：

[扩展 vSAN](/knowledge-base/zh/storage-vsan/scaling-up-a-vsan.md)

### 关键流程概览

1. **将节点置于维护模式** （如果不支持热插拔）
2. **关闭目标节点电源** （如果不支持热插拔）
3. **安装新驱动器** 遵循制造商指南
4. **启动节点电源** 并验证驱动器是否被检测到
5. **将驱动器添加到 vSAN 层** 通过 VergeOS UI
6. **监控层修复进度** - 这可能需要较长时间

{% hint style="warning" %}
**关键等待期**

在扩容过程中，vSAN 层在修复阶段会显示黄色状态。在继续处理下一台节点之前，必须等待 vSAN 层恢复为“绿色”健康状态。
{% endhint %}

{% hint style="success" %}
**监控进度**

在 VergeOS UI 中，进入 System -> vSAN 监控 vSAN 修复进度。该过程会显示完成状态和可用容量更新。
{% endhint %}

7. **对每个存储节点重复执行** 直到完成

## 扩容后验证

扩容完成后，验证系统运行正常：

### 系统健康检查

* [ ] 验证所有新驱动器都已被识别并添加到相应的 vSAN 层
* [ ] 确认 UI 中反映出的存储容量已增加
* [ ] 验证 vSAN 层显示绿色状态
* [ ] 根据您的成功标准按需测试/确认来宾系统
* [ ] 检查日志中是否有新的或意外的事件
* [ ] 验证准备步骤中概述的所有成功标准
* [ ] 确认数据在所有驱动器之间均匀分布

## 故障排除

### 常见问题

**vSAN 层在较长时间后仍保持黄色**

* 验证所有新驱动器已正确安装到位并被检测到
* 检查日志中的驱动器错误
* 确保有足够的网络带宽用于修复
* 如果修复停滞，请联系支持
* 根据总数据量和驱动器速度等多种因素，vSAN 修复可能需要数小时、数天甚至更久

**新驱动器未被检测到**

* 验证驱动器是否已物理安装正确
* 如适用，请检查磁盘控制器配置
* 确认驱动器与现有硬件兼容
* 检查系统日志中的硬件检测问题

**修复期间性能下降**

* VergeOS 会尽一切努力在修复期间优先保障工作负载存储
* 考虑在维护窗口期间尽量减少工作负载，以降低任何可能的影响
* 监控系统资源

## 回滚流程

{% hint style="danger" %}
**紧急支持**

如果您的 VergeOS vSAN 扩容遇到任何问题，请联系 [我们的支持团队](/overview/zh/support-and-services.md) 以获取即时协助。
{% 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/run-the-platform/zh/yun-wei/vsan-scale-up-sop.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.