Change in osmo-bsc[master]: manual: add "Multiple Instances" section, akin to other manuals

This is merely a historical archive of years 2008-2021, before the migration to mailman3.

A maintained and still updated list archive can be found at https://lists.osmocom.org/hyperkitty/list/gerrit-log@lists.osmocom.org/.

neels gerrit-no-reply at lists.osmocom.org
Wed Mar 18 00:05:35 UTC 2020


neels has uploaded this change for review. ( https://gerrit.osmocom.org/c/osmo-bsc/+/17503 )


Change subject: manual: add "Multiple Instances" section, akin to other manuals
......................................................................

manual: add "Multiple Instances" section, akin to other manuals

Related: OS#2767
Change-Id: Ideb137f19d19144d35b05eb036098045bbb18d64
---
M doc/manuals/chapters/running.adoc
1 file changed, 69 insertions(+), 0 deletions(-)



  git pull ssh://gerrit.osmocom.org:29418/osmo-bsc refs/changes/03/17503/1

diff --git a/doc/manuals/chapters/running.adoc b/doc/manuals/chapters/running.adoc
index 995fd88..a680df4 100644
--- a/doc/manuals/chapters/running.adoc
+++ b/doc/manuals/chapters/running.adoc
@@ -40,3 +40,72 @@
 *-r, --rf-ctl 'RFCTL'*::
 	Offer a Unix domain socket for RF control at the path/filename
 	'RFCTL' in the file system.
+
+
+=== Multiple instances
+
+Running multiple instances of `osmo-bsc` on the same computer is possible if all
+interfaces (VTY, CTRL) are separated using the appropriate configuration
+options. The IP based interfaces are binding to local host by default. In order
+to separate the processes, the user has to bind those services to specific but
+different IP addresses and/or ports.
+
+The VTY and the Control interface can be bound to IP addresses from the loopback
+address range, for example:
+
+----
+line vty
+ bind 127.0.0.2
+ctrl
+ bind 127.0.0.2
+----
+
+For the following links, OsmoBSC acts as a client and does not listen/bind to a
+specific interface, and will hence not encounter conflicts for multiple instances
+running on the same interface:
+
+- The SCCP/M3UA links are established by OsmoBSC contacting an STP.
+- The MGCP link is established by OsmoMSC contacting an MGW.
+
+To run multiple OsmoBSC instances on the same A-interface (SCCP/M3UA), each BSC
+has to configure a distinct point-code. See <<cs7_config>>.
+
+
+=== Configure primary links
+
+==== Configure SCCP/M3UA to connect to an MSC's _A_ interface
+
+OsmoBSC acts as client to contact an STP instance and establish an SCCP/M3UA
+link.
+
+An example configuration of OsmoBSC's SCCP link:
+
+----
+cs7 instance 0
+ point-code 1.23.3
+ asp asp-clnt-msc-0 2905 0 m3ua
+  remote-ip 127.0.0.1
+  sctp-role client
+ as as-clnt-msc-0 m3ua
+  asp asp-clnt-msc-0
+  #routing-key 6 1.23.3
+ sccp-address msc
+  routing-indicator PC
+  point-code 1.23.1
+msc 0
+ msc-address msc
+----
+
+==== Configure MGCP to connect to an MGW
+
+OsmoBSC uses a media gateway (typically OsmoMGW) to direct RTP streams. By
+default, an MGW is expected to listen for MGCP clients on port 2427 on local
+host (127.0.0.1).
+
+Here is an example configuration for a remote MGW:
+
+----
+msc 0
+ mgw remote-ip 10.9.8.7
+ mgw remote-port 2427
+----

-- 
To view, visit https://gerrit.osmocom.org/c/osmo-bsc/+/17503
To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings

Gerrit-Project: osmo-bsc
Gerrit-Branch: master
Gerrit-Change-Id: Ideb137f19d19144d35b05eb036098045bbb18d64
Gerrit-Change-Number: 17503
Gerrit-PatchSet: 1
Gerrit-Owner: neels <nhofmeyr at sysmocom.de>
Gerrit-MessageType: newchange
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.osmocom.org/pipermail/gerrit-log/attachments/20200318/f789524a/attachment.htm>


More information about the gerrit-log mailing list