lsportip

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

語法

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

參數

-filtervalue attribute=value
（選用）指定一或多個過濾器的清單。只會傳回其值符合過濾器屬性值的物件。如果指定容量，也必須包括單位。
註： 某些過濾器容許您在輸入指令時使用萬用字元。在 SAN Volume Controller 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（1、2、3 或 4）。如果省略，則會顯示所有埠的簡要視圖。使用此參數時，將傳回所指定埠的詳細視圖，而忽略 -filtervalue 參數指定的任何值。如果未使用 ethernet_port_id 參數，簡要視圖會顯示所有符合 -filtervalue 參數所指定之過濾需求的埠。

說明

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

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

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

每個埠的第四列顯示已配置給該埠，且未交給另一個節點進行失效接手的任何 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 指出乙太網路埠的鏈結狀態。其值為 active 和 inactive。
主機 顯示用於主機連接的 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) 通訊協定的數值優先順序標籤值。該值必須為 0 到 7 的數字，或為空白。
pfc_enabled_tags 顯示在已連接的交換器埠上已啟用 PFC 的優先順序標籤之清單。如果您想要使用無損 iSCSI 或 FCoE 功能，則必須為交換器上對應的標籤啟用 PFC。在交換器上啟用後，標籤就會顯示在此欄位中。該值為空白或以冒號區隔的數字清單（從 0 到 7）。
重要： 如果交換器上未定義優先順序標籤，則該欄位為空白。如果交換器上已定義優先順序標籤，但沒有對那些優先順序標籤啟用 PFC，則該欄位為空白。
priority_group_0 顯示優先順序群組 0 內的優先順序標籤的集合。該值為空白或以冒號分隔的數字清單（這些數字的範圍為 0 到 7）。該欄位是「增強傳輸選擇」(ETS) 設定的一部分。
priority_group_1 顯示優先順序群組 1 內的優先順序標籤的集合。該值為空白或以冒號分隔的數字清單（這些數字的範圍為 0 到 7）。該欄位是 ETS 設定的一部分。
priority_group_2 顯示優先順序群組 2 內的優先順序標籤的集合。該值為空白或以冒號分隔的數字清單（這些數字的範圍為 0 到 7）。該欄位是 ETS 設定的一部分。
priority_group_3 顯示優先順序群組 3 內的優先順序標籤的集合。該值為空白或以冒號分隔的數字清單（這些數字的範圍為 0 到 7）。該欄位是 ETS 設定的一部分。
priority_group_4 顯示優先順序群組 4 內的優先順序標籤的集合。該值為空白或以冒號分隔的數字清單（這些數字的範圍為 0 到 7）。該欄位是 ETS 設定的一部分。
priority_group_5 顯示優先順序群組 5 內的優先順序標籤的集合。該值為空白或以冒號分隔的數字清單（這些數字的範圍為 0 到 7）。該欄位是 ETS 設定的一部分。
priority_group_6 顯示優先順序群組 6 內的優先順序標籤的集合。該值為空白或以冒號分隔的數字清單（這些數字的範圍為 0 到 7）。該欄位是 ETS 設定的一部分。
priority_group_7 顯示優先順序群組 7 內的優先順序標籤的集合。該值為空白或以冒號分隔的數字清單（這些數字的範圍為 0 到 7）。該欄位是 ETS 設定的一部分。
bandwidth_allocation 顯示優先順序群組 0 到 7 的保證頻寬配置百分比之清單。該值為空白，或是以冒號區隔的各優先順序群組頻寬配置百分比數值清單，其中，每個百分比都是整數。該欄位是 ETS 設定的一部分。
註： 如果還沒有為網路上的任何優先順序群組配置特定頻寬，則該欄位為空白。
storage 指出是否將 IPv4 位址用於 iSCSI 後端儲存體連接功能。值為 yes 和 no（預設值）。如果未指定任何位址，則該值為空白。
storage_6 指示埠上的 IPv6 位址是否用於 iSCSI 後端儲存體連接功能。值為 yes 和 no（預設值）。如果未指定任何位址，則該值為空白。
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。
lossless_host_attach 此欄位顯示是否已針對 IPv4 上的主機連接資料流量啟用優先順序流程控制 (PFC)。如果未啟用 PFC ，則會顯示原因。值如下：
  • 空白 - 未配置 IP。
  • off-host_flag_disabled - 未設定 host 旗標。
  • off-vlan_not_configured - 未配置 vlan。
  • off-priority_tag_not_enabled_on_switch - 未在交換器上啟用 priority 標籤（使用 chsystemethernet 來設定 hostattachcos）。
  • on - 已啟用 PFC
lossless_host_attach6 此欄位顯示是否已針對 IPv6 上的主機連接資料流量啟用優先順序流程控制 (PFC)。如果未啟用 PFC ，則會顯示原因。值如下：
  • 空白 - 未配置 IP。
  • off-host_flag_disabled - 未設定 host6 旗標。
  • off-vlan_not_configured - 未配置 vlan。
  • off-priority_tag_not_enabled_on_switch - 未在交換器上啟用 priority 標籤（使用 chsystemethernet 來設定 hostattachcos）。
  • on - 已啟用 PFC
lossless_system 此欄位顯示是否已針對系統資料流量啟用優先順序流程控制 (PFC)。如果未啟用 PFC ，則會顯示原因。值如下：
  • 空白 - 未配置 IP。
  • off-vlan_not_configured - 未配置 vlan。
  • off-priority_tag_not_enabled_on_switch - 未在交換器上啟用 priority 標籤（使用 chsystemethernet 來設定 systemcos）。
  • on - 已啟用 PFC
lossless_storage 此欄位顯示是否已針對 IPv4 上的儲存體資料流量啟用優先順序流程控制 (PFC)。如果未啟用 PFC ，則會顯示原因。值如下：
  • 空白 - 未配置 IP。
  • off-host_flag_disabled - 未設定 storage 旗標。
  • off-vlan_not_configured - 未配置 vlan。
  • off-priority_tag_not_enabled_on_switch - 未在交換器上啟用 priority 標籤（使用 chsystemethernet 來設定 storagecos）。
  • on - 已啟用 PFC
lossless_storage6 此欄位顯示是否已針對 IPv6 上的儲存體資料流量啟用優先順序流程控制 (PFC)。如果未啟用 PFC ，則會顯示原因。值如下：
  • 空白 - 未配置 IP。
  • off-host_flag_disabled - 未設定 storage6 旗標。
  • off-vlan_not_configured - 未配置 vlan。
  • off-priority_tag_not_enabled_on_switch - 未在交換器上啟用 priority 標籤（使用 chsystemethernet 來設定 storagecos）。
  • on - 已啟用 PFC
is_rdma_clustering 此欄位顯示此乙太網路埠是否已配置成使用 RDMA 系統節點至節點連線。值為 yes、no 或空白。

在下列範例中（其中列出不同埠配置選項），每個可能的乙太網路埠有兩行，分別代表埠和 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  is_rdma_clustering
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
  
lossless_host_attach on
lossless_host_attach6
lossless_system
lossless_storage on
lossless_storage6
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

is_rdma_clustering

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
 
lossless_host_attach on
lossless_host_attach6
lossless_system
lossless_storage on
lossless_storage6
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

is_rdma_clustering

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
 
lossless_host_attach on
lossless_host_attach6
lossless_system
lossless_storage on
lossless_storage6
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

is_rdma_clustering

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
 
lossless_host_attach
lossless_host_attach6
lossless_system
lossless_storagelossless_storage6
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

is_rdma_clustering

埠 1（1 Gb 埠，不支援 DCBx）的呼叫範例。 

lsportip 1

產生的輸出（並未顯示所有欄位）： 

node_id 3
...
host yes
remote_copy 1
host_6
...
vlanvlan_6
adapter_location 0
adapter_port_id 2
dcbx_state unsupported   <------ for 1G ports DCBx is not supported
lossless_host_attach off
lossless_host_attach6
lossless_system off
lossless_storage off
lossless_storage6
storage no
storage_6host_port_grp_id 1
rdma_type
is_rdma_clustering

埠 5（25 Gb 埠，且已啟用 DCBx）的呼叫範例。主機連接優先順序標籤設定為 4。系統優先順序標籤設定為 5。儲存體優先順序標籤設定為 6。

lsportip 5

產生的輸出（並未顯示所有欄位）： 

node_id 3
node_name node1
IP_address 10.39.5.1
...
host yes    <------- host flag is set
remote_copy 1
host_6
...
vlan   <------ VLAN is not configured
vlan_6
adapter_location 0
adapter_port_id 2
dcbx_state supported
lossless_host_attach on <------ VLAN is configured, host flag is set, and PFC for tag 4 (host attach cos) is enabled.
lossless_host_attach6
lossless_system on      <----- Node IP is configured over VLAN and PFC for tag 5 (system cos) is enabled. 
lossless_storage on     <----- VLAN is configured, Storage flag is set, and PFC for tag 6 (storage cos) is enabled 
lossless_storage6
fcoe_priority_tag  3 
pfc_enabled_tags 4:5:6 
...
storage yes <------- Storage flag is set
storage_6host_port_grp_id 1
rdma_type
is_rdma_clustering

埠 5（25 Gb 埠，且已啟用 DCBx）的呼叫範例。主機連接優先順序標籤設定為 4。系統優先順序標籤設定為 5。儲存體優先順序標籤設定為 6。

lsportip 5

產生的輸出（並未顯示所有欄位）： 

node_id 3
node_name node1
IP_address 10.39.5.1
...
host yes    <------- host flag is set
remote_copy 1
host_6
...
vlan    <------ VLAN is not configured
vlan_6
adapter_location 0
adapter_port_id 2
dcbx_state supported
lossless_host_attach off-enable-vlan <------ host flag is set, priority for tag 4
                                                 (host attach cos) is enabled, but VLAN
                                                 is not configured
lossless_host_attach6
lossless_system off-enable-vlan      <----- Node IP is configured but not over VLAN, 
                                                therefore lossless_system is off. 
lossless_storage off-enable-vlan     <----- Storage flag is set, PFC for tag 6 (storage
                                                cos) is enabled, but VLAN is not configured.
                                                Therefore lossless_storage is off.
lossless_storage6
fcoe_priority_tag  3 
pfc_enabled_tags 4:5:6 
...
storage yes <------- Storage flag is set
storage_6host_port_grp_id 1
rdma_type
is_rdma_clustering