<p>osmith has uploaded this change for <strong>review</strong>.</p><p><a href="https://gerrit.osmocom.org/c/osmo-ggsn/+/23159">View Change</a></p><pre style="font-family: monospace,monospace; white-space: pre-wrap;">doc/manuals: describe GTP-U kernel module<br><br>Related: OS#3209<br>Change-Id: Ib45cbfe03077960f216a83cf500ab3203d02cb3b<br>---<br>M doc/manuals/chapters/running.adoc<br>1 file changed, 41 insertions(+), 0 deletions(-)<br><br></pre><pre style="font-family: monospace,monospace; white-space: pre-wrap;">git pull ssh://gerrit.osmocom.org:29418/osmo-ggsn refs/changes/59/23159/1</pre><pre style="font-family: monospace,monospace; white-space: pre-wrap;"><span>diff --git a/doc/manuals/chapters/running.adoc b/doc/manuals/chapters/running.adoc</span><br><span>index 51b8ae2..3a4d832 100644</span><br><span>--- a/doc/manuals/chapters/running.adoc</span><br><span>+++ b/doc/manuals/chapters/running.adoc</span><br><span>@@ -80,3 +80,44 @@</span><br><span> ggsn ggsn0</span><br><span>  gtp bind-ip 127.0.0.2</span><br><span> ----</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+=== GTP-U kernel module</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+OsmoGGSN has support to use the Linux kernel GTP-U code to accelerate the</span><br><span style="color: hsl(120, 100%, 40%);">+data/user plane while still implementing the control plane (GTP-C) in userspace</span><br><span style="color: hsl(120, 100%, 40%);">+in OsmoGGSN. The kernel code is included in Linux 4.7.0 and higher. Notably the</span><br><span style="color: hsl(120, 100%, 40%);">+Debian GNU/Linux distribution has it enabled by default (as module).</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+In order to use this feature, make sure that your Linux kernel was configured</span><br><span style="color: hsl(120, 100%, 40%);">+to support it (`CONFIG_GTP=m` or `=y`). Furthermore, `osmo-ggsn` must have been</span><br><span style="color: hsl(120, 100%, 40%);">+built with `./configure` argument `--enable-gtp-linux`.</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+Load the kernel module with:</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+----</span><br><span style="color: hsl(120, 100%, 40%);">+$ sudo modprobe gtp</span><br><span style="color: hsl(120, 100%, 40%);">+----</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+Then start OsmoGGSN with a configuration file that uses `gtpu-mode kernel-gtp`.</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+A full example configuration is in `osmo-ggsn-kernel-gtp.cfg`.</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+----</span><br><span style="color: hsl(120, 100%, 40%);">+$ sudo osmo-ggsn -c /usr/share/doc/osmo-ggsn/examples/osmo-ggsn-kernel-gtp.cfg</span><br><span style="color: hsl(120, 100%, 40%);">+----</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+.Example: APN with kernel-gtp</span><br><span style="color: hsl(120, 100%, 40%);">+----</span><br><span style="color: hsl(120, 100%, 40%);">+ggsn ggsn0</span><br><span style="color: hsl(120, 100%, 40%);">+ gtp state-dir /tmp</span><br><span style="color: hsl(120, 100%, 40%);">+ gtp bind-ip 127.0.0.2</span><br><span style="color: hsl(120, 100%, 40%);">+ apn internet</span><br><span style="color: hsl(120, 100%, 40%);">+  gtpu-mode kernel-gtp</span><br><span style="color: hsl(120, 100%, 40%);">+  tun-device tun4</span><br><span style="color: hsl(120, 100%, 40%);">+  type-support v4</span><br><span style="color: hsl(120, 100%, 40%);">+  ip prefix dynamic 172.16.222.0/24</span><br><span style="color: hsl(120, 100%, 40%);">+  ip dns 0 8.8.8.8</span><br><span style="color: hsl(120, 100%, 40%);">+  ip dns 1 8.8.4.4</span><br><span style="color: hsl(120, 100%, 40%);">+  ip ifconfig 172.16.222.0/24</span><br><span style="color: hsl(120, 100%, 40%);">+  no shutdown</span><br><span style="color: hsl(120, 100%, 40%);">+----</span><br><span></span><br></pre><p>To view, visit <a href="https://gerrit.osmocom.org/c/osmo-ggsn/+/23159">change 23159</a>. To unsubscribe, or for help writing mail filters, visit <a href="https://gerrit.osmocom.org/settings">settings</a>.</p><div itemscope itemtype="http://schema.org/EmailMessage"><div itemscope itemprop="action" itemtype="http://schema.org/ViewAction"><link itemprop="url" href="https://gerrit.osmocom.org/c/osmo-ggsn/+/23159"/><meta itemprop="name" content="View Change"/></div></div>

<div style="display:none"> Gerrit-Project: osmo-ggsn </div>
<div style="display:none"> Gerrit-Branch: master </div>
<div style="display:none"> Gerrit-Change-Id: Ib45cbfe03077960f216a83cf500ab3203d02cb3b </div>
<div style="display:none"> Gerrit-Change-Number: 23159 </div>
<div style="display:none"> Gerrit-PatchSet: 1 </div>
<div style="display:none"> Gerrit-Owner: osmith <osmith@sysmocom.de> </div>
<div style="display:none"> Gerrit-MessageType: newchange </div>