jolly has uploaded this change for review.

View Change

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.

To view, visit change 43757. To unsubscribe, or for help writing mail filters, visit settings.