Set controller host port properties

Contributors netapp-driley

The set controller hostPort command changes the network properties for the following types of host ports: iSCSI, iSER, NVMe over InfiniBand, and NVMe over RoCE. Property changes include IPv4 and IPv6 properties, port speed, and maximum frame payload.

Supported Arrays

This command applies to an individual E2800, E5700, EF600 or EF300 storage array. It does not operate on E2700 or E5600 storage arrays.

Roles

To execute this command on an E2800, E5700, EF600, or EF300 storage array, you must have the Storage Admin or Support Admin role.

Context

Note

This command replaces the deprecated Set iSCSI host port networking properties command.

Syntax

set controller [(a|b)] hostPort ["portLabel"[, "physical"|"virtual"]]
    (IPV4Address=(0-255).(0-255).(0-255).(0-255) |
    IPv6LocalAddress=(FE80):(0000):(0000):(0000):(0-FFFF):(0-FFFF):(0-FFFF):(0-FFFF) |
    IPv6RoutableAddress=(0-FFFF):(0-FFFF):(0-FFFF):(0-FFFF): (0-FFFF):(0-FFFF):(0-FFFF):(0-FFFF) |
    IPv6RouterAddress=(0-FFFF):(0-FFFF):(0-FFFF):(0-FFFF): (0-FFFF):(0-FFFF):(0-FFFF):(0-FFFF) |
    enableIPv4=(TRUE | FALSE) |
    enableIPv6=(TRUE | FALSE) |
    enableIPv4Vlan=(TRUE | FALSE) |
    enableIPv6Vlan=(TRUE | FALSE) |
    enableIPv4Priority=(TRUE | FALSE) |
    enableIPv6Priority=(TRUE | FALSE) |
    fecMode=(auto:none:reedSolomon:fireCode) |
    IPv4ConfigurationMethod=(static | dhcp) |
    IPv6ConfigurationMethod=(static | auto) |
    IPv4GatewayIP=(0-255).(0-255).(0-255).(0-255) |
    IPv6HopLimit=[0-255] |
    IPv6NdDetectDuplicateAddress=[0-255] |
    IPv6NdReachableTime=[0-65535] |
    IPv6NdRetransmitTime=[0-65535] |
    IPv6NdTimeOut=[0-65535] |
    IPv4Priority=[0-7] |
    IPv6Priority=[0-7] |
    IPv4SubnetMask=(0-255).(0-255).(0-255).(0-255) |
    IPv4VlanId=[1-4094] |
    IPv6VlanId=[1-4094] |
    maxFramePayload=[1500-9000] |
    tcpListeningPort=(3260 | [49152-65535]) |
    portSpeed=(autoNegotiate | 10 | 25 | 40 | 50 | 100))

Parameters

Parameter Description

controller

Allows you to specify the controller for which you want to define properties.

hostPort

Allows you to specify the host port label for which you want to define properties. For 200 GB Host Ports only, you can specify physical or virtual as parameters.

Note

If you do not specify a value for your 200 GB host port connection, the physical parameter is set by default.

IPV4Address

Allows you to enter the address in this format: (0-255).(0-255).(0-255).(0-255).

IPV6LocalAddress

Allows you to enter the address in this format: (FE80):(0000):(0000):(0000): (0-FFFF):(0-FFFF):(0-FFFF):(0-FFFF).

IPv6RoutableAddress

Allows you to enter the address in this format: (0-FFFF):(0-FFFF):(0-FFFF):(0-FFFF): (0-FFFF):(0-FFFF):(0-FFFF):(0-FFFF).

IPV6RouterAddress

Allows you to enter the address in this format: (0-FFFF):(0-FFFF):(0-FFFF):(0-FFFF): (0-FFFF):(0-FFFF):(0-FFFF):(0-FFFF).

enableIPV4

Allows you to enable IPv4.

enableIPV6

Allows you to enable IPv6. The IPv6 address space is 128 bits. It is represented by eight 16-bit hexadecimal blocks separated by colons.

enableIPv4Vlan

Allows you to enable IPv4 VLAN. A VLAN is a logical network that behaves like it is physically separate from other physical and virtual local area networks (LANs) supported by the same switches, the same routers, or both.

enableIPv6Vlan

Allows you to enable IPv6 VLAN. A VLAN is a logical network that behaves like it is physically separate from other physical and virtual local area networks (LANs) supported by the same switches, the same routers, or both.

enableIPv4Priority

Allows you to enable the parameter that determines the priority of accessing the network. In a shared local area network (LAN) environment, such as Ethernet, many stations might contend for access to the network. Access is on a first-come, first-served basis. Two stations might try to access the network at the same time, which causes both stations to back off and wait before trying again. This process is minimized for switched Ethernet, where only one station is connected to a switch port.

enableIPv6Priority

Allows you to enable the parameter that determines the priority of accessing the network. In a shared local area network (LAN) environment, such as Ethernet, many stations might contend for access to the network. Access is on a first-come, first-served basis. Two stations might try to access the network at the same time, which causes both stations to back off and wait before trying again. This process is minimized for switched Ethernet, where only one station is connected to a switch port.

fecMode

Allows you to set the FEC mode for the host port to one of the following options:

  • auto

  • none

  • reedSolomon

  • fireCode

IPv4ConfigurationMethod

Allows you to set IPv4 static or DHCP addressing.

IPv6ConfigurationMethod

Allows you to set IPv6 static or DHCP addressing.

IPv4GatewayIP

Allows you to enter the gateway address in this format: (0-255).(0-255).(0-255).(0-255).

IPv6HopLimit

Allows you to configure the maximum number of hops an IPv6 packet can traverse. The default value is 64.

IPv6NdDetectDuplicateAddress

Allows you to set the number of neighbor-solicitation messages to send in trying to determine IP address uniqueness.

IPv6NdReachableTime

Allows you to set the amount of time, in milliseconds, that a remote IPv6 node is considered reachable. The default value is 30000 milliseconds.

IPv6NdRetransmitTime

Allows you to set the amount of time, in milliseconds, to continue to retransmit a packet to an IPv6 node. The default value is 1000 milliseconds.

IPv6NdTimeOut

Allows you to set the timeout value, in milliseconds, for an IPv6 node. The default value is 30000 milliseconds.

IPv4Priority

Allows you to set the priority assignment for IPv4 packets.

IPv6Priority

Allows you to set the priority assignment for IPv6 packets.

IPv4SubnetMask

Allows you to enter the subnet mask address in this format: (0-255).(0-255).(0-255).(0-255).

IPv4VlanId

Allows you to set the IPv4 VLAN id.

IPv6VlanId

Allows you to set the IPv6 VLAN id.

maxFramePayload

Allows you to set the maximum size of a packet or frame that is sent in a network. The payload portion of a standard Ethernet frame is set to 1500, and a jumbo Ethernet frame is set to 9000. When using jumbo frames, all the devices that are in the network path should be able to handle the larger frame size. The default value is 1500 bytes per frame.

Note

To ensure best performance in an NVMe over RoCE environment, configure a frame size of 4200.

tcpListeningPort

Allows you to set the TCP port number that is used to listen for iSCSI logins from initiators. The default port is 3260.

portSpeed

Allows you to set the speed, in megabits per second (Mb/s), for which the port should be communicating.

Note

This parameter is only supported with a 25 Gbps iSCSI host interface card and a 100 Gbps Ethernet host interface card. For a 25 Gbps iSCSI host interface card, changing the speed of one port changes the speed of all four ports on the card. The allowable options in this case are 10 or 25. For a 100 Gbps Ethernet host interface card, new in release 8.50, changing the speed of one port doesn’t affect the other ports on the card. The allowable options in the latter case are autoNegotiate, 10, 25, 40, 50, or 100GbE.

Parameter support by host port type

Parameter support varies by host port type (iSCSI, iSER, NVMe over InfiniBand, or NVMe over RoCE), as described in the following table:

Parameter iSCSI iSER NVMe over InfiniBand NVMe over RoCE

IPV4Address

Yes

Yes

Yes

Yes

IPV6LocalAddress

Yes

Yes

IPv6RoutableAddress

Yes

Yes

IPV6RouterAddress

Yes

Yes

enableIPV4

Yes

Yes

enableIPV6

Yes

Yes

enableIPv4Vlan

Yes

No

enableIPv6Vlan

Yes

No

enableIPv4Priority

Yes

No

enableIPv6Priority

Yes

No

IPv4ConfigurationMethod

Yes

Yes

IPv6ConfigurationMethod

Yes

Yes

IPv4GatewayIP

Yes

Yes

IPv6HopLimit

Yes

IPv6NdDetectDuplicateAddress

Yes

IPv6NdReachableTime

Yes

IPv6NdRetransmitTime

Yes

IPv6NdTimeOut

Yes

IPv4Priority

Yes

No

IPv6Priority

Yes

No

IPv4SubnetMask

Yes

Yes

IPv4VlanId

Yes

No

IPv6VlanId

Yes

No

maxFramePayload

Yes

Yes

tcpListeningPort

Yes

portSpeed

Yes

Yes

Minimum firmware level

8.41

8.50 - added information about the NVMe over RoCE environment.

11.70.1 added the fecMode parameter.