[PATCH] osmo-gsm-manuals[master]: OsmoGGSN: more info on non-root operation / tun creation

This is merely a historical archive of years 2008-2021, before the migration to mailman3.

A maintained and still updated list archive can be found at https://lists.osmocom.org/hyperkitty/list/gerrit-log@lists.osmocom.org/.

Neels Hofmeyr gerrit-no-reply at lists.osmocom.org
Mon Nov 13 01:52:51 UTC 2017


Review at  https://gerrit.osmocom.org/4824

OsmoGGSN: more info on non-root operation / tun creation

Add examples for 'ip addr add' and mention correspondence to config file,
add examples for enabling masquerading and IP forwarding,
place the non-root config in its own section and highlight the diffs.

Change-Id: I02bd9cfa35c7f2fb338d5d92c2e968fe80574a78
---
M OsmoGGSN/chapters/configuration.adoc
1 file changed, 20 insertions(+), 3 deletions(-)


  git pull ssh://gerrit.osmocom.org:29418/osmo-gsm-manuals refs/changes/24/4824/1

diff --git a/OsmoGGSN/chapters/configuration.adoc b/OsmoGGSN/chapters/configuration.adoc
index 9a4c81b..b7b292b 100644
--- a/OsmoGGSN/chapters/configuration.adoc
+++ b/OsmoGGSN/chapters/configuration.adoc
@@ -266,8 +266,20 @@
 Where _username_ and _groupname_ correspond to the User and Group that will have ownership over the
 device, i.e. the privileges which you intend to run osmo-ggsn under, and _apn0_ will be the
 name of the network device created.  After creating the interface, you can configure its addresses
-using standard means like `ip addr add` or your distribution-specific utilities/tools.
+using standard means like `ip addr add` or your distribution-specific utilities/tools
+to match the `ip prefix dynamic` config item, and activate the link, for example:
 
+----
+# ip addr add 192.168.7.0/24 dev apn0
+# ip link set apn0 up
+----
+
+To manually enable IP forwarding and masquerading, you can do:
+
+----
+# sh -c "echo 1 > /proc/sys/net/ipv4/ip_forward"
+# iptables -t nat -A POSTROUTING -o '*' -j MASQUERADE
+----
 
 ==== systemd based TUN device creation+configuration
 
@@ -303,8 +315,13 @@
     You may not want this if you have proper end-to-end routing set up, and want to have transparent
     inbound IP access to your GPRS-attached devices.
 
-The pair of the configuration files above allows you to create and configure tun device which can be
-used by OsmoGGSN as follows.
+==== Config Changes
+
+With the tun device pre-configured in one of the ways outlined above, the main
+changes in your osmo-ggsn.cfg file are:
+
+* remove `ip ifconfig` directive,
+* add `no shutdown` under the `apn` section.
 
 .Example: using externally configured tun device as non-root
 ----

-- 
To view, visit https://gerrit.osmocom.org/4824
To unsubscribe, visit https://gerrit.osmocom.org/settings

Gerrit-MessageType: newchange
Gerrit-Change-Id: I02bd9cfa35c7f2fb338d5d92c2e968fe80574a78
Gerrit-PatchSet: 1
Gerrit-Project: osmo-gsm-manuals
Gerrit-Branch: master
Gerrit-Owner: Neels Hofmeyr <nhofmeyr at sysmocom.de>



More information about the gerrit-log mailing list