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

</div><pre style="font-family: monospace,monospace; white-space: pre-wrap;">manual: add "Configuring Primary Links" and "Multiple instances"<br><br>Change-Id: I0919392b716e2812ff19d7efa5d1ba535b08eb91<br>---<br>M doc/manuals/chapters/running.adoc<br>1 file changed, 80 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 41909e2..57b8231 100644</span><br><span>--- a/doc/manuals/chapters/running.adoc</span><br><span>+++ b/doc/manuals/chapters/running.adoc</span><br><span>@@ -35,3 +35,83 @@</span><br><span>      Set the global log level for logging to stderr. This has mostly</span><br><span>      been deprecated by VTY based logging configuration, see</span><br><span>      <<logging>> for more information.</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-hnbgw` on the same computer is possible if</span><br><span style="color: hsl(120, 100%, 40%);">+all interfaces (VTY, CTRL, Iuh) are separated using the appropriate</span><br><span style="color: hsl(120, 100%, 40%);">+configuration options. The IP based interfaces are binding to local host by</span><br><span style="color: hsl(120, 100%, 40%);">+default. In order to separate the processes, the user has to bind those</span><br><span style="color: hsl(120, 100%, 40%);">+services to specific but 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%);">+The Iuh interface can be bound to an individual port:</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%);">+hnbgw</span><br><span style="color: hsl(120, 100%, 40%);">+ iuh</span><br><span style="color: hsl(120, 100%, 40%);">+  local-ip 0.0.0.0</span><br><span style="color: hsl(120, 100%, 40%);">+  local-port 29169</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, OsmoHNBGW 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 OsmoHNBGW contacting an STP.</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+To run multiple OsmoHNBGW instances on the same SCCP routing, each HNBGW has to</span><br><span style="color: hsl(120, 100%, 40%);">+configure a distinct point-code, see <<configure_iucs_iups>>.</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%);">+=== Configuring Primary Links</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+[[configure_iucs_iups]]</span><br><span style="color: hsl(120, 100%, 40%);">+==== Configure SCCP/M3UA to connect to an MSC's _IuCS_ and an SGSN's _IuPS_ interface</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+OsmoHNBGW 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 OsmoHNBGW's SCCP link:</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 0.23.5</span><br><span style="color: hsl(120, 100%, 40%);">+ asp asp-clnt-OsmoHNBGW 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%);">+  routing-indicator PC</span><br><span style="color: hsl(120, 100%, 40%);">+  point-code 0.23.1</span><br><span style="color: hsl(120, 100%, 40%);">+ sccp-address sgsn</span><br><span style="color: hsl(120, 100%, 40%);">+  routing-indicator PC</span><br><span style="color: hsl(120, 100%, 40%);">+  point-code 0.23.2</span><br><span style="color: hsl(120, 100%, 40%);">+hnbgw</span><br><span style="color: hsl(120, 100%, 40%);">+ iucs</span><br><span style="color: hsl(120, 100%, 40%);">+  remote-addr msc</span><br><span style="color: hsl(120, 100%, 40%);">+ iups</span><br><span style="color: hsl(120, 100%, 40%);">+  remote-addr sgsn</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 RUA to accept Iuh connections from hNodeB</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+OsmoHNBGW acts as server to accept Iuh connections from hNodeB devices.</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+An example configuration for OsmoHNBGW's RUA server:</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%);">+hnbgw</span><br><span style="color: hsl(120, 100%, 40%);">+ iuh</span><br><span style="color: hsl(120, 100%, 40%);">+  local-ip 10.9.8.7</span><br><span style="color: hsl(120, 100%, 40%);">+  local-port 29169</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-iuh/+/17505">change 17505</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-iuh/+/17505"/><meta itemprop="name" content="View Change"/></div></div>

<div style="display:none"> Gerrit-Project: osmo-iuh </div>
<div style="display:none"> Gerrit-Branch: master </div>
<div style="display:none"> Gerrit-Change-Id: I0919392b716e2812ff19d7efa5d1ba535b08eb91 </div>
<div style="display:none"> Gerrit-Change-Number: 17505 </div>
<div style="display:none"> Gerrit-PatchSet: 3 </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: neels <nhofmeyr@sysmocom.de> </div>
<div style="display:none"> Gerrit-Reviewer: pespin <pespin@sysmocom.de> </div>
<div style="display:none"> Gerrit-MessageType: merged </div>