Skip to main content

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

  1. To create a floating IP named s1-nas-ip with the IP address and netmask of 172.16.32.64/24, with a gateway of 172.16.32.1 using the sob4-data and soe5-data interfaces on nodes example-s1n1 and example-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
  2. To create a floating IP named s1-s3-ip with the IP address 10.10.150.42/255.0.0.0 and no gateway, using interfaces DATA and DATA on nodes storone-n1 and storone-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 admin > Floatingips admin. 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.