单机版
./stor setup { -n | --stor-name } STOR_NAME [ { -u | --user-name } USER_NAME ] { -p | --password } PASSWORD { -s | --server } { SERVER_IP[:PORT]:PATH &<1-n> } [ { -P | --public-network } CIDR ] [ --iscsi-port ISCSI_PORT ] [--port-range PORT1-PORT2 ] [ --management-port1 MANAGEMENT_PORT1 ] [ --management-port2 MANAGEMENT_PORT2 ] [ --management-port3 MANAGEMENT_PORT3 ] [ --management-port4 MANAGEMENT_PORT4 ] [ --management-port6 MANAGEMENT_PORT6 ]
集群版
./stor setup { -n | --stor-name } STOR_NAME [ { -u | --user-name } USER_NAME ] { -p | --password } PASSWORD { { -s | --server } { SERVER_IP[:PORT][:PATH] &<1-n> } &<1-n> | --topology-file TOPOLOGY_FILE } [ {-C | --cluster-network } CIDR ] [ { -P | --public-network } CIDR ] [ --fault-domain FAULT_DOMAIN ] [ --iscsi-port ISCSI_PORT ] [--port-range PORT1-PORT2 ] [ --data-port1 DATA_PORT1 ] [ --management-port1 MANAGEMENT_PORT1 ] [ --management-port2 MANAGEMENT_PORT2 ] [ --management-port3 MANAGEMENT_PORT3 ] [ --management-port4 MANAGEMENT_PORT4 ] [ --management-port5 MANAGEMENT_PORT5 ] [ --management-port6 MANAGEMENT_PORT6 ] [ --metadata-port1 METADATA_PORT1 ] [ --metadata-port2 METADATA_PORT2 ] [ --metadata-port3 METADATA_PORT3 ] [ --metadata-port4 METADATA_PORT4 ] [ --metadata-port5 METADATA_PORT5 ] [ --metadata-port6 METADATA_PORT6 ] [ --metadata-port7 METADATA_PORT7 ] [ --metadata-port8 METADATA_PORT8 ] [ --cs SERVER_IP[:DIR],SERVER_IP[:DIR],SERVER_IP[:DIR] ] [ --mdm SERVER_IP[:DIR],SERVER_IP [:DIR] ] [ --ls SERVER_IP[:DIR],SERVER_IP[:DIR],SERVER_IP[:DIR] ]
此命令用来初始化HBlock。
说明
对于集群版，在每台服务器上安装HBlock后，可以在集群内的任一服务器上进行初始化。
注意
- 请确保Linux用户具有所需要端口的权限。Linux系统默认小于1024的端口不对没有root权限的Linux普通用户开放。
- 设置端口范围（--port-range PORT1-PORT2）时，请避免和Linux系统的本地临时端口（ip_local_port_range）范围重合，否则可能会导致HBlock服务所用的端口被占用。使用命令行cat /proc/sys/net/ipv4/ip_local_port_range可以查看本地临时端口范围。
参数
| 参数 | 描述 |
|---|---|
| -n STOR_NAME或--stor-name STOR_NAME | 指定HBlock名称。 取值：字符串形式，长度范围是1~64，可以包含字母、数字、下划线（_）和短横线（-），字母区分大小写，且仅支持以字母或数字开头。 |
| -u USER_NAME 或--user-name USER_NAME | HBlock的管理员用户名。 取值：字符串形式，长度范围是5~16，只能由数字和字母组成，字母区分大小。默认值为storuser。 |
| -p PASSWORD或--password PASSWORD | 设置新的管理员密码。初始化时必须修改密码。 取值：字符串形式，长度范围8~16，至少包含以下字符中的3种：大写字母、小写字母、数字、特殊字符 (~ ! @ # $ % ^ & * ( ) _ + [ ] { } | ; : , . / < > ?)，区分大小写。不能包含：3个连续重复的字符，3个连续或反序的数字、或字母（不区分大小写），3个连续或反序的键盘序列（不区分大小写）。 |
| -s { SERVER_IP[:PORT][:PATH] &<1-n> } &<1-n>或--server { SERVER_IP[:PORT][:PATH] &<1-n> } &<1-n> | 指定要初始化的服务器IP（SERVER_IP）、API端口号（PORT）和数据目录（PATH）。 取值：
说明 对于单机版，第一个数据目录是默认数据目录。对于集群版，需要至少有一个数据目录。 |
| --topology-file TOPOLOGY_FILE | 导入集群拓扑文件（仅集群版支持）。 拓扑文件为符合UTF-8编码格式的JSON文件，详见集群拓扑文件。 |
| -C CIDR或--cluster-network CIDR | 集群网络（仅集群版支持），用于集群间的数据通信。IP CIDR格式。
|
| -P CIDR或--public-network CIDR | 业务网络，用于客户端和服务器之间的数据传输。IP CIDR格式。
|
| --fault-domain FAULT_DOMAIN | 设置基础存储池的故障域级别（仅集群版支持）。初始化时设置的集群拓扑中，包含的数据目录节点都加入到基础存储池中。 取值：
默认值为server。 注意 如果故障域级别为room或者rack，则必须使用拓扑文件导入方式进行初始化 |
| --iscsi-port ISCSI_PORT | 指定iSCSI端口号。 取值：整型，取值为[1, 65535]，默认端口为3260。 |
| --port-range PORT1-PORT2 | 指定端口范围。存储服务以及未指定端口的服务将从此范围中自动取值。 取值：整型，取值范围为[1, 65535]，PORT1为端口范围最小值，PORT2为端口范围最大值，且PORT1且PORT1 < PORT2。PORT1默认取值为20000，PORT2默认取值为20500。 说明 建议指定的端口范围至少包含500个端口。 |
| --data-port1 DATA_PORT1 | 指定数据端口1（仅集群版支持）。 取值：整型，取值范围为[1, 65535]。 |
| --management-port1 MANAGEMENT_PORT1 | 指定管理服务端口1。 取值：整型，取值范围为[1, 65535]。 |
| --management-port2 MANAGEMENT_PORT2 | 指定管理服务端口2。 取值：整型，取值范围为[1, 65535]。 |
| --management-port3 MANAGEMENT_PORT3 | 指定管理服务端口3。 取值：整型，取值范围为[1, 65535]。 |
| --management-port4 MANAGEMENT_PORT4 | 指定管理服务端口4。 取值：整型，取值范围为[1, 65535]。 |
| --management-port5 MANAGEMENT_PORT5 | 指定管理服务端口5（仅集群版支持）。 取值：整型，取值范围为[1, 65535]。 |
| --management-port6 MANAGEMENT_PORT6 | 指定管理服务端口6。 取值：整型，取值范围为[1, 65535]。 |
| --metadata-port1 METADATA_PORT1 | 指定元数据端口1（仅集群版支持）。 取值：整型，取值范围为[1, 65535]。 |
| --metadata-port2 METADATA_PORT2 | 指定元数据端口2（仅集群版支持）。 取值：整型，取值范围为[1, 65535]。 |
| --metadata-port3 METADATA_PORT3 | 指定元数据端口3（仅集群版支持）。 取值：整型，取值范围为[1, 65535]。 |
| --metadata-port4 METADATA_PORT4 | 指定元数据端口4（仅集群版支持）。 取值：整型，取值范围为[1, 65535]。 |
| --metadata-port5 METADATA_PORT5 | 指定元数据端口5（仅集群版支持）。 取值：整型，取值范围为[1, 65535]。 |
| --metadata-port6 METADATA_PORT6 | 指定元数据端口6（仅集群版支持）。 取值：整型，取值范围为[1, 65535]。 |
| --metadata-port7 METADATA_PORT7 | 指定元数据端口7（仅集群版支持）。 取值：整型，取值范围为[1, 65535]。 |
| --metadata-port8 METADATA_PORT8 | 指定元数据端口8（仅集群版支持）。 取值：整型，取值范围为[1, 65535]。 |
| --cs SERVER_IP[:DIR],SERVER_IP[:DIR],SERVER_IP[:DIR] | 指定协调服务的地址和存储协调服务数据的数据目录（仅集群版支持）。 如果指定协调服务的地址，必须同时指定集群中的3个IP地址。 说明 为了提升读写性能，建议协调服务的数据目录与安装目录、存储数据的数据目录相互独立。 取值：
|
| --mdm SERVER_IP[:DIR],SERVER_IP[:DIR] | 指定元数据管理服务的地址和存储元数据管理服务数据的数据目录（仅集群版支持）。 如果指定元数据管理服务的地址，必须同时指定集群中的2个IP地址。 说明 为了提升读写性能，建议元数据服务的数据目录与安装目录、存储数据的数据目录相互独立。 取值：
|
| --ls SERVER_IP[:DIR],SERVER_IP[:DIR],SERVER_IP[:DIR] | 指定日志服务的地址和存储日志服务数据的数据目录（仅集群版支持）。 如果指定日志服务的地址，必须同时指定集群中的3个IP地址。 说明 为了提升读写性能，建议日志服务的数据目录与安装目录、存储数据的数据目录相互独立。 取值：
|
示例
示例1
初始化HBlock（单机版）。
[root@hblockserver CTYUN_HBlock_Plus_3.8.0_x64]# ./stor setup -n test -s 192.168.0.69:/mnt/storage01,/mnt/storage02
Please enter password:
**********
Start to setup HBlock, please wait.
Processing...
Setup successfully and the HBlock services have been started.
Welcome to HBlock!
You are using a 30-day trial version. Please follow the steps to get a license.
1. Run "stor info --serial-id" to get the serial ID of the HBlock
2. Contact the software vendor to obtain a license
3. Run "stor license add -k KEY" to import the license
Type 'stor --help' to get more information, such as managing LUNs, targets, servers, etc.示例2
初始化HBlock（集群版）：集群拓扑使用服务器方式。
[root@hblockserver CTYUN_HBlock_Plus_3.8.0_x64]# ./stor setup -n test -s 192.168.0.209:/mnt/storage01,/mnt/storage02 192.168.0.121:/mnt/storage01 192.168.0.72:/mnt/storage01
Please enter password:
**********
Start to setup HBlock, please wait.
Processing...
Setup successfully and the HBlock services have been started.
Welcome to HBlock!
You are using a 30-day trial version. Please follow the steps to get a license.
1. Run "stor info --serial-id" to get the serial ID of the HBlock
2. Contact the software vendor to obtain a license
3. Run "stor license add -k KEY" to import the license
Type 'stor --help' to get more information, such as managing LUNs, targets, servers, etc.示例3
初始化HBlock（集群版）：集群拓扑使用拓扑文件导入方式。
[root@hblockserver CTYUN_HBlock_Plus_3.7.0_x64]# ./stor setup -n stor -p ********** --topology-file /mnt/storage01/topology.txt --fault-domain path
Start to setup HBlock, please wait.
Processing...
Setup successfully and the HBlock services have been started.
Welcome to HBlock!
You are using a 30-day trial version. Please follow the steps to get a license.
1. Run "stor info --serial-id" to get the serial ID of the HBlock
2. Contact the software vendor to obtain a license
3. Run "stor license add -k KEY" to import the license
Type 'stor --help' to get more information, such as managing LUNs, targets, servers, etc.拓扑文件源码如下：
{
"name": "default",
"childNodes": [
{
"name": "room1",
"type": "room",
"childNodes": [
{
"type": "server",
"name": "server1",
"ip": "192.168.0.192",
"apiPort": 1443,
"childNodes": [
{
"name": "/mnt/stor",
"type": "path"
},
{
"name": "/mnt/storage01",
"type": "path"
}
]
},
{
"type": "server",
"name": "server2",
"ip": "192.168.0.110",
"apiPort": 1443,
"childNodes": [
{
"name": "/mnt/stor",
"type": "path"
}
]
},
{
"type": "server",
"name": "server3",
"ip": "192.168.0.102",
"apiPort": 1443,
"childNodes": [
{
"name": "/mnt/stor",
"type": "path"
}
]
}
]
}
]
}
