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 參數會暫停顯示這些標題。
註: 如果沒有要顯示的資料,就不會顯示標題。
-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? 參數指定的任何參數。
-filtervalue attribute=value
(選用)指定與指定值符合的一或多個過濾器屬性的清單;請參閱 -filtervalue? 以取得支援的屬性。 只會傳回其值符合過濾器屬性值的物件。 如果指定 capacity,也必須包括單位。 使用 unit 參數來解譯大小或容量的值。
註: 當您輸入指令時,某些過濾器可使用萬用字元。當您在 CLI 中使用萬用字元時,會套用下列規則:
  • 萬用字元是星號 (*)。
  • 指令最多可包含一個萬用字元,並且該萬用字元必須是字串中的第一個或最後一個字元。
  • 使用萬用字元時,必須以雙引號 ("") 將過濾項目括起來:
    lsarray -filtervalue  "name=md*"
-filtervalue capacity=value
(選用)指定與 unit 參數的指定值符合的一或多個過濾器容量(大小)值的清單。使用 unit 參數來解譯大小或容量的值。
-unit b | 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 的簡要清單或 詳細視圖。這份表格提供可以顯示為輸出視圖資料的屬性值。
表 1. 陣列輸出
屬性
capacity 指出使用 -unit 參數時指定的容量值。
status
  • online
  • offline
  • 已排除
  • 欠佳(僅適用於內部 MDisk)
mode 指出模式。值如下:
  • unmanaged
  • managed
  • image
  • array
quorum_index 指出仲裁索引。值如下:
  • 0
  • 1
  • 2
  • 如果不以 MDisk 做為仲裁磁碟,則為空白
block_size 指出區塊大小。在每一個儲存體區塊中,此值為 512 位元組(或空白)。
ctrl_type 46,其中 6 表示節點內連接的快閃磁碟機,4 表示任何其他裝置
raid_status 指出 RAID 狀態。值如下:
offline
該陣列在所有節點上均為離線。
欠佳
陣列有已解除配置或離線的成員;陣列不是完全備援
同步化中
陣列成員全都在線上。陣列使同位檢查或鏡映同步化,以達到備援。
起始設定
陣列成員全都在線上。陣列起始設定中;陣列已完整備援。
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
註: 使用 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 指出陣列上儲存的資料是否加密或不加密。可能的值為:
distributed 指出陣列是否為分散式。值為 yesno
drive_class_id 指出構成此陣列的磁碟機類別。如果在陣列建立期間使用 -allowsuperior,則顯示最不常使用的磁碟機類別 ID。對於非分散式陣列,此值為空白。
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 的所有路徑。
已排除
系統排除使用 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_type
ctrl_WWNN
controller_id
path_count
max_path_count
ctrl_LUN_#
UID
preferred_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_type
site_id
site_name
easy_tier_load
encrypt 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:
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
site_id:3
site_name:Quorum
fabric_type:
encrypt:yes
distributed no
 drive_class_id
 drive_count 8
 stripe_width 4
 total_rebuild_areas 
 available_rebuild_areas 
 rebuild_areas_goal