OsmoGGSN » History » Version 13
wirelesss, 12/16/2016 10:55 AM
1 | 2 | laforge | h1. [[OpenGGSN]] |
---|---|---|---|
2 | 1 | laforge | |
3 | 2 | laforge | [[OpenGGSN]] is an implementation of the Gateway GPRS Support Node ("GGSN":http://en.wikipedia.org/wiki/GGSN) element in the GPRS core network. |
4 | |||
5 | 3 | laforge | [[OpenGGSN]] was developed in 2002 to 2004 by Mondru AB and was abandoned for some years before adopted by the Osmocom project around 2010. |
6 | 1 | laforge | |
7 | 3 | laforge | h2. Source Code / git repository |
8 | |||
9 | The source code is maintained in the osmcoom git at http://git.osmocom.org/openggsn/ |
||
10 | |||
11 | h2. Binary packages |
||
12 | 1 | laforge | |
13 | OpenGGSN packages are created as part of the Osmocom nightly debian builds, see [[cellular-infrastructure:NightlyBuilds]] |
||
14 | 4 | laforge | |
15 | h2. Support / mailing lists |
||
16 | |||
17 | Please direct any questions regarding use, configuration or development of OpenGGSN to the osmocom-net-gprs@lists.osmocom.org mailing list, to which you can subscribe at https://lists.osmocom.org/mailman/listinfo/osmocom-net-gprs |
||
18 | 5 | wirelesss | |
19 | 7 | wirelesss | h2. Building OpenGGSN with kernel-gtp |
20 | 5 | wirelesss | |
21 | 13 | wirelesss | It is expected that complete openbsc project and dependencies are pre-installed. Check if package @libc-ares-dev@ is installed and if not please add it. |
22 | 12 | wirelesss | |
23 | 5 | wirelesss | Ubuntu 16.10, kernel 4.8.0-30-generic is used. |
24 | |||
25 | * Installing dependencies and build library @libgtpnl@ |
||
26 | |||
27 | 6 | wirelesss | You can install those packages with: |
28 | 5 | wirelesss | |
29 | <pre> |
||
30 | sudo apt install libtalloc-dev libpcsclite libmnl-dev |
||
31 | </pre> |
||
32 | 1 | laforge | |
33 | 12 | wirelesss | Please follow instructions provided at [[cellular-infrastructure:Build from source]] in order to install following library and projects : |
34 | 1 | laforge | |
35 | 6 | wirelesss | Information about dependencies between Osmocom projects is given at the above link: |
36 | |||
37 | 5 | wirelesss | * libgtpnl |
38 | |||
39 | <pre> |
||
40 | sudo make install |
||
41 | sudo ldconfig |
||
42 | </pre> |
||
43 | |||
44 | * libosmocore |
||
45 | * openggsn |
||
46 | |||
47 | <pre> |
||
48 | 1 | laforge | ./configure --enable-gtp-linux |
49 | 8 | wirelesss | make |
50 | sudo make install |
||
51 | sudo ldconfig |
||
52 | 5 | wirelesss | </pre> |
53 | |||
54 | Following message is shown at end of the command @ ./configure --enable-gtp-linux@ response: |
||
55 | |||
56 | <pre> |
||
57 | openggsn Configuration: |
||
58 | GTP Linux kernel support: yes |
||
59 | 6 | wirelesss | </pre> |
60 | |||
61 | This means that appropriate header files are available. |
||
62 | 1 | laforge | |
63 | 7 | wirelesss | |
64 | h2. Using OpenGGSN with kernel-gtp |
||
65 | |||
66 | In order to find out whether gtp.ko module is available we can enter following command: |
||
67 | 1 | laforge | |
68 | 7 | wirelesss | <pre> |
69 | find /lib/modules/`uname -r` -name gtp.ko |
||
70 | </pre> |
||
71 | |||
72 | 11 | wirelesss | Output below shows that gtp.ko module is present |
73 | 7 | wirelesss | |
74 | 1 | laforge | <pre> |
75 | 10 | wirelesss | /lib/modules/4.8.0-30-generic/kernel/drivers/net/gtp.ko |
76 | 7 | wirelesss | </pre> |
77 | 1 | laforge | |
78 | 7 | wirelesss | |
79 | 8 | wirelesss | We are loading module gtp from kernel by entering command <pre>sudo modprobe gtp </pre> |
80 | 1 | laforge | |
81 | 11 | wirelesss | command: |
82 | <pre> |
||
83 | lsmod | grep gtp |
||
84 | </pre> |
||
85 | 7 | wirelesss | |
86 | 8 | wirelesss | give us information about gtp and related udp tunnel: |
87 | 7 | wirelesss | |
88 | <pre> |
||
89 | gtp 28672 0 |
||
90 | udp_tunnel 16384 1 gtp |
||
91 | 1 | laforge | </pre> |
92 | |||
93 | |||
94 | 13 | wirelesss | Some helpful tools are available in: @libgtpnl/tools@ |
95 | 11 | wirelesss | |
96 | 13 | wirelesss | you can get more details about gtp-tunnel, entering command from the OpenGGSN shell: |
97 | 1 | laforge | |
98 | 13 | wirelesss | <pre> |
99 | gtp-tunnel list |
||
100 | </pre> |
||
101 | |||
102 | |||
103 | Furthermore we can use: <pre> sudo starce ggsn --gtp-linux -c ggsn.conf -f -d </pre> to determine if Ubuntu 16.10, kernel 4.8.0-30 is in use. |
||
104 | |||
105 | Next two cases shall be considered as an indication whether gtp kernel module is active: |
||
106 | |||
107 | ** If gtp kernel module is active then we can see the strace output just when PDP context activation or deactivation is done. |
||
108 | |||
109 | ** If gtp kernel module is not active then we can see the strace output constantly running on the screen. |
||
110 | |||
111 | |||
112 | 11 | wirelesss | Note: OpenGGSN is started by: |
113 | 1 | laforge | <pre> |
114 | 13 | wirelesss | sudo ggsn --gtp-linux -c ggsn.conf -f -d |
115 | 1 | laforge | </pre> |
116 | |||
117 | 13 | wirelesss | -d option is useful for debugging purposes. |
118 | 1 | laforge | |
119 | 13 | wirelesss | Related output should be similar to the one shown below: |
120 | |||
121 | 1 | laforge | <pre> |
122 | 13 | wirelesss | conf: ggsn.conf |
123 | fg: 1 |
||
124 | debug: 1 |
||
125 | qos: 0x0b921f |
||
126 | apn: internet |
||
127 | net: 192.168.0.0/24 |
||
128 | pidfile: /var/run/ggsn.pid |
||
129 | statedir: /var/lib/ggsn/ |
||
130 | gtp_linux: 1 |
||
131 | timelimit: 0 |
||
132 | cmdline_parser_configfile |
||
133 | listen: 127.0.0.1 |
||
134 | conf: ggsn.conf |
||
135 | fg: 1 |
||
136 | debug: 1 |
||
137 | qos: 0x0b921f |
||
138 | apn: internet |
||
139 | net: 192.168.0.0/24 |
||
140 | pidfile: /var/run/ggsn.pid |
||
141 | statedir: /var/lib/ggsn/ |
||
142 | gtp-linux: 1 |
||
143 | timelimit: 0 |
||
144 | <000c> gtp.c:701 GTP: gtp_newgsn() started |
||
145 | <0002> gtp-kernel.c:123 Using the GTP kernel mode (genl ID is 27) |
||
146 | |||
147 | <0002> gtp-kernel.c:156 GTP kernel configured |
||
148 | |||
149 | <000b> control_if.c:693 CTRL at 127.0.0.1 4257 |
||
150 | 1 | laforge | </pre> |
151 | |||
152 | 13 | wirelesss | osmosgsn can be started with: |
153 | 1 | laforge | |
154 | 13 | wirelesss | <pre> |
155 | sudo osmo-sgsn -c sgsn.cfg |
||
156 | </pre> |
||
157 | |||
158 | - d option is also available ins osmo-sgsn command. |
||
159 | |||
160 | Additional information related to setup of openbsc and GPRS setup is available [[cellular-infrastructure:OpenBSC GPRS]] |
||
161 | 7 | wirelesss | |
162 | 13 | wirelesss | For clarity purposes configuration files of openbsc, OpenGGSN, osmosgsn and sysmoBTS are added. |