Review at https://gerrit.osmocom.org/4912
OsmoGGSN: add IP forward and Masquerading section
Change-Id: Ie49ca7a45113f49e89ce09017500008cbec757f5
---
M OsmoGGSN/chapters/running.adoc
1 file changed, 24 insertions(+), 0 deletions(-)
git pull ssh://gerrit.osmocom.org:29418/osmo-gsm-manuals
refs/changes/12/4912/1
diff --git a/OsmoGGSN/chapters/running.adoc b/OsmoGGSN/chapters/running.adoc
index ef899b5..82e2390 100644
--- a/OsmoGGSN/chapters/running.adoc
+++ b/OsmoGGSN/chapters/running.adoc
@@ -20,6 +20,30 @@
used. If none is specified, use `osmo-ggsn.cfg` in the current
working directory.
+=== Enable IP Forwarding and Masquerading
+
+To be able to route data traffic between subscribers' IP addresses and an
+internet uplink, OsmoGGSN usually requires IP Forwarding and Masquerading to be
+enabled on the system.
+
+To manually enable IPv4 forwarding and masquerading ad-hoc, you can do:
+
+----
+sh -c "echo 1 > /proc/sys/net/ipv4/ip_forward"
+iptables -t nat -A POSTROUTING -o '*' -j MASQUERADE
+----
+
+(You may want to replace `*` with the network device name, like `-o eth0`)
+
+To enable IP forwarding persistently:
+
+----
+sh -c "echo net.ipv4.ip_forward=1 > /etc/sysctl.d/99-ip-forward-v4.conf"
+----
+
+There are various ways to enable Masquerading persistently, please refer to
+your distribution's documentation (for example
https://wiki.debian.org/iptables).
+
=== Multiple instances
Running multiple instances of `osmo-ggsn` is possible if all GGSN instances
--
To view, visit https://gerrit.osmocom.org/4912
To unsubscribe, visit https://gerrit.osmocom.org/settings
Gerrit-MessageType: newchange
Gerrit-Change-Id: Ie49ca7a45113f49e89ce09017500008cbec757f5
Gerrit-PatchSet: 1
Gerrit-Project: osmo-gsm-manuals
Gerrit-Branch: master
Gerrit-Owner: Neels Hofmeyr <[email protected]>
