添加服务器(集群版适用) 本节主要介绍如何使用API添加服务器(集群版适用)。 此操作用来向集群中添加新的服务器。 请先在待添加的服务器上执行下列步骤: 1. 拷贝安装包至安装路径。 2. 解压安装包。 3. 执行 ./stor install命令安装。 然后在集群中的任意一台服务器上,执行添加服务器的操作。 注意 请确保Linux用户具有所需要端口的权限。Linux系统默认小于1024的端口不对没有root权限的Linux普通用户开放。 设置端口范围(portRange)时,请避免和Linux系统的本地临时端口(iplocalportrange)范围重合,否则可能会导致HBlock服务所用的端口被占用。使用命令行cat /proc/sys/net/ipv4/iplocalportrange可以查看本地临时端口范围。 请求语法 plaintext POST /rest/v1/system/server HTTP/1.1 Date: date ContentType: application/json; charsetutf8 ContentLength: length Host: ip:port Authorization: authorization { "nodeName": nodeName, "parentName": nodeName, "description": description, "ip": ip, "apiPort": apiPort, "iSCSIPort": iSCSIPort, "portRange": port1port2, "diskPaths": [ { "path":path, "capacityQuota": capacityvalue }, { "path":path, "capacityQuota": capacityvalue }, …… ], "ports": { "dataPort1": dataPort1, "managementPort1": managementPort1, "managementPort2": managementPort2, "managementPort3": managementPort3, "managementPort4": managementPort4, "managementPort5": managementPort5, "managementPort6": managementPort6 } } 请求参数 参数 类型 描述 是否必须 nodeName String 节点名称。 取值:字符串形式,长度范围1~63,只能由字母、数字、句点(.)、下划线()和短横线()组成,字母区分大小写,且仅支持以字母或数字开头。 默认使用服务器ID作为节点名称。 否 parentName String 父节点名称。 默认映射给根节点。 否 description String 服务器的描述信息。 取值:1~50位字符串。 否 ip String 要添加的服务器IP。 是 apiPort Integer 管理API端口。 取值:[1, 65535],默认值为1443。 否 iSCSIPort Integer iSCSI端口。 取值:[1, 65535],默认值为3260。 否 portRange String 指定端口范围。存储服务以及未指定端口的服务将从此范围中自动取值。 取值:[1, 65535],port1为端口范围最小值,port2为端口范围最大值,且port1 < port2。 port1默认取值为20000,port2默认取值为20500。 说明 建议指定的端口范围至少包含500个端口。 否 diskPaths Array of diskPath 数据目录属性集合。包括path、capacityQuota,详见“表1 请求参数diskPath说明”。 否 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]。 否 表1 请求参数diskPath说明 参数 类型 描述 是否必须 path Sring 指定数据目录。数据目录用于存储数据,建议不要与操作系统共用磁盘或文件系统。 取值:只能包含字母、数字、汉字和特殊字符(~ ! @ $ ( ) + ; . :)。 否 capacityQuota Long 指定数据目录的容量配额,即针对加入到服务器中的每个数据目录,HBlock可写入的数据总量。当HBlock的使用空间一旦达到配额,就立刻阻止数据写入,不允许再使用超出配额的空间。 取值:小于数据目录所在磁盘的总容量,单位是bytes。负整数表示无限制写入,0表示禁止写入。 默认不限制写入。 注意 如果相同的数据目录出现多次,以第一次出现的数据目录的容量配额为准。 否