單機版
./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"
}
]
}
]
}
]
}
