lsarray

使用 lsarray 命令可列出阵列 MDisk。

语法

 lsarray    [  -nohdr  ]   [  -delim   delimiter  ]   [ -bytes ]   [  -filtervalue?  ]   { [  -filtervalue  attribute=value  ] | [  -filtervalue   capacity=value   -unit  {  b  |  kb  |  mb  |  gb  |  tb  |  pb  } ] }   [ {  mdisk_id   |  mdisk_name  } ]  

参数

-nohdr
(可选)缺省情况下,在详细样式视图中显示每个数据项的标题。-nohdr 参数用于禁止显示这些标题。
Note: 如果没有要显示的数据,那么不会显示标题。
-delim delimiter
(可选)在详细视图中,每个数据项各占一行,如果显示标题,将用空格来分隔数据与标题。-delim 参数会覆盖此行为。-delim 参数的有效输入为一个单字节字符。在详细视图中,数据与标题间以指定的定界符分隔。
-bytes
(可选)请求输出以字节为单位的容量(而不是舍入值)。
-filtervalue?
(可选)在报告中包含所有有效过滤器属性。以下过滤器属性对 lsarray 命令有效:
  • balanced
  • capacity
  • distributed
  • mdisk_id
  • mdisk_name
  • mode
  • mdisk_grp_id
  • mdisk_grp_name
  • fast_write_state
  • raid_status
  • raid_level
  • redundancy
  • spare_goal
  • spare_protection_min
  • status
  • strip_size
  • tier
  • easy_tier_load
将忽略使用 -filtervalue? 参数指定的任何参数。
-filtervalueattribute=value
(可选)指定与指定值匹配的一个或多个过滤器属性的列表;请参阅 -filtervalue? 以了解支持的属性。仅返回值与过滤器属性值匹配的对象。如果指定了容量,那么还必须包含单位。使用 unit 参数可解释大小或容量的值。
Note: 某些过滤器允许您在输入命令时使用通配符。以下规则适用于在运行 CLI 时使用通配符的情况:
  • 通配符为星号 (*)。
  • 命令最多可包含一个通配符,并且该通配符必须是字符串中的第一个或最后一个字符。
  • 使用通配符时,必须以双引号("")将过滤器条目括起来:
    lsarray -filtervalue  "name=md*"
-filtervaluecapacity=value
(可选)指定与特定 unit 参数值匹配的一个或多个过滤器容量(大小)值的列表。使用 unit 参数可解释大小或容量的值。
-unitb | kb | mb | gb | tb | pb
(可选)指定 -filtervalue 容量时使用的单位,其中:
  • b = 字节
  • kb = 1,024 字节
  • mb = 1,048,576 字节
  • gb = 1,073,741,824 字节
  • tb = 1,099,511,627,776 字节
  • pb = 1,125,899,906,842,624 字节
mdisk_id
(可选)阵列 MDisk 的标识。
mdisk_name
(可选)阵列 MDisk 的名称。

描述

此命令返回集群系统(系统)可视的阵列 MDisk 的简明列表或详细视图。Table 1 提供了可显示为输出视图数据的属性值。
Table 1. 阵列输出
属性
capacity 指示使用 -unit 参数时指定的容量值。
status
  • online
  • offline
  • excluded
  • degraded(仅适用于内部 MDisk)
mode 指示方式。值包括:
  • unmanaged
  • managed
  • 映像 (image)
  • 阵列
quorum_index 指示定额索引。值包括:
  • 0
  • 1
  • 2
  • 如果 MDisk 不用作定额磁盘,那么设置为空白
block_size 指示块大小。各存储块中值为 512 字节(或空白)。
ctrl_type 46,其中 6 表示节点内附加的闪存驱动器,4 表示任何其他设备
raid_status 指示 RAID 状态。值包括:
offline
阵列在所有节点上处于脱机状态。
degraded
阵列已取消配置或使成员处于脱机状态;阵列未完全冗余。
syncing
阵列成员全部处于联机状态。阵列正在同步奇偶性校验或者进行镜像以实现冗余。
initializing
阵列成员全部处于联机状态。阵列正在初始化;阵列完全冗余。
online
阵列成员全部处于联机状态,且阵列完全冗余。
fast_write_state 指示阵列的高速缓存状态。值包括:
  • empty,指示阵列磁盘数据未更改
  • not_empty,指示阵列磁盘数据可能更改
  • corrupt,指示阵列磁盘数据丢失,阵列已损坏
可使用 recoverarrayrecoverarraybysystem 命令启动修复。
raid_level 指示阵列的 RAID 级别。值包括:
  • RAID0
  • RAID1
  • RAID5
  • RAID6
  • RAID10
redundancy 指示可同时发生故障而不会导致阵列无法工作的成员磁盘的数量。
strip_size 指示阵列的条带大小(以 KB 为单位)。
spare_goal 指示必须用于保护阵列成员的备件数。对于分布式阵列,该值为空白。
spare_protection_min 指示保护一个阵列成员所需的最小备件数。对于分布式阵列,该值为空白。
balanced
对于非分布式阵列,该值指示是否针对备用目标均衡阵列:
  • exact 指示所有已填充成员具有相同(匹配)的容量和位置。
  • yes 指示所有已填充成员至少具有相同的容量和链,但具有不同的机柜或插槽。
  • no 表示不平衡。
对于分布式阵列,该值指示是否对阵列使用上级驱动器种类:
  • exact 表示正在使用相同的驱动器种类。
  • yes 表示至少一个阵列成员超出阵列驱动器种类范畴。
对于分布式阵列,还必须针对其重建区域目标均衡阵列。
tier 指示通过自动检测(对于内部阵列)或由用户将此阵列分配到的层:
  • tier0_flash
  • tier1_flash
  • tier_enterprise
  • tier_nearline
Note: 使用 chmdisk 命令可更改此值。
replacement_date 指示潜在阵列故障的日期。格式必须为 YYMMDD
easy_tier_load 指示 Easy Tier 设置的值,为空白(对于阵列)或者以下值之一(对于 MDisk):
  • low
  • medium
  • high
  • very_high
slow_write_priority 指示响应时间目标:
  • latency 指示阵列取消同步,以便快速完成耗时过长的写操作。
  • redundancy 指示以正常的耗时完成较慢的写操作,同时阵列保持同步。
site_id 指示存储池的站点值。 此数字值为 123 或空白。
site_name 指示存储池的站点名称。 该值为字母数字或为空白。
fabric_type 指示光纤通道 (FC)、SAS 或其他类型的阵列。
  • fc 指示来自 FC 控制器的阵列
  • sas_direct 指示来自 SAS 直接连接控制器的阵列
encrypt 指示是否已加密阵列上存储的数据。可能的值如下所示:
  • yes
  • no
distributed 指示阵列是否是分布式阵列。 值为 yesno
drive_class_id 指示构成此阵列的驱动器类。如果在阵列创建期间使用 -allowsuperior,那么将显示最不常使用的驱动器类标识。对于非分布式阵列,该值为空白。
drive_count 指示阵列的总宽度,包括重建区域。该值为 4128 之间的数字。 RAID-6 和 RAID-10 阵列的最小值为 6
stripe_width 指示一组分布式驱动器中单个冗余单元的宽度。值包括:
  • 3 - 16 之间的任何数字(针对 RAID-5 阵列)
  • 4 - 16 之间的任何数字(针对 RAID-6 阵列)
  • 2 - 16 之间的的任何偶数(针对 RAID-10 阵列)
rebuild_areas_total 指示在创建阵列时设置的重建区域总数。这些重建区域提供性能但不提供容量。对于分布式阵列 RAID-5 和分布式阵列 RAID-6,此值为 1 - 4。对于非分布式阵列,该值为空白。
rebuild_areas_available 指示驱动器集中的剩余重建区域数量。对于分布式阵列 RAID-5 和分布式阵列 RAID-6,此值为 1 - 4。对于非分布式阵列,该值为空白。
rebuild_areas_goal 指示阵列将记录错误的重建区域阈值(最小限制)。对于分布式阵列 RAID-5 和分布式阵列 RAID-6,此值为 1 - 4。对于非分布式阵列,该值为空白。
该列表定义了状态字段:
online
MDisk 处于联机状态且可用。
degraded
(仅适用于内部 MDisk)阵列包含降级的成员或 raid_status 为 degraded。
degraded_ports
存在一个或多个 MDisk 端口错误。
degraded_paths
丢失了一条或多条到 MDisk 的路径;MDisk 未联机到系统中的每个节点。
offline
丢失了到 MDisk 的所有路径。
excluded
已排除 MDisk,无法供系统使用;MDisk 端口错误计数超过阈值。

简明调用示例

lsarray -delim :

生成的输出:

mdisk_id:mdisk_name:status:mdisk_grp_id:mdisk_grp_name:capacity:raid_status:raid_level:redundancy:strip_size:tier:encrypt:distributed
1::online:0:mdiskgrp0:68.4GB:online:raid0:0:256:enterprise:no:yes
2:mdisk2:online:0:mdiskgrp0:88.4GB:syncing:raid5:1:256:nearline:no:no
533:mdisk533:degraded:1:mdiskgrp1:78.2GB:syncing:raid6:2:128:ssd:yes:yes
534:mdisk534:online:2:mdiskgrp1:94.2GB:initting:raid6:2:64:ssd:yes:no

详细调用示例

lsarray 

生成的输出:

mdisk_id 144
mdisk_name draid6_5
status online
mode array
mdisk_grp_id 1
mdisk_grp_name pool_512
capacity 5.6TB
quorum_index 
block_size 
controller_name
ctrl_typectrl_WWNN 
controller_id 
path_count
max_path_count
ctrl_LUN_#UIDpreferred_WWPN 
active_WWPN 
fast_write_state not_empty
raid_status initting
raid_level raid6
redundancy 2
strip_size 256
spare_goal spare_protection_min balanced exact
tier tier0_flash
replacement_date 121110090907
slow_write_priority redundancy
fabric_typesite_id 
site_name 
easy_tier_loadencrypt no
distributed yes
drive_class_id 1
drive_count 28
stripe_width 15
rebuild_areas_total 4
rebuild_areas_available 4
rebuild_areas_goal 2

详细调用示例

lsarray 1

生成的输出:

mdisk_id:1
mdisk_name:
status:online
mode:array
mdisk_grp_id:0
mdisk_grp_name:mdiskgrp0
capacity:68.4GB
quorum_index:
block_size:
controller_name:
ctrl_type:
ctrl_WWNN:
controller_id:
path_count:
max_path_count:
ctrl_LUN_#:
UID:
preferred_WWPN:
active_WWPN:
node_id:
node_name:
location:fast_write_state:empty
raid_status:online
raid_level:raid0
redundancy:0
strip_size:256
spare_goal:2
spare_protection_min:2
balanced:yes
tier tier1_flash
replacement_date 121110090907
slow_write_priority:latency
fabric_type:encrypt:yesdistributed no
 drive_class_id
 drive_count 8
 stripe_width 4
 total_rebuild_areas 
 available_rebuild_areas 
 rebuild_areas_goal