cfgportip

使用 cfgportip 命令可向因特网小型计算机系统接口 (iSCSI) 输入/输出 (I/O) 的每个节点以太网端口分配因特网协议 (IP) 地址。

语法

对于因特网协议 V4 (IPv4) 和因特网协议 V6 (IPv6):

cfgportip -node { node_name | node_id } { -ipipv4addr-masksubnet_mask-gwipv4gw | -ip_6ipv6addrprefix_6prefix-gw_6ipv6gw } [ -failover ] { [ -host { yes | no } ] | [ -host_6 { yes | no } ] } { [ -remotecopyremote_copy_port_group_id ] | [ -remotecopy_6remote_copy_port_group_id ] } { [ -vlan vlan_id_ip4 ] | [ -novlan ] } { [ -vlan_6 vlanid_ip6 ] | [ -novlan_6 ] } { [ -storage { yes | no } ] | [ -storage_6 { yes | no } ] } [ -force ] port_id

对于最大传输单元 (MTU):

cfgportip { -mtu { mtu } | -defaultmtu } [ -iogrp { io_grp_id | io_grp_name } ] port_id

参数

-nodenode_name | node_id
(必需)指定哪个节点具有要分配 IP 地址的以太网端口。
Note: 设置端口 IP 地址需要使用该参数。 它不能与 -mtu 参数一起使用。
-ipipv4addr
(必需)为以太网端口设置因特网协议 V4 (IPv4) 地址。 不能将该参数与 ip_6 参数一起使用。
-ip_6ipv6addr
(必需)为以太网端口设置因特网协议 V6 (IPv6) 地址。 不能将该参数与 ip 参数一起使用。
-gwipv4addr
(必需)设置 IPv4 网关 IP 地址。 不能将该参数与 gw_6 参数一起使用。
-gw_6ipv6gw
(必需)设置端口的 IPv6 缺省网关地址。 不能将该参数与 gw 参数一起使用。
-masksubnet_mask
(必需)设置 IPv4 子网掩码。 不能将该参数与 prefix_6 参数一起使用。
-prefix_6prefix
(必需)设置 IPv6 前缀。 不能将该参数与 mask 参数一起使用。
-failover
(可选)指定属于 I/O 组中伙伴节点的 IP 地址。 如果未配置伙伴节点或伙伴节点处于脱机状态,那么由该节点配置和提供地址。 当 I/O 组中的另一个节点联机时,将由该节点提供故障转移地址。

如果伙伴节点处于联机状态,请勿使用该选项。

-mtu mtu | -defaultmtu
(必需)指定最大传输单元 (MTU)。 缺省值为 1500,最大值为 9000。 如果 MTU 为 9000,那么对于大小为 4KB 以及更大的包,可以节省 CPU 使用量。 增加的 MTU 可以帮助您改进小型计算机系统接口(iSCSI)性能。 指定 -defaultmtu 使用缺省值。
注释: 此参数具有以下限制:
  • 必须在设置或更改系统 MTU 值时使用此参数。
  • 此参数不能与 -node 参数一起使用。
-iogrp iogrp
(可选)指定包含要修改的节点的 I/O 组。
-hostyes | no
(可选)指定主机连接使用的 IPv4 地址(同时保留现有的系统设置)。 指定:
  • yes,目标发现期间报告主机的 IPv4 地址(缺省值)
  • no,关闭此报告(主机发现期间不报告 IPv4 地址)。
-remotecopyremote_copy_port_group_id
(可选)指定用于远程拷贝功能的 IPv4 地址。 远程拷贝包括 高速镜像和全局镜像。 它还指定关联端口组的标识。 这些标识为数字值(012),用于指定系统上的 IP 地址可以作为登录伙伴关系的一部分。 要构成登录,IP 地址必须在相同的端口组中。 缺省值为 0,这指示该端口不适用于伙伴关系。
Important: 要在复制组中添加或删除端口,请确保使用该端口组的伙伴关系处于停止状态。
-host_6yes | no
(可选)指定主机连接使用的 IPv6 地址(同时保留现有的系统设置)。 指定:
  • yes,目标发现期间报告主机的 IPv6 地址(缺省值)。
  • no,关闭此报告(主机发现期间不报告 IPv6 地址)。
Note: 关闭已设置为 yes 的 IP 地址的主机连接设置是一个中断性过程,因为该 IP 地址的所有主机 iSCSI 会话都会被注销。
-remotecopy_6remote_copy_port_group_id
(可选)指定用于远程拷贝功能的 IPv6 地址。 远程拷贝包括 高速镜像和全局镜像。 它还指定关联端口组的标识。 这些标识为数字值(012),用于指定系统上的 IP 地址可以作为登录伙伴关系的一部分。 要构成登录,IP 地址必须在相同的端口组中。 缺省值为 0,这指示该端口不适用于伙伴关系。
Important: 要在复制组中添加或删除端口,请确保使用该端口组的伙伴关系处于停止状态。
-vlanvlanid_ip4
(可选)针对为 iSCSI 主机连接或远程拷贝功能配置的 IPv4 地址,设置虚拟局域网 (VLAN) 标识。 远程拷贝包括 高速镜像和全局镜像。 只有设置了端口的 IP 地址时,才能够指定 IPv4 类型地址的 VLAN 标识。 针对所有 IP 地址都禁用了 VLAN 标记,因此必须使用 -vlan 指定 VLAN 标识,以开启 VLAN 标记。
Remember: 请慎用 -vlan。 您可以:
  • 重置 VLAN 设置,这可能会中断端口与主机或系统的通信(连接),包括重置活动 iSCSI 或 IP 伙伴关系的 VLAN 标识
  • 对不具有 VLAN 标记或不具有已配置的 IP 地址的端口重置 VLAN 值

可以使用 -failover 属性为故障诊断端口设置 VLAN 标识。

-novlan
(可选)禁用以太网端口的 IPv4 地址的 VLAN 标记(这意味着没有任何 VLAN 标记与该端口关联)。
-vlan_6 vlanid_ip6
(可选)针对为 iSCSI 主机连接或远程拷贝功能配置的 IPv6 地址,设置虚拟局域网 (VLAN) 标识。 远程拷贝包括 高速镜像和全局镜像。 只有设置了端口的 IP 地址时,才能够指定 IPv6 类型地址的 VLAN 标识。 针对所有 IP 地址都禁用了 VLAN 标记,因此必须使用 -vlan 指定 VLAN 标识,以开启 VLAN 标记。
Remember: 请慎用 -vlan_6
  • 重新设置 VLAN 设置可能会中断端口与主机或系统的通信(连接),包括重新设置活动 iSCSI 或 IP 伙伴关系的 VLAN 标识。
  • 可以对不具有 VLAN 标记或不具有已配置的 IP 地址的端口重置 VLAN 标记。

可以使用 -failover 属性为故障诊断端口设置 VLAN 标识。

-novlan_6
(可选)禁用以太网端口的 IPv6 地址的虚拟局域网 (VLAN) 标记(这意味着没有任何 VLAN 标记与该端口关联)。
Remember: 请慎用 -novlan_6
  • 重新设置 VLAN 设置可能会中断端口与主机或系统的通信(连接),包括重新设置活动 iSCSI 或 IP 伙伴关系的 VLAN 标识。
  • 可以对不具有 VLAN 标记或不具有已配置的 IP 地址的端口重置 VLAN 标记。
-storageyes | no
(可选)指定是否可将 IPv4 地址用于后端存储器连接功能。 yes 值指示可将此 IPv4 地址用于发现 iSCSI 目标和 连接后端存储器。 如果您未使用存储器连接 IP 地址,那么必须指定 no(缺省值)。 如果更改了与特定端口(节点上)关联的 IPv4 地址,那么将保留现有存储器连接设置。 值为 yesno
-storage_6yes | no
(可选)指定是否可将 IPv6 地址用于后端存储器连接功能。 yes 值(缺省值)指示可将此 IPv6 地址用于发现 iSCSI 目标和连接后端存储器。 如果您未使用存储器连接 IP 地址,那么必须指定 no。 如果更改了与特定端口(节点上)关联的 IPv6 地址,那么将保留现有存储器连接设置。 值为 yesno
-force
(可选)即使节点以太网端口的 IP 地址更改会导致移除 iSCSI 后端控制器或者使 MDisk 进入降级或脱机状态,也会 强制执行此类更改。
Important: 很少使用 force 属性以避免失去节点或 MDisk 访问权。

更改 IP 地址属性可能使 MDisk 进入降级状态一段时间。 如果正在使用源 IP 地址进行 iSCSI 后端控制器连接,那么更改 IP 地址、子网掩码或 IP 网关会移除现有会话并建立新会话。 在此期间,通过重新配置的源端口显示的 Mdisk 将短暂进入降级状态,直至建立新会话为止。

如果您了解所有相关风险,那么可以使用 -force 标志来继续重新配置。 如果您不确定可能发生什么,那么仅在支持人员的指导下使用 force 属性。

如果要在系统中添加新的 I/O 组,您可能会看到消息 CMMVC8915E。 在新的 I/O 组上配置 iSCSI IP 地址时,请确保将该 IP 地址分配给未配置的端口,并对 IP 分配使用 -force 标志。

port_id
(必需)指定要应用更改的端口(1234)。
Remember: 所有端口都可以用作 I/O 操作的专用管理端口。

描述

cfgportip 命令设置 iSCSI 以太网端口的 IP 地址,或配置一组端口的 MTU。 此命令会将 IPv4 或 IPv6 地址分配给节点的指定以太网端口。 IP 地址用于 iSCSI I/O。请使用 chsystemip 命令分配集群系统 IP 地址。

Remember: 当使用相同的远程复制端口组标识(用于冗余)为 I/O 组的各节点配置 IP 地址时,请确保在配置期间对两个节点使用相同的以太网端口。 使用对称的以太网端口从相同的 I/O 组设置 MTU。 为确保备用远程复制端口组均使用相同的 MTU 设置,必须为远程复制端口组配置对称以太网端口。

对于 IPv4 地址,ipmaskgw 参数是必需的。 必须指定所有 IPv4 IP 参数,才能为以太网端口分配 IPv4 地址。

对于 IPv6 地址,ip_6prefix_6gw_6 参数是必需的。 必须指定所有 IPv6 IP 参数,才能为以太网端口分配 IPv6 地址。

如果为主机指定了 IP 地址,那么主机可使用 iSNS 服务器(或诸如 SendTargets 等其他发现机制)发现指定端口。 这些 IP 地址未报告给伙伴系统,以创建用于远程拷贝的 TCP 会话。 这些端口也无法用于登录,以及对后端 iSCSI 存储控制器执行基于 SendTargets 的发现。

主机无法发现为远程拷贝指定的 IP 地址,这意味着它们无法用于主机连接。 这些端口不会报告给伙伴系统,以创建用于远程拷贝的 TCP 会话。 这些端口也无法用于登录,以及在考虑发现后端 iSCSI 存储控制器时用于 SendTargets。

在 IP 配置后,会将 host_port_group_id 自动分配给 iSCSI 端口。 主机端口分组会将具有相同速度的端口分组在一起,并确保主机发现的端口不超过 4 个。 其他 host_port_group_id 条件包括:
  • host_port_group_id 是用整数指定的自动端口分组。 主机端口组标识在 I/O 组之间是唯一的。
  • 每个主机端口组标识最多包含 4 个端口。
  • 一个主机端口组标识中的所有端口都具有相同速度。
  • 将相同主机端口组标识分配给故障转移端口。 如果已将 host_port_group_id 分配给故障转移端口,那么会将相同的 host_port_group_id 分配给本地端口。
  • 启用 -host 标志为 yes 将分配 host_port_group_id。 如果在 host 标志为 no 的端口上,host 标志设置为 yes,那么会将 host_port_group_id 分配给端口。
  • 禁用标志为 no 将移除与 iSCSI 端口相关联的主机端口组标识。

主机无法发现为存储器指定的 IP 地址,这意味着它无法用于主机连接。 这些 IP 地址未报告给伙伴系统,以创建和设置用于远程拷贝的 TCP 会话。

要将相同的 IP 地址用于主机 I/O 和后端存储器连接功能(但不用于远程拷贝):
  • 必须将 -host 参数设置为 yes
  • 必须将 -storage 参数设置为 yes
  • 必须将 -remotecopy 参数设置为 no
在这些实例中,主机可发现这些 IP 地址。 这些 IP 地址还可用于发现后端存储控制器和登录,以便进行基于 iSCSI 的迁移和虚拟化。
要将相同的 IP 地址用于后端存储器连接功能和远程拷贝功能(但不用于主机 I/O 操作):
  • 必须将 -storage 参数设置为 yes
  • 必须使用必需的远程拷贝端口组标识指定 -remotecopy 参数。
  • 必须将 -host 参数设置为 no
在这些情况下,这些 IP 地址可用于发现和连接到后端 iSCSI 存储控制器。 这些 IP 地址还可用于基于 IP 的远程拷贝。
要将相同的 IP 地址用于主机 I/O 和远程拷贝功能(但不用于后端存储器连接功能):
  • 必须将 -host 参数设置为 yes
  • 必须使用必需的远程拷贝端口组标识调用 -remotecopy 参数。
  • 必须将 -storage 参数设置为 no
在这些情况下,主机可发现这些 IP 地址,以及将其用于基于 IP 的远程拷贝,但不能用于后端存储器连接。

使用具有可选 ethernet_port_id 参数的 lsportip 命令,列出指定端口的端口 IP 地址。

Remember:

如果使用 cfgportip 来修改与特定以太网端口关联的 IP 地址而不指定新的 VLAN 标识,那么新的(修改后的)IP 地址将继承先前 IP 地址(IPv4 或 IPv6)的现有 VLAN 标识设置。

IPv4 调用示例

cfgportip -node 1  -ip 9.8.7.1 -gw 9.0.0.1 -mask 255.255.255.0 1

生成的输出:

No feedback

IPv6 调用示例

cfgportip -node 1  -ip_6 3:3:0:4::0  -gw_6 ffe8::0  -prefix_6 64 2

生成的输出:

No feedback

在 I/O 组 0 中的端口 1 上将 MTU 设置为 1600 的调用示例

cfgportip  –mtu 1600 -iogrp 0 1

生成的输出:

No feedback

将 MTU 设置为缺省值的调用示例

cfgportip  –defaultmtu -iogrp 0 1

生成的输出:

No feedback

配置新的 IPv4 地址执行基于 IP 的复制的调用示例

cfgportip -node 1 -ip 9.8.7.1 -gw 9.0.0.1 -mask 255.255.255.0 –remotecopy 1 –host no -host_6 no 1

生成的输出:

No feedback

配置新的 IPv4 地址执行主机连接的调用示例

cfgportip -node 1 -ip 9.8.7.1 -gw 9.0.0.1 -mask 255.255.255.0 –host yes 1

生成的输出:

No feedback

配置对现有 IPv6 地址的复制的调用示例

cfgportip -node 1 –remotecopy_6 2 1

生成的输出:

No feedback

配置对新 IPv6 地址的主机连接的调用示例

cfgportip -node 1 –ip_6 2001:db8::1:0:0:1 –host_6 yes 1

生成的输出:

No feedback

使用 VLAN 标识 105 配置新 IPv4 地址的调用示例

cfgportip -node 1 -ip 9.8.7.1 -gw 9.0.0.1 -mask 255.255.255.0 –vlan 105 1

生成的输出:

No feedback

使用 VLAN 标识 1063 配置新 IPv6 地址的调用示例

cfgportip -node 1 -ip_6 2001:db8::1:0:0:101 -prefix_6 64 -gw_6 2001:db8::1:0:0:1 -vlan_6 1063 1

生成的输出:

No feedback

使用 iSCSI 为后端存储器连接功能配置新 IPv4 地址的调用示例

cfgportip -node 1 -ip 9.8.7.1 -gw 9.0.0.1 -mask 255.255.255.0 –storage yes -remotecopy 0 –host no 1
cfgportip -node 1 -ip 9.8.7.1 -gw 9.0.0.1 -mask 255.255.255.0 –storage yes –host no 1

生成的输出:

No feedback

配置新 IPv4 地址仅执行主机连接的调用示例

cfgportip -node 1 -ip 9.8.7.1 -gw 9.0.0.1 -mask 255.255.255.0 –host yes -storage no 1
cfgportip -node 1 -ip 9.8.7.1 -gw 9.0.0.1 -mask 255.255.255.0 –host yes -storage no -remotecopy 0 1
cfgportip -node 1  -ip 9.8.7.1 -gw 9.0.0.1 -mask 255.255.255.0 1

生成的输出:

No feedback

配置新 IPv4 地址执行基于 IP 的复制的调用示例

cfgportip -node 1 -ip 9.8.7.1 -gw 9.0.0.1 -mask 255.255.255.0 -storage no –remotecopy 1 –host no 1

生成的输出:

No feedback

为新 IPv6 地址配置存储器连接功能的调用示例

cfgportip -node 1 –ip_6 2001:db8::1:0:0:1 –storage_6 yes 1
cfgportip -node 1 –ip_6 2001:db8::1:0:0:1 1

生成的输出:

No feedback

为现有 IPv6 地址更改存储器规范的调用示例

cfgportip -node 1 –storage_6 no 1
cfgportip -node 1 –storage_6 yes 1

生成的输出:

No feedback