<p>neels has uploaded this change for <strong>review</strong>.</p><p><a href="https://gerrit.osmocom.org/c/osmo-msc/+/17580">View Change</a></p><pre style="font-family: monospace,monospace; white-space: pre-wrap;">manual: link to new common cs7-config.adoc, remove some dup of that<br><br>Related: OS#2767<br>Depends: Ia2508d4c7b0fef9cdc57e7e122799a480e340bf7 (osmo-gsm-manuals)<br>Change-Id: Ie88dd2c7f7318a31ae04fbd6930346d92141fde5<br>---<br>A TODO-RELEASE<br>M doc/manuals/chapters/running.adoc<br>M doc/manuals/osmomsc-usermanual.adoc<br>3 files changed, 24 insertions(+), 23 deletions(-)<br><br></pre><pre style="font-family: monospace,monospace; white-space: pre-wrap;">git pull ssh://gerrit.osmocom.org:29418/osmo-msc refs/changes/80/17580/1</pre><pre style="font-family: monospace,monospace; white-space: pre-wrap;"><span>diff --git a/TODO-RELEASE b/TODO-RELEASE</span><br><span>new file mode 100644</span><br><span>index 0000000..dde4b72</span><br><span>--- /dev/null</span><br><span>+++ b/TODO-RELEASE</span><br><span>@@ -0,0 +1,10 @@</span><br><span style="color: hsl(120, 100%, 40%);">+# When cleaning up this file: bump API version in corresponding Makefile.am and rename corresponding debian/lib*.install</span><br><span style="color: hsl(120, 100%, 40%);">+# according to https://www.gnu.org/software/libtool/manual/html_node/Updating-version-info.html#Updating-version-info</span><br><span style="color: hsl(120, 100%, 40%);">+# In short:</span><br><span style="color: hsl(120, 100%, 40%);">+# LIBVERSION=c:r:a</span><br><span style="color: hsl(120, 100%, 40%);">+# If the library source code has changed at all since the last update, then increment revision: c:r + 1:a.</span><br><span style="color: hsl(120, 100%, 40%);">+# If any interfaces have been added, removed, or changed since the last update: c + 1:0:0.</span><br><span style="color: hsl(120, 100%, 40%);">+# If any interfaces have been added since the last public release: c:r:a + 1.</span><br><span style="color: hsl(120, 100%, 40%);">+# If any interfaces have been removed or changed since the last public release: c:r:0.</span><br><span style="color: hsl(120, 100%, 40%);">+#library what description / commit summary line</span><br><span style="color: hsl(120, 100%, 40%);">+manual needs common chapter cs7-config.adoc from osmo-gsm-manuals > 0.3.0</span><br><span>diff --git a/doc/manuals/chapters/running.adoc b/doc/manuals/chapters/running.adoc</span><br><span>index 4bd3913..18fdad9 100644</span><br><span>--- a/doc/manuals/chapters/running.adoc</span><br><span>+++ b/doc/manuals/chapters/running.adoc</span><br><span>@@ -91,20 +91,24 @@</span><br><span> </span><br><span> ==== Configure SCCP/M3UA to accept _A_ and _IuCS_ links</span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">-OsmoMSC will contact an STP instance to establish an SCCP/M3UA link. BSC and</span><br><span style="color: hsl(0, 100%, 40%);">-HNBGW will then reach the MSC via this link. By default, an STP instance is</span><br><span style="color: hsl(0, 100%, 40%);">-assumed to listen on the default M3UA port (2905) on the local host.</span><br><span style="color: hsl(120, 100%, 40%);">+OsmoMSC acts as client to contact an STP instance and establish an SCCP/M3UA</span><br><span style="color: hsl(120, 100%, 40%);">+link.</span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">-Establishing an SCCP/M3UA link towards an STP instance not on the local host</span><br><span style="color: hsl(0, 100%, 40%);">-can be configured as follows:</span><br><span style="color: hsl(120, 100%, 40%);">+An example configuration of OsmoMSC's SCCP link:</span><br><span> </span><br><span> ----</span><br><span> cs7 instance 0</span><br><span style="color: hsl(0, 100%, 40%);">- asp my-OsmoMSC 2905 0 m3ua</span><br><span style="color: hsl(0, 100%, 40%);">- ! IP address of the remote STP:</span><br><span style="color: hsl(0, 100%, 40%);">- remote-ip 10.23.24.1</span><br><span style="color: hsl(120, 100%, 40%);">+ point-code 0.23.1</span><br><span style="color: hsl(120, 100%, 40%);">+ asp asp-clnt-OsmoMSC-A-Iu 2905 0 m3ua</span><br><span style="color: hsl(120, 100%, 40%);">+ remote-ip 127.0.0.1</span><br><span style="color: hsl(120, 100%, 40%);">+ sctp-role client</span><br><span style="color: hsl(120, 100%, 40%);">+ as as-clnt-OsmoMSC-A-Iu m3ua</span><br><span style="color: hsl(120, 100%, 40%);">+ asp asp-clnt-OsmoMSC-A-Iu</span><br><span style="color: hsl(120, 100%, 40%);">+ #routing-key 2 0.23.1</span><br><span> ----</span><br><span> </span><br><span style="color: hsl(120, 100%, 40%);">+This configuration is explained in detail in <<cs7_config>>.</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span> Note that _A_ and _IuCS_ may use different SCCP instances, if so desired:</span><br><span> </span><br><span> ----</span><br><span>@@ -119,21 +123,6 @@</span><br><span> cs7-instance-iu 1</span><br><span> ----</span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">-A full configuration needs an `asp` on an `as` -- an Application Server Process</span><br><span style="color: hsl(0, 100%, 40%);">-running on an Application Server -- as well as a local point code and routing</span><br><span style="color: hsl(0, 100%, 40%);">-configuration. The SCCP VTY automatically creates those parts that are missing,</span><br><span style="color: hsl(0, 100%, 40%);">-by assuming sane defaults. A complete configuration would look like this:</span><br><span style="color: hsl(0, 100%, 40%);">-</span><br><span>-----</span><br><span style="color: hsl(0, 100%, 40%);">-cs7 instance 0</span><br><span style="color: hsl(0, 100%, 40%);">- point-code 0.23.1</span><br><span style="color: hsl(0, 100%, 40%);">- asp my-OsmoMSC-A-Iu 2905 0 m3ua</span><br><span style="color: hsl(0, 100%, 40%);">- remote-ip 127.0.0.1</span><br><span style="color: hsl(0, 100%, 40%);">- as my-as-for-OsmoMSC-A-Iu m3ua</span><br><span style="color: hsl(0, 100%, 40%);">- asp my-OsmoMSC-A-Iu</span><br><span style="color: hsl(0, 100%, 40%);">- routing-key 0 0.23.1</span><br><span>-----</span><br><span style="color: hsl(0, 100%, 40%);">-</span><br><span> ==== Configure GSUP to reach the HLR</span><br><span> </span><br><span> OsmoMSC will assume a GSUP server (OsmoHLR) to run on the local host and the</span><br><span>diff --git a/doc/manuals/osmomsc-usermanual.adoc b/doc/manuals/osmomsc-usermanual.adoc</span><br><span>index d680a51..848d9c0 100644</span><br><span>--- a/doc/manuals/osmomsc-usermanual.adoc</span><br><span>+++ b/doc/manuals/osmomsc-usermanual.adoc</span><br><span>@@ -22,6 +22,8 @@</span><br><span> </span><br><span> include::./common/chapters/logging.adoc[]</span><br><span> </span><br><span style="color: hsl(120, 100%, 40%);">+include::./common/chapters/cs7-config.adoc[]</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span> include::{srcdir}/chapters/net.adoc[]</span><br><span> </span><br><span> include::./common/chapters/smpp.adoc[]</span><br><span></span><br></pre><p>To view, visit <a href="https://gerrit.osmocom.org/c/osmo-msc/+/17580">change 17580</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/+/17580"/><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: Ie88dd2c7f7318a31ae04fbd6930346d92141fde5 </div>
<div style="display:none"> Gerrit-Change-Number: 17580 </div>
<div style="display:none"> Gerrit-PatchSet: 1 </div>
<div style="display:none"> Gerrit-Owner: neels <nhofmeyr@sysmocom.de> </div>
<div style="display:none"> Gerrit-MessageType: newchange </div>