Floating IPs
You can create and pair floating IPs using the command line interface (CLI) or the web interface. For more information about floating IPs and how they are used in the StorONE system, see Floating IPs.
Creating a floating IP for NAS, object store, or replication
Before you can create a NAS server or an object store, you must create a floating IP. For replicated NAS and object store virtual storage containers (VSCs, also referred to as volumes), you can also use floating IPs to allow you to access the replicated volume using the same IP address or DNS name, regardless of which system is hosting the primary volume.
Web UI
In the admin web interface, go to Inventory > Floatingips
. Click the Create button, and fill in the sections:
Name
In the Name section, specify the name of the floating IP. This is the name you will use to reference this floating IP within the StorONE user interfaces.
If this floating IP will be used for non-replicated NAS or object store volumes, consider including a variation of nas
, object
, or s3
within the name for easy identification.
If this floating IP will be paired with a standby floating IP on another system for use with replication, consider using a name associated with the volumes you want to access using this IP. This will make it easier to identify the floating IPs you need to activate in a replication transition scenario.
If this is the standby floating IP with a dummy address that you will pair with the replication source, make sure to use the same name that you used on the other system. This makes it easier to identify and configure the floating IP pair.
IP Address
Specify the IP address of the floating IP, and select the correct subnet mask. Then, optionally specify the default gateway if this address will be accessible from other subnets.
If this is a standby floating IP that will be paired with a floating IP on a replication source, check the Dummy checkbox. This clears the other options, as you cannot specify an IP address on a standby floating IP.
Interfaces per Node
Select the network interface on each node that will be associated with this floating IP. These are the interfaces that will be assigned the floating IP, depending on which node is active for the NAS server or object store.
For a standby floating IP that will paired with a replication source, these are the interfaces that the floating IP will be assigned to in a replication transition event, again based on which node is active for the NAS server.
After completing all fields, click Submit to create the floating IP.
CLI
To create a floating IP, use the following command:
floatingips create <name> (--dummy)|(--address=<ip> --mask=<subnet> [--gateway=<ip>]) --nodes=<text...> --interfaces=<text...>
<name>
Specify the name of the floating IP. This is the name you will use to reference this floating IP within the StorONE user interfaces.
If this floating IP will be used for non-replicated NAS or object store volumes, consider including a variation of nas
, object
, or s3
within the name for easy identification.
If this floating IP will be paired with a standby floating IP on another system for use with replication, consider using a name associated with the volumes you want to access using this IP. This will make it easier to identify the floating IPs you need to activate in a replication transition scenario.
If this is the standby floating IP with a dummy address that you will pair with the replication source, make sure to use the same name that you used on the other system. This makes it easier to identify and configure the floating IP pair.
--dummy
If this is a standby floating IP that will be paired with a floating IP on a replication source, specify the --dummy
flag. Do not specify an IP address, subnet mask, or gateway.
--address=<ip> --mask=<subnet> --gateway=<ip>
Specify the IP address of the floating IP and the subnet mask. Optionally, specify the default gateway if this address will be accessible from other subnets.
--nodes=<node_1 node_2> --interfaces=<node_1_if node_2_if>
Specify the network interface on each node that will be associated with this floating IP. These are the interfaces that will be assigned the floating IP, depending on which node is active for the NAS server or object store.
For a standby floating IP that will paired with a replication source, these are the interfaces that the floating IP will be assigned to in a replication transition event, again based on which node is active for the NAS server.
You can use the TAB
key auto-complete to see the available nodes and interfaces. These arguments are positional, meaning that you must list nodes and interfaces in the same order. If you list node A first, you must specify the interface on node A first in the --interfaces
arguments.
Examples
-
To create a floating IP named
s1-nas-ip
with the IP address and netmask of172.16.32.64/24
, with a gateway of172.16.32.1
using thesob4-data
andsoe5-data
interfaces on nodesexample-s1n1
andexample-s1n2
, respectively:floatingips create s1-nas-ip --address 172.16.32.64 --mask 24 --gateway 172.16.32.1 --nodes example-s1n1 example-s1n2 --interfaces sob4-data soe5-data
-
To create a floating IP named
s1-s3-ip
with the IP address10.10.150.42/255.0.0.0
and no gateway, using interfacesDATA
andDATA
on nodesstorone-n1
andstorone-n2
, respectively:floatingips create s1-s3-ip --address 10.10.150.42 --mask 255.0.0.0 --nodes storone-n1 storone-n2 --interfaces DATA DATA
Pairing floating IPs for replication
Web UI
You can create a floating IP pair from either system in a replication pair. One floating IP must be configured with a real IP address, and the other must be a standby floating IP configured with a dummy address.
In the admin web interface, go to Inventory > Floatingips
. Click the Pair button, and fill in the sections:
Local Floating Ip
Select the name of the floating IP on the local system you want to pair.
Target Floating Ip
Select the Target System, and then select the Target Floating Ip that you want to pair with. If you configured the system as recommended, the local floating IP and target floating IP have the same name.
Click Submit to create the pair.
CLI
You can create a floating IP pair from either system in a replication pair. One floating IP must be configured with a real IP address, and the other must be a standby floating IP configured with a dummy address.
To pair floating IPs using the CLI, use the following command:
floatingips pair <name> --targetSystem=<name> --targetFloatingIp=<name>
Specify the name of the local floating IP, the target system, and target floating IP. You can use the TAB
key auto-complete to see the available target systems and target floating IPs.
No Comments