Project

General

Profile

Osmo-gbproxy » History » Version 7

Anonymous, 02/19/2016 10:48 PM

1 7 laforge
{{>toc}}
2 1 laforge
3 7 laforge
h1. The Gb proxy
4
5
6 1 laforge
The purpose of the Gb proxy is to aggregate the Gb links of multiple
7
BSS's and present them in one Gb link to the SGSN.
8
9
More specifically, the Gb proxy terminates the NS-VCs of each BSS
10
locally.  Furthermore, it establishes one NS-VC with the SGSN.
11
12 7 laforge
Source code available as part of [[OpenBSC]] repository:
13
<pre>
14 6 laforge
git clone git://git.osmocom.org/openbsc.git
15 7 laforge
</pre>
16 6 laforge
17 1 laforge
The proxy then forwards NS-DUs (BSSGP PDUs) between the SGSN and the
18
respective BSS (and vice versa).
19 7 laforge
<pre>
20
<code class="graphviz">
21 5 laforge
digraph G {
22 1 laforge
  rankdir=LR;
23
  nanobts1->OpenBSC  [ label="Abis/IP" ];
24 5 laforge
  nanobts2->OpenBSC  [ label="Abis/IP" ];
25 1 laforge
  nanobts1->gb_proxy [ label="Gb/IP" ];
26
  nanobts2->gb_proxy [ label="Gb/IP" ];
27
  gb_proxy->SGSN     [ label="Gb/IP or\nGb/FR/GRE/IP" ];
28 5 laforge
  nanobts2 [ label = "nanoBTS 2" ];
29
  nanobts1 [ label = "nanoBTS 1" ];
30 7 laforge
  [[OpenBSC]] [ label = "OpenBSC" ]
31 5 laforge
}
32 7 laforge
</code></pre>
33 5 laforge
34 1 laforge
35 7 laforge
h2. Configuring and using osmo-gbproxy
36
37
38 1 laforge
Like other programs in this project, osmo-gbproxy accepts a number of command line arguments
39
but is generally configured by a configuration file (which can be interactively created/edited
40
from the VTY).
41 3 laforge
42 1 laforge
The command line arguments are:
43 7 laforge
<pre>
44 1 laforge
  -h --help this text
45
  -d option --debug=DNS:DGPRS,0:0 enable debugging
46
  -c --config-file filename The config file to use.
47 3 laforge
  -s --disable-color
48
  -T --timestamp Prefix every log line with a timestamp
49 7 laforge
  -V --version. Print the version of [[OpenBSC]].
50 3 laforge
  -e --log-level number. Set a global loglevel.
51 7 laforge
</code></pre>
52 3 laforge
53 7 laforge
There is a wiki page [[osmo-gbproxy_VTY]] with a reference for all VTY commands
54 1 laforge
55
56 7 laforge
h2. Advanced use cases
57 1 laforge
58 7 laforge
59
60
h3. Cascading proxies
61
62
63 2 laforge
You can also cascade multiple Gb proxies behind each other, where a number
64 1 laforge
of BSS connect to one Gb proxy, which in turn connects to another Gb proxy,
65
which then finally connects to the SGSN.  
66
67
The reason for this type of use can be broken or limited Gb implementations
68
in proprietary BSS equipment, which fails to re-connect the Gb link after some
69
intermittent network outage.
70
71
72 7 laforge
h2. Design documentation
73
74
75
There's a more detailed [[osmo-gbproxy_design|design description]] outlining
76 1 laforge
details of the proxy.
Add picture from clipboard (Maximum size: 48.8 MB)