Use the cfgportip command to assign
an Internet Protocol (IP) address to each node
Ethernet port for Internet Small Computer System Interface (iSCSI)
input/output (I/O).
Syntax
For Internet
Protocol Version 4 (IPv4) and Internet Protocol Version 6 (IPv6):
cfgportip -node { node_name | node_id } { -ip ipv4addr -mask subnet_mask -gw ipv4gw | -ip_6 ipv6addr prefix_6 prefix -gw_6 ipv6gw } [ -failover ] { [ -host { yes | no } ] | [ -host_6 { yes | no } ] } { [ -remotecopy remote_copy_port_group_id ] | [ -remotecopy_6 remote_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
For maximum transmission unit (MTU):
cfgportip { -mtu { mtu } | -defaultmtu } [ -iogrp { io_grp_id | io_grp_name } ] port_id
Parameters
- -nodenode_name | node_id
- (Required) Specifies which node has the Ethernet port that the
IP address is being assigned to.
Note: This parameter
is required for setting a port IP address. It cannot be used with
the -mtu parameter.
- -ipipv4addr
- (Required) Sets the Internet
Protocol Version 4 (IPv4) address for the Ethernet port. You
cannot use this parameter with the ip_6 parameter.
- -ip_6ipv6addr
- (Required) Sets the Internet
Protocol Version 6 (IPv6) address for the Ethernet port. You
cannot use this parameter with the ip parameter.
- -gwipv4addr
- (Required) Sets the IPv4 gateway IP address.
You cannot use this parameter with the gw_6 parameter.
- -gw_6ipv6gw
- (Required) Sets the IPv6 default gateway
address for the port. You cannot use this parameter with the gw parameter.
- -masksubnet_mask
- (Required) Sets the IPv4 subnet mask. You
cannot use this parameter with the prefix_6 parameter.
- -prefix_6prefix
- (Required) Sets the IPv6 prefix. You cannot
use this parameter with the mask parameter.
- -failover
- (Optional) Specifies that the IP address belongs
to the partner node in the I/O group. If the partner node is not configured
or offline, the address is configured and presented by this node.
When another node comes online in the I/O group, the failover address
is presented by that node.
If the partner node is
online, do not use this option.
- -mtu mtu | -defaultmtu
- (Required) Specifies the maximum transmission unit (MTU). The default is 1500, with a maximum of
9000. An MTU of 9000 allows you to save CPU utilization for packets of 4 KB and over in size. The
increased MTU provides you with improved Internet Small Computer System Interface (iSCSI)
performance. Specify -defaultmtu to use the default value.
Note: This parameter:
- Must be used when you are setting the clustered system (system) MTU This parameter
- Cannot be used with the -node parameter
- -iogrpiogrp
- (Optional) Specifies the I/O group
that contains the nodes to modify.
- -hostyes | no
- (Optional) Specifies the IPv4 address that is used for host attach
(the existing system settings are retained). Specifying:
- yes reports the IPv4 address to hosts during
target discovery (default)
- no turns off this report (IPv4 addresses are
not reported during host discovery).
- -remotecopyremote_copy_port_group_id
- (Optional) Specifies the IPv4
address that is used for the remote copy function. Remote
copy includes Metro Mirror, Global Mirror, and HyperSwap®. It also specifies
the ID for the associated port group. These IDs are numerical values (0,
1, or 2) that specify that IP addresses on a system can be part of
a partnership for a login. To form a login, IP addresses must be in the same port group. The default
is 0, which indicates that the port is not available for partnerships.
Important: To add or delete ports to or from a replication group, make sure the partnership
that uses that port group is in a stopped state.
- -host_6yes | no
- (Optional) Specifies the IPv6 address that is used for host attach
(the existing system settings are retained). Specifying:
- yes reports the IPv6 address to hosts during
target discovery (default).
- no turns off this report (IPv6 addresses are
not reported during host discovery).
Note: Turning off host attach settings for an IP address that
is set to yes is disruptive because all host iSCSI
sessions to that IP address are logged out.
- -remotecopy_6remote_copy_port_group_id
- (Optional) Specifies the IPv6
address that is used for the remote copy function. Remote
copy includes Metro Mirror, Global Mirror, and HyperSwap®. It also specifies
the ID for the associated port group. These IDs are numerical values (0,
1, or 2) that specify that IP addresses on a system can be part of
a partnership for a login. To form a login, IP addresses must be in the same port group. The default
is 0, which indicates that the port is not available for partnerships.
Important: To add or delete ports to or from a replication group, make sure the partnership
that uses that port group is in a stopped state.
- -vlanvlanid_ip4
- (Optional) Sets the virtual local area network (VLAN) ID for a IPv4 address that is configured
for iSCSI host attach or remote copy function. Remote
copy includes Metro Mirror, Global Mirror, and HyperSwap®. The VLAN ID for an
IPv4 type address can be specified only if the IP address for that port is set. VLAN tagging is
disabled for any IP address, so a VLAN ID must be specified by using -vlan to
turn on VLAN tagging.
Remember: Use
-vlan with caution. You can:
- Reset VLAN settings, which can disrupt port communication (connection) with hosts or systems
(including resetting the VLAN ID for an active iSCSI or IP partnership)
- Reset a VLAN value for a port that does not have VLAN tagging or does not have a configured IP
address
The VLAN ID can be set for the failover port that uses the
-failover attribute.
- -novlan
- (Optional) Disables VLAN tagging for an IPv4 address for an Ethernet
port (which means no VLAN tag is associated with that port).
- -vlan_6vlanid_ip6
- (Optional) Sets the virtual local area network (VLAN) ID for a IPv4 address that is configured
for iSCSI host attach or remote copy function. Remote
copy includes Metro Mirror, Global Mirror, and HyperSwap®. The VLAN ID for an
IPv6 type address can be specified only if the IP address for that port is set. VLAN tagging is
disabled for any IP address, so a VLAN ID must be specified by using -vlan to
turn on VLAN tagging.
Remember: Use
-vlan with caution:
- Resetting VLAN settings can disrupt port communication (connection) with hosts or systems,
including resetting the VLAN ID for an active iSCSI or IP partnership.
- You can reset a VLAN tag for a port that does not have VLAN tagging or does not have a
configured IP address.
The VLAN ID can be set for the failover port by using the
-failover attribute.
- -novlan_6
- (Optional) Disables Virtual local area network (VLAN) tagging
for an IPv6 address for an Ethernet port (which means no VLAN tag
is associated with that port).
Remember: Use
-novlan_6 with
caution:
- Resetting VLAN settings can disrupt port communication (connection)
with hosts or systems, including resetting the VLAN ID for an active
iSCSI or IP partnership.
- You can reset a VLAN tag for a port that does not have VLAN tagging
or does not have a configured IP address.
- -storageyes | no
- (Optional) Specifies whether an IPv4 address can be used for the backend storage attach
function. The value yes indicates that this IPv4 address can be used for iSCSI
target discovery and backend storage connectivity. You must specify no (default)
if you are not using the storage attach IP address. If the IPv4 address associated with a specific
port (on a node) is changed, the existing storage attach settings are retained. The values are
yes and no.
- -storage_6yes | no
- (Optional) Specifies whether an IPv6 address can be used for the backend storage attach
function. The value yes (the default) indicates that this IPv6 address can be
used for iSCSI target discovery and backend storage connectivity. You must specify no if you are not using a storage attach IP address. If the IPv6 address associated with a specific port (on a node) is changed, the existing storage attach settings are retained. The values are yes
and no.
- -force
- (Optional) Forces an IP address change for a node Ethernet port even if this causes backend
controllers being removed or MDisks going into a degraded or offline state.
Important: Using the force parameter might result in a loss of access. Use it only under the direction of your
product support information.
- port_id
- (Required) Specifies which port (1, 2,
3, or 4) to apply changes to.
Description
The cfgportip command either sets the
IP address of an Ethernet port for iSCSI, or configures the MTU of
a group of ports. This command assigns either an IPv4 or IPv6
address to a specified Ethernet port of a node. The IP address is
used for iSCSI I/O. Use the chsystemip command
to assign clustered system IP addresses.
Remember: When
IP addresses are configured with the same remote replication port
group ID (for redundancy) to each node of an I/O group, make sure
that the same Ethernet port for both nodes is used during configuration.
MTU is set by using symmetric Ethernet ports from the same I/O group.
To make sure alternative remote replication port groups work with
the same MTU settings, symmetric Ethernet ports must be configured
for remote replication port groups.
For an IPv4 address,
the ip, mask, and gw parameters
are required. All of the IPv4 IP parameters must be specified to assign
an IPv4 address to an Ethernet port.
For an IPv6 address, the ip_6, prefix_6,
and gw_6 parameters are required. All of the
IPv6 IP parameters must be specified to assign an IPv6 address to
an Ethernet port.
If an IP address is specified for a host, the specified
port can be discovered by hosts using the iSNS server (or other discovery mechanisms such as
SendTargets). These IP addresses are not reported to partner systems in order to create TCP sessions
that are used for remote copy. These ports also cannot be used for login to and SendTargets based
discovery of backend iSCSI Storage controllers.
IP addresses that are specified for remote copy cannot
be discovered by hosts, which means they cannot be used for host attachment. These ports are not
reported to partner systems in order to create TCP sessions for remote copy. These ports also cannot
be used to login to and for SendTargets when considering discovery of backend iSCSI Storage
controllers.
IP addresses that
are specified for storage cannot be discovered by hosts, which means they cannot be used for host
attachment. These IP addresses are not reported to partner systems to create and set up TCP sessions
for remote copy.
To use the same IP
address for both host I/O and backend storage attach functions (but not for remote copy):
- The -host parameter must be set to yes.
- The -storage parameter must be set to yes.
- The -remotecopy parameter must be set to no.
In these instances, these IP addresses can be discovered by hosts. These IP addresses can also
be used for backend storage controller discovery and login for iSCSI based migration and
virtualization.
To use the same IP
address for both backend storage attach functions and remote copy functions (but not for host I/O
operations):
- The -storage parameter must be set to yes.
- The -remotecopy parameter must be specified with the required remote copy
port group ID.
- The -host parameter must be set to no.
In such cases, these IP addresses can be used to discover and connect to backend iSCSI storage
controllers. These IP addresses can also be used for IP-based remote copy.
To use the same IP
address for both host I/O and remote copy functions (but not for backend storage attach functions):
- The -host parameter must be set to yes.
- The -remotecopy parameter must be invoked with the required remote copy
port group ID.
- The -storage parameter must be set to no.
In such cases, these IP addresses can be discovered by hosts as well as used for IP-based
Remote Copy but not for backend storage attach.
Use the lsportip command
with the optional ethernet_port_id parameter
to list the port IP addresses for the specified port.
Remember: If cfgportip is used to modify the IP address that is associated with a
specific Ethernet port without specifying a new VLAN ID, the new (modified) IP address inherits the
existing VLAN ID setting of the earlier IP address (IPv4 or IPv6).
An invocation example for IPv4
cfgportip -node 1 -ip 9.8.7.1 -gw 9.0.0.1 -mask 255.255.255.0 1
The
resulting output:
No feedback
An invocation example for IPv6
cfgportip -node 1 -ip_6 3:3:0:4::0 -gw_6 ffe8::0 -prefix_6 64 2
The
resulting output:
No feedback
An invocation example to set an MTU of 1600 on
port 1 in I/O group 0
cfgportip –mtu 1600 -iogrp 0 1
The
resulting output:
No feedback
An invocation example to set the MTU to its default
value
cfgportip –defaultmtu -iogrp 0 1
The
resulting output:
No feedback
An invocation example configuring a new IPv4 address
for IP-based replication
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
The
resulting output:
No feedback
An invocation example configuring a new IPv4 address
for host attach
cfgportip -node 1 -ip 9.8.7.1 -gw 9.0.0.1 -mask 255.255.255.0 –host yes 1
The
resulting output:
No feedback
An invocation example configuring replication
for an existing IPv6 address
cfgportip -node 1 –remotecopy_6 2 1
The
resulting output:
No feedback
An invocation example configuring host attach
for a new IPv6 address
cfgportip -node 1 –ip_6 2001:db8::1:0:0:1 –host_6 yes 1
The
resulting output:
No feedback
An invocation example configuring a new IPv4 address with the VLAN ID
105
cfgportip -node 1 -ip 9.8.7.1 -gw 9.0.0.1 -mask 255.255.255.0 –vlan 105 1
The
resulting output:
No feedback
An invocation example for configuring a new IPv6 address with the VLAN ID
1063
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
The
resulting output:
No feedback
An invocation example for configuring a new IPv4 address for the backend storage attach
function using iSCSI
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
The resulting output:
No feedback
An invocation example for configuring a new IPv4 address for host attach only
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
The resulting output:
No feedback
An invocation example for configuring a new IPv4 address for IP-based replication
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
The resulting output:
No feedback
An invocation example for configuring the storage attach function for a new IPv6
address
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
The resulting output:
No feedback
An invocation example for changing the storage specification for an existing IPv6
address
cfgportip -node 1 –storage_6 no 1
cfgportip -node 1 –storage_6 yes 1
The resulting output:
No feedback