> 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/node-replacement.md).

# 使用 ISO 安装程序替换节点

本指南介绍如何通过将原始服务器中的驱动器移至替换硬件，并使用 VergeOS ISO 安装程序的 **替换节点** 选项，将新机箱重新注册到现有集群。

## 概述

{% hint style="info" %}
**关键要点**

* 此过程可替换节点机箱，同时 **重复使用原始节点驱动器** 在新硬件中
* 可用于替换故障节点，或主动淘汰已到使用寿命终点的硬件
* 需要与已安装系统版本相匹配的 VergeOS ISO 安装程序
* 一次只能替换一个节点
  {% endhint %}

{% hint style="warning" %}
**必须从原始节点移出驱动器**

此过程仅适用于将原始驱动器转移到替换节点的情况。如果需要替换节点 **和** 其驱动器，请联系 [VergeOS 支持](/overview/zh/support-and-services.md) 以获取帮助。
{% endhint %}

### 你将学到什么

* 如何安全地将节点下线并准备替换硬件
* 如何使用 VergeOS ISO 安装程序的 **替换节点** 选项
* 如何验证替换节点运行正常并重新加入集群

### 所需条件

* 一个现有且运行正常的 VergeOS 集群（正在替换的故障节点除外）
* 已安装所有驱动器的替换服务器（从原始节点转移而来）
  * 替换硬件必须与现有集群节点兼容；最好使用完全相同的硬件
* 包含与系统当前安装版本相匹配的 VergeOS ISO 安装程序的可启动介质
* VergeOS 系统的管理员级凭据

## 开始之前

* **一次仅替换一个节点。** 开始前请确认没有其他节点当前处于维护模式。
* **确认系统运行状况。** 继续操作前，请确保集群处于正常状态（所有 vSAN 层级均为绿色，且没有活动告警）。
* **规划工作负载迁移。** 如果其余节点拥有足够的计算资源，则可在不停机的情况下执行替换。操作过程中可将工作负载迁移到其他节点。
* **确保系统快照保留期足以支持可能的回滚。** 在替换过程开始前立即创建系统快照，或确认在需要时可使用近期的系统快照。

## 替换过程

### 第 1 步：将原始节点下线

具体方法取决于原始节点是否仍可正常运行。

**如果节点仍可正常运行：**

1. 在 VergeOS UI 中，导航至 **基础架构** > **节点**.
2. 双击该节点以打开其仪表板。
3. 单击 **启用维护模式** 位于左侧菜单中，然后确认。
4. 等待所有正在运行的工作负载迁移出该节点。监控 **正在运行的计算机** 部分，直至其为空。关闭所有无法迁移的工作负载。
5. 当节点处于维护模式且没有正在运行的工作负载时，将其关机。
6. 断开原始节点的所有网络电缆。

**如果节点已无法正常运行（系统中未检测到）：**

1. 如果节点尚未关闭，请将其关机。
2. 断开原始节点的所有网络电缆。

### 第 2 步：准备替换节点

1. 记录替换服务器上每个 NIC 的 MAC 地址，并注明每个物理端口对应的网络角色（例如 core1、core2、external）。在安装程序的 NIC 确认步骤中将需要这些信息。
2. 在替换节点 **关机**的情况下，连接所有网络电缆。新节点必须连接到与原始节点相同的网络。

### 第 3 步：从 VergeOS ISO 启动

1. 确保安装介质（例如包含 VergeOS ISO 的 USB 驱动器）已连接到替换节点。
2. 启动节点并从 ISO 引导。

   <div data-gb-custom-block data-tag="hint" data-style="success" class="hint hint-success"><p><strong>启动菜单</strong></p><p>您可能需要访问服务器的一次性启动菜单（通常为 <strong>F11</strong> 或 <strong>F12</strong> ，在 POST 期间）以选择 USB 设备。</p></div>
3. 出现安装程序菜单时，选择 **替换节点**.
4. 系统会检测到要替换的节点。确认已选择正确的节点，然后按 **输入**.

### 第 4 步：确认网络连接

安装程序会扫描网络并列出所有检测到的 NIC。检查每个条目，并验证显示的 MAC 地址是否与正确的网络角色（core1、core2、external 等）相匹配。

{% hint style="success" %}
**NIC 不匹配**

如果 NIC 分配看起来未连接到正确的网络，请退出安装程序并重新检查布线和交换机配置。修正所有连接后，重新启动至安装介质，并重新启动安装程序。
{% endhint %}

### 第 5 步：完成安装

1. 将出现一个对话框，询问您是否正在替换节点的驱动器。选择 **否** 以表示原始驱动器已移至此新机箱中。

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>替换节点及其驱动器时，请联系</strong> <a href="/spaces/qQVUXkFQ1hoPDgCmpeHZ/pages/4cefb24414afb309af2b2faf6d42d4b525d150f7"><strong>VergeOS 支持</strong></a><strong>.</strong></p></div>
2. 等待安装完全完成。安装程序会完成节点替换，并将新机箱注册到现有集群。安装完成时将显示一条消息，节点会自动重启。此过程通常需要 5 至 15 分钟。

## 替换后步骤

### 验证

1. **确认节点状态：** 导航到 **基础架构** > **节点** 并验证所有节点（包括替换节点）均显示为在线且状态正常（绿色）。

{% hint style="success" %}
**禁用维护模式**

如果被替换的节点显示 ***维护模式*** 状态，选择该节点并单击 **禁用维护模式** 左侧菜单中的。
{% endhint %}

2. **检查告警：** 导航到 **系统** > **告警** 并确认没有触发新的告警。
3. **验证网络连接：** 打开替换节点的仪表板（**基础架构** > **节点** > 双击该节点）。滚动至 **NIC** 部分。 **确认：**
   * 核心和外部网络连接的状态显示为 ***已启用***
   * 核心网络连接的 Fabric 状态显示为 ***已确认***

### 在已替换节点上启动工作负载

完全验证替换完成后，可根据需要将工作负载迁移回替换节点，或在替换节点上重新启动工作负载。

## 摘要

我们已通过将原始驱动器移至新硬件并使用 VergeOS ISO 安装程序的 **替换节点** 选项，成功替换了物理节点。替换节点现已注册到集群，并可随时运行工作负载。

## 故障排除

### 未找到合适的节点

**症状：**

* 安装期间出现错误，指示未找到可供替换的合适节点

**解决方法：**

* 原始节点必须关机或断开连接。仅将节点置于维护模式无法进行替换。
* 确认原始节点在 VergeOS UI 中未显示为“运行中”或“维护模式”，然后使用 VergeOS 安装 ISO 再次启动新节点。

### 替换安装未按预期完成

**症状：**

* 该过程在显示“正在停止 appserver”后停止，且未完成
* 安装过程进入命令行，并报告：“vergeos install cancelled”
* 系统日志条目：

  ```
  ybsan：向节点“node2”写入根密钥时出错：(5) 输入/输出错误
  ```

**解决方法：**

* 这些情况可能表示：
  * **权限不足：** 确认您使用的凭据具有管理员级权限
  * **网络配置错误：** 确认替换节点已正确连接到核心网络和外部网络。
* 进行必要调整后，您可以在不重启的情况下重新启动安装： `yb-install --restart`

## 其他资源

* [维护模式](/run-the-platform/zh/yun-wei/maintenance-mode.md)
* [节点概览](/run-the-platform/zh/xi-tong-guan-li/nodes-overview.md)
* [创建可启动安装介质](/plan-and-deploy/zh/shi-shi-zhi-nan/install-media.md)

{% hint style="info" %}
**需要帮助吗？**

如果遇到问题或有疑问，请联系 [VergeOS 支持](/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/node-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.