summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorNeels Hofmeyr <neels@hofmeyr.de>2020-10-29 23:50:43 +0100
committerNeels Hofmeyr <neels@hofmeyr.de>2020-11-24 18:13:27 +0100
commit66cb6e941d9f801b9f107a39b3112b30e93486cd (patch)
tree4bb0c31f1fca0e5936a14f2387a4d214052c8e32
parent29718f96a4dcb44d255d5d6fe67695245f884c2b (diff)
common SCCP: add example for two cs7 instances (for A and Lb)neels/lcs
-rw-r--r--common/chapters/cs7-config.adoc82
1 files changed, 82 insertions, 0 deletions
diff --git a/common/chapters/cs7-config.adoc b/common/chapters/cs7-config.adoc
index 394da82..648e289 100644
--- a/common/chapters/cs7-config.adoc
+++ b/common/chapters/cs7-config.adoc
@@ -319,3 +319,85 @@ routing-key RCONTEXT DPC si (aal2|bicc|b-isup|h248|isup|sat-isup|sccp|tup)
routing-key RCONTEXT DPC ssn SSN
routing-key RCONTEXT DPC si (aal2|bicc|b-isup|h248|isup|sat-isup|sccp|tup) ssn SSN
----
+
+[[sccp-multiple-cs7]]
+=== Multiple cs7 Instances
+
+It is possible to connect to several STPs from an Osmocom CNI program. Which
+`cs7 instance` to use is usually indicated by choosing an SCCP address
+configured at the desired instance.
+
+For example, an OsmoBSC can run A- and Lb-interface via distinct STP
+connections, by configuring two separate `cs7 instance` sections with different
+STP addresses. Which instance to use is chosen by assigning an SCCP address from
+the desired instance:
+
+----
+cs7 instance 0
+ asp my-asp 2905 0 m3ua
+ remote-ip 10.23.24.1
+
+cs7 instance 1
+ # default remote-ip for STP is 127.0.0.1
+ sccp-address smlc-on-local-stp
+ point-code 0.23.6
+
+msc 0
+
+smlc
+ smlc-addr smlc-on-local-stp
+ enable
+----
+
+The above example points `cs7 instance 0` to a remote STP for the A-interface.
+`msc 0` has no explicit `msc-addr` set, so it uses the first `cs7 instance 0`
+and its default point-code for the A-interface.
+
+The second `cs7 instance 1` points at a locally running STP at 127.0.0.1. `cs7
+instance 1` contains an addressbook entry named `smlc-on-local-stp`. By
+assigning this address to the `smlc-addr`, the Lb interface will run on `cs7
+instance 1` via the local STP.
+
+The remaining AS, ASP and point-codes are automatically configured. A fully
+written out version of above example is:
+
+----
+cs7 instance 0
+ # the default point-code for a BSC is 0.23.3
+ point-code 0.23.3
+ asp my-asp 2905 0 m3ua
+ remote-ip 10.23.24.1
+ sctp-role client
+ as as-clnt-A-0-m3ua m3ua
+ asp my-asp
+ # the default point-code for an MSC is 0.23.1
+ sccp-address msc0
+ point-code 0.23.1
+ sccp-address bsc-on-A
+ point-code 0.23.3
+
+cs7 instance 1
+ point-code 0.23.3
+ asp asp-clnt-Lb-1-m3ua 2905 0 m3ua
+ remote-ip localhost
+ sctp-role client
+ as as-clnt-Lb-1-m3ua m3ua
+ asp asp-clnt-Lb-1-m3ua
+ sccp-address smlc-on-local-stp
+ point-code 0.23.6
+ sccp-address bsc-on-Lb
+ point-code 0.23.3
+
+msc 0
+ msc-addr msc0
+ # when bsc-addr is omitted, the chosen cs7 instance's point-code is used
+ bsc-addr bsc-on-A
+
+smlc
+ # when smlc-addr is omitted, cs7 instace 0 would be used with the SMLC's
+ # default point-code
+ smlc-addr smlc-on-local-stp
+ # when bsc-addr is omitted, the chosen cs7 instance's point-code is used
+ bsc-addr bsc-on-Lb
+ enable
+----