lscontroller
使用 lscontroller 指令，顯示叢集系統（系統）可看見的控制器之簡要清單或詳細視圖。
語法
>>- lscontroller -- --+-----------------------------------+-----> '- -filtervalue -- attribute=value -' >-- --+----------+-- --+-----------------------+-- -- ----------> '- -nohdr -' '- -delim -- delimiter -' >--+-----------------+--+-------------------+------------------>< '- -filtervalue? -' +- controller_id ---+ '- controller_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 的實際控制器。
附註：
- mdisk_link_count 值是目前與此儲存體控制器相關聯的 MDisk 的數量。
- max_mdisk_link_count 值是 mdisk_link_count 自前次重設為 mdisk_link_count
值以來，所達到的最大值。記住： 此值會由特定的維護程序重設，或在清除事件日誌時重設。
- 對於單一的 MDisk，從節點或節點機匣埠到控制器埠的 SAN 連線是一個路徑。控制器埠 path_count 值是目前用來將輸入/輸出 (I/O) 資料提交至此控制器埠的路徑數目。
- 儲存體控制器 max_path_count 值是儲存體控制器
path_count 自前次重設為 path_count 值以來，所達到的最大值。這個值會由特定的維護程序，或是在清除系統錯誤日誌時進行重設。重要： max_path_count 值是 path_count 自前次重設為 path_count 值以來，所達到的最大值。記住： 此值會由特定的維護程序重設，或在清除事件日誌時重設。
- allow_quorum 值用來識別控制器是否能夠支援仲裁磁碟。仲裁支援為啟用或停用狀態，視控制器硬體類型而定。
- ctrl_s/n 值是控制器序號。重要： 此資料來自供應商控制的原始檔，可能無法使用。
這份表格提供可以顯示為輸出視圖資料的屬性值。
| 屬性 | 可能的值 |
|---|---|
| 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 | 指出控制器的站台值。此數值為 1、2、3 或空白。 |
| site_name | 指出控制器的站台名稱。這個值是英數值或空白。 |
| fabric_type | 指出光纖通道 (FC) 或 SAS 控制器。
|
| 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.0GBiSCSI 控制器的詳細呼叫範例
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