This command creates a virtual IP pool.
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
| Lists the ranges of IPv4 or IPv6 addresses included in the virtual IP pool. Specify For example: |
Options
| 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 For example: |
| Specifies the subnet in Classless Inter-Domain Routing (CIDR) notation for IPv6. This option is required if IPv6 is used in 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 For example: |
| 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. |
| 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. |
| Tags the virtual IP pool with a specific VLAN on the data network. See Tagging Virtual IP Pools with VLANs. Specify |
| 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 By default, virtual IP pools are distributed among all active CNodes. |
| Dedicates a group of CNodes to the virtual IP pool, specifying CNodes by name. Specify CNode names as a comma separated list. For example: By default, virtual IP pools are distributed among all active CNodes. |
| Specifies a name for the virtual IP pool. |
| 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. |
| Determines the usage of the virtual IP pool:
|
| Sets CNodes participating in the virtual IP pool to belong to a preferred domain for VMS failover. For more details, see Configuring Network Access. |
| Disables |
| 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. |
| 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. |
| Detaches a tenant from the virtual IP pool, so that the virtual IP pool serves all tenants. |
| Applicable for combinations of CNodes of different generations. Enables automatic rebalancing of virtual IPs across CNodes according to the following ratios:
This feature allows you to leverage the increased CPU capacity of newer CNode generations that can handle a higher workload. |
| Disables CNode virtual IP rebalancing. |
| Enables L3 BGP for the virtual IP pool. This is required if L3 BGP networking is used. If enabled,
|
| Disables L3 BGP for the virtual IP pool.
|
| 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