Updated README and NEWS
This commit is contained in:
parent
6922f96c8f
commit
0ac82a12e7
10
NEWS
10
NEWS
|
@ -1,7 +1,17 @@
|
||||||
OpenGGSN - Gateway GPRS Support Node
|
OpenGGSN - Gateway GPRS Support Node
|
||||||
Copyright (C) 2002 Mondru AB.
|
Copyright (C) 2002 Mondru AB.
|
||||||
|
|
||||||
|
Version 0.6b
|
||||||
|
|
||||||
|
* Improved README file.
|
||||||
|
* Absolute path to ifconfig and route in ggsn and sgsnemu
|
||||||
|
* Absolute path to gtp library in ggsn/Makefile.am and ggsn/Makefile.am
|
||||||
|
* Compiles with gengetopt 2.8 (Thanks to Lorenzo Bettini
|
||||||
|
<lorenzo.bettini@penteres.it>
|
||||||
|
|
||||||
|
|
||||||
Version 0.5
|
Version 0.5
|
||||||
|
|
||||||
* Initial release. See README file for installation and usage
|
* Initial release. See README file for installation and usage
|
||||||
instructions.
|
instructions.
|
||||||
|
|
||||||
|
|
79
README
79
README
|
@ -11,16 +11,22 @@ testing results.
|
||||||
Tun
|
Tun
|
||||||
Both ggsn and sgsnemu uses the tun package. You need at least tun
|
Both ggsn and sgsnemu uses the tun package. You need at least tun
|
||||||
version 1.1. See http://vtun.sourceforge.net/tun/ for instructions on
|
version 1.1. See http://vtun.sourceforge.net/tun/ for instructions on
|
||||||
installation. Tun should be included from linux kernel version 2.4, so
|
installation. Tun is included in the kernel from early version 2.4, so
|
||||||
you might not need to manually install tun.
|
you will not normall need to install it. You do however need to do the
|
||||||
|
following:
|
||||||
|
mkdir /dev/net
|
||||||
|
mknod /dev/net/tun c 10 200
|
||||||
|
Add the following line to /etc/modules.conf: alias char-major-10-200 tun
|
||||||
|
depmod -a
|
||||||
|
|
||||||
COMPILATION
|
|
||||||
|
COMPILATION and INSTALLATION
|
||||||
./configure
|
./configure
|
||||||
make clean
|
cd gtp
|
||||||
|
make
|
||||||
|
make install
|
||||||
|
cd ..
|
||||||
make
|
make
|
||||||
|
|
||||||
INSTALLATION
|
|
||||||
Need to be root to do this
|
|
||||||
make install
|
make install
|
||||||
Add /usr/local/lib to /etc/ld.so.conf
|
Add /usr/local/lib to /etc/ld.so.conf
|
||||||
Run ldconfig
|
Run ldconfig
|
||||||
|
@ -29,10 +35,10 @@ RUNNING
|
||||||
|
|
||||||
sgsnemu
|
sgsnemu
|
||||||
Edit the configuration file sgsnemu.conf found under
|
Edit the configuration file sgsnemu.conf found under
|
||||||
openggsn/examples.
|
openggsn/examples. Use sgsnemu -h for a list of available options.
|
||||||
Start the emulator using the command:
|
Start the emulator using the command:
|
||||||
|
|
||||||
sgsnemu -c examples/sgsnemu.conf -l 10.20.30.50 -r 10.20.30.40 --apn internet
|
sgsnemu -c examples/sgsnemu.conf -l 10.20.30.50 -r 10.20.30.40
|
||||||
|
|
||||||
This will cause the sgsn emulator to bind to local address 10.20.30.50
|
This will cause the sgsn emulator to bind to local address 10.20.30.50
|
||||||
and connect to the ggsn found at 10.20.30.40. It will first send off
|
and connect to the ggsn found at 10.20.30.40. It will first send off
|
||||||
|
@ -42,9 +48,12 @@ routing. Now you should be able to ping through the connection. Use a
|
||||||
network analysator such as ethereal to monitor the traffic.
|
network analysator such as ethereal to monitor the traffic.
|
||||||
|
|
||||||
ggsn
|
ggsn
|
||||||
Edit the configuration file ggsn.conf found under openggsn/examples.
|
Edit the configuration file ggsn.conf found under
|
||||||
|
openggsn/examples. Use sgsnemu -h for a list of available options.
|
||||||
Start the ggsn using the command:
|
Start the ggsn using the command:
|
||||||
ggsn --fg -c examples/ggsn.conf -l 10.20.30.40
|
|
||||||
|
ggsn --fg -c examples/ggsn.conf -l 10.20.30.40 --statedir .
|
||||||
|
|
||||||
This will run the ggsn in foreground using the local interface
|
This will run the ggsn in foreground using the local interface
|
||||||
10.20.30.40
|
10.20.30.40
|
||||||
|
|
||||||
|
@ -60,53 +69,58 @@ OpenGGSN provides 3 components:
|
||||||
* sgsnemu
|
* sgsnemu
|
||||||
|
|
||||||
gtplib
|
gtplib
|
||||||
This library contain all functionality retating to the GTP
|
This library contains all functionality relating to the GTP
|
||||||
protocol. Use this libraty if you want to implement your own
|
protocol. Use this libraty if you want to implement your own
|
||||||
GSN. Currently gtplib supports GTPv0.
|
GSN. Currently gtplib supports GTPv0.
|
||||||
|
|
||||||
ggsn
|
ggsn
|
||||||
The ggsn implements a Gateway GPRS Support Node. The GGSN is a
|
The ggsn implements a Gateway GPRS Support Node. The GGSN is a small
|
||||||
small application which is provided in order to test and demonstrate
|
application which is provided in order to test and demonstrate the use
|
||||||
the use of gtplib. It is fully compliant to the 3GPP standards, but
|
of gtplib. It is fully compliant to the 3GPP standards, but lacks
|
||||||
lack important functionality such as charging and management. Use this
|
important functionality such as charging and management. Use this
|
||||||
application as a starting point if you want to build your own GGSN
|
application as a starting point if you want to build your own GGSN
|
||||||
with your own fancy VPN, management and charging functionality.
|
with your own fancy VPN, management and charging functionality.
|
||||||
|
|
||||||
sgsnemu This application emulates a Serving GPRS Support Node. sgsnemu
|
sgsnemu
|
||||||
|
This application emulates a Serving GPRS Support Node (SGSN). sgsnemu
|
||||||
enable you to test your 3GPP core network without the need to invest
|
enable you to test your 3GPP core network without the need to invest
|
||||||
in a 3G radio access network. An important application of sgsnemu is
|
in a 3G radio access network. An important application of sgsnemu is
|
||||||
the testing of roaming connectivity through a GPRS roaming exchange.
|
the testing of roaming connectivity through a GPRS roaming exchange.
|
||||||
|
|
||||||
|
|
||||||
*** Required software ***
|
*** Required software ***
|
||||||
|
|
||||||
TUN
|
TUN
|
||||||
http://vtun.sourceforge.net/tun/
|
http://vtun.sourceforge.net/tun/
|
||||||
|
|
||||||
Both ggsn and sgsnemu uses the tun package. You need at least tun
|
Both ggsn and sgsnemu uses the tun package. You need at least tun
|
||||||
version 1.1. See the above web page for instructions on installation.
|
version 1.1. See the above web page for instructions on
|
||||||
|
installation. Tun is included in the kernel from early version 2.4, so
|
||||||
|
you will not normally need to install it. For Redhat 7.1 and 7.2 you
|
||||||
|
do however need to do the following:
|
||||||
|
mkdir /dev/net
|
||||||
|
mknod /dev/net/tun c 10 200
|
||||||
|
Add the following line to /etc/modules.conf: alias char-major-10-200 tun
|
||||||
|
depmod -a
|
||||||
|
|
||||||
|
|
||||||
GENGETOPT
|
GENGETOPT
|
||||||
http://www.gnu.org/software/gengetopt/gengetopt.html
|
http://www.gnu.org/software/gengetopt/gengetopt.html
|
||||||
|
|
||||||
Gengetopt is required if you want to change the options defined in the
|
Gengetopt is required if you want to change the options defined in the
|
||||||
cmdline.ggo source file. You need at least gengetopt version 2.8 (Not
|
cmdline.ggo source file. You need at least gengetopt version 2.8.
|
||||||
released yet 2002-12-12).
|
|
||||||
|
|
||||||
If you are just going to compile the programs you don't need
|
If you are just going to compile the programs you don't need
|
||||||
gengetopt.
|
gengetopt.
|
||||||
|
|
||||||
To use gengetopt do the following:
|
To use gengetopt for the ggsn do the following:
|
||||||
cd ggsn
|
cd ggsn
|
||||||
../../gengetopt-2.8rc/src/gengetopt < cmdline.ggo --conf-parser
|
gengetopt < cmdline.ggo --conf-parser
|
||||||
insert #define _GNU_SOURCE in the top of cmdline.c to get rid of warnings.
|
|
||||||
|
|
||||||
To use gengetopt do the following:
|
To use gengetopt for the sgsnemu do the following:
|
||||||
cd sgsnemu
|
cd sgsnemu
|
||||||
../../gengetopt-2.8rc/src/gengetopt < cmdline.ggo --conf-parser
|
gengetopt < cmdline.ggo --conf-parser
|
||||||
insert #define _GNU_SOURCE in the top of cmdline.c to get rid of warnings.
|
|
||||||
|
|
||||||
libPropList-0.10.1 (??? I can't remember if I use this???)
|
|
||||||
ftp://ftp.windowmaker.org/pub/libs
|
|
||||||
|
|
||||||
*** Compilation and Installation ***
|
*** Compilation and Installation ***
|
||||||
|
|
||||||
|
@ -121,18 +135,13 @@ See http://sources.redhat.com/autobook/autobook/autobook_25.html#SEC25
|
||||||
6 run ./configure
|
6 run ./configure
|
||||||
7 rin make clean
|
7 rin make clean
|
||||||
8 run make
|
8 run make
|
||||||
|
(First time you run make it will complain that it can not find gtp.
|
||||||
|
Ignore the warning, gtp will get installed when you run make install)
|
||||||
9 run make install
|
9 run make install
|
||||||
10 Add /usr/local/lib to /etc/ld.so.conf
|
10 Add /usr/local/lib to /etc/ld.so.conf
|
||||||
11 run ldconfig
|
11 run ldconfig
|
||||||
|
|
||||||
|
|
||||||
*** Installation of libraries
|
|
||||||
|
|
||||||
cd gtp
|
|
||||||
make install
|
|
||||||
Add /usr/local/lib to /etc/ld.so.conf
|
|
||||||
run ldconfig
|
|
||||||
|
|
||||||
On RedHat add /usr/local/lib to /etc/ld.so.conf
|
On RedHat add /usr/local/lib to /etc/ld.so.conf
|
||||||
http://www.dwheeler.com/program-library/Program-Library-HOWTO/shared-libraries.html
|
http://www.dwheeler.com/program-library/Program-Library-HOWTO/shared-libraries.html
|
||||||
|
|
||||||
|
|
Reference in New Issue