From ec30bdaf3de163cd844592ef22ac8ba837259608 Mon Sep 17 00:00:00 2001
From: Matthias Radestock <matthias.radestock@gmail.com>
Date: Wed, 8 Apr 2015 18:33:39 +0100
Subject: [PATCH] explain kernel settings that need changing

---
 bin/multiweave | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/bin/multiweave b/bin/multiweave
index 23a0491a..a0938e30 100755
--- a/bin/multiweave
+++ b/bin/multiweave
@@ -1,6 +1,16 @@
 #!/bin/bash
 set -e
 
+# You may need to adjust
+#    echo 4096 >/proc/sys/net/ipv4/neigh/default/gc_thresh3
+# where the number is greater than NUM_WEAVES*(NUM_WEAVES-1) plus some
+# fudge.
+#
+# Without that, some connections between the weaves may fail to get
+# established, and networking on the host in general becomes
+# broken. There will also be some "net_ratelimit: nnn callbacks
+# suppressed" messages in the syslog.
+
 START=${FIRST_WEAVE:-1}
 COUNT=${NUM_WEAVES:-28}
 FINISH=$((START+COUNT-1))