laforge has submitted this change. ( https://gerrit.osmocom.org/c/osmo-hnbgw/+/29075 )
Change subject: manual: explain the PFCP port
......................................................................
manual: explain the PFCP port
Change-Id: I383befb226caa49e4a2577657806aef1ee11faa3
---
M doc/manuals/chapters/running.adoc
1 file changed, 34 insertions(+), 0 deletions(-)
Approvals:
Jenkins Builder: Verified
laforge: Looks good to me, approved
dexter: Looks good to me, but someone else must approve
diff --git a/doc/manuals/chapters/running.adoc b/doc/manuals/chapters/running.adoc
index 0bcca70..e575215 100644
--- a/doc/manuals/chapters/running.adoc
+++ b/doc/manuals/chapters/running.adoc
@@ -70,6 +70,7 @@
- The SCCP/M3UA links are established by OsmoHNBGW contacting an STP.
- The MGCP link is established by OsmoHNBGW contacting an MGW.
+- The PFCP link is established by OsmoHNBGW contacting a UPF.
To run multiple OsmoHNBGW instances on the same SCCP routing, each HNBGW has to
configure a distinct point-code, see <<configure_iucs_iups>>.
@@ -140,3 +141,36 @@
mgw remote-port 2427
mgw reset-endpoint rtpbridge/*
----
+
+==== Configure co-located User Plane Function
+
+OsmoHNBGW optionally supports relaying the GTP user plane via a co-located UPF,
+which is controlled by the PFCP protocol.
+
+PFCP support is optional at compile time, as well as run time. To use a co-located UPF,
+
+* osmo-hnbgw needs to be compiled with 'configure --enable-pfcp',
+* and osmo-hnbgw.cfg needs to configure a 'pfcp' / 'remote-addr' and
+ 'local-addr'.
+
+The following example configures OsmoHNBGW to associate via PFCP with a UPF
+listening on UDP 127.0.0.2:8805, ready to setup GTP tunnel relays.
+
+----
+hnbgw
+ pfcp
+ remote-addr 127.0.0.2
+ local-addr 127.0.0.1
+----
+
+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-hnbgw.
+
+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-hnbgw 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/5647 .
--
To view, visit https://gerrit.osmocom.org/c/osmo-hnbgw/+/29075
To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings
Gerrit-Project: osmo-hnbgw
Gerrit-Branch: master
Gerrit-Change-Id: I383befb226caa49e4a2577657806aef1ee11faa3
Gerrit-Change-Number: 29075
Gerrit-PatchSet: 6
Gerrit-Owner: neels <nhofmeyr(a)sysmocom.de>
Gerrit-Reviewer: Jenkins Builder
Gerrit-Reviewer: dexter <pmaier(a)sysmocom.de>
Gerrit-Reviewer: fixeria <vyanitskiy(a)sysmocom.de>
Gerrit-Reviewer: laforge <laforge(a)osmocom.org>
Gerrit-MessageType: merged
laforge has submitted this change. ( https://gerrit.osmocom.org/c/osmo-hnbgw/+/29074 )
Change subject: manual: add missing bit on the MGCP port
......................................................................
manual: add missing bit on the MGCP port
Change-Id: Ic18180793f0c1497b020e5f4a8cd34d6b519b85f
---
M doc/manuals/chapters/running.adoc
1 file changed, 1 insertion(+), 0 deletions(-)
Approvals:
Jenkins Builder: Verified
fixeria: Looks good to me, but someone else must approve
laforge: Looks good to me, approved
diff --git a/doc/manuals/chapters/running.adoc b/doc/manuals/chapters/running.adoc
index 6ad59a5..0bcca70 100644
--- a/doc/manuals/chapters/running.adoc
+++ b/doc/manuals/chapters/running.adoc
@@ -69,6 +69,7 @@
running on the same interface:
- The SCCP/M3UA links are established by OsmoHNBGW contacting an STP.
+- The MGCP link is established by OsmoHNBGW contacting an MGW.
To run multiple OsmoHNBGW instances on the same SCCP routing, each HNBGW has to
configure a distinct point-code, see <<configure_iucs_iups>>.
2 is the latest approved patch-set.
No files were changed between the latest approved patch-set and the submitted one.
--
To view, visit https://gerrit.osmocom.org/c/osmo-hnbgw/+/29074
To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings
Gerrit-Project: osmo-hnbgw
Gerrit-Branch: master
Gerrit-Change-Id: Ic18180793f0c1497b020e5f4a8cd34d6b519b85f
Gerrit-Change-Number: 29074
Gerrit-PatchSet: 4
Gerrit-Owner: neels <nhofmeyr(a)sysmocom.de>
Gerrit-Reviewer: Jenkins Builder
Gerrit-Reviewer: fixeria <vyanitskiy(a)sysmocom.de>
Gerrit-Reviewer: laforge <laforge(a)osmocom.org>
Gerrit-MessageType: merged
Attention is currently required from: neels, msuraev.
laforge has posted comments on this change. ( https://gerrit.osmocom.org/c/libosmo-sccp/+/29158 )
Change subject: cosmetic: add spec reference
......................................................................
Patch Set 1:
(1 comment)
File src/sua.c:
https://gerrit.osmocom.org/c/libosmo-sccp/+/29158/comment/b2f7a3fb_1fd13581
PS1, Line 184: /* ITU-T Rec Q.713 */
> this spec is about SCCP, not SUA?
Background: SUA is a (much younger, IETF-provided) alternative protocol for (SCCP+MTP). As SUA functionality is a superset of SCCP (you can express everything possible in SCCP with SUA, but SUA has some additional bits you cannot express in SCCP) I decided that our stack internally uses SUA, and only transcodes to SCCP when SCCP is needed.
The SUA spec often falls back on SCCP.
I think it's useful to add these kind of annotations, but if one wants to do that, one should first mention the SUA RFC section and then the ITU-T reference, something like
"RFC1234 section 3.4 resembling Q.714 Secion 4.2"
or the like.
However, given that the task at hand was not to improve the documentation of our SIGTRAN code but to implement a specific message size limit, I don't think it is worth investing time
--
To view, visit https://gerrit.osmocom.org/c/libosmo-sccp/+/29158
To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings
Gerrit-Project: libosmo-sccp
Gerrit-Branch: master
Gerrit-Change-Id: I4d6bf9d0e681db779770b2fb815f7f9c5e608b15
Gerrit-Change-Number: 29158
Gerrit-PatchSet: 1
Gerrit-Owner: msuraev <msuraev(a)sysmocom.de>
Gerrit-Reviewer: Jenkins Builder
Gerrit-Reviewer: neels <nhofmeyr(a)sysmocom.de>
Gerrit-CC: laforge <laforge(a)osmocom.org>
Gerrit-Attention: neels <nhofmeyr(a)sysmocom.de>
Gerrit-Attention: msuraev <msuraev(a)sysmocom.de>
Gerrit-Comment-Date: Sat, 20 Aug 2022 08:20:39 +0000
Gerrit-HasComments: Yes
Gerrit-Has-Labels: No
Comment-In-Reply-To: neels <nhofmeyr(a)sysmocom.de>
Gerrit-MessageType: comment