<p>laforge <strong>submitted</strong> this change.</p><p><a href="https://gerrit.osmocom.org/c/osmo-bsc/+/17503">View Change</a></p><div style="white-space:pre-wrap">Approvals:
  laforge: Looks good to me, approved
  Jenkins Builder: Verified

</div><pre style="font-family: monospace,monospace; white-space: pre-wrap;">manual: add "Multiple Instances" section, akin to other manuals<br><br>Related: OS#2767<br>Change-Id: Ideb137f19d19144d35b05eb036098045bbb18d64<br>---<br>M doc/manuals/chapters/running.adoc<br>1 file changed, 67 insertions(+), 0 deletions(-)<br><br></pre><pre style="font-family: monospace,monospace; white-space: pre-wrap;"><span>diff --git a/doc/manuals/chapters/running.adoc b/doc/manuals/chapters/running.adoc</span><br><span>index 995fd88..9348f69 100644</span><br><span>--- a/doc/manuals/chapters/running.adoc</span><br><span>+++ b/doc/manuals/chapters/running.adoc</span><br><span>@@ -40,3 +40,70 @@</span><br><span> *-r, --rf-ctl 'RFCTL'*::</span><br><span>   Offer a Unix domain socket for RF control at the path/filename</span><br><span>       'RFCTL' in the file system.</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+=== Multiple instances</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+Running multiple instances of `osmo-bsc` on the same host is possible if all</span><br><span style="color: hsl(120, 100%, 40%);">+interfaces (VTY, CTRL) are separated using the appropriate configuration</span><br><span style="color: hsl(120, 100%, 40%);">+options. The IP based interfaces are binding to local host by default. In order</span><br><span style="color: hsl(120, 100%, 40%);">+to separate the processes, the user has to bind those services to specific but</span><br><span style="color: hsl(120, 100%, 40%);">+different IP addresses and/or ports.</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+The VTY and the Control interface can be bound to IP addresses from the loopback</span><br><span style="color: hsl(120, 100%, 40%);">+address range, for example:</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+----</span><br><span style="color: hsl(120, 100%, 40%);">+line vty</span><br><span style="color: hsl(120, 100%, 40%);">+ bind 127.0.0.2</span><br><span style="color: hsl(120, 100%, 40%);">+ctrl</span><br><span style="color: hsl(120, 100%, 40%);">+ bind 127.0.0.2</span><br><span style="color: hsl(120, 100%, 40%);">+----</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+For the following links, OsmoBSC acts as a client and does not listen/bind to a</span><br><span style="color: hsl(120, 100%, 40%);">+specific interface, and will hence not encounter conflicts for multiple instances</span><br><span style="color: hsl(120, 100%, 40%);">+running on the same interface:</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+- The SCCP/M3UA links are established by OsmoBSC contacting an STP.</span><br><span style="color: hsl(120, 100%, 40%);">+- The MGCP link is established by OsmoMSC contacting an MGW.</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+To run multiple OsmoBSC instances on the same A-interface (SCCP/M3UA), each BSC</span><br><span style="color: hsl(120, 100%, 40%);">+has to configure a distinct point-code.</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+=== Configure primary links</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+==== Configure SCCP/M3UA to connect to an MSC's _A_ interface</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+OsmoBSC 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 style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+An example configuration of OsmoBSC's AoIP SCCP link, assuming the BSC at</span><br><span style="color: hsl(120, 100%, 40%);">+point-code 1.23.3 and the MSC reachable at point-code 0.23.1 via an SG</span><br><span style="color: hsl(120, 100%, 40%);">+listening for M3UA at 127.0.0.1:2905:</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+----</span><br><span style="color: hsl(120, 100%, 40%);">+cs7 instance 0</span><br><span style="color: hsl(120, 100%, 40%);">+ point-code 1.23.3</span><br><span style="color: hsl(120, 100%, 40%);">+ asp asp-clnt-msc-0 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%);">+ sccp-address msc</span><br><span style="color: hsl(120, 100%, 40%);">+  point-code 0.23.1</span><br><span style="color: hsl(120, 100%, 40%);">+msc 0</span><br><span style="color: hsl(120, 100%, 40%);">+ msc-address msc</span><br><span style="color: hsl(120, 100%, 40%);">+----</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+==== Configure MGCP to connect to an MGW</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+OsmoBSC uses a media gateway (typically OsmoMGW) to direct RTP streams. By</span><br><span style="color: hsl(120, 100%, 40%);">+default, an MGW is expected to receive MGCP requests on the IANA-registered</span><br><span style="color: hsl(120, 100%, 40%);">+default port for MGCP (2427) on local host (127.0.0.1).</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+Here is an example configuration for a remote MGW:</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+----</span><br><span style="color: hsl(120, 100%, 40%);">+msc 0</span><br><span style="color: hsl(120, 100%, 40%);">+ mgw remote-ip 10.9.8.7</span><br><span style="color: hsl(120, 100%, 40%);">+ mgw remote-port 2427</span><br><span style="color: hsl(120, 100%, 40%);">+----</span><br><span></span><br></pre><p>To view, visit <a href="https://gerrit.osmocom.org/c/osmo-bsc/+/17503">change 17503</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/+/17503"/><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: Ideb137f19d19144d35b05eb036098045bbb18d64 </div>
<div style="display:none"> Gerrit-Change-Number: 17503 </div>
<div style="display:none"> Gerrit-PatchSet: 5 </div>
<div style="display:none"> Gerrit-Owner: neels <nhofmeyr@sysmocom.de> </div>
<div style="display:none"> Gerrit-Reviewer: Jenkins Builder </div>
<div style="display:none"> Gerrit-Reviewer: laforge <laforge@osmocom.org> </div>
<div style="display:none"> Gerrit-Reviewer: pespin <pespin@sysmocom.de> </div>
<div style="display:none"> Gerrit-MessageType: merged </div>