<p>neels has uploaded this change for <strong>review</strong>.</p><p><a href="https://gerrit.osmocom.org/c/osmo-bsc/+/19966">View Change</a></p><pre style="font-family: monospace,monospace; white-space: pre-wrap;">CBSP: adjust manual to reflect new 'cbc' VTY config<br><br>Related: OS#4702<br>Change-Id: I101144dc4ebf151fa23d05743398aeea4a26834b<br>---<br>M doc/manuals/chapters/smscb.adoc<br>1 file changed, 42 insertions(+), 20 deletions(-)<br><br></pre><pre style="font-family: monospace,monospace; white-space: pre-wrap;">git pull ssh://gerrit.osmocom.org:29418/osmo-bsc refs/changes/66/19966/1</pre><pre style="font-family: monospace,monospace; white-space: pre-wrap;"><span>diff --git a/doc/manuals/chapters/smscb.adoc b/doc/manuals/chapters/smscb.adoc</span><br><span>index f7469a3..011aec4 100644</span><br><span>--- a/doc/manuals/chapters/smscb.adoc</span><br><span>+++ b/doc/manuals/chapters/smscb.adoc</span><br><span>@@ -13,7 +13,7 @@</span><br><span> </span><br><span> In order to use SMSCB with OsmoBSC, you will need to</span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">-* Configure the CBSP server and/or client</span><br><span style="color: hsl(120, 100%, 40%);">+* Configure OsmoBSC as either CBSP server or client</span><br><span> * Use a channel combination including a CBCH on the BTSs</span><br><span> </span><br><span> === Enabling a CBCH channel combination</span><br><span>@@ -41,41 +41,63 @@</span><br><span> In order to comply with the specifications, OsmoBSC supports this mode</span><br><span> of operation as CBSP TCP server.  However, to make network operation and</span><br><span> configuration more simple, it also can operate in TCP client mode,</span><br><span style="color: hsl(0, 100%, 40%);">-connecting to the CBC.  This way the all the BSCs need to know is the CBC IP</span><br><span style="color: hsl(120, 100%, 40%);">+connecting to the CBC.  This way the BSCs need to know the CBC IP</span><br><span> address, but not vice-versa.</span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">-The BSC can operate both CBSP TCP server and CBSP TCP client mode in</span><br><span style="color: hsl(0, 100%, 40%);">-parallel.</span><br><span style="color: hsl(120, 100%, 40%);">+The BSC can operate in either CBSP TCP server mode or CBSP TCP client mode.</span><br><span> </span><br><span> The CBC related configuration of OsmoBSC can be found in the `cbc` configuration</span><br><span> node of the VTY interface.</span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">-.Example: Configure CBSP TCP client to connect to CBC at 1.2.3.4:48049</span><br><span style="color: hsl(120, 100%, 40%);">+The default port number for the CBSP server is 48049, according to the CBSP</span><br><span style="color: hsl(120, 100%, 40%);">+specification. Hence it normally suffices to configure only the IP addresses for</span><br><span style="color: hsl(120, 100%, 40%);">+the remote CBC server or the local CBSP server:</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+.Example: Configure CBSP TCP client to connect to CBC at 1.2.3.4:48049 in osmo-bsc.cfg</span><br><span> ----</span><br><span style="color: hsl(0, 100%, 40%);">-OsmoBSC> enable</span><br><span style="color: hsl(0, 100%, 40%);">-OsmoBSC# configure terminal</span><br><span style="color: hsl(0, 100%, 40%);">-OsmoBSC(config)# cbc</span><br><span style="color: hsl(0, 100%, 40%);">-OsmoBSC(config-cbc)# remote-ip 1.2.3.4</span><br><span style="color: hsl(0, 100%, 40%);">-OsmoBSC(config-cbc)# remote-port 48049</span><br><span style="color: hsl(0, 100%, 40%);">-OsmoBSC(config-cbc)# end</span><br><span style="color: hsl(120, 100%, 40%);">+cbc</span><br><span style="color: hsl(120, 100%, 40%);">+ mode client</span><br><span style="color: hsl(120, 100%, 40%);">+ client</span><br><span style="color: hsl(120, 100%, 40%);">+  remote-ip 1.2.3.4</span><br><span> ----</span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">-.Example: Disable CBSP TCP client</span><br><span style="color: hsl(120, 100%, 40%);">+In server mode, the default configuration is 127.0.0.1:48049, so it suffices to</span><br><span style="color: hsl(120, 100%, 40%);">+set `mode server` to accept CBSP connections from localhost:</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span> ----</span><br><span style="color: hsl(0, 100%, 40%);">-OsmoBSC> enable</span><br><span style="color: hsl(0, 100%, 40%);">-OsmoBSC# configure terminal</span><br><span style="color: hsl(0, 100%, 40%);">-OsmoBSC(config)# cbc</span><br><span style="color: hsl(0, 100%, 40%);">-OsmoBSC(config-cbc)# no remote-ip</span><br><span style="color: hsl(0, 100%, 40%);">-OsmoBSC(config-cbc)# end</span><br><span style="color: hsl(120, 100%, 40%);">+cbc</span><br><span style="color: hsl(120, 100%, 40%);">+ mode server</span><br><span> ----</span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">-.Example: Configure CBSP TCP server to listen for CBC at 127.0.0.2:9999</span><br><span style="color: hsl(120, 100%, 40%);">+To also listen for inbound CBSP connections on all interfaces, both IPv4 and</span><br><span style="color: hsl(120, 100%, 40%);">+IPv6:</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+.Example: Configure CBSP TCP server to listen on all interfaces in osmo-bsc.cfg</span><br><span style="color: hsl(120, 100%, 40%);">+----</span><br><span style="color: hsl(120, 100%, 40%);">+cbc</span><br><span style="color: hsl(120, 100%, 40%);">+ mode server</span><br><span style="color: hsl(120, 100%, 40%);">+ server</span><br><span style="color: hsl(120, 100%, 40%);">+  local-ip ::</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%);">+Should non-standard port numbers be required, these can be configured with the</span><br><span style="color: hsl(120, 100%, 40%);">+`client` / `local-port` or the `server` / `remote-port` settings.</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+The `client` config also supports an explicit local bind for connecting to the</span><br><span style="color: hsl(120, 100%, 40%);">+remote CBC, using `client` / `local-ip` and `local-port`.</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+IP addresses for client and server can remain configured at the same time, and</span><br><span style="color: hsl(120, 100%, 40%);">+the `mode` command can be used to switch between client and server operation.</span><br><span style="color: hsl(120, 100%, 40%);">+The `mode` command takes immediate effect, no restart of OsmoBSC is required.</span><br><span style="color: hsl(120, 100%, 40%);">+After changing `cbc` IP addresses in the telnet VTY, it is required to switch</span><br><span style="color: hsl(120, 100%, 40%);">+`mode` to `disabled` and back to `client` or `server` to take effect.</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+.Example: Disable the CBSP link in the telnet VTY</span><br><span> ----</span><br><span> OsmoBSC> enable</span><br><span> OsmoBSC# configure terminal</span><br><span> OsmoBSC(config)# cbc</span><br><span style="color: hsl(0, 100%, 40%);">-OsmoBSC(config-cbc)# listen-ip 127.0.0.2</span><br><span style="color: hsl(0, 100%, 40%);">-OsmoBSC(config-cbc)# listen-port 9999</span><br><span style="color: hsl(120, 100%, 40%);">+OsmoBSC(config-cbc)# mode disabled</span><br><span> OsmoBSC(config-cbc)# end</span><br><span> ----</span><br><span> </span><br><span></span><br></pre><p>To view, visit <a href="https://gerrit.osmocom.org/c/osmo-bsc/+/19966">change 19966</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/+/19966"/><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: I101144dc4ebf151fa23d05743398aeea4a26834b </div>
<div style="display:none"> Gerrit-Change-Number: 19966 </div>
<div style="display:none"> Gerrit-PatchSet: 1 </div>
<div style="display:none"> Gerrit-Owner: neels <nhofmeyr@sysmocom.de> </div>
<div style="display:none"> Gerrit-MessageType: newchange </div>