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/.
Harald Welte gerrit-no-reply at lists.osmocom.orgHarald Welte has submitted this change and it was merged. Change subject: OsmoGGSN: more info on non-root operation / tun creation ...................................................................... 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. Add tiny hint at systemd-networkd. Change-Id: I02bd9cfa35c7f2fb338d5d92c2e968fe80574a78 --- M OsmoGGSN/chapters/configuration.adoc 1 file changed, 16 insertions(+), 5 deletions(-) Approvals: Harald Welte: Looks good to me, approved Jenkins Builder: Verified diff --git a/OsmoGGSN/chapters/configuration.adoc b/OsmoGGSN/chapters/configuration.adoc index 9a4c81b..5f61c88 100644 --- a/OsmoGGSN/chapters/configuration.adoc +++ b/OsmoGGSN/chapters/configuration.adoc @@ -250,7 +250,7 @@ achieved by means such as * a custom shell script run as root before starting osmo-ggsn (e.g. as init script) -* systemd .netdev and .network files +* systemd .netdev and .network files, if your system is using systemd-networkd (see `networkctl status`). ==== Manual TUN device creation / configuration @@ -266,8 +266,13 @@ 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 +---- ==== systemd based TUN device creation+configuration @@ -303,10 +308,16 @@ 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 -.Example: using externally configured tun device as non-root +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, +* make sure that `no shutdown` is present in the `apn` section as well as + `no shutdown ggsn` in the `ggsn` section. + +.Example: using externally configured tun device `apn0` as non-root ---- ggsn ggsn0 gtp state-dir /tmp -- To view, visit https://gerrit.osmocom.org/4824 To unsubscribe, visit https://gerrit.osmocom.org/settings Gerrit-MessageType: merged Gerrit-Change-Id: I02bd9cfa35c7f2fb338d5d92c2e968fe80574a78 Gerrit-PatchSet: 3 Gerrit-Project: osmo-gsm-manuals Gerrit-Branch: master Gerrit-Owner: Neels Hofmeyr <nhofmeyr at sysmocom.de> Gerrit-Reviewer: Harald Welte <laforge at gnumonks.org> Gerrit-Reviewer: Jenkins Builder Gerrit-Reviewer: Neels Hofmeyr <nhofmeyr at sysmocom.de>