PowerScaleOneFS CLI Command Reference

Syntax

isi network pools create <id>
  [--access-zone <string]
  [--aggregation-mode {roundrobin | failover | lacp | loadbalance | none}]
  [--description <string>]
  [--alloc-method {dynamic | static}]
  [--ifaces <node-interface-range>]
  [--ranges <ip-address-range>]
  [--rebalance-policy{manual | auto}]
  [--sc-failover-policy {roundrobin | conn_count | throughput | cpu_usage}]
  [--static-routes <route>]
  [--nfs-rroce-only  {true | false}]
  [--ipv6-perform-dad {true | false}]
  [--sc-connect-policy {roundrobin | conn_count | throughput | cpu_usage}]
  [--sc-dns-zone <domain-name>]
  [--sc-dns-zone-aliases <domain-name>]
  [--sc-subnet <string>]
  [--sc-ttl <integer>]
  [--force]
  [--verbose]

Options

<id>

Specifies the ID of the new pool that you want to create. The pool must be added to an existing groupnet and subnet. 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 pool ID in the following format:

<groupnet_name>.<subnet_name>.<pool_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:pool0. The pool name must be unique in the subnet.

Pool Options

--access-zone <zone-name>

Associates an access zone with the pool. Clients will be allowed to connect to the specified access zone only through IP addresses in the pool. The access zone must belong to the same groupnet as the IP address pool.

--aggregation-mode {roundrobin | failover | lacp | loadbalance | none}

Specifies how outgoing traffic is distributed across aggregated network interfaces. The aggregation mode is applied only if at least one aggregated network interface is a member of the IP address pool.

The following values are valid:

roundrobin

Rotates connections through the nodes in a first-in, first-out sequence, handling all processes without priority. Balances outbound traffic across all active ports in the aggregated link and accepts inbound traffic on any port.

failover

Switches to the next active interface when the primary interface becomes unavailable. Manages traffic only through a primary interface. The second interface takes over the work of the first as soon as it detects an interruption in communication.

lacp

Supports the IEEE 802.3ad Link Aggregation Control Protocol (LACP). Balances outgoing traffic across the interfaces based on hashed protocol header information that includes the source and destination address and the VLAN tag, if available. Also assembles interfaces of the same speed into groups called Link Aggregated Groups (LAGs) and balances traffic across the fastest LAGs. This option is the default mode for new pools.

loadbalance

Balances outgoing traffic across the active ports based on hashed protocol header information that includes the Ethernet source and destination address, and, if available, the VLAN tag, and the IP source and destination address, and accepts incoming traffic from any active port.

none

Does not allow for aggregation in a given node pool. Attempting to add an aggregated interface will return an error.

--description <string>

Specifies an optional description of the IP address pool. The description cannot exceed 128 bytes.

Network Options

--alloc-method {dynamic | static}

Specifies the method by which IP addresses are allocated to the network interfaces that are members of the pool.

The following values are valid:

static

Assigns each network interface in the IP address pool a single, permanent IP address from the pool. Depending on the number of IP addresses available, some IP addresses might go unused. The static option is the default setting.

dynamic

Specifies that all pool IP addresses must be assigned to a network interface at all times. Enables multiple IP addresses to be assigned to an interface. If a network interface becomes unavailable, this option helps to ensure that the assigned IP address are redistributed to another interface.

NOTE:This option is only available if a SmartConnect Advanced license is active on the cluster.

--ifaces <node-interface-range>...

Specifies which network interfaces should be members of the IP address pool. Specify network interfaces in the following format:

<node>:<interface>

To specify a range of nodes, separate the lower and upper node IDs with a dash (-). To specify multiple network interfaces, separate each interface with a comma. The following example adds the interfaces from nodes 1, 2 and 3:

--ifaces 1-2:ext-1,3:ext-2,1:10gige-agg-1,3:10gige-1

NOTE:If you attempt to add an interface that has already been added as part of an aggregated interface, you will receive an error message.

--ranges <ip-address-range>...

Specifies one or more IP address ranges for the pool. IP addresses within these ranges are assigned to the network interfaces that are members of the pool.

Specify the IP address range in the following format:

<low-ip-address>-<high-ip-address>

--rebalance-policy{manual | auto}

Specifies when to redistribute pool IP addresses if a network interface that was previously unavailable becomes available.

manual

Requires that connection rebalancing be performed manually after network interface failback.

To manually rebalance all IP addresses in a specific pool, run the following command:

isi network pools rebalance-ips 

To manually rebalance all IP addresses across the cluster, run the following command:

isi network sc-rebalance-all 

auto

Causes connections to be rebalanced automatically after network interface failback. This is the default value.

--sc-failover-policy {roundrobin | conn_count | throughput | cpu_usage}

Specifies how IP addresses that belong to an unavailable interface are rebalanced across the remaining network interfaces.

The following values are valid:

round-robin

Assigns IP addresses across nodes equally. This is the default policy.

conn-count

Assigns IP addresses to the node that has fewest number of connections.

throughput

Assigns IP addresses to the node with least throughput.

cpu-usage

Assigns IP addresses to the node with lowest CPU usage.

--static-routes <route>

Designates an IP addresses as a static route and specifies the destination gateway. If a client connects through a static route IP address, outgoing client traffic is routed through the specified gateway. Multiple routes can be specified in a comma-separated list.

Specify the static route in the following classless inter-domain routing (CIDR) notation format:

<network-address>/<subnet-mask>-<gateway-ip-address>

--nfs-rroce-only {true | false}

NFS RDMA RRoCE only.

--ipv6-perform-dad {true | false}

Enables or disables IPv6 Duplicate Address Detection (DAD) on static network pool IPs. You must also enable IPv6 and global DAD using the isi network external modify command.

SmartConnect DNS Options

--sc-connect-policy {roundrobin | conn_count | throughput | cpu_usage}

Specifies how incoming DNS queries for client connections are balanced across IP addresses.

The following values are valid:

round-robin

Rotates connections through nodes equally. This value is the default policy.

conn-count

Assigns connections to the node that has the fewest number of connections.

throughput

Assigns connections to the node with the least throughput.

cpu-usage

Assigns connections to the node with the lowest CPU usage.

--sc-dns-zone <domain-name>

Specifies the SmartConnect DNS zone name for this pool. IP addresses are returned in response to DNS queries to this SmartConnect zone.

--sc-dns-zone-aliases <domain-name>

Specifies a list of alternate SmartConnect DNS zone names for the pool. Multiple aliases can be specified in a comma-separated list.

--sc-subnet <string>

Specifies the name of the service subnet that is responsible for handling DNS requests for the SmartConnect zone. If not specified, the parent subnet of the Network Pool will be used.

--sc-ttl <integer>

Specifies the time-to-live value for SmartConnect DNS query responses (in seconds). DNS responses are only valid for the time specified. The default value is 0 seconds.

Display Options

{--verbose | -v}

Displays more detailed information.

{--force | -f}

Forces commands without warnings.

Argument Formats

<aggregation_mode>

Specifies the type of NIC aggregation. Supported types are: roundrobin, failover, lacp, loadbalance, and none.

<domain_name>

Specifies the domain name. The string must be formatted as empty sequences or sequences of supported characters (a-zA-Z0-9-) separated by "." and may be up to 253 characters long.

Examples:

example.domain.name.net, another..example..com

<ip_address_range>

Specifies an IP address range, using two IP addresses separated by a dash. The specified IP addresses will be included in the range.

Examples:

192.168.0.100-192.168.100.100, 10.7.0.0-10.7.255.255

<node_iface_range>

Specifieds a string that identifies an interface on a node, consisting of a Logical Node Number (LNN) and an interface name, separated by a ":". Multiple nodes can be specified using a dash to define the range.

Examples:

1:ext-1, 2:ext-1, 1:10gige-agg-1, 3:10gige-1

<id>

Specifies the string that identifies the ID of a pool consisting of a subnet ID and a pool name, separated by a ":" or a ".". The pool name must be unique throughout the subnet and must contain supported characters (a-zA-Z0-9-) and may be up to 32 characters long.

Examples:

groupnetA:subnetA:poolA, subnet1.pool1, subnet1:pool2

<static_route>

Specifies a static route that allows connections to networks that are unavailable through the default routes of the form: <ip_address>/<integer>-<ip_address> where the first address and the integer form a netmask, and the second address is a gateway. Static routes are configured on a per-pool basis.

Examples:

192.168.0.0/16-192.170.0.1

Examples

The following command creates an IP address pool called pool1 under groupnet0.subnet0. It assigns IP addresses 198.51.100.10-198.51.100.20 to ext-1 network on nodes 1, 2, and 3. The SmartConnect zone name of this pool is storage.company.com, but it accepts the alias of storage.company:

isi network pools create groupnet0.subnet0.pool1 \
 --ranges=192.168.8.10-192.168.8.15 --ifaces=1-3:ext-1 \
 --sc-dns-zone=storage.company.com --sc-dns-zone-aliases=storage.company

The following command creates an IP address pool called pool1 under groupnet0.subnet0. It assigns IP addresses 198.51.100.10-198.51.100.20 to the pool. The command also includes aggregated interfaces from nodes 1 through 3 and specifies loadbalance as the aggregation mode:

isi network pools create groupnet0.subnet0.pool1 \ 
 --ranges=192.168.8.10-192.168.8.15 --ifaces=1-3:10gige-agg-1 \
 --aggregation-mode=loadbalance

The following command creates an IP address pool called pool1 under groupnet0.subnet0. It assigns IP addresses 198.51.100.10-198.51.100.20 to the pool and specifies that connection rebalancing must be performed manually:

isi network pools create groupnet0.subnet0.pool1 \ 
 --ranges=192.168.8.10-192.168.8.15 --alloc-method=dynamic \
 --rebalance-policy=manual