vippool create

Prev Next

This command creates a virtual IP pool.Managing Virtual IP Pools

Usage
vippool create  --ip-ranges IP_RANGES
               [--subnet-cidr CIDR]
               [--subnet-cidr-ipv6 CIDR]
               [--gw-ip IPV4]
               [--gw-ipv6 IPV6]
               [--vlan VLAN]
               [--cnode-ids CNODE_IDs]
               [--cnode-names CNODE_NAMEs]
               [--name NAME]
               [--vast-dns-domain-name DOMAIN_NAME]
               [--role PROTOCOLS|REPLICATION]
               [--vms-preferred]
               [--not-vms-preferred]
               [--port-membership ALL|RIGHT|LEFT]
               [--tenant-id TENANT_ID]
               [--serve-all-tenants]
               [--enable-weighted-balancing|--disable-weighted-balancing]
               [--enable-l3|--disable-l3]
               [--bgp-config-id ID]
Required Parameters

--ip-ranges IP_RANGES

Lists the ranges of IPv4 or IPv6 addresses included in the virtual IP pool.

Specify IP_RANGES as a list of IP ranges in the format <start IP>,<end IP>. Separate ranges with a space.

For example: --ip-ranges 10.10.10.2,10.10.10.4 10.10.10.8,10.10.10.24

Options

--subnet-cidr CIDR

Specifies the subnet in Classless Inter-Domain Routing (CIDR) notation for IPv4.

In CIDR notation, the subnet is expressed as the number of bits of each IP address that represent the subnet address. For example, the subnet mask 255.255.255.0 is expressed as 24 in CIDR notation.

Specify CIDR as an integer.

For example: --subnet-cidr 24

--subnet-cidr-ipv6 CIDR

Specifies the subnet in Classless Inter-Domain Routing (CIDR) notation for IPv6.

This option is required if IPv6 is used in --ip-ranges.

In CIDR notation, the subnet is expressed as the number of bits of each IP address that represent the subnet address. For IPv6, this is known as IPv6 prefix length. For example, the prefix length of /32 in 2001:db8::/32 would include IP addresses from 2001:db8:: to 2001:db8:ffff:ffff:ffff:ffff:ffff:ffff.

Specify CIDR as an integer.

For example: --subnet-cidr-ipv6 48

--gw-ip IPV4

Specifies a gateway IPv4 address. Use this option if your storage clients are on multiple subnets and you are routing your client storage traffic through a local gateway.

--gw-ipv6 IPV6

Specifies a gateway IPv6 address. Use this option if your storage clients are on multiple subnets and you are routing your client storage traffic through a local gateway.

--vlan VLAN

Tags the virtual IP pool with a specific VLAN on the data network. See Tagging Virtual IP Pools with VLANs.Tagging Virtual IP Pools with VLANs

Specify VLAN as a VLAN number (0-4096).

--cnode-ids CNODE_IDs

Dedicates a specific group of CNodes to the virtual IP pool. The virtual IPs in this pool will only be distributed among the specified CNodes.

Specify CNODE_IDs as a comma separated list of CNode IDs.

By default, virtual IP pools are distributed among all active CNodes.

--cnode-names CNODE_NAMEs

Dedicates a group of CNodes to the virtual IP pool, specifying CNodes by name. Specify CNode names as a comma separated list.

For example: --cnode-names cnode-1,cnode-3,cnode-4

By default, virtual IP pools are distributed among all active CNodes.

--name NAME

Specifies a name for the virtual IP pool.

--vast-dns-domain-name DOMAIN_NAME

Specifies a domain name to associate with the virtual IP pool for DNS resolution by the VAST Cluster DNS server. If a domain suffix is defined in the DNS server configuration, it is appended to the domain name to form a FQDN.Configuring the VAST Cluster DNS Service

--role PROTOCOLS|REPLICATION

Determines the usage of the virtual IP pool:

  • PROTOCOLS. The virtual IP pool is used to provide access to the cluster for data network clients.

  • REPLICATION. The virtual IP pool is used for async replication.

--vms-preferred

Sets CNodes participating in the virtual IP pool to belong to a preferred domain for VMS failover.  For more details, see Configuring Network Access. Configuring Network Access

--not-vms-preferred

Disables --vms-preferred.

--port-membership ALL|RIGHT|LEFT

Determines which port (right or left) in a group of CNodes is allocated to the virtual IP pool. For more information, see Configuring Network Access. By default, all ports on the pool's CNodes are included in the virtual IP pool.Configuring Network Access

--tenant-id TENANT_ID

Specifies a tenant for the virtual IP pool to serve exclusively.

If a tenant ID is specified, only this particular tenant is able to access the virtual IP pool. If no tenant ID is set, the pool can be accessed by any tenant.

--serve-all-tenants

Detaches a tenant from the virtual IP pool, so that the virtual IP pool serves all tenants.

--enable-weighted-balancing

Applicable for combinations of CNodes of different generations. Enables automatic rebalancing of virtual IPs across CNodes according to the following ratios:

  • Ice Lake CNodes are allocated 50% more virtual IPs than Cascade Lake CNodes,

  • Cascade Lake CNodes are allocated 50% more virtual IPs than Broadwell CNodes.

  • Genoa and Gen5 CNodes are allocated 100% more virtual IPs than Ice lake CNodes.

This feature allows you to leverage the increased CPU capacity of newer CNode generations that can handle a higher workload.  

--disable-weighted-balancing

Disables CNode virtual IP rebalancing.

--enable-l3

Enables L3 BGP for the virtual IP pool. This is required if L3 BGP networking is used. If enabled, --bgp-config-id  must also be set.

--disable-l3

Disables L3 BGP for the virtual IP pool.

--bgp-config-id ID

Sets the BGP configuration ID to be used for L3 networking. This must be set if L3 is enabled for the virtual IP pool.

Example
vcli: admin> vippool create --ip-ranges 203.0.113.2,203.0.113.5 203.0.113.8,203.0.113.24  --subnet-cidr 24 --gw-ip 203.0.113.1 --vlan 60 --cnode-ids 1,2,3 --name vippool1