From 52f9da22ff98fe1598afb66ee6fd197b954673fb Mon Sep 17 00:00:00 2001 From: Neels Janosch Hofmeyr Date: Fri, 9 Dec 2022 06:45:33 +0100 Subject: [PATCH] manual: tweak 'running' for new netinst feature Related: SYS#6192 Change-Id: Iaa7af53aae72099283bb29ef0fc0eba03ae2f27d --- doc/manuals/chapters/running.adoc | 23 +++++++++++++++-------- 1 file changed, 15 insertions(+), 8 deletions(-) diff --git a/doc/manuals/chapters/running.adoc b/doc/manuals/chapters/running.adoc index ab7ab18..0f56521 100644 --- a/doc/manuals/chapters/running.adoc +++ b/doc/manuals/chapters/running.adoc @@ -117,11 +117,12 @@ device. To en/decapsulate GTP, the APN device needs to be assigned an IP address range that matches the UE IP addresses that are configured in GTP-C / PFCP. The following configuration placed in `osmo-upf.cfg` creates a GTP device called -`apn23` on startup, which is also destroyed on program exit: +`apn23` on startup of osmo-upf, which is destroyed on program exit. It listens +for GTP on local IP address `1.2.3.4`: ---- tunend - dev create apn23 + dev create apn23 1.2.3.4 ---- TODO:: `osmo-upf` is not yet able to configure this network device's IP address @@ -132,7 +133,7 @@ called `apn42`: ---- tunend - dev use apn42 + dev use apn42 2.3.4.5 ---- GTP kernel devices can be managed manually using the `gtp-link` program @@ -146,11 +147,17 @@ available from the 'libgtpnl' project: $ osmo-upf -c osmo-upf.cfg ---- -NOTE:: It is possible to configure multiple GTP devices in `osmo-upf.cfg`, but -`osmo-upf` currently _only uses the first GTP device_ found in the -configuration. In the future, different devices may be used based on the Network -Instance IE passed in the PFCP Session messages (PDR/FAR). Until then, it makes -little sense to configure more than one GTP device. +It is possible to configure multiple GTP devices in `osmo-upf.cfg`. Depending on +the Network Instance name, osmo-upf creates tunnel endpoints on the GTP device +with a matching IP address: + +- The Network Instance IE in the PDR on the Access side determines the local IP + address to use, see <>. +- This local IP address in turn determines the GTP device to use. + +It is possible for a GTP device to listen on ANY -- just omit the IP address in +the `dev` config. In this case, all Network Instance names will be served by +this GTP device. When using ANY, there should be exactly one GTP dev configured. [[nftables]] ===== Configure Linux netfilter for `tunmap`