PowerScaleOneFS CLI Command Reference

Syntax

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

Options

<id>

Specifies the ID of the IP address pool that you want to modify. Specify the 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.

--revert-access-zone

Sets the value of --access-zone to the system default value.

--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 network pool. Attempting to add an aggregated interface will return an error.

--revert-aggregation-mode

Sets the value of --aggregation-mode to the system default value.

--description <string>

Specifies an optional description of the IP address pool. This option overwrites the existing description. The description cannot exceed 128 bytes.

--clear-description

Clears the description of the IP address pool.

--name <string>

Specifies a new name for the IP address pool. The name can be up to 32 alphanumeric characters long and can include underscores or hyphens, but cannot include spaces or other punctuation. The new pool name must be unique in the subnet.

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.

NOTE:Cloud deployments offer an additional allocation method: ExternallyManaged. This allocation method allows cloud providers to decide the placement of Primary IP addresses. Pools using ExternallyManaged allocation method are created and managed by SmartConnect, and cannot be edited or changed from the ExternallyManaged allocation method.

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.

--revert-alloc-method

Sets the value of --alloc-method to the system default value.

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

Adds network interfaces to 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

--clear-ifaces

Removes all network interfaces from the IP address pool.

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

Adds one or more network interfaces to the IP address pool.

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

Removes one or more network interfaces from the IP address pool.

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

This option overwrites the existing list of IP address ranges. Use the --add-ranges and --remove-ranges options to modify the existing list.

--clear-ranges

Removes all IP address ranges from the pool.

--add-ranges

Adds one or more IP address ranges to the pool.

--remove-ranges

Removes one or more IP address ranges from the pool.

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

--revert-rebalance-policy

Sets the value of --rebalance-policy to the system 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:

roundrobin

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.

--revert-sc-failover-policy

Sets the value of --sc-failover-policy to the system default value.

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

This option overwrites the existing list of static routes. Use the --add-static-routes and --remove-static-routes options to modify the existing list.

--clear-static-routes

Removes all static routes from the pool.

--add-static-routes <route>...

Adds one or more static routes to the pool.

--remove-static-routes <route>...

Removes one or more static routes from the pool.

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

NFSv3 RDMA RRoCE only.

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

Enables IPv6 Duplicate Address Detection (DAD) on the network pool.

SmartConnect DNS Options

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

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

The following values are valid:

roundrobin

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.

--revert-sc-connect-policy

Sets the value of --sc-connect-policy to the system default value.

--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. This option overwrites the existing list of SmartConnect DNS zone aliases. Use the --add-sc-dns-zone-aliases and --remove-sc-dns-zone-aliases options to modify the existing list.

--clear-sc-dns-zone-aliases

Removes all SmartConnect DNS zone aliases from the pool.

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

Adds one or more SmartConnect DNS zone aliases to the pool.

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

Removes one or more SmartConnect DNS zone aliases from the pool.

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

--revert-sc-ttl

Sets the value to the default value of 0 seconds.

Display Options

--verbose | -v

Displays more detailed information.

--force | -f

Forces commands without warnings.