./stor server ls [ { -n | --server } SERVER_ID ] [ --port ]

此命令用来查询HBlock服务器的相关信息。

参数

参数
描述
-n SERVER_ID 或 --server SERVER_ID
指定HBlock服务器的ID。
--port
指定查询服务器中HBlock使用的端口号。

示例

示例1

单机版：查询HBlock服务器的信息。

[root@hblockserver CTYUN_HBlock_Plus_3.7.0_x64]# ./stor server ls 
+-----+-----------+------------------+-----------+-------------------+-----------------+---------------------+
| No. | Server ID | Server Name      | Status    | Public Address    | Cluster Address | Recent Start Time   |
+-----+-----------+------------------+-----------+-------------------+-----------------+---------------------+
| 1.  | hblock_1  | hblockserver     | Connected | 192.168.0.32:3260 | 192.168.0.32    | 2023-12-18 18:00:05 |
+-----+-----------+------------------+-----------+-------------------+-----------------+---------------------+

集群版：查询HBlock服务器的信息。

[root@hblockserver CTYUN_HBlock_Plus_3.7.0_x64]# ./stor server ls 
+-----+--------------+------------------+-----------+--------------------+-----------------+---------------------+
| No. | Server ID    | Server Name      | Status    | Public Address     | Cluster Address | Recent Start Time   |
+-----+--------------+------------------+-----------+--------------------+-----------------+---------------------+
| 1.  | hblock_1(M)  | hblockserver     | Connected | 192.168.0.110:3260 | 192.168.0.110   | 2023-12-12 15:02:26 |
| 2.  | hblock_2(**) | pm-006           | Connected | 192.168.0.192:3260 | 192.168.0.192   | 2023-12-15 16:14:54 |
| 3.  | hblock_3(**) | ecs-9689-0915140 | Connected | 192.168.0.102:3260 | 192.168.0.102   | 2023-12-12 15:03:24 |
+-----+--------------+------------------+-----------+--------------------+-----------------+---------------------+

HBlock服务器信息描述
参数
描述
No.
No.
Server ID
服务器ID。
Server Name
服务器名称。
M：表示主服务器。
**：表示是基础节点。
只显示服务器名称，表示为非基础节点。
Status
服务器状态：
Connected：已连接。
Disconnected：未连接。
Removing：移除中。
Public Address
业务网的IP和端口号。
Cluster Address
集群网的IP和端口号。
Recent Start Time
HBlock服务在该节点上最近一次成功启动的时间。
-：表示HBlock服务处于停止状态。

示例2

单机版：查询服务器ID为hblock_1的服务器信息。

[root@hblockserver CTYUN_HBlock_Plus_3.7.0_x64]# ./stor server ls -n hblock_1
Server Name: hblockserver
Status: Connected
Public Address: 192.168.0.32:3260
Cluster Address: 192.168.0.32
Recent Start Time: 2023-12-18 18:00:05
Version: 3.7.0
Disk Path(s):
+-----+-------------------+---------------+----------------+---------------------+----------------+---------------+---------------+
| No. | Path              | Used Capacity | Total Capacity | Used Capacity Quota | Capacity Quota | Health Status | Health Detail |
+-----+-------------------+---------------+----------------+---------------------+----------------+---------------+---------------+
| 1.  | /mnt/storage01(*) | 214.18 MiB    | 93.29 GiB      | 92 KiB              | Unlimited      | Healthy       |               |
+-----+-------------------+---------------+----------------+---------------------+----------------+---------------+---------------+

集群版：查询服务器ID为hblock_1的服务器信息。

[root@hblockserver CTYUN_HBlock_Plus_3.7.0_x64]# ./stor server ls -n hblock_1
Server Name: pm-006
Server ID: hblock_1
Node Name: default:room2:rack2:hblock_1
Parent Node: default:room2:rack2
Status: Connected
Master Server: true
Base Server: true
Base Service: mdm(Up),ls(Up),cs(Up)
Public Address: 192.168.0.192:3260
Cluster Address: 192.168.0.192
Recent Start Time: 2024-06-19 13:46:11
Version: 3.7.0
Disk Path(s):
+-----+-----------+--------------+---------------+----------------+---------------------+----------------+---------------+---------------+
| No. | Path      | Storage Pool | Used Capacity | Total Capacity | Used Capacity Quota | Capacity Quota | Health Status | Health Detail |
+-----+-----------+--------------+---------------+----------------+---------------------+----------------+---------------+---------------+
| 1.  | /mnt/stor | default      | 10.33 GiB     | 93.29 GiB      | 972.59 MiB          | Unlimited      | Healthy       | -             |
+-----+-----------+--------------+---------------+----------------+---------------------+----------------+---------------+---------------+

查询指定服务器信息描述
参数
描述
Server Name
服务器名称。
Server ID
服务器ID。
Node Name
节点名称。
Parent Node
父节点名称。
Description
服务器描述信息，如果没有描述信息，不显示。
Status
服务器状态：
Connected：已连接。
Disconnected：未连接。
Removing：移除中。
Master Server
该服务器是否为Master节点（仅集群版支持）：
true：该服务器为Master节点。
false：该服务器不是Master节点。
Base Server
该服务器是否为基础节点（仅集群版支持）：
true：该服务器为基础节点。
false：该服务器不是基础节点。
Base Service
服务器上的基础服务。
Public Address
业务网的IP和端口号。
Cluster Address
集群网的IP。
Target portal IP and Port
目标门户和目标端口。
Recent Start Time
HBlock服务在该节点上最近一次成功启动的时间。
-：表示HBlock服务处于停止状态。
Version
HBlock版本号。
Disk Path(s)
数据目录信息：
 No.：编号。
Path：数据目录。单机版中，如果数据目录后有(*)，表示为HBlock服务器的默认数据目录。
Storage Pool：数据目录所属资源池。
Used Capacity：HBlock数据目录对应分区的已用容量。
Total Capacity：HBlock数据目录对应分区的总容量。
Used Capacity Quota：数据目录已用容量配额。
Capacity Quota：数据目录容量配额，当HBlock的使用空间一旦达到配额，就立刻阻止数据写入，不允许再使用超出配额的空间。
Health Status：数据目录的健康状态：
Healthy：数据目录处于健康状态，可正常读写，且数据目录所在磁盘使用率未超过90%。
Warning：数据目录处于警告状态，可读，但存在以下情况的任意一种：慢盘；数据目录所在磁盘使用率超过90%；磁盘剩余空间不足1GiB；或者HBlock对这个目录停写。
Error：数据目录错误状态，无法访问，原因可能是：所在磁盘出现I/O错误导致无法读写，数据目录未正确挂载等。
Health Detail：数据目录健康状态详情。
如果健康状态为Healthy，此列为空。
如果健康状态为Warning或Error，显示警告或错误的详细信息。

示例3

集群版：集群中有3台服务器，移除hblock_1的一个数据目录，查询hblock_1的服务器信息。

[root@hblockserver CTYUN_HBlock_Plus_3.7.0_x64]# ./stor server ls -n hblock_1
Server Name: pm-006
Server ID: hblock_1
Node Name: default:room2:rack2:hblock_1
Parent Node: default:room2:rack2
Status: Connected
Master Server: true
Base Server: true
Base Service: mdm(Up),ls(Up),cs(Up)
Public Address: 192.168.0.192:3260
Cluster Address: 192.168.0.192
Recent Start Time: 2024-06-19 13:46:11
Version: 3.7.0
Disk Path(s):
+-----+--------------------------+--------------+---------------+----------------+---------------------+----------------+---------------+--------------------------+
| No. | Path                      | Storage Pool | Used Capacity | Total Capacity | Used Capacity Quota | Capacity Quota | Health Status | Health Detail           |
+-----+---------------------------+--------------+---------------+----------------+---------------------+----------------+---------------+-------------------------+
| 1.  | /mnt/stor                 | default      | 10.31 GiB     | 93.29 GiB      | 869.26 MiB          | Unlimited      | Healthy       | -                       |
| 2.  | (Removing) /tmp/pathnCV9V | default      | 62.1 MiB      | 5 GiB          | 62.09 MiB           | Unlimited      | Warning       | StopWritingWhenRemoving |
+-----+---------------------------+--------------+---------------+----------------+---------------------+----------------+---------------+-------------------------+
Removing Details:
+-----+----------------+--------------+----------------------------------------------------------------------------------------------------------+
| No. | Path           | Stage        | Details                                                                                                  |
+-----+----------------+--------------+----------------------------------------------------------------------------------------------------------+
| 1.  | /tmp/pathnCV9V | CheckingData | FaultDomains: 2 healthy, 1 warning, 0 error                                                              |
|     |                |              | Data: 33.33% safe, 66.67% await reconstruction, 0% await more faultdomains, 0% single-copy, 0% corrupted |
+-----+----------------+--------------+----------------------------------------------------------------------------------------------------------+

集群版：集群中有4台服务器，移除服务器hblock_4，查询服务器hblock_4信息。

[root@hblockserver CTYUN_HBlock_Plus_3.7.0_x64]# ./stor server ls -n hblock_4
Server Name: ecs-9689-0915142
Server ID: hblock_4
Node Name: default:room2:rack2:stor
Parent Node: default:room2:rack2
Status: Removing
Master Server: false
Base Server: false
Public Address: 192.168.0.117:20050
Cluster Address: 192.168.0.117
Recent Start Time: 2024-06-26 11:30:04
Version: 3.7.0
Disk Path(s):
+-----+---------------------------+--------------+---------------+----------------+---------------------+----------------+---------------+---------------+
| No. | Path                      | Storage Pool | Used Capacity | Total Capacity | Used Capacity Quota | Capacity Quota | Health Status | Health Detail |
+-----+---------------------------+--------------+---------------+----------------+---------------------+----------------+---------------+---------------+
| 1.  | (Removing) /mnt/storage02 | -            | 52.13 MiB     | 52.18 GiB      | -                   | Unlimited      | -             | -             |
+-----+---------------------------+--------------+---------------+----------------+---------------------+----------------+---------------+---------------+

查询指定服务器信息描述
 项目
描述
Server Name	
服务器名称。
Server ID
服务器ID。
Node Name
节点名称。
Parent Node
父节点名称。
Description
服务器描述信息，如果没有描述信息，不显示。
Status
服务器状态：
Connected：已连接。
Disconnected：未连接。
Removing：移除中。
Master Server
该服务器是否为Master节点：
true：该服务器为Master节点。
false：该服务器不是Master节点。
Base Server
该服务器是否为基础节点：
true：该服务器为基础节点。
false：该服务器不是基础节点。
Base Service
服务器上的基础服务。
Public Address
业务网的IP和端口号。
Cluster Address
集群网的IP。
Recent Start Time
HBlock服务在该节点上最近一次成功启动的时间。
-：表示HBlock服务处于停止状态。
Version
HBlock版本号。
Disk Path(s)
数据目录信息：
No.：编号。
Path：数据目录。单机版中，如果数据目录后有(*)，表示为HBlock服务器的默认数据目录。
Storage Pool：数据目录所属资源池。
Used Capacity：HBlock数据目录对应分区的已用容量。
Total Capacity：HBlock数据目录对应分区的总容量。
Used Capacity Quota：数据目录已用容量配额。
Capacity Quota：数据目录容量配额，当HBlock的使用空间一旦达到配额，就立刻阻止数据写入，不允许再使用超出配额的空间。
Health Status：数据目录的健康状态：
Healthy：数据目录处于健康状态，可正常读写，且数据目录所在磁盘使用率未超过90%。
Warning：数据目录处于警告状态，可读，但存在以下情况的任意一种：慢盘；数据目录所在磁盘使用率超过90%；磁盘剩余空间不足1GiB；或者HBlock对这个目录停写。
Error：数据目录错误状态，无法访问，原因可能是：所在磁盘出现I/O错误导致无法读写，数据目录未正确挂载等。
Health Detail：数据目录健康状态详情。
如果健康状态为Healthy，此列为空。
如果健康状态为Warning或Error，显示警告或错误的详细信息。
Removing Details
移除服务器或者移除数据目录时，被移除数据目录的详细信息：
No.：编号。
Path：具体数据目录。
Stage：移除数据目录所处的阶段：
Reconfiguration：重置中。
CheckingData：检查数据。
Executing：执行移除数据目录。
Details：详细数据：
FaultDomains：故障域详情，包括：healthy（健康个数），warning（告警个数），error（错误个数）。
Data：safe（安全数据百分比），await reconstruction（需要重建的数据百分比），await more faultdomains（需要额外故障域才能够重建的数据百分比），single-copy（单副本数据百分比），corrupted（已经损坏的数据百分比）。

示例4

单机版：查询服务器中HBlock使用的端口号。

[root@hblockserver CTYUN_HBlock_Plus_3.7.0_x64]# ./stor server ls --port
+-----+-----------+---------------+----------------+-----------------+-------------+------------+--------------+-------------------+
| No. | Server ID | Server Name   | Public Address | Cluster Address | Port Range  | iSCSI Port | API&Web Port | Management Port   |
+-----+-----------+---------------+----------------+-----------------+-------------+------------+--------------+-------------------+
| 1.  | hblock_1  | hblockserver  | 192.168.0.32   | 192.168.0.32    | 20000-20500 | 3260       | 1443,442     | 20000,20001,20002 |
|     |           |               |                |                 |             |            |              | 20003,20004       |
+-----+-----------+---------------+----------------+-----------------+-------------+------------+--------------+-------------------+

集群版：查询服务器中HBlock使用的端口号。

[root@hblockserver CTYUN_HBlock_Plus_3.7.0_x64]# ./stor server ls --port
+-----+--------------+------------------+----------------+-----------------+-------------+------------+--------------+-----------+-------------------+-------------------+-------------------+
| No. | Server ID    | Server Name      | Public Address | Cluster Address | Port Range  | iSCSI Port | API&Web Port | Data Port | Storage Port      | Management Port   | Metadata Port     |
+-----+--------------+------------------+----------------+-----------------+-------------+------------+--------------+-----------+-------------------+-------------------+-------------------+
| 1.  | hblock_1(M)  | pm-006           | 192.168.0.192  | 192.168.0.192   | 20000-20500 | 3260       | 1443,2443    | 20008     | 20015,20016,20017 | 20000,20003,20007 | 20001,20002,20004 |
|     |              |                  |                |                 |             |            |              |           | 20018,20019,20020 | 20009,20010,20013 | 20005,20006,20011 |
|     |              |                  |                |                 |             |            |              |           |                   |                   | 20012,20014       |
| 2.  | hblock_2(**) | hblockserver     | 192.168.0.110  | 192.168.0.110   | 20000-20500 | 3260       | 1443,2443    | 20008     | 20015,20016,20017 | 20000,20003,20007 | 20001,20002,20004 |
|     |              |                  |                |                 |             |            |              |           |                   | 20009,20010,20013 | 20005,20006,20011 |
|     |              |                  |                |                 |             |            |              |           |                   |                   | 20012,20014       |
| 3.  | hblock_3(**) | ecs-9689-0915140 | 192.168.0.102  | 192.168.0.102   | 20000-20500 | 3260       | 1443,2443    | 20008     | 20002,20004,20005 | 20000,20003,20007 | 20001,20006,20011 |
|     |              |                  |                |                 |             |            |              |           |                   | 20009,20010,20013 | 20012,20014       |
+-----+--------------+------------------+----------------+-----------------+-------------+------------+--------------+-----------+-------------------+-------------------+-------------------+

集群版：查询服务器hblock_1中HBlock的端口号。

[root@hblockserver CTYUN_HBlock_Plus_3.7.0_x64]# ./stor server ls -n hblock_1 --port
Server Name: pm-006
Server ID: hblock_1
Node Name: default:room2:rack2:hblock_1
Parent Node: default:room2:rack2
Public Address: 192.168.0.192
Cluster Address: 192.168.0.192
Ports:
+---------------------+-------------------------------------------------+
| Port Classification | Port                                            |
+---------------------+-------------------------------------------------+
| Port Range          | 20000-20500                                     |
| iSCSI Port          | 3260                                            |
| API Port            | 1443                                            |
| Web Port            | 2443                                            |
| Data Port           | 20008                                           |
| Storage Port        | 20015,20016,20017,20018,20019,20020             |
| Management Port     | 20000,20003,20007,20009,20010,20013             |
| Metadata Port       | 20001,20002,20004,20005,20006,20011,20012,20014 |
+---------------------+-------------------------------------------------+

查询指定服务器端口号描述
项目
描述
No.
编号。
Server Name
服务器名称。
Server ID
服务器ID。
Node Name
节点名称。
Parent Node
父节点名称。
Public Address
业务网的IP和端口号。
Cluster Address
集群网的IP和端口号。
Port Range
端口范围。
iSCSI Port
iSCSI端口。
API Port
API端口。
Web Port
Web端口。
Data Port
数据端口（仅集群版支持）。
Storage Port
数据存储端口（仅集群版支持）。
Management Port
管理端口。
Metadata Port
元数据端口（仅集群版支持）。