lsportip

請使用 lsportip 指令來列出系統中每個節點上的每個乙太網路埠的配置。這個指令會顯示「網際網路通訊協定 (IP)」位址,以及埠是否配置為「小型電腦系統介面 (SCSI)」埠。

語法

讀取語法圖表略過語法圖表 lsportip -filtervalueattribute=value-filtervalue?-nohdr-delimdelimiterethernet_port_id

參數

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

說明

這個指令會列出 IBM Spectrum Virtualize 系統中每個節點的乙太網路埠配置。

請搭配使用 lsportip 指令和 ethernet_port_id 選用參數,以顯示所指定埠的詳細視圖。

埠的輸出列會顯示該埠的 MAC 位址(可以確定的話)。如果節點和乙太網路鏈結在線上,各列也會顯示鏈結的速度和雙工狀態。duplex 欄位可以有 HalfFull 的值,如果節點離線,則為空白。

每個埠的第四列顯示已配置給該埠,且未交給另一個節點進行失效接手的任何 IP 位址。這一列的 failover 欄位設為 no。每個埠的第二列顯示已配置給夥伴節點,或已配置給含失效接手之本端節點的任何 iSCSI 位址,以及在埠上作用中的 iSCSI 位址。這一列的 failover 欄位設為 yes

如果未將任何 iSCSI 位址配置給埠,state 欄位會設為 unconfigured。如果已配置位址,但鏈結當掉,state 欄位便設為 offline,如果鏈結已啟動,就設為 online。任何離線的列都代表可能有問題。

這個指令會顯示系統埠狀態的相關資訊。

這份表格提供可以顯示為輸出視圖資料的屬性值。
表 1. lsportip 輸出
屬性 說明
id 指示乙太網路埠的 ID。
node_id 指示包含埠的節點的 ID。
node_name 指示包含埠的節點的名稱。
IP 位址 指出 IPv4 位址(若無則為空白)。
mask 指出 IPv4 子網路遮罩(若無則為空白)。
gateway 指出 IPv4 閘道(若無則為空白)。
IP_address_6 指出 IPv6 位址(若無則為空白)。
prefix_6 指出 IPv6 字首(若無則為空白)。
gateway_6 指出 IPv6 閘道位址(若無則為空白)。
MAC 指出現行 MAC 位址(如果不明,則為空白)。
duplex 指出埠的現行雙工狀態(如果不明,則為空白)。
狀態 指出 iSCSI 位址的狀態。值可以是:
  • unconfigured:沒有 iSCSI 位址(或硬體可能不存在)。
  • configured:已配置 iSCSI 位址。
  • management_only:無法針對 I/O 作業來配置。
link_state 指出乙太網路埠的鏈結狀態。其值為 activeinactive
主機 顯示用於主機連接的 IPv4 位址。
remote_copy 顯示 IPv4 遠端副本埠群組 ID。遠端副本包括 Metro Mirror、Global Mirror 和 HyperSwap®
host_6 顯示用於主機連接的 IPv6 位址。
remote_copy_6 顯示 IPv6 遠端副本埠群組 ID。遠端副本包括 Metro Mirror、Global Mirror 和 HyperSwap
remote_copy_status 顯示 IPv4 遠端副本狀態。遠端副本包括 Metro Mirror、Global Mirror 和 HyperSwap
remote_copy_status_6 顯示 IPv6 遠端副本狀態。遠端副本包括 Metro Mirror、Global Mirror 和 HyperSwap
vlan 顯示與該埠上的 IPv4 位址相關聯的虛擬區域網路 (VLAN) ID(範圍 1 到 4094 的數值字元)。
vlan_6 顯示這個埠上與 IPv6 位址相關聯的 VLAN ID(1 - 4094 範圍內的數值字元)。
adapter_location 顯示包含乙太網路埠的配接卡位置(範圍 0 - 8 內的任何數字)。其中 1 - 8 是 PCIe 擴充槽號碼,0 表示配接卡是主機板的一部分,或不在 PCIe 擴充槽中。
adapter_port_id 顯示配接卡的乙太網路埠的位置(從範圍 1 到 4 的任何數字)。
dcbx_state 顯示埠的「資料中心橋接功能交換通訊協定 (DCB)」狀態。值如下:
  • unsupported:指示埠不接受交換器埠的優先順序流程控制 (PFC) 配置,即使交換器具備 DCBx 功能也一樣。 所有不到 10 Gbps 的埠都具有此值。
  • enabled:指示對已連接的交換器埠啟用 DCBx,且埠狀態為線上。
  • disabled:指示對已連接的交換器埠關閉 DCBx,或埠狀態為離線。
如果已連接的交換器埠啟用了 DCBx,則在速度為 10 Gbps 的乙太網路埠上會自動啟用 DCBx。
記住: 當該欄位已停用或不受支援時,所有 PFC 相關欄位均為空白。
fcoe_priority_tag 顯示已連接的交換器埠上指派的乙太網路光纖通道 (FCoE) 通訊協定的數值優先順序標籤值。該值必須為 07 的數字,或為空白。
pfc_enabled_tags 顯示在已連接的交換器埠上已啟用 PFC 的優先順序標籤之清單。如果您想要使用無損 iSCSI 或 FCoE 功能,則必須為交換器上對應的標籤啟用 PFC。在交換器上啟用後,標籤就會顯示在此欄位中。該值為空白或以冒號區隔的數字清單(從 07)。
重要: 如果交換器上未定義優先順序標籤,則該欄位為空白。如果交換器上已定義優先順序標籤,但沒有對那些優先順序標籤啟用 PFC,則該欄位為空白。
priority_group_0 顯示優先順序群組 0 內的優先順序標籤的集合。該值為空白或以冒號分隔的數字清單(這些數字的範圍為 07)。該欄位是「增強傳輸選擇」(ETS) 設定的一部分。
priority_group_1 顯示優先順序群組 1 內的優先順序標籤的集合。該值為空白或以冒號分隔的數字清單(這些數字的範圍為 07)。該欄位是 ETS 設定的一部分。
priority_group_2 顯示優先順序群組 2 內的優先順序標籤的集合。該值為空白或以冒號分隔的數字清單(這些數字的範圍為 07)。該欄位是 ETS 設定的一部分。
priority_group_3 顯示優先順序群組 3 內的優先順序標籤的集合。該值為空白或以冒號分隔的數字清單(這些數字的範圍為 07)。該欄位是 ETS 設定的一部分。
priority_group_4 顯示優先順序群組 4 內的優先順序標籤的集合。該值為空白或以冒號分隔的數字清單(這些數字的範圍為 07)。該欄位是 ETS 設定的一部分。
priority_group_5 顯示優先順序群組 5 內的優先順序標籤的集合。該值為空白或以冒號分隔的數字清單(這些數字的範圍為 07)。該欄位是 ETS 設定的一部分。
priority_group_6 顯示優先順序群組 6 內的優先順序標籤的集合。該值為空白或以冒號分隔的數字清單(這些數字的範圍為 07)。該欄位是 ETS 設定的一部分。
priority_group_7 顯示優先順序群組 7 內的優先順序標籤的集合。該值為空白或以冒號分隔的數字清單(這些數字的範圍為 07)。該欄位是 ETS 設定的一部分。
bandwidth_allocation 顯示優先順序群組 0 到 7 的保證頻寬配置百分比之清單。該值為空白,或是以冒號區隔的各優先順序群組頻寬配置百分比數值清單,其中,每個百分比都是整數。該欄位是 ETS 設定的一部分。
註: 如果還沒有為網路上的任何優先順序群組配置特定頻寬,則該欄位為空白。
storage 指出是否將 IPv4 位址用於 iSCSI 後端儲存體連接功能。值為 yesno(預設值)。如果未指定任何位址,則該值為空白。
storage_6 指示埠上的 IPv6 位址是否用於 iSCSI 後端儲存體連接功能。值為 yesno(預設值)。如果未指定任何位址,則該值為空白。
host_port_grp_id 指出簡要視圖和詳細視圖中的主機埠群組 ID。值為 0 和 1-32。

對於任何乙太網路埠,預設值為 0。

所有已配置的主機連接埠都具有非零的 host_port_grp_id。

  • 0(預設值):在新的安裝中,對於 host 旗標設為 no 的所有已配置的 iSCSI 埠,這個欄位會設為 0。

    從舊版更新時,所有先前配置的 iSCSI 埠會新增至預設主機埠群組,亦即 0。更新至現行版本後,即使 host 旗標設為 yes,iSCSI 埠仍會放入主機埠群組 0 中。

  • 1-32:這些主機埠群組 ID 會指派給 host 旗標設為 yes 的每個已配置的 iSCSI 埠。

    主機埠分組會將具有相同速度和相同 rdma_type 功能的埠分組在一起。具有相同速度但 rdma_type 功能不同的埠將個別分組在一起。範例:速度為 25 Gbps 且 rdma_type 為 iWARP 的埠與速度為 25 Gbps 但 rdma_type 為 RoCE 的埠分在不同群組中。

    主機埠分組可確保在探索期間主機探索的埠不超過 4 個。每個系統節點最多四個埠可屬於同一個主機埠群組 ID。屬於同一主機埠群組 ID 的所有埠的速度都相同,並且具有相同 rdma_type 功能。在 I/O 群組的兩個節點之間,最多八個 iSCSI 埠(每個節點四個)可屬於同一個主機埠群組 ID。

在下列範例中(其中列出不同埠配置選項),每個可能的乙太網路埠有兩行,分別代表埠和 iSCSI 行為效果。埠索引是以靜態方式指派,較高的索引用於選用的埠。

簡要呼叫範例

lsportip

結果輸出:


id node_id node_name IP_address   mask          gateway     IP_address_6                            prefix_6 gateway_6                               MAC               duplex state      speed failover link_state host remote_copy host_6 remote_copy_6 remote_copy_status remote_copy_status_6 vlan vlan_6 adapter_location adapter_port_id  storage storage_6 host_port_grp_id  
1  1       node1     192.168.1.52 255.255.255.0 192.168.1.1                                                                                          5c:f3:fc:0b:da:64 Full   configured 1Gb/s no       active     yes  0                  0                                                                 0                1                yes               1       
1  1       node1                                                                                                                                     5c:f3:fc:0b:da:64 Full   configured 1Gb/s yes      active          0                  0                                                                 0                1                                                                0 
2  1       node1                                            fc00:0000:0000:0000:445a:0a17:fcf7:0236 64       fc00:0000:0000:0000:445a:0a17:fcf7:0001 5c:f3:fc:0b:da:66 Full   configured 1Gb/s no       active          0           yes    0                                                                 0                2                                  1 
2  1       node1                                                                                                                                     5c:f3:fc:0b:da:66 Full   configured 1Gb/s yes      active          0                  0                                                                 0                2                                                                0
1  2       node2     192.168.1.53 255.255.255.0 192.168.1.1                                                                                          e4:1f:13:2f:b4:a4 Full   configured 1Gb/s no       active     yes  0                  0                                                                 0                1                                  1
1  2       node2                                                                                                                                     e4:1f:13:2f:b4:a4 Full   configured 1Gb/s yes      active          0                  0                                                                 0                1                                                                0
2  2       node2                                            fc00:0000:0000:0000:445a:0a17:fcf7:0237 64       fc00:0000:0000:0000:445a:0a17:fcf7:0001 e4:1f:13:2f:b4:a6 Full   configured 1Gb/s no       active          0           yes    0                                                                 0                2                                  1
2  2       node2                                                                                                                                     e4:1f:13:2f:b4:a6 Full   configured 1Gb/s yes      active          0                  0                                                                 0                2                                                                0

詳細的呼叫範例

lsportip 1

詳細的結果輸出:

id 1

node_id 1
node_name node1
IP_address 192.168.20.10
mask 255.255.255.0
gateway 192.168.20.1
IP_address_6
prefix_6
gateway_6
MAC 00:1a:64:97:1b:a0
duplex Full
state online
speed 1Gb/s
failover no
mtu 1500
host yes
remote_copy 0
host_6
remote_copy_6 0
remote_copy_status
remote_copy_status_6
vlan 1063
vlan_6
adapter_location 1
adapter_port_id 1
dcbx_state Enabled
  

fcoe_priority_tag  3 
pfc_enabled_tags 3:4 
 
priority_group_0  
priority_group_1  
priority_group_2  
priority_group_3  
priority_group_4  
priority_group_5  
priority_group_6 3
priority_group_7 4
bandwidth_allocation 0:0:0:0:0:0:30:30
storage yes
storage_6
host_port_grp_id 1



id 1

node_id 1
node_name node1
IP_address
mask
gateway
IP_address_6
prefix_6
gateway_6
MAC 00:1a:64:97:1b:a0
duplex Full
state online
speed 1Gb/s
failover yes
mtu 1500
host yes
remote_copy 0
host_6
remote_copy_6 0
remote_copy_status
remote_copy_status_6
vlan 1063
vlan_6
adapter_location 1
adapter_port_id 1
dcbx_state Enabled
 

fcoe_priority_tag  3 
pfc_enabled_tags 3:4 
 
priority_group_0  
priority_group_1  
priority_group_2  
priority_group_3  
priority_group_4  
priority_group_5  
priority_group_6 3
priority_group_7 4
bandwidth_allocation 0:0:0:0:0:0:30:30
storage
storage_6
host_port_grp_id 1



id 1

node_id 2
node_name node2
IP_address 192.168.20.11
mask 255.255.255.0
gateway 192.168.20.1
IP_address_6
prefix_6
gateway_6
MAC 00:1a:64:97:16:08
duplex Full
state online
speed 1Gb/s
failover no
mtu 1500
host yes
remote_copy 0
host_6
remote_copy_6 0
remote_copy_status
remote_copy_status_6
vlan 1063
vlan_6
adapter_location 1
adapter_port_id 1
dcbx_state Enabled
 

fcoe_priority_tag  3 
pfc_enabled_tags 3:4 

priority_group_0  
priority_group_1  
priority_group_2  
priority_group_3  
priority_group_4  
priority_group_5  
priority_group_6 3
priority_group_7 4
bandwidth_allocation 0:0:0:0:0:0:30:30
storage yes
storage_6
host_port_grp_id 1



id 1

node_id 2
node_name node2
IP_address
mask
gateway
IP_address_6
prefix_6
gateway_6
MAC 00:1a:64:97:16:08
duplex Full
state online
speed 1Gb/s
failover yes
mtu 1500
host yes
remote_copy 0
host_6
remote_copy_6 0
remote_copy_status
remote_copy_status_6
vlan 1063
vlan_6
adapter_location 1
adapter_port_id 1
dcbx_state Enabled
 

fcoe_priority_tag  3 
pfc_enabled_tags 3:4 
 
priority_group_0  
priority_group_1  
priority_group_2  
priority_group_3  
priority_group_4  
priority_group_5  
priority_group_6 3
priority_group_7 4
bandwidth_allocation 0:0:0:0:0:0:30:30
storage
storage_6
host_port_grp_id 1