lshost

使用 lshost 指令來產生一份清單,其中包含關於叢集系統(系統)能看見的所有主機的簡要資訊,以及單一主機的詳細資訊。

語法

讀取語法圖表略過語法圖表
>>- lshost-- --+-----------------------------------+-- --------->
               '- -filtervalue -- attribute=value -'      

>--+----------+-- --+-----------------------+-- -- ------------->
   '- -nohdr -'     '- -delim -- delimiter -'         

>--+-----------------+--+---------------+----------------------><
   '- -filtervalue? -'  +- object_id ---+   
                        '- object_name -'   

參數

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

如需過濾屬性的相關資訊,請參閱 -filtervalue 參數的屬性

說明

這個指令會傳回系統可見之主機的簡要清單或詳細視圖。

如果是「光纖通道 (FC)」埠,node_logged_in_count 欄位會提供主機埠登入的節點數目。如果是「網際網路小型電腦系統介面 (iSCSI)」埠,node_logged_in_count 欄位會提供來自主機 iSCSI 完整名稱 (IQN) 的 iSCSI 階段作業數目。

您可以將 iSCSI 主機對映至可透過多個 I/O 群組來存取的磁區。 iSCSI 主機可以存取可透過多個 I/O 群組(和單一 I/O 群組)來存取的磁區。 如果 iSCSI 主機對映至可透過多重 I/O 群組來存取的磁區,而且與存取集的每一個 I/O 群組之間至少有一個作用中的 iSCSI 階段作業,該 iSCSI 主機的狀態為 online。 如果磁區未對映至 iSCSI 主機,則其狀態為 degraded

下列清單提供由光纖連接的「光纖通道」主機埠的不同狀態:
作用中
如果含有磁區對映的所有節點都已登入指定的全球埠名稱 (WWPN),而且在過去 5 分鐘之內,至少有一個節點收到來自 WWPN 的 SCSI 指令,則主機埠的狀態是「作用中」。
欠佳
如果一或多個含有磁區對映的節點沒有登入指定的 WWPN,則主機埠的狀態是「欠佳」。
非作用中
如果含有磁區對映的所有節點都已登入指定的 WWPN,但是在過去 5 分鐘之內,沒有任何節點看到任何來自 WWPN 的「小型電腦系統介面 (SCSI)」指令,則主機埠的狀態是「非作用中」。
離線
如果一或多個含有磁區對映的輸入/輸出 (I/O) 群組沒有登入指定的 WWPN,則主機埠的狀態是「離線」。
下列清單提供直接連接的「光纖通道」主機埠的不同狀態:
作用中
如果節點已登入指定的 WWPN,而且節點在過去 5 分鐘內收到來自 WWPN 的 SCSI 指令,則主機埠的狀態是「作用中」。
非作用中
如果含有磁區對映的所有節點都已登入指定的 WWPN,但是在過去 5 分鐘之內,沒有任何節點看到任何來自 WWPN 的「小型電腦系統介面 (SCSI)」指令,則主機埠的狀態是「非作用中」。
離線
如果指定的 WWPN 沒有登入,則主機埠的狀態是「離線」。
如果主機沒有任何磁區對映,就會將它報告為「離線」或「非作用中」。
註: lshost 指令會呈現一份已登入至節點的主機 HBA 埠清單。不過,有時呈現的資訊會包括不再登入,甚至已不屬於 SAN 光纖的主機 HBA 埠。例如,已從交換器拔除主機 HBA 埠,但 lshost 仍然顯示已登入所有節點的 WWPN。如果發生這個動作,當另一個裝置插入相同交換器埠(與先前移除的主機 HBA 埠為同一個埠)時,即會移除不正確的項目。
下列清單提供指定 iscsiname 的各種不同狀態:
作用中
如果含有磁區對映的所有 I/O 群組,對指定的 iscsiname 都至少有一個相關聯的 iSCSI 階段作業,則此 iscsiname 的狀態為「作用中」。
非作用中
如果主機沒有磁區對映,但是對指定的 iscsiname 至少有一個 iSCSI 階段作業存在,則此 iscsiname 的狀態為「非作用中」。
離線
如果一或多個含有磁區對映的 I/O 群組,對於指定的 iscsiname 沒有相關聯的 iSCSI 階段作業,則此 iscsiname 的狀態是「離線」。
下列清單提供 host_status 的不同狀態:
線上
主機具有完整的連線功能。只使用一種連線功能形式的主機,如果使用下列其中一個類型,則為「線上」:
光纖連接的光纖通道 (FAFC)
每個埠均為作用中或非作用中,且登入每個 I/O 群組(主機在其中有磁區對映)中的每個線上節點。
直接連接的光纖通道 (DAFC)
主機對 I/O 群組(主機對其具有磁區對映)中的所有節點均有作用中或非作用中的登入。
網際網路小型電腦系統介面 (iSCSI)
主機與各 I/O 群組(主機與其具有磁區對映)之間有 iSCSI 階段作業。
離線
主機不具有連線功能。原因可能是主機已關閉電源而未啟動。
記住: 如果 iSCSI 主機只登入未配置該主機的 I/O 群組,相關聯的主機物件狀態會是 offline
欠佳
主機未完全連線,可能是因為配置錯誤或硬體故障所造成。這可能會造成在任何規劃的維護活動期間無法進行存取,必須儘早更正。
記住: 沒有對映磁區的 iSCSI 主機如果登入至其所屬的某些(並非所有)I/O 群組,則該主機的狀態為 degraded
mask
主機可存取的光纖通道 (FC) I/O 埠(存在於節點上)。
表 1 顯示可能的輸出:
表 1. lshost 輸出
屬性 說明
id 指出唯一的主機 ID。此值為英數值。
name 指出唯一的主機名稱。此值為英數字串。
port_count 指出埠數目。
type 指出主機類型。
mask 指出具有 64 位元二進位字串的遮罩值。
iogrp_count 指出 I/O 群組數目。
status 指示主機是 online 還是 offline
WWPN 指出具有 16 個字元十六進位字串的全球埠名稱 (WWPN)。
SAS_WWPN 指出具有 16 個字元十六進位字串的序列連接 SCSI (SAS) WWPN。
node_logged_in_count 指出 WWPN 所登入的節點數目。
state 指出 SAS WWPN 登入狀態。值如下:
  • offline
  • inactive
  • active
sas_wwpn_count 指出所配置的 SAS WWPN 數目。
site_id 指出主機的站台 ID。值為 12 或空白。
site_name 指出主機的站台名稱。值必須是英數字串或空白。
host_cluster_id 指出主機叢集的唯一 ID。
host_cluster_name 指出主機叢集的唯一名稱。

呼叫範例

lshost

結果輸出:

id name    port_count iogrp_count status mapping_count host_cluster_id  host_cluster_name site_id site_name  
  0  hostone 1          4           offline              0               vardyhost1 2 chelsea3
  1  host0   1          4           degraded             1               vardyhost2 1 chelsea1
  2  host1   1          4           online               2               vardyhost3 2 chelsea2

詳細的呼叫範例

lshost 0

結果輸出:

id 0
name ined
port_count 1
type openvms
mask 0000000000000000000000000000000000000000000000000000000000001101
iogrp_count 4
status online
WWPN 10000000C92BB490
node_logged_in_count 1
state inactive
site_id 2
site_name chelsea2
host_cluster_id 1
host_cluster_name jvardy8

呼叫範例

lshost 0

結果輸出:

id 0
name host0
port_count 10
type generic
mask 1111111111111111111111111111111111111111111111111111111111111111
iogrp_count 4
status offline
SAS_WWPN 1000000000000009
node_logged_in_count 0
state offline
SAS_WWPN 1000000000000008
node_logged_in_count 0
state offline
site_id 2
site_name chelsea2
host_cluster_id 2
host_cluster_name boat3ng