Gateways in bmx6¶

The gateways of the mesh are those nodes who are able to reach some other networks, such as the Internet or another wireless community,and are used as a door for the nodes of the mesh who cannot reach these networks directly.

In bmx6 these gateways are reached using IP tunnels between the node who offer the network and the node who wants to fetch the network.

The list of tunnels can be seen from the web interface (Mesh -> Tunnels) or from the terminal using the command "bmx6 -c --tunnels".

A node (not gateway) should look for some specific network, as shown in the next /etc/config/bmx6 configuration example:

config 'tunOut'
    option 'tunOut' 'ipv6'
    option 'network' '::/0'

config 'tunOut'
    option 'tunOut' 'inet'
    option 'network' '0.0.0.0/0'
    option 'maxPrefixLen' '0'

config 'tunOut'  
    option 'tunOut' 'guifi'    
    option 'network' '10.0.0.0/8'
    option 'maxPrefixLen' '8'

config 'tunOut'
    option 'tunOut' 'cloud'
    option 'network' '10.0.0.0/8'
    option 'minPrefixLen' '16'

1. ipv6 Look for all IPv6 announcements
2. inet Look only for v4 internet 0.0.0.0/0 (and not smaller)
3. guifi Look for the big announcements to other networks, inside the subnetwork 10.0.0.0/8 not smaller than /8
4. cloud Lookg for all (small) announcements from /16 to /32 inside the subnetwork 10.0.0.0/8

In the mesh network there might be several gateways publishing the same network, in such case the node will choose his best path.
There are many options which can be used to modify the path decision, for instance one quite useful is the "gwName".

config 'tunOut'  
        option 'tunOut' 'guifi'    
        option 'network' '10.0.0.0/8'
        option 'maxPrefixLen' '8'
        option 'gwName' 'GSmVictoria-RK71'

In this example, if exist a node named "GSmVictoria-RK71" publishing the network 10.0.0.0/8 it will be selected and not the another ones.

Gateways in qMp¶

QMP implements an abstraction layer of the bmx6 gateways. It is configured in the file /etc/config/gateways which can look like this (there is also a nice web interface under Configuration->Gateways to manage them):

config gateway 'inet6'
     option type 'search'
    option network '::/0'
     option maxPrefixLen '0'
    option tableRule '32767/253'
    option ignore '0'

config gateway 'inet6_offer'
    option type 'offer'
    option network '::/0'
    option ignore '1'

config gateway 'inet4'
    option type 'search'
    option network '0.0.0.0/0'
     option maxPrefixLen '0'
    option tableRule '32767/253'
     option ignore '0'

config gateway 'inet4_offer'
    option type 'offer'
    option network '0.0.0.0/0'
     option ignore '1'

config gateway 'cloud'
     option type 'search'
     option network '10.0.0.0/8'
     option minPrefixLen '24'

config gateway 'cloud6'
    option type 'search'
    option network '::/0'
     option minPrefixLen '48'

config gateway 'community'
     option type 'search'
     option network '10.0.0.0/8'
     option maxPrefixLen '8'
     option gwName 'UPCc6-65ab'

config gateway 'community6'
     option type 'search'
     option network '::/0'
     option minPrefixLen '32'
     option maxPrefixLen '48'

config gateway 'community_offer'
    option type 'offer'
    option network '10.0.0.0/8'
    option ignore '1'

config gateway 'example'
    option ignore '1'
    option type 'search'
    option gwName 'qMp-example'
    option network '10.1.0.0/16'
    option address '10.2.2.2/32'
    option minPrefixLen '16'
    option maxPrefixLen '24'
    option hysteresis '20'
    option bonus '10'
    option minBandwidth '10000'
    option exportDistance '10'

config gateway 'inet4_upc'
    option type 'search'
    option network '0.0.0.0/0'
    option gwName 'UPCc6-alix1c'
    option maxPrefixLen '0'
    option bonus '20'
<pre>

h2. More info about qMp gateways (copy&pasted from mailing list)

To choose the best GW bmx6 consider several things:

- PathMetric (based on packet losses of the e2e path)
- Bandwidth announced
- Bonus/Hysteresis/etc...

If you go to one node via web interface, under Mesh->Tunnels you will
find this information. The final calculation is the row named "Tun Metric".

The Hysteresis defines how good has to be an alternative GW to select it
(by default it is 20%). So you can consider this scenario:

- GW A is the best (TunMetric=100)
- GW B is not so good (TunMetric=85)
- Node C is looking for a gateway

So Node C will select GW A because it is better. However in some moment
node A reboots because of an electricity problem. Then node C will
select GW B because it is the only remaining choice. After 5 minuts GW A
comes back, but as the Hysteresis is set tun 20% it won't be selected
again until B or C reboot.

So, this could be your scenario, I don't know. To solve this bmx6 will
implement a window time before the hysteresis is taken into account.

Another typical problem is that two GW are announcing different
bandwidth. The bandwidth has a big impact in the TunMetric calculation.
In old versions of qMp the default announced BW was 1Mbit/s. But in
newer versions it has changed to the bmx6 default which is 100Kbit/s.
So it could happen that a node is announcing 1Mbit/s and the other
100Kbit/s, so all nods will select the first one.

To solve this (actually it was a treated in a long mailing list thread)
the best option would be to remove all the bandwidth announcements and
leave bmx6 use the default bandwidth announcement (which is 100Kbit/s).
So if all GW are announcing the same, bmx6 will take into account only
the PathMetric.
Enter into the gateways, look into the file /etc/config/gateways and
remove all the lines which configures the "bandwidth".

There is also another solution which consists in setting minBW=0 in the
non-GW nodes. This will do that the nodes do not look in the bandwidth
announcements of the GW but only in the PathMetric. I'll add this by
default in future versions of qMp.