PowerScale OneFS 9.3.0.0 CLI Command Reference

Syntax

isi network pools create <id>
  [--access-zone <string]
  [--aggregation-mode {roundrobin | failover | lacp | fec}]
  [--alloc-method {dynamic | static}]
  [--description <string>]
  [--ifaces <node-interface-range>]
  [--ranges <ip-address-range>]
  [--rebalance-policy{manual | auto}]
  [--sc-auto-unsuspend-delay <integer>]
  [--sc-connect-policy {roundrobin | conn_count | throughput | cpu_usage}]
  [--sc-dns-zone <domain-name>]
  [--sc-dns-zone-aliases <domain-name>]
  [--sc-failover-policy {roundrobin | conn_count | throughput | cpu_usage}]
  [--sc-subnet <string>]
  [--sc-ttl <integer>]
  [--static-routes <route>]
  [--nfsv3-rroce-only <boolean>]
  [--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.

--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 | fec}

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.

fec

Provides static balancing on aggregated interfaces through the Cisco Fast EtherChannel (FEC) driver, which is found on older Cisco switches. Capable of load-balancing traffic across Fast Ethernet links. Enables multiple physical Fast Ethernet links to combine into one logical channel.

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

--description <string>

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

--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-auto-unsuspend-delay <integer>

Specifies the time delay (in seconds) before a node that is automatically unsuspended resumes SmartConnect DNS query responses for the node. During certain cluster operations such as rolling upgrades, general node splits, or node reboots, a node is automatically suspended and then unsuspended by the system.

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

--sc-subnet <string>

Specifies the name of the service subnet that is responsible for handling DNS requests for the SmartConnect zone.

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

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

[--nfsv3-rroce-only <boolean>]

NFSv3 RDMA RRoCE only.

{--verbose | -v}

Displays more detailed information.

{--force | -f}

Forces commands without warnings.

Examples

The following command creates a new IP address pool called pool1 under groupnet0.subnet0 and 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 a new IP address pool called pool1 under groupnet0.subnet0 and assigns IP addresses 198.51.100.10-198.51.100.20 to the pool. The command also includes aggregated interfaces from nodes 1-3 and specifies FEC 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=fec

The following command creates a new IP address pool called pool1 under groupnet0.subnet0, 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