lscontroller

請使用 lscontroller 指令,來顯示系統可見之控制器的簡要清單或詳細視圖。

語法

讀取語法圖表略過語法圖表 lscontroller -filtervalueattribute=value-nohdr-delimdelimiter-filtervalue?controller_idcontroller_name

參數

-filtervalue attribute=value
(選用)指定一或多個過濾器的清單。只會傳回其值符合過濾器屬性值的物件。如果指定容量,也必須包括單位。
註: 某些過濾器容許您在輸入指令時使用萬用字元。在 CLI 中使用萬用字元時,會套用下列規則:
  • 萬用字元是星號 (*)
  • 指令最多可包含一個萬用字元,並且該萬用字元必須是字串中的第一個或最後一個字元。
-filtervalue?
(選用)顯示有效的過濾器屬性。lscontroller 指令的有效過濾器屬性如下:
  • controller_name
  • id
  • site_id
  • site_name
-nohdr
(選用)依預設,會在簡要樣式視圖中顯示每個資料直欄的標題,以及在詳細樣式視圖中顯示每個資料項目的標題。-nohdr 參數會暫停顯示這些標題。
註: 如果沒有要顯示的資料,就不會顯示標題。
-delim delimiter
(選用)依預設,簡要視圖中的所有資料直欄都以空格區隔。每個直欄的寬度都會設為各資料項目的最大寬度。在詳細視圖中,每個資料項目本身都有一列,如果顯示標頭,會用空格來區隔資料與標頭。-delim 參數會置換此行為。-delim 參數的有效輸入為一個單位元組字元。如果您在指令行輸入 -delim :,則會用冒號字元 (:) 來區隔簡要視圖中的所有資料項目;例如,直欄不會出現間距。在詳細視圖中,會用指定的定界字元來區隔資料與其標頭。
controller_id | controller_name
(選用)指定控制器的名稱或 ID。當使用這個參數時,會傳回特定控制器的詳細視圖,而忽略 -filtervalue 參數所指定的任何值。如果未指定 controller_id | controller_name 參數,簡要視圖會顯示符合過濾需求(以 -filtervalue 參數指定)的所有控制器。

說明

這個指令會傳回系統可見的控制器的簡要清單或詳細視圖。

下列值適用於輸出視圖中的資料:
degraded no, yes

如果要區分儲存體控制器的名稱與系統上所顯示的名稱,請發出 lscontroller 指令,以列出儲存體控制器。記錄您要決定之控制器的控制器名稱或 ID。針對考量中的控制器,發出 lscontroller controller name | id 指令,其中 controller name | id 是控制器名稱或 ID。請將控制器的全球節點名稱 (WWNN) 記錄下來。您可以使用 WWNN 來判定實際的儲存體控制器,其方式是啟動原生控制器使用者介面,或是使用其所提供的指令行工具,來驗證具有 WWNN 的實際控制器。

附註:
  1. mdisk_link_count 值是目前與此儲存體控制器相關聯的 MDisk 的數量。
  2. max_mdisk_link_count 值是 mdisk_link_count 自前次重設為 mdisk_link_count 值以來,所達到的最大值。
    記住: 此值會由特定的維護程序重設,或在清除事件日誌時重設。
  3. 對於單一的 MDisk,從節點或節點機匣埠到控制器埠的 SAN 連線是一個路徑。控制器埠 path_count 值是目前用來將輸入/輸出 (I/O) 資料提交至此控制器埠的路徑數目。
  4. 儲存體控制器 max_path_count 值是儲存體控制器 path_count 自前次重設為 path_count 值以來,所達到的最大值。這個值會由特定的維護程序,或是在清除系統錯誤日誌時進行重設。
    重要: max_path_count 值是 path_count 自前次重設為 path_count 值以來,所達到的最大值。
    記住: 此值會由特定的維護程序重設,或在清除事件日誌時重設。
  5. allow_quorum 值用來識別控制器是否能夠支援仲裁磁碟。仲裁支援為啟用或停用狀態,視控制器硬體類型而定。
  6. ctrl_s/n 值是控制器序號。
    重要: 此資料來自供應商控制的原始檔,可能無法使用。
這份表格提供可以顯示為輸出視圖資料的屬性值。
這份表格提供可以顯示為輸出視圖資料的屬性值。
表 1. lscontroller 輸出
屬性 可能的值
id 指出控制器 ID。
name 指出控制器名稱。
WWNN 指示全球節點名稱 (WWNN)。 該欄位對於 iSCSI 控制器為空白。
mdisk_link_count 指出 MDisk 鏈結計數。
max_mdisk_link_count 指出 MDisk 鏈結計數上限。
degraded 指出控制器是否有欠佳的 MDisk。
vendor_id 指出供應商的識別名稱或號碼。
product_id_low 指出產品識別。
product_id_high 指出產品識別。
product_revision 指出產品修訂。
ctrl_s/n 指出控制器序號。
allow_quorum 指出控制器可支援仲裁磁碟。
WWPN 指示全球埠名 (WWPN)。 該欄位對於 iSCSI 控制器為空白。
path_count 指出目前用來將輸入/輸出 (I/O) 資料提交給控制器埠的路徑數目。
max_path_count 指出目前用來將輸入/輸出 (I/O) 資料提交給控制器埠的路徑數目上限。
site_id 指出控制器的站台值。此數值為 123 或空白。
site_name 指出控制器的站台名稱。這個值是英數值或空白。
fabric_type 指出光纖通道 (FC) 或 SAS 控制器。
  • fc 表示 FC 控制器
  • sas_direct 表示 SAS 直接連接的控制器
  • multiple 表示多個控制器(FC 及/或 SAS)
  • iscsi 表示 iSCSI 控制器
iscsi_port_id 指出 I/O 埠 ID,與 FC 網域中的 WWPN 值相同。若為 iSCSI 控制器,此值會顯示 iSCSI 埠 ID;若為其他控制器,此值空白。此值必須是數值。

此 ID 會參照 lsiscsistorageport 指令輸出中的列號。lsiscsistorageport 可用來尋找控制器 IQN。

ip 指出 iscsi_port_id 相關聯的 IP 位址。若為 iSCSI 控制器,此值會顯示 IP 值;若為其他控制器,此值空白。此值必須是 IPv4 或 IPv6 位址。
physical_capacity 指出控制器的實體容量。如果控制器不會報告實體容量資訊,則此值一律空白或空的。

iSCSI 控制器的簡要呼叫範例

lscontroller -delim :

簡要的結果輸出:

id:controller_name:ctrl_s/n:vendor_id:product_id_low:product_id_high:WWNN:degraded:fabric_type:site_id:site_name
0:controller0::IBM:1726-4xx:FAStT::no:iscsi:1:snpp1
1:controller1::IBM:1726-4xx:FAStT::no:iscsi:2:snpp2
7:controller7:3EK0J5Y8:SEAGATE :ST373405:FC:200600A0B851061E:yes:fc:1:snpp1
8:controller8:3EK0J6CR:SEAGATE :ST373405:FC:200600A0B851061D:no:fc:2:snpp2
9:controller9:3EK0J4YN:SEAGATE :ST373405:FC:200600A0B851061C:no:fc:3:snpp3
10:controller10:3EK0GKGH:SEAGATE :ST373405:FC:200600A0B851061B:no:fc:1:snpp4
11:controller11:3EK0J85C:SEAGATE :ST373405:FC:200600A0B851061A:no:fc:2:snpp5
12:controller12:3EK0JBR2:SEAGATE :ST373405:FC:200600A0B851062A:no:fc:3:snpp6
13:controller13:3EKYNJF8:SEAGATE :ST373405:FC:200600A0B851062B:no:fc:1:snpp7
14:controller14:3EK0HVTM:SEAGATE :ST373405:FC:200600A0B851062C:no:fc:2:snpp8 

光纖通道控制器的詳細呼叫範例

lscontroller -delim = 7

詳細的結果輸出:

id=7
controller_name=controller7
WWNN=20000004CF2412AC
mdisk_link_count=1
max_mdisk_link_count=1
degraded=no
vendor_id=SEAGATE 
product_id_low=ST373405
product_id_high=FC      
product_revision=0003
ctrl_s/n=3EK0J5Y8
allow_quorum=no
site_id=2
site_name=DR
WWPN=22000004CF2412AC
path_count=1
max_path_count=1
WWPN=21000004CF2412AC
path_count=0
max_path_count=0
fabric_type=sas_direct
iscsi_port_id=
ip=
physical_capacity=20.0GB

iSCSI 控制器的詳細呼叫範例

lscontroller 0

詳細的結果輸出:

id 0
controller_name controller0
WWNN
mdisk_link_count 4
max_mdisk_link_count 4
degraded no
vendor_id IBM
product_id_low 1726-4xx
product_id_high   FAStT
product_revision 0617
ctrl_s/n
allow_quorum no
fabric_type iscsi
site_id
site_name
WWPN
path_count 4
max_path_count 4
iscsi_port_id 1
ip 10.10.10.1
WWPN
path_count 4
max_path_count 4
iscsi_port_id 2
ip 10.10.10.2
physical_capacity 40.0GB