lsportip
使用 lsportip 命令列出 IBM Spectrum Virtualize™ 系统中每个节点上的每个以太网端口的配置。该命令显示了因特网协议 (IP) 地址和是否将此端口配置为一个因特网小型计算机系统接口 (iSCSI) 端口。
语法
>>- lsportip -- --+-----------------------------------+-- ------> '- -filtervalue -- attribute=value -' >--+-----------------+-- --+----------+-- ----------------------> '- -filtervalue? -' '- -nohdr -' >--+-----------------------+-- --+--------------------+-- ----->< '- -delim -- delimiter -' '- ethernet_port_id -'
参数
- -filtervalue attribute=value
- (可选)指定一个或多个过滤器的列表。 仅返回值与过滤器属性值匹配的对象。 如果指定了容量,那么还必须包含单位。
- 注: 某些过滤器允许您在输入命令时使用通配符。 以下规则适用于将通配符用于 IBM Spectrum Virtualize CLI 的情况:
- 通配符为星号 (*)。
- 命令最多可包含一个通配符,并且该通配符必须是字符串中的第一个或最后一个字符。
- 使用通配符时,请将过滤器条目用双引号 ("") 引起来,如下所示:
lsportip -filtervalue "node_name=md*"
- -filtervalue?
- (可选)显示有效的过滤器属性。 lsporti 命令的以下过滤器属性有效:
- id
- node_id
- node_name
- state
- failover
- -nohdr
- (可选)缺省情况下,将在简明样式视图中显示每个数据列的标题,在详细样式视图中显示每个数据项的标题。 -nohdr 参数用于禁止显示这些标题。注: 如果没有要显示的数据,那么不会显示标题。
- -delim delimiter
- (可选)缺省情况下,简明视图中的所有数据列都以空格分隔。 每列的宽度设置为每个数据项的最大宽度。 在详细视图中,每个数据项各占一行,如果显示标题,将用空格来分隔数据与标题。 -delim 参数会覆盖此行为。 -delim 参数的有效输入为一个单字节字符。 如果在命令行中输入 -delim :,那么在简明视图中将用冒号字符 (:) 分隔所有数据项;例如,不会出现列间距。 在详细视图中,数据与标题间以指定的定界符分隔。
- ethernet_port_id
- (可选)指定以太网端口的标识(1、2、3 或 4)。 如果省略该参数,那么将显示所有端口的简明视图。 使用该参数时,将返回指定对象的详细视图,并忽略 -filtervalue 参数指定的任何值。 如果不使用 ethernet_port_id 参数,那么简明视图将显示与 -filtervalue 参数指定的过滤要求相符的所有端口。
描述
此命令可列出 IBM Spectrum Virtualize 系统中每个节点的以太网端口的配置。
使用带有可选 ethernet_port_id 参数的 lsportip 命令可显示指定端口的详细视图。
一个端口的输出行显示可确定的该端口的 MAC 地址。如果节点和以太网链路处于联机状态,那么这两行还会显示此链路的速度和双工状态。 duplex 字段的值可以是 Half 或 Full,或者如果此节点处于脱机状态,那么该字段将为空白。
每个端口的第四行均显示已为该端口配置且未故障转移到其他节点的任何 IP 地址。 该行上的 failover 字段设置为 no。每个端口的第二行均显示已为伙伴节点或带有故障转移的本地节点配置的且在该端口上处于活动状态的任何 iSCSI 地址。 该行上的 failover 字段设置为 yes。
如果该端口上没有配置任何 iSCSI 地址,那么 state 字段将设置为 unconfigured。 如果存在已配置的地址,但链路关闭,那么 state 字段将设置为 offline,如果链路打开,那么 state 字段将设置为 online。 任何脱机行均表明可能有问题。
此命令可显示有关系统端口状态的信息。
| 属性 | 描述 |
|---|---|
| id | 指示以太网端口的标识。 |
| node_id | 指示包含端口的节点的标识。 |
| node_name | 指示包含端口的节点的名称。 |
| IP address | 指示 IPv4 地址(如果未提供,那么显示为空白)。 |
| mask | 指示 IPv4 子网掩码(如果未提供,那么显示为空白)。 |
| gateway | 指示 IPv4 网关(如果未提供,那么显示为空白)。 |
| IP_address_6 | 指示 IPv6 地址(如果未提供,那么显示为空白)。 |
| prefix_6 | 指示 IPv6 前缀(如果未提供,那么显示为空白)。 |
| gateway_6 | 指示 IPv6 网关地址(如果未提供,那么显示为空白)。 |
| MAC | 指示当前的 MAC 地址(如果未知,那么显示为空白)。 |
| duplex | 指示端口当前的双工状态(如果未知,那么显示为空白)。 |
| state | 指示 iSCSI 地址的状态。 值可以是:
|
| link_state | 指示以太网端口的链路状态。 其值为 active 和 inactive。 |
| host | 显示用于主机连接的 IPv4 地址。 |
| remote_copy | 显示 IPv4 远程拷贝端口组标识。 远程拷贝包括高速镜像、全局镜像和 HyperSwap®。 |
| host_6 | 显示用于主机连接的 IPv6 地址。 |
| remote_copy_6 | 显示 IPv6 远程拷贝端口组标识。 远程拷贝包括高速镜像、全局镜像和 HyperSwap。 |
| remote_copy_status | 显示 IPv4 远程拷贝状态。 远程拷贝包括高速镜像、全局镜像和 HyperSwap。 |
| remote_copy_status_6 | 显示 IPv6 远程拷贝状态。 远程拷贝包括高速镜像、全局镜像和 HyperSwap。 |
| vlan | 显示与该端口上的 IPv4 地址关联的虚拟局域网 (VLAN) 标识(范围 1 到 4094 之间的数字字符)。 |
| vlan_6 | 显示与该端口上的 IPv6 地址关联的 VLAN 标识(1 到 4094 之间的数字字符)。 |
| adapter_location | 显示包含以太网端口的适配器的位置(从 0 到 8 的任何数字)。 其中,1 - 8 是 PCIe 扩展槽号,0 表示适配器属于主板一部分或者不在 PCIe 扩展槽中。 |
| adapter_port_id | 显示适配器中以太网端口的位置(从 1 到 4 的任何数字)。 |
| dcbx_state | 显示端口的 DCBx 状态。 值包括:
切记: 该字段被禁用或不受支持时,除 lossless_iscsi 和 lossless_iscsi6 之外的所有其他字段均为空白。
|
| iscsi_priority_tag | 显示已连接交换机端口上分配的因特网小型计算机系统接口 (iSCSI) 协议的数字优先级标记值。 该优先级值必须为 0 到 7 之间的数字,或为空白。 |
| 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 设置的一部分。 注: 如果还没有为网络上的任何优先级组分配特定带宽,那么该字段为空白。
|
| lossless_iscsi | 显示针对 iSCSI 因特网协议 V4 (IPv4) IP 地址启用 (on) 还是禁用 (off) PFC。 要设置为 on:
|
| lossless_iscsi6 | 显示针对 iSCSI 因特网协议 V6 (IPv6) IP 地址启用 (on) 还是禁用 (off) PFC。 要设置为 on:
|
| 存储 | 指示是否将 IPv4 地址用于 iSCSI 后端存储连接功能。 值为 yes 和 no(缺省值)。 如果未指定任何地址,那么该值为空。 |
| storage_6 | 指示是否将端口上的 IPv6 地址用于 iSCSI 后端存储连接功能。 值为 yes 和 no(缺省值)。 如果未指定任何地址,那么该值为空。 |
| host_port_grp_id | 在简明和详细视图中均指示主机端口组标识。 值为 0 和 1-32。 对于任何以太网端口,缺省值都为 0。 所有配置的主机连接端口都具有非零 host_port_grp_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
