Skip to main content

Set controller

The set controller command defines the attributes for the controllers.

Supported Arrays​

This command applies to an individual DE2000H, DE4000H, DE4000F, DE6000H, or DE6000F storage array.

Roles​

To execute this command on an storage array, you must have the Storage Admin role.

Syntax​

set controller [(<span className="ph">a</span>|<span className="ph">b</span>)] 
[availability=(online | offline | serviceMode)] 
[ethernetPort [(<span className="ph">1</span>| <span className="ph">2</span>)] <var id="GUID-5C5CB0E1-8377-4DA9-933F-AF024615A5A0__V1106291" className="keyword varname">ethernetPortOptions</var>] 
[globalNVSRAMByte [<var id="GUID-5C5CB0E1-8377-4DA9-933F-AF024615A5A0__V1106292" className="keyword varname">nvsramOffset</var>]=(<var id="GUID-5C5CB0E1-8377-4DA9-933F-AF024615A5A0__V1106293" className="keyword varname">nvsramByteSetting</var> | <var id="GUID-5C5CB0E1-8377-4DA9-933F-AF024615A5A0__V1106294" className="keyword varname">nvsramBitSetting</var>)] 
[hostNVSRAMByte [<var id="GUID-5C5CB0E1-8377-4DA9-933F-AF024615A5A0__V1106295" className="keyword varname">hostType</var>, <var id="GUID-5C5CB0E1-8377-4DA9-933F-AF024615A5A0__V1106296" className="keyword varname">nvsramOffset</var>]=(<var id="GUID-5C5CB0E1-8377-4DA9-933F-AF024615A5A0__V1106297" className="keyword varname">nvsramByteSetting</var> |<var id="GUID-5C5CB0E1-8377-4DA9-933F-AF024615A5A0__V1106298" className="keyword varname">nvsramBitSetting</var>)] 
[IPv4GatewayIP=<var id="GUID-5C5CB0E1-8377-4DA9-933F-AF024615A5A0__V1106299" className="keyword varname">ipAddress</var>] 
[IPv6RouterAddress=<var id="GUID-5C5CB0E1-8377-4DA9-933F-AF024615A5A0__V1106300" className="keyword varname">ipv6Address</var>] 
[iscsiHostPort [<var id="GUID-5C5CB0E1-8377-4DA9-933F-AF024615A5A0__V1837904" className="keyword varname">portLabel</var>] <var id="GUID-5C5CB0E1-8377-4DA9-933F-AF024615A5A0__V1106301" className="keyword varname">iscsiHostPortOptions</var>] 
[rloginEnabled=(TRUE | FALSE)] 
[serviceAllowedIndicator=(on | off)]

Parameters​

ParameterDescription
controller The controller for which you want to define properties. Valid controller identifiers are a or b , where a is the controller in slot A , and b is the controller in slot B . Enclose the identifier for the controller in square brackets ([ ]). If you do not specify a controller, the firmware for the controller returns a syntax error.
availability The mode for the controller, which you can set to online , offline , or serviceMode (service).
ethernetPort The attributes (options) for the management Ethernet ports. The entries to support this parameter are listed in the Syntax Element Statement Data table that follows. Many settings are possible, including setting the IP address, the gateway address, and the subnet mask address.
globalNVSRAMByte A portion of the controller NVSRAM. Specify the region to be modified using the starting byte offset within the region and the byte value or bit value of the new data to be stored into the NVSRAM.
hostNVSRAMByte The NVSRAM for the host-specific region. The setting specifies the host index for the specific host, the starting offset within the region, the number of bytes, and the byte value or bit value of the new data to be stored into the NVSRAM.
IPv4GatewayIP The IP address of the node that provides the interface to the network. The address format for the IPv4 gateway is (0–255).(0–255).(0–255).(0–255)
IPv6RouterAddress The IP address of IPv6 router that connects two or more logical subnets. The address format for the IPv6 router is (0–FFFF):(0–FFFF):(0–FFFF):(0–FFFF): (0–FFFF):(0–FFFF):(0–FFFF):(0–FFFF) .
iscsiHostPort

This parameter enables you to set options for the iSCSI ports on the controller. Enter the iSCSI port label or number and then select the options for that port.

rloginEnabled The setting for whether the remote login feature is turned on or turned off. To turn on the remote login feature, set this parameter to TRUE . To turn off the remote login feature, set this parameter to FALSE .
serviceAllowedIndicator The setting for whether the Service Action Allowed indicator light is turned on or turned off. To turn on the Service Action Allowed indicator light, set this parameter to on . To turn off the Service Action Allowed indicator light, set this parameter to off .

Identifying an iSCSI host port label​

You must specify a label for the host port. Follow these steps to specify the host port label:

  1. If you do not know the port label for the iSCSI host port, run the

    show controller command.

  2. In the Host interface section of the results, locate the host port you want to select.

    Note
    The port label is the complete value returned for the Port field.

  3. Enclose the entire value of the port label in both quotes and square brackets: ["

    portLabel "]. For example, if the port label is Ch 2 , specify the iSCSI host port as follows:

                            iscsiHostPort[\"ch 2\"]
    Note
    If you are using a Windows command line and the label contains a pipe (|), the character should be escaped (using ^); otherwise, it will be interpreted as a command. For example, if the port label is e0b|0b , specify the iSCSI host port as follows: 

                            iscsiHostPort[\"e0b^|0b\"]

Options for the ethernetPort parameter​


enableIPv4=(TRUE | FALSE) | 
            

enableIPv6=(TRUE | FALSE) | 
            

IPv6LocalAddress=(0-FFFF):(0-FFFF):(0-FFFF):(0-FFFF): (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) | 
            

IPv4Address=(0-255).(0-255).(0-255).(0-255) | 
            

IPv4ConfigurationMethod=[(static | dhcp)] | 
            

IPv4SubnetMask=(0-255).(0-255).(0-255).(0-255) | 
            

duplexMode=(TRUE | FALSE) | 
            

portSpeed=[(autoNegotiate | 10 | 100 | 1000)]

Options for the iSCSIHostPort parameter​


IPv4Address=(0-255).(0-255).(0-255).(0-255) | 
            

IPv6LocalAddress=(0-FFFF):(0-FFFF):(0-FFFF):(0-FFFF): (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) |
            

IPv4ConfigurationMethod=(static | dhcp) | 
            

IPv6ConfigurationMethod=(static | auto) | 
            

IPv4GatewayIP=(TRUE | FALSE) | 
            

IPv6HopLimit=[0-255] | 
            

IPv6NdDetectDuplicateAddress=[0-256] | 
            

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=[
<em id="GUID-5C5CB0E1-8377-4DA9-933F-AF024615A5A0__V752031" className="ph i">
    frameSize
</em>
] | 
            

tcpListeningPort=[3260, 49152-65536] | 
            

portSpeed=[( 10 | 25)]

Notes​

When you use this command, you can specify one or more of the parameters. You do not need to use all of the parameters.

Setting the availability parameter to serviceMode causes the alternate controller to take ownership of all of the volumes. The specified controller no longer has any volumes and refuses to take ownership of any more volumes. Service mode is persistent across reset cycles and power cycles until the availability parameter is set to online .

Use the show controller NVSRAM command to show the NVSRAM information. Before making any changes to the NVSRAM, contact technical support to learn what regions of the NVSRAM you can modify.

When the duplexMode option is set to TRUE , the selected Ethernet port is set to full duplex. The default value is half duplex (the duplexMode parameter is set to FALSE ).

To make sure that the IPv4 settings or the IPv6 settings are applied, you must set these iscsiHostPort options:

  • enableIPV4= TRUE
  • enableIPV6= TRUE

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

The maxFramePayload option is shared between IPv4 and IPv6. 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 of the devices that are in the network path should be capable of handling the larger frame size.

The portSpeed option is expressed as megabits per second (Mb/s).

Values for the portSpeed option of the iscsiHostPort parameter are in megabits per second (Mb/s).

The following values are the default values for the iscsiHostOptions :

  • The IPv6HopLimit option is 64.

  • The IPv6NdReachableTime option is 30000 milliseconds.

  • The IPv6NdRetransmitTime option is 1000 milliseconds.

  • The IPv6NdTimeOut option is 30000 milliseconds.

  • The tcpListeningPort option is 3260.