lsportip

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

語法

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

>--+-----------------+-- --+----------+-- ---------------------->
   '- -filtervalue? -'     '- -nohdr -'      

>--+-----------------------+-- --+--------------------+-- -----><
   '- -delim -- delimiter -'     '- ethernet_port_id -'      

參數

-filtervalue attribute=value
(選用)指定一或多個過濾器的清單。只會傳回其值符合過濾器屬性值的物件。 如果指定容量,也必須包括單位。
註: 某些過濾器容許您在輸入指令時使用萬用字元。在 IBM Spectrum Virtualize CLI 中使用萬用字元時,需套用下列規則:
  • 萬用字元是星號 (*)。
  • 指令最多可包含一個萬用字元,並且該萬用字元必須是字串中的第一個或最後一個字元。
  • 使用萬用字元時,請用雙引號 ("") 括住過濾項目,如下所示
    lsportip -filtervalue "node_name=md*"
-filtervalue?
(選用)顯示有效的過濾器屬性。 lsportip 指令的下列過濾器屬性有效:
  • id
  • node_id
  • node_name
  • state
  • 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 提供了可顯示為輸出視圖資料的屬性值。
表 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 顯示埠的 DCBx 狀態。值如下:
  • unsupported:指示埠不接受交換器埠的優先順序流程控制 (PFC) 配置,即使交換器具備 DCBx 功能也一樣。所有 1 Gbps 埠都具有此值。
  • enabled:指示對已連接的交換器埠啟用 DCBx,且埠狀態為線上。
  • disabled:指示對已連接的交換器埠關閉 DCBx,或埠狀態為離線。
如果已連接的交換器埠啟用了 DCBx,則在速度為 10 Gb/s 的乙太網路埠上會自動啟用 DCBx。
記住: 當該欄位已停用或不受支援時,除 lossless_iscsilossless_iscsi6 之外的所有其他欄位均為空白。
iscsi_priority_tag 顯示已連接的交換器埠上指派的網際網路小型電腦系統介面 (iSCSI) 通訊協定的數值優先順序標籤值。該優先順序值必須為 07 的數字,或為空白。
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 設定的一部分。
註: 如果還沒有為網路上的任何優先順序群組配置特定頻寬,則該欄位為空白。
lossless_iscsi 顯示對 iSCSI 網際網路通訊協定第 4 版 (IPv4) IP 位址啟用 (on) 或停用 (off) PFC。如要設為 on
  • 它必須是含有效 IPv4 位址的 10 Gbps 埠。
  • 在交換器埠上已啟用適用於 iSCSI 的 PFC。
  • 將虛擬區域網路 (VLAN) 配置為使用該 IPv4 位址。
  • 在該埠上已啟用 iSCSI 主機連接。
否則此值為 off
lossless_iscsi6 顯示對 iSCSI 網際網路通訊協定第 6 版 (IPv6) IP 位址啟用 (on) 或停用 (off) PFC。如要設為 on
  • 它必須是含有效 IPv6 位址的 10 Gbps 埠。
  • 在交換器埠上已啟用適用於 iSCSI 的 PFC
  • 將虛擬區域網路 (VLAN) 配置為使用該 IPv4 位址
  • 在該埠上已啟用 iSCSI 主機連接
否則此值為 off
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 埠。

    主機埠分組可以將速度相同的埠分在同一組,並於探索期間,確保一個主機探索到的埠不超過四個。

    每個系統節點最多四個埠可屬於同一個主機埠群組 ID。屬於相同主機埠群組 ID 的所有埠都是相同速度。在 I/O 群組的兩個節點之間,最多八個 iSCSI 埠(每個節點四個)可屬於同一個主機埠群組 ID。

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

簡要呼叫範例

lsportip -delim ,

結果輸出:

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,lossless_iscsi,lossless_iscsi6,storage,storage_6,host_port_grp_id
1,1,node1,192.168.48.135,255.255.255.0,192.168.48.1,,,,5c:f3:fc:f5:67:ca,Full,configured,1Gb/s,no,
active,yes,1,,0,unused,,65,,0,1,off,,no,1
1,1,node1,,,,,,,5c:f3:fc:f5:67:ca,Full,configured,1Gb/s,yes,active,,0,,0,,,,,0,1,,,,0
2,1,node1,192.168.48.136,255.255.255.0,192.168.48.1,,,,5c:f3:fc:f5:67:cb,Full,configured,1Gb/s,no,
active,yes,1,,0,unused,,,,0,2,off,,no,1
2,1,node1,,,,,,,5c:f3:fc:f5:67:cb,Full,configured,1Gb/s,yes,active,,0,,0,,,,,0,2,,,,0
3,1,node1,192.168.48.137,255.255.255.0,192.168.48.1,,,,00:90:fa:27:ec:22,,configured,10Gb/s,no,
active,yes,1,,0,unused,,,,1,1,off,,no,1
3,1,node1,,,,,,,00:90:fa:27:ec:22,,configured,10Gb/s,yes,active,,0,,0,,,,,1,1,,,,0
4,1,node1,192.168.48.138,255.255.255.0,192.168.48.1,0009:2009:0003:0004:0005:0006:0007:1130,64,
fe80:0000:0000:0000:0007:b4ff:fe00:0a00,00:90:fa:27:ec:24,,configured,10Gb/s,no,
active,yes,1,yes,0,unused,,165,170,1,2,on,on,yes,yes,1
4,1,node1,,,,,,,00:90:fa:27:ec:24,,configured,10Gb/s,yes,active,,0,,0,,,,,1,2,,,,0
1,2,node2,192.168.48.145,255.255.255.0,192.168.48.1,,,,5c:f3:fc:f5:68:b2,Full,configured,1Gb/s,no,
active,yes,1,,0,unused,,65,,0,1,off,,no,1
1,2,node2,,,,,,,5c:f3:fc:f5:68:b2,Full,configured,1Gb/s,yes,active,,0,,0,,,,,0,1,,,,0
2,2,node2,192.168.48.146,255.255.255.0,192.168.48.1,,,,5c:f3:fc:f5:68:b3,Full,configured,1Gb/s,no,
active,yes,1,,0,unused,,,,0,2,off,,,1
2,2,node2,,,,,,,5c:f3:fc:f5:68:b3,Full,configured,1Gb/s,yes,active,,0,,0,,,,,0,2,,,,0
3,2,node2,192.168.48.147,255.255.255.0,192.168.48.1,,,,00:90:fa:27:ec:4a,,configured,10Gb/s,no,
active,yes,1,,0,unused,,,,1,1,off,,no,1
3,2,node2,,,,,,,00:90:fa:27:ec:4a,,configured,10Gb/s,yes,inactive,,0,,0,,,,,1,1,,0
4,2,node2,192.168.48.148,255.255.255.0,192.168.48.1,0009:2009:0003:0004:0005:0006:0007:1230,64,
fe80:0000:0000:0000:0007:b4ff:fe00:0a00,00:90:fa:27:ec:4c,,configured,10Gb/s,no,active,yes,1,yes,
0,unused,,165,170,1,2,on,on,yes,yes,1
4,2,node2,,,,,,,00:90:fa:27:ec:4c,,configured,,yes,inactive,,0,,0,,,,,1,2,,,,0

簡要呼叫範例

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 lossless_iscsi lossless_iscsi6 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               off                            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                              off                     yes       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               off                            no                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                              off                     no        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
iscsi_priority_tag  4  
fcoe_priority_tag  3 
pfc_enabled_tags 3:4 
pfc_disabled_tags  0:1:2:5:6:7 
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
lossless_iscsi  on 
lossless_iscsi6 
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
iscsi_priority_tag  4  
fcoe_priority_tag  3 
pfc_enabled_tags 3:4 
pfc_disabled_tags  0:1:2:5:6:7 
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
lossless_iscsi  on 
lossless_iscsi6 
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
iscsi_priority_tag  4  
fcoe_priority_tag  3 
pfc_enabled_tags 3:4 
pfc_disabled_tags  0:1:2:5:6:7 
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
lossless_iscsi  on 
lossless_iscsi6 
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
iscsi_priority_tag  4  
fcoe_priority_tag  3 
pfc_enabled_tags 3:4 
pfc_disabled_tags  0:1:2:5:6:7 
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
lossless_iscsi  on 
lossless_iscsi6 
storage
storage_6
host_port_grp_id 1