Digimer: Created page with "{{howto_header}} The Anvil! Cluster implements four main network types, each of which there could be one or more of. = Anvil! Networks = {| class="wikitable" !style="white-space:nowrap; text-align:center;"|Network Name !style="white-space:nowrap; text-align:center;"|Prefix !style="white-space:nowrap; text-align:center;"|Subnet !style="white-space:nowrap; text-align:center;"|Used By !style="white-space:nowrap; text-align:center;"|Description |- !style="white-space..."

2023-10-22T16:17:26Z

Created page with "{{howto_header}} The Anvil! Cluster implements four main network types, each of which there could be one or more of. = Anvil! Networks = {| class="wikitable" !style="white-space:nowrap; text-align:center;"|Network Name !style="white-space:nowrap; text-align:center;"|Prefix !style="white-space:nowrap; text-align:center;"|Subnet !style="white-space:nowrap; text-align:center;"|Used By !style="white-space:nowrap; text-align:center;"|Description |- !style="white-space..."

Páàjì titun

{{howto_header}}

The [[Anvil! Cluster]] implements four main network types, each of which there could be one or more of.

= Anvil! Networks =

{| class="wikitable"
!style="white-space:nowrap; text-align:center;"|Network Name
!style="white-space:nowrap; text-align:center;"|Prefix
!style="white-space:nowrap; text-align:center;"|Subnet
!style="white-space:nowrap; text-align:center;"|Used By
!style="white-space:nowrap; text-align:center;"|Description
|-
!style="white-space:nowrap; text-align:left;"|Back-Channel Network
|BCN
|style="text-align:center;"|10.20{x}/16
|All Machines
|The BCN is used for cluster communications and monitoring of [[foundation pack]] equipment.
|-
!style="white-space:nowrap; text-align:left;"|Internet-Facing Network
|IFN
|class="span"; style="text-align:center;"|<user defined>
|All Machines
|The IFN is the connection between the servers hosted on the Anvil! and the user's main network. The subnet of this network is, therefor, defined by you.
|-
!style="white-space:nowrap; text-align:left;"|Storage Network
|SN
|style="text-align:center;"|10.10{x}/16
|Nodes, some DR
|The SN is used for storage replication and nothing else. This is often connected back to back between [[subnodes]] in an Anvil! node. When connecting to a DR host
|-
!style="white-space:nowrap; text-align:left;"|Migration Network
|MN
|style="text-align:center;"|10.199/16
|Nodes
|The MN is an ''optional'' back-to-back network link used between subnodes. When this network is available, when a hosted server live-migrates, the contents of the server's RAM is copied over this dedicated network. When this network is not available, RAM copy happens over the BCN (which, in some high load cases, could cause contention).
|}

== Back-Channel Network ==

Back-Channel Networks are the primary networks used by the various Anvil! cluster machines. Examples;

* Commands from the Striker dashboard are transmitted to the nodes and DR hosts via the BCN.
* [[Scancore]] used the BCN to communicate with [[UPS]]es, [[PDU]]s, [[IPMI]] out-of-band management interfaces, etc.
* Servers being live-migrated between subnodes, when the [[MN]] is not available, copies over the BCN

Most clusters have a single BCN, which uses the subnet 10.201/16. If there's need for a second BCN, it would be 10.202/16, and so forth, with the third digit of the second octet matching the network's sequence number (ie: BCN1 uses 10.201.x.y).

=== Device IP Addresses ===

{{note|1=The IPs assigned to devices on the BCN match how IPs are assigned on other networks. The way IPs are assigned will be discussed in detail here.}}

In the BCN, SN and MN, the third octet of the IP indicates the device type, and the fourth octet defines the sequence number. The third octet will be between 1~9 for Strikers and foundation pack devices. The third octet of 10 and higher is assigned to nodes and DR hosts.

Lets lay this out in a table so that it makes more sense. For this example, 10.201/16 will be used as we're in the BCN section. Note that, where applicable, the same third and fourth octets will be used for the SN and MN also.

{| class="wikitable"
!style="white-space:nowrap; text-align:center;"|Device
!Third Octet
!Example (first device)
|-
|Ethernet Switches
|class="code"|1
|class="code"|10.201.'''1'''.'''1'''
|-
|Switched [[PDU]]
|class="code"|2
|class="code"|10.201.'''2'''.'''1'''
|-
|Managed [[UPS]]
|class="code"|3
|class="code"|10.201.'''3'''.'''1'''
|-
|Striker Dashboard
|class="code"|4
|class="code"|10.201.'''4'''.'''1'''
|-
|Striker [[IPMI]]
|class="code"|5
|class="code"|10.201.'''5'''.'''1'''
|}

The octets 6 through 9 are not yet assigned to any device type.

Anvil! [[nodes]] start with the octet 10 for node 1, 12 for node 2, 14 for node 3, and so on. The reason for jumping by two is to allow for the next octet up to be used by the subnode's IPMI interface. Lets look at an example;

{| class="wikitable"
!style="white-space:nowrap; text-align:center;"|Node
!Subnode
!BCN 1 - IP
!IPMI - IP
|-
|rowspan="2"|Node 1 (an-anvil-01)
|class="code"|an-a01n01
|class="code"|10.201.'''10'''.'''1'''
|class="code"|10.201.'''11'''.'''1'''
|-
|class="code"|an-a01n02
|class="code"|10.201.'''10'''.'''2'''
|class="code"|10.201.'''11'''.'''2'''
|-
|rowspan="2"|Node 2 (an-anvil-02)
|class="code"|an-a02n01
|class="code"|10.201.'''12'''.'''1'''
|class="code"|10.201.'''13'''.'''1'''
|-
|class="code"|an-a02n02
|class="code"|10.201.'''12'''.'''2'''
|class="code"|10.201.'''13'''.'''2'''
|-
|rowspan="2"|Node 3 (an-anvil-03)
|class="code"|an-a03n01
|class="code"|10.201.'''14'''.'''1'''
|class="code"|10.201.'''15'''.'''1'''
|-
|class="code"|an-a03n02
|class="code"|10.201.'''14'''.'''2'''
|class="code"|10.201.'''15'''.'''2'''
|-
|rowspan="2"|Node 4 (an-anvil-04)
|class="code"|an-a04n01
|class="code"|10.201.'''16'''.'''1'''
|class="code"|10.201.'''17'''.'''1'''
|-
|class="code"|an-a03n02
|class="code"|10.201.'''16'''.'''2'''
|class="code"|10.201.'''17'''.'''2'''
|-
|rowspan="2"|Node 5 (an-anvil-05)
|class="code"|an-a05n01
|class="code"|10.201.'''18'''.'''1'''
|class="code"|10.201.'''19'''.'''1'''
|-
|class="code"|an-a05n02
|class="code"|10.201.'''18'''.'''2'''
|class="code"|10.201.'''19'''.'''2'''
|}

{{note|1=Generally, [[DR Hosts]] are assigned to a node, matching its hardware. This isn't required, a DR host can protect servers from multiple nodes, but the IP assignment is based around peering DR hosts to nodes. As such, DR hosts have host names and IPs that link them to a node. If you plan to use a DR host for multiple nodes, you can connect it to which ever node you like. The naming and IPs are not used to enforce any actual linkages.}}

With the above note said, we'll show an example where there is a DR host per node.

{| class="wikitable"
!style="white-space:nowrap; text-align:center;"|Node
!DR Host
!BCN 1 - IP
!IPMI - IP
|-
|class="code"|an-anvil-01
|class="code"|an-a01dr01
|class="code"|10.201.'''10'''.'''3'''
|class="code"|10.201.'''11'''.'''3'''
|-
|class="code"|an-anvil-02
|class="code"|an-a02dr01
|class="code"|10.201.'''12'''.'''3'''
|class="code"|10.201.'''13'''.'''3'''
|-
|class="code"|an-anvil-03
|class="code"|an-a03dr01
|class="code"|10.201.'''14'''.'''3'''
|class="code"|10.201.'''15'''.'''3'''
|-
|class="code"|an-anvil-04
|class="code"|an-a04dr01
|class="code"|10.201.'''16'''.'''3'''
|class="code"|10.201.'''17'''.'''3'''
|-
|class="code"|an-anvil-05
|class="code"|an-a05dr01
|class="code"|10.201.'''18'''.'''3'''
|class="code"|10.201.'''19'''.'''3'''
|}

If you wanted to link additional DR hosts to a given node, you can do so by setting the fourth octet to 4, etc.

== Internet-Facing Network ==

This is the network used to connect machines in the Anvil! cluster to your network. For fully-offline installations, this could better be called the '''Intranet-Facing Network''', but either way, '''IFN''' is an accurate acronym.

The IFN is used for all traffic going into and out of the servers hosted on the Anvil! node(s). It is also the network used to connect to the Striker Dashboard's web interface, using to manage the Anvil! cluster. Lastly, when needed, it is usually the network used by [[Alteeve]] (with a support contract) to connect into the Anvil! cluster to provide support. Beyond this, the Anvil! does all it can to minimize it's use of the IFN, reserving as much bandwidth as possible for the hosted servers.

When the IFN is not yet defined, we recommend that the same method of using the third octet to identify the device type, and the fourth octet to define the device sequence number. Understandably though, this is rarely possible. As such, it is up to you to decide how IPs on the IFN are allocated to the various machines in the cluster.

== Storage Network ==

Storage in an Anvil! node is kept synchronously replicated between the two subnodes over a dedicated network connection. This replication traffic uses the dedicated '''Storage Network''', and nothing else uses that network to ensure minimum latency and maximum bandwidth.

This works by capturing the incoming write to storage from the guest server, and sending a copy to the peer subnode. When the data reaches persistent storage (or protected cache, like flash-backed write cache), the server's storage driver is told that the right is complete. This way, if the active subnode is destroyed without warning, the server will reboot on the surviving subnode, and recover just as is it was a normal server that lost power.

The storage network can be run through a switch, or it can be back-to-back connection between the subnodes. The subnet is 10.10x, where 'x' indicates the specific storage network. In almost all installations, there is only one storage network, and so the subnet is usually 10.101/16.

The storage network can be used for replication to [[DR hosts]], but it isn't required. When switching infrastructure is fast enough, running the SN through switches will allow the DR's storage network connection to receive the replication data on that dedicated network. However, given DR hosts are usually outside the local location, it's not often possible for this to be done. So in most cases, the storage network is connected back-to-back in the nodes, and the DR replication traffic will be sent over the BCN (or IFN, if that's the only available link).

=== Device IP Addresses ===

The IP addresses used on the '''SN''' match the '''BCN''' IPs, save for the different subnet (ie: 10.201.10.1 on the BCN 1, 10.101.10.1 on the SN 1).

Given that there is no IPMI on the storage network, the third octet indicating the node simply jumps by two. For example;

{| class="wikitable"
!style="white-space:nowrap; text-align:center;"|Node
!Subnode
!SN 1 - IP
|-
|rowspan="2"|Node 1 (an-anvil-01)
|class="code"|an-a01n01
|class="code"|10.101.'''10'''.'''1'''
|-
|class="code"|an-a01n02
|class="code"|10.101.'''10'''.'''2'''
|-
|rowspan="2"|Node 2 (an-anvil-02)
|class="code"|an-a02n01
|class="code"|10.101.'''12'''.'''1'''
|-
|class="code"|an-a02n02
|class="code"|10.101.'''12'''.'''2'''
|-
|rowspan="2"|Node 3 (an-anvil-03)
|class="code"|an-a03n01
|class="code"|10.101.'''14'''.'''1'''
|-
|class="code"|an-a03n02
|class="code"|10.101.'''14'''.'''2'''
|-
|rowspan="2"|Node 4 (an-anvil-04)
|class="code"|an-a04n01
|class="code"|10.101.'''16'''.'''1'''
|-
|class="code"|an-a03n02
|class="code"|10.101.'''16'''.'''2'''
|-
|rowspan="2"|Node 5 (an-anvil-05)
|class="code"|an-a05n01
|class="code"|10.101.'''18'''.'''1'''
|-
|class="code"|an-a05n02
|class="code"|10.101.'''18'''.'''2'''
|}

== Migration Network ==

When the Anvil! determines that the active host for a server is degraded, or when an operator chooses to move a server for any reason, a frozen clone of the server is created on the peer subnode. The RAM, actively in use, starts to be copied over to the frozen copy of the server. This is the process that determines how long a live migration will take to complete.

Without a migration network, the RAM copy is done over the BCN. However, the BCN must go through a switch, and that often sets a limit on the bandwidth available, both because of the cost of higher speed switches, and also because of competing with other network traffic.

The migration network is an optional network used exclusively for copying the RAM of running servers during live migration. This is almost always run back-to-back between the subnodes in an Anvil! node, and it is not used for any other purpose. As such, a migration network can greatly reduce the time for live migrations to complete.

=== Subnode IP Assignement ===

Given that nothing else uses the MN, there is no reason for a second MN to exist. So the subnet is almost always 10.199/16. As above, the third and fourth octets indicate the node and subnode sequence.

{| class="wikitable"
!style="white-space:nowrap; text-align:center;"|Node
!Subnode
!MN 1 - IP
|-
|rowspan="2"|Node 1 (an-anvil-01)
|class="code"|an-a01n01
|class="code"|10.199.'''10'''.'''1'''
|-
|class="code"|an-a01n02
|class="code"|10.199.'''10'''.'''2'''
|-
|rowspan="2"|Node 2 (an-anvil-02)
|class="code"|an-a02n01
|class="code"|10.199.'''12'''.'''1'''
|-
|class="code"|an-a02n02
|class="code"|10.199.'''12'''.'''2'''
|-
|rowspan="2"|Node 3 (an-anvil-03)
|class="code"|an-a03n01
|class="code"|10.199.'''14'''.'''1'''
|-
|class="code"|an-a03n02
|class="code"|10.199.'''14'''.'''2'''
|-
|rowspan="2"|Node 4 (an-anvil-04)
|class="code"|an-a04n01
|class="code"|10.199.'''16'''.'''1'''
|-
|class="code"|an-a03n02
|class="code"|10.199.'''16'''.'''2'''
|-
|rowspan="2"|Node 5 (an-anvil-05)
|class="code"|an-a05n01
|class="code"|10.199.'''18'''.'''1'''
|-
|class="code"|an-a05n02
|class="code"|10.199.'''18'''.'''2'''
|}

= Network Interface Types =

In the Anvil!, there are three types of network types.

== Interfaces ==

A network interface is a single, traditional network interface. Specifically, an '''interface''' is a physical connection to a specific port on a switch, or another machine.

== Bonds ==

A bonded interface is a virtual interface, made up using two physical network interfaces. The two real interfaces are "bonded" together to function as a single interface, but with the benefit of fault tolerance. If the active interface fails, the backup interface will take over extremely quickly, preventing any connections from being dropped or interrupted.

More specifically, the Anvil! uses "[https://www.ibm.com/docs/ja/linux-on-systems?topic=recommendations-bonding-modes mode=1 (active-backup)]" bonds. This bonding mode provides the fastest fault-detection and recovery out of all the available bonding modes in Linux.

Note that it is the only mode that does ''NOT'' aggregate bandwidth. That is to say, bonding two 10 Gbps interfaces results in a bonded interface that runs at 10 Gbps, '''not''' 20 Gbps. The reason for this is primarily the speed of fault detection and recovery, but also to ensure consistent performance in a fault condition.

As a principle of [[Intelligent Availability]]; If 10 Gbps (in this example) is not fast enough for normal operation, then faster interfaces should be used. If 10 Gbps is fast enough, then there's no reason to aggregate the bandwidth to 20 Gbps (which would fall to 10 Gbps on link failure).

== Bridges ==

A bridge is a virtual "ethernet switch". A bridged interface (which can connect to a bond or simple interface) acts as a "bridge" between hosted servers and the outside network.

Each server will have one (or more) virtual network interfaces. These interfaces, outside the server, needs to "plug into" a switch. Being that the servers are virtual, this connection is done using a special vnetX interface that is created when the server boots, and is deleted when the server migrates or shuts off. This transient vnetX device acts like a network cable, and "plugs into" a bridge.

The bridge itself connects to the outside world, almost always via a bridge interface, which in turn sends and receives data on the active interface to the outside world.

By default, all servers created on the Anvil! nodes have a single network interface connected to the ''Internet-Facing Network'' bridge. Optionally, an operator could add a second interface to connect to the ''Back-Channel Network'' if desired, or simply move the existing interface off of the IFN bridge over to the BCN bridge.

{{footer}}

Anvil! Networking - Revision history