Repository : ssh://git@open-mesh.org/doc
On branches: backup-redmine/2017-07-13,master
commit eb01d9085bec3ed5288a03ba2c0d7f176bdcf4da Author: Linus Lüssing linus.luessing@c0d3.blue Date: Wed Mar 31 16:55:27 2010 +0000
doc: batman-adv/Troubleshooting: first version of batman-adv troubleshooting guide
eb01d9085bec3ed5288a03ba2c0d7f176bdcf4da batman-adv/Troubleshooting.textile | 30 ++++++++++++++++++++++++++++++ 1 file changed, 30 insertions(+)
diff --git a/batman-adv/Troubleshooting.textile b/batman-adv/Troubleshooting.textile new file mode 100644 index 00000000..00607ae5 --- /dev/null +++ b/batman-adv/Troubleshooting.textile @@ -0,0 +1,30 @@ += B.A.T.M.A.N.-Adv Troubleshooting = +''B.A.T.M.A.N.-Adv does net work as expected, what can I do now?'' + +First, try to minimise the complexity of your setup, i.e. just try to build a simple mesh network between two devices. Usually just following the [wiki/batman-adv-quick-start-guide quick-start-guide] is a good way to start with. + +If you still can't get any setup working at all, go through this checklist: + +=== Any warnings or errors in the kernel log? === +Check 'dmesg' for warnings, errors or crashes. + +=== Are both nodes having the same cell id? === +Check with 'iwconfig'. Some wifi drivers are a little buggy and do not always merge two ad-hoc cells, therefore you're usually best advised to chose and configure one manually (i.e. 'iwconfig wlan0 ap 02:XX:XX:XX:XX:XX'). If configuring a cell-id manually, you should set the 7th bit of the first byte - or start it with "02:" in other words. To keep this id (mostly) unique, using one of the routers mac-address for the rest is usually the safest way to go. + +=== Is 'batctl if' showing the used interfaces as active? === +If batman-adv is saying "[inactive]" for one of the mesh-port interfaces, make sure this one is up (i.e. 'ifconfig wlan0 up') + +=== Is 'batctl o' showing the other node? === +Make sure, that they see each other with a reasonable TQ quality (i.e. > 200). Be aware, that a full TQ update in a dynamic environment but still with the default ogm-interval setting can be delayed for up to 64 seconds. If they are not seeing each other, check your wifi settings twice, try ad-hoc meshing without batman-adv or any bridges first to make sure, that the ad-hoc wifi layer itself works fine and allows any kinds of packets (ad-hoc mode is usually not the best implemented and well tested wifi mode in a lot of wifi drivers). + +=== Are those tq-values rather stable or acting crazy? === +If they are acting crazy, check if the mesh-port interfaces used by batman-adv all have a different mac addresses. Otherwise this could break the routing algoritm in some scenarios. + +=== Does a ping to the other node via the mesh work? === +Set static ipv4-addresses (or (autoconfigured) ipv6 addresses) not being used on any other interfaces on bat0 and check if those two nodes can ping each other. If this works, but large pings do not (i.e. ping -s 1700), then check the MTU settings. All mesh hosts need an MTU of 24 Bytes less (i.e. on bat0 or any host bridged into the mesh) than on their mesh-port interfaces' MTU (the interfaces you've added via 'batctl if'). For instance you could chose to increase the MTU on all mesh-port interfaces to 1524 (or decrease it on all hosts, bat0 or any host interface being bridged into the mesh, to 1476 which is usually harder to maintain when having 'foreign' hosts). + +=== Does 'batctl ping' to the other node work? === +If you can see the other node but can't send any packets through the mesh network, check whether you can ping it with batman-adv's internal echoing packets (see 'batctl ping -h' for usage info). If this works, check your layer 3 settings, in general your routes and IP adresses - don't use the same routes/addresses on different interfaces, don't set any ip-addresses on the mesh-port interfaces. Just use bat0 or the bridge you might have created on top of it. + +=== Are the wifi/lan LEDs blinking like crazy? === +Make sure you DONT bridge any mesh-port-interfaces with your bat0 interface! \ No newline at end of file