nils/gluon
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

gluon-core: Document support for additional wired mesh-interfaces

Browse Source 
Documents the changes introduced in #2041
This commit is contained in:
Marvin Gaube 2020-06-20 18:54:34 +02:00
parent 2be6fe32e6
commit b6f943a054
2 changed files with 37 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
docs/dev/mac_addresses.rst
View File

@ -1,3 +1,5 @@
.. _dev-mac-addresses:
MAC addresses MAC addresses
============= =============
@ -16,3 +18,9 @@ Gluon tries to solve this issue by using a hash of the primary MAC address as a
* 5: mesh1 * 5: mesh1
* 6: owe1 * 6: owe1
* 7: wan_radio1 (private WLAN); mesh VPN * 7: wan_radio1 (private WLAN); mesh VPN
When you need another MAC address, e.g. for adding another Mesh-Interface,
pick an index from an unused feature on your device.
Example: if you don't have wireless meshing enabled on 5 GHz (mesh1),
you can go with index 5.

29
docs/features/wired-mesh.rst
View File

@ -85,3 +85,32 @@ Disable Mesh-on-LAN::
Please note that this configuration has changed in Gluon 2016.1. Using Please note that this configuration has changed in Gluon 2016.1. Using
the old commands on 2016.1 and later will break the corresponding options the old commands on 2016.1 and later will break the corresponding options
in the *Advanced settings*. in the *Advanced settings*.
Mesh on other interfaces
========================
In some cases you may want to mesh on more interfaces than only LAN or WAN.
This is especially useful if you have multiple other nodes connected to a central node,
and don't want them to mesh with each other, but only the central node.
In this case, you may need to isolate them via VLANs on the device switch.
Starting from Gluon 2020.2 it's possible to configure additional mesh-interfaces
by adding an interface configuration with the proto ``gluon_wired``::
uci set network.mesh_add=interface
uci set network.mesh_add.proto=gluon_wired
uci set network.mesh_add.index=2
uci set network.mesh_add.disabled='0'
uci set network.mesh_add.transitive='1'
uci set network.mesh_add.ifname='eth2'
``ifname`` is the mesh hardware-interface. This could be a VLAN.
``index`` must be between 0 and 7, and is used to generate the used MAC.
Be careful when selecting the index,
see :ref:`MAC addresses <dev-mac-addresses>` for details.
Before the changes take effect, the node needs a reboot or
``gluon-reconfigure`` to update the firewall.
This configuration should survive updates.