<p>daniel has uploaded this change for <strong>review</strong>.</p><p><a href="https://gerrit.osmocom.org/c/osmo-gbproxy/+/24694">View Change</a></p><pre style="font-family: monospace,monospace; white-space: pre-wrap;">manual: Add section describing show gbproxy command usage<br><br>Change-Id: Iad2775d125b842f47b0a7b8324fbe417bece04de<br>---<br>M doc/manuals/chapters/gbproxy-configuration.adoc<br>1 file changed, 48 insertions(+), 1 deletion(-)<br><br></pre><pre style="font-family: monospace,monospace; white-space: pre-wrap;">git pull ssh://gerrit.osmocom.org:29418/osmo-gbproxy refs/changes/94/24694/1</pre><pre style="font-family: monospace,monospace; white-space: pre-wrap;"><span>diff --git a/doc/manuals/chapters/gbproxy-configuration.adoc b/doc/manuals/chapters/gbproxy-configuration.adoc</span><br><span>index 79a508b..84eac07 100644</span><br><span>--- a/doc/manuals/chapters/gbproxy-configuration.adoc</span><br><span>+++ b/doc/manuals/chapters/gbproxy-configuration.adoc</span><br><span>@@ -48,4 +48,51 @@</span><br><span> ----</span><br><span> <1> Define bind with IP/port for the BSS</span><br><span> <2> Allow BSS with dynamic NSE to connect to this bind</span><br><span style="color: hsl(0, 100%, 40%);">-<3> Use this bind as default for dynamic NSE</span><br><span>\ No newline at end of file</span><br><span style="color: hsl(120, 100%, 40%);">+<3> Use this bind as default for dynamic NSE</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+=== Checking OsmoGbProxy state</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+The VTY interface (see <<vty>>) offers you commands to inspect the state of</span><br><span style="color: hsl(120, 100%, 40%);">+OsmoGbProxy.</span><br><span style="color: hsl(120, 100%, 40%);">+FIXME mention/link to NS VTY chapter</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%);">+.Example: Check SGSN-side BVCs</span><br><span style="color: hsl(120, 100%, 40%);">+----</span><br><span style="color: hsl(120, 100%, 40%);">+OsmoGbProxy# show gbproxy bvc sgsn <1></span><br><span style="color: hsl(120, 100%, 40%);">+NSEI 1, SIG-BVCI 0 [UNBLOCKED] <2></span><br><span style="color: hsl(120, 100%, 40%);">+NSEI 1, PTP-BVCI 1234, RAI 001-01-1234-0 [UNBLOCKED] <3></span><br><span style="color: hsl(120, 100%, 40%);">+NSEI 1, PTP-BVCI 1235, RAI 001-01-1235-0 [BLOCKED] <4></span><br><span style="color: hsl(120, 100%, 40%);">+----</span><br><span style="color: hsl(120, 100%, 40%);">+<1> show the BVCs towards the SGSN-side</span><br><span style="color: hsl(120, 100%, 40%);">+<2> a signalling BVC is required before PTP-BVCs can be established</span><br><span style="color: hsl(120, 100%, 40%);">+<3> for PTP-BVCs show the BVCI and RAI that was sent during the RESET procedure</span><br><span style="color: hsl(120, 100%, 40%);">+<4> a BVC on the SGSN-side can be blocked either because the BSS blocked the PTP-BVC or if the</span><br><span style="color: hsl(120, 100%, 40%);">+ BSS BVC vanished (due to BVC-RESET or NSE failure). Since there is no way to delete a PTP-BVC</span><br><span style="color: hsl(120, 100%, 40%);">+ it will stay until the SIG-BVC on that NSE is reset.</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+.Example: Check BSS-side BVCs</span><br><span style="color: hsl(120, 100%, 40%);">+----</span><br><span style="color: hsl(120, 100%, 40%);">+OsmoGbProxy# show gbproxy bvc bss <1></span><br><span style="color: hsl(120, 100%, 40%);">+NSEI 1001, SIG-BVCI 0 [UNBLOCKED]</span><br><span style="color: hsl(120, 100%, 40%);">+NSEI 1001, PTP-BVCI 1234, RAI 001-01-1234-0 [UNBLOCKED] <2></span><br><span style="color: hsl(120, 100%, 40%);">+NSEI 1002, SIG-BVCI 0 [UNBLOCKED]</span><br><span style="color: hsl(120, 100%, 40%);">+NSEI 1002, PTP-BVCI 1235, RAI 001-01-1235-0 [BLOCKED]</span><br><span style="color: hsl(120, 100%, 40%);">+----</span><br><span style="color: hsl(120, 100%, 40%);">+<1> show the BVCs towards the BSS-side</span><br><span style="color: hsl(120, 100%, 40%);">+<2> the information displayed is the same as for the SGSN-side</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+.Example: Show cell information</span><br><span style="color: hsl(120, 100%, 40%);">+----</span><br><span style="color: hsl(120, 100%, 40%);">+OsmoGbProxy# show gbproxy cell</span><br><span style="color: hsl(120, 100%, 40%);">+BVCI 1234 RAI 001-01-1234-0 CID 1234: BSS NSEI 1001, SGSN NSEI 1</span><br><span style="color: hsl(120, 100%, 40%);">+BVCI 1235 RAI 001-01-1235-0 CID 1235: BSS NSEI 1002, SGSN NSEI 1</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%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+----</span><br><span style="color: hsl(120, 100%, 40%);">+BVCI 1234 RAI 001-01-1234-0 CID 1234: BSS NSEI 1001, SGSN NSEI 1 2 <1></span><br><span style="color: hsl(120, 100%, 40%);">+BVCI 1235 RAI 001-01-1235-0 CID 1235: BSS NSEI <none>, SGSN NSEI <none> <2></span><br><span style="color: hsl(120, 100%, 40%);">+----</span><br><span style="color: hsl(120, 100%, 40%);">+<1> when multiple SGSNs are connected (SGSN pooling) more than one NSEI is shown</span><br><span style="color: hsl(120, 100%, 40%);">+<2> if the BSS or SGSN side of a cell is currently disconnected none is shown instead of the NSEI</span><br><span>\ No newline at end of file</span><br><span></span><br></pre><p>To view, visit <a href="https://gerrit.osmocom.org/c/osmo-gbproxy/+/24694">change 24694</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-gbproxy/+/24694"/><meta itemprop="name" content="View Change"/></div></div>
<div style="display:none"> Gerrit-Project: osmo-gbproxy </div>
<div style="display:none"> Gerrit-Branch: master </div>
<div style="display:none"> Gerrit-Change-Id: Iad2775d125b842f47b0a7b8324fbe417bece04de </div>
<div style="display:none"> Gerrit-Change-Number: 24694 </div>
<div style="display:none"> Gerrit-PatchSet: 1 </div>
<div style="display:none"> Gerrit-Owner: daniel <dwillmann@sysmocom.de> </div>
<div style="display:none"> Gerrit-MessageType: newchange </div>