初始化 请求参数 参数 类型 描述 是否必须 storName String HBlock名称。 取值:长度范围是1~64,可以包含字母、数字、下划线()和短横线(),字母区分大小写,且仅支持以字母或数字开头。 是 userName String HBlock的管理员用户名。 取值:长度范围是5~16,只能由数字和字母组成,字母区分大小。默认值为storuser。 否 newPassword String 设置的新密码。初始化时必须修改密码。 取值:长度范围8~16,至少包含以下字符中的3种:大写字母、小写字母、数字、特殊字符 (~ ! @ $ % ^ & ( ) + [ ] { } ; : , . / ?),区分大小写。不能包含:3个连续重复的字符,3个连续或反序的数字、或字母(不区分大小写),3个连续或反序的键盘序列(不区分大小写)。 是 edition String 指定版本类型。 取值: Free:免费版。 Commercial:商业版。 默认值为Commercial。 否 iSCSIPort Integer iSCSI端口。 取值:[1, 65535],默认值为3260。 否 portRange String 指定端口范围。存储服务以及未指定端口的服务将从此范围中自动取值。 取值:[1, 65535],port1为端口范围最小值,port2为端口范围最大值,且port1 < port2 。port1 默认取值为20000,port2默认取值为20500。 说明 建议指定的端口范围至少包含500个端口。 否 faultDomain String 设置基础存储池的故障域级别(仅集群版支持)。初始化时设置的集群拓扑中,包含的数据目录节点都加入到基础存储池中。 取值: room:机房级别。 rack:机架级别。 path:数据目录级别。 server:服务器级别。 默认值为server。 注意 如果故障域级别为room或者rack,则必须使用拓扑文件导入方式进行初始化。 否 ports.dataPort1 Integer 数据端口1(仅集群版支持)。 取值:[1, 65535]。 否 ports.managementPort1 Integer 管理服务端口1。 取值:[1, 65535]。 否 ports.managementPort2 Integer 管理服务端口2。 取值:[1, 65535]。 否 ports.managementPort3 Integer 管理服务端口3。 取值:[1, 65535]。 否 ports.managementPort4 Integer 管理服务端口4。 取值:[1, 65535]。 否 ports.managementPort5 Integer 管理服务端口5(仅集群版支持)。 取值:[1, 65535]。 否 ports.managementPort6 Integer 管理服务端口6。 取值:[1, 65535]。 否 ports.metadataPort1 Integer 元数据端口1(仅集群版支持)。 取值:[1, 65535]。 否 ports.metadataPort2 Integer 元数据端口2(仅集群版支持)。 取值:[1, 65535]。 否 ports.metadataPort3 Integer 元数据端口3(仅集群版支持)。 取值:[1, 65535]。 否 ports.metadataPort4 Integer 元数据端口4(仅集群版支持)。 取值:[1, 65535]。 否 ports.metadataPort5 Integer 元数据端口5(仅集群版支持)。 取值:[1, 65535]。 否 ports.metadataPort6 Integer 元数据端口6(仅集群版支持)。 取值:[1, 65535]。 否 ports.metadataPort7 Integer 元数据端口7(仅集群版支持)。 取值:[1, 65535]。 否 ports.metadataPort8 Integer 元数据端口8(仅集群版支持)。 取值:[1, 65535]。 否 topology String 导入集群拓扑文件内容(仅集群版支持)。 取值:拓扑文件需要采用UTF8编码,且为JSON文件格式,然后转换成字符串格式复制给该参数。拓扑文件的构成详见集群拓扑文件。 注意 “topology”与“servers”必须选一种,且只能选一种。如果故障域级别为room或者rack,则必须使用拓扑文件导入方式进行初始化。 否 servers Array of server HBlock服务器的属性集合,详见“表1 请求参数server说明(仅集群版支持)”。 注意 “topology”与“servers”必须选一种,且只能选一种。如果故障域级别为room或者rack,则必须使用拓扑文件导入方式进行初始化。 否 services Array of server 服务地址的集合(仅集群版支持),详见“表3 请求参数service说明(仅集群版支持)”。 否 clusterNetwork String 集群网络(仅集群版支持),用于集群间的数据通信。 如果指定集群网络,为了保证HBlock的各个服务器之间能够正常通信,请确保每个服务器上都有与指定网段相符的IP,系统会自动选取该IP进行通信。 如果未指定集群网络,默认使用服务器列表中HBlock服务器IP,此时HBlock的服务器IP不能指定为localhost、127.0.0.1或0:0:0:0:0:0:0:1。 取值:如果指定地址范围,IP地址后加掩码表示,如192.163.1.5/24。 否 publicNetwork String 业务网络,用于客户端和HBlock之间的数据传输式。 如果指定业务网络,请确保每个服务器上都有与指定网段相符的IP,系统会自动选取该IP和客户端进行通信。 如果未指定业务网络,或指定了业务网络,但指定的网段与服务器所有IP均不相符,默认使用服务器列表中HBlock服务器IP,此时HBlock服务器IP不能指定为localhost、127.0.0.1或0:0:0:0:0:0:0:1。 取值:如果指定地址范围,IP地址后加掩码表示,如192.163.1.5/24列表。 否 表1 请求参数servers说明 参数 类型 描述 是否必须 nodeName String 拓扑节点名称。 取值:字符串形式,长度范围1~63,只能由字母、数字、句点(.)、下划线()和短横线()组成,字母区分大小写,且仅支持以字母或数字开头。 否 ip String HBlock的服务器IP。 取值:IPv4或[IPv6]地址。 是 apiPort Integer 管理API端口。 取值:[1, 65535],默认值为1443。需要和该服务器安装HBlock时设置的API端口号保持一致。 否 diskPaths Array of server 数据目录属性集合,详见“表2 请求参数diskPaths说明”。 否 表2 请求参数diskPath说明 参数 类型 描述 是否必须 path String 指定数据目录。数据目录用于存储数据,建议不要与操作系统共用磁盘或文件系统。 取值:只能包含字母、数字、汉字和特殊字符(~ ! @ $ ( ) + ; . :)。 说明 对于单机版,第一个数据目录为默认数据目录。对于集群版,需要至少有一个数据目录。 注意 如果故障域是server和path级别,此项必填。 否 capacityQuota Long 指定数据目录的容量配额,即针对加入到服务器中的每个数据目录,HBlock可写入的数据总量。当HBlock的使用空间一旦达到配额,就立刻阻止数据写入,不允许再使用超出配额的空间。 取值:小于数据目录所在磁盘的总容量,单位是bytes。负整数表示无限制写入,0表示禁止写入。默认不限制写入。 注意 如果相同的数据目录出现多次,以第一次出现的数据目录的容量配额为准。 否 表3 请求参数services说明(仅集群版支持) 参数 类型 描述 是否必须 mdm Array of mdm 元数据管理服务(仅集群版支持),详见“表4 请求参数mdm说明(仅集群版支持)”。 否 ls Array of ls 日志服务(仅集群版支持),详见“表5 请求参数ls说明(仅集群版支持)”。 否 cs Array of cs 协调服务(仅集群版支持),详见“表6 请求参数cs说明(仅集群版支持)”。 否 表4 请求参数mdm说明(仅集群版支持) 参数 类型 描述 是否必须 ip String 元数据管理服务的地址(仅集群版支持)。 如果指定元数据管理服务的地址,必须同时指定集群中的2个IP地址。 取值:IPv4或[IPv6]地址。 否 metaDir String 元数据服务的数据目录(仅集群版支持),用于存储元数据服务的相关数据信息。 说明 为了提升读写性能,建议元数据服务的数据目录与安装目录、存储数据的数据目录分开。 取值:只能包含字母、数字、汉字和特殊字符(~ ! @ $ ( ) + ; . :)。默认目录为安装目录。 否 表5 请求参数ls说明(仅集群版支持) 参数 类型 描述 是否必须 ip String 日志服务的地址(仅集群版支持)。 如果指定日志服务的地址,必须同时指定集群中的3个IP地址。 取值:IPv4或[IPv6]地址。 否 metaDir String 日志服务的数据目录(仅集群版支持),用于存储日志服务的相关数据信息。 说明 为了提升读写性能,建议日志服务的数据目录与安装目录、存储数据的数据目录分开。 取值:只能包含字母、数字、汉字和特殊字符(~ ! @ $ ( ) + ; . :)。默认目录为安装目录。 否 表6 请求参数cs说明(仅集群版支持) 参数 类型 描述 是否必须 ip String 协调服务的地址(仅集群版支持)。 如果指定协调服务的地址,必须同时指定集群中的3个IP地址。 取值:IPv4或[IPv6]地址。 否 metaDir String 协调服务的数据目录(仅集群版支持),用于存储协调服务的相关数据信息。 说明 为了提升读写性能,建议协调服务的数据目录与安装目录、存储数据的数据目录分开。 取值:只能包含字母、数字、汉字和特殊字符(~ ! @ $ ( ) + ; . :)。默认目录为安装目录。 否