Wizard引导设置

首次登录ZStack Cube 旗舰版，在Chrome 66及以上版本的浏览器中输入相应URL地址http://management_node_ip:5000，输入默认账户名admin 和默认初始密码password，系统界面将引导进行ZStack Cube 旗舰版基本的初始化环境配置。ZStack Cube 旗舰版提供自动初始化和手动初始化两种初始化方式：

自动初始化：系统自动扫描硬件资源，并根据预配置为云平台创建/添加基础资源。
手动初始化：用户手动配置为云平台创建/添加基础资源。

Note:

在系统使用中，如果中断Wizard引导设置或者删除了系统关键资源，系统将不会再次进入引导界面。
建议按照引导进行ZStack Cube 旗舰版基本环境的配置。

自动初始化

ZStack Cube 旗舰版为自动初始化流程预配置了以下基础资源：区域、集群、物理机、镜像服务器、主存储、计算规格、云盘规格、镜像、二层网络、三层网络。

区域：云平台内最大的一个资源定义，包括：集群、二层网络、主存储等资源。
集群：一组物理机（计算节点）的逻辑集合。
物理机：为云主机实例提供计算、网络、存储等资源的物理主机。
镜像服务器：用于存储云主机镜像模板（含ISO）的存储服务器。
主存储：用于存储云主机磁盘文件（包括：根云盘、数据云盘、根云盘快照、数据云盘快照、镜像缓存等）的存储服务器。
计算规格：云主机涉及的CPU数量、内存、网络设置等规格定义。
镜像：云主机或云盘使用的镜像模板文件，包括两种类型：系统镜像、云盘镜像。
二层网络：对应于一个二层广播域，进行二层相关的隔离。一般用物理网络的设备名称标识。
三层网络：云主机使用的网络配置，包括：IP地址范围、网关、DNS、网络服务等。

Note: 若在部署环境时未配置业务网络，自动初始化流程不会创建二层网络和三层网络。

其中：

物理机、镜像服务器和主存储资源配置为扫描物理硬件后云平台获取的配置信息。
计算规格包括以下三种类型：
- 均衡型：CPU/内存配比为1:4，包括1C4G、2C8G、4C16G、8C32G四种计算规格。
- 计算型：CPU/内存配比为1:2，包括1C2G、2C4G、4C8G、8C16G四种计算规格。
- 内存型：CPU/内存配比为1:8，包括2C16G、4C32G、8C64G、16C128G四种计算规格。
云盘规格包括20GB、40GB、100GB、200GB、和500GB五种类型。

如图 1所示：

点击开始初始化，将按照以上资源配置初始化云平台。

Note: 若存在资源创建/添加失败，点击重试后，将从创建/添加“失败”的资源开始继续初始化。

如图 2所示：

创建网络

若在部署环境时未配置业务网络，自动初始化流程不会创建二层网络和三层网络，需手动进行创建。

创建二层网络

可参考以下示例输入相应内容：

名称：输入二层网络的名称
简介：可选项，可留空不填
交换机类型：支持Linux Bridge和OVS-DPDK两种交换机类型
网络类型：可选择以下网络类型：L2NoVlanNetwork、L2VlanNetwork
- L2NoVlanNetwork
  - 若不打算使用Vlan网络，则选择L2NoVlanNetwork。
  - NoVlanNetwork模式下，指定的网卡连接交换机网口必须是Access模式。
- L2VlanNetwork
  - 若需要ZStack Cube 旗舰版帮助配置VLAN网络，则需选择L2VlanNetwork。
  - VlanNetwork模式下，指定的网卡连接交换机网口必须是Trunk模式。
  - 输入Vlan ID，可输入1~4094之间的数字，需与交换机配置相同。
集群：显示二层网络加载的集群
网卡名称：选择或输入二层网络设备名称，例如：em01
Note: 仅支持选择或输入集群内所有物理机之间具体相同名称的网卡。

如图 1所示

创建三层网络

可参考以下示例输入相应内容：

名称：输入三层网络的名称
简介：可选项，可留空不填
网络类型：Wizard仅支持创建扁平网络
网络段方法：添加网络段方法包括IP范围、CIDR
若选择IP范围，需填写以下参数：
- 起始IP：设置网络段的起始IP，例如：172.20.108.100
- 结束IP：设置网络段的结束IP，例如：172.20.108.200
- 子网掩码：设置网络段的子网掩码，例如：255.255.0.0
- 网关：设置网络段的网关，例如：172.20.0.1
- 添加DNS：可添加DNS服务器，用于设置三层网络的DNS解析服务，例如可指定223.5.5.5、8.8.8.8或114.114.114.114
若选择CIDR，需填写以下参数：
- CIDR：设置网络段的CIDR，例如：192.168.108.1/24
- 网关：可设置网关，例如：192.168.108.1
  Note:
  - 允许使用CIDR的第一个或最后一个IP地址作为网关。
  - 若留空不填，默认使用CIDR的第一个IP地址作为网关。
- 添加DNS：可添加DNS服务器，用于设置三层网络的DNS解析服务，例如可指定223.5.5.5、8.8.8.8或114.114.114.114

如图 2所示

至此，自动初始化流程全部完成。

手动初始化

创建区域

背景信息

区域：云平台内最大的一个资源定义，包括：集群、二层网络、主存储等资源。

如图 1所示：

可参考以下示例输入相应内容：

名称：输入区域的名称
简介：可选项，可留空不填

点击下一步按钮，完成区域创建。

创建集群

背景信息

集群：一组物理机（计算节点）的逻辑集合。

如图 1所示：

可参考以下示例输入相应内容：

名称：输入集群的名称
简介：可选项，可留空不填
类型：可选择服务器的 Hypervisor 类型，包括：KVM、XDragon

点击下一步按钮，完成集群创建。

添加物理机

背景信息

物理机：为云主机实例提供计算、网络、存储等资源的物理主机。

如图 1所示：

选择需要添加的物理机，点击下一步，ZStack Cube 旗舰版会调用后台作业来配置物理机。

如需修改物理机配置信息，可点击右侧编辑按钮，支持修改以下内容：

名称：输入物理机的名称
简介：可选项，可留空不填
SSH端口：输入物理机的SSH端口，默认为22，如果此物理机没有配置SSH端口，则可按照默认配置的22端口使用
用户名：输入物理机的用户名，输入具有sudo权限的用户。
- 普通用户要求拥有sudo权限。
- 建议在创建普通用户时，使用adduser命令。
  创建普通用户及修改用户sudo权限可参考以下样例：
```
#创建一个名为test的普通用户
[root@localhost ~]# adduser test
#授权test用户拥有sudo权限
[root@localhost ~]# echo "test    ALL=(ALL)    NOPASSWD: ALL" >>/etc/sudoers
```
密码：输入对应的用户密码，输入时请注意大小写。

配置过程可能持续几分钟。
若安装出错，会提示相应的错误信息。

后续操作

若Wizard引导设置结束后，要在同一区域的同一集群中再添加其它物理机，则对应主机需安装相同的操作系统。SSH端口、用户名、密码无须相同。

添加镜像服务器

镜像服务器：用于存储云主机镜像模板（含ISO）的存储服务器。

如图 1所示：

请参考以下示例输入相应内容：

名称：输入镜像服务器的名称
简介：可选项，可留空不填
存储池：可选项，可对Ceph镜像服务器指定特定的存储池
- 如果指定，需提前在Ceph存储集群自行创建存储池。
- 如果不指定，默认自动创建存储池。

如需修改镜像服务器监控节点配置信息，可点击右侧编辑按钮，支持修改以下内容：

SSH端口：默认为22，如果此节点没有配置SSH端口，则可按照默认配置的22端口使用。
用户名：默认为root用户，也可输入普通用户
- 如果镜像服务器没有添加普通用户，则可按照默认的root用户使用。
- 普通用户要求拥有sudo权限。
密码：输入对应的用户密码，输入密码时请注意大小写

点击下一步按钮，系统会配置Ceph类型镜像服务器。

添加主存储

主存储：用于存储云主机磁盘文件（包括：根云盘、数据云盘、根云盘快照、数据云盘快照、镜像缓存等）的存储服务器。

如图 1所示：

可参考以下示例输入相应内容：

名称：设置主存储名称
简介：可选项，可留空不填
存储池：可选项，可对Ceph主存储指定特定的存储池
- 如果指定，需提前在Ceph存储集群自行创建存储池。
- 如果不指定，默认自动创建存储池。

如需修改主存储Mon节点配置信息，可点击右侧编辑按钮，支持修改以下内容：

SSH端口：默认为22，如果此节点没有配置SSH端口，则可按照默认配置的22端口使用。
用户名：默认为root用户，也可输入普通用户
- 如果主存储没有添加普通用户，则可按照默认的root用户使用。
- 普通用户要求拥有sudo权限。
密码：输入对应的用户密码，输入密码时请注意大小写

点击下一步按钮，完成Ceph主存储添加。

创建计算规格

背景信息

计算规格：云主机涉及的CPU数量、内存、网络设置等规格定义。

如图 1所示：

可参考以下示例输入相应内容：

名称：设置计算规格的名称
简介：可选项，可留空不填
CPU：设置云主机CPU的核数
内存：设置云主机内存的大小，基本单位包括：M/G/T
物理机分配策略：创建云主机时采用此计算规格，则执行对应选择的物理机分配策略，默认策略为“运行云主机数量最少”，各策略特性如下：
- 运行云主机数量最少：优先选择云主机最少的物理机来创建云主机
- CPU使用率最低：优先选择CPU使用率最低的物理机来创建云主机
  Note:
  - 系统会采集一段时间内物理机CPU负载数据，计算出这段时间的平均CPU使用率，然后优先选择CPU使用率最低的物理机来创建云主机。
  - 数据采集周期默认10分钟，在设置 > 全局设置 > 高级设置中，修改物理机CPU使用率最低采集间隔参数，更改数据采集时间。
- 内存使用率最低：优先选择内存使用率最低的物理机来创建云主机
  Note:
  - 系统会采集一段时间内物理机内存负载数据，计算出这段时间的平均内存使用率，然后优先选择内存使用率最低的物理机来创建云主机。
  - 数据采集周期默认10分钟，在设置 > 全局设置 > 高级设置中，修改物理机内存使用率最低采集间隔参数，更改数据采集时间。
- 运行云主机最大数量：用户需要先设置物理机最多运行云主机的数量，然后系统会筛选出满足此要求的物理机来创建云主机。如果没有满足条件的物理机，那么云主机创建失败。
- 首选上次所在物理机：已关机的云主机启动时优先选择上次所在物理机，首次启动的云主机随机选择物理机。
- 随机分配：随机选择物理机来创建云主机
设置磁盘带宽：可选项，设置云主机根云盘的IO带宽上限。为空时，代表不限制IO带宽。基本单位包括：MB/s、GB/s、TB/s
使用磁盘带宽的方法有以下两种：
- 总速度：
  如选择总速度，需设置云主机根云盘的读写总速度上限，需输入整数，单位：MB/s、GB/s，取值范围：1MB/s~100GB/s。
- 读写速度：
  如选择读写速度，需设置以下内容：
  - 读取速度：设置云主机根云盘的读取速度上限，需输入整数，单位：MB/s、GB/s，取值范围：1MB/s~100GB/s。
  - 写入速度：设置云主机根云盘的写入速度上限，需输入整数，单位：MB/s、GB/s，取值范围：1MB/s~100GB/s。
设置磁盘IOPS：可选项，可设置云盘每秒的读写次数上限
若不设置，代表不限制每秒读写次数。支持以下两种设置方式：
- 按总IOPS：如选择按总IOPS，需设置云盘每秒读写次数上限
- 按读写IOPS：如选择按读写IOPS，需设置以下内容：
  - 读IOPS：可选项，可设置云盘读IOPS上限
  - 写IOPS：可选项，可设置云盘写IOPS上限
设置网络带宽：可选项，设置云主机的网络带宽
- 上行带宽：可选项，设置从云主机上传的网络带宽上限。若为空，代表不限制上行带宽。需输入整数，基本单位包括：Kbps、Mbps、Gbps，取值范围：8Kbps~100Gbps。
- 下行带宽：可选项，设置从云主机下载的网络带宽的上限。若为空，代表不限制上行带宽。需输入整数，基本单位包括：Kbps、Mbps、Gbps，取值范围：8Kbps~100Gbps。
  Note: 用户需完全理解磁盘带宽和网络带宽的配置含义，才能进行相应设置，否则可能导致无法从云主机上传/下载文件。

高级参数：通过json格式配置高级参数，自定义区分磁盘性能

示例格式如下：

{
  "allocate": {
    "primaryStorage": {
      "type": "输入主存储类型，支持Ceph、LocalStorage、NFS、SharedBlock",
      "uuid": "输入主存储UUID",
      "poolNames": [
        "输入Ceph pool名称，若非Ceph主存储，需删除poolNames配置"
      ]
    }
    "clusterUuid":"输入集群UUID"
  },
  "priceUserConfig": {
    "rootVolume": {
      "priceKeyName": "自定义根云盘计费名称，计费价目的高级参数需要与该参数完全一致，否则不能生成相关计费条目。"
    }
  },
  "displayAttribute": {
    "rootVolume": {
      "diskType": "自定义根云盘显示类型，可在云主机详情页面查看此高级参数。"
    }
  }
}

配置分为三个部分，如下：

配置根云盘所属的主存储和集群：
```
"allocate": {
    "primaryStorage": {
      "type": "输入主存储类型，支持Ceph、LocalStorage、NFS、SharedBlock",
      "uuid": "输入主存储UUID",
      "poolNames": [
        "输入Ceph pool名称，若非Ceph主存储，需删除poolNames配置"
      ]
    }
    "clusterUuid":"输入集群UUID"
  }
```
- type：输入主存储类型，支持Ceph、LocalStorage、NFS、SharedBlock，其中Ceph主存储支持指定Ceph pool。
- uuid：输入主存储UUID。
- poolNames：输入Ceph pool名称，若非Ceph主存储，需删除poolNames配置。
- clusterUuid：输入指定计算规格分配的集群UUID
Note: 若不指定主存储或集群，需将对应的代码全部删除。
配置根云盘计费类型：
```
"priceUserConfig": {
    "rootVolume": {
      "priceKeyName": "自定义根云盘计费名称，计费价目的高级参数需要与该参数完全一致，否则不能生成相关计费条目。"
    }
  }
```
- priceKeyName：自定义根云盘计费名称，计费价目的高级参数需要与该参数完全一致，否则不能生成相关计费条目。
Note: 若不需要计费，此部分代码全部删除。
配置根云盘显示属性：
```
"displayAttribute": {
    "rootVolume": {
      "diskType": "自定义根云盘显示类型，可在云主机和根云盘详情页面查看此高级参数。"
    }
  }
```
- rootVolume：自定义根云盘显示名称，用于详情页展示。支持配置多个属性，配置格式为key-value(键值对)。
Note: 若不需要特殊显示，此部分代码全部删除。

点击下一步按钮，完成计算规格创建。

添加镜像

背景信息

镜像：云主机或云盘使用的镜像模板文件，包括两种类型：系统镜像、云盘镜像。

如图 1所示：

可参考以下示例输入相应内容：

名称：输入云主机镜像的名称
简介：可选项，可留空不填
镜像格式：选择相应的镜像格式，包括qcow2、raw和iso。需根据镜像的文件属性选择正确的选项。
平台：选择相应的平台类型，包括：Linux、Windows、Other
Note: 使用Other平台类型可以解决旧版本系统的兼容问题。
镜像路径：可选择URL或本地文件方式上传镜像
- URL：采用指定的URL路径来添加镜像。
  - 支持HTTP/HTTPS方式：
    - 填写格式为：http://path/file或https://path/file
    - 例如：http://cdn.zstack.io/product_downloads/images/zstack-image.qcow2
  - 支持FTP方式：
    - 匿名模式：ftp://hostname[:port]/path/file
      例如：ftp://172.20.0.10/pub/zstack-image.qcow2
    - 非匿名模式：ftp://user:password@hostname[:port]/path/file
      例如：ftp://zstack:password@172.20.0.10/pub/zstack-image.qcow2
  - 支持SFTP方式：
    - 指定密码模式：sftp://user:password@hostname[:port]/path/file
      例如：sftp://root:password@172.20.0.10/pub/zstack-image.qcow2
    - 免密模式：sftp://user@hostname[:port]/path/file
      例如：sftp://root@172.20.0.10/pub/zstack-image.qcow2
  - 镜像服务器上的绝对路径，支持Sftp镜像服务器和镜像仓库
    例如：file:///opt/zstack-dvd/zstack-image-1.4.qcow2
  Note:
  - 输入URL时，需确保可被镜像服务器访问，且存在此镜像文件。
  - 使用SFTP免密模式上传镜像时，需提前确保镜像服务器与Sftp服务器可互相SSH免密登录。
  - 关于平滑连续进度条显示和断点续传：
    - ImageStore和Ceph镜像服务器均支持平滑连续进度条显示与断点续传。
  - 关于file:///方式上传镜像
    - 若使用Ceph镜像服务器，目前暂不支持file:///格式的输入；
    - file:///是三个/，对应的路径应为镜像服务器的绝对路径，例如file:///opt/zstack-dvd/zstack-image-1.4.qcow2，在镜像服务器的/opt/zstack-dvd目录下应存放有zstack-image-1.4.qcow2文件。
- 本地文件：选择当前浏览器可访问的镜像直接上传，支持镜像仓库。

BIOS模式：选择BIOS模式，包括：Legacy和UEFI

Legacy：支持X86架构和所有操作系统。为了确保使用稳定，推荐使用Legacy模式引导。
UEFI：aarch64和mips64el架构需使用UEFI模式，支持Windows操作系统和CentOS操作系统，其中，Windows 7/2008版本必须使用兼容模块 (CSM)。

Note: 模式不匹配可能导致云主机无法正常工作，请谨慎选择：

对于qcow2或raw格式的镜像，请选择与封装时一致的BIOS模式。
对于iso格式的镜像，可自行选择BIOS模式，系统将基于所选模式引导安装。

若创建的云主机希望使用UEFI引导，建议从以下操作系统版本列表中选择相应的云主机镜像：

操作系统	BIOS模式	支持版本
Windows平台	UEFI	Windows 8及以上版本
Windows平台	UEFI	Windows 7 Windows Server 2008 R2
Linux平台	UEFI	CentOS 7.2 CentOS 7.3 CentOS 7.4及以上版本

对于使用UEFI引导模式的Windows云主机（例如：Windows Server 2012 R2、Windows Server 2016和Windows 10等版本），启动后会显示如下页面，需按任意键继续安装，否则将进入UEFI Shell。
如图 2所示：
图 2. 按下任意键继续

若进入UEFI Shell，需执行以下命令，才能成功启动进入操作系统：
```
Shell> fs0:
FS0:\> dir
FS0:\> cd EFI
FS0:\EFI\> cd BOOT
FS0:\EFI\BOOT\> BOOTX64.EFI
```
操作后请及时按任意键，否则会再次进入UEFI Shell。

QEMU Guest Agent：可选项，可标记当前镜像是否已经安装QEMU Guest Agent
Note: 若镜像己安装QEMU Guest Agent，并已设置为自启动，则由此镜像创建出来的云主机，以及该云主机克隆生成的云主机或创建的镜像，可在运行状态下从外部修改云主机密码。
支持弹性裸金属实例：可选项，标识镜像是否可用于创建弹性裸金属实例，开启表示可用于创建弹性裸金属实例
Note: 添加弹性裸金属实例的镜像需要确保以下情况：
- 需确保创建弹性裸金属实例的镜像已安装agent，否则无法执行打开控制台、修改弹性裸金属实例密码、加/卸载云盘、加/卸载网络操作。
- 需确保创建弹性裸金属实例的镜像的BIOS模式与系统配置相同。默认为UEFI，若需要使用Legacy，请联系官方技术支持获取帮助。

点击下一步按钮，完成镜像添加。

创建二层网络

背景信息

二层网络：对应于一个二层广播域，进行二层相关的隔离。一般用物理网络的设备名称标识。

如图 1所示：

可参考以下示例输入相应内容：

名称：输入二层网络的名称
简介：可选项，可留空不填
交换机类型：支持Linux Bridge和OVS-DPDK两种交换机类型
网络类型：可选择以下网络类型：L2NoVlanNetwork、L2VlanNetwork
- L2NoVlanNetwork
  - 若不打算使用Vlan网络，则选择L2NoVlanNetwork。
  - NoVlanNetwork模式下，指定的网卡连接交换机网口必须是Access模式。
- L2VlanNetwork
  - 若需要ZStack Cube 旗舰版帮助配置VLAN网络，则需选择L2VlanNetwork。
  - VlanNetwork模式下，指定的网卡连接交换机网口必须是Trunk模式。
  - 输入Vlan ID，可输入1~4094之间的数字，需与交换机配置相同。
集群：显示二层网络加载的集群
网卡名称：选择或输入二层网络设备名称，例如：em01
Note: 仅支持选择或输入集群内所有物理机之间具体相同名称的网卡。

点击下一步按钮，完成二层网络创建。

创建三层网络

背景信息

三层网络：云主机使用的网络配置，包括IP地址范围、网关、DNS等。

如图 1所示：

可参考以下示例输入相应内容：

名称：输入三层网络的名称
简介：可选项，可留空不填
网络类型：Wizard仅支持创建扁平网络
网络段方法：添加网络段方法包括IP范围、CIDR
若选择IP范围，需填写以下参数：
- 起始IP：设置网络段的起始IP，例如：172.20.108.100
- 结束IP：设置网络段的结束IP，例如：172.20.108.200
- 子网掩码：设置网络段的子网掩码，例如：255.255.0.0
- 网关：设置网络段的网关，例如：172.20.0.1
- 添加DNS：可添加DNS服务器，用于设置三层网络的DNS解析服务，例如可指定223.5.5.5、8.8.8.8或114.114.114.114
若选择CIDR，需填写以下参数：
- CIDR：设置网络段的CIDR，例如：192.168.108.1/24
- 网关：可设置网关，例如：192.168.108.1
  Note:
  - 允许使用CIDR的第一个或最后一个IP地址作为网关。
  - 若留空不填，默认使用CIDR的第一个IP地址作为网关。
- 添加DNS：可添加DNS服务器，用于设置三层网络的DNS解析服务，例如可指定223.5.5.5、8.8.8.8或114.114.114.114

点击下一步按钮，完成三层网络创建。

后续操作

至此，手动初始化引导设置全部完成。