Skip to main content

Create Replication Floating IP

Before you can replicate a virtual storage container (VSC, also referred to as a volume in the documentation and user interfaces), you must create a replication floating IP on the source and target StorONE deployments.

The replication floating IP is distinct from the general purpose floating IPs that you create for network attached storage (NAS) and object store volumes as well as client access to replicated volumes. This floating IP is used for the replication mechanism itself between the source and target systems. It is also used for client initiators to access replicated block-based volumes, including iSCSI, Fibre Channel (FC), and NVMe over Fabrics (NVMe-oF) volumes.

In a highly available (HA) system, the replication floating IP that you configure in the StorONE system actually specifies two IP addresses: one for each node in the HA pair. Therefore, to create the replication floating IPs for two HA systems, you must allocate four IP addresses.

In the event that one node in an HA pair fails, or a manual failover is initiated, the replication floating IP on the failed node (as well as any volumes hosted on that node) moves to the remaining node. When the node is restored, and a giveback is initiated to return the system to HA mode, the floating IP and the original volumes are transitioned back to the restored node.

Normal Operation:

Normal Operation Failover

You can create the replication floating IP using the web admin interface or the command line interface (CLI):

{{<

tabpane text=true >}} {{% tab header="Web UI"UI %}}

In the admin web interface, go to Replication admin > Floatingips admin. Click the Create button, and fill in the sections:

Name

In the Name section, specify the name of the replication floating IP. This is the name you will use to reference this replication floating IP within the StorONE user interfaces.

IP Addresses

The Nodes in the system are pre-selected for you. Select the interface on each node that you want to use for replication traffic, and then specify the IP address you want to assign to that interface.

Subnet mask and Gateway

Specify the subnet mask and the optional default gateway for the interfaces.

After completing all fields, click Submit to create the replication floating IP.

{{%
/tab
%}}CLI {{% tab header="CLI" %}}

To create a replication floating IP using the CLI, use the following command:

replication floatingips create <name> --nodes=<node_1 node_2> --interfaces=<node_1_if node_2_if> --addresses=<node_1_ip node_2_ip> --mask=<subnet> [--gateway=<ip>] [--force]

<name>

Specify the name of the replication floating IP. This is the name you will use to reference this replication floating IP within the StorONE user interfaces.

--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 replication floating IP. These are the interfaces that will be assigned the specified IP addresses.

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.

--addresses=<node_1_ip node_2_ip> --mask=<subnet> [--gateway=<ip>]

Specify the IP addresses of the floating IPs and the subnet mask. Optionally, specify the default gateway if this address will be accessible from other subnets. These arguments are positional, meaning that you must specify the IP addresses in the same order as the --nodes and --interfaces arguments. If you specified node A first in the --nodes arguments, specify the IP address you want to assign to node A first in the --addresses arguments.

--force

Optionally ignore validations, and force the creation of the replication floating IP. In general, you should never need to use this option.

Examples

  1. To create a replication floating IP named s1-src-repl with the IP addresses of 172.16.32.64 and 172.16.32.65, and a netmask of 255.255.255.0, with a gateway of 172.16.32.1, using the sob4-data and soe5-data interfaces on nodes example-s1n1 and example-s1n2, respectively:

    replicication floatingips create s1-src-repl --nodes example-s1n1 example-s1n2 --interfaces sob4-data soe5-data --addresses 172.16.32.64 172.16.32.64 --mask 24 --gateway 172.16.32.1

  2. To create a replication floating IP named s1-dst-repl with the IP addresses of 10.10.150.42 and 10.10.150.43, and a netmask of 255.0.0.0, with a gateway of 10.0.0.1 using interfaces DATA and DATA on nodes storone-n1 and storone-n2, respectively:

    replication floatingips create s1-dst-repl --nodes storone-n1 storone-n2 --interfaces DATA DATA --addresses 10.10.150.42 10.10.150.43 --mask 255.0.0.0 --gateway 10.0.0.1

{{% /tab %}} {{< /tabpane >}}

Back to top