> 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/sop-verge-install.md).

# VergeOS 安装指南

本指南为 VergeOS 工程师和管理员在使用更新的安装程序界面执行初始系统安装时提供标准化流程和最佳实践。

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

安装您的 VergeOS 系统需要周密的规划和执行，以确保成功部署。本指南将该过程分为以下主要阶段：

1. **准备** - 安排安装之前需要采取的步骤
2. **安装前** - 安装前 24 小时内的最终检查
3. **安装** - 安装和配置系统的过程
4. **安装后** - 验证安装是否成功
   {% endhint %}

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

本指南涵盖通用最佳实践。您可能需要根据您的特定环境和需求调整这些步骤。请预留空间以适应节点数量、网络配置和其他需求。
{% endhint %}

## 前提条件

* 用于安装的硬件节点物理访问权限
* 网络基础设施已配置并可用
* 所有节点的 IPMI/远程管理访问权限
* VergeOS 许可证凭据
* **预计时间：** 4-8 小时，取决于配置复杂度

## 目标

完成 Node1 和 Node2+ 的初始安装，这是系统冗余和生产系统支持所需的最低配置。

## 准备阶段

在安排安装之前完成以下步骤：

### 硬件要求

* [ ] 确认硬件满足最低要求

{% hint style="info" %}
**硬件文档**

请参阅 [VergeOS 容量规划文档](/plan-and-deploy/zh/shi-shi-zhi-nan/sizing.md) 以获取当前和详细的要求。

\[ ] **CPU 要求：**

* [ ] 支持硬件虚拟化的 64 位 CPU \[ ] **内存要求：**
* [ ] 每个 vSAN 节点为操作系统预留 16GB RAM
* [ ] 每 1 TB 原始 vSAN 存储额外增加 1GB RAM；例如，具有 4TB 原始 vSAN 存储的节点需要 16GB+4GB = 20GB RAM/节点 \[ ] **IPMI/远程管理：**
* [ ] IPMI；iDRAC、iLO 或类似方案 \[ ] **磁盘控制器：**
* [ ] HBA 磁盘控制器（首选）
* [ ] 如果是 RAID 控制器：请确保它支持 JBOD/IT 模式
* [ ] 如果使用 NVMe，请确保控制器支持从 NVMe 启动 \[ ] **网络要求：**
* [ ] 每个 VergeOS UI/'External' 接口需要 1 个物理网络接口/节点
* [ ] 第二个同类型绑定对 *强烈* 建议用于冗余
* [ ] 每个 VergeOS Core Fabric 需要 1 个 10Gbps 或更高带宽的网络接口/节点
* [ ] 第二个同类型 *强烈* 建议用于冗余（不绑定）\[ ] **存储要求：**
* [ ] Tier0 存储（可选，推荐）
  * [ ] 基于 NVMe
  * [ ] 高写入耐久度（建议 3+ Drive Writes Per Day (DWPD)）
  * [ ] vSAN 中每 1TB 可用磁盘空间需要 5GB（推荐 10GB/1TB）
* [ ] 存储层级（1 个必需，> 可选）
  * [ ] 至少 1 个 PCIe 连接的 NVMe 存储层级 *强烈推荐*
  * [ ] 性能应满足工作负载预期
* [ ] 静态磁盘加密
  * [ ] 用于 vSAN 解密密钥的 USB 磁盘/节点（如需要）
    {% endhint %}

### 安装介质和文档

* [ ] 按照 [VergeOS 文档](/plan-and-deploy/zh/shi-shi-zhi-nan/install-media.md)
  * [ ] 创建安装介质
* [ ] 测试启动介质以验证其功能

{% hint style="info" %}
**记录并创建所有网络要求**

请参阅 [网络文档](/plan-and-deploy/zh/shi-shi-zhi-nan/network-design.md) VergeOS 网络设计文档

\[ ] **以获取当前和详细的网络要求。**

* [ ] Core 网络 VLAN1 已创建并记录
* [ ] Core 网络 VLAN2 已创建并记录 \[ ] **External 网络配置：**
* [ ] External 网络 VLAN1 已创建并记录
* [ ] External 网络 VLAN2 已创建并记录 \[ ] **IP 配置：**
* [ ] UI/管理 IP 地址已分配并记录
* [ ] 网关配置已记录
* [ ] DNS 服务器已识别并记录 \[ ] **网络设计/构建文档**
* [ ] 已创建并记录 A-B 线缆图
* [ ] 机架布局已记录
* [ ] 已创建网络二层设计文档/图纸
* [ ] 已创建网络三层设计文档/图纸
  {% endhint %}

### 系统访问和配置

* [ ] 验证所有节点的 IPMI 访问
* [ ] 检查 BIOS 设置要求
  * [ ] 已选择正确的启动方式（Legacy/Dual/UEFI） ***如果所有驱动器都是 NVMe，则需要 UEFI***
  * [ ] 已启用硬件辅助虚拟化
  * [ ] 已启用超线程
  * [ ] 已启用所有处理器核心
  * [ ] 时钟设置正确（所有节点相差在几秒内）

### 规划决策

* [ ] 通读此处描述的整个流程
* [ ] 准备完成整个流程所需的信息
* [ ] 决定 RAM 预留偏好：更多 *可用内存* **或** 更多 *强制执行 N+1 HA*
* [ ] 规划安装时间表并与相关方沟通

## 安装前阶段

在计划安装前 24 小时内执行以下检查：

### 当前状态验证

* [ ] 验证当前状态
  * [ ] 所有硬件已物理安装并通电
  * [ ] 所有网络线缆都通过“拉拽测试”
  * [ ] 交换机配置已完成并已测试
  * [ ] 已检查当前运行中的网络配置并完成 “write mem”
  * [ ] 所有节点均可访问 IPMI
  * [ ] 所需 IP 可用且未被占用
  * [ ] 交换机已配置巨型帧（MTU 9216+）

### 硬件最终检查

* [ ] BIOS 中显示所有驱动器
* [ ] BIOS 中显示所有 NIC
* [ ] 确认 MAC 与记录一致
* [ ] BIOS 中时间和日期正确
* [ ] 已启用虚拟化设置

### 网络最终检查

* [ ] Core 网络交换机有响应
* [ ] External 网络交换机有响应
* [ ] 没有冲突的 DHCP 服务器（如果使用 DHCP）
* [ ] 具有故障排除所需的文档

## 执行阶段

### 主控制器安装

按安装程序顺序执行的实际安装过程：

* [ ] 从 USB 安装介质启动
* [ ] 选择“Standard Install”
* [ ] 选择“Controller”
* [ ] 选择“New Install”

### 系统配置

**NTP 配置：**

* [ ] 输入以空格分隔的 NTP 服务器列表，或保留默认值

**日期/时间配置：**

* [ ] 仔细确认当前日期
* [ ] 非常仔细地确认当前时间（Node 1 控制系统的 NTP）

**系统标识：**

* [ ] 输入您的系统名称。（安装后可更改）

### 管理员账户配置

* [ ] 输入您的管理员用户名，或保留默认值
* [ ] 输入管理员账户密码（应生成并存储在您的密码库中）
* [ ] 设置管理员账户电子邮件地址（可选，但建议）

### 网络接口配置

**Core 网络接口：**

* [ ] 选择 Core1 网络接口
* [ ] 按需要配置 Core1 接口名称、MTU、Core（保持“是”）和 VLAN
* [ ] 选择 Core2 网络接口
* [ ] 按需要配置 Core2 接口名称、MTU、Core（保持“是”）和 VLAN

**External 网络接口：**

* [ ] 选择 External 网络接口
* [ ] 配置 External 网络名称、MTU（通常为 1500）、Core（改为“否”）。
* [ ] 配置 External VLAN（如需要）
* [ ] 设置 External IP（CIDR 格式）
* [ ] 设置 External 网关
* [ ] 设置 External DNS 服务器

### 许可证配置

* [ ] 选择许可证服务器（生产或试用/NFR）
* [ ] 输入许可证用户凭据
* [ ] 输入许可证密码（安全存储在密码库中）

### 存储配置

**vSAN 加密：**

* [ ] 选择 vSAN 加密设置（是/否）
* [ ] 如启用，请记录加密密钥（安全存储在密码库中）
* [ ] 创建 USB 加密盘（如果使用 vSAN 加密，强烈推荐）

**vSAN 磁盘选择与层级分配：**

* [ ] 选择用于安装的 vSAN 磁盘
* [ ] 将磁盘分配到适当的存储层级（按安装准备阶段的计划）

**交换配置：**

* [ ] 按需要配置交换分配
* [ ] 安装程序完成后，请移除 USB 介质
* [ ] 重启

### 主节点验证

* [ ] 系统在控制台启动到“蓝色”界面
* [ ] 可通过配置的 IP 地址访问 UI
* [ ] UI 中所有状态指示均为绿色
* [ ] vSAN 已挂载且健康

## 从控制器安装第二控制器

* [ ] 从 USB 安装介质启动第二节点
* [ ] 选择“Controller”
* [ ] 新安装选择“No”
* [ ] 输入主控制器的管理员凭据
* [ ] 确认网络自动检测（如果检测到的 IP 或接口与预期不符，请停止！）
* [ ] 与主控制器匹配加密设置
* [ ] 与主控制器匹配磁盘层级分配

### 第二节点验证

* [ ] 系统在控制台启动到“蓝色”界面
* [ ] Node2 在主 UI 中可见
* [ ] 所有状态指示均为绿色
* [ ] 两个节点上的 vSAN 状态均为绿色

## 安装后验证

安装完成后，验证系统是否正常运行：

### 系统健康检查

* [ ] 所有仪表板指示灯均为绿色
* [ ] 仪表板日志中没有意外的警报或警告
* [ ] 所有节点显示正确版本
* [ ] 所有节点均处于“Running”状态（检查每个单独节点）
* [ ] 没有待处理的节点重启
* [ ] 所有层级的 vSAN 健康状态均为绿色
* [ ] Core Fabric 连接性已验证
* [ ] External 网络连接性已验证

### 系统配置验证

* [ ] 已设置默认 VM 存储层级
* [ ] 已配置集群目标最大 RAM 百分比
* [ ] 已配置站点同步（如需要）
* [ ] 系统已激活并保持最新
* [ ] SMTP 服务器已设置（强烈推荐）
* [ ] 已配置管理员用户电子邮件通知

### 最终测试

* [ ] 测试 VM 创建和基本操作
* [ ] 验证测试 VM 的网络连接
* [ ] 确认快照功能
* [ ] 如适用，测试系统备份/恢复

## 故障排除

### 常见问题

**启动问题：**

* 验证 BIOS 启动设置与安装介质类型匹配
* 在已知正常工作的系统上检查 USB 介质功能
* 确认硬件与 VergeOS 兼容

**网络配置问题：**

* 验证 VLAN 配置与网络设计一致
* 检查物理线缆连接和交换机配置
* 确认 IP 地址分配不会与现有基础设施冲突

**存储配置问题：**

* 验证磁盘控制器处于 JBOD/IT 模式
* 检查 BIOS 中的磁盘可见性
* 确认存储层级分配与规划文档一致

**加入第二节点问题：**

* 验证节点之间的网络连接
* 检查管理员凭据是否正确
* 确认在添加第二节点之前主节点已完全正常运行

## 下一步

成功完成安装后：

* [ ] 安排初始系统备份
* [ ] 配置监控和告警
* [ ] 使用最终配置更新网络文档
* [ ] 规划租户创建和资源分配
* [ ] 如需要，安排管理员培训
* [ ] 为运维团队记录最终系统配置

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

如果您的 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/sop-verge-install.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.