PowerScale OneFS 9.3.0.0 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>]
  [--sc-service-addr <ip-address>]
  [--vlan-enabled {true | false}]
  [--vlan-id <integer>]
  [--verbose]

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.

<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.

--description <string>

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

--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.

--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.

--sc-service-addr <ip_address>

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

--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.

{--verbose | -v}

Displays more detailed information.