neels has submitted this change. ( https://gerrit.osmocom.org/c/osmo-upf/+/30832 )
Change subject: manual: use 'tunend' and 'tunmap' ......................................................................
manual: use 'tunend' and 'tunmap'
Change-Id: I09a2fa28465945c98b58b4093c7d5de65e184645 --- M doc/manuals/chapters/overview.adoc M doc/manuals/chapters/running.adoc 2 files changed, 13 insertions(+), 10 deletions(-)
Approvals: Jenkins Builder: Verified pespin: Looks good to me, but someone else must approve laforge: Looks good to me, approved
diff --git a/doc/manuals/chapters/overview.adoc b/doc/manuals/chapters/overview.adoc index 9cd7751..a6dc345 100644 --- a/doc/manuals/chapters/overview.adoc +++ b/doc/manuals/chapters/overview.adoc @@ -79,14 +79,14 @@ OsmoUPF does not support the complete PFCP feature set. It detects exactly two use cases that will provide service of actual GTP tunnels:
-* GTP tunnel encapsulation/decapsulation: +* `tunend`: GTP tunnel encapsulation/decapsulation: - One Packet Detection Rule (PDR) accepts a GTP tunnel from the Access side with an Outer Header Removal. - This PDR uses a Forwarding Action Rule (FAR) for plain IP towards Core. - Another PDR accepts plain IP on a specific IP address from Core. - The second PDR uses a FAR towards Access with Outer Header Creation for GTP.
-* GTP tunnel forwarding: +* `tunmap`: GTP tunnel forwarding: - One Packet Detection Rule (PDR) accepts a GTP tunnel from the Access side with an Outer Header Removal. - This PDR uses a Forwarding Action Rule (FAR) towards Core with an Outer diff --git a/doc/manuals/chapters/running.adoc b/doc/manuals/chapters/running.adoc index 0459541..ab7ab18 100644 --- a/doc/manuals/chapters/running.adoc +++ b/doc/manuals/chapters/running.adoc @@ -55,7 +55,7 @@ naming of individual tunnel rulesets does not collide:
---- -nft +tunmap table-name osmo-upf-2 ----
@@ -103,10 +103,10 @@ forwarding proxy, without encapsulation/decapsulation of GTP payloads.
[[gtp_module]] -===== Configure Linux Kernel GTP Module +===== Configure Linux Kernel GTP Module for `tunend`
-The Linux kernel GTP module is used for GTP encapsulation/decapsulation from/to -"the internet". +The Linux kernel GTP module is used for the `tunend` use case, i.e. GTP +encapsulation/decapsulation from/to "the internet".
To use the GTP kernel module, OsmoUPF requires a GTP device, which is a dedicated network device provided by the Linux kernel, serving as GTP tunnel @@ -120,7 +120,7 @@ `apn23` on startup, which is also destroyed on program exit:
---- -gtp +tunend dev create apn23 ----
@@ -131,7 +131,7 @@ called `apn42`:
---- -gtp +tunend dev use apn42 ----
@@ -153,7 +153,7 @@ little sense to configure more than one GTP device.
[[nftables]] -===== Configure Linux netfilter +===== Configure Linux netfilter for `tunmap`
The Linux kernel netfilter module is used for GTP tunnel proxying, also known as tunnel forwarding or tunnel mapping. @@ -165,6 +165,9 @@ can be configured in `osmo-upf.cfg` like this:
---- -nft +tunmap table-name my-table-name ---- + +When running more than one osmo-upf process on a system, pick distinct table +names to avoid name collisions in the nftables reulesets.
2 is the latest approved patch-set. No files were changed between the latest approved patch-set and the submitted one.