osmo-gbproxy/doc/manuals/chapters/gbproxy-configuration.adoc

95 lines
3.2 KiB
Plaintext

== Configuring OsmoGbProxy
OsmoGbProxy requires very little configuration, most of it being the
configuration of the NS links.
Most config options specific to OsmoGbProxy are related to SGSN pooling and
telling the proxy which NSE(s) it should use to talk to the SGSN(s).
The following config snippets assume the SGSN(s) (NSEI 101 and 102) are using
IP-SNS and listen on 10.0.1.1:23000 and 10.0.1.2:23000 respectively.
=== Configure SGSN(s)
Configuration of a single (non-pooling) SGSN is rather simple.
.Example: SGSN configuration example
----
sgsn 101 <1>
name Main SGSN <2>
sgsn 102
ns
bind udp sgsn-side
listen 10.0.0.1 23000 <3>
nse 101 <4>
ip-sns-bind sgsn-side <5>
ip-sns-remote 10.0.1.1 23000 <6>
nse 102
ip-sns-bind sgsn-side
ip-sns-remote 10.0.1.2 23000
----
<1> Each SGSN is identified by its NSEI (same as in the NS configuration)
<2> An SGSN can optionally have a name. If none is set a default name will be used.
<3> Define IP/port from which to connect
<4> Define an NSE with NSEI
<5> Use this bind to connect from
<6> Use IP-SNS to connect to the SGSN
=== Configure a socket for BSS
The following configuration shows how to accept arbitrary BSS-NSE
.Example: NS configuration example (NS)
----
ns
bind udp bss-side <1>
listen 10.0.0.100 23000
accept-dynamic-ip-sns <2>
ip-sns-default bind bss-side <3>
----
<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
=== 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 <1>
BVCI 1235 RAI 001-01-1235-0 CID 1235: BSS NSEI 1002, SGSN NSEI 1
BVCI 1236 RAI 001-01-1236-0 CID 1236: BSS NSEI 1003, SGSN NSEI 1 2 <2>
BVCI 1237 RAI 001-01-1237-0 CID 1237: BSS NSEI <none>, SGSN NSEI <none> <3>
----
<1> Show cell information (BVCI, RAI)
<2> When multiple SGSNs are connected (SGSN pooling) more than one NSEI is shown
<3> If the BSS or SGSN side of a cell is currently disconnected none is shown instead of the NSEI