<p>pespin has uploaded this change for <strong>review</strong>.</p><p><a href="https://gerrit.osmocom.org/c/osmo-bsc/+/14840">View Change</a></p><pre style="font-family: monospace,monospace; white-space: pre-wrap;">doc: Add Osmux documentation to User Manual<br><br>Depends: osmo-gsm-manuals.git f3a734e6777a902abfb03257277454c7a879aeb7<br>Change-Id: I75dcdddc713b0dc43e2ba577ca377c20fc511f38<br>---<br>A doc/manuals/chapters/osmux_bsc.adoc<br>M doc/manuals/osmobsc-usermanual.adoc<br>2 files changed, 43 insertions(+), 1 deletion(-)<br><br></pre><pre style="font-family: monospace,monospace; white-space: pre-wrap;">git pull ssh://gerrit.osmocom.org:29418/osmo-bsc refs/changes/40/14840/1</pre><pre style="font-family: monospace,monospace; white-space: pre-wrap;"><span>diff --git a/doc/manuals/chapters/osmux_bsc.adoc b/doc/manuals/chapters/osmux_bsc.adoc</span><br><span>new file mode 100644</span><br><span>index 0000000..7c73903</span><br><span>--- /dev/null</span><br><span>+++ b/doc/manuals/chapters/osmux_bsc.adoc</span><br><span>@@ -0,0 +1,40 @@</span><br><span style="color: hsl(120, 100%, 40%);">+include::{commondir}/chapters/osmux/osmux.adoc[]</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+=== Osmux Support in OsmoBSC</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+==== OsmoBSC in a A/IP with IPA/SCCPlite network setup</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+In this kind of setup, Osmux is transparent to {program-name} and no specific</span><br><span style="color: hsl(120, 100%, 40%);">+configuration is required here, since the CN-side of the BSC-attached MGW is</span><br><span style="color: hsl(120, 100%, 40%);">+managed directly by the MSC.</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+So, in this case, only MSC and MGW (both for MSC-attached one and BSC-attached</span><br><span style="color: hsl(120, 100%, 40%);">+one) need to be configured explicitly.</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+==== OsmoBSC in a 3GPP AoIP network setup</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+Osmux usage in {program-name} in managed through the VTY command `osmux</span><br><span style="color: hsl(120, 100%, 40%);">+(on|off|only)`. Once enabled (`on` or `only`), {program-name} will start</span><br><span style="color: hsl(120, 100%, 40%);">+appending the _Osmux Support_ IE in _BSSMAP RESET_ and _BSSMAP RESET ACK_</span><br><span style="color: hsl(120, 100%, 40%);">+message towards the MSC in order to announce it supports Osmux. This way, the</span><br><span style="color: hsl(120, 100%, 40%);">+MSC can decide whether to use Osmux or not based on this information when</span><br><span style="color: hsl(120, 100%, 40%);">+setting up a call (this time using _Osmux CID_ IE).</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+{program-name} will behave differently during call set up based on the VTY</span><br><span style="color: hsl(120, 100%, 40%);">+command presented above:</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+* `off`: If _BSSMAP Assign Request_ from MSC contains _Osmux CID_ IE, meaning</span><br><span style="color: hsl(120, 100%, 40%);">+  MSC wants to use Osmux for this call, then {program-name} will reject the</span><br><span style="color: hsl(120, 100%, 40%);">+  assignment and the call set up will fail.</span><br><span style="color: hsl(120, 100%, 40%);">+* `on`: BSC will support and accept both Osmux and non-Osmux (RTP) upon call set</span><br><span style="color: hsl(120, 100%, 40%);">+  up. If _BSSMAP Assign Request_ from MSC contains _Osmux CID_ IE,</span><br><span style="color: hsl(120, 100%, 40%);">+  {program-name} will instruct its MGW to set up an Osmux connection on the</span><br><span style="color: hsl(120, 100%, 40%);">+  CN-side of the MGCP endpoint, and will provide the MSC with its _recvCID_</span><br><span style="color: hsl(120, 100%, 40%);">+  through the extension IE _Osmux CID_ appened to the _BSSMAP Assign Complete_</span><br><span style="color: hsl(120, 100%, 40%);">+  message. On the other hand, if _BSSMAP Assign Request_ doesn't contain an</span><br><span style="color: hsl(120, 100%, 40%);">+  _Osmux CID_ IE, {program-name} will instruct its MGW to set up a regular RTP</span><br><span style="color: hsl(120, 100%, 40%);">+  connection on the CN-side of the MGCP endpoint.</span><br><span style="color: hsl(120, 100%, 40%);">+* `only`: Same as per `on`, except that {program-name} will accept only Osmux</span><br><span style="color: hsl(120, 100%, 40%);">+  calls on the CN-side, this is, if  _BSSMAP Assign Request_ from MSC doesn't</span><br><span style="color: hsl(120, 100%, 40%);">+  contain an _Osmux CID_ IE, it will reject the assignment and the call set up</span><br><span style="color: hsl(120, 100%, 40%);">+  will fail.</span><br><span>diff --git a/doc/manuals/osmobsc-usermanual.adoc b/doc/manuals/osmobsc-usermanual.adoc</span><br><span>index 3515aaa..766a11f 100644</span><br><span>--- a/doc/manuals/osmobsc-usermanual.adoc</span><br><span>+++ b/doc/manuals/osmobsc-usermanual.adoc</span><br><span>@@ -1,4 +1,5 @@</span><br><span> :gfdl-enabled:</span><br><span style="color: hsl(120, 100%, 40%);">+:program-name: OsmoBSC</span><br><span> </span><br><span> OsmoBSC User Manual</span><br><span> ===================</span><br><span>@@ -35,6 +36,8 @@</span><br><span> </span><br><span> include::./common/chapters/cell-broadcast.adoc[]</span><br><span> </span><br><span style="color: hsl(120, 100%, 40%);">+include::{srcdir}/chapters/osmux_bsc.adoc[]</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span> include::./common/chapters/port_numbers.adoc[]</span><br><span> </span><br><span> include::./common/chapters/bibliography.adoc[]</span><br><span>@@ -42,4 +45,3 @@</span><br><span> include::./common/chapters/glossary.adoc[]</span><br><span> </span><br><span> include::./common/chapters/gfdl.adoc[]</span><br><span style="color: hsl(0, 100%, 40%);">-</span><br><span></span><br></pre><p>To view, visit <a href="https://gerrit.osmocom.org/c/osmo-bsc/+/14840">change 14840</a>. To unsubscribe, or for help writing mail filters, visit <a href="https://gerrit.osmocom.org/settings">settings</a>.</p><div itemscope itemtype="http://schema.org/EmailMessage"><div itemscope itemprop="action" itemtype="http://schema.org/ViewAction"><link itemprop="url" href="https://gerrit.osmocom.org/c/osmo-bsc/+/14840"/><meta itemprop="name" content="View Change"/></div></div>

<div style="display:none"> Gerrit-Project: osmo-bsc </div>
<div style="display:none"> Gerrit-Branch: master </div>
<div style="display:none"> Gerrit-Change-Id: I75dcdddc713b0dc43e2ba577ca377c20fc511f38 </div>
<div style="display:none"> Gerrit-Change-Number: 14840 </div>
<div style="display:none"> Gerrit-PatchSet: 1 </div>
<div style="display:none"> Gerrit-Owner: pespin <pespin@sysmocom.de> </div>
<div style="display:none"> Gerrit-MessageType: newchange </div>