Change in osmo-bsc[master]: CBSP: adjust manual to reflect new 'cbc' VTY config

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/.

laforge gerrit-no-reply at lists.osmocom.org
Thu Sep 3 13:33:42 UTC 2020


laforge has submitted this change. ( https://gerrit.osmocom.org/c/osmo-bsc/+/19966 )

Change subject: CBSP: adjust manual to reflect new 'cbc' VTY config
......................................................................

CBSP: adjust manual to reflect new 'cbc' VTY config

Related: OS#4702
Change-Id: I101144dc4ebf151fa23d05743398aeea4a26834b
---
M doc/manuals/chapters/smscb.adoc
1 file changed, 42 insertions(+), 20 deletions(-)

Approvals:
  Jenkins Builder: Verified
  laforge: Looks good to me, approved



diff --git a/doc/manuals/chapters/smscb.adoc b/doc/manuals/chapters/smscb.adoc
index f7469a3..011aec4 100644
--- a/doc/manuals/chapters/smscb.adoc
+++ b/doc/manuals/chapters/smscb.adoc
@@ -13,7 +13,7 @@
 
 In order to use SMSCB with OsmoBSC, you will need to
 
-* Configure the CBSP server and/or client
+* Configure OsmoBSC as either CBSP server or client
 * Use a channel combination including a CBCH on the BTSs
 
 === Enabling a CBCH channel combination
@@ -41,41 +41,63 @@
 In order to comply with the specifications, OsmoBSC supports this mode
 of operation as CBSP TCP server.  However, to make network operation and
 configuration more simple, it also can operate in TCP client mode,
-connecting to the CBC.  This way the all the BSCs need to know is the CBC IP
+connecting to the CBC.  This way the BSCs need to know the CBC IP
 address, but not vice-versa.
 
-The BSC can operate both CBSP TCP server and CBSP TCP client mode in
-parallel.
+The BSC can operate in either CBSP TCP server mode or CBSP TCP client mode.
 
 The CBC related configuration of OsmoBSC can be found in the `cbc` configuration
 node of the VTY interface.
 
-.Example: Configure CBSP TCP client to connect to CBC at 1.2.3.4:48049
+The default port number for the CBSP server is 48049, according to the CBSP
+specification. Hence it normally suffices to configure only the IP addresses for
+the remote CBC server or the local CBSP server:
+
+.Example: Configure CBSP TCP client to connect to CBC at 1.2.3.4:48049 in osmo-bsc.cfg
 ----
-OsmoBSC> enable
-OsmoBSC# configure terminal
-OsmoBSC(config)# cbc
-OsmoBSC(config-cbc)# remote-ip 1.2.3.4
-OsmoBSC(config-cbc)# remote-port 48049
-OsmoBSC(config-cbc)# end
+cbc
+ mode client
+ client
+  remote-ip 1.2.3.4
 ----
 
-.Example: Disable CBSP TCP client
+In server mode, the default configuration is 127.0.0.1:48049, so it suffices to
+set `mode server` to accept CBSP connections from localhost:
+
 ----
-OsmoBSC> enable
-OsmoBSC# configure terminal
-OsmoBSC(config)# cbc
-OsmoBSC(config-cbc)# no remote-ip
-OsmoBSC(config-cbc)# end
+cbc
+ mode server
 ----
 
-.Example: Configure CBSP TCP server to listen for CBC at 127.0.0.2:9999
+To also listen for inbound CBSP connections on all interfaces, both IPv4 and
+IPv6:
+
+.Example: Configure CBSP TCP server to listen on all interfaces in osmo-bsc.cfg
+----
+cbc
+ mode server
+ server
+  local-ip ::
+----
+
+Should non-standard port numbers be required, these can be configured with the
+`client` / `local-port` or the `server` / `remote-port` settings.
+
+The `client` config also supports an explicit local bind for connecting to the
+remote CBC, using `client` / `local-ip` and `local-port`.
+
+IP addresses for client and server can remain configured at the same time, and
+the `mode` command can be used to switch between client and server operation.
+The `mode` command takes immediate effect, no restart of OsmoBSC is required.
+After changing `cbc` IP addresses in the telnet VTY, it is required to switch
+`mode` to `disabled` and back to `client` or `server` to take effect.
+
+.Example: Disable the CBSP link in the telnet VTY
 ----
 OsmoBSC> enable
 OsmoBSC# configure terminal
 OsmoBSC(config)# cbc
-OsmoBSC(config-cbc)# listen-ip 127.0.0.2
-OsmoBSC(config-cbc)# listen-port 9999
+OsmoBSC(config-cbc)# mode disabled
 OsmoBSC(config-cbc)# end
 ----
 

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

Gerrit-Project: osmo-bsc
Gerrit-Branch: master
Gerrit-Change-Id: I101144dc4ebf151fa23d05743398aeea4a26834b
Gerrit-Change-Number: 19966
Gerrit-PatchSet: 1
Gerrit-Owner: neels <nhofmeyr at sysmocom.de>
Gerrit-Reviewer: Jenkins Builder
Gerrit-Reviewer: laforge <laforge at osmocom.org>
Gerrit-MessageType: merged
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.osmocom.org/pipermail/gerrit-log/attachments/20200903/d996281c/attachment.htm>


More information about the gerrit-log mailing list