ARDEN-documentation/arednHow-toGuides/xlinks.rst

39 lines
4.3 KiB
ReStructuredText
Raw Normal View History

2024-07-18 11:44:22 -06:00
============
Using Xlinks
============
2023-11-03 08:47:36 -06:00
*Contributor: Tim Wilkinson KN6PLV*
2023-11-03 08:47:36 -06:00
2024-07-18 11:44:22 -06:00
A cross-link (xlink) allows you to pass AREDN® traffic across non-AREDN® network links.
2023-11-03 08:47:36 -06:00
2023-11-06 16:10:09 -07:00
Comparison with tunnels
-----------------------
2024-07-18 11:44:22 -06:00
Tunnels and xlinks both connect two nodes together, so they are the same in that respect. However, they do it in very different ways.
2023-11-06 16:10:09 -07:00
2024-07-17 09:03:01 -06:00
**Tunnels** are a simple to use, all in one feature, which operates over your regular Internet to connect two AREDN® nodes. There is a bit of configuration information to exchange, but it is all fairly easy to set up. Tunnels *only work* over your **WAN** connection, you use the IP address given by the server, and there is very little else to configure.
2023-11-06 16:10:09 -07:00
2024-07-18 11:44:22 -06:00
**Xlinks**, on the other hand, are much more basic and flexible. The configuration lets you choose IP addresses yourself, as well as setting a VLAN and *port* on which xlink traffic leaves the device. The IP addresses let the system route the data (OLSR works at layer 3 so every interface needs an IP address), but unlike the tunnel you can set these addresses any way you desire. You choose any unused VLAN number yourself, and the *port* determines how you want the data to be physically sent into or out of the node. How the data is moved to the peer device is not defined in any way, and deliberately so. Maybe you want to connect that *port* directly to a non-AREDN® PtP radio. Maybe you feed it into a switch then use some other tunneling technology to get it where it needs to go. Maybe it is just a bit of Ethernet cable. It is entirely up to you. Personally, I use tunnels to connect nodes over the Internet, but I use xlinks to connect nodes over Point-to-Point radios which are not running AREDN® firmware.
2023-11-03 08:47:36 -06:00
2024-07-17 09:03:01 -06:00
Configure the AREDN® nodes at both ends
2024-07-18 11:44:22 -06:00
---------------------------------------
2023-11-03 08:47:36 -06:00
2024-07-18 11:44:22 -06:00
You can use either a *Mikrotik hAP ac2* or *ac3* as the AREDN® device on each end of the xlink. Navigate to the **Ethernet Ports & Xlinks** page of the node on one side of the link. To add an xlink click the *plus* icon, enter an unused VLAN number for the link, an IP address for the near-side device, an IP address for the far-side device, a weighting factor, the available port to which the near-side device is connected on your node, and the `CIDR <https://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing>`_ netmask. The *Weight* will be used by `OLSR <https://en.wikipedia.org/wiki/Optimized_Link_State_Routing_Protocol>`_ to determine the best route for AREDN® traffic.
2023-11-03 08:47:36 -06:00
2024-06-24 16:10:49 -06:00
.. image:: ../arednGettingStarted/_images/admin-ports-xlinks.png
2024-08-05 09:09:14 -06:00
:alt: Ethernet Ports & Xlinks
2023-11-03 08:47:36 -06:00
:align: center
2024-07-20 14:37:06 -06:00
In this example VLAN ``20`` is not in use anywhere else on the network. We assigned an *IP Address* of ``172.16.1.1`` for the near-side node, and we assigned ``172.16.1.2`` as the *Peer Address* for the node on the other side of the link. The xlink knows nothing about the details or configuration of the intermediate transport devices. The *Weight* is set to ``1`` which is the same weight as would be used by a tunnel connection, but this can be increased if you want the cross-link to be chosen at a lower priority for routing traffic on the mesh. *Port* ``lan3`` was chosen because it is an open port on this node. After entering these values, click ``Done`` and ``Commit`` your changes. Now you can cable your near-side transport device to port 3 on your AREDN® node.
2023-11-03 08:47:36 -06:00
.. image:: _images/xlink.png
2024-07-20 14:37:06 -06:00
:alt: xlink diagram
2023-11-03 08:47:36 -06:00
:align: center
2024-07-20 14:37:06 -06:00
Next, open the **Ethernet Ports & Xlinks** page on the node for the other side of the link. Set the *IP Address* for that node to ``172.16.1.2`` and the *Peer Address* to ``172.16.1.1``. The *Weight* is set to ``1`` and the *Port* is set to ``lan4`` because that is an open port on this node. After entering these values, click ``Done`` and ``Commit`` your changes. Now you can cable your far-side transport device to port 4 on that AREDN® node.
2023-11-03 08:47:36 -06:00
2024-07-20 14:37:06 -06:00
Configure the intermediate transport link
2023-11-03 08:47:36 -06:00
----------------------------------------------
2024-07-20 14:37:06 -06:00
How data is moved between the peer devices is not restricted or defined. There are many types of intermediate transport products that can be used to establish an AREDN® xlink. Refer to your manufacturer's documentation for the best way to ensure that network packets can be successfully transferred between the two endpoint devices. The easiest way to accomplish this is to bridge the traffic directly between the peer devices.