lists.osmocom.org
Sign In Sign Up
Manage this list Sign In Sign Up

Keyboard Shortcuts

Thread View

  • j: Next unread message
  • k: Previous unread message
  • j a: Jump to all threads
  • j l: Jump to MailingList overview

gerrit-log

Thread Start a new thread
Download
Threads by month
  • ----- 2026 -----
  • November
  • October
  • September
  • August
  • July
  • June
  • May
  • April
  • March
  • February
  • January
  • ----- 2025 -----
  • December
  • November
  • October
  • September
  • August
  • July
  • June
  • May
  • April
  • March
  • February
  • January
  • ----- 2024 -----
  • December
  • November
  • October
  • September
  • August
  • July
  • June
  • May
  • April
  • March
  • February
  • January
  • ----- 2023 -----
  • December
  • November
  • October
  • September
  • August
  • July
  • June
  • May
  • April
  • March
  • February
  • January
  • ----- 2022 -----
  • December
  • November
  • October
  • September
  • August
  • July
  • June
  • May
  • April
  • March
  • February
  • January
gerrit-log@lists.osmocom.org

September 2022

  • 2 participants
  • 1860 discussions
Change in osmo-hlr[master]: systemd: enable basic hardening
by laforge 18 Sep '22

18 Sep '22
Attention is currently required from: msuraev. laforge has posted comments on this change. ( https://gerrit.osmocom.org/c/osmo-hlr/+/29379 ) Change subject: systemd: enable basic hardening ...................................................................... Patch Set 1: Code-Review+1 -- To view, visit https://gerrit.osmocom.org/c/osmo-hlr/+/29379 To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings Gerrit-Project: osmo-hlr Gerrit-Branch: master Gerrit-Change-Id: Ida5f13bdb9e5bd956c440a381d94eecc18f0b2ef Gerrit-Change-Number: 29379 Gerrit-PatchSet: 1 Gerrit-Owner: msuraev <msuraev(a)sysmocom.de> Gerrit-Reviewer: Jenkins Builder Gerrit-Reviewer: laforge <laforge(a)osmocom.org> Gerrit-Attention: msuraev <msuraev(a)sysmocom.de> Gerrit-Comment-Date: Sun, 18 Sep 2022 05:42:03 +0000 Gerrit-HasComments: No Gerrit-Has-Labels: Yes Gerrit-MessageType: comment
1 0
0 0
Change in osmo-hlr[master]: Debian: bump compatibility level
by msuraev 18 Sep '22

18 Sep '22
Attention is currently required from: fixeria. msuraev has posted comments on this change. ( https://gerrit.osmocom.org/c/osmo-hlr/+/29381 ) Change subject: Debian: bump compatibility level ...................................................................... Patch Set 1: (1 comment) File debian/not-installed: https://gerrit.osmocom.org/c/osmo-hlr/+/29381/comment/6cb4f5c8_1a07e007 PS1, Line 2: osmo-hlr-dgsm.cfg > Hmm, I think it actually makes sense to install this one. As part of osmo-hlr or some other package? -- To view, visit https://gerrit.osmocom.org/c/osmo-hlr/+/29381 To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings Gerrit-Project: osmo-hlr Gerrit-Branch: master Gerrit-Change-Id: Id1557cd07b5d28dbb6018cbf972ce41008b65867 Gerrit-Change-Number: 29381 Gerrit-PatchSet: 1 Gerrit-Owner: msuraev <msuraev(a)sysmocom.de> Gerrit-Reviewer: Jenkins Builder Gerrit-Reviewer: fixeria <vyanitskiy(a)sysmocom.de> Gerrit-Attention: fixeria <vyanitskiy(a)sysmocom.de> Gerrit-Comment-Date: Sun, 18 Sep 2022 02:10:28 +0000 Gerrit-HasComments: Yes Gerrit-Has-Labels: No Comment-In-Reply-To: fixeria <vyanitskiy(a)sysmocom.de> Gerrit-MessageType: comment
1 0
0 0
Change in osmo-upf[master]: manual: add/fix running.adoc
by neels 17 Sep '22

17 Sep '22
Attention is currently required from: fixeria. neels has posted comments on this change. ( https://gerrit.osmocom.org/c/osmo-upf/+/29383 ) Change subject: manual: add/fix running.adoc ...................................................................... Patch Set 2: (1 comment) Commit Message: https://gerrit.osmocom.org/c/osmo-upf/+/29383/comment/7ffeaa96_927e6493 PS1, Line 12: Add section 'Configure Primary Links' > IMO, this should be done in a separate change. Done -- To view, visit https://gerrit.osmocom.org/c/osmo-upf/+/29383 To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings Gerrit-Project: osmo-upf Gerrit-Branch: master Gerrit-Change-Id: I1ae668ff75882e7ac55dd5b27566a68c449bdee5 Gerrit-Change-Number: 29383 Gerrit-PatchSet: 2 Gerrit-Owner: neels <nhofmeyr(a)sysmocom.de> Gerrit-Reviewer: Jenkins Builder Gerrit-CC: fixeria <vyanitskiy(a)sysmocom.de> Gerrit-Attention: fixeria <vyanitskiy(a)sysmocom.de> Gerrit-Comment-Date: Sat, 17 Sep 2022 21:03:43 +0000 Gerrit-HasComments: Yes Gerrit-Has-Labels: No Comment-In-Reply-To: fixeria <vyanitskiy(a)sysmocom.de> Gerrit-MessageType: comment
1 0
0 0
Change in osmo-upf[master]: manual: add 'Configure Primary Links'
by neels 17 Sep '22

17 Sep '22
neels has uploaded this change for review. ( https://gerrit.osmocom.org/c/osmo-upf/+/29385 ) Change subject: manual: add 'Configure Primary Links' ...................................................................... manual: add 'Configure Primary Links' Add section 'Configure Primary Links' with detailed explanation of the GTP and netfilter setup. Related: SYS#5599 Change-Id: I2378d4856b28e81dae2a85e20aaf2999768de4d9 --- M doc/manuals/chapters/running.adoc A doc/manuals/chapters/upf_gtp_roles.dot 2 files changed, 150 insertions(+), 0 deletions(-) git pull ssh://gerrit.osmocom.org:29418/osmo-upf refs/changes/85/29385/1 diff --git a/doc/manuals/chapters/running.adoc b/doc/manuals/chapters/running.adoc index 6a6afd4..0459541 100644 --- a/doc/manuals/chapters/running.adoc +++ b/doc/manuals/chapters/running.adoc @@ -49,3 +49,122 @@ For GTP encapsulation/decapsulation and GTP tunnel relaying, osmo-upf depends on the IP addresses configured at the Linux kernel GTP module, and the IP addresses negotiated within PFCP by the control plane function. + +If multiple `osmo-upf` processes are running on the same Linux kernel, each +`osmo-upf` needs to be configured with a distinct netfilter table name, so that +naming of individual tunnel rulesets does not collide: + +---- +nft + table-name osmo-upf-2 +---- + +=== Configuring Primary Links + +==== Configure PFCP Server + +The following example configures OsmoUPF to listen for PFCP association requests +from Control Plane Function entities on local interface 10.9.8.7, port 8805: + +---- +pfcp + local-addr 10.9.8.7 +---- + +3GPP TS 29.244 4.2.2 specifies that PFCP Request messages shall be sent to UDP +port 8805, i.e. the PFCP port is fixed as 8805 and currently not configurable in +osmo-upf. + +Setting a 'local-addr' is required: the PFCP protocol features a Node ID, which +uniquely identifies PFCP peers across different interfaces. According to the +PFCP specification, the Node ID can be a fully-qualified domain name (FQDN) or +an IP address. Currently, osmo-upf has no support for using an FQDN as Node +ID, and so far uses the 'local-addr' as local Node ID -- hence the 'local-addr' +must not be "0.0.0.0", which is an unfortunate consequence. This is likely to +improve in the future, see https://osmocom.org/issues/5682 . + +==== Configure Linux Kernel GTP Features + +OsmoUPF uses two distinct Linux kernel features: + +* The GTP module is used for GTP encapsulation/decapsulation from/to + "the internet". + +* The netfilter module is used for GTP tunnel proxying, also known as + tunnel forwarding or tunnel mapping. + +.Linux kernel feature usage +[graphviz] +---- +include::upf_gtp_roles.dot[] +---- + +GTP kernel module configuration can be omitted for sites that serve only as GTP +forwarding proxy, without encapsulation/decapsulation of GTP payloads. + +[[gtp_module]] +===== Configure Linux Kernel GTP Module + +The Linux kernel GTP module is used for 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 +endpoint. It is typically named like "apn0". + +`osmo-upf` can either create a GTP device on startup, or use a pre-existing GTP +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: + +---- +gtp + dev create apn23 +---- + +TODO:: `osmo-upf` is not yet able to configure this network device's IP address +range, MTU etc. + +The following configuration placed in `osmo-upf.cfg` uses a pre-existing device +called `apn42`: + +---- +gtp + dev use apn42 +---- + +GTP kernel devices can be managed manually using the `gtp-link` program +available from the 'libgtpnl' project: + +---- +# gtp-link add apn42 +(keep this process running) +# ip addr add dev apn42 192.168.42.1/24 + +$ 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. + +[[nftables]] +===== Configure Linux netfilter + +The Linux kernel netfilter module is used for GTP tunnel proxying, also known as +tunnel forwarding or tunnel mapping. + +Using the netfilter module usually requires no configuration in `osmo-upf.cfg`. + +`osmo-upf` creates a new netfilter table, under which it submits rule sets for +GTP tunnel proxying. This table name defaults to `osmo-upf`. A custom table name +can be configured in `osmo-upf.cfg` like this: + +---- +nft + table-name my-table-name +---- diff --git a/doc/manuals/chapters/upf_gtp_roles.dot b/doc/manuals/chapters/upf_gtp_roles.dot new file mode 100644 index 0000000..12dd171 --- /dev/null +++ b/doc/manuals/chapters/upf_gtp_roles.dot @@ -0,0 +1,31 @@ +digraph G { +rankdir=LR +sgsn [label="SGSN"] + +subgraph cluster_sgw { + style=invisible + sgwc [label="SGW-C"] + sgwu [label="OsmoUPF as SGW-U\ntunnel proxy\n*netfilter* kernel module",style=bold,shape=box] + sgwc -> sgwu [label="PFCP",constraint=false] +} + +subgraph cluster_pgw { + style=invisible + pgwc [label="PGW-C"] + pgwu [label="OsmoUPF as PGW-U\ntunnel proxy\n*netfilter* kernel module",style=bold,shape=box] + pgwc -> pgwu [label="PFCP",constraint=false] +} + +subgraph cluster_tdf { + style=invisible + tdfc [label="TDF-C"] + tdfu [label="OsmoUPF as TDF-U\ntunnel en-/decaps\n*GTP* kernel module",style=bold,shape=box] + tdfc -> tdfu [label="PFCP",constraint=false] +} + +pdn [label="PDN\n'the internet'"] + +sgsn -> sgwc -> pgwc -> tdfc [label="GTP-C"] +sgsn -> sgwu -> pgwu -> tdfu [label="GTP-U",dir=both] +tdfu -> pdn [label="IP",dir=both] +} -- To view, visit https://gerrit.osmocom.org/c/osmo-upf/+/29385 To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings Gerrit-Project: osmo-upf Gerrit-Branch: master Gerrit-Change-Id: I2378d4856b28e81dae2a85e20aaf2999768de4d9 Gerrit-Change-Number: 29385 Gerrit-PatchSet: 1 Gerrit-Owner: neels <nhofmeyr(a)sysmocom.de> Gerrit-MessageType: newchange
1 0
0 0
Change in osmo-upf[master]: manual: add/fix running.adoc
by neels 17 Sep '22

17 Sep '22
Attention is currently required from: neels. Hello Jenkins Builder, I'd like you to reexamine a change. Please visit https://gerrit.osmocom.org/c/osmo-upf/+/29383 to look at the new patch set (#2). Change subject: manual: add/fix running.adoc ...................................................................... manual: add/fix running.adoc Actually add running.adoc to osmoupf-usermanual.adoc so that the chapter shows in the generated PDF. Related: SYS#5599 Change-Id: I1ae668ff75882e7ac55dd5b27566a68c449bdee5 --- M doc/manuals/osmoupf-usermanual.adoc 1 file changed, 2 insertions(+), 0 deletions(-) git pull ssh://gerrit.osmocom.org:29418/osmo-upf refs/changes/83/29383/2 -- To view, visit https://gerrit.osmocom.org/c/osmo-upf/+/29383 To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings Gerrit-Project: osmo-upf Gerrit-Branch: master Gerrit-Change-Id: I1ae668ff75882e7ac55dd5b27566a68c449bdee5 Gerrit-Change-Number: 29383 Gerrit-PatchSet: 2 Gerrit-Owner: neels <nhofmeyr(a)sysmocom.de> Gerrit-Reviewer: Jenkins Builder Gerrit-CC: fixeria <vyanitskiy(a)sysmocom.de> Gerrit-Attention: neels <nhofmeyr(a)sysmocom.de> Gerrit-MessageType: newpatchset
1 0
0 0
Change in osmo-hlr[master]: Debian: bump compatibility level
by fixeria 17 Sep '22

17 Sep '22
Attention is currently required from: msuraev. fixeria has posted comments on this change. ( https://gerrit.osmocom.org/c/osmo-hlr/+/29381 ) Change subject: Debian: bump compatibility level ...................................................................... Patch Set 1: Code-Review+1 (1 comment) File debian/not-installed: https://gerrit.osmocom.org/c/osmo-hlr/+/29381/comment/fa6b9248_89b6aa8f PS1, Line 2: osmo-hlr-dgsm.cfg Hmm, I think it actually makes sense to install this one. -- To view, visit https://gerrit.osmocom.org/c/osmo-hlr/+/29381 To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings Gerrit-Project: osmo-hlr Gerrit-Branch: master Gerrit-Change-Id: Id1557cd07b5d28dbb6018cbf972ce41008b65867 Gerrit-Change-Number: 29381 Gerrit-PatchSet: 1 Gerrit-Owner: msuraev <msuraev(a)sysmocom.de> Gerrit-Reviewer: Jenkins Builder Gerrit-Reviewer: fixeria <vyanitskiy(a)sysmocom.de> Gerrit-Attention: msuraev <msuraev(a)sysmocom.de> Gerrit-Comment-Date: Sat, 17 Sep 2022 19:04:26 +0000 Gerrit-HasComments: Yes Gerrit-Has-Labels: Yes Gerrit-MessageType: comment
1 0
0 0
Change in osmo-hlr[master]: Debian: bump copyright year to match current
by fixeria 17 Sep '22

17 Sep '22
Attention is currently required from: msuraev. fixeria has posted comments on this change. ( https://gerrit.osmocom.org/c/osmo-hlr/+/29380 ) Change subject: Debian: bump copyright year to match current ...................................................................... Patch Set 1: Code-Review+1 -- To view, visit https://gerrit.osmocom.org/c/osmo-hlr/+/29380 To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings Gerrit-Project: osmo-hlr Gerrit-Branch: master Gerrit-Change-Id: I581e62b5410a9dddc6b5fd974081d633cc20416d Gerrit-Change-Number: 29380 Gerrit-PatchSet: 1 Gerrit-Owner: msuraev <msuraev(a)sysmocom.de> Gerrit-Reviewer: Jenkins Builder Gerrit-Reviewer: fixeria <vyanitskiy(a)sysmocom.de> Gerrit-Attention: msuraev <msuraev(a)sysmocom.de> Gerrit-Comment-Date: Sat, 17 Sep 2022 19:03:02 +0000 Gerrit-HasComments: No Gerrit-Has-Labels: Yes Gerrit-MessageType: comment
1 0
0 0
Change in osmo-upf[master]: manual: add/fix running.adoc
by fixeria 17 Sep '22

17 Sep '22
Attention is currently required from: neels. fixeria has posted comments on this change. ( https://gerrit.osmocom.org/c/osmo-upf/+/29383 ) Change subject: manual: add/fix running.adoc ...................................................................... Patch Set 1: (1 comment) Commit Message: https://gerrit.osmocom.org/c/osmo-upf/+/29383/comment/a50f8464_dbacd48b PS1, Line 12: Add section 'Configure Primary Links' IMO, this should be done in a separate change. -- To view, visit https://gerrit.osmocom.org/c/osmo-upf/+/29383 To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings Gerrit-Project: osmo-upf Gerrit-Branch: master Gerrit-Change-Id: I1ae668ff75882e7ac55dd5b27566a68c449bdee5 Gerrit-Change-Number: 29383 Gerrit-PatchSet: 1 Gerrit-Owner: neels <nhofmeyr(a)sysmocom.de> Gerrit-Reviewer: Jenkins Builder Gerrit-CC: fixeria <vyanitskiy(a)sysmocom.de> Gerrit-Attention: neels <nhofmeyr(a)sysmocom.de> Gerrit-Comment-Date: Sat, 17 Sep 2022 19:00:03 +0000 Gerrit-HasComments: Yes Gerrit-Has-Labels: No Gerrit-MessageType: comment
1 0
0 0
Change in osmo-upf[master]: vty doc: indicate default nft table name
by neels 17 Sep '22

17 Sep '22
neels has uploaded this change for review. ( https://gerrit.osmocom.org/c/osmo-upf/+/29384 ) Change subject: vty doc: indicate default nft table name ...................................................................... vty doc: indicate default nft table name Change-Id: I79b4d287cae47c37b45a35904f298e57120a65f0 --- M src/osmo-upf/upf_vty.c 1 file changed, 2 insertions(+), 1 deletion(-) git pull ssh://gerrit.osmocom.org:29418/osmo-upf refs/changes/84/29384/1 diff --git a/src/osmo-upf/upf_vty.c b/src/osmo-upf/upf_vty.c index 5227dba..cfc65ea 100644 --- a/src/osmo-upf/upf_vty.c +++ b/src/osmo-upf/upf_vty.c @@ -238,7 +238,8 @@ "table-name TABLE_NAME", "Set the nft inet table name to create and place GTP tunnel forwarding chains in" " (as in 'nft add table inet foo'). If multiple instances of osmo-upf are running on the same system, each" - " osmo-upf must have its own table name. Otherwise the names of created forwarding chains will collide.\n" + " osmo-upf must have its own table name. Otherwise the names of created forwarding chains will collide." + " The default table name is \"osmo-upf\".\n" "nft inet table name\n") { osmo_talloc_replace_string(g_upf, &g_upf->nft.table_name, argv[0]); -- To view, visit https://gerrit.osmocom.org/c/osmo-upf/+/29384 To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings Gerrit-Project: osmo-upf Gerrit-Branch: master Gerrit-Change-Id: I79b4d287cae47c37b45a35904f298e57120a65f0 Gerrit-Change-Number: 29384 Gerrit-PatchSet: 1 Gerrit-Owner: neels <nhofmeyr(a)sysmocom.de> Gerrit-MessageType: newchange
1 0
0 0
Change in osmo-upf[master]: manual: add/fix running.adoc
by neels 17 Sep '22

17 Sep '22
neels has uploaded this change for review. ( https://gerrit.osmocom.org/c/osmo-upf/+/29383 ) Change subject: manual: add/fix running.adoc ...................................................................... manual: add/fix running.adoc Actually add running.adoc to osmoupf-usermanual.adoc so that the chapter shows in the generated PDF. Add section 'Configure Primary Links' with detailed explanation of the GTP and netfilter setup. Related: SYS#5599 Change-Id: I1ae668ff75882e7ac55dd5b27566a68c449bdee5 --- M doc/manuals/chapters/running.adoc A doc/manuals/chapters/upf_gtp_roles.dot M doc/manuals/osmoupf-usermanual.adoc 3 files changed, 153 insertions(+), 1 deletion(-) git pull ssh://gerrit.osmocom.org:29418/osmo-upf refs/changes/83/29383/1 diff --git a/doc/manuals/chapters/running.adoc b/doc/manuals/chapters/running.adoc index 6a6afd4..dc7b396 100644 --- a/doc/manuals/chapters/running.adoc +++ b/doc/manuals/chapters/running.adoc @@ -43,9 +43,128 @@ ---- pfcp - local-addr 10.9.0.2 + local-addr 10.9.0.2 ---- For GTP encapsulation/decapsulation and GTP tunnel relaying, osmo-upf depends on the IP addresses configured at the Linux kernel GTP module, and the IP addresses negotiated within PFCP by the control plane function. + +If multiple `osmo-upf` processes are running on the same Linux kernel, each +`osmo-upf` needs to be configured with a distinct netfilter table name, so that +naming of individual tunnel rulesets does not collide: + +---- +nft + table-name osmo-upf-2 +---- + +=== Configuring Primary Links + +==== Configure PFCP Server + +The following example configures OsmoUPF to listen for PFCP association requests +from Control Plane Function entities on local interface 10.9.8.7, port 8805: + +---- +pfcp + local-addr 10.9.8.7 +---- + +3GPP TS 29.244 4.2.2 specifies that PFCP Request messages shall be sent to UDP +port 8805, i.e. the PFCP port is fixed as 8805 and currently not configurable in +osmo-upf. + +Setting a 'local-addr' is required: the PFCP protocol features a Node ID, which +uniquely identifies PFCP peers across different interfaces. According to the +PFCP specification, the Node ID can be a fully-qualified domain name (FQDN) or +an IP address. Currently, osmo-upf has no support for using an FQDN as Node +ID, and so far uses the 'local-addr' as local Node ID -- hence the 'local-addr' +must not be "0.0.0.0", which is an unfortunate consequence. This is likely to +improve in the future, see https://osmocom.org/issues/5682 . + +==== Configure Linux Kernel GTP Features + +OsmoUPF uses two distinct Linux kernel features: + +* The GTP module is used for GTP encapsulation/decapsulation from/to + "the internet". + +* The netfilter module is used for GTP tunnel proxying, also known as + tunnel forwarding or tunnel mapping. + +.Linux kernel feature usage +[graphviz] +---- +include::upf_gtp_roles.dot[] +---- + +GTP kernel module configuration can be omitted for sites that serve only as GTP +forwarding proxy, without encapsulation/decapsulation of GTP payloads. + +[[gtp_module]] +===== Configure Linux Kernel GTP Module + +The Linux kernel GTP module is used for 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 +endpoint. It is typically named like "apn0". + +`osmo-upf` can either create a GTP device on startup, or use a pre-existing GTP +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: + +---- +gtp + dev create apn23 +---- + +TODO:: `osmo-upf` is not yet able to configure this network device's IP address +range, MTU etc. + +The following configuration placed in `osmo-upf.cfg` uses a pre-existing device +called `apn42`: + +---- +gtp + dev use apn42 +---- + +GTP kernel devices can be managed manually using the `gtp-link` program +available from the 'libgtpnl' project: + +---- +# gtp-link add apn42 +(keep this process running) +# ip addr add dev apn42 192.168.42.1/24 + +$ 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. + +[[nftables]] +===== Configure Linux netfilter + +The Linux kernel netfilter module is used for GTP tunnel proxying, also known as +tunnel forwarding or tunnel mapping. + +Using the netfilter module usually requires no configuration in `osmo-upf.cfg`. + +`osmo-upf` creates a new netfilter table, under which it submits rule sets for +GTP tunnel proxying. This table name defaults to `osmo-upf`. A custom table name +can be configured in `osmo-upf.cfg` like this: + +---- +nft + table-name my-table-name +---- diff --git a/doc/manuals/chapters/upf_gtp_roles.dot b/doc/manuals/chapters/upf_gtp_roles.dot new file mode 100644 index 0000000..12dd171 --- /dev/null +++ b/doc/manuals/chapters/upf_gtp_roles.dot @@ -0,0 +1,31 @@ +digraph G { +rankdir=LR +sgsn [label="SGSN"] + +subgraph cluster_sgw { + style=invisible + sgwc [label="SGW-C"] + sgwu [label="OsmoUPF as SGW-U\ntunnel proxy\n*netfilter* kernel module",style=bold,shape=box] + sgwc -> sgwu [label="PFCP",constraint=false] +} + +subgraph cluster_pgw { + style=invisible + pgwc [label="PGW-C"] + pgwu [label="OsmoUPF as PGW-U\ntunnel proxy\n*netfilter* kernel module",style=bold,shape=box] + pgwc -> pgwu [label="PFCP",constraint=false] +} + +subgraph cluster_tdf { + style=invisible + tdfc [label="TDF-C"] + tdfu [label="OsmoUPF as TDF-U\ntunnel en-/decaps\n*GTP* kernel module",style=bold,shape=box] + tdfc -> tdfu [label="PFCP",constraint=false] +} + +pdn [label="PDN\n'the internet'"] + +sgsn -> sgwc -> pgwc -> tdfc [label="GTP-C"] +sgsn -> sgwu -> pgwu -> tdfu [label="GTP-U",dir=both] +tdfu -> pdn [label="IP",dir=both] +} diff --git a/doc/manuals/osmoupf-usermanual.adoc b/doc/manuals/osmoupf-usermanual.adoc index eace4dd..0e0e7b7 100644 --- a/doc/manuals/osmoupf-usermanual.adoc +++ b/doc/manuals/osmoupf-usermanual.adoc @@ -9,6 +9,8 @@ include::{srcdir}/chapters/overview.adoc[] +include::{srcdir}/chapters/running.adoc[] + include::./common/chapters/vty.adoc[] include::./common/chapters/logging.adoc[] -- To view, visit https://gerrit.osmocom.org/c/osmo-upf/+/29383 To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings Gerrit-Project: osmo-upf Gerrit-Branch: master Gerrit-Change-Id: I1ae668ff75882e7ac55dd5b27566a68c449bdee5 Gerrit-Change-Number: 29383 Gerrit-PatchSet: 1 Gerrit-Owner: neels <nhofmeyr(a)sysmocom.de> Gerrit-MessageType: newchange
1 0
0 0
  • ← Newer
  • 1
  • ...
  • 98
  • 99
  • 100
  • 101
  • 102
  • 103
  • 104
  • ...
  • 186
  • Older →

HyperKitty Powered by HyperKitty version 1.3.12.