文档中心知识库API Explorer
文档中心›HCI›SDDC Manager›使用手册
HCI

概述

SDDC Manager 是一款安装部署工具，支持虚拟化、存储和容器产品的多种组合部署，可用于安装 ZStack Cube、ZCF、ZVF、Zaku 及配套存储产品。

工具提供统一的可视化向导，覆盖服务器装机、产品配置、安装检查和结果确认的完整流程。用户可在同一工具中完成多个产品的配置与安装，减少重复操作和工具切换，简化部署过程。

本文档介绍使用 SDDC Manager 进行产品安装部署的详细方法。

适用范围

本文档适用的工具版本为 SDDC Manager 1.1.0。

读者对象

本文档主要面向以下参与产品安装部署的人员：

  • 实施人员。
  • 技术支持人员。
  • 测试人员。
  • 运维人员。

读者需了解服务器、网络、磁盘和虚拟化的基本知识。

阅读说明

首次部署时，按下表从部署前准备读到产品部署向导。遇到不熟悉的名词，可查阅附录中的名词解释。

章节 阅读说明
概述 了解产品用途、适用范围、读者对象和文档约定。
部署前准备 准备部署机、服务器、网络、软件包和操作系统镜像，完成部署规划。
配置部署机 按部署方式配置网络并启动 Manager；通过 PXE 装机时，配置并启动 PXE 服务。
安装服务器操作系统 需要装机时，通过 PXE 安装服务器操作系统并保存装机报告。所有目标服务器均已安装配套操作系统并运行 SDDC Agent 时，可跳过 PXE 装机，直接进入产品部署向导。
通过向导部署产品 按向导完成主机选择、产品及安装包准备、部署配置、安装前检查、产品安装和验收。
常见问题 核对页面访问、服务器发现及介质或安装包检查问题，并查看错误、保存支持资料。
附录 查阅本文档涉及的常用名词。

约定

不同版本的界面名称和选项可能有所不同，请以实际界面为准。

本文档中的 IP 地址、主机名和文件路径仅为示例，使用时请替换为实际环境中的对应信息。

部署前准备

准备清单

部署前，按规划的产品组合准备下列设备、网络和软件，并查看对应的详细要求。

准备项 说明 详细要求
部署机 运行 SDDC 部署服务的终端设备，可单独准备，也可由目标服务器兼任。 准备部署机
SDDC Manager 软件包 用于在部署机上运行 SDDC 客户端、Manager 和 PXE 服务的工具包。 准备 SDDC Manager 软件包
服务器 安装并运行目标产品的设备，在操作界面中称为“主机”。 准备服务器
操作系统镜像 用于服务器装机的定制版操作系统镜像。 准备操作系统镜像
目标产品安装包 本次部署所需的虚拟化、存储或容器产品的安装文件。 准备目标产品安装包
网络规划 部署机与服务器通信、服务器装机和产品运行所需的网络配置。 准备网络

准备部署机

按部署方式准备运行 SDDC 服务的设备：

  • 独立部署机：使用 Windows 或 macOS 物理机或虚拟机。
  • 服务器兼任部署机：服务器已安装定制版操作系统时，可选择其中一台运行部署服务。

Windows 建议使用 Windows 11 x64，macOS 建议使用 macOS 13 及以上版本。

  • 管理权限：具备运行和管理 SDDC Manager 所需的权限。
  • 网络连接：能够通过部署网络访问服务器。
  • 存储空间：为安装包及镜像解压文件预留足够的磁盘空间。

准备 SDDC Manager 软件包

请联系官方技术支持获取配套的 SDDC Manager 软件包，并核对以下信息：

  • 软件包适用的操作系统与部署机一致。
  • 软件包支持的 CPU 架构与部署机一致。

准备服务器

按目标产品的要求完成以下服务器准备：

  • 获取目标产品的硬件配置要求，按要求准备 CPU、内存、磁盘和网卡。
  • 记录每台服务器用于装机的网卡 MAC 地址、设备序列号（SN），以及计划使用的系统盘名称、容量和型号。
  • 备份需要保留的数据。
  • 通过 PXE 装机时，确认服务器支持从联网的网卡启动，并关闭 Secure Boot（安全启动）。同一装机批次使用相同 CPU 架构的服务器。

准备操作系统镜像

软硬一体交付场景中，服务器可能已预装操作系统。先核对系统是否配套及 SDDC Agent 是否运行。

需要装机时，使用配套的定制版操作系统镜像。安装后运行 SDDC Agent，供 SDDC Manager 发现和管理服务器。请联系官方技术支持获取镜像，并核对以下信息：

  • 镜像支持服务器的 CPU 架构。
  • 镜像支持服务器的启动方式。
  • 镜像符合所部署产品的要求。

准备目标产品安装包

请联系官方技术支持获取本次部署所需的虚拟化平台、存储平台、容器平台安装包。

准备网络

按需规划部署页面访问、PXE 装机和目标产品运行所用的网络：

  • 页面访问：为部署机准备一个浏览器能够访问的 IPv4 地址，用于打开 Manager 和 PXE 页面。可以使用部署机现有的地址。
  • PXE 装机：选定与待装服务器网卡处于同一二层网络的部署机网卡，规划其 IPv4 地址、子网掩码、可选 VLAN 和 DHCP 地址池。地址池与 PXE 地址位于同一子网，排除已用地址、网络地址和广播地址，并覆盖本批次装机数量。
  • 服务器发现与通信：部署机与服务器之间保留有线网卡的 IPv6 功能，并允许 mDNS 组播，用于发现服务器及与 SDDC Agent 通信。
  • 产品运行：按所部署产品的要求规划各服务器的管理地址、存储网络和业务网络；双管理节点场景还需规划管理 VIP。记录 IP、子网掩码、网关及所用网卡，供后续向导配置使用。
重要： PXE 装机网络中不能存在冲突的 DHCP 服务。开始装机前，请核对该网络中的 DHCP 服务与地址池规划。

在相应访问方向放通以下端口。IPv4 地址用于访问部署页面；服务器发现和 Agent 通信还需要上述 IPv6 与组播条件。

访问方向 端口 用途
浏览器到部署机 TCP 10016 Manager 产品部署页面。
浏览器到部署机 TCP 10018 PXE 装机页面。
待装服务器到部署机 PXE 地址 TCP 10019 网络启动、安装内容下载、探测与安装结果回报。
待装服务器与 PXE 服务 UDP 67、69 DHCP 与 TFTP 网络启动。
部署机到服务器 TCP 10017 SDDC Agent 通信。

产品部署还需访问服务器的 SSH TCP 端口（默认 22），以“配置系统”中填写的实际端口为准。

配置部署机

完成部署前准备后，在部署机上配置网络并启动 Manager 服务，用于部署目标产品。通过 PXE 为服务器安装操作系统时，还需配置并启动 PXE 服务。

独立部署机使用 Windows 或 macOS，通过本机控制台操作；服务器兼任部署机时，在选定的 Linux 服务器上使用命令行操作。

Windows / macOS（独立部署机）

  1. 将已获取的 SDDC Manager 软件包完整解压到可读写的目录，保留包内的 bin、assets 等目录及文件。
  2. 打开解压目录下的 bin 目录。Windows 双击 sddc-console.exe；macOS 双击 sddc-console，等待浏览器打开本机控制台。
  3. 按系统提示完成所需授权。在控制台查看当前网络，核对网卡、MAC 地址和 IPv4 地址。状态无法确认时，单击授权检测，再单击重新检测。

  4. 配置并启动 Manager 服务。

    如果 Manager 卡片已显示“运行中”且无需修改网络，无需重复启动。否则，按以下情况操作：

    • 如果使用部署机现有的 IPv4 地址，则单击 Manager 卡片的启动 Manager，完成系统授权。
    • 如果需要为部署网卡配置静态 IPv4 地址，则单击 Manager 卡片的初始化并启动，选择配置静态 IPv4 地址，填写网卡、IPv4 地址、子网掩码和可选 VLAN。核对变更后确认并启动。

  5. 按需配置并启动 PXE 服务。

    通过 PXE 装机时，按以下情况操作。PXE 卡片已显示“运行中”且装机网络无需调整时，可继续检查服务页面。

    • 首次使用 PXE 时，单击 PXE 卡片的初始化并启动，填写下表中的网络参数，核对变更后确认并启动。
    • 使用此前已进行过 PXE 初始化的部署机，且仍使用原来的装机网卡、地址和地址池时，单击启动 PXE 即可。需要调整这些配置时，重新执行初始化并启动。
    PXE 网络参数 填写说明
    网卡 选择与待装服务器处于同一二层网络的有线网卡，结合 MAC 地址核对。建议使用专用装机网络，避免与管理连接相互影响。
    IPv4 地址、子网掩码 分别填写部署机在装机网络中的 IPv4 地址和子网掩码，不在 IPv4 地址框中填写 CIDR 后缀。
    VLAN ID 按交换机与网卡规划填写；不使用 VLAN 时选择不打标签。变更 Windows 网卡 VLAN 可能影响该网卡的其他连接，应在确认网卡用途后操作。
    DHCP 地址池 与 PXE 地址位于同一子网，排除部署机及其他设备已用地址、网络地址和广播地址。装机网络中不能存在冲突的 DHCP 服务。

  6. 检查服务并打开页面。

    等待 Manager 卡片显示“运行中”，单击进入服务。使用 PXE 时，同样确认 PXE 卡片显示“运行中”并打开服务页面。

    • Manager：http://127.0.0.1:10016/。
    • PXE：http://127.0.0.1:10018/。

    以上为部署机本机的访问地址。从其他设备访问时，将 127.0.0.1 替换为部署机实际可达的 IPv4 地址，并确认相应端口可达。

    服务就绪后，按服务器状态继续：

注： 便携版不随系统自动启动。部署期间保持部署机开机；睡眠或重启后，重新检查并启动所需服务。

Linux（服务器兼任部署机）

  1. 检查 SDDC Manager。

    执行以下命令检查版本：

    sddc-manager version
    • 能输出版本：核对是否为本次部署使用的配套版本，匹配后继续下一步。

    • 未找到命令：使用适用于当前系统的配套 RPM 软件包，将下列路径替换为实际文件路径后执行：

      sudo rpm -Uvh "<SDDC Manager RPM软件包路径>"

      安装完成后，重新执行 sddc-manager version 检查版本。

  2. 配置 Manager 网络。

    首次使用时，执行 Manager 初始化命令：

    sudo sddc-manager init
    1. 选择 Manager 使用的网卡，填写规划的 IPv4 地址、子网、网关、DNS 和可选 VLAN，核对后确认。
    2. 出现 Enable PXE? 提示时选择 No；如需 PXE 装机，按下一项单独配置。

    如果此前已完成 Manager 初始化且网络无需调整，直接进行下一步。

  3. 按需配置 PXE 装机网络。

    所有目标服务器均已安装配套操作系统并运行 SDDC Agent 时，可跳过 PXE 配置，继续检查并启动 Manager 服务。首次使用 PXE 装机时，执行：

    sudo sddc-manager pxe init
    1. 选择与待装服务器处于同一二层网络的 PXE 网卡。
    2. 按准备网络中的规划填写 PXE IPv4 地址、子网掩码、可选 VLAN 和 DHCP 地址池。
    3. 核对网络参数并确认，等待 PXE 初始化完成。

    如果此前已完成 PXE 初始化且仍沿用原来的装机网络，无需重新初始化，继续检查服务状态。

  4. 检查并启动服务。

    • 检查 Manager 状态：

      sudo sddc-manager status

      如果 Manager 尚未运行，执行：

      sudo systemctl start sddc-manager.service

      再次执行状态命令，确认 Manager 已就绪。

    • 通过 PXE 装机时，检查 PXE 状态：

      sudo sddc-manager pxe status

      如果 PXE 尚未运行，执行：

      sudo sddc-manager pxe serve

      再次执行状态命令，确认 PXE 已就绪。

  5. 打开服务页面。

    在浏览器中使用部署机实际可达的 IPv4 地址访问：

    • Manager：http://<部署机IPv4地址>:10016/。
    • PXE（通过 PXE 装机时）：http://<部署机IPv4地址>:10018/。

    服务就绪后，按服务器状态继续：

安装服务器操作系统

注： 所有目标服务器均已安装配套操作系统并运行 SDDC Agent 时，可跳过本章，直接通过向导部署产品。
警告： 开始安装会格式化所选系统盘。操作前确认目标主机和系统盘，备份需要保留的数据。

已按部署前准备准备好配套的操作系统镜像、服务器和装机网络，并按配置部署机完成 PXE 服务的网络配置和启动。

本章通过 PXE 为目标主机安装定制版操作系统。目标主机是本次要装机的服务器，页面或报告中的“节点”也指这些设备。

  1. 导入并确认安装介质

    使用配套的操作系统镜像准备安装介质。同一批次使用同一份介质，为一组相同 CPU 架构的目标主机装机；介质须与准备阶段确认的产品版本、CPU 架构和启动方式匹配。

    1. 打开 PXE 装机页面。
      • Windows/macOS 部署机：在本机控制台的 PXE 卡片单击进入服务。
      • 直接访问：在浏览器中打开 http://<部署机可达IPv4地址>:10018/。

      确认页面显示“PXE 运行环境已就绪”后，再选择安装介质。

    2. 进入安装介质页面，核对已有介质的名称、架构、操作系统和状态。如已有本次配套镜像对应的“已就绪”介质，无需重复导入。
    3. 如果没有可复用的介质，在“导入新的 ISO”中选择导入方式，并按下表导入准备好的操作系统镜像。
      方式 操作
      浏览器上传 选择本地操作系统镜像文件，单击上传并导入。
      URL 下载 填写配套操作系统镜像的 HTTP/HTTPS 地址，单击下载并导入。
      部署节点本地文件 将镜像放入页面指定的导入目录，扫描后选择对应文件并导入。Windows/macOS 便携包的目录为包内 data/pxe-imports。
    4. 确认介质状态为“已就绪”；新导入的介质须等待处理完成。核对其架构和支持的启动方式与目标主机一致，再选择该介质。
    5. 单击确认介质并开始发现。

      确认后，安装介质与当前批次绑定，再让目标主机从 PXE 网卡启动。

      图 1. 选择已就绪的安装介质


    页面显示本批次所选介质。接下来让目标主机从 PXE 网卡启动，完成主机发现。

  2. 发现并选择目标主机

    使用准备阶段记录的 PXE 网卡 MAC 地址和设备 SN（序列号）核对目标主机。

    1. 将目标主机的本次启动设备设为与部署机 PXE 网络相连的网卡，然后开机或重启目标主机。
    2. 进入目标主机页面，等待目标主机完成探测。
    3. 逐台核对 PXE MAC、设备 SN、架构、启动方式和硬盘探测结果。

      只有探测完成且在线就绪的目标主机可以选择。根据 MAC 地址和 SN 确认其属于本次装机范围，再核对磁盘信息。

    4. 选择本次需要安装的目标主机，单击下一步。

      所选目标主机架构必须相同，且与安装介质匹配。系统盘将在下一步配置，此时尚未开始格式化或安装。

      图 2. 选择探测完成的目标主机


    所选目标主机进入系统配置页面。

  3. 配置系统盘与系统参数

    为上一步所选的每台目标主机配置系统盘，并设置安装后的主机名、root 密码和分区。

    1. 在系统配置页面选择系统盘模式。
      • RAID1 模式（默认）：使用已探测到的软 RAID1 或硬 RAID1 逻辑盘。此模式不会创建 RAID1；RAID 成员盘不能作为独立系统盘。
      • 自定义模式：为每台目标主机选择一块可写的本地整盘。计划使用的系统盘不是 RAID1 逻辑盘时，选择此模式。

      本章截图使用自定义模式，每台选择 /dev/vda 作为系统盘，保留 /dev/vdb、/dev/vdc 供后续产品使用。实际部署时，按准备阶段记录的磁盘名称、容量和型号选择系统盘。

    2. 填写批次公共参数。
      参数 用途 填写说明
      主机名、起始序号 批量生成目标主机名称。 填写符合规划的主机名前缀和起始序号，并核对各目标主机生成的名称。需要不同名称时，在目标主机行中单独覆盖。
      root 密码、确认 root 密码 设置新安装系统的 root 密码。 首次配置必填，两次输入须一致。保存后页面仅显示已配置状态，不回显明文。
      /boot 分区 保存系统启动文件。 默认 1024 MB，可设置为 1～10240 MB。
      swap 分区 按需要配置交换分区。 默认不启用；启用设置 swap后填写大小，默认值为 4096 MB。
      Legacy biosboot 分区 用于 Legacy 启动。 默认 1 MB，可设置为 0～2 MB；Legacy 模式下大于 2 TiB 的系统盘不能设为 0。
      UEFI EFI 分区 用于 UEFI 启动。 默认 600 MB，可设置为 1～4096 MB。目标主机启动方式由探测结果确定。
    3. 逐台核对主机名、系统盘和自动探测的启动方式。

      自定义模式下，重点核对磁盘名称、容量和型号，避免将数据盘选为系统盘。

    4. 单击保存并下一步。

      如出现“系统盘信息需要确认”提示，先对照服务器或虚拟化平台中的磁盘信息核对。按以下情况处理：

      • 已确认所选系统盘及容量与规划一致：单击仍然继续。
      • 无法确认磁盘信息，或发现选择有误：单击返回修改，重新核对系统盘。
      • 页面提示磁盘问题阻止保存：按提示处理后，再保存配置。

      该提示可能由磁盘型号或容量信息缺失、或各目标主机系统盘信息不同引起。

      图 3. 系统盘与系统参数配置示例


    配置保存后进入“确认配置”页面，此时尚未执行系统安装。

  4. 确认配置并开始安装

    在“确认配置”页面复核已保存的安装参数。

    警告： 单击“开始安装”会格式化所选系统盘并清除盘上数据。开始前再次确认目标主机、系统盘及数据备份。
    1. 在确认配置页面核对 DHCP 网卡和网段，确认与装机网络规划一致。
    2. 核对每台目标主机的 MAC、主机名和系统盘。如页面显示安装 IP，核对其属于本次装机网络。

      临时安装 IP 用于本次 PXE 装机，不替代后续产品安装时的管理网络规划。

    3. 核对启动方式以及 /boot、biosboot/EFI 和 swap 分区摘要。

      如需修改，返回对应页面调整并保存，再回到本页重新核对。

      图 4. 确认配置示例


    4. 确认目标和系统盘无误后，单击开始安装。安装会随即开始。

    页面进入“安装部署”，可以查看介质准备和每台目标主机的安装进度。安装期间保持部署机、PXE 服务及相关网络可用。

  5. 跟踪安装进度与结果
    1. 在安装部署页面查看批次进度，以及每台目标主机的阶段、状态和消息。

      页面会定期刷新，也可单击刷新。总体估算进度可能与消息中显示的安装器进度不同，应以目标主机最终的成功或失败状态判断安装结果。

      图 5. 查看本批次装机进度


    2. 如需查看安装过程，单击对应目标主机的详情。

      可查看阶段、事件和各次安装记录。控制台就绪后，单击查看安装器控制台图标查看安装画面；该控制台为只读模式。

    3. 等待本批次所有目标主机安装完成，并确认安装结果为成功。

    确认本批次所有目标主机安装成功后，结束批次并保存报告。

  6. 结束批次并保存报告
    1. 单击结束部署，进入完成页面。

      核对批次、介质、目标数量、成功数量、失败数量，以及每台目标主机的结果和系统盘。如仍有失败的目标主机，记录其错误信息和后续处理安排。

      图 6. 确认装机完成结果


    2. 单击下载装机报告并妥善保存。
      注： 报告包含目标主机配置、root 密码和安装结果等敏感信息，请妥善保管，并通过受控渠道传递。

      后续可通过部署历史查阅批次、目标主机结果和详情。

    3. 确认安装成功的目标主机从本地系统盘启动，进入新安装的操作系统。

      如仍从 PXE 启动，通过设备启动菜单或所在虚拟化平台的启动设置，改为从本地系统盘启动。操作系统启动后，按下一章进入 Manager 的“发现主机”页面，核对这些目标主机。

确认服务器已进入新操作系统并保存装机报告后，继续通过向导部署产品，在 Manager 中核对并选择这些服务器。

报告保存后，如不再需要 PXE，可单击关闭服务。该操作会停止 PXE 页面和装机服务；如需继续装机，可保持服务运行。

通过向导部署产品

服务器已安装配套操作系统并运行 SDDC Agent，Manager 服务已启动。需要装机时，先按安装服务器操作系统完成装机。

SDDC Manager 支持以下部署场景，请根据本次部署目标选择相应的产品与配置方式。

场景 说明
虚拟化平台单独部署 单独部署 ZCF 或 ZVF 虚拟化平台，两者只能选择一项。
虚拟化平台＋存储 部署 ZCF 或 ZVF 虚拟化平台，并搭配 ZStone、ZBS 或 ZCE 存储。ZCF 与 ZVF 只能选择一项。
虚拟化平台＋容器平台 部署 ZCF 虚拟化平台及 Zaku 容器云平台，可按需搭配 ZStone、ZBS 或 ZCE 存储。
注： Zaku 需搭配 ZCF 虚拟化平台，不能单独部署。
存储单独部署 单独部署 ZCE 存储。
注： 仅 ZCE 存储支持单独部署，ZStone 和 ZBS 存储必须搭配虚拟化平台部署。
Cube 部署

部署 ZCF 并搭配 ZCE、ZStone 或 ZBS 存储时，可启用 Cube 管理界面，通过统一的 Cube UI 实现组合产品的交付和管理。

本章以部署 ZCF 与 ZStone，并启用 Cube 管理界面为例，介绍产品部署向导的操作。涉及 Zaku 的参数和操作仅适用于同时选择 Zaku 的部署场景。

本例为三台服务器部署 ZStack Cloud 5.4.16 和 ZStone 5.5.12。截图中的主机名可在“配置系统”步骤调整，请通过设备 SN 和 MAC 地址对应同一台服务器。

  1. 发现主机
    1. 打开 Manager，进入发现主机页面。
      • Windows/macOS 部署机：在本机控制台的 Manager 卡片单击进入服务。
      • 直接访问：在浏览器中打开 http://<部署机可达IPv4地址>:10016/。
    2. 等待服务器发现和硬件信息采集完成，核对以下信息。
      • 服务器身份：根据准备阶段记录的设备 SN 和装机时设置的主机名，确认属于本次部署范围。
      • 硬件信息：查看 CPU、内存、磁盘和网卡信息，确认硬件采集完成。
      • CPU 架构：同一次产品部署选择相同架构的服务器。
      • SDDC 版本：核对发现列表中显示的版本信息。
    3. 勾选本次使用的服务器，单击下一步。
      图 7. 选择本次部署使用的服务器


    进入“选择产品”页面。

  2. 选择产品
    1. 选择本次部署的产品。
    2. 部署 ZStack Cube 时，在交付选项中开启启用 Cube 管理界面。

      此选项适用于 ZCF 搭配 ZCE、ZStone 或 ZBS 存储的组合。

    3. 确认产品组合和服务器资源满足页面要求，单击下一步。

      检查项包括服务器数量、CPU、内存、磁盘和网卡。

      图 8. 选择产品组合并启用 Cube 管理界面


    进入“管理安装包”页面。

  3. 管理安装包
    1. 单击产品兼容列表，核对所选产品的版本配套关系。
    2. 按需导入所选产品的安装包。

      本例使用以下配套安装包：

      • ZCF：使用 tar 格式的 ZCF 安装包，或 iso 格式的 ZStack Cloud 安装包。本例使用后者。
      • ZStone：使用 tar.gz 格式的安装包。
      注：

      部署其他产品时，使用对应格式的配套安装包：

      • ZVF：使用 iso 格式的 ZStack ZSphere 安装包。
      • ZBS：使用 tar.gz 格式的安装包。
        注： ZBS 与 ZStone 复用同一配套安装包。
      • ZCE：使用 tar.gz 格式的安装包。
      • Zaku：使用 qcow2 格式的镜像文件。

      包列表中已有所需安装包时，无需重复导入。否则，按以下方式导入：

      • 本地上传：单击上传包，选择本地上传，从浏览器所在电脑选择安装包文件并上传。
      • 远程 URL：单击上传包，选择远程 URL，填写部署机可访问的 HTTP/HTTPS 安装包地址，由部署机下载并导入。
      • 预置目录扫描：按配套部署说明确认预置目录，将安装包放入该目录后，单击重新扫描。Windows/macOS 便携包可在 config/config.yaml 中查看 package.presetPath；相对路径以软件包根目录为基准。
    3. 待安装包校验完成后，核对以下信息。
      • 安装包状态为“正常”。
      • 产品和版本为本次部署所需。
      • 支持的 CPU 架构和目标操作系统适用于所选服务器。
      • MD5 校验值与官方提供的值一致。
    4. 为各产品选择安装包，确认已选择的产品中均显示所选包，单击下一步。
      管理安装包

    通过部署校验后，进入“分配主机”页面。

  4. 分配主机
    1. 配置管理节点和管理访问地址。

      按部署规划配置以下参数。本例选择共用管理节点和单节点模式。

      参数名 配置说明
      管理节点分配
      • 共用管理节点：ZCF/ZVF 与存储产品共用一组管理节点，只需在共用管理节点区域选择一次。
      • 分离管理节点：分别在虚拟化平台和存储产品区域选择管理节点，两组管理节点不能重叠。
      管理节点数量
      • 单节点（1 个）：每组选择一台管理节点。
      • 双节点（2 个）：每组选择两台管理节点。
      管理节点
      • 共用模式：在共用管理节点区域选择服务器，所选服务器同时作为虚拟化平台和存储产品的管理节点，不需要再单独指定存储管理节点。
      • 分离模式：分别在对应产品的管理节点区域选择服务器。

      根据主机名和发现/访问 IP 核对服务器身份；后续产品配置使用“配置网络”中规划的管理 IP。
      管理 VIP（双节点模式） 填写用于访问产品管理界面的虚拟 IP 地址。
      • 共用模式：填写管理 VIP。
      • 分离模式：分别填写对应产品的 VIP，例如ZCF VIP和ZStone VIP。

      VIP 应与相应管理节点位于同一管理网段，且未被其他设备占用。单节点模式无需填写此项。
      分配管理节点与核对分配结果

    2. 核对分配结果预览中的管理节点和非管理节点。

      分配结果应与部署规划一致。共用模式下，ZCF/ZVF 与存储产品应显示相同的管理节点。

    3. 单击下一步，保存分配结果。

    进入“配置网络”页面。

  5. 配置网络
    1. 配置服务器的管理网络、存储网络及所需的业务网络。

      本例按主机配置管理网络，存储网络复用管理网，不启用业务网络。

      配置区域 参数项 配置说明
      / 配置范围
      • 所有主机统一配置：所有主机使用相同配置。
      • 按角色配置：管理节点和非管理节点分别配置。
      • 按产品配置：每个产品独立配置。
      • 按主机配置：先选择主机卡片，再填写该主机的网络参数；所有主机均显示完成标记后才能进入下一步。
      管理网络 网卡选择 单击添加网卡，根据网卡名称和 MAC 地址选择连接管理网络的网卡。此处配置的是服务器的产品管理网络，不是部署机的 PXE 服务网卡。
      IP、子网掩码、网关 按主机配置时，为当前服务器填写规划的管理 IP、子网掩码和网关；统一配置时填写起止 IP 范围。各服务器地址应与网络规划一一对应。
      Bond

      需要绑定网卡时，选择网卡并启用 Bond，然后选择绑定模式：

      • 主备 (mode1)：主网卡故障时切换到备用网卡。
      • 链路聚合 (mode4)：需在交换机上开启 LACP。
      VLAN ID 按相应网络的 VLAN 规划填写。不需要服务器在该网卡上配置 VLAN 标签时留空；不要直接照搬交换机或上层虚拟网络的 VLAN 编号。
      存储网络 配置方式
      • 统一配置：存储公共网和集群网共用一套网络参数。
      • 分别配置：为存储公共网和集群网分别填写参数。
      • 复用管理网：直接使用当前管理网络配置，无需重复填写存储地址。
      存储公共网（Public） 选择“分别配置”时显示，用于客户端与存储之间的数据读写。配置网卡、IP 范围或主机 IP、子网掩码，以及可选 VLAN ID。
      存储集群网（Cluster） 选择“分别配置”时显示，用于存储节点之间的数据复制、回填和心跳。配置网卡、IP 范围或主机 IP、子网掩码，以及可选 VLAN ID。
      Bond

      需要绑定网卡时，选择网卡并启用 Bond，然后选择绑定模式：

      • 主备 (mode1)：主网卡故障时切换到备用网卡。
      • 链路聚合 (mode4)：需在交换机上开启 LACP。
      VLAN ID 按相应网络的 VLAN 规划填写。不需要服务器在该网卡上配置 VLAN 标签时留空；不要直接照搬交换机或上层虚拟网络的 VLAN 编号。
      业务网络 配置业务网络 需要通过向导生成 ZCF/ZVF 业务网络时开启。本例不启用此项。
      网卡选择
      • 开启业务网络后，选择一张网卡或两张速率相同的网卡；可复用管理网络或存储网络已使用的网卡。
      • 复用已配置 Bond 的网卡时，沿用已有 Bond，不再显示 Bond 选择。
      • 选择尚未使用的独立网卡时，页面显示 Bond 选择，可按需配置。
      IP 范围、子网掩码、网关 开启业务网络后填写，用于生成 ZCF/ZVF 的推荐网络配置。根据业务网络规划填写起止地址、子网掩码和网关；此处的 IP 范围用于虚拟化业务网络，不是服务器管理地址。
      VLAN ID 开启业务网络后，按业务网络规划填写 VLAN ID；无需配置 VLAN 标签时留空。
      配置主机网络

    2. 核对各服务器的网络参数，单击下一步。

    IP 冲突检测通过后，网络配置保存并进入“配置系统”页面。

  6. 配置系统
    1. 配置主机名、连接凭据和系统服务。
      参数名 配置说明
      主机名 在批量配置中填写名称前缀和后缀，核对“生成预览”后单击应用。在下方主机列表中逐台核对名称、设备 SN 和规划管理 IP。主机名总长度不超过 16 个字符（含前缀、连字符和后缀）。
      Root 密码 填写服务器当前可用的 root 密码。通过前文 PXE 安装的服务器，填写装机时设置的密码。此处用于后续 SSH 连通性检查，不会修改服务器密码。
      SSH 端口 填写服务器实际使用的 SSH 端口，默认值为 22。同一批次所有服务器须使用相同端口。此处不会修改服务器的 SSH 端口。
      NTP时钟源 填写服务器能够访问的 NTP 时间源地址，用于同步时间。仅支持 IPv4 地址，不支持域名。多个地址用英文逗号分隔。
      DNS服务器 填写服务器能够访问的 DNS 服务器地址，用于域名解析。多个地址用英文逗号分隔。
      防火墙 按现场安全策略设置防火墙状态。开启时，系统会自动开放产品运行所需端口。
      额外开放端口 需要开放其他端口时，单击新增端口，填写端口或端口范围，并选择 TCP 或 UDP 协议。多个端口或范围用英文逗号分隔，例如 8092,8093-8095。
      免密登录 部署存储产品需要开启SSH Key 免密登录，建议保持默认开启状态。
      系统批量配置

      核对主机列表

    2. 核对各服务器的系统参数，保存并进入下一步。
      需要在现场识别服务器时，可在主机列表的定位灯列选择点亮、闪烁或关闭。

    进入“配置产品”页面。

  7. 配置产品
    1. 选择配置方式。
      参数名 配置说明
      推荐配置 单击页面右上角的推荐配置，根据已保存的服务器、网络和产品信息生成配置，并进入“确认配置”页面。本例采用此方式。
      手工配置 按部署规划自行填写所选产品的参数。
      注： 推荐配置会替换所选产品的现有配置。出现覆盖提示时，确认无需保留现有配置后，再单击生成并覆盖。
    2. 核对或填写所选产品的参数。
      • 推荐配置：生成后进入“确认配置”页面。ZCF 管理员密码和数据库密码需手工填写，本例须单击上一步返回“配置产品”，补齐并确认两类密码、核对下表参数后保存。其他产品按页面要求补齐未生成的必填项。
      • 手工配置：在“配置产品”页面按下表填写并保存。

      以下参数说明以 ZCF＋ZStone 为例。实际配置项及要求以所选产品的页面为准，参数值按部署规划填写。

      配置区域 参数项 配置说明
      ZStone 存储配置 主机配置 管理、监控、数据、块网关：在存储配置（ZStone）的主机配置中勾选服务器并分配角色。至少三台节点同时具备管理、监控、数据和块网关四种角色。这里是 ZStone 内部的服务角色，与“分配主机”页选择的产品管理节点用途不同。
      数据盘配置 数据盘类型：
      • 混合盘：使用 SATA SSD 或 NVMe 作为缓存盘，为 HDD 数据盘提供加速。
      • 原生盘：直接使用 HDD、SSD 或 NVMe 作为数据盘。

      可同时使用两种类型，但同一磁盘不能重复使用。本例三台服务器均只有 HDD 数据盘，使用原生盘。
      • 缓存盘：配置混合盘时，先选择缓存盘。
      • 分配方式：选择缓存盘后，指定缓存盘与数据盘的对应方式：
        • 自动分配：由工具分配对应关系。
        • 手动分配：手动指定对应关系。
      • 数据盘：配置混合盘时，按所选分配方式配置；配置原生盘时，直接选择数据盘。

      本例选择三台服务器的 vdb、vdc，保留系统盘 vda。
      存储池配置

      单击添加存储池后配置：

      • 名称：填写存储池名称，本例为推荐配置生成的 pool-hdd。
      • 副本数：按存储规划选择，本例为 3。
      • 故障域级别：按存储规划选择，本例为服务器。
      OSD 分配：为当前池选择上一页的数据盘，至少创建一个存储池。每个数据盘最多属于一个池。本例将六块原生数据盘分配给同一个存储池。
      ZCF 虚拟化配置 主机配置 计算节点：核对“分配主机”中已选择的管理节点，再选择承担计算角色的服务器。管理节点也可以同时承担计算角色。本例三台服务器均作为计算节点，其中一台同时作为管理节点。
      公共配置
      • 管理员密码：设置安装后登录产品界面使用的密码，并填写确认密码。
      • 数据库密码：设置产品数据库用户使用的密码，并填写确认密码。
      • 集群规模：按交付要求选择。

      两类密码均须满足页面列出的复杂度要求。推荐配置不会自动填写，需自行设置。
      创建区域
      • 名称：填写区域名称。本例保留推荐配置生成的 ZONE-1。
      • 简介：按需填写。
      创建集群

      核对所属区域后，配置以下参数：

      • 名称：填写集群名称，本例为 Cluster-1。
      • 虚拟化类型：按部署规划选择，本例为 KVM。
      • CPU 架构：与所选服务器一致，本例为 x86_64。
      添加镜像服务器
      • 类型：本例使用 ZStone，选择 Ceph。
      • Mon 节点：选择已分配监控角色的 ZStone 服务器，使用“配置网络”中规划的管理 IP，以及“配置系统”中的 SSH 端口和 root 凭据。
      • 镜像服务器池：填写前面创建的存储池名称。

      推荐配置会根据已保存的节点、凭据和存储池信息生成这些参数，逐项核对即可。
      添加主存储
      • 类型：本例选择 Ceph。
      • Mon 节点：核对各节点的管理 IP 和 SSH 连接信息。
      • 镜像缓存池：核对所用存储池，本例为 pool-hdd。
      • 数据云盘池：核对所用存储池，本例为 pool-hdd。
      • 根云盘池：核对所用存储池，本例为 pool-hdd。
      • 存储网关 CIDR：填写存储网络对应的 CIDR。
      • 可选参数：按需设置 Cephx、冷迁移网络和 Ceph 企业版访问令牌。
      创建计算规格
      • 名称：填写计算规格名称。
      • CPU 数量：设置云主机使用的 CPU 数量。
      • 内存容量：设置云主机使用的内存容量。
      • 物理机分配策略：按部署规划选择。
      • 可选参数：按需设置云盘带宽、IOPS、网络带宽限制和高级配置。

      本例保留推荐配置生成的 1 核、1 GB 规格。
      添加镜像
      • 镜像格式：按镜像实际格式选择。
      • CPU 架构：按镜像实际架构选择。
      • 平台：按镜像实际平台选择。
      • 操作系统：按镜像实际操作系统选择。
      • 镜像 URL：填写镜像文件地址。
      • BIOS 模式：按镜像支持的启动方式选择。

      同时核对 Virtio 和镜像服务器。本例使用推荐配置中的预置 qcow2 镜像；镜像 URL 指向产品安装介质内的文件，不是部署机上的操作系统镜像路径。
      创建二层网络、创建三层网络 按业务网络规划开启并配置。本例在“配置网络”中未启用业务网络，推荐配置相应关闭这两项，安装时不创建二层、三层网络。需要部署 Zaku 的场景应准备其使用的业务网络。
      Zaku 配置（选择时） 集群名称与部署模式
      • 集群名称：填写管理集群名称。
      • 部署模式：选择单节点或 HA 模式；HA 模式使用三台管理云主机。
      管理云主机规格

      为每个管理节点配置以下资源，并核对虚拟化平台资源是否足够：

      • CPU：按部署规划配置。
      • 内存：按部署规划配置。
      • 系统盘：按部署规划配置。
      • 数据盘：按部署规划配置。
      地址 从本次业务 IPv4 三层网络的可分配地址池中配置地址，确认已开启 IPAM（IP 地址管理）。单节点模式至少需要两个地址；HA 模式至少需要五个，分别用于管理节点、集群 VIP 和控制台访问。
      Cloud 管理员密码 继承前面配置的虚拟化平台管理员密码；如需修改，返回虚拟化平台配置。
      Cloud 地址与 NTP
      • Cloud 地址：填写或核对本次虚拟化平台的访问地址。
      • NTP：核对前面已配置的时间源。
      配置存储池

    产品配置已保存，进入“确认配置”页面。

  8. 确认配置
    1. 核对以下部署配置。
      • 产品组合、版本、安装包及 Cube 管理界面开关。
      • 管理模式、管理 VIP、节点角色、系统盘与数据盘。
      • 存储池、虚拟化存储绑定、管理网络和业务地址池。
      • SSH 凭据配置状态、端口、NTP 和 DNS。
      • 选择 Zaku 时，核对其管理集群模式、每节点资源、地址和存储依赖。
      复核主机地址

      复核产品组合与管理节点

    2. 需要调整时，返回对应步骤修改并保存。

      节点、网络或安装包发生变化时，重新核对受影响的产品配置。

    3. 确认无误后，进入下一步。

    进入预检查页面。

  9. 预检查
    1. 运行预检查，等待各检查项返回结果。

      检查内容包括 Agent 通信、安装包完整性与兼容性、产品配置、可用空间、硬件兼容性和 SSH 连接等，实际项目随所选产品和版本变化。

      图 15. 预检查结果


    2. 确认全部检查通过，进入下一步。

    安装前检查通过，具备执行产品部署的条件。

  10. 安装部署
    1. 提交部署任务。
      警告： 提交部署任务后，会按已保存的配置修改服务器并安装产品。提交前再次核对目标服务器、磁盘用途及数据备份。
    2. 查看各产品和服务器的部署进度、日志及状态。

      工具按依赖完成服务器基础配置、存储、虚拟化安装和 Cloud 初始化，再部署所选附加产品。

      • 部署 Cube 时，检查“配置 Cube 管理界面”阶段及其校验结果。
      • 部署 Zaku 时，检查前置检查、镜像处理、管理云主机创建和集群就绪结果。
    3. 等待全部已选产品部署成功。

    全部已选产品部署成功，进入完成页。

  11. 完成
    1. 核对各产品和服务器的部署结果。
    2. 打开各产品控制台，确认可正常访问，并检查以下内容。
      • 虚拟化与存储组合：核对产品管理界面、存储接入和所配置的关键资源。未创建业务网络时，后续使用云主机前还需配置所需网络。
      • ZStack Cube：确认显示 Cube 管理界面，存储信息和对应管理入口正常；多管理节点场景还应核对预期入口和节点状态。
      • Zaku：核对管理云主机数量、集群就绪状态、控制台入口，以及实际地址和存储是否符合配置。
    3. 下载部署报告并妥善保存。

      当前部署完成并保存报告后，如需部署另一套环境，可在 Manager 页面单击重置。重置会归档当前批次、清空向导配置并重新发现主机，保留安装包，不影响已完成部署的环境。

      重要： 部署进行中，重置会清空当前向导配置并影响当前任务；仅在决定放弃本次部署、重新配置时使用。

      如果完成页提供自动停用倒计时或停服操作，先保存报告并完成验收，再停止部署服务。部署服务停止不等于已安装产品停止运行。

    产品验收通过，部署报告已保存。

产品安装完成后，在对应产品的管理界面中进行云资源、存储和容器的日常管理。

常见问题

部署页面无法访问或服务状态无法确认

  1. 核对访问地址，使用部署机可达的 IPv4 地址；Manager 页面端口为 10016，PXE 页面端口为 10018。确认浏览器所在设备能够访问对应地址和端口。

  2. 检查对应服务是否运行：

    • Windows/macOS 部署机：在本机控制台查看 Manager 或 PXE 服务卡片。状态无法确认时，单击授权检测，完成系统授权后单击重新检测。
    • Linux 部署机：使用Linux（服务器兼任部署机）中的状态命令检查。
  3. 服务未运行时，按配置部署机启动对应服务，再访问页面。

服务器未被发现

PXE 页面未发现目标服务器

  1. 确认当前批次已选择并确认状态为“已就绪”的安装介质，且介质支持服务器的 CPU 架构和启动方式。
  2. 确认服务器从与部署机 PXE 网络相连的网卡启动，两端处于同一二层网络，装机网络中没有冲突的 DHCP 服务。
  3. 等待探测完成，按准备阶段记录的 MAC 地址和设备 SN 核对服务器。

Manager 页面未发现已装机的服务器

  1. 通过服务器控制台确认已从本地系统盘进入配套操作系统。
  2. 确认系统和 SDDC Agent 已启动，部署机与服务器的网络满足准备网络中的要求。
  3. 在发现主机页面单击重新扫描，按设备 SN 核对服务器。硬件信息采集仍有错误时，保留提示，不选择信息尚未确认的服务器。

安装介质或产品包检查不通过

  1. 确认文件来自本次版本的配套交付，并核对文件名、版本和官方提供的 MD5 校验值。

  2. 根据文件用途核对以下条件：

    • 服务器操作系统镜像：支持服务器的 CPU 架构和启动方式。
    • 产品安装包：产品、版本、文件格式、CPU 架构和目标操作系统与本次部署匹配。格式要求见管理安装包。
  3. 等待导入及校验结束，核对页面结果。PXE 介质须为“已就绪”，产品安装包须为“正常”，再选择并继续。检查仍不通过时，记录文件信息和完整错误提示。

查看错误和保存支持资料

完成上述检查后仍无法继续部署时，保留以下信息并联系官方技术支持：

  • SDDC Manager 和所选产品的版本、当前步骤、受影响服务器的设备 SN，以及完整错误提示。
  • 安装包导入问题：在上传包窗口或包列表查看任务状态，记录文件名和失败原因。
  • PXE 装机问题：在安装部署页面单击对应服务器的详情，保留阶段、状态和错误信息。
  • 产品部署问题：在安装部署页面保留失败产品、服务器、阶段及相关日志。

装机或部署完成后，按结束批次并保存报告或产品向导的完成步骤保存相应报告。

报告可能包含服务器配置和密码等敏感信息，应妥善保管，向他人提供前先脱敏。

附录

名词解释

名称 说明
部署机（Controller） 运行 SDDC 部署服务的设备，可独立使用，也可由目标服务器兼任。
服务器（主机） 安装并运行目标产品的节点，在操作界面中称为“主机”。
SDDC Manager 用于配置和安装目标产品的部署工具。
本机控制台（Console） Windows/macOS 便携包提供的网页入口，用于查看和配置部署机网络、启停 Manager 和 PXE 服务。
Manager 服务 提供产品部署向导的服务。
PXE 预启动执行环境（Preboot Execution Environment），用于通过网络启动服务器并安装操作系统。
SDDC Agent 安装在服务器上的代理程序，用于主机发现、硬件信息采集和部署操作。
ISO 镜像 光盘镜像文件，本文档中的 ZStack Cloud 产品安装包采用此格式。
RPM 软件包 一种 Linux 软件包格式，配套的 SDDC Manager 软件包可通过 rpm 命令安装。
MD5 一种文件摘要算法，本文档中用于核对文件的计算结果与提供方给出的校验值是否一致。
MAC 地址 网络接口的地址，本文档中用于核对部署机网卡和待装服务器的 PXE 网卡。
设备 SN 设备序列号（Serial Number），用于核对目标服务器的身份。
DHCP 动态主机配置协议（Dynamic Host Configuration Protocol），在本文档的 PXE 装机流程中为待装服务器分配 IP 地址等网络参数。
DHCP 地址池 PXE 服务可分配给待装服务器的 IP 地址范围。
IPv4 / IPv6 互联网协议的两个版本，本文档使用 IPv4 地址访问服务页面，并在服务器发现与 Agent 通信的网络要求中使用 IPv6。
CIDR 用 IP 地址、斜杠和前缀长度表示地址及其网络范围的写法，例如 192.168.10.0/24。
网关 连接当前网络与其他网络的转发设备，配置时通常填写其在当前网络中的 IP 地址。
DNS 域名系统（Domain Name System），用于将域名解析为 IP 地址等信息。
mDNS 组播域名系统（Multicast DNS），本文档中的自动发现使用该机制发现网络中的服务器。
Zaku 管理云主机 在虚拟化平台中创建、用于运行 Zaku 管理集群的云主机。
管理 VIP 用于访问产品管理界面的虚拟 IP 地址。
推荐配置 工具根据所选产品、节点硬件和网络信息自动生成的部署参数。
部署报告 记录本次装机或产品安装过程及结果的文件。
Mon 节点 Ceph 存储的监控节点。本例为 ZStone 中已分配监控角色的服务器。