Skip to main content

Floating IPs

A floating IP is an IP address that can be dynamically assigned to different servers or nodes in a network.network, similar to virtual IPs in other HA systems. It can be used to provide high availability and fail fail-over capabilities between multiple nodes.

In the S1 system, two nodecontroller serversnodes work together to provide storage services to clients. These nodes typically share access to the same physical storage resources, such as disk enclosures. By using a floating IP, clients can connect to the storage appliance through a single IP address, regardless of which node is currently serving their requests.

In the event of a failure or maintenance event on one of the nodes, the floating IP can be reassigned to another node that is still operational. This allows clients to continue accessing the storage services without interruption, even if one or more nodes are unavailable.interruption.

Listing floating IPs

To display a list ofsee existing floating IPs, use the floatingips list command.

Usage:

floatingips list [<name>] [--ip=<ip>]

Options:

Options and arguments Description
<anmename> To filter the list byDisplay a specific floating IP name.IP.
--ip=<ip> ToDisplay filtera the list by anspecific IP address.

Examples:

  1. To list all floating IP addresses in S1 system, run

    floatingips list

  2. To display floating IP details for a floating IP namenamed Xf11, run

    floatingips list Xf11

  3. To display floating IP details for floating IP address 192.168.20.11, run

    floatingips list --ip 192.168.20.11

  4. To display floating IP details for floating IP name Xf11 and IP address 192.168.20.11 (If IP name Xf11 is not associated with IP address 192.168.20.11, then no output is to be displayed), run

    floatingip list Xf11 --ip 192.168.20.11

Creating a floating IP

To create a floating IP, use the floatingips create command

Usage:

floatingips create <name> (--dummy)|(--address=<ip> --mask=<subnet> [--gateway=<ip>]) --nodes=<NS-name…s1_nodes> --interfaces=<NS-NIC…interfaces>

Options:

Options and arguments Description
<name> ToThe name of the floating IP, replace <name> with a name of your choice.IP.
--dummy To create a dummy floating IP, primarily used for replication transitions purposes.
--address=<ip> To specify theThe IP address ofto use for the newly created floating IP. Replace <ip> with an IP address.
--mask=<subnet> ToThe specifysubnet mask for the subnetfloating mask address.IP.
--gateway=<ip> To specify theThe gateway IP address offor the network.floating IP.
--nodes=<NS-name…S1_nodes> ToThe specify the namenames of the nodeS1 server,nodes replacethat <NS-name>will withuse the namefloating IP. These are positional arguments. The order of the namespecified server.nodes corresponds to the order of the interfaces.
--interfaces=<NS-NIC…interfaces> To specify theThe network interface card (NIC) names. Replace <NS-NIC…interfaces> with the namenames of the NIC namesNICs that arethe installedfloating IP will use in youreach servernode. nodesYou (can use the TAB keyauto-complete to display listthe ofavailable NICsinterfaces. thatThese are installedpositional onarguments. theThe node server).
--no=<other-NS-name>In a two-node appliance, you may add the nameorder of the otherspecified node-serverinterfaces withcorresponds this option. Replaceto the <other-NS-name> argument with the nameorder of the otherspecified name server.
--in=<other-NS-NIC>In a two-node appliance, you may use this option after --no=<other-NS-name>, to specify the NIC name of the other node-server. Replace <other-NS-NIC> with the NIC name of the other node-server (use the TAB key to display list of NiCs that are installed on the other node-server.nodes.

Examples:

  1. To create a floating IP name Xf11 on address 192.168.20.111 with mask 255.255.255.0 and gateway 192.168.20.1 on nodes s1-6020 with interface so6c and node s1-6021 with interface so91, run

    floatingips create Xf11 --address 192.168.20.111 --mask 255.255.255.0 --gateway 192.168.20.1 --nodes s1-6020 --interfaces so6c --no s1-6021 --in so91

    or

    floatingips create Xf11 --address 192.168.20.111 --mask 255.255.255.0 --gateway 192.168.20.1 --nodes s1-6020 s1-6021 --interfaces so6c so91

  2. To create a dummy floating IP dmy on nodes s1-6020 with interface so6c and node s1-6021 with interface so91, run

    floatingips create ddddmy --dummy --nodes s1-6020 s1-6021 --interfaces so6c so91

Editing a floating IP

To edit a floating IP, use the command floatingips edit.

Usage:

floatingips edit <name> [--newname=<name>] [--dummy]|[--address=<ip> --mask=<subnet> --gateway=<ip>] [--nodes=<NS-name…> --interfaces=<NS-NIC…>]

Options:

Options and arguments Description
<name> To specify the name of the floating IP, replace <name> with the name of the floating IP that you want to edit.
newname=<name> To rename the floating IP. Replace <name> with a new name of your choice.
--dummy To edit a dummy floating IP a dummy floating
--address=<ip> To edit the IP address of the floating IP. Replace <ip> with a new IP address.
--mask=<subnet> To edit the subnet mask address.
--gateway=<ip> To edit the gateway IP address of the network.
--nodes=<NS-name…S1_nodes> To edit the name of the node server, replace <NS-name> with node-server name.
--interfaces=<NS-NIC…interfaces> To edit the name of the network interface card (NIC). Replace <NS-NIC…> with NIC names that are installed in your server nodes (use the TAB key to display list of NICs that are installed on the node-server).

Example:

  1. To rename floating IP xyz to abc, run

    floatingips xyz --newname abc

  2. To rename floating IP mks to flpp and to change its address to 192.168.13.13, run

    floatingips mks --newname flpp --address 192.168.13.13

  3. To rename floating IP Xf11 to fp12 and change its address to 192.168.30.222 with mask 255.255.255.0 and gateway 192.168.30.1 and to change nodes s1-6020 to RH11 with interface mth and node s1-6021 with interface so91, run

    floatingips edit Xf11 --newname fp12 --address 192.168.30.222 --mask 255.255.255.0 --gateway 192.168.30.1 --nodes RH11  s1-6021 --interfaces mth so91

  4. To rename dummy IP ddd to hkk, run

    floatingips  edit ddd --newname hkk

Pairing between local and remote floating IP

A floating IP pair refers to the association of a local floating IP with a remote floating IP. This pairing is required for replicating NAS (Network-Attached Storage) or object storage systems.

The purpose of pairing floating IPs is to establish a connection or link between the local and remote systems, allowing for data replication or synchronization. By assigning a specific name to the pair, you can easily identify and manage the association.

To pair between local and remote floating IPs, use the floatingips pair command.

Usage:

floatingips pair <name> --targetSystem=<local-sys-name> --targetFloatingIp=<remote-sys-name>

Options:

IP with
Options and arguments Description
<name> To specify the name of the floating IP.
--targetSystem=<local-sys-name>To specify the name of the local system. Replace <local-sys-name> with the name ofon the local system.
--targetFloatingIp=targetSystem=<remote-sys-nameremote_system> To specifySpecifies the name of the remote system.system Replaceto pair with. The remote system must be connected to the same relay machine. You can use the TAB auto-complete to show the available systems.
--targetFloatingIp=<remote-sys-nameremote_floating_ip> Specifies the name of the floating IP on the remote system. You can use the TAB auto-complete to show the available floating IPs on the specified target system.

Example:

To use floating IP Xf11 to pair between local system name Cloud1 and remote system name Rem, run

floatingips pair xf11 --targetSystem Cloud1 --targetFloatingIp Rem

Unpairing a floating IP

To un-pair floating IP from a remote system, use the floatingips unpair command

Usage:

floatingips unpair <name> --targetSystem=<local-sys-name>

Options:

Options and arguments Description
<name> To specifySpecifies the name of the floating IP.IP on the local system.
--targetSystem=<local-sys-nameremote_system> To specifySpecifies the name of the localremote system to un-pair from. Replace <local-sys-nameremote_system> with the name of the localremote system.

Example:

  1. Local system name Cloud1 that is paired to a remote system through floating IP name fhr can be un-paired by running:

    floatingips unpair fhr --targetsystem Cloud1

Delete a floating IP

To delete a floating IP, use the floatingips delete command

Usage:

floatingips delete <name>

Options:

Options and arguments Description
<name> To specify the name of the floating IP that you want to delete.

Example:

To delete floating IP name fhr, run

floatingips delete fhr
Back to top