安装部署

环境准备

准备软件工具

请准备以下软件包，以便安装部署过程顺利执行：

ZStack Cloud ISO（H76C，至少为专家模式）。
Note:
- ZStack ZStone 4.2.0之前的版本依赖ZStack Cloud管理节点组件，包括ZSHA2（双管理节点模式）和MySQL。
- ZStack Cloud ISO镜像可通过Rufus（推荐使用）/UltraISO工具将ISO文件刻录到U盘。关于如何使用Rufus刻录，可参考快速安装使用教程 (新手快速入门)镜像刻录U盘章节。
ZStack Cloud企业版工具包：请联系官方技术支持获取。
ZStack Cloud多管理节点高可用套件：请联系官方技术支持获取。
ZStack ZStone软件包：请联系官方技术支持获取。

检查硬件设备

默认部署场景下，服务器硬件配置需至少满足以下需求：

设备	配件	推荐配置
服务器	CPU	2*Intel® Xeon® Silver 4314 (16C 2.4GHz)
	内存	4*32GB DDR4，最大3200 MT/s
	系统盘	2*Intel S4510/S4520 480GB (RAID1)
	缓存盘	2*Intel S5610/S4620 960GB (JBOD)
	数据盘	2/4/8/12/16TB HDD (JBOD)
	网卡	41Gb+210Gb
	RAID卡	同时支持JBOD、RAID1
网络交换机	/	至少配备1个千兆交换机和1个万兆交换机

核对网络要求

管理网络：没有限制。
存储公有网络：建议使用万兆网卡，小规模部署可与存储集群网络复用，大规模部署（10节点以上）建议与存储集群网络分离配置。
存储集群网络：建议使用万兆网卡，需要配置LACP Bond。

安装ZStack ZStone

本章节主要介绍ZStack ZStone的安装部署模式。ZStack ZStone支持以下安装部署模式：

默认部署：在已经部署ZStack Cloud的环境中，推荐使用此模式部署。
超融合部署：部署ZStack Cube超融合环境时，默认提供ZStack ZStone分布式存储，无需单独安装部署。

默认部署

环境准备。
ZStack ZStone的管理服务依赖ZStack Cloud管理节点服务。因此需先部署ZStack Cloud管理节点，再部署ZStack ZStone管理节点服务。可参考以下步骤：
1. 部署两个ZStack Cloud管理节点并配置高可用。
  Note: 此处部署的双管理节点可作为ZStack ZStone管理节点，提供管理服务。
2. 部署一个ZStack Cloud计算节点或专家模式。
  Note: 此处部署的计算节点或专家模式可与部署的双管理节点作为ZStack ZStone存储服务器节点，提供存储服务。
在任一管理节点下载获取的ZStack ZStone软件安装包。

解压软件安装包。

# 查看获取的软件安装包
[root@localhost ~]# ls
ZStone-x86_64-installer-5.5.12.tar.gz
# 解压软件安装包
[root@localhost ~]# tar xf ZStone-x86_64-installer-5.5.12.tar.gz

解压后进入zstone-installer目录。
```
[root@localhost ~]# cd zstone-installer
```

打开install.conf文件，编辑安装配置文件。

[root@localhost zstone-installer]# vim install.conf
# 若仅部署一个管理节点，填写该管理节点 IP；双管理节点填写 VIP。
zstone_vip=
# ZStone 管理节点列表。双管理节点的 IP 地址使用英文逗号分隔。
zstone_managerment_host_ip=
# 管理节点的 SSH 端口，默认为 22。
zstone_managerment_host_port=22
# 管理节点 root 密码，格式：["password1","password2"]
zstone_managerment_host_rootpw=["password"]

# MySQL 信息
zstone_db=zstone
zstone_db_user=root
zstone_db_port=3306
zstone_db_password=zstack.mysql.password

# 是否执行自定义数据库安装。
# 设置为 false 时，使用默认云平台数据库。
zstone_master_db_customed_use=false
# 必填。指定数据库类型：mariadb 或 greatsql。
# 仅当 zstone_master_db_customed_use 设置为 true 时生效。
zstone_master_customed_db=mariadb

# keepalived 的 virtual_router_id，在同一网络中必须唯一，且所有主机必须保持一致。
# 取值范围：1-255
zstone_master_keepalived_virtual_router_id=230

# 必填。指定主机管理网络接口。
# 仅当 zstone_master_db_customed_use 设置为 true 时生效。
zstone_master_vrrp_interface=ens3

# 日志级别：trace、debug、info、warning、error、fatal、panic
log_level=info

# 告警使用的语言，默认为 zh_CN，可选值：en_US、zh_CN
default_language=zh_CN

# PostgreSQL 信息
zstone_temporal_db_port=5432

# ZStone 账户
zstone_account_name=admin
zstone_account_password=password

# Cloud VIP
zstone_identify_server_ip=

# 默认为 /zstack/v1，可按需修改。
zstone_identify_url_prefix=

# ZCF 许可证服务器信息
# zstone_license_server_type 可设置为 zs 或 ls。留空用于兼容升级；全新安装默认为 ls。
zstone_license_server_type=ls
# host 留空时默认为 zstone_vip；port 留空时默认为 18201。
zstone_license_server_host=
zstone_license_server_port=
# protocol 留空时根据 type 自动检测：ls 使用 https，zs 使用 http。
zstone_license_server_protocol=
# LS 配额类型：Auto、Host 或 Capacity。Auto 优先使用 Host，失败后回退到 Capacity。
# 为兼容升级，ZStone 将空值视为 Auto。
zstone_license_server_quota_type=
# LS 离线保护最大天数，取值范围为 0-15，默认为 7。
zstone_license_server_max_offline_days=7
# LS HTTPS CA 文件路径
zstone_license_server_ca_path=/opt/zstone/license/ls_ca.pem
# LS 内置证书 SAN
zstone_license_server_tls_server_name=license.server.zstack.org
# 全局站点访问密钥
zstone_license_server_site_access_key=zstack-license-site-global-access-key

# ZBS
# 若需安装高性能块存储，需设置为 true。
zbs_install=false

# ZBS ChunkServer 存储引擎：fs（文件系统，用于测试）或 block（裸块设备，生产环境推荐）。
chunkserver_backend=block

保存配置信息后，返回当前路径下，执行以下命令安装软件包。
```
[root@localhost zstone-installer]# ./install.sh
```
安装成功，即会返回ZStack ZStoneUI界面地址链接。

超融合部署

部署ZStack Cube超融合环境时，默认提供ZStack ZStone分布式存储，无需单独安装部署。

快速使用

集群初始化

首次登录ZStack ZStone，在Chrome 49及以上版本的浏览器中输入相应的URL地址http://management_node_ip:4000，输入默认账户名admin和默认初始密码password，系统界面将引导进行ZStack ZStone分布式存储平台基本的初始化环境配置。

Note:

若页面无法正常加载，请确认管理服务和UI服务均正常运行。
当前会话登录超过2小时，系统将进行超时提醒并强制退出，需要重新登录。

创建集群

在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:
- 第一次添加服务器时，默认选择管理、监控、块存储网关角色。其中，块存储网关角色允许取消选择，管理和监控角色不支持取消选择。
- 后续添加服务器时，支持添加无角色的存储服务器。
- 一般一个集群中至少部署三台同时作为管理、监控、块存储网关角色的存储服务器。

如图 2所示：

第 2 步：环境配置

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

如图 3所示：

第 3 步：网络配置

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

如图 4所示：

第 4 步：信息确认

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

如图 5所示：

第 5 步：安装部署

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

Note:

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

如图 6所示：

图 6. 安装部署

扫描硬盘

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

如图 7所示：

Note:

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

创建数据盘

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

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

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

如图 8所示：

创建存储池

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

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

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

创建存储池-块存储

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

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

如图 9所示：

创建存储池-对象存储

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

名称：设置存储池名称
存储池名称需符合以下命名规则：支持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:
  - 选择的数据盘需满足数据安全策略的故障域要求。
  - 建议尽量选择大小一致的数据盘。

如图 10所示：

术语表

文件存储 (File Storage)

提供文件存储服务，为文件数据提供存储和管理功能。

文件共享 (File Share)

文件共享是通过文件协议实现的文件目录共享，允许客户端通过挂载操作将目录映射到本地文件系统，实现文件共享和协作。

文件网关 (File Gateway)

文件网关组为用户提供SMB、NFS等文件存储访问协议。

文件用户 (File User)

文件用户是文件存储服务的使用者账户，包含文件协议访问时所需的用户名、密码等授权信息。

文件目录 (File Directory)

文件目录为用户提供文件系统内一级子目录的管理功能，如创建目录、删除目录、搜索目录等

文件系统 (File System)

文件系统是文件存储的核心资源，负责元数据信息存储、文件数据存储。

块存储 (Block Storage)

为重要业务提供高性能的块存储功能。

块存储卷 (Block Storage Volume)

展示存储池中提供的块存储设备，其数据一般按照副本数分布在多台服务器的多个数据盘中，具备精简置备、可伸缩等高级特性。

快照 (Snapshot)

快照为某一时间点某一块存储卷的数据状态文件，主要为存储系统提供数据备份和数据恢复的功能。

对象存储 (Objet Storage)

提供对象存储服务，为海量非结构化数据提供安全、高效的存储和管理功能。

存储策略 (Storage Policy)

存储策略是一组关于存储桶资源分配来源、数据存储形式等的规则。

对象网关 (Object Gateway)

支持高可用对象网关和 S3 网关。其中，S3网关为用户访问存储集群提供一个兼容 S3 协议的对象存储服务；高可用对象网关可为对象存储提供高可用服务和负载均衡功能。

对象用户 (Object User)

对象用户是对象存储服务使用者的账户，包含权限、密钥对、用户配额等信息。

存储桶 (Bucket)

存储桶是分配给对象用户使用的一个逻辑存储空间，用户的数据以对象形式存储在桶中。

存储资源 (Storage Resource)

可对外提供存储服务的逻辑单位，由一个存储集群组成。

存储池 (Storage Pool)

存储集群的逻辑分区，由多台存储服务器的多个数据盘组成，通常用于存储对象。

数据盘 (Data Disk)

物理或逻辑存储单元，每块数据盘对应一个OSD进程，多块数据盘可根据副本或EC机制组成存储池。

硬件资源 (Hardware)

服务器、硬盘、网络等组成存储集群的硬件设备合集。

服务器 (Server)

包括存储服务器和存储网关服务器两种类型。

硬盘 (Hard Disk)

数据盘的物理单位。所有类型为存储服务器的服务器，其硬盘都会被扫描，符合状态的空闲盘可以被添加为数据盘。

拓扑 (Topology)

拓扑是对集群物理资源实际部署方式的可视化展示。用户可基于该功能，设置存储池的数据冗余策略。

集群 (Cluster)

集群是一组服务器的逻辑集合。

监控管理 (Monitoring Management)

由操作日志、告警中心组成的存储平台监控系统，便于运维人员掌握平台运行情况，及时快速定位解决问题。

操作日志 (Operation Log)

平台运行过程中变化的一种抽样，内容为操作员触发的事件及其操作结果按时间排序的有序集合，便于排错和跟踪，方便全方面掌控平台运行情况。

告警中心 (Alarm Center)

告警中心支持对时序化数据和事件进行监控，展示当前平台全部报警消息，并按照报警级别实时推送报警消息至指定的通知对象，便于及时了解资源使用情况。

报警消息 (Alarm Message)

报警器触发时发送的即时提示消息，展示当前存储平台全部报警消息。

报警器 (Alarm)

用于监控并响应时序性数据和事件的状态变化。

通知对象 (Endpoint)

用户获取订阅主题信息的方式，包含系统和邮箱两种类型的通知对象。

系统设置 (System Setting)

系统设置包括邮箱服务器设置、主题设置和全局设置。

邮箱服务器 (Email Server)

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

主题设置 (Theme Setting)

用户可自定义设置分布式存储平台主题标识。

全局设置 (Global Setting)

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

上一篇技术白皮书