Documentation update: Remove NEWS, README.Solaris, update README.md
* README.Solaris is obsolete and related code has been removed * NEWS file was unmaintained for more than a decade, remove it * Remove "Performance" chapter about 550MHz Athlon * gengetopt is no longer needed for ggsn * remove compilation/installation instructions horribly out of date * command line syntax of 'ggsn' program has changed Change-Id: I45d627911503c7b733cae6a1396ca4d69a9994db
This commit is contained in:
parent
dda21ed7d4
commit
3591437e0f
|
@ -10,6 +10,6 @@ $(top_srcdir)/.version:
|
|||
dist-hook:
|
||||
echo $(VERSION) > $(distdir)/.tarball-version
|
||||
|
||||
EXTRA_DIST = git-version-gen .version README.md README.FreeBSD README.MacOSX README.Solaris
|
||||
EXTRA_DIST = git-version-gen .version README.md README.FreeBSD README.MacOSX
|
||||
|
||||
@RELMAKE@
|
||||
|
|
78
NEWS
78
NEWS
|
@ -1,78 +0,0 @@
|
|||
OPENGGSN NEWS
|
||||
=============
|
||||
|
||||
OpenGGSN - Gateway GPRS Support Node
|
||||
Copyright (C) 2002, 2003, 2004 Mondru AB.
|
||||
|
||||
Version 0.84
|
||||
============
|
||||
|
||||
* Initial MAC OSX support (Thanks to Pekka Nikander)
|
||||
* Quality assurance and improved error logging (Thanks to Pekka
|
||||
Nikander and Jonny Winberg)
|
||||
|
||||
Version 0.83
|
||||
============
|
||||
|
||||
* Added selection mode and charging characteristics option to sgsnemu.
|
||||
* Bug fixes on charging characteristics and PPP PCO length.(Thanks to
|
||||
Loic Bernable <leto@vilya.org>).
|
||||
* Improved Solaris support, hash table bugfix and improved logging.
|
||||
|
||||
Version 0.82
|
||||
============
|
||||
|
||||
* Improved Solaris support.
|
||||
* Routing manipulation and IP address alias capability for FreeBSD.
|
||||
* Initial Debian port (Thanks to ARAKI Yasuhiro <ar@debian.org>).
|
||||
|
||||
Version 0.81
|
||||
============
|
||||
|
||||
* Initial FreeBSD port (Thanks to Pavel Andreev <pavel.andreev@hp.com>).
|
||||
* IMSI '1111' bugfix (Thanks to Pavel Andreev <pavel.andreev@hp.com>).
|
||||
|
||||
Version 0.8
|
||||
===========
|
||||
|
||||
* Support for compilation under Solaris.
|
||||
* Iptables firewall script.
|
||||
* New options for sgsnemu
|
||||
|
||||
|
||||
Version 0.7
|
||||
===========
|
||||
|
||||
* Support for GTP1. Currently without support for the secondary pdp
|
||||
context activation procedure.
|
||||
* sgsnemu will first attempt to use GTP1. If that fails it will
|
||||
fallback to using GTP0.
|
||||
* Standards compliance document.
|
||||
|
||||
Version 0.6
|
||||
===========
|
||||
|
||||
* Improved README file.
|
||||
* Now uses ioctl instead of 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 <bettini@gnu.org>)
|
||||
* sgsnemu is now able to handle several contexts and allocate
|
||||
interface IP addresses for each context.
|
||||
* ggsn now supports protocol configuration option DNS
|
||||
addresses. This allow mobile stations to set up DNS based on
|
||||
information configured in the ggsn.
|
||||
* Ping facility in sgsnemu allow testing without the need to route
|
||||
packets through the tun interface.
|
||||
* Man pages for ggsn and sgsnemu.
|
||||
* Sys 5 init script.
|
||||
* Spec file for building binary RPM packages.
|
||||
* If not --createif exit after "ping" or "echo" finishes
|
||||
* If sgsnemu echo failure, exit with code != 0
|
||||
|
||||
|
||||
Version 0.5
|
||||
===========
|
||||
|
||||
* Initial release. See README file for installation and usage
|
||||
instructions.
|
||||
|
|
@ -1,41 +0,0 @@
|
|||
OpenGGSN/Solaris notes
|
||||
======================
|
||||
|
||||
Solaris support is experimental, please test and report bugs. The
|
||||
Solaris port is tested under Solaris 8.
|
||||
|
||||
Compiling
|
||||
---------
|
||||
|
||||
You need to edit the following line in ggsn/Makefile.in and
|
||||
sgsnemu/Makefile.in:
|
||||
|
||||
LDFLAGS = -Wl,--rpath -Wl,/usr/local/lib @EXEC_LDFLAGS@
|
||||
|
||||
should be changed to:
|
||||
|
||||
LDFLAGS = -lresolv -lsocket -lnsl @EXEC_LDFLAGS@
|
||||
|
||||
After this you install by the following commands:
|
||||
./configure
|
||||
make
|
||||
make install
|
||||
|
||||
|
||||
TUN
|
||||
---
|
||||
|
||||
You might or might not need to install the tun driver manually. For
|
||||
general information about tun see http://vtun.sourceforge.net/tun/
|
||||
|
||||
|
||||
Known problems
|
||||
--------------
|
||||
|
||||
Currently multiple IP addresses on the same network interface is not
|
||||
implemented for Solaris.
|
||||
|
||||
Currently routing table manipulation is not implemented for
|
||||
Solaris. You have to set the routes manually after you start ggsn or
|
||||
sgsnemu.
|
||||
|
122
README.md
122
README.md
|
@ -174,26 +174,6 @@ exchange. sgsnemu will first attempt to use GTPv1. If unsuccessful it
|
|||
will fallback to GTPv0.
|
||||
|
||||
|
||||
Performance
|
||||
===========
|
||||
|
||||
Two experiments were performed in order to test the performance of
|
||||
sgsnemu and ggsn. The ggsn used a 550 MHz Athlon with 384 MB of
|
||||
RAM. sgsnemu used a 1 GHz Athlon with 256 MB of RAM. Both machines had
|
||||
100 Mb/s NICs (RTL-8139) and were connected through a crossed patch
|
||||
cable. Both tests were performed by sending ICMP echo packets from
|
||||
sgsnemu to the ggsn.
|
||||
|
||||
89.5 Mb/s IP throughput when sending 10000 ICMP ping packets with a
|
||||
payload of 1400 bytes. Transfer time 1.27 sec, no packets lost.
|
||||
|
||||
71.4 Mb/s IP throughput when sending 10000 ICMP ping packets with a
|
||||
payload of 1000 bytes. Transfer time 1.15 sec, no packets lost.
|
||||
|
||||
12,1 Mb/s IP throughput when sending 10000 ICMP ping packets with a
|
||||
payload of 100 bytes. Transfer time 0.84 sec, no packets lost.
|
||||
|
||||
|
||||
Required software
|
||||
=================
|
||||
|
||||
|
@ -209,9 +189,6 @@ version 1.1. With Linux tun is normally included from kernel version
|
|||
|
||||
Alternatively you can execute "modprobe tun" on the commandline.
|
||||
|
||||
For Solaris the tun driver needs to be installed manually. For general
|
||||
information about tun see http://vtun.sourceforge.net/tun/
|
||||
|
||||
Gengetopt
|
||||
---------
|
||||
|
||||
|
@ -219,10 +196,6 @@ 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. If
|
||||
you are just going to compile the programs you don't need gengetopt.
|
||||
|
||||
To use gengetopt for the ggsn do the following:
|
||||
cd ggsn
|
||||
gengetopt < cmdline.ggo --conf-parser
|
||||
|
||||
To use gengetopt for the sgsnemu do the following:
|
||||
cd sgsnemu
|
||||
gengetopt < cmdline.ggo --conf-parser
|
||||
|
@ -234,98 +207,7 @@ http://www.gnu.org/software/gengetopt/gengetopt.html
|
|||
Compilation and Installation
|
||||
============================
|
||||
|
||||
|
||||
Setting up autotools
|
||||
--------------------
|
||||
|
||||
You do not need to perform this step if you are only going to compile
|
||||
the package:
|
||||
|
||||
1. Get version from somewhere: Script to extract version from configure.in
|
||||
2. Copy the latest config.guess and config.sub from ftp://ftp.gnu.org/gnu/config
|
||||
3. Run autoscan and copy configure.scan to configure.in
|
||||
4. Add/edit the following lines in configure.in:
|
||||
- AC_INIT(openggsn, 0.70, jj@openggsn.org)
|
||||
- AC_CONFIG_SRCDIR([gtp/gtp.c])
|
||||
- AM_CONFIG_HEADER([config.h])
|
||||
- AC_PROG_LIBTOOL
|
||||
- AM_PROG_LIBTOOL
|
||||
- AM_INIT_AUTOMAKE()
|
||||
5. libtoolize --automake --copy
|
||||
(ads copy of ltmain.sh)
|
||||
6. aclocal
|
||||
7. autoheader
|
||||
8. automake --add-missing --copy
|
||||
(Ads copy of mkinstalldirs missing, install-sh, depcomp)
|
||||
9. automake
|
||||
10. autoconf
|
||||
|
||||
The above will initialise the project to the current version of
|
||||
autotools (As installed in RedHat 8.0). See
|
||||
http://sources.redhat.com/autobook/autobook/autobook_25.html#SEC25
|
||||
for details on autotools.
|
||||
|
||||
|
||||
Checking out from CVS
|
||||
---------------------
|
||||
|
||||
To download the latest source code from anonymous CVS:
|
||||
|
||||
cvs -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/ggsn login
|
||||
cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/ggsn co openggsn
|
||||
|
||||
Or to download from developer CVS:
|
||||
|
||||
export CVS_RSH=ssh
|
||||
cvs -z3 -d:ext:developername@cvs.sourceforge.net:/cvsroot/ggsn co openggsn
|
||||
|
||||
Both the above sets of commands creates a new directory called openggsn.
|
||||
|
||||
|
||||
Compilation and installation
|
||||
----------------------------
|
||||
|
||||
If compiling under Solaris you need to edit the following line in
|
||||
ggsn/Makefile.in and sgsnemu/Makefile.in:
|
||||
|
||||
LDFLAGS = -Wl,--rpath -Wl,/usr/local/lib @EXEC_LDFLAGS@
|
||||
|
||||
should be changed to:
|
||||
|
||||
LDFLAGS = -lresolv -lsocket -lnsl @EXEC_LDFLAGS@
|
||||
|
||||
Note that the above is not necessary on other platforms. Compilation
|
||||
and installation is performed by the following steps:
|
||||
|
||||
1. ./configure
|
||||
2. make clean
|
||||
3. cd gtp
|
||||
4. make
|
||||
5. make install (as root)
|
||||
6. cd ..
|
||||
(Step 3 to 6 you only need to run the first time to install libgtp)
|
||||
7. make
|
||||
8. make install (as root)
|
||||
9. Add /usr/local/lib to /etc/ld.so.conf
|
||||
10. run ldconfig
|
||||
|
||||
(Steps 9 and 10 are not required as path to libgtp is included in Makefile)
|
||||
|
||||
Documentation can be converted to html by issuing:
|
||||
|
||||
1. txt2html -pm -tf README > README.html
|
||||
2. txt2html -pm -tf NEWS > NEWS.html
|
||||
3. man2htm ggsn.8 > ggsn.html
|
||||
4. man2htm sgsnemu.8 > sgsnemu.html
|
||||
|
||||
|
||||
Installation from binary
|
||||
------------------------
|
||||
|
||||
1. rpm -i openggsn-<version>.rpm
|
||||
|
||||
This will install binaries, man pages, configuration files as well as
|
||||
a Sys V init script for the ggsn.
|
||||
Please refer to the project homepage
|
||||
|
||||
|
||||
Running ggsn
|
||||
|
@ -337,7 +219,7 @@ examples/ggsn.conf for the format of this file.
|
|||
|
||||
Start the ggsn as root using the command:
|
||||
|
||||
ggsn -c examples/ggsn.conf --fg -l 10.0.0.40 --net 192.168.0.0/24 --dynip 192.168.0.0/24
|
||||
ggsn -c examples/ggsn.conf
|
||||
|
||||
First a tun network interface will be created. In the above example
|
||||
the network interface address is 192.168.0.0 and the mask is
|
||||
|
|
Loading…
Reference in New Issue