jolly has uploaded this change for review. ( https://gerrit.osmocom.org/c/osmo-gsm-manuals/+/43757?usp=email )

Change subject: Add description for IP DSCP (QoS) support of libosmo-signtran ......................................................................

Add description for IP DSCP (QoS) support of libosmo-signtran

Related: OS#6753 Change-Id: I57e1fa47f811132116deefe769ed6b7e90d11e49 --- M common/chapters/sigtran-osmocom.adoc M common/chapters/sigtran.adoc 2 files changed, 43 insertions(+), 0 deletions(-)

git pull ssh://gerrit.osmocom.org:29418/osmo-gsm-manuals refs/changes/57/43757/1

diff --git a/common/chapters/sigtran-osmocom.adoc b/common/chapters/sigtran-osmocom.adoc index 32d03cf..1e064bd 100644 --- a/common/chapters/sigtran-osmocom.adoc +++ b/common/chapters/sigtran-osmocom.adoc @@ -285,6 +285,8 @@ |Network Indicator|(config-cs7)# network-indicator|Network Indicator used in MTP3 Routing Label |Point Code Format|(config-cs7)# point-code format|Point Code Format (Default: 3.8.3) |Point Code Delimiter|(config-cs7)# point-code delimiter|Point Code Delimiter: . or - +|QoS Class Definition|(config-cs7)# qos class ID|Definition of a QoS class +|QoS DSCP|(config-cs7-qos-class)# qos-ip-dscp DSCP|DSCP value of QoS class |====

[[xua-server]] @@ -306,6 +308,7 @@ |Local Port|Local IP Address to which the server shall bind/listen |Protocol|Protocol (M3UA, SUA, IPA) to be operated by this server |Accept Dynamic ASPs|Should we accept connections from ASPs that are not explicitly pre-configured with their source IP and port? +|QoS Class|QoS Class the server will apply to incoming connections |====

@@ -377,6 +380,7 @@ |Remote Port|Port Number of the remote end of the connection |Remote IP|IP Address of the remote end of the connection |State|ASP State (Down, Inactive, Active) +|QoS Class|QoS Class to apply to this connection |====

=== Osmocom SS7 Routes diff --git a/common/chapters/sigtran.adoc b/common/chapters/sigtran.adoc index 308f157..bd9ffa3 100644 --- a/common/chapters/sigtran.adoc +++ b/common/chapters/sigtran.adoc @@ -523,3 +523,42 @@ _all_ the ASPs in broadcast traffic mode.

Osmocom (libosmo-sigtran) implements all above-mentioned traffic modes. + +==== Quality of Service (QoS) / IP DSCP + +Osmocom SIGTRAN support allows mapping abstract Quality of Service (QoS) +classes to specific IP Differentiated Services Code Point (DSCP) values. This +enables network operators to prioritize SIGTRAN signaling traffic (such as M3UA +or SUA) across underlying IP transport networks. + +QoS classes are defined centrally under the `cs7 instance` node. Once defined, +a QoS class can optionally be assigned to individual xUA listeners (`listen` +node) or Application Server Processes (`asp` node). + +A QoS class that is assigned to an xUA listener applies to IP packets sent +during negotiation with the socket server. This QoS class also applies to IP +packets sent by the Application Server Process, if no class is assigned to it. + +---- +cs7 instance 0 + qos class 5 <1> + qos-ip-dscp 23 + qos class 6 + qos-ip-dscp 42 + qos class 7 + qos-ip-dscp 8 + ... + listen m3ua 2905 + qos-class 5 <2> + ... + asp asp-srv-m3ua 2906 2905 m3ua + qos-class 7 <3> + ... + asp asp-clnt-m3ua 2905 2906 m3ua + qos-class 6 <4> + ... +---- +<1> Define QoS class `5` and assign it IP DSCP value `23`. +<2> Apply QoS class `5` to the M3UA listener socket. +<3> Apply QoS class `7` (DSCP 8) to the server-role ASP. +<4> Apply QoS class `6` (DSCP 42) to the client-role ASP.