<p>pespin has uploaded this change for <strong>review</strong>.</p><p><a href="https://gerrit.osmocom.org/c/osmo-msc/+/14841">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: I70c488c3d9b05599b834a8608e6361c8aa43ef31<br>---<br>A doc/manuals/chapters/osmux_msc.adoc<br>M doc/manuals/osmomsc-usermanual.adoc<br>2 files changed, 64 insertions(+), 1 deletion(-)<br><br></pre><pre style="font-family: monospace,monospace; white-space: pre-wrap;">git pull ssh://gerrit.osmocom.org:29418/osmo-msc refs/changes/41/14841/1</pre><pre style="font-family: monospace,monospace; white-space: pre-wrap;"><span>diff --git a/doc/manuals/chapters/osmux_msc.adoc b/doc/manuals/chapters/osmux_msc.adoc</span><br><span>new file mode 100644</span><br><span>index 0000000..1d22bba</span><br><span>--- /dev/null</span><br><span>+++ b/doc/manuals/chapters/osmux_msc.adoc</span><br><span>@@ -0,0 +1,62 @@</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 OsmoMSC</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+==== OsmoMSC 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, the CN side of BSC co-located MGW is managed by the MSC,</span><br><span style="color: hsl(120, 100%, 40%);">+meaning the use of Osmux is transparent to BSC since MSC takes care of both peer</span><br><span style="color: hsl(120, 100%, 40%);">+MGW connections. Moreover, in this case the MSC has no dynamic information on</span><br><span style="color: hsl(120, 100%, 40%);">+Osmux support in the BSC co-located MGW until `CRCX` time, which means</span><br><span style="color: hsl(120, 100%, 40%);">+configuration on both nodes need to be carefully set up so they can work</span><br><span style="color: hsl(120, 100%, 40%);">+together.</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)`. Since there's no dynamic information on Osmux support, it may be</span><br><span style="color: hsl(120, 100%, 40%);">+required in the future to have an extra VTY command which can be set per BSC to</span><br><span style="color: hsl(120, 100%, 40%);">+fine-tune which ones should use Osmux and which shouldn't.</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`: {program-name} won't include an `X-Osmux` extension to `CRCX` sent to</span><br><span style="color: hsl(120, 100%, 40%);">+  the BSC co-located MGW when configuring the CN side of the MGW endpoint. If</span><br><span style="color: hsl(120, 100%, 40%);">+  the MGW answers with a `CRCX ACK` containing an `X-Osmux`, {program-name} will</span><br><span style="color: hsl(120, 100%, 40%);">+  cancel the call establishment.</span><br><span style="color: hsl(120, 100%, 40%);">+* `on`: {program-name} will initially configure its co-located MGW to use Osmux, then</span><br><span style="color: hsl(120, 100%, 40%);">+  similarly send a `CRCX` with an `X-Osmux` extension towrds the BSC co-located</span><br><span style="color: hsl(120, 100%, 40%);">+  MGW. Under this configuration, if the BSC co-located MGW didn't support Osmux,</span><br><span style="color: hsl(120, 100%, 40%);">+  it could send a `CRCX ACK` without `X-Osmux` extension or fail (depending on</span><br><span style="color: hsl(120, 100%, 40%);">+  its own configuration), and {program-name} could choose to re-create its local</span><br><span style="color: hsl(120, 100%, 40%);">+  connection as non-Osmux (RTP) (and possibly try again against BSC co-located</span><br><span style="color: hsl(120, 100%, 40%);">+  MGW), but this behavior is currently not implemented. As a result, currently</span><br><span style="color: hsl(120, 100%, 40%);">+  `on` behaves the same as `only`.</span><br><span style="color: hsl(120, 100%, 40%);">+* `only`: {program-name} will configure its co-located MGW as well as the BSC</span><br><span style="color: hsl(120, 100%, 40%);">+  co-located MGW to use Osmux by including the `X-Osmux` MGCP extension. If MGW</span><br><span style="color: hsl(120, 100%, 40%);">+  rejects to use Osmux, {program-name} will reject the call and the call</span><br><span style="color: hsl(120, 100%, 40%);">+  establishment will fail.</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+==== OsmoMSC 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 BSC in order to announce it supports Osmux, and BSC will do</span><br><span style="color: hsl(120, 100%, 40%);">+the same. This way, the MSC can decide whether to use Osmux or not based on this</span><br><span style="color: hsl(120, 100%, 40%);">+information when 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`: {program-name} won't use Osmux. That is, it will send a _BSSMAP Assign</span><br><span style="color: hsl(120, 100%, 40%);">+  Request_ without the _Osmux CID_ IE, and will send a `CRCX` without `X-Osmux`</span><br><span style="color: hsl(120, 100%, 40%);">+  extension towards its co-located MGW.</span><br><span style="color: hsl(120, 100%, 40%);">+* `on`: If BSC announced Osmux support to {program-name} during _BSSMAP RESET_</span><br><span style="color: hsl(120, 100%, 40%);">+  time, then {program-name} will set up the call to use Osmux (by adding</span><br><span style="color: hsl(120, 100%, 40%);">+  `X-Osmux` to MGCP `CRCX` and _Osmux CID_ IE to _BSSMAP Assign Request_). If</span><br><span style="color: hsl(120, 100%, 40%);">+  the BSC didn't announce Osmux support to {program-name}, then {program-name}</span><br><span style="color: hsl(120, 100%, 40%);">+  will use RTP to set up the call (by avoiding addition of previously described</span><br><span style="color: hsl(120, 100%, 40%);">+  bits).</span><br><span style="color: hsl(120, 100%, 40%);">+* `only`: Same as per `on`, except that {program-name} will allow to set up only</span><br><span style="color: hsl(120, 100%, 40%);">+  Osmux calls on the CN-side, this is, it will reject to set up voice calls for</span><br><span style="color: hsl(120, 100%, 40%);">+  BSC which didn't announce Osmux support.</span><br><span>diff --git a/doc/manuals/osmomsc-usermanual.adoc b/doc/manuals/osmomsc-usermanual.adoc</span><br><span>index 3c69d7b..d680a51 100644</span><br><span>--- a/doc/manuals/osmomsc-usermanual.adoc</span><br><span>+++ b/doc/manuals/osmomsc-usermanual.adoc</span><br><span>@@ -28,6 +28,8 @@</span><br><span> </span><br><span> include::./common/chapters/mncc.adoc[]</span><br><span> </span><br><span style="color: hsl(120, 100%, 40%);">+include::{srcdir}/chapters/osmux_msc.adoc[]</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span> include::./common/chapters/control_if.adoc[]</span><br><span> </span><br><span> include::./common/chapters/gsup.adoc[]</span><br><span>@@ -39,4 +41,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-msc/+/14841">change 14841</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-msc/+/14841"/><meta itemprop="name" content="View Change"/></div></div>

<div style="display:none"> Gerrit-Project: osmo-msc </div>
<div style="display:none"> Gerrit-Branch: master </div>
<div style="display:none"> Gerrit-Change-Id: I70c488c3d9b05599b834a8608e6361c8aa43ef31 </div>
<div style="display:none"> Gerrit-Change-Number: 14841 </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>