PowerScaleOneFS CLI Command Reference

Syntax

isi networks create subnet <id> <addr-family> (ipv4 | ipv6) <prefixlen>
  [--description <string>]
  [--dsr-addrs <ip-address>]
  [--gateway <ip-address>]
  [--gateway-priority <integer>]
  [--mtu <integer>]
  [--vlan-enabled {true | false}]
  [--vlan-id <integer>]
  [--sc-service-addr <ip-address>]
  [--sc-service-name <domain_name>]
  [--verbose | -v]

Options

<id>

Specifies the ID of the new subnet that you want to create. The subnet must be added to an existing groupnet. The ID can be up to 32 alphanumeric characters long and can include underscores or hyphens, but cannot include spaces or other punctuation. Specify the subnet ID in the following format:

<groupnet_name>.<subnet_name>

The groupnet name is optional if referring to the default groupnet0. Colons are also acceptable as delimiters between component names—for example, groupnet0:subnet1. The subnet name must be unique in the groupnet.

Network options:

<addr-family> (ipv4 | ipv6)

Specifies IP address format to be applied to the subnet. All subnet settings and IP address pools added to the subnet must use the specified address format. You cannot modify the address family once the subnet has been created.

<prefixlen>

Sets the prefix length of the subnet. Specify a prefix length appropriate for the selected address family.

Subnet options:

--description <string>

Specifies an optional description of the subnet. The description cannot exceed 128 bytes.

Network options:

--dsr-addrs <ip_address>...

Sets one or more Direct Server Return addresses for the subnet. If an external hardware load balancer that uses DSR addresses is used, this parameter is required.

NOTE:dsr-addrs have been deprecated.

--gateway <ip_address>

Specifies the gateway IP address used by the subnet.

NOTE:The IP address must belong to the appropriate gateway. If no gateway is assigned or an incorrect IP address is specified, communication with the cluster might be disabled.

--gateway-priority <integer>

Specifies the gateway priority for the subnet. Valid values start at 1. A lower value has a higher priority—for example, a gateway with priority 3 is given priority over a gateway with priority 7. When a new gateway is configured on the system, it is given a default priority of the current lowest priority plus 10 to ensure it does not take priority over existing gateways until you modify the priority level.

--mtu <integer>

Sets the maximum transmission unit (MTU) of the subnet. Common values are 1500 and 9000.

NOTE:Using a larger frame size for network traffic permits more efficient communication on the external network between clients and cluster nodes. For example, if a subnet is connected through a 10 GbE interface, we recommend that you set the MTU to 9000. To benefit from using jumbo frames, all devices in the network path must be configured to use jumbo frames.

All interfaces in the subnet must have the same MTU configuration in all subnets. For example, if 1:10gige-1 is only configured in groupnet0.subnet0 and groupnet0.subnet1, the MTU for both subnets must be identical. If groupnet0.mgmt-subnet has a different MTU, but doesn't contain the interface 1:10gige-1, this will not cause a problem.

VLAN interfaces are allowed to have a different MTU than their physical interface, if the MTU does not exceed the MTU of the parent. In the above example, groupnet0.subnet0 has an MTU of 9000. If groupnet0.vlan0 has vlan 100 configured with an MTU of 1500, it can be configured with 1:10gige-1.

Finally, each VLAN tag is individually validated. Meaning, if groupnet0.vlan2 uses a different vlan, for example vlan 101, and it also contains 1:10gige-1, it can use an MTU of 9000 even though groupnet0.vlan0 has an MTU of 1500.

--vlan-enabled {true | false}

Enables or disables VLAN tagging on the subnet.

--vlan-id <integer>

Specifies the VLAN ID for all interfaces in the subnet.

SmartConnect options:

--sc-service-addr <ip_address>

Specifies the IP address on which the SmartConnect module listens for domain name server (DNS) requests on this subnet.

--sc-service-name <domain_name>

Specifies the domain name corresponding to the SmartConnect service address.

Display options:

--verbose | -v

Displays more detailed information.