setISCSI CLI command

Edit online

Use the setISCSI command to update the network configuration settings for a single Ethernet drive and to optionally change the name and alias of the drive. Each port can be configured separately so that ports in the same drive can be attached to different subnets.

To look up a drive's current settings, use the viewISCSI command or refer to the Drives > Ethernet Ports GUI page.

Syntax

setISCSI -portxAddress {DHCP|<ip-address>} -subnet <subnet-mask> -gateway <gateway-address>  [-name {DEFAULT|<iSCSI-name>}] [-alias "<iSCSI-alias>"] <-f# -c# -r#> -ssl

Parameters

-portxAddress {DHCP|<ip-address>}

(Required.) The port to modify, where:

  • -portxAddress is either -port0Address or -port1Address.
  • DHCP enables DHCP.
  • <ip-address> disables DHCP and assigns this value as the IP address for the specified port. (IPv4 format)

If you are specifying a different subnet mask and gateway for each port, you must enter a separate command for each port, as shown in the example commands. If both ports will be using the same subnet mask and gateway, you can enter the network settings in a single command.

-subnet <subnet-mask>

(Required if DHCP is being disabled.) The subnet mask for the specified port.

-gateway <gateway-address>

(Required if DHCP is being disabled.) The gateway for the specified port.

[-name {DEFAULT|<iSCSI-name>}]

(Optional.) The name for the drive, where:

  • DEFAULT restores the drive name to the system-assigned name.
  • <iSCSI-name> is the new name for the drive. See Ethernet drive network configuration for port name requirements.

A port ID is required when specifying this parameter, even though the name is applied to the drive. You can specify either port.

[-alias "<iSCSI-alias>"]

(Optional.) The new alias for the drive. See Ethernet drive network configuration for alias naming requirements. Quotes are required.

A port ID is required when specifying this parameter, even though the alias is applied to the drive. You can specify either port.

<-f# -c# -r#>

(Required.) The location of the drive, where:

  • -f# = frame number
  • -c# = column number
  • -r# = row number
-ssl

Required if SSL (HTTPS) is enabled.

Example commands

The following command disables DHCP for port 0 of the drive in F1C4R1 and assigns the provided network settings to the port.

setISCSI -port0Address 9.1.2.4 -subnet 255.255.255.0 -gateway 9.1.0.100 -f1 -c4 -r1

The following command enables DHCP for port 0, disables DHCP for port 1 and assigns the provided network settings to the port, and changes the alias for the drive to new-drive-alias.

setISCSI -port0Address DHCP -port1Address 9.1.2.5 -subnet 255.255.255.1 -gateway 9.1.0.100 -alias "new-drive-alias" -f1 -c4 -r1

The following command assigns the address 9.1.2.4 to port 0, assigns the address 9.1.2.5 to port 1, and assigns the provided subnet mask and gateway to both ports.

setISCSI -port0Address 9.1.2.4 -port1Address 9.1.2.5 -subnet 255.255.255.1 -gateway 9.1.0.100 -f1 -c4 -r1

The following commands assign the provided network settings to each port in the specified drive when each port will be attached to a different subnet. (These commands must be entered separately. Combining them into one command will apply the last subnet mask and gateway entered to both ports.)

setISCSI -port0Address 9.1.2.3 -subnet 255.255.0.0 -gateway 9.7.0.1 -f1 -c4 -r1
setISCSI -port1Address 9.1.2.4 -subnet 255.255.0.1 -gateway 9.8.0.1 -f1 -c4 -r1

The following command enables DHCP for port 0 of the drive in F1C4R1 and renames the drive to new-drive-name.

setISCSI -port0Address DHCP -name new-drive-name -f1 -c4 -r1

Example output

The iSCSI Drive Settings were updated.