doc/manuals: describe GTP-U kernel module
Related: OS#3209 Change-Id: Ib45cbfe03077960f216a83cf500ab3203d02cb3b
This commit is contained in:
parent
9d82492e49
commit
1596463985
|
@ -80,3 +80,47 @@ possible to pick differing ports on the same IP address), like:
|
|||
ggsn ggsn0
|
||||
gtp bind-ip 127.0.0.2
|
||||
----
|
||||
|
||||
=== GTP-U kernel module
|
||||
|
||||
WARNING: As of writing, the kernel module does not support IPv6.
|
||||
|
||||
OsmoGGSN has support to use the Linux kernel GTP-U tunnel driver to accelerate
|
||||
the data/user plane while still implementing the control plane (GTP-C) in
|
||||
userspace in OsmoGGSN. The kernel module is included in Linux 4.7.0 and higher.
|
||||
Notably the Debian GNU/Linux distribution has it enabled by default.
|
||||
|
||||
In order to use this feature, make sure that your Linux kernel was configured
|
||||
to support it (`CONFIG_GTP=m` or `=y`). Furthermore, `osmo-ggsn` must have been
|
||||
built with `./configure` argument `--enable-gtp-linux` (which requires libgtpnl
|
||||
to be installed).
|
||||
|
||||
Load the kernel module with:
|
||||
|
||||
----
|
||||
$ sudo modprobe gtp
|
||||
----
|
||||
|
||||
Then start OsmoGGSN with a configuration file that uses `gtpu-mode kernel-gtp`.
|
||||
|
||||
A full example configuration is in `osmo-ggsn-kernel-gtp.cfg`.
|
||||
|
||||
----
|
||||
$ sudo osmo-ggsn -c /usr/share/doc/osmo-ggsn/examples/osmo-ggsn-kernel-gtp.cfg
|
||||
----
|
||||
|
||||
.Example: APN with kernel-gtp
|
||||
----
|
||||
ggsn ggsn0
|
||||
gtp state-dir /tmp
|
||||
gtp bind-ip 127.0.0.2
|
||||
apn internet
|
||||
gtpu-mode kernel-gtp
|
||||
tun-device tun4
|
||||
type-support v4
|
||||
ip prefix dynamic 172.16.222.0/24
|
||||
ip dns 0 8.8.8.8
|
||||
ip dns 1 8.8.4.4
|
||||
ip ifconfig 172.16.222.0/24
|
||||
no shutdown
|
||||
----
|
||||
|
|
Loading…
Reference in New Issue