平台初始化

平台初始化是指将服务器、硬盘等加入集群并创建可用的存储池。首次访问ZStack ZStone，系统界面将引导进行ZStack ZStone的初始化环境配置。

如图 1所示：

创建集群

在ZStack ZStone引导页面，点击开始初始化，进入集群初始化界面。

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

名称：设置集群名称
命名规则：1~128个字符，支持小写字母(a-z)、数字(0-9)、英文句点(.)和连接符(-)，且连接符(-)不可放在名称开头或结尾。建议不要用数字开头。
Admin IP CIDR：填写管理网络CIDR，用于管理和配置存储集群
Public IP CIDR：填写存储集群公有网络CIDR，用于块存储网关与存储池之间的访问、监控角色之间的通信、数据盘与块存储网关之间的通信
Cluster IP CIDR：填写存储集群内部网络CIDR，用于存储集群各服务器之间进行数据盘监控及副本同步
Note: 小规模配置可与Public IP复用，大规模配置（10台服务器以上）建议与Public IP分离部署。
时间同步服务器IP地址：填写时间同步服务器IP地址
Note:
- 时间同步服务器用于保障存储集群中所有服务器的时间同步，避免因时间不同步影响存储集群健康状态。
- 建议时间同步服务器地址与管理网络在同一个CIDR。

如图 1所示：

添加服务器

在ZStack ZStone主菜单，点击硬件资源 > 服务器，进入服务器界面。点击添加服务器，弹出添加服务器界面。

添加通用存储服务器分为以下五步，您可参考以下示例输入相应内容，完成服务器配置。

第 1 步：基础配置

服务器IP地址：输入服务器的IP地址，可填写单个IP地址或IP范围。支持批量添加多台服务器
类型：选择服务器类型，支持以下两种服务器类型：
- 存储服务器：
  - 为存储池提供硬盘等资源。存储服务器上的硬盘可被作为数据盘使用。
  - 存储服务器类型的服务器支持管理、监控、块存储网关、对象存储网关四种角色。
- 存储网关服务器：
  - 承载各类接口客户端，仅支持对网关进行管理，不可以管理服务器中的硬盘。
  - 存储网关服务器类型的服务器仅支持块存储网关一种角色。
角色：设置服务器的角色，支持以下五种服务器角色：
- 管理：
  - 负责集群运行时状态的采集与管理，作为管理节点来提供分布式存储集群的管理功能，支持GUI、API等管理方式。
  - 为满足高可用要求，建议一般部署至少2个管理角色。
- 监控：
  - 负责集群存储数据的监控，维持集群整体状态，包括数据映射关系、集群认证等元数据信息。
  - 为满足高可用要求，建议部署数量为奇数（3+2*N，N≥0），一般可部署3个监控节点。
- 块存储网关：
  - 负责服务器与存储集群之间使用Block接口访问。
  - 存储服务器类型的服务器默认选择此角色。
  - 存储网关服务器类型的服务器默认且仅支持选择此角色。
- 对象存储网关：
  - 负责服务器与存储集群之间使用 Object 接口访问。
  - 若使用对象存储功能，需选择此角色。
  - 对象存储网关角色的服务器支持开启对象网关，提供S3协议和网关服务。
- 文件存储网关：
  - 若使用文件存储功能，需选择此角色。
  - 文件存储网关角色的服务器支持创建文件网关组，提供SMB、NFS等文件存储访问协议。
Note:
- 第一次添加服务器时，默认选择管理、监控、块存储网关角色。其中，块存储网关角色允许取消选择，管理和监控角色不支持取消选择。
- 后续添加服务器时，支持添加无角色的存储服务器。
- 一般一个集群中至少部署三台同时作为管理、监控、块存储网关角色的存储服务器。

如图 1所示：

第 2 步：环境配置

SSH用户名：输入服务器的SSH用户名，默认为root
SSH密码：输入服务器的SSH密码。该密码仅用于配置免密，不会保存
端口：输入服务器的端口号，默认端口为22
服务器名：可选项，设置服务器名称
命名规则：长度限制1~63个字符，输入内容只能包含英文小写字母、数字和以下2种特殊字符：“.”、“-”，且不支持以“-”开头或结尾。建议不要以数字开头。
Note:
- 若选择不设置服务器名，请提前在服务器/etc/hosts配置文件下配置服务器名称和IP地址的映射关系。服务器添加完成后，将直接使用/etc/hosts中配置的服务器名。
- 若选择设置服务器名，新的服务器名将写入服务器/etc/hosts配置文件，并覆盖原服务器名与IP地址的映射关系。
- 批量添加服务器时，若设置服务器名，系统将自动增加服务器IP末位数字（0-254）作为名称后缀，用于资源区分。
时间同步服务：选择是否开启时间同步服务
开启后，系统将通过时间同步服务器保证新添加服务器与集群中其他服务器的时间同步。
服务器免密：选择是否通过输入的SSH用户名和密码自动配置免密功能

如图 2所示：

第 3 步：网络配置

Admin IP：设置管理网络IP地址，用于对存储集群进行管理和配置，默认为服务器IP地址
Public IP：设置存储集群公有网络IP地址，用于块存储网关与存储池之间的访问
Cluster IP：设置存储集群内部网络IP地址，用于存储集群各服务器之间的数据盘监控及副本同步
Note: 添加存储网关服务器类型的服务器无需设置Cluster IP。

如图 3所示：

第 4 步：信息确认

查看将要添加的服务器，支持跳转修改相应信息。

如图 4所示：

第 5 步：安装部署

查看服务器安装部署进度。安装过程中如退出该页面，服务器安装部署将继续进行，可通过操作日志再次查看安装进程。

Note:

首次添加服务器不支持退出该页面。
首次添加服务器建议不要刷新浏览器。

如图 5所示：

图 5. 安装部署

扫描硬盘

在ZStack ZStone主菜单，点击硬件资源 > 硬盘，进入硬盘界面。点击扫描，即可列出服务器中的硬盘及硬盘信息。

如图 1所示：

Note:

健康状态的空闲盘可进行缓存分区（建议SSD）或添加为数据盘。若进行缓存分区，需确保单个分区容量至少为50 GB。
若扫描出未知盘，表示该硬盘上存在未知分区。
- 针对ZStack ZStone 4.2.0及之前的版本，可执行wipefs -af /dev/sdX命令，手动清理分区后再次扫描硬盘。
- 针对ZStack ZStone 4.2.0及之后的版本，可在硬盘页面，点击初始化硬盘，直接进行分区清理。
部分硬件环境中，新添加的硬盘可能无法识别，请重启服务器或联系官方技术支持。

创建数据盘

在ZStack ZStone主菜单，点击存储资源 > 数据盘，进入数据盘界面。点击创建数据盘，弹出创建数据盘界面。

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

选择硬盘：选择需要添加为数据盘的硬盘
Note: 仅支持将健康状态且用途为空闲盘的硬盘添加为数据盘。单个硬盘的容量不能少于25 GB。
缓存分区：选择数据盘是否使用缓存分区
- 自动模式：系统自动为已选择的硬盘批量匹配服务器上的缓存分区。
- 手动模式：用户可手动为已选择的每一块硬盘单独选择需要绑定的缓存分区。
Note: 可用缓存分区数量小于已选硬盘数时，超出数量的硬盘将无法添加为数据盘。

如图 1所示：

创建存储池

在ZStack ZStone主菜单，点击存储资源 > 存储池，进入存储池界面。点击创建存储池，弹出创建存储池界面。

支持创建以下三种类型存储池：

块存储存储池
对象存储存储池
文件存储存储池

创建存储池-块存储

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

名称：设置存储池名称
存储池名称需符合以下命名规则：支持1~128字符，输入内容只能包含中文汉字、英文字母、数字和以下7种英文字符“-”、“_”、“.”、“(”、“)”、“:”、“+”。
类型：选择块存储
角色：默认显示数据池角色，且不支持修改
数据安全策略：
- 类型：默认显示副本类型，且不支持修改
- 副本数：设置存储池的副本数，支持选择的副本数范围：2~6
  Note: 生产环境中建议至少设置为3副本以确保数据安全。
- 级别：可按照拓扑中的规划，选择服务器、机架、机房级别的故障域。
- 数据盘：根据拓扑视图选择需要添加的数据盘
  Note:
  - 选择的数据盘需满足数据冗余级别要求。
  - 建议尽量选择大小一致的数据盘。

如图 1所示：

创建存储池-对象存储

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

名称：设置存储池名称
存储池名称需符合以下命名规则：支持1~128字符，输入内容只能包含中文汉字、英文字母、数字和以下7种英文字符“-”、“_”、“.”、“(”、“)”、“:”、“+”。
类型：选择对象存储
角色：选择存储池的角色，包括数据池、索引池、复合池
Note:
1. 数据池：用于存储数据。
2. 索引池：用于存储对象的索引信息。
3. 复合池：支持多用途复用，可被存储策略中的索引池、数据中转池选用。
数据安全策略：
- 类型：选择数据冗余类型，包括副本、EC
  - 若选择副本，可参考以下示例填写相应内容：
    - 副本数：设置存储池的副本数，支持选择的副本数范围：2~6
    Note:
    - 索引池和复合池角色的存储池仅支持副本类型的数据冗余策略。
    - 生产环境中建议至少设置为3副本以确保数据安全。
  - 若选择EC，可参考以下示例填写相应内容：
    - EC策略：设置存储的EC策略，包括推荐值、自定义
      - 推荐值：选择系统推荐的六种EC策略，包括2+1、4+2、8+3、4+2:1、8+2:1、16+2:1
      - 自定义：支持自定义EC策略，输入数据块+校验块
        Note: 需输入正整数，数据块数量需大于校验块数量，校验块数量需小于等于4。
      Note:
      
      EC策略由数据块和校验块构成，其中数据块指数据分片的数量，校验块指通过校验算法生成的校验分片的数量，以服务器级别的4+2的EC策略为例，其表示允许当2台服务器发生故障时，数据仍可正常使用。
      
      支持实时展示得盘率，计算方法：数据块/（数据块+校验块）。
- 级别：可按照拓扑中的规划，选择服务器、机架、机房级别的故障域。
- 数据盘：根据拓扑视图选择需要添加的数据盘
  Note:
  - 选择的数据盘需满足数据安全策略的故障域要求。
  - 建议尽量选择大小一致的数据盘。

如图 2所示：