Floating IPs

A floating IP is an IP address that can be dynamically assigned to different servers or nodes in a network. It can be used to provide high availability and fail over capabilities between multiple nodes.

In the S1 system, two node servers 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.

Listing floating IPs

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

Usage:

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

Options:

Options and arguments	Description
`<anme>`	To filter the list by a specific floating IP name.
`--ip=<ip>`	To filter the list by an IP address.

Examples:

To list all floating IP addresses in S1 system, run
```
floatingips list 
```
To display floating IP details for floating IP name Xf11, run
```
floatingips list Xf11
```
To display floating IP details for floating IP address 192.168.20.11, run
```
floatingips list --ip 192.168.20.11
```
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…> --interfaces=<NS-NIC…>

Options:

Options and arguments	Description
`<name>`	To name of the floating IP, replace `<name>` with a name of your choice.
`--dummy`	To create a dummy floating IP, primarily used for replication transitions purposes.
`--address=<ip>`	To specify the IP address of the newly created floating IP. Replace `<ip>` with an IP address.
`--mask=<subnet>`	To specify the `subnet` mask address.
`--gateway=<ip>`	To specify the gateway IP address of the network.
`--nodes=<NS-name…>`	To specify the name of the node server, replace `<NS-name>` with the name of the name server.
`--interfaces=<NS-NIC…>`	To specify the network interface card (NIC) names. Replace `<NS-NIC…>` with the name of the 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).
`--no=<other-NS-name>`	In a two-node appliance, you may add the name of the other node-server with this option. Replace the `<other-NS-name>` argument with the name of the other 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.

Examples:

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

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

To create a dummy floating IP dmy on nodes s1-6020 with interface so6c and node s1-6021 with interface so91, run
```
floatingips create ddd --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…>`	To edit the name of the node server, replace `<NS-name>` with node-server name.
`--interfaces=<NS-NIC…>`	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:

To rename floating IP xyz to abc, run
```
floatingips xyz --newname abc
```
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
```
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
```
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:

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 of the local system.
`--targetFloatingIp=<remote-sys-name>`	To specify the name of the remote system. Replace `<remote-sys-name>` with the name of the remote 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 specify the name of the floating IP.
`--targetSystem=<local-sys-name>`	To specify the name of the local system to un-pair from. Replace `<local-sys-name>` with the name of the local system.

Example:

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

Last updated on 15 Nov 2022
Published on 30 Oct 2022