Change in osmo-gbproxy[master]: manual: Add section describing show gbproxy command usage

daniel gerrit-no-reply at lists.osmocom.org
Wed Jun 16 12:56:10 UTC 2021


daniel has uploaded this change for review. ( https://gerrit.osmocom.org/c/osmo-gbproxy/+/24694 )


Change subject: manual: Add section describing show gbproxy command usage
......................................................................

manual: Add section describing show gbproxy command usage

Change-Id: Iad2775d125b842f47b0a7b8324fbe417bece04de
---
M doc/manuals/chapters/gbproxy-configuration.adoc
1 file changed, 48 insertions(+), 1 deletion(-)



  git pull ssh://gerrit.osmocom.org:29418/osmo-gbproxy refs/changes/94/24694/1

diff --git a/doc/manuals/chapters/gbproxy-configuration.adoc b/doc/manuals/chapters/gbproxy-configuration.adoc
index 79a508b..84eac07 100644
--- a/doc/manuals/chapters/gbproxy-configuration.adoc
+++ b/doc/manuals/chapters/gbproxy-configuration.adoc
@@ -48,4 +48,51 @@
 ----
 <1> Define bind with IP/port for the BSS
 <2> Allow BSS with dynamic NSE to connect to this bind
-<3> Use this bind as default for dynamic NSE
\ No newline at end of file
+<3> Use this bind as default for dynamic NSE
+
+=== Checking OsmoGbProxy state
+
+The VTY interface (see <<vty>>) offers you commands to inspect the state of
+OsmoGbProxy.
+FIXME mention/link to NS VTY chapter
+
+
+.Example: Check SGSN-side BVCs
+----
+OsmoGbProxy# show gbproxy bvc sgsn <1>
+NSEI     1, SIG-BVCI     0 [UNBLOCKED] <2>
+NSEI     1, PTP-BVCI  1234, RAI 001-01-1234-0 [UNBLOCKED] <3>
+NSEI     1, PTP-BVCI  1235, RAI 001-01-1235-0 [BLOCKED] <4>
+----
+<1> show the BVCs towards the SGSN-side
+<2> a signalling BVC is required before PTP-BVCs can be established
+<3> for PTP-BVCs show the BVCI and RAI that was sent during the RESET procedure
+<4> a BVC on the SGSN-side can be blocked either because the BSS blocked the PTP-BVC or if the
+    BSS BVC vanished (due to BVC-RESET or NSE failure). Since there is no way to delete a PTP-BVC
+    it will stay until the SIG-BVC on that NSE is reset.
+
+.Example: Check BSS-side BVCs
+----
+OsmoGbProxy# show gbproxy bvc bss <1>
+NSEI  1001, SIG-BVCI     0 [UNBLOCKED]
+NSEI  1001, PTP-BVCI  1234, RAI 001-01-1234-0 [UNBLOCKED] <2>
+NSEI  1002, SIG-BVCI     0 [UNBLOCKED]
+NSEI  1002, PTP-BVCI  1235, RAI 001-01-1235-0 [BLOCKED]
+----
+<1> show the BVCs towards the BSS-side
+<2> the information displayed is the same as for the SGSN-side
+
+.Example: Show cell information
+----
+OsmoGbProxy# show gbproxy cell
+BVCI  1234 RAI 001-01-1234-0 CID  1234: BSS NSEI  1001, SGSN NSEI     1
+BVCI  1235 RAI 001-01-1235-0 CID  1235: BSS NSEI  1002, SGSN NSEI     1
+----
+
+
+----
+BVCI  1234 RAI 001-01-1234-0 CID  1234: BSS NSEI  1001, SGSN NSEI     1     2 <1>
+BVCI  1235 RAI 001-01-1235-0 CID  1235: BSS NSEI  <none>, SGSN NSEI <none> <2>
+----
+<1> when multiple SGSNs are connected (SGSN pooling) more than one NSEI is shown
+<2> if the BSS or SGSN side of a cell is currently disconnected none is shown instead of the NSEI
\ No newline at end of file

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

Gerrit-Project: osmo-gbproxy
Gerrit-Branch: master
Gerrit-Change-Id: Iad2775d125b842f47b0a7b8324fbe417bece04de
Gerrit-Change-Number: 24694
Gerrit-PatchSet: 1
Gerrit-Owner: daniel <dwillmann at sysmocom.de>
Gerrit-MessageType: newchange
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.osmocom.org/pipermail/gerrit-log/attachments/20210616/98944ff7/attachment.htm>


More information about the gerrit-log mailing list