Updated README and NEWS

This commit is contained in:
jjako 2003-01-05 18:36:33 +00:00
parent 6922f96c8f
commit 0ac82a12e7
2 changed files with 55 additions and 36 deletions

10
NEWS
View File

@ -1,7 +1,17 @@
OpenGGSN - Gateway GPRS Support Node
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
* Initial release. See README file for installation and usage
instructions.

81
README
View File

@ -2,7 +2,7 @@
REQUIREMENTS
Linux
Linux
OpenGGSN was developed and tested using Redhat 7.1 and Redhat
7.2. It should run also on other Linux distributions as well as
FreeBSD and Solaris, but this is untested. Please tell me of any
@ -11,16 +11,22 @@ testing results.
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
installation. Tun should be included from linux kernel version 2.4, so
you might not need to manually install tun.
installation. Tun is included in the kernel from early version 2.4, so
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
make clean
cd gtp
make
make install
cd ..
make
INSTALLATION
Need to be root to do this
make install
Add /usr/local/lib to /etc/ld.so.conf
Run ldconfig
@ -29,10 +35,10 @@ RUNNING
sgsnemu
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:
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
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.
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:
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
10.20.30.40
@ -60,53 +69,58 @@ OpenGGSN provides 3 components:
* sgsnemu
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
GSN. Currently gtplib supports GTPv0.
ggsn
The ggsn implements a Gateway GPRS Support Node. The GGSN is a
small application which is provided in order to test and demonstrate
the use of gtplib. It is fully compliant to the 3GPP standards, but
lack important functionality such as charging and management. Use this
The ggsn implements a Gateway GPRS Support Node. The GGSN is a small
application which is provided in order to test and demonstrate the use
of gtplib. It is fully compliant to the 3GPP standards, but lacks
important functionality such as charging and management. Use this
application as a starting point if you want to build your own GGSN
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
in a 3G radio access network. An important application of sgsnemu is
the testing of roaming connectivity through a GPRS roaming exchange.
*** Required software ***
TUN
http://vtun.sourceforge.net/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
http://www.gnu.org/software/gengetopt/gengetopt.html
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
released yet 2002-12-12).
cmdline.ggo source file. You need at least gengetopt version 2.8.
If you are just going to compile the programs you don't need
gengetopt.
To use gengetopt do the following:
To use gengetopt for the ggsn do the following:
cd ggsn
../../gengetopt-2.8rc/src/gengetopt < cmdline.ggo --conf-parser
insert #define _GNU_SOURCE in the top of cmdline.c to get rid of warnings.
gengetopt < cmdline.ggo --conf-parser
To use gengetopt do the following:
To use gengetopt for the sgsnemu do the following:
cd sgsnemu
../../gengetopt-2.8rc/src/gengetopt < cmdline.ggo --conf-parser
insert #define _GNU_SOURCE in the top of cmdline.c to get rid of warnings.
gengetopt < cmdline.ggo --conf-parser
libPropList-0.10.1 (??? I can't remember if I use this???)
ftp://ftp.windowmaker.org/pub/libs
*** Compilation and Installation ***
@ -121,18 +135,13 @@ See http://sources.redhat.com/autobook/autobook/autobook_25.html#SEC25
6 run ./configure
7 rin make clean
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
10 Add /usr/local/lib to /etc/ld.so.conf
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
http://www.dwheeler.com/program-library/Program-Library-HOWTO/shared-libraries.html