概述

关于本文档

本文档介绍如何完成 ZSphere 的部署前准备、管理节点安装、管理节点 HA 设置、基础服务检查、首次登录和环境初始化。

目标读者

本文档的目标读者是负责部署和初始化 ZSphere 的管理员、实施工程师和运维工程师。读者需要了解服务器硬件、基础网络、操作系统安装和虚拟化基础设施部署流程。

安装模式

ZSphere 提供三种安装模式。不同安装模式的安装内容和适用场景不同。

安装模式	安装内容	适用场景
管理节点模式	基础操作系统 `MariaDB`、`CloudBus`消息总线等依赖包	适用于安装为虚拟化平台的管理节点。
计算节点模式	基础操作系统 `libvirt`、`QEMU`等虚拟化组件	适用于安装为除管理节点外的其他节点，例如：计算节点单机镜像存储、分布式镜像存储、分布式镜像存储监控节点分布式存储节点、分布式存储监控节点
专家模式	基础操作系统

规划与准备

安装 ZSphere 前，需要完成硬件、网络、软件包和服务器配置准备，确保服务器能够从安装介质启动，并满足管理节点、计算节点以及后续业务资源的部署要求。

本章介绍部署前需要确认的基础条件，包括硬件设备要求、网络规划、软件包准备、安装介质制作和服务器配置。完成这些准备后，可以开始安装管理节点。

硬件设备要求

基础硬件要求

服务器的 CPU、内存、存储大小以及网卡性能等配置决定了 ZSphere 的业务承载能力。

基础演示环境：服务器 CPU 核心数至少为 4 核、内存至少为 8 GB。
生产环境：
- 管理节点配置：小规模场景下，服务器 CPU 核心数至少为 8 核、内存至少为 16 GB、存储至少为 240 GB。
  服务器的实际硬件配置要求需根据用户的业务规模确定，详情请咨询官方技术支持。
- 计算节点配置：服务器的实际硬件配置要求需根据用户的业务规模确定，详情请咨询官方技术支持。

设备	配置需求
服务器	CPU	x86 架构：64 位，且支持 Intel VT-x 或 AMD-V 硬件虚拟化特性（如 Intel VMX 或 AMD/Hygon SVM） ARM 架构：64 位，且支持硬件虚拟化特性
内存	无特殊要求。推荐配置 DDR4 或更高规格内存
主板	标准双路服务器主板
阵列卡	需支持 SAS/SATA RAID 0/1/10，且支持直通模式
硬盘	无特殊要求。可根据容量与性能需求，选配机械硬盘或固态硬盘
网口	管理网口：1 × 1 GbE RJ45 业务网口：1 × 10 GbE SFP+
网络交换机	至少提供 1 台千兆交换机，推荐万兆交换机随附五类及以上等级网线若干

硬件规划

您需要根据生产环境的实际业务需求，妥善规划服务器资源。在资源充足的大型数据中心场景，推荐将两台服务器作为管理节点，用于管控整个虚拟化平台。这两个管理节点可提供管理节点高可用功能，当其中任何一个管理节点失联，系统将自动触发秒级高可用切换，从而保障管理节点持续提供服务。在小型数据中心场景，也可仅选择一台服务器作为管理节点。

其余服务器作为计算节点。在大型数据中心场景，可选择多台计算节点作为镜像存储以扩展镜像存储容量和吞吐率。在小型数据中心场景，镜像存储可以和管理节点共用一台服务器。

网络规划

一个典型的数据中心通常由若干台不同功能的服务器和两个独立的网络环境构成。

管理网络采用双千兆网络，用于管理虚拟化平台相关的硬件资源。业务网络采用双万兆网络，用于虚拟机的业务流量。网络速率可根据实际业务需求进行配置。
若您使用 NFS 或分布式存储等网络存储，还应额外规划存储网络，用于承载存储流量。
建议所有服务器的网卡命名保持一致，并使用相同名称的网卡承载相同的网络流量，例如：管理网流量都使用em1网卡。
若您使用 VLAN 网络环境，需提前在交换机上配置对应的 VLAN 网络通讯。
ZSphere 会主动为虚拟机分配 IP 地址，需提前预留一段和系统不冲突的 IP 网络段，同时避免该网络段与原有网络环境中的 DHCP 服务冲突。

准备软件包

软件包说明

ZSphere ISO 以自研的 Helix 为底座。Helix 是运行在基础设施层和上层客户操作系统之间的虚拟化内核软件，集成硬件驱动、宏内核、虚拟代理等必要组件。当上层各类客户操作系统对底层硬件资源进行访问时，Helix 可屏蔽底层异构硬件的差异，使客户操作系统免除对最底层物理硬件的驱动依赖，并增强虚拟化运行环境中的硬件兼容性、高可靠性、高可用性、可扩展性、运行性能。

安装 ZSphere 无需连接公网，也无须配置 yum 源，可完全离线安装。

软件包清单

安装 ZSphere 使用的软件包如下表所示：

服务器架构	软件包名称
x86	ZStack-ZSphere-x86_64-DVD-5.1.0-H84r.iso
x86	ZStack-ZSphere-x86_64-DVD-5.1.0-KylinV10SP3.iso
ARM	ZStack-ZSphere-aarch64-DVD-5.1.0-H22e.iso
ARM	ZStack-ZSphere-aarch64-DVD-5.1.0-KylinV10SP3.iso

Note: 获取软件后，请通过 MD5 校验工具核对校验码，以确保软件完整无损。

制作安装介质

获取 ZSphere ISO 镜像文件后，需要将 ISO 镜像文件刻录到 U 盘，用于从物理服务器启动安装程序。

您可以根据本地操作系统和工具使用习惯，选择使用 Rufus 或 Fedora Media Writer 制作安装介质。制作完成后，请在服务器 BIOS 或启动菜单中将 U 盘设置为启动介质。

使用 Rufus 刻录 ISO 镜像文件

获取 ISO 软件包后，可使用 Rufus 软件将 ISO 镜像刻录到 U 盘。

操作步骤

选择 ISO 镜像。
1. 接入 U 盘，然后打开 Rufus。
2. 在引导类型选择列表，选择镜像文件（请选择）。
3. 点击选择，打开已获取到的 ISO 镜像文件。
图 3. 选择 ISO 镜像
刻录镜像。
1. 选择好 ISO 镜像后，保持其他选项为默认设置不变，然后点击开始。
2. 确认风险提示信息。
  
  Note: 刻录镜像会格式化 U 盘数据，若您的 U 盘中存有重要数据，请在格式化前做好备份。
3. 点击确定，Rufus 会把 ISO 镜像刻录到 U 盘。
图 4. 刻录镜像

后续操作

刻录完成后，即可使用U盘作为启动盘，支持Legacy模式和UEFI模式引导。

使用 Fedora Media Writer 刻录 ISO 镜像文件

获取 ISO 软件包后，若使用麒麟操作系统，建议使用 Fedora Media Writer 软件刻录 ISO 镜像。

操作步骤

选择 ISO 镜像。
1. 接入 U 盘，然后打开 Fedora Media Writer。
2. 点击自定义镜像，打开已获取到的 ISO 镜像文件。
图 5. 选择 ISO 镜像
刻录镜像。
1. 选择好 ISO 镜像后，保持其他选项为默认设置不变，然后点击写入磁盘。
  
  Note: 刻录镜像会格式化 U 盘数据，若您的 U 盘中存有重要数据，请在格式化前做好备份。
图 6. 刻录镜像

后续操作

刻录完成后，即可使用U盘作为启动盘，支持Legacy模式和UEFI模式引导。

配置服务器

服务器配置检查

根据实际网络规划，管理员需将前述服务器和网络设备进行上架、连线并加载电源。随后管理员需启动服务器进入 BIOS，检查以下内容：

安装过程将覆盖所有数据，请确认服务器内的硬盘数据已备份。
进入服务器 BIOS，开启 CPU VT 和超线程 HT 选项。
进入阵列卡配置合适的 RAID 级别，以提供一定的数据冗余特性。
设置 U 盘为第一启动顺序。

有关如何更改服务器配置的信息，请参阅硬件供应商文档。

安装管理节点

管理节点用于承载 ZSphere 管理服务、Web UI 和基础控制服务，是完成平台部署和后续资源管理的入口。

您可以根据网络规划和部署场景选择安装方式。生产环境通常使用 Bond 网卡部署，以提升管理网络可靠性；简单验证或单网卡环境可使用单网卡部署；需要在安装后通过文本界面配置管理节点时，可使用 TUI 安装路径。

安装完成后，请继续检查 ZSphere 服务状态，并根据业务连续性要求决定是否设置管理节点 HA。

Bond 网卡部署

为了满足网口带宽容量和高可靠需要，在实际生产环境中需实施网卡 Bond 配置操作。x86 服务器与 ARM 服务器安装操作系统流程一致，本章以 x86 服务器为例介绍系统安装的详细步骤。

操作步骤

选择引导项。
进入 ISO 系统引导界面，选择默认选项开始安装操作系统。您可根据实际情况选择，建议使用图形界面安装。若服务器无 VGA 接口，仅支持串口连接，您可使用 VNC 方式或字符安装方式。
- 图形界面方式
- VNC 方式
- 字符安装方式
图 7. 系统引导
查看安装配置汇总。
此页面展示系统安装配置，您可按需修改，ZSphere 默认已配置以下内容：
- Keyboard：默认 English (US)
- Language Support：默认 English (United States)
- Time & Date：默认亚洲东八区，建议管理员提前检测主机时间，配置为当前时间和时区
图 8. 安装系统界面
选择安装模式。
1. 在 INSTALLATION SUMMARY 界面，点击 Software Selection。
2. 在 SOFTWARE SELECTION 界面，选择安装模式。
  管理节点所在服务器选择Management Node模式，其余节点所在服务器选择Compute Node模式。
3. 选择完安装模式后，点击 Done。
图 9. 选择安装模式
配置硬盘分区。
1. 在 INSTALLATION SUMMARY 界面，点击 Installation Destination，进入 INSTALLATION DESTINATION 界面。
2. 对于 Device Selection，建议此处仅配置系统盘，其余磁盘可在系统安装后配置。
3. 对于 Storage Configuration，建议选择 Automatic 自动配置硬盘分区。
  若您需手动配置，可根据 BIOS 引导模式参考以下内容：
  - UEFI 模式：
    - /boot：存放 Linux 启动所需的核心文件，建议分配 1 GB 空间
    - /boot/efi：存放 UEFI 启动引导文件，建议分配 500 MB
    - swap：交换区，建议分配 32 GB
    - /：Linux 系统根目录，建议分配全部剩余空间
  - Legacy 模式
    - /boot：存放 Linux 启动所需的核心文件，建议分配 1 GB 空间
    - swap：交换区，建议分配 32 GB
    - /：Linux 系统根目录，建议分配全部剩余空间
  Note:
  - 以上数值为 ZSphere 建议分区容量（磁盘总容量大于 300 GB）。
  - Legacy 模式下，若系统盘容量大于 2 TB，需配置 BIOS boot 分区，以支持 GPT 分区。UEFI 模式没有此限制，且支持 GPT 分区。
4. 确认配置无误后，点击 Done。
图 10. 配置硬盘分区
添加 Bond 设备。
1. 在 INSTALLATION SUMMARY 界面，点击 Network & Host Name。
2. 在 NETWORK & HOST NAME 界面，点击页面左下角的 + 按钮，弹出 Add device 弹窗，在下拉菜单中选择 Bond，然后点击 Add。
图 11. 添加 Bond 设备
添加 Bond Slave。
1. 在 Bond 配置弹窗中，按需调整 Connection name 命名。
  
  Note: 请确保 Connection name 和 Interface name 保持一致。
  
  图 12. 调整 Connection name
2. 在 Bond 配置弹窗中，点击 Add，添加 Bond Slave。
  图 13. 添加 Bond Slave
3. 弹出 Choose a Connection Type 弹窗，在下拉菜单中选择连接类型，如 Ethernet，然后点击 Create...。
  图 14. 选择 Bond Slave 连接类型
4. 弹出 Editing bond0 slave1 弹窗，在弹窗的 Ethernet 子页面，点击 Device 下拉菜单按钮，选择需要绑定的 Slave 设备，如 ens3 (相应MAC地址)，其它选择默认或按需自定义设置，然后点击 Save。
  图 15. 选择 Bond Slave 设备
选择 Bond 模式。
在 Bond 配置弹窗的 Mode 下拉菜单中，按需选择 Bond 模式，如 Active backup（主备模式），其它选择默认或按需自定义设置，然后点击 Save。

图 16. 选择 Bond 模式
原网卡禁用 IPv4。
1. 选择原网卡，如 Ethernet (ens3)，点击 Configure。
  图 17. 配置原网卡
2. 弹出 Editing ens3 弹窗，点击 IPv4 Settings，进入 IPv4 Settings 子页面。将 Method 参数值改为 Disabled，然后点击 Save。
  图 18. 禁用 IPv4
配置 Bond 静态 IP 地址。
1. 在 NETWORK & HOST NAME 界面，选择 Bond 设备，如 Bond (bond0)，然后点击 Configure。
2. 弹出 Editing bond0 弹窗，点击 IPv4 Settings，进入 IPv4 Settings 子页面。将 Method 参数值改为 Manual，用于切换 IP 地址获取方式为手动指定。
  
  Note: 您可按需配置 IP 地址获取方式，包括使用 DHCP 自动获取、手动指定等。
3. 点击 Add 添加 IP 地址条目，根据按需配置 IP 地址、子网掩码、网关地址，完成后点击 Save保存配置。
图 19. 配置 Bond 静态 IP 地址
配置网卡自动激活。
在 Editing bond0 弹窗，点击 General，进入 General 子页面。勾选 Connect automatically with priority，用于设置网卡自动激活，然后点击 Save。

图 20. 配置网卡自动激活
完成 Bond 配置。
1. 检查 Bond 配置项，必须保证 On 开启且配置了 IP 地址，同时 Bond Slave (如 ens3) 也 On 开启，否则 ZSphere 无法正常安装。
2. 确认配置无误后，点击 Done，返回 INSTALLATION SUMMARY 界面。
图 21. 检查 Bond 配置
在 INSTALLATION SUMMARY 界面，点击 Root Password，设置操作系统 root 密码。
在 INSTALLATION SUMMARY 界面，点击 Begin Installation，开始安装操作系统。

单网卡部署

x86 服务器与 ARM 服务器安装操作系统流程一致，本章以 x86 服务器为例介绍系统安装的详细步骤。

操作步骤

选择引导项。
进入 ISO 系统引导界面，选择默认选项开始安装操作系统。您可根据实际情况选择，建议使用图形界面安装。若服务器无 VGA 接口，仅支持串口连接，您可使用 VNC 方式或字符安装方式。
- 图形界面方式
- VNC 方式
- 字符安装方式
图 22. 系统引导
查看安装配置汇总。
此页面展示系统安装配置，您可按需修改，ZSphere 默认已配置以下内容：
- Keyboard：默认 English (US)
- Language Support：默认 English (United States)
- Time & Date：默认亚洲东八区，建议管理员提前检测主机时间，配置为当前时间和时区
图 23. 安装系统界面
选择安装模式。
1. 在 INSTALLATION SUMMARY 界面，点击 Software Selection。
2. 在 SOFTWARE SELECTION 界面，选择安装模式。
  管理节点所在服务器选择Management Node模式，其余节点所在服务器选择Compute Node模式。
3. 选择完安装模式后，点击 Done。
图 24. 选择安装模式
配置硬盘分区。
1. 在 INSTALLATION SUMMARY 界面，点击 Installation Destination，进入 INSTALLATION DESTINATION 界面。
2. 对于 Device Selection，建议此处仅配置系统盘，其余磁盘可在系统安装后配置。
3. 对于 Storage Configuration，建议选择 Automatic 自动配置硬盘分区。
  若您需手动配置，可根据 BIOS 引导模式参考以下内容：
  - UEFI 模式：
    - /boot：存放 Linux 启动所需的核心文件，建议分配 1 GB 空间
    - /boot/efi：存放 UEFI 启动引导文件，建议分配 500 MB
    - swap：交换区，建议分配 32 GB
    - /：Linux 系统根目录，建议分配全部剩余空间
  - Legacy 模式
    - /boot：存放 Linux 启动所需的核心文件，建议分配 1 GB 空间
    - swap：交换区，建议分配 32 GB
    - /：Linux 系统根目录，建议分配全部剩余空间
  Note:
  - 以上数值为 ZSphere 建议分区容量（磁盘总容量大于 300 GB）。
  - Legacy 模式下，若系统盘容量大于 2 TB，需配置 BIOS boot 分区，以支持 GPT 分区。UEFI 模式没有此限制，且支持 GPT 分区。
4. 确认配置无误后，点击 Done。
图 25. 配置硬盘分区
开始配置网卡。
1. 在 INSTALLATION SUMMARY 界面，点击 Network & Host Name，进入 NETWORK & HOST NAME 界面。
2. 在左侧网卡列表，选择网卡，例如 Ethernet (ens3)。
3. 点击 Configure。
图 26. 配置网卡
配置网卡静态 IP 地址。
1. 在 Editing ens3 弹窗中，点击 IPv4 Settings。
2. 对于 Method，按需选择 IP 地址获取方式，例如选择 Manual 手动指定 IP 地址。
3. 点击 Add 添加 IP 地址条目，按需配置 IP 地址、子网掩码、网关地址。
图 27. 配置静态 IP 地址
配置网卡自动激活。
1. 在 Editing ens3 弹窗中，点击 General，然后勾选 Connect automatically with priority，用于设置网卡自动激活。
2. 确认配置无误后，点击 Save。
图 28. 配置网卡自动激活
完成网卡配置。
1. 返回 NETWORK & HOST NAME 界面，确认网卡选择正确，并且网卡状态为 ON。
2. 点击 Done，返回 INSTALLATION SUMMARY 界面。
图 29. 检查网卡配置
在 INSTALLATION SUMMARY 界面，点击 Root Password，设置操作系统 root 密码。
在 INSTALLATION SUMMARY 界面，点击 Begin Installation，开始安装操作系统。

使用 TUI 安装

本章介绍通过 ISO 部署计算节点模式，并在 TUI 中将管理网络配置为 bond，最终在该计算节点上安装管理节点的完整流程。

操作步骤

选择引导项。
进入 ISO 系统引导界面，选择默认选项开始安装操作系统。您可根据实际情况选择，建议使用图形界面安装。若服务器无 VGA 接口，仅支持串口连接，您可使用 VNC 方式或字符安装方式。
- 图形界面方式
- VNC 方式
- 字符安装方式
图 30. 系统引导
进入 INSTALLATION SUMMARY 安装向导。
自动加载安装引导界面后，最终进入 INSTALLATION SUMMARY 页面。此页面需重点关注三个配置项：Installation Destination、Software Selection、Root Password。

图 31. INSTALLATION SUMMARY 总览
配置 Installation Destination。
1. 点击 Installation Destination。
2. 在 Local Standard Disks 中选择一块磁盘作为系统盘。
3. Storage Configuration 保持默认 Automatic。
4. 点击左上角 Done 返回。
图 32. 选择系统盘
配置 Software Selection。
1. 点击 Software Selection。
2. 在 Base Environment 中选择 Compute Node 计算节点模式。
3. 点击左上角 Done 返回。
图 33. 选择计算节点模式
配置 Root Password。
1. 点击 Root Password。
2. 输入并确认 root 密码。
  
  密码强度需符合提示要求。
3. 点击 Done 返回。
启动安装并等待完成。

确认所有红框标识项均已配置完成(不再有黄色警告条)，点击右下角 Begin Installation 开始安装。

图 34. 开始安装

安装过程将自动完成，期间无需手动干预。安装完成后系统会重启并进入 TUI 界面。
进入 TUI 主界面并完成 root 身份认证。
TUI 界面分为四个信息区域：
- NODE INFO：节点运行时间、负载、CPU、内存使用率。
- DISK INFO：磁盘挂载点和容量。
- NIC INFO：网卡名称及 IP，首次启动会显示默认网卡。如 ens3。
- VM INFO：当前节点上的虚拟机列表。
界面底部提示快捷键：
- <F2> System Configuration：进入系统配置。
- <F12> Reboot/Poweroff：重启或关机。
图 35. TUI界面
1. 按 F2 进入系统配置，弹出 ROOT PASSWORD 验证框。
2. 输入 root 密码并按 Enter 确认。
图 36. 输入 root 密码进行身份验证
进入 Configure Networks 配置项。
通过身份验证后进入 System Configuration 菜单。
1. 使用方向键选择 Configure Networks 后按 Enter。
2. 在弹出的 CONFIGURE NETWORKS 对话框中，选择需要配置的物理网卡(如 ens3)。
3. 将键盘切换至大写状态。
4. 按字母 A 键，触发 Link <A>ggregation 链路聚合操作。
  
  Note: 必须确保键盘已切换至大写状态，否则按 A 不会触发 Bond 创建流程。
图 37. 选择网卡并触发 Link Aggregation
选择 Bond 模式。
1. 弹出 CONFIGURE BOND 对话框，选择 Bond 模式。
2. 本章示例选择 Active-Backup，按 Enter 确认。
图 38. 选择 Active-Backup Bond 模式
命名 Bond 并选择 Slave 网卡。
进入 CONFIGURE BOND SLAVE 对话框，完成以下设置。
1. 在 BOND NAME 中输入 Bond 名称，如 bond0。
2. 在 Select SLAVES 中，使用方向键移动到目标网卡，按空格键选中。
  
  选中后显示 [X] 标记。
3. 全部选择完成后按 Enter 确认。
图 39. 输入 Bond 名称并选中 Slave 网卡
确认 Bond 配置。
系统弹出 CONFIGURE BOND NETWORK CONFIRM 警告框，提示以下信息：
```
Be careful! Changing the network configuration may cause failure!
If you know what you are doing, then enter 'Y' to continue!
```
1. 将键盘切换至大写状态。
2. 按字母 Y 键确认配置。
  
  图 40. 确认 Bond 网络配置
3. 成功后弹出 SUCCESS 提示框，提示 Network configuration is changed successfully!，按 Enter 关闭。
  
  图 41. Bond 创建成功
选择 Bond 进入 IP 配置。
回到 Configure Networks 对话框。
1. 在网卡列表中选择上一步创建的 Bond (如 bond0)。
2. 按 Enter 进入 IP 配置。
图 42. 选择 bond0 进行 IP 配置
配置管理网 IP 地址。
1. 在 CONFIGURE NETWORK 对话框中，参考示例依次填写以下字段：
  - VLAN ID：输入管理网 VLAN ID，无 VLAN 留空。
  - IP ADDR：输入管理网 IP 地址，例如 172.26.215.195
  - NETMASK：输入子网掩码，例如 255.255.0.0
  - GATEWAY(DEF)：输入默认网关，例如 172.26.0.1
2. 按 Enter 确认。
图 43. IP 配置示例
确认 IP 配置。
1. 按 Enter 提交，弹出 CONFIGURE NETWORK CONFIRM 二次确认。
2. 键盘切换至大写状态。
3. 按字母 Y 键确认。
  
  图 44. IP 配置二次确认
4. 弹出 SUCCESS 提示框，按 Enter 关闭。
  
  图 45. IP 配置成功
进入 Install ZStack 选项。
1. 按 Esc 键，回到 System Configuration 菜单，
2. 使用方向键选择 Install ZStack。
3. 按 Enter。
图 46. 进入 Install ZStack 选项
确认安装管理节点。
系统弹出 INSTALL ZStack 警告框，提示以下信息：
```
This process will install a brand new ZStack, please confirm
```
1. 完整输入字符串 install zstack。
2. 按 Enter 确认。
图 47. 确认安装管理节点
等待管理节点安装完成。

进入安装等待状态，界面提示 Please wait...，请耐心等待安装完成。

图 48. 管理节点安装进行中
安装完成后，查看 TUI 主界面。
管理节点安装完成后，TUI 主界面中的信息将出现如下变化：
- DISK INFO：新增 /var/lib/zstack、/usr/local/zstack 等挂载点。
- NIC INFO：显示新增的 docker0 (管理服务相关)，以及配置好的 bond0 与对应 IP (如 172.26.215.195)。
图 49. 安装完成后的 TUI 主界面
通过命令行验证管理节点状态。
1. 按组合键 Ctrl + Alt + F2 切换到命令行登录界面。
2. 使用 root 账号登录。
3. 执行如下命令查询管理节点状态：
```
[root@localhost ~]# zstack-ctl status
```
  管理节点处于运行状态时，正常输出示例：
```
MN status: Running
UI status: Running
```
图 50. 命令行验证管理节点状态

设置管理节点 HA

管理节点 HA 用于提高 ZSphere 管理面的可用性。配置管理节点 HA 后，当主管理节点异常时，系统可以通过备用管理节点继续提供管理服务。

设置管理节点 HA 前，请准备两台已安装管理节点服务的服务器，并提前规划管理网络、业务网络和 VIP。您可以使用图形化界面完成设置，也可以按命令行流程依次安装操作系统、配置网络并安装高可用套件。

使用图形化界面设置

前提条件

选取的两台服务器均需要安装管理节点服务。有关如何安装管理节点服务，请参阅安装管理节点。
确保两个管理节点的网关地址在同一网络段内，并且两个管理节点的网卡名称配置保持一致。
确保两个管理节点的版本保持一致。
确保两个管理节点的操作系统类型和架构受支持，且两个管理节点系统类型保持一致。
确保两个管理节点使用相同类型的许可证。

操作步骤

登录任意一个管理节点的 UI 管理界面。
如果是还未初始化的全新环境：
1. 在欢迎使用初始化向导弹窗中，点击下一步，系统将自动检测管理节点 HA 状态。
2. 在设置管理节点HA弹窗中，点击前往MN Ops。
3. 点击后，将在浏览器新标签页中打开 MN Ops 页面。
图 51. 从初始化页面前往 MN Ops
如果是现有环境：
1. 在导航栏中，点击可靠服务 > 管理节点监控。
2. 在管理节点监控页面，点击前往MN Ops。
3. 点击后，将在浏览器新标签页中打开 MN Ops 页面。
图 52. 从管理节点监控页面前往 MN Ops
在 MN Ops 的管理节点监控页面，点击设置管理节点HA。

图 53. 管理节点监控页面
在设置管理节点 HA弹窗中，完成管理节点配置、配置信息确认、设置管理节点 HA。
1. 对于配置管理节点，参考以下示例完成配置：
  - VIP：设置 VIP 用于后续访问管理节点环境的管理界面
    Note: 需确保 VIP 与主管理节点 IP 在相同网络段内。
  - 主管理节点IP：显示主管理节点的 IP 地址。指定主管理节点 SSH 用户名和密码
  - 备管理节点IP：指定备管理节点的 IP 地址、SSH 用户名和密码
    Note:
    
    需确保备管理节点 IP 与主管理节点 IP 在相同网络段内。
    
    设置管理节点 HA 时，密码仅支持英文字母、数字和以下特殊字符：-=[];,./~!@#$%^&*()_+|{}:<>?`。若您的管理节点密码不符合此规则，请修改后再设置管理节点 HA。
  - 时间同步服务器：默认使用主管理节点地址作为时间同步服务器
  - 强制同步：默认关闭。当主备管理节点的数据库无法完成自动同步时，对主管理节点强制执行 zsha2 安装命令
  - 数据库密码：留空不填时，默认使用初始数据库密码。若已修改过数据库密码，需填写修改后的数据库密码
  图 54. 配置管理节点
2. 点击下一步。
  系统将自动检测是否满足添加条件。
3. 在确认配置信息步骤中，检查主备管理节点的资源信息。
  Note:
  1. 确定添加后，系统将先自动备份主管理节点的数据库，再执行添加操作。
  2. 添加时，主备管理节点将停止运行，同时备管理节点的数据库将被主管理节点的数据库覆盖，请谨慎操作。
  3. 若在对比主备管理节点资源信息时，发现备管理节点存在较多资源，如需保留其资源，建议勾选切换主备管理节点。勾选后，将调换主备管理节点角色，将资源较多的备管理节点作为主管理节点来设置管理节点 HA。
  图 55. 确认配置信息
4. 输入确认信息后，点击确定。
5. 在设置管理节点 HA步骤中，查看添加进度及任务结果。
  图 56. 设置管理节点 HA
添加成功后，点击前往VIP，通过 VIP 访问平台管理界面。
图 57. 前往VIP

使用命令行设置

当无法通过图形化界面设置管理节点 HA，或需要在服务器部署阶段完成更细粒度的配置时，可以使用命令行方式设置管理节点 HA。

命令行设置管理节点 HA 需要按顺序完成以下操作：

安装操作系统。
配置管理网络。
配置业务网络。
安装高可用套件。

完成上述操作后，请通过 VIP 登录 ZSphere，并检查管理节点 HA 服务状态。

安装操作系统

本场景中，管理员需分别在选取的两台服务器上安装管理节点模式。

操作步骤

选择引导项。
进入 ISO 系统引导界面，选择默认选项开始安装操作系统。您可根据实际情况选择，建议使用图形界面安装。若服务器无 VGA 接口，仅支持串口连接，您可使用 VNC 方式或字符安装方式。
- 图形界面方式
- VNC 方式
- 字符安装方式
图 58. 系统引导
选择安装模式。
1. 在 INSTALLATION SUMMARY 界面，点击 Software Selection。
2. 在 SOFTWARE SELECTION 界面，选择安装模式。
  管理节点所在服务器选择Management Node模式，其余节点所在服务器选择Compute Node模式。
3. 选择完安装模式后，点击 Done。
图 59. 选择安装模式
配置硬盘分区。
1. 在 INSTALLATION SUMMARY 界面，点击 Installation Destination，进入 INSTALLATION DESTINATION 界面。
2. 对于 Device Selection，建议此处仅配置系统盘，其余磁盘可在系统安装后配置。
3. 对于 Storage Configuration，建议选择 Automatic 自动配置硬盘分区。
  若您需手动配置，可根据 BIOS 引导模式参考以下内容：
  - UEFI 模式：
    - /boot：存放 Linux 启动所需的核心文件，建议分配 1 GB 空间
    - /boot/efi：存放 UEFI 启动引导文件，建议分配 500 MB
    - swap：交换区，建议分配 32 GB
    - /：Linux 系统根目录，建议分配全部剩余空间
  - Legacy 模式
    - /boot：存放 Linux 启动所需的核心文件，建议分配 1 GB 空间
    - swap：交换区，建议分配 32 GB
    - /：Linux 系统根目录，建议分配全部剩余空间
  Note:
  - 以上数值为 ZSphere 建议分区容量（磁盘总容量大于 300 GB）。
  - Legacy 模式下，若系统盘容量大于 2 TB，需配置 BIOS boot 分区，以支持 GPT 分区。UEFI 模式没有此限制，且支持 GPT 分区。
4. 确认配置无误后，点击 Done。
图 60. 配置硬盘分区
在 INSTALLATION SUMMARY 界面，点击 Root Password，设置操作系统 root 密码。
在 INSTALLATION SUMMARY 界面，点击 Begin Installation，开始安装操作系统。

配置管理网络

背景信息

本场景对管理节点的网络信息以及用于 Keepalived 通信的 VIP 设定如下：

服务器	网卡 1	网卡 2	聚合接口	网桥	IP 地址	掩码	网关
管理节点 1	eth0	eth1	bond0	br_bond0	192.168.195.200	255.255.0.0	192.168.0.1
管理节点 2	eth0	eth1	bond0	br_bond0	192.168.196.125	255.255.0.0	192.168.0.1

-	IP 地址	掩码
VIP	192.168.199.151	255.255.0.0

Note:

VIP 用于登录管理节点 UI 界面，请避免使用 VIP 通过 SSH 方式登录管理节点。
以上为示例数据，管理员可根据实际部署环境自行更改。
网关需由物理网络设备提供，同时作为网络状态仲裁检测。

操作步骤

# 创建聚合网卡bond0
[root@localhost ~]# zs-bond-lacp -c bond0

# 将网卡eth0与eth1均添加到bond0
[root@localhost ~]# zs-nic-to-bond -a bond0 eth0
[root@localhost ~]# zs-nic-to-bond -a bond0 eth1

# 配置上述链路聚合后,请管理员在对应的交换机网口配置LACP聚合

# 创建网桥br_bond0,指定网络IP、掩码和网关
[root@localhost ~]# zs-network-setting -b bond0 192.168.195.200 255.255.0.0 192.168.0.1

# 查看聚合端口bond0是否创建成功
[root@localhost ~]# zs-show-network
...
----------------------------------------------------------------------------------
| Bond Name  | SLAVE(s)        | BONDING_OPTS                                     |
----------------------------------------------------------------------------------
| bond0      | eth0            | miimon=100 mode=4 xmit_hash_policy=layer2+3        |
|            | eth1            |                                                    |
---------------------------------------------------------------------------------

登录管理节点 2 操作系统，然后执行类似的配置命令。
Note:
- eth0 和 eth1 加载到 bond0 后，对应交换机的端口需要配置 LACP 聚合，否则网络通信将异常。
- 通过 bond0 创建网桥后，网桥命名为 br_bond0，将提供管理网络服务。
- 关于网桥的IP地址、子网掩码和网关参数，用户需按照实际情况填写。
- 管理网络配置完成后，可通过ping命令进行检测；若配置正确，则两管理节点的管理网络对应的 IP 地址可互ping。
- 管理网络建议采用万兆以上带宽，若独立部署，允许千兆带宽。

配置业务网络

背景信息

本场景对业务网络的设定如下：

节点	网卡 1	网卡 2	聚合接口	网桥	IP 地址	掩码	网关
管理节点 1	em1	em2	bond1	-	-	-	-
管理节点 2	em1	em2	bond1	-	-	-	-

操作步骤

# 创建聚合网卡bond1
[root@localhost ~]# zs-bond-lacp -c bond1

# 将网卡em1与em2均添加到bond1
[root@localhost ~]# zs-nic-to-bond -a bond1 em1
[root@localhost ~]# zs-nic-to-bond -a bond1 em2

# 配置上述链路聚合后,请管理员在对应的交换机网口配置LACP聚合

# 业务网络,无需创建网桥

# 查看聚合端口bond1是否创建成功
[root@localhost ~]# zs-show-network
...
----------------------------------------------------------------------------------
| Bond Name  | SLAVE(s)        | BONDING_OPTS                                     |
----------------------------------------------------------------------------------
| bond1      | em1            | miimon=100 mode=4 xmit_hash_policy=layer2+3        |
|            | em2            |                                                    |
---------------------------------------------------------------------------------

安装高可用套件

完成操作系统安装、管理网络配置和业务网络配置后，需要安装高可用套件，将两台管理节点组成高可用环境。

高可用套件支持以下安装方式：

通过命令行安装
通过配置文件安装

Note: 使用相同配置安装高可用套件时，直接指定命令行方式的优先级高于配置文件方式。

通过命令行安装

本场景中，管理员已经将两台服务器安装为 ZSphere 管理节点。现在，管理员只需对其中一个管理节点安装高可用套件，即可设置管理节点高可用。若管理员对管理节点 1 安装高可用套件，则管理节点 1 为主管理节点，管理节点 2 为备管理节点。

操作步骤

导入高可用套件。

# 通过scp工具将高可用套件传输到管理节点1
[root@localhost ~]# ls
ZStack-ZSphere-Multinode-HA-Suite.tar.gz

# 将高可用套件解压，生成两个可执行文件：zsha2和zstack-hamon
[root@localhost ~]# tar zxvf ZStack-ZSphere-Multinode-HA-Suite.tar.gz
zsha2 //管理节点高可用的安装和管理程序
zstack-hamon //管理节点高可用的监控程序

HA 初始化。
执行以下命令，在管理节点 1 中安装高可用套件：
```
[root@localhost ~]# chmod +x zsha2 zstack-hamon
[root@localhost ~]# ./zsha2 install-ha -nic br_bond0 -gateway 192.168.0.1 -slave "root:password@192.168.196.125" \
-vip 192.168.199.151 -myip 192.168.195.200 -db-root-pw zstack.mysql.password -time-server 192.168.196.125 -cidr 192.168.0.0/16 -yes
```
Note:
- 安装命令执行后，会先自动备份主备管理节点的数据库，再执行安装操作。
- 安装高可用套件，需将 zsha2 和 zstack-hamon 放在一个目录，安装过程中，zsha2 会自动部署 zstack-hamon 以及相关配置文件。

查看管理节点状态。

高可用套件初始化完成后，执行以下命令，查看管理节点状态：

# 查看管理节点1的状态
[root@localhost ~]# zsha2 status
Status report from 192.168.195.200
=================================
Owns virtual address:            yes //管理节点1已获取VIP，同一时刻只允许一个管理节点获取VIP
Self 192.168.195.200 reachable:   yes //管理节点1可达
Gateway 192.168.0.1 reachable:    yes //当前网关可达
VIP 192.168.199.151 reachable:    yes //VIP可达
Peer 192.168.196.125 reachable:   yes //管理节点2可达
Keepalived status:               active //Keepalived服务处于工作状态
ZStack HA Monitor:               active //高可用监控服务处于工作状态
MySQL status:                    mysqld is alive //数据库正常工作
MN status: Running [PID:6500] //管理节点正常工作
UI status: Running [PID:9785] https://192.168.195.200:443 //UI正常工作

Slave Status:
-------------
             Slave_IO_Running: Yes //Slave IO正常运行
            Slave_SQL_Running: Yes //Slave SQL正常运行
                   Last_Error:
        Seconds_Behind_Master: 0
                Last_IO_Error:
               Last_SQL_Error:

Warning: Permanently added '192.168.196.125' (ECDSA) to the list of known hosts.
Status report from 192.168.196.125 //查看管理节点2的状态
================================
Owns virtual address:            no
Self 192.168.196.125 reachable:    yes
Gateway 192.168.0.1 reachable:    yes
VIP 192.168.199.151 reachable:     yes
Peer 192.168.195.200 reachable:   yes
Keepalived status:               active
ZStack HA Monitor:               active
MySQL status:                    mysqld is alive

Slave Status:
-------------
             Slave_IO_Running: Yes
            Slave_SQL_Running: Yes
                   Last_Error:
        Seconds_Behind_Master: 0
                Last_IO_Error:
               Last_SQL_Error:

Note: visit ZStack UI with https://192.168.199.151:443

Note: 安装高可用套件过程中，已自动为两个管理节点做 SSH 免密登录。

通过配置文件安装

操作步骤

导入高可用套件。

# 通过scp工具将高可用套件传输到管理节点1
[root@localhost ~]# ls
ZStack-ZSphere-Multinode-HA-Suite.tar.gz

# 将高可用套件解压，生成两个可执行文件：zsha2和zstack-hamon
[root@localhost ~]# tar zxvf ZStack-ZSphere-Multinode-HA-Suite.tar.gz
zsha2 //管理节点高可用的安装和管理程序
zstack-hamon //管理节点高可用的监控程序

编写配置文件。

执行以下命令，编写高可用套件的初始化配置文件：

[root@localhost ~]# chmod +x zsha2 zstack-hamon
[root@localhost ~]# ./zsha2 sample-config > zs-install.config
[root@localhost ~]# cat zs-install.config
{
  "gateway": "192.168.0.1", //主备管理节点的仲裁网关
  "virtualIp": "192.168.199.151", //指定Keepalived通信的VIP
  "myIp": "192.168.195.200", //指定本机IP
  "peerIp": "192.168.196.125", //指定Peer管理节点IP
  "peerSshUser": "root", //指定Peer管理节点SSH用户名
  "peerSshPass": "password", //指定Peer管理节点SSH密码
  "peerSshPort": 22, //指定Peer管理节点SSH端口
  "dbRootPass": "zstack.mysql.password", //指定主备管理节点的数据库root密码（必须相同）
  "interface": "br_bond0", //物理设备名，用于配置VIP，生产环境一般是一个管理网络的网桥
  "timeServer": "192.168.196.125" //指定时间同步服务器，用于统一时间同步
}

HA 初始化。
执行以下命令，初始化安装高可用套件：
```
[root@localhost ~]# ./zsha2 install-ha -config zs-install.config
```
Note:
- 安装命令执行后，会先自动备份主备管理节点的数据库，再执行安装操作。
- 安装高可用套件，需将 zsha2 和 zstack-hamon 放在一个目录，安装过程中，zsha2 会自动部署 zstack-hamon 以及相关配置文件。

查看管理节点状态。

高可用套件初始化完成后，执行以下命令，查看管理节点状态：

# 查看管理节点1的状态
[root@localhost ~]# zsha2 status
Status report from 192.168.195.200
=================================
Owns virtual address:            yes //管理节点1已获取VIP，同一时刻只允许一个管理节点获取VIP
Self 192.168.195.200 reachable:   yes //管理节点1可达
Gateway 192.168.0.1 reachable:    yes //当前网关可达
VIP 192.168.199.151 reachable:    yes //VIP可达
Peer 192.168.196.125 reachable:   yes //管理节点2可达
Keepalived status:               active //Keepalived服务处于工作状态
ZStack HA Monitor:               active //高可用监控服务处于工作状态
MySQL status:                    mysqld is alive //数据库正常工作
MN status: Running [PID:6500] //管理节点正常工作
UI status: Running [PID:9785] https://192.168.195.200:443 //UI正常工作

Slave Status:
-------------
             Slave_IO_Running: Yes //Slave IO正常运行
            Slave_SQL_Running: Yes //Slave SQL正常运行
                   Last_Error:
        Seconds_Behind_Master: 0
                Last_IO_Error:
               Last_SQL_Error:

Warning: Permanently added '192.168.196.125' (ECDSA) to the list of known hosts.
Status report from 192.168.196.125 //查看管理节点2的状态
================================
Owns virtual address:            no
Self 192.168.196.125 reachable:    yes
Gateway 192.168.0.1 reachable:    yes
VIP 192.168.199.151 reachable:     yes
Peer 192.168.195.200 reachable:   yes
Keepalived status:               active
ZStack HA Monitor:               active
MySQL status:                    mysqld is alive

Slave Status:
-------------
             Slave_IO_Running: Yes
            Slave_SQL_Running: Yes
                   Last_Error:
        Seconds_Behind_Master: 0
                Last_IO_Error:
               Last_SQL_Error:

Note: visit ZStack UI with https://192.168.199.151:443

Note: 安装高可用套件过程中，已自动为两个管理节点做 SSH 免密登录。

管理 ZSphere 服务

查看管理节点服务状态

您可以使用 zstack-ctl status 命令，查看 ZSphere 管理节点相关服务的运行状态：

[root@localhost ~]# zstack-ctl status
ZSTACK_HOME: /usr/local/zstack/apache-tomcat/webapps/zstack
zstack.properties: /usr/local/zstack/apache-tomcat/webapps/zstack/WEB-INF/classes/zstack.properties
log4j2.xml: /usr/local/zstack/apache-tomcat/webapps/zstack/WEB-INF/classes/log4j2.xml
PID file: /usr/local/zstack/management-server.pid
log file: /usr/local/zstack/apache-tomcat/logs/management-server.log
version: 5.1.0 (ZStack-enterprise 5.1.0)
MN status: Running [PID:123135]
UI status: Running [PID:795] https://10.0.0.254:443

您也可以使用 zstack-ctl ui_status 命令单独查看 Web UI 服务状态：

[root@localhost ~]# zstack-ctl ui_status
UI status: Running [PID:8459] https://10.0.0.254:443

改变管理节点服务状态

在使用过程中如需重启管理节点服务，不重启 Web UI 服务，可执行：

zstack-ctl restart_node

在使用过程中不建议全部停止及重启所有服务。如果确需重启所有服务，可执行以下命令进行重启：

zstack-ctl stop && zstack-ctl start

管理节点因维护或其他异常原因停止服务后，需手动启动服务。启动 ZSphere 服务方法如下：

# 此命令将同时启动管理节点和 Web UI 服务
[root@localhost ~]#zstack-ctl start

查看管理节点 HA 服务状态

您可以执行 zsha2 status 命令查看 zsha2 服务是否正常运行。

输出管理节点 HA 日志

您可以执行以下命令收集 zsha2 服务相关日志：

[root@localhost ~]# zsha2 collect-log
Collecting logs ...
Collected log: zsha2-log-2018-09-17T154358+0800.tgz

# 将日志压缩包解压
[root@localhost ~]# tar zxvf zsha2-log-2021-01-17T154358+0800.tgz
tmp/zsha2-log588815976/
tmp/zsha2-log588815976/zsha2-status.log
tmp/zsha2-log588815976/zstack-ha.log
tmp/zsha2-log588815976/keepalived.data
tmp/zsha2-log588815976/zs-vip-192.168.199.151.log
tmp/zsha2-log588815976/keepalived_status.log

登录 ZSphere

平台默认使用 HTTPS 协议，并开启重定向至 HTTPS 地址的 443 端口，您只需在浏览器中输入管理节点 IP 地址即可访问 UI 管理界面。

前提条件

为了获取更好的产品体验，建议使用 Chrome 67 及以上版本的浏览器，且将显示器最小分辨率调整为 1280 × 900 px。
若页面无法正常加载，请确认管理节点和 UI 服务均正常运行。

操作步骤

在浏览器中，采用以下格式输入管理节点 IP 地址：https://management_node_ip。
双管理节点环境可通过 VIP 访问 UI 管理界面。
输入账户名和密码。
首次登录时，默认账户名：admin，默认初始密码：password。
点击登录。

后续操作

有关登录策略、HTTPS/HTTP 访问方式、统一认证和证书的更多信息，请参阅安全。
首次登录后，请根据部署目标继续初始化 ZSphere。

初始化 ZSphere

首次登录 ZSphere 后，可以通过初始化向导创建基础资源，使环境具备后续纳管主机、配置存储和创建虚拟机的基础条件。

ZSphere 支持以下初始化方式：

手动初始化：通过向导创建数据中心、集群、主机、数据存储、镜像存储、镜像和端口组等资源。
通过备份数据还原初始化环境：使用平台数据库备份数据恢复环境资源配置。

在初始化过程中请注意：

若中途退出初始化向导，系统将不会再次进入向导界面。
若在初始化过程中没有创建任何资源，可再次从首页通过初始化向导初始化环境。
若在初始化过程中意外退出向导界面，可删除数据中心，再次从首页进入初始化向导。
Note: 删除数据中心将删除集群、主机、网络、数据存储等资源，同时还会删除各资源下的所有子级资源，请谨慎操作。

手动初始化

跟随初始化向导，手动创建环境所需基础资源，包括数据中心、集群、主机、数据存储、镜像存储、镜像、分布式端口组。

操作步骤

在欢迎使用初始化向导弹窗中，选择手动初始化。
点击下一步。
在手动初始化页面，新建数据中心。
1. 输入数据中心名称和简介。
2. 点击确定。
新建集群。
1. 输入集群名称。
2. 选择集群 CPU 架构，包括 x86_64 和 aarch 64。
3. 点击确定。
添加主机。
1. 输入主机名称。
2. 输入主机 IP 地址、SSH 端口、SSH 用户名和密码。
  
  Note: 添加至集群的主机架构需和集群 CPU 架构一致，否则将添加失败。
3. 点击确定。
  添加过程可能持续几分钟。
添加数据存储。
1. 输入数据存储名称。
2. 选择数据存储类型，包括本地存储、ZCE 分布式存储、ZHPS 分布式存储。
  - 本地存储：需配置挂载路径、主机硬盘。
    Note:
    
    挂载路径不能使用/、/dev、/proc、/sys、/usr/bin、/bin等系统目录，否则可能导致主机异常。
    
    配置主机空闲硬盘会格式化所选硬盘，将彻底清除硬盘上的所有分区、文件系统及数据。
  - ZCE 分布式存储：需配置是否启用密钥认证、添加监控节点、指定镜像缓存池和存储池、指定存储网络。
    Note: 需确保分布式存储的密钥认证和平台配置一致，否则可能导致虚拟机创建失败。
  - ZHPS 分布式存储：需配置 IP 地址、端口、用户名和密码、添加存储池。
  - ZBS 分布式存储：添加 MDS 节点、输入存储池的池名称。
3. 点击确定。
添加镜像存储。
1. 输入镜像存储名称。
2. 选择镜像存储类型，包括单机镜像仓库和分布式镜像仓库。
  - 单机镜像仓库：需输入镜像存储 IP、SSH 端口、用户名和密码。完成硬盘相关配置，包括添加方式、挂载路径、是否获取已有镜像、镜像同步网络、以及数据网络。
    Note:
    
    若添加方式选择空闲硬盘，配置空闲硬盘会格式化所选硬盘，将彻底清除硬盘上的所有分区、文件系统及数据。
    
    挂载路径不能使用/、/dev、/proc、/sys、/usr/bin、/bin等系统目录，否则可能导致镜像存储异常。
  - 分布式镜像仓库：需配置监控节点，包括监控节点管理 IP、SSH 端口、用户名和密码。按需填写镜像存储池 UUID，若留空不填，默认自动创建镜像存储池。
3. 点击确定。
添加镜像。
1. 选择镜像路径，包括 URL 和本地上传。
2. 输入镜像名称。
3. 选择镜像类型，包括系统镜像和硬盘镜像。
4. 选择镜像格式，包括 qcow2、iso、vmdk、raw 格式。
5. 点击确定。
新建分布式端口组。
1. 输入分布式端口组名称。
2. 选择分布式端口组所在的分布式交换机，包括默认交换机和新建交换机。
  - 默认交换机：集群添加首台主机后，平台将基于主机相关配置自动创建默认分布式交换机，用于管理主机的管理网络。支持复用此默认分布式交换机，实现管理网和业务网复用。
  - 新建交换机：基于网络规划新建分布式交换机，实现管理网与业务网分离，推荐生产环境选择此选项。若选择此选项，需配置聚合口配置方式、上行链路名称、聚合模式、哈希策略、以及主机网口。
3. 选择 VLAN 类型，包括无和标准 VLAN。
  选择标准 VLAN 需配置 VLAN ID。
4. 选择是否开启 DHCP 服务。
  开启后，需配置网络段方式（IP 范围或 CIDR）、网关、IP 分配策略、以及 DHCP 服务 IP。
5. 输入 DNS。
6. 点击确定。
弹出手动初始化已完成弹窗，点击确定。
已完成创建环境所需基础资源，可以开始使用。

通过备份数据还原初始化环境

若本地数据中心发生灾难，可依赖平台数据库备份数据，重建数据中心并恢复业务。您可跟随初始化向导，从已有平台数据库备份数据恢复环境资源配置。

前提条件

已有平台数据库备份数据。

操作步骤

在欢迎使用初始化向导弹窗中，选择备份数据还原。
点击下一步。

在备份数据还原弹窗中，参考以下示例完成服务器配置：

配置项	说明
备份存储 IP	输入存有平台数据库备份数据的备份存储 IP 地址。
URL	备份存储的路径 URL。
SSH 端口	备份存储 SSH 端口，默认为 22。
用户名	备份存储用户名。
密码	用户名对应的密码。

点击测试连接，检测备份存储网络连通性。

连接成功后，参考以下示例完成备份数据配置：

配置项	说明
数据库备份数据	选择平台数据库备份数据。

Note: 请根据许可证授权情况，选择适当的数据进行还原，避免备份数据还原后，因许可证授权配额不足导致管理节点启动失败。可按需点击更新许可证对许可证进行更新。

确认配置无误后，点击确定。
在还原平台数据库弹窗中，输入平台数据库 root 密码，然后点击确定。

Note: 还原平台数据库需要重新启动管理节点，期间将无法使用管理界面。此过程通常需要几分钟，您的业务资源不会受到影响。
等待平台数据库还原成功后，点击重新登录。

后续操作

恢复平台数据库后，平台所有资源都会变为创建备份时的状态。请在本地备份存储中点击扫描备份数据以获取当前真实备份数据信息。

概述

关于本文档

本文档介绍如何在已部署的 ZSphere 环境中完成升级前准备、管理节点环境升级、管理节点 HA 环境升级以及升级后检查与处理。

目标读者

本文档的目标读者是负责升级和维护 ZSphere 环境的管理员、实施工程师和运维工程师。读者需要了解当前环境的部署方式、管理节点访问方式，以及 Linux 命令行基础操作。

升级路径

请根据当前环境是否已设置管理节点 HA 选择对应的升级路径。

环境类型	升级路径
未设置管理节点 HA 的 ZSphere 环境	完成升级前准备后，执行管理节点环境升级，再进行升级后检查与处理。
已设置管理节点 HA 的 ZSphere 环境	完成升级前准备后，在 VIP 所在管理节点升级高可用套件和管理节点，再进行升级后检查与处理。

升级前准备

升级 ZSphere 前，请确认当前环境版本，准备升级所需软件包，并完成必要的保护操作。

操作步骤

查看当前环境版本以及操作系统版本。

[root@localhost ~]# zstack-ctl status
[root@localhost ~]# cat /etc/redhat-release

获取安装升级包。
按需下载 zstack-upgrade 脚本、ISO 软件包、安装升级包以及管理节点高可用套件。
关闭高可用策略。
升级前需关闭虚拟机高可用全局开关，避免意外触发虚拟机高可用影响升级。升级完成后再手动开启高可用策略。
1. 登录 ZSphere。
2. 点击可靠服务 > 高可用策略，进入高可用策略页面。
3. 关闭高可用策略开关。

备份数据库和升级脚本。

登录管理节点操作系统，分别执行以下命令备份数据库和升级脚本用于意外恢复。

# 备份数据库至/var/lib/zstack/mysql-backup/目录
[root@localhost ~]# zstack-ctl dump_mysql --file-name zstack-db-backup

# 备份升级脚本至/root/目录
[root@localhost ~]# cp /usr/local/bin/zstack-upgrade /root/zstack-upgrade-bk

升级管理节点环境

本任务适用于未设置管理节点 HA 的 ZSphere 环境。

前提条件

执行本任务前，请先完成升级前准备。

背景信息

完成升级前准备后，请登录管理节点操作系统，并根据升级包准备情况选择一种离线升级方式。

操作步骤

选择一种离线升级方式升级 ZSphere。
- 推荐方式：升级本地仓库和管理服务。
```
[root@zstack-1 opt]# zstack-upgrade ZStack-ZSphere-x86_64-DVD-5.1.0-H84r.iso
```
- 分步方式：先升级本地仓库，再升级管理服务。
```
[root@zstack-1 opt]# zstack-upgrade -r ZStack-ZSphere-x86_64-DVD-5.1.0-H84r.iso
[root@zstack-1 opt]# bash ZStack-ZSphere-installer-5.1.0.bin -u -P MYSQL_ROOT_PASSWORD
```
Note:
- 若数据库 root 密码采用系统默认密码，可省略 -P MYSQL_ROOT_PASSWORD 参数。
- 执行 zstack-upgrade 命令前，需确认所准备的 ISO 与当前升级路径匹配，避免使用不匹配的 ISO 覆盖本地源。

后续操作

升级完成后，请继续执行升级后检查与处理。

升级管理节点 HA 环境

本任务适用于已设置管理节点 HA 的 ZSphere 环境。

前提条件

执行本任务前，请先完成升级前准备。

操作步骤

获取 VIP 所在管理节点 IP 地址。
执行以下命令获取 VIP 所在管理节点 IP 地址，返回结果中 VIP 为 yes 的节点即为 VIP 所在的管理节点：
```
[root@localhost ~]# zsha2 status
```
解压高可用套件，并赋予可执行权限。
在 VIP 所在管理节点依次执行以下命令，解压高可用套件，并对 zsha2 和 zstack-hamon 文件赋予可执行权限：
```
# 解压高可用套件
[root@localhost ~]# tar zxvf ZStack-ZSphere-Multinode-HA-Suite.tar.gz

# 赋予可执行权限
[root@localhost ~]# chmod +x zsha2 zstack-hamon
```
升级高可用套件。
在 VIP 所在管理节点执行以下命令，升级高可用套件：
```
[root@localhost ~]# ./zsha2 upgrade-ha
```
执行 zsha2 version 命令检查 commit id 是否与最新版本包中的一致。
升级 ZStack-ZSphere。
在 VIP 所在管理节点执行以下命令，升级虚拟化平台：
```
zsha2 upgrade-mn -peerpass password ZStack-ZSphere-x86_64-DVD-5.1.0-H84r.iso
```
Note: -peerpass 为可选参数，可设置 Peer 管理节点 SSH 登录密码。

后续操作

升级完成后，请继续执行升级后检查与处理。

升级后检查与处理

升级完成后，请清理浏览器缓存，按需恢复高可用策略，并检查服务状态和版本信息。

操作步骤

手动清理浏览器缓存。
为了保证新功能能够正常使用，建议在升级完成后登录 UI 管理界面，按下 Ctrl+F5 或 Ctrl+Shift+R 手动清理浏览器缓存。
按需开启高可用策略。
如果升级前关闭了虚拟机高可用全局开关，升级完成并确认环境运行正常后，请重新进入可靠服务 > 高可用策略，开启高可用策略。

检查管理节点服务状态和版本信息。

[root@localhost ~]# zstack-ctl status
[root@localhost ~]# zstack-ctl ui_status
[root@localhost ~]# cat /etc/redhat-release

如果升级的是管理节点 HA 环境，检查管理节点 HA 服务状态和版本信息。
```
[root@localhost ~]# zsha2 status
[root@localhost ~]# zsha2 version
```

术语表

数据中心 (Data Center)

虚拟化平台内最大的资源命名空间，包括：集群、主机、数据存储、分布式交换机、分布式端口组等资源。

集群 (Cluster)

一组主机（计算节点）的逻辑集合。

主机 (Host)

运行KVM虚拟化Hypervisor的x86或ARM物理服务器，为虚拟机提供计算、网络、存储等资源。

虚拟机分组 (VM Group)

基于业务需求将虚拟机进行划分的逻辑集合。

虚拟机 (Virtual Machine)

运行在物理主机上的虚拟主机，可像物理主机一样运行操作系统与业务应用。

硬盘 (Disk)

为虚拟机提供存储，包括两种类型：系统盘、数据盘。

系统盘 (System Disk)

用于支撑虚拟机系统运行的硬盘。

数据盘 (Data Disk)

用于扩展虚拟机存储数据所使用的硬盘。

镜像 (Image)

虚拟机或硬盘使用的镜像文件，包括两种类型：系统镜像、硬盘镜像。

镜像存储 (Image Storage)

为虚拟机或硬盘使用的镜像文件提供存储空间的虚拟化资源，可分为单机镜像仓库和分布式镜像仓库。

单机镜像仓库 (Standalone Image Storage)

镜像存储的一种类型，以镜像切片方式存储镜像文件。

分布式镜像仓库 (Distributed Image Storage)

镜像存储的一种类型，以分布式块存储方式存储镜像文件。

数据存储 (Data Storage)

为虚拟机及其应用数据提供存储空间的虚拟化资源，可分为本地存储和网络共享存储。

本地存储 (Local Storage)

使用一个或多个主机的物理存储空间构建的存储资源。

网络共享存储 (Netowrk Shared Storage)

用于远程存储虚拟机及其应用数据的存储系统，主机可通过网络进行并发访问。

分布式交换机 (Distributed Switch)

为集群内虚拟机提供统一虚拟网络管理和监控功能的虚拟交换机设备。

分布式端口组 (Distributed Port Group)

分布式交换机端口的逻辑分组，用于端口配置。

vNUMA配置 (vNUMA Configuration)

通过CPU绑定透传关联的主机NUMA节点（pNUMA Node）拓扑，为虚拟机生成vNUMA节点（vNUMA Node）拓扑，实现虚拟机CPU优先访问所在vNUMA节点本地内存，提高虚拟机性能。

NUMA (Non-Uniform Memory Access)

非一致性内存访问，是一种计算机内存设计架构。该架构下，CPU访问内存的时间取决于CPU与内存的相对位置。通过优先访问相对位置较近的内存可缩短延迟，从而可提升主机系统性能。

pNUMA节点 (pNUMA Node)

基于主机NUMA架构预定义的NUMA节点，用于主机CPU和内存管理。

pNUMA拓扑 (pNUMA Topology)

CPU厂商基于NUMA架构预定义的主机NUMA节点拓扑。

vNUMA节点 (vNUMA Node)

基于CPU绑定透传关联的主机NUMA节点而生成的虚拟机NUMA节点，用于虚拟机CPU和内存管理。

vNUMA拓扑 (vNUMA Topology)

基于CPU绑定生成的虚拟机NUMA节点（vNUMA Node）拓扑。

本地内存 (Local Memory)

CPU（pCPU或vCPU）通过所在NUMA节点（pNUMA节点或vNUMA节点）非CPU核部件中内存控制器可直接访问的内存。相比非本地内存，CPU访问本地内存的延迟更低。

CPU绑定配置 (CPU Pinning)

将虚拟机的虚拟CPU（vCPU）与主机的物理CPU（pCPU）严格关联，可为虚拟机分配特定的pCPU，提高虚拟机性能。

EmulatorPin配置 (EmulatorPin Configuration)

将虚拟机中除vCPU和IO线程外的其他线程与主机pCPU进行绑定，使虚拟机相关线程只运行在对应的pCPU上。

快照 (Snapshot)

某一时间点某一硬盘的数据状态文件。

虚拟机调度策略 (VM Scheduling Policy)

为虚拟机分配主机的资源编排策略，可用于保障业务的高性能和高可用。

管理节点 (Management Node)

安装系统的物理主机，提供UI管理、虚拟化平台部署功能。

计算节点 (Compute Node)

也称之为主机，为虚拟机实例提供计算、网络、存储等资源的物理主机。

iSCSI存储 (iSCSI Storage)

基于iSCSI协议构建的SAN存储。用户可将iSCSI存储上划分的块设备添加为SAN数据存储。

FC存储 (FC Storage)

基于FC协议构建的SAN存储。用户可将FC存储上划分的块设备添加为SAN数据存储。

NVMe存储 (NVMe Storage)

基于NVMe-oF协议构建的存储阵列，用户可将NVMe存储上划分的块设备添加为SAN数据存储。

管理网络 (Management Network)

管理控制虚拟化平台相关物理资源的网络，例如：配置访问主机、数据存储、镜像存储时使用的网络。

安全组 (Security Group)

为虚拟机网卡提供安全控制，按照指定的安全规则对进出网卡的TCP/UDP/ICMP等数据包进行有效过滤。

管理节点监控 (MN Monitoring)

在多管理节点主机高可用场景下，可直观查看每个管理节点的健康状态。

报警器 (Alarm)

用于监控并响应时序性数据和事件的状态变化，支持资源报警器、事件报警器。

消息模版 (Message Template)

报警器或事件向SNS系统的主题发送消息时使用的文本模板。

通知对象 (Endpoint)

用户获取订阅主题信息的方式。

报警消息 (Alarm Message)

报警器触发时发送的即时提示消息。

操作任务 (Operation Task)

平台运行过程中变化的一种抽样，内容为指定对象的某些操作及其操作结果按时间的有序集合。

高可用任务 (HA Task)

启用高可用策略后，平台触发高可用机制时，生成的高可用任务日志。

调度任务 (Scheduling Task)

集群开启动态资源调度后，平台触发动态资源资源调度时，生成的调度任务日志。

事件 (Event)

实时监控并记录平台所有活动，可用于操作追踪、等保合规、安全分析、问题排查、自动运维等场景。

标签 (Tag)

一种资源标记，便于快速搜索和资源聚合。

自定义属性 (Custom Attribute)

通过用户自定义的属性键值对，扩展平台资源的标记和管理能力。

统一认证 (Single Sign-On)

虚拟化平台提供的统一登录认证服务，支持无缝接入统一登录认证系统，相应统一认证用户将直接登录虚拟化平台，便捷使用资源。

控制台代理 (Console Proxy)

可通过代理地址登录虚拟机控制台。

AccessKey管理 (AccessKey Management)

访问虚拟化平台API的身份凭证，具有该虚拟化平台完全的权限，包括：AccessKey ID（访问密钥 ID）和AccessKey Secret（秘密访问密钥）。

IP黑白名单 (IP Blocklist/Allowlist)

虚拟化平台登录IP的黑白名单，通过对访客身份的识别和过滤，进一步提升虚拟化平台访问控制安全。

用户管理 (User Management)

用户由admin创建或统一认证系统同步，且受admin管理，用户对自己创建的虚拟资源拥有管理权限。

主题外观 (Theme)

用户可自定义设置虚拟化平台主题外观。

邮箱服务器 (Email Server)

虚拟化平台报警选择邮箱类型的通知对象，需设置邮箱服务器，用来发送报警邮件。

日志服务器 (Log Server)

用于接收虚拟化平台投递的管理节点日志或平台操作日志，以便集中保存、查询和分析日志。

系统参数 (Global Setting)

提供平台层面的功能特性设置，一经设置，虚拟化平台全局范围内生效。

高可用策略 (HA Policy)

虚拟化平台内计算、存储、网络资源发生故障或虚拟机计划性/异常停机时，确保相关业务持续稳定运行的机制。启用后，支持自定义虚拟机高可用策略，确保业务连续性。

备份计划 (Backup Plan)

通过备份计划，可将本地虚拟机或平台数据库定时备份到指定的备份存储。

备份数据 (Backup Data)

虚拟机或平台数据库的备份数据，存放在备份存储中。

本地备份存储 (Local Backup Storage)

位于本地数据中心的存储服务器，用于存放本地备份数据。

异地备份存储 (Remote Backup Storage)

位于异地数据中心的存储服务器，用于存放异地备份数据。

裸金属模板 (Bare Metal Template)

通过裸金属模板，可快速生成预配置文件，实现无人值守批量安装裸金属主机操作系统。

裸金属集群 (Bare Metal Cluster)

为裸金属设备提供单独的集群管理。

部署服务器 (Deployment Server)

一台单独的服务器，为裸金属设备提供 PXE 服务和控制台代理服务。

裸金属设备 (Bare Metal Chassis)

用于创建裸金属主机，通过 BMC 接口以及 IPMI 配置进行唯一识别。

裸金属主机 (Bare Metal Instance)

裸金属设备的虚拟化实例。

概述

关于本文档

目标读者

安装模式

规划与准备

硬件设备要求

基础硬件要求

推荐硬件配置

硬件规划

网络规划

准备软件包

软件包说明

软件包清单

制作安装介质

使用 Rufus 刻录 ISO 镜像文件

操作步骤

后续操作

使用 Fedora Media Writer 刻录 ISO 镜像文件

操作步骤

后续操作

配置服务器

服务器配置检查

安装管理节点

Bond 网卡部署

操作步骤

单网卡部署

操作步骤

使用 TUI 安装

操作步骤

设置管理节点 HA

使用图形化界面设置

前提条件

操作步骤

使用命令行设置

安装操作系统

操作步骤

配置管理网络

背景信息

操作步骤

配置业务网络

背景信息

操作步骤

安装高可用套件

通过命令行安装

操作步骤

通过配置文件安装

操作步骤

管理 ZSphere 服务

查看管理节点服务状态

改变管理节点服务状态

查看管理节点 HA 服务状态

输出管理节点 HA 日志

登录 ZSphere

前提条件

操作步骤

后续操作

初始化 ZSphere

手动初始化

操作步骤

通过备份数据还原初始化环境

前提条件

操作步骤

后续操作

概述

关于本文档

目标读者

升级路径

升级前准备

操作步骤

升级管理节点环境

前提条件

背景信息

操作步骤

后续操作

升级管理节点 HA 环境

前提条件

操作步骤

后续操作

升级后检查与处理

操作步骤