From 13ba41c8f3b66575a057f50dad9c9b9701675e3d Mon Sep 17 00:00:00 2001 From: Oliver Smith Date: Wed, 28 Nov 2018 10:44:12 +0100 Subject: remove OsmoGGSN files (now avail in osmo-ggsn.git) Files were added in osmo-ggsn.git Change-Id I14533676d5774ee0d0ee5054ba77d7dac32cff43 Depends: osmo-ggsn.git Change-Id I14533676d5774ee0d0ee5054ba77d7dac32cff43 Related: OS#3385 Change-Id: I4b9e2836a74b84bfc73ea7048a137ab5253d9045 --- Makefile.am | 1 - OsmoGGSN/Makefile.am | 15 - OsmoGGSN/chapters/configuration.adoc | 335 ------- OsmoGGSN/chapters/overview.adoc | 145 --- OsmoGGSN/chapters/running.adoc | 82 -- OsmoGGSN/osmoggsn-usermanual-docinfo.xml | 46 - OsmoGGSN/osmoggsn-usermanual.adoc | 29 - OsmoGGSN/osmoggsn-vty-reference.xml | 38 - OsmoGGSN/vty/ggsn_vty_additions.xml | 30 - OsmoGGSN/vty/ggsn_vty_reference.xml | 1447 ------------------------------ configure.ac | 1 - 11 files changed, 2169 deletions(-) delete mode 100644 OsmoGGSN/Makefile.am delete mode 100644 OsmoGGSN/chapters/configuration.adoc delete mode 100644 OsmoGGSN/chapters/overview.adoc delete mode 100644 OsmoGGSN/chapters/running.adoc delete mode 100644 OsmoGGSN/osmoggsn-usermanual-docinfo.xml delete mode 100644 OsmoGGSN/osmoggsn-usermanual.adoc delete mode 100644 OsmoGGSN/osmoggsn-vty-reference.xml delete mode 100644 OsmoGGSN/vty/ggsn_vty_additions.xml delete mode 100644 OsmoGGSN/vty/ggsn_vty_reference.xml diff --git a/Makefile.am b/Makefile.am index 1275358..dec4024 100644 --- a/Makefile.am +++ b/Makefile.am @@ -6,7 +6,6 @@ pkgconfig_DATA = osmo-gsm-manuals.pc BUILT_SOURCES = $(top_srcdir)/.version EXTRA_DIST = git-version-gen .version check-depends.sh $(share_files) SUBDIRS = tests \ - OsmoGGSN \ OsmoGSMTester \ OsmoHLR \ OsmoMGCP \ diff --git a/OsmoGGSN/Makefile.am b/OsmoGGSN/Makefile.am deleted file mode 100644 index 4cbff6d..0000000 --- a/OsmoGGSN/Makefile.am +++ /dev/null @@ -1,15 +0,0 @@ -OSMO_GSM_MANUALS_DIR = $(top_srcdir) -EXTRA_DIST = osmoggsn-usermanual.adoc \ - osmoggsn-usermanual-docinfo.xml \ - osmoggsn-vty-reference.xml \ - chapters \ - vty - -ASCIIDOC = osmoggsn-usermanual.adoc -ASCIIDOC_DEPS = $(srcdir)/chapters/*.adoc -include $(OSMO_GSM_MANUALS_DIR)/build/Makefile.asciidoc.inc - -VTY_REFERENCE = osmoggsn-vty-reference.xml -include $(OSMO_GSM_MANUALS_DIR)/build/Makefile.vty-reference.inc - -include $(OSMO_GSM_MANUALS_DIR)/build/Makefile.common.inc diff --git a/OsmoGGSN/chapters/configuration.adoc b/OsmoGGSN/chapters/configuration.adoc deleted file mode 100644 index 657a014..0000000 --- a/OsmoGGSN/chapters/configuration.adoc +++ /dev/null @@ -1,335 +0,0 @@ -== Configuring OsmoGGSN - -All configuration of OsmoGGSN is performed using the VTY. For more -general information on the VTY interface, see <>. - -=== Configuring a virtual GGSN instance - -OsmoGGSN can run multiple GGSN instances inside one program/process. -Each GGSN instance binds to its own transport-layer GTP IP address and -has its own set of APNs and associated IP address pools + tun/gtp -devices. - -In most usage cases, yo will only have a single GGSN instance inside -your configuration file, like in below example: - -.Example: Single GGSN configuration section ----- -ggsn ggsn0 - gtp state-dir /tmp - gtp bind-ip 127.0.0.6 - apn internet - gtpu-mode tun - tun-device tun4 - type-support v4 - ip prefix dynamic 176.16.222.0/24 - ip dns 0 192.168.100.1 - ip dns 1 8.8.8.8 - ip ifconfig 176.16.222.0/24 - no shutdown ----- - - -==== Creating/Editing a GGSN instance - -Creating/Editing a GGSN instance can be done by the following sequence -of VTY commands: - ----- -OsmoGGSN> enable <1> -OsmoGGSN# configure terminal <2> -OsmoGGSN(config)# ggsn ggsn0 <3> -OsmoGGSN(config-ggsn)# <4> ----- -<1> Change into privileged mode -<2> Enter the interactive configuration mode -<3> Create or edit the GGSN instance `ggsn0`. The name can be any ASCII - string, its significance is only to the local user. -<4> Your prompt is now in the `ggsn` config node, where you can - configure the properties of this GGSN instance. - -NOTE:: After creating a new GGSN instance, it is in `shutdown` mode. See -<> to take it out of shutdown, but make sure to configure it fully -before taking it out of shutdown. - -==== Configuring a GGSN instance - -The following two mandatory configuration statements have to be given -for every GGSN instance: - ----- -OsmoGGSN(config-ggsn)# gtp state-dir /var/lib/ggsn/ggsn0 <1> -OsmoGGSN(config-ggsn)# gtp bind-ip 127.0.0.6 <2> ----- -<1> Store the GSN restart state in the specified directory -<2> Bind the GGSN instance to the specified local IPv4 address - -There are some further configuration statements that can be used at the -GGSN node, some examples are given below. For a full list, see the -_OsmoGGSN VTY reference manual_ <>. - ----- -OsmoGGSN(config-ggsn)# default-apn foobar <1> ----- -<1> Configure a default APN to be used if the user-requested APN is not - found. The named APN must previously be configured - - -==== Deleting a GGSN instance - -A GGSN instance can be removed like this - -.Example: Deleting a GGSN instance ----- -OsmoGGSN> enable <1> -OsmoGGSN# configure terminal <2> -OsmoGGSN(config)# no ggsn ggsn0 <3> ----- -<1> Change into privileged mode -<2> Enter the interactive configuration mode -<3> Delete the GGSN instance - - -==== Taking a GGSN instance out of shutdown - -.Example: Taking a GGSN instance out of shutdown ----- -OsmoGGSN> enable <1> -OsmoGGSN# configure terminal <2> -OsmoGGSN(config)# ggsn ggsn0 <3> -OsmoGGSN(config-ggsn)# no shutdown ggsn <4> ----- -<1> Change into privileged mode -<2> Enter the interactive configuration mode -<3> Enter the config ndoe of the GGSN instance `ggsn0` -<4> Take the GGSN instance out of shutdown - - -==== Shutting a GGSN instance down - -If you would like to take a GGSN instance out of service, you can -put it into shutdown mode. This will make the entire GGSN unavailable -to user traffic and permit you to e.g. reconfigure it before taking it -out of shutdown again. - -.Example: Shutting down a GGSN instance ----- -OsmoGGSN> enable <1> -OsmoGGSN# configure terminal <2> -OsmoGGSN(config)# ggsn ggsn0 <3> -OsmoGGSN(config-ggsn)# shutdown ggsn <4> ----- -<1> Change into privileged mode -<2> Enter the interactive configuration mode -<3> Enter the config ndoe of the GGSN instance `ggsn0` -<4> Shut down the GGSN instance - - -=== Configuring an Access Point Name - -An Access Point Name (APN) represents a connection to an external packet -data network, such as the public Internet or private corporate networsk. - -APNs are selected by terminals (MS/UE) when establishing PDP contexts. - -Each OsmoGGSN GGSN instance can have any number of APNs configured. -Each APN is identified by a string name. - -==== Creating/Editing an APN - -.Example: Creating a new APN ----- -OsmoGGSN> enable <1> -OsmoGGSN# configure terminal <2> -OsmoGGSN(config)# ggsn ggsn0 <3> -OsmoGGSN(config-ggsn)# apn internet <4> -OsmoGGSN(config-ggsn-apn)# <5> ----- -<1> Change into privileged mode -<2> Enter the interactive configuration mode -<3> Enter the config node of the GGSN instance `ggsn0` -<4> Create or Edit an APN called `internet` -<5> Your prompt is now in the `ggsn` config node, where you can - configure the properties of this GGSN instance. - -NOTE:: The newly-create APN is created in `shutdown` mode. See <> to take it -out of shutdown. - - -==== Configuring an APN - -.Example: Configuring an APN ----- -OsmoGGSN(config-ggsn-apn)# gtpu-mode tun <1> -OsmoGGSN(config-ggsn-apn)# type-support v4 <2> -OsmoGGSN(config-ggsn-apn)# ip prefix dynamic 176.16.222.0/24 <3> -OsmoGGSN(config-ggsn-apn)# ip dns 0 192.168.100.1 <4> -OsmoGGSN(config-ggsn-apn)# ip dns 1 8.8.8.8 <5> -OsmoGGSN(config-ggsn-apn)# ip ifconfig 176.16.222.0/24 <6> ----- -<1> Use the userspace GTP-U handling using a TUN device -<2> Support (only) IPv4 Addresses -<3> Specify the pool of dynamic IPv4 addresses to be allocated to PDP - contexts -<4> Specify the primary DNS server to be provided using IPCP/PCO -<5> Specify the secondary DNS server to be provided using IPCP/PCO -<6> Request OsmoGGSN to configure the `tun4` device network/netmask - -NOTE:: If you use the optional `ip ifconfig` command to set the network -device address/mask, OsmoGGSN must run with root or `CAP_NET_ADMIN` -support. It might be better to configure related tun devices at system -startup and run OsmoGGSN as non-privileged user. See <> for more -details. - - -==== Deleting an APN - -An APN configuration can be removed like this - -.Example: Deleting an APN ----- -OsmoGGSN> enable <1> -OsmoGGSN# configure terminal <2> -OsmoGGSN(config)# ggsn ggsn0 <3> -OsmoGGSN(config-ggsn)# no apn internet <4> ----- -<1> Change into privileged mode -<2> Enter the interactive configuration mode -<3> Enter the config node of the GGSN instance `ggsn0` -<4> Delete the APN `internet` - -[[unshutdown_apn]] -==== Taking an APN out of shutdown - -In order to bring a deactived APN in `shutdown` state into active -operation, use the `no shutdown` command at the APN node as explained in -the following example: - -.Example: Taking an APN out of shutdown ----- -OsmoGGSN> enable <1> -OsmoGGSN# configure terminal <2> -OsmoGGSN(config)# ggsn ggsn0 <3> -OsmoGGSN(config-ggsn)# apn internet <4> -OsmoGGSN(config-ggsn-apn)# no shutdown <5> ----- -<1> Change into privileged mode -<2> Enter the interactive configuration mode -<3> Enter the config ndoe of the GGSN instance `ggsn0` -<4> Enter the config ndoe of the APN `internet` -<5> Take the APN out of shutdown - - -==== Shutting an APN down - -If you would like to take an APN instance out of service, you can -put it into shutdown mode. This will make the APN unavailable -to user traffic and permit you to e.g. reconfigure it before taking it -out of shutdown again. - -.Example: Shutting down an APN ----- -OsmoGGSN> enable <1> -OsmoGGSN# configure terminal <2> -OsmoGGSN(config)# ggsn ggsn0 <3> -OsmoGGSN(config-ggsn)# apn internet <4> -OsmoGGSN(config-ggsn-apn)# shutdown <5> ----- -<1> Change into privileged mode -<2> Enter the interactive configuration mode -<3> Enter the config ndoe of the GGSN instance `ggsn0` -<4> Enter the config ndoe of the APN `internet` -<5> Shut down the APN - -[[ggsn_no_root]] -=== Configuring for running without root privileges - -It's possible to run OsmoGGSN without root privileges if the tun devices are already configured. - -The interface creation + configuration must then happen before osmo-ggsn starting up. This can be -achieved by means such as - -* a custom shell script run as root before starting osmo-ggsn (e.g. as init script) -* systemd .netdev and .network files, if your system is using systemd-networkd (see `networkctl status`). - -==== Manual TUN device creation / configuration - -If you chose to go for custom shell/init scripts, you may use the `ip` program which is the standard -tool for network interface configuration on Linux, part of the `iproute2` package. In order to -create a tun device, you must call it like this: - -.Example: iproute2 command to create a tun device ----- -# ip tuntap add dev apn0 mode tun user username group groupname ----- - -Where _username_ and _groupname_ correspond to the User and Group that will have ownership over the -device, i.e. the privileges which you intend to run osmo-ggsn under, and _apn0_ will be the -name of the network device created. After creating the interface, you can configure its addresses -using standard means like `ip addr add` or your distribution-specific utilities/tools -to match the `ip prefix dynamic` config item, and activate the link, for example: - ----- -# ip addr add 192.168.7.0/24 dev apn0 -# ip link set apn0 up ----- - -==== systemd based TUN device creation+configuration - -If you want to have systemd take care of creating and configuring a tun device for you, -you can use the below example config files. - -.Example: device config via systemd-networkd using apn0.netdev ----- -[NetDev] -Name=apn0 <1> -Kind=tun - -[Tun] -User=username <2> -Group=username <3> ----- -<1> The network interface name of the newly-created device -<2> The username under which you will run OsmoGGSN -<3> The group name under which you will run OsmoGGSN - -.Example: network settings via systemd-networkd using ggsn.network ----- -[Match] -Name=apn0 <1> - -[Network] -Address=192.168.7.1 <2> -IPMasquerade=yes <3> ----- -<1> The netowrk device name, which must match the one in the apn0.netdev unit file above -<2> The local IP address configured on the device -<3> Requesting systemd to configure IP masquerading for this interface. Depending on your needs, - You may not want this if you have proper end-to-end routing set up, and want to have transparent - inbound IP access to your GPRS-attached devices. - -==== Config Changes - -With the tun device pre-configured in one of the ways outlined above, the main -changes in your osmo-ggsn.cfg file are: - -* remove `ip ifconfig` directive, -* make sure that `no shutdown` is present in the `apn` section as well as - `no shutdown ggsn` in the `ggsn` section. - -.Example: using externally configured tun device `apn0` as non-root ----- -ggsn ggsn0 - gtp state-dir /tmp - gtp bind-ip 127.0.0.6 - apn internet - gtpu-mode tun - tun-device apn0 - type-support v4 - ip prefix dynamic 192.168.7.0/24 - ip dns 0 192.168.100.1 - ip dns 1 8.8.8.8 - no shutdown - default-apn internet - no shutdown ggsn ----- diff --git a/OsmoGGSN/chapters/overview.adoc b/OsmoGGSN/chapters/overview.adoc deleted file mode 100644 index 632db5e..0000000 --- a/OsmoGGSN/chapters/overview.adoc +++ /dev/null @@ -1,145 +0,0 @@ -[[chapter_introduction]] -== Overview - -[[intro_overview]] -=== About OsmoGGSN - -OsmoGGSN is a Free / Open Source Software implementation of the GPRS -GGSN (Gateway GPRS support node) element in side the packet switched -core network of 2G and 3G cellular networks. - -The GGSN function is the tunnel endpoint on the core network side, -from where the external (IP) packet data network - -=== Software Components - -==== GTP Implementation (libgtp) - -The OsmoGGSN source code includes a shared library implementation of -the GTP protocol used on the GGSN-SGSN interface. This library -and associated header files are installed system-wide and are -available to other programs/applications. - -In fact, libgtp is what the OsmoSGSN also uses for its use of GTP. - -==== sgsnemu - -In order to test OsmoGGSN without running a SGSN and other elements -of a cellular network, there is a small command-line utility called -*sgsnemu* which is able to simulate the customary operations of a SGSN -towards the GGSN, such as a PDP Context Activation. - -*sgsnemu* can even be used for testing against other GGSNs, as the GTP -protocol is standardized across implementations. - -==== osmo-ggsn - -*osmo-ggsn* is the actual name of the OsmoGGSN executable program. It -implements the GGSN functionality. All parameters are set using the -configuration file, by default located in *./osmo-ggsn.cfg* - -==== systemd service file - -In *contrib/osmo-ggsn.service* you can find a sample service file for -OsmoGGSN which can be used with systemd. - -==== init script - -In *contrib/osmo-ggsn.init* you can find a sample init script to be used -on systems with classic init process. - -=== Limitations - -OsmoGGSN supports both GTP0 (GSM 09.60) and GTP1 (3GPP 29.060). In the -following tables the support of each individual message type is -detailed. The numbers before each feature indicates the relevant -section in the standard. - -==== GSM 09.60 (GTPv0) - -[options="header",cols="50%,15%,15%,15%,5%"] -|=== -| Feature | gtplib | osmo-ggsn | sgsnemu | notes -5+<|*7.4 Path Management Messages* -|7.4.1 Echo Request |Supported |Supported |Supported | -|7.4.2 Echo Response |Supported |Supported |Supported | -|7.4.3 Version Not Supported |Supported |Supported |Supported | -5+<| *7.5 Tunnel Management Messages* -|7.5.1 Create PDP Context Request|Supported |Supported |Supported | -|7.5.2 Create PDP Context Response|Supported |Supported |Supported | -|7.5.3 Update PDP Context Request|Supported |Supported |Not | -|7.5.4 Update PDP Context Response|Supported |Supported |Not | -|7.5.5 Delete PDP Context Request|Supported |Supported |Supported | -|7.5.6 Delete PDP Context Response|Supported |Supported |Supported | -|7.5.7 Create AA PDP Context Request|Unsupported |Unsupported |Unsupported | -|7.5.8 Create AA PDP Response|Unsupported |Unsupported |Unsupported | -|7.5.9 Delete AA PDP Context Request|Unsupported |Unsupported |Unsupported | -|7.5.10 Delete AA PDP Context Response|Unsupported |Unsupported |Unsupported | -|7.5.11 Error Indication |Supported |Supported |Supported | -|7.5.12 PDU Notification Request|Unsupported |Unsupported |Unsupported | -|7.5.13 PDU Notification Response|Unsupported |Unsupported |Unsupported | -|7.5.14 PDU Notification Reject Request|Unsupported |Unsupported |Unsupported | -|7.5.15 PDU Notification Reject Response|Unsupported |Unsupported |Unsupported | -5+<| *7.6 Location Management Messages* -|7.6.1 Send Routeing Information for GPRS Request|Unsupported |Unsupported |Not applicable | -|7.6.2 Send Routeing Information for GPRS Response|Unsupported |Unsupported |Not applicable | -|7.6.3 Failure Report Request|Unsupported |Unsupported |Not applicable | -|7.6.3 Failure Report Response|Unsupported |Unsupported |Not applicable | -|7.6.5 Note MS GPRS Present Request|Unsupported |Unsupported |Not applicable| -|7.6.6 Note MS GPRS Present Response|Unsupported |Unsupported |Not applicable| -5+<| *7.5 Mobility Management Messages* -|7.5.1 Identification Request|Unsupported |Not applicable|Not applicable| -|7.5.2 Identification Response|Unsupported |Not applicable|Not applicable | -|7.5.3 SGSN Context Request|Unsupported |Not applicable|Not applicable| -|7.5.4 SGSN Context Response|Unsupported |Not applicable|Not applicable| -|7.5.5 SGSN Context Acknowledge|Unsupported |Not applicable|Not applicable| -|=== - -==== 3GPP 29.060 (GTPv1) - -[options="header",cols="50%,15%,15%,15%,5%"] -|=== -|Feature |gtplib |osmo-ggsn |sgsnemu |notes -5+<|*7.2 Path Management Messages* -|7.2.1 Echo Request |Supported |Supported |Supported | -|7.2.2 Echo Response |Supported |Supported |Supported | -|7.2.3 Version Not Supported|Supported |Supported |Supported | -|7.2.4 Extension Headers Notification|Supported |Supported |Supported | -5+<|*7.3 Tunnel Management Messages* -|7.3.1 Create PDP Context Request|Supported |Supported |Supported |1 -|7.3.2 Create PDP Context Response|Supported |Supported |Supported | -|7.3.3 Update PDP Context Request|Supported |Supported |Not applicable|1 -|7.3.4 Update PDP Context Response|Supported |Supported |Not applicable| -|7.3.5 Delete PDP Context Request|Supported |Supported |Supported | -|7.3.6 Delete PDP Context Response|Supported |Supported |Supported | -|7.3.7 Error Indication |Supported |Supported |Supported | -|7.3.8 PDU Notification Request|Unsupported |Unsupported |Unsupported | -|7.3.9 PDU Notification Response|Unsupported |Unsupported |Unsupported | -|7.3.10 PDU Notification Reject Request|Unsupported |Unsupported |Unsupported | -|7.3.10 PDU Notification Reject Response|Unsupported |Unsupported |Unsupported | -5+<|*7.4 Location Management Messages* -|7.4.1 Send Routeing Information for GPRS Request|Unsupported |Unsupported |Not applicable | -|7.4.2 Send Routeing Information for GPRS Response|Unsupported |Unsupported |Not applicable | -|7.4.3 Failure Report Request|Unsupported |Unsupported |Not applicable| -|7.4.3 Failure Report Response|Unsupported |Unsupported |Not applicable| -|7.4.5 Note MS GPRS Present Request|Unsupported |Unsupported |Not applicable| -|7.4.6 Note MS GPRS Present Response|Unsupported |Unsupported |Not applicable| -5+<|*7.5 Mobility Management Messages* -|7.5.1 Identification Request|Unsupported |Not applicable|Not applicable| -|7.5.2 Identification Response|Unsupported |Not applicable |Not applicable| -|7.5.3 SGSN Context Request|Unsupported |Not applicable|Not applicable| -|7.5.4 SGSN Context Response|Unsupported |Not applicable |Not applicable| -|7.5.5 SGSN Context Acknowledge|Unsupported |Not applicable|Not applicable| -|7.5.6 Forward Relocation Request|Unsupported |Not applicable|Not applicable| -|7.5.7 Forward Relocation Response|Unsupported |Not applicable|Not applicable| -|7.5.8 Forward Relocation Complete|Unsupported |Not applicable|Not applicable| -|7.5.9 Relocation Cancel Request|Unsupported |Not applicable|Not applicable| -|7.5.10 Relocation Cancel Response|Unsupported |Not applicable|Not applicable| -|7.5.11 Forward Relocation Complete |Unsupported |Not applicable |Not applicable | -|7.5.12 Forward SRNS Context Acknowledge|Unsupported |Not applicable|Not applicable| -|7.5.13 Forward SRNS Context|Unsupported |Not applicable|Not applicable| -|=== - -Notes - -1) The "Secondary PDP Context Activation Procedure" is not supported. diff --git a/OsmoGGSN/chapters/running.adoc b/OsmoGGSN/chapters/running.adoc deleted file mode 100644 index 83470e8..0000000 --- a/OsmoGGSN/chapters/running.adoc +++ /dev/null @@ -1,82 +0,0 @@ -== Running OsmoGGSN - -The OsmoGGSN executable (`osmo-ggsn`) offers the following command-line -arguments: - -=== SYNOPSIS - -*osmo-ggsn* [-h|-V] [-D] [-c 'CONFIGFILE'] - -=== OPTIONS - -*-h, --help*:: - Print a short help message about the supported options -*-V, --version*:: - Print the compile-time version number of the OsmoBTS program -*-D, --daemonize*:: - Fork the process as a daemon into background. -*-c, --config-file 'CONFIGFILE'*:: - Specify the file and path name of the configuration file to be - used. If none is specified, use `osmo-ggsn.cfg` in the current - working directory. - -=== Routing - -Operating the OpenGGSN tun device naturally creates a network setup with -multiple interfaces. Consider: - -* Typical Linux setups prevent forwarding of packets between separate - interfaces by default. To let subscribers reach the internet uplink from the - tun device, it may be required to enable IP forwarding. - -* Having a locally defined address range assigned to the tun device requires - either sensible routing for this address range, or that masquerading is - enabled to allow your single uplink IP address to "proxy" for the tun. - -These are decisions to be made on a network administration level. - -In a trivial case where you have a single box serving GPRS to few subscribers -on an arbitrary IP address range not known in the larger network, the easiest -way to enable GPRS uplink would be to enable IP forwarding and masquerading. - -To manually enable IPv4 forwarding and masquerading ad-hoc, you can do: - ----- -sh -c "echo 1 > /proc/sys/net/ipv4/ip_forward" -iptables -t nat -A POSTROUTING -o '*' -j MASQUERADE ----- - -(You may want to replace `*` with the network device name, like `-o eth0`) - -There are various ways to enable these settings persistently, please refer to -your distribution's documentation -- e.g. look for @net.ipv4.ip_forward=1@ in -@/etc/sysctl.d/@, and https://wiki.debian.org/iptables for masquerading. - -=== Multiple instances - -Running multiple instances of `osmo-ggsn` is possible if all GGSN instances -are binding to different local IP addresse and all other interfaces (VTY, -OML) are separated using the appropriate configuration options. The IP based -interfaces are binding to local host by default. In order to separate the -processes, the user has to bind those services to specific but different -IP addresses. - -The VTY and the control interface can be bound to IP addresses from the loopback -address range. - -.Example: Binding VTY and control interface to a specific ip-address ----- -line vty - bind 127.0.0.2 -ctrl - bind 127.0.0.2 ----- - -Also make sure to place each instance's GTP bind on a separate IP address (GTP -uses a port number that is fixed in the GTP specifications, so it will not be -possible to pick differing ports on the same IP address), like: - ----- -ggsn ggsn0 - gtp bind-ip 127.0.0.2 ----- diff --git a/OsmoGGSN/osmoggsn-usermanual-docinfo.xml b/OsmoGGSN/osmoggsn-usermanual-docinfo.xml deleted file mode 100644 index c93d5e1..0000000 --- a/OsmoGGSN/osmoggsn-usermanual-docinfo.xml +++ /dev/null @@ -1,46 +0,0 @@ - - - 1 - August 2017 - HW - - Initial version. - - - - - - - Harald - Welte - hwelte@sysmocom.de - HW - - sysmocom - sysmocom - s.f.m.c. GmbH - Managing Director - - - - - - 2013-2017 - sysmocom - s.f.m.c. GmbH - - - - - Permission is granted to copy, distribute and/or modify this - document under the terms of the GNU Free Documentation License, - Version 1.3 or any later version published by the Free Software - Foundation; with no Invariant Sections, no Front-Cover Texts, - and no Back-Cover Texts. A copy of the license is included in - the section entitled "GNU Free Documentation License". - - - The Asciidoc source code of this manual can be found at - - http://git.osmocom.org/osmo-gsm-manuals/ - - - diff --git a/OsmoGGSN/osmoggsn-usermanual.adoc b/OsmoGGSN/osmoggsn-usermanual.adoc deleted file mode 100644 index 9bc3885..0000000 --- a/OsmoGGSN/osmoggsn-usermanual.adoc +++ /dev/null @@ -1,29 +0,0 @@ -OsmoGGSN User Manual -==================== -Harald Welte - - -include::./common/chapters/preface.adoc[] - -include::{srcdir}/chapters/overview.adoc[] - -include::{srcdir}/chapters/running.adoc[] - -//include::{srcdir}/chapters/control.adoc[] - -include::./common/chapters/vty.adoc[] - -include::./common/chapters/logging.adoc[] - - -include::{srcdir}/chapters/configuration.adoc[] - -include::./common/chapters/control_if.adoc[] - -include::./common/chapters/port_numbers.adoc[] - -include::./common/chapters/bibliography.adoc[] - -include::./common/chapters/glossary.adoc[] - -include::./common/chapters/gfdl.adoc[] diff --git a/OsmoGGSN/osmoggsn-vty-reference.xml b/OsmoGGSN/osmoggsn-vty-reference.xml deleted file mode 100644 index 3ad7e83..0000000 --- a/OsmoGGSN/osmoggsn-vty-reference.xml +++ /dev/null @@ -1,38 +0,0 @@ - - - - -]> - - - - - - v1 - 06th September 2017 - hw - Initial version as of OsmoGGSN v1.0.0 - - - - OsmoGGSN VTY Reference - - - 2017 - - - - This work is copyright by sysmocom - s.f.m.c. GmbH. All rights reserved. - - - - - - &chapter-vty; - - diff --git a/OsmoGGSN/vty/ggsn_vty_additions.xml b/OsmoGGSN/vty/ggsn_vty_additions.xml deleted file mode 100644 index b0e8a39..0000000 --- a/OsmoGGSN/vty/ggsn_vty_additions.xml +++ /dev/null @@ -1,30 +0,0 @@ - - - - Telnet/VTY Configuration Node - - Configure parameters of the Telnet/VTY Interface, such as to which IP address it should bind/listen to. - - - - - CTRL Configuration Node - - Configure parameters of the CTRL Interface, such as to which IP address it should bind/listen to. - - - - - GGSN Instance Configuration Node - - Configure an Instance of a (virtual) GGSN - - - - - APN Configuration Node - - Configure an Access Point Name (APN) inside a GGSN Instance - - - diff --git a/OsmoGGSN/vty/ggsn_vty_reference.xml b/OsmoGGSN/vty/ggsn_vty_reference.xml deleted file mode 100644 index 7460026..0000000 --- a/OsmoGGSN/vty/ggsn_vty_reference.xml +++ /dev/null @@ -1,1447 +0,0 @@ - - - Common Commands - These commands are available on all VTY nodes. They are listed here only once, to unclutter the VTY reference. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - view - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - enable - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - config - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - config-log - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - config-stats - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - config-line - - - - - - - - - - - - - - - - - - - - config-ctrl - - - - - - - - - config-ggsn - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - config-ggsn-apn - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/configure.ac b/configure.ac index 770df9e..cef7115 100644 --- a/configure.ac +++ b/configure.ac @@ -28,7 +28,6 @@ AC_OUTPUT( osmo-gsm-manuals.pc Makefile tests/Makefile - OsmoGGSN/Makefile OsmoGSMTester/Makefile OsmoHLR/Makefile OsmoMGCP/Makefile -- cgit v1.2.3