Skip to content

GitLab

openairinterface5G
openairinterface5G
Commit 007544e1 authored by gauthier's avatar gauthier
Browse files
Options

moved PMIPv6 from trunk/openair3 to extras/openair3/PMIPv6 


git-svn-id: http://svn.eurecom.fr/openair4G/trunk@7751 818b1a75-f10b-46b9-bf7c-635c3b92a50f
parent 905aee70
Expand all Hide whitespace changes
Inline Side-by-side
Showing with 0 additions and 159501 deletions
openair3/PMIPv6/AUTHORS deleted 100644 → 0
View file @ 905aee70
OpenAir3 - Mobile Communication Department - EURECOM (Sophia-Antipolis, FRANCE)
openair3/PMIPv6/BUGS deleted 100644 → 0
View file @ 905aee70
/*******************************************************************************
OpenAirInterface
Copyright(c) 1999 - 2014 Eurecom
OpenAirInterface is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
OpenAirInterface is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with OpenAirInterface.The full GNU General Public License is
included in this distribution in the file called "COPYING". If not,
see <http://www.gnu.org/licenses/>.
Contact Information
OpenAirInterface Admin: openair_admin@eurecom.fr
OpenAirInterface Tech : openair_tech@eurecom.fr
OpenAirInterface Dev : openair4g-devel@eurecom.fr
Address : Eurecom, Campus SophiaTech, 450 Route des Chappes, CS 50193 - 06410 Biot Sophia Antipolis cedex, FRANCE
*******************************************************************************/
/*________________________OPENAIR/OPENAIR3/________________________
File : INSTALL.kernel
Authors : OpenAir3
Company : EURECOM
Emails : openair3@eurecom.fr
________________________________________________________________*/
-------------------------
BUGS
-------------------------
PROBLEM : "config.h file not found"
SOLUTION : A simple symbolic link is enough to avoid this error. Open a terminal and type :
$ ln -s /usr/src/linux-source-XX.XX.XX/include/linux/autoconf.h /usr/src/linux-sources-XX.XX.XX/include/linux/config.h
PROBLEM : "Error while loading shared libraries : libfreeradius-client.so.2 cannot open shared object file : no such file or directory"
SOLUTION : Open a terminal and type :
$ export LD_LIBRARY_PATH=/usr/local/lin:$LD_LIBRARY_PATH
To avoid this problem to occur once again, we add the previsou line to the Bashrc file. Open a terminal and type:
$ echo "export LD_LIBRARY_PATH=/usr/local/lin:$LD_LIBRARY_PATH" >> ~/.bashrc
\ No newline at end of file
openair3/PMIPv6/CHANGELOG deleted 100644 → 0
View file @ 905aee70
==================================================================
Proxy Mobile IPv6 - Changelog
==================================================================
Changes in 0.4.2 (9 Nov 2012)
*Corrected bugs in virtual terminal, enabled at configuration with --enable-vt
*Check of P flag in PBU.
*Radius now not mandatory, enabled at configuration with --with-pmip-use-radius
*Only one type of script per MAG, LMA (before we had a script for MAG1, another one for MAG2, etc)
*LMA host type is fusionned with HA host type
*Rename executable from pmip6d to mip6d in order to ease integration of our PMIP stack with the umip project
*Check that RS or message alerting for an incoming MN comes from the ingress interface
*Added timer handler for tunnel.
*Tunnels now can be static or dynamic
*The alternative of using radius is to create a mapping file (hw address <-> IPv6 W prefix):/etc/pmip/mac-mapping.auth
*We can put comments in /etc/pmip/mac-mapping.auth file
*Now 2 MNs attached to the same MAG can communicate between them.
*Added detection of router sollicitation messages from mobiles (over ethernet and other LTE technologies)
Changes in 0.4.1 (13 Dec 2011):
*Added Handoff Indicator Option (RFC5213), Access Technology Type Option(RFC5213),
Mobile Node Identifier Option (RFC 4283) for RFC 5213 PBU/PBA messages.
*Correction of P and A flag in PBU message (bad endianess issue).
*Correction and use of automatic padding for options alignment.
*Removed command line options for PMIP protocol, let only UMIP options, because
the number of configuration parameters is rather high, so it is preferable to
use the configuration files.
*Updated man pages for pmip6d and pmip6d.conf.
*removed HomeNetworkPrefix and OurAddress entries in LMA and MAG configuration files.
Changes in 0.4 (21 Nov 2011):
*Now the configuration is inside only one configuration file, for each entity.
A python script automaticaly parse the configuration file and take the appropriate
decision for configuring the testbed, there should be no need for modifying this script.
*Removed hardcoded syslog parse string, now they are located in the configuration files.
*Now PBU lifetime is smaller (40 seconds instead of 1000 seconds), now the restart
of this timer works.
*Now timestamp option is OK in PBU/PBA, but we will improve the processing in next release (windowing).
*Now sequence numbering of PBU/PBA messages is checked.
*Added miscellaneous parameters in configuration files, some will be processed in future
release (RFC5213EnableMAGLocalRouting), RFC5213TimestampBasedApproachInUse should be always
set to enabled, RFC5213MobileNodeGeneratedTimestampInUse should be always set to disabled.
*Added traces in case of critical section problems.
*Added correct type values (RFC 5213) for PBU/PBA message options.
*Corrected bug of BCE update in LMA: the tunnel was always deleted.
*Corrected bugs in handlers.
*Renamed eth_address2hw_address, hw_address2eth_address to EUI64_to_EUI48, EUI48_to_EUI64
*Reinforced the test procedure for checking the presence of a mobile on a MAG.
*Warning, there are some known memory leaks, they will be fixed in next release.
Changes in 0.3 (10 Juin 2011):
*
Changes in 0.2 (17 May 2011):
* Update of README.first, INSTALL, INSTALL.kernel files for the UBUNTU 10.04 LTS version
* Add of the "Simple_experimentation" directory which contains the drawing and the shell script files to achieve a 1 LMA + 2 MAGs testbed.
* Update of the /etc/match content file format
Changes in 0.1 (23 Oct 2010):
* First release
openair3/PMIPv6/COPYING deleted 100644 → 0
View file @ 905aee70
This diff is collapsed.
openair3/PMIPv6/INSTALL deleted 100644 → 0
View file @ 905aee70
/*******************************************************************************
OPENAIRINTERFACE 0/1/2/3
Copyright(c) 1999 - 2010 EURECOM
This program is free software; you can redistribute it and/or modify it
under the terms and conditions of the GNU General Public License,
version 2, as published by the Free Software Foundation.
This program is distributed in the hope it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
more details.
You should have received a copy of the GNU General Public License along with
this program; if not, write to the Free Software Foundation, Inc.,
51 Franklin St - Fifth Floor, Boston, MA 02110-1301 USA.
The full GNU General Public License is included in this distribution in
the file called "COPYING".
Contact Information:
Openair Admin <openair_admin@eurecom.fr>
Mailing List <openair_tech@eurecom.fr>
Forums http://forums.eurecom.fr/openairinterface
Eurecom, 2229, route des cretes, 06560 Valbonne Sophia Antipolis, France
*******************************************************************************/
/*________________________OPENAIR/OPENAIR3/________________________
File : INSTALL
Authors : OpenAir3
Company : EURECOM
Emails : openair3@eurecom.fr
________________________________________________________________*/
-------------------------
Table of contents
-------------------------
The content of this readme is the following:
0) System requirements
1) Installation of SYSLOGs Servers on MAGs (it has to be done only on MAG machines)
2) EURECOM FreeRadius Installation
2.1) FreeRadius client installation (concern only MAG machines)
2.2) FreeRadius Server installation (concern only LMA machines)
3) PMIP6D Compilation
4) Change MAC addresses on other MAGs
-----------------------------------------
0) System Requirements
-----------------------------------------
We validated that PMIP6D runs under UBUNTU 10.04 x86 LTS version. For this reason, we highly recommend you to use this UBUNTU version.
However, we don't exclude that it might also work with other linux systems.
-------------------------------------------------------------------------------
1) Installation of SYSLOGs Servers on MAGs (It does not have to be done on LMA)
-------------------------------------------------------------------------------
1.1) Each MAG machine has to run a SYSLOG Server on it.
So on each machine that you use as MAG, you have to install a SYSLOG server :
Installation of the SOCKLOG and SYSKLOGD packages :
$ apt-get install socklog sysklogd
Edit and change the Syslog server configuration :
$ gedit /etc/syslog.conf
-> In this file, look for the line containing local7.info and change it to have this -> "local7.info /var/log/pmip_syslog.log"
-> In case the line wouldn't exist, go at the bottom of the text file and add this line "local7.info /var/log/pmip_syslog.log"
$ touch /var/log/pmip_syslog.log
-> The file has to exist before to be used
$ gedit /etc/default/syslogd
-> You should have the option "-r" enabled for the SYSLOG Daemon. So be sure you have -> SYSLOGD="-r"
$ /etc/init.d/sysklogd restart
-> We restart the syslog daemon to take into account the modifications we just did
1.2) Each Access Point should have their SYSLOG client enabled and configured.
So on each Access Point you have to do what follows :
For example on a CISCO SERIES 1100 ACCESS POINT web interface, you should go to EVENT LOG, then to CONFIGURATION and then add the MAG IP Address on which the syslog server is running.
Access Point Web Interface (10.0.0.1) --> EVENT LOG --> CONF --> Put SYSLOG SERVER's IP ADDRESS
----------------------------------------------------------------------
2) EURECOM FreeRadius Installation
----------------------------------------------------------------------
Since the FreeRADIUS Client v1.1.6 from freeradius.org is limited to IPv4 protocol, we modified it in order to use only IPv6.
The Freeradius clients has to installed on all LMA and MAG.
FYI, "THEGOODPATH" indicates the path where you downloaded PMIPv6_v0.4.1. We suggest you to copy everything in "/usr/local/src".
Each line starting by a "$" are commands to be executed in a shell.
2.1) FreeRadius client installation (It has to be installed on all MAGs and LMAs)
$ cd THEGOODPATH/freeradiusclient-1.1.6/
$ autoreconf -i
$ ./configure
$ make
$ make install
On all the MAGs, do as follows :
In the "/etc/hosts" file, you have to tell the ipv6 address of the FreeRadius Server
$ gedit /etc/hosts
At the bottom of the file, type for example : "2001:100::1 radius6server"
To let PMIP6D find Freeradius libraries, execute what follows :
$ gedit /etc/ld.so.conf
Add at the bottom of the file this line -> "include /usr/local/lib/". Save and exit.
$ ldconfig
2.2) FreeRadius Server installation (Has to be done only on LMAs)
Now we proceed to the FreeRadius Server 2.1.12 installation :
We will get the code from http://freeradius.org/ website, and download the 2.1.12 FreeRADIUS server source code (2.5 MB)
$ wget ftp://ftp.freeradius.org/pub/freeradius/freeradius-server-2.1.12.tar.bz2
$ tar xjf freeradius-server-2.1.12.tar.bz2
$ cd freeradius-server-2.1.12
$ ./configure
$ make
$ make install
You need now to copy three configuration files to the FreeRADIUS server in order to correctly connect the clients.
$ cd THEGOODPATH/freeradiusclient-1.1.6/examples/
$ cp users /usr/local/etc/raddb/
$ gedit /usr/local/etc/raddb/users
N.B: This file contains all the Mobile Node MAC addresses authorised in the PMIP6D domain. Please update it with your data.
$ cp radiusd.conf /usr/local/etc/raddb/
N.B: This file contains all the information required for the connection, authentication between the Server and clients (MAGs).
$ cp clients.conf /usr/local/etc/raddb/
N.B: This file contains the list of authorised clients (MAGs). Please update this file with all your MAGs information.
-----------------------------------------------------
3) PMIP6D Compilation (To be done on LMAs and MAGs)
-----------------------------------------------------
Execute the following commands :
$ cd THEGOODPATH/pmipv6-daemon-umip-0.4/
$ autoreconf -i
$ ./configure
$ make
$ make install
WARNING : If you have some issues during the PMIP6D compilation, please look into the BUGS file.
If you are still facing any issue, please report it to us using the following email "openair3@eurecom.fr"
-----------------------------------------
4) Change MAC addresses on other MAGs
-----------------------------------------
4.1) One of the specificity of a PMIP Domain is that the Mobile Node should not be aware of its mobility inside the PMIP Domain.
One of the way to achieve this is to copy the MAC Address of one of the MAG and duplicate it for all other MAGs.
So in the configuration scripts we force the ingress MAG address to a predefined MAC address: 00:11:22:33:44:55 with the help of the macchanger executable.
If you have a look to "THEGOODPATH/pmipv6-daemon-umip-0.4/extras/UMIP0.4_MAG2_UBUNTU.10.04.py" file, you will notice that we achieve this automatically via the configuration script.
Moreover, your Access Points should not add their MAC Address to the IP Packets that they forward. To do this, you should put your Access Points in a MASQUERADING mode.
openair3/PMIPv6/INSTALL.kernel deleted 100644 → 0
View file @ 905aee70
/*******************************************************************************
OpenAirInterface
Copyright(c) 1999 - 2014 Eurecom
OpenAirInterface is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
OpenAirInterface is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with OpenAirInterface.The full GNU General Public License is
included in this distribution in the file called "COPYING". If not,
see <http://www.gnu.org/licenses/>.
Contact Information
OpenAirInterface Admin: openair_admin@eurecom.fr
OpenAirInterface Tech : openair_tech@eurecom.fr
OpenAirInterface Dev : openair4g-devel@eurecom.fr
Address : Eurecom, Campus SophiaTech, 450 Route des Chappes, CS 50193 - 06410 Biot Sophia Antipolis cedex, FRANCE
*******************************************************************************/
/*________________________OPENAIR/OPENAIR3/________________________
File : INSTALL.kernel
Authors : OpenAir3
Company : EURECOM
Emails : openair3@eurecom.fr
________________________________________________________________*/
-------------------------
Table of contents
-------------------------
The content of this file is the following:
0) PMIP6D
1) HOW TO BUILD THE PROPER KERNEL
1.1) Enable the required features in the kernel
1.2) Kernel recompilation
0) PMIP6D
================================
Proxy Mobile IPv6 (PMIPv6) is a network-based mobility management protocol for localized domains, which has been actively standardized by the IETF NETLMM Working Group. PMIPv6 is starting to attract much attention among telecommunication and internet communities due to its salient features and it is expected to expedite the real deployment of IP-based mobility management.
Notice also that this release is for use with:
- i386,
WARNING: The PMIP6D has been developped and validated under Linux UBUNTU 10.04 LTS distribution.
We can not confirm it will work with other systems however it might work with other UBUNTU systems.
1) HOW TO BUILD THE PROPER KERNEL
=================================
1.1) Enable the required features in the kernel
-----------------------------------------------
Your current kernel DOES NOT require any patches in order to run PMIP6D, however you need to enable some already existing features in your kernel and recompile it.
If you don't already have your kernel source installed on your machine, follow what is next.
Be sure to be connected to Internet, open a new shell and type :
$ apt-get update
$ apt-get install linux-source
$ cd /usr/src/
$ tar xjf linux-source-XX.XX.XX (with XX.XX.XX depends on your system version)
$ ln -s /usr/src/linux-source-XX.XX.XX /usr/src/linux
Now that you have your kernel source, we will configure them.
In your shell, execute :
$ apt-get install qt3-apps-dev g++
$ cd /usr/src/linux-source-XX.XX.XX
Run either :
$ make xconfig # (Qt-based) (recommended)
$ make gconfig # (GTK-based)
$ make menuconfig # (You need to install libncurses4-dev first)
And set the features this way :
N.B: When you execute "make xconfig" all the features are set in a tree. For some features, you'll find in brackets the path in the kernel tree to reach the feature you want to enable.
Required for every nodes :
CONFIG_EXPERIMENTAL=y (GENERAL SETUP -> PROMPT FOR DEV AND OR INCOMPLETE DRIVERS)
CONFIG_SYSVIPC=y (GENERAL SETUP -> SYSTEM V IPC)
CONFIG_PROC_FS=y
CONFIG_NET=y (NETWORKING SUPPORT -> NETWORKING OPTIONS -> TCP/IP NETWORKING)
CONFIG_INET=y (NETWORKING SUPPORT -> NETWORKING OPTIONS -> TCP/IP NETWORKING)
CONFIG_IPV6=y (NETWORKING SUPPORT -> NETWORKING OPTIONS -> TCP/IP NETWORKING)
CONFIG_IPV6_MIP6=y (NETWORKING SUPPORT -> NETWORKING OPTIONS -> IPV6 PROTOCOL)
CONFIG_XFRM=y
CONFIG_XFRM_USER=y (NETWORKING SUPPORT -> NETWORKING OPTIONS -> TRANSFORMATION USER CONFIGURATION INTERFACE)
CONFIG_XFRM_SUB_POLICY=y (NETWORKING SUPPORT -> NETWORKING OPTIONS -> TRANSFORMATION SUB POLICY SUPPORT)
CONFIG_INET6_XFRM_MODE_ROUTEOPTIMIZATION=y (NETWORKING SUPPORT -> NETWORKING OPTIONS -> IPV6 PROTOCOL -> IPV6: MIPV6 ROUTE OPTIMISATION MODE)
The Home Agent and Mobile Node also need:
CONFIG_IPV6_TUNNEL=y (NETWORKING SUPPORT -> NETWORKING OPTIONS -> IPV6 PROTOCOL -> IPV6: IPV6 IN IPV6 TUNNEL)
CONFIG_IP_ADVANCED_ROUTER=y (NETWORKING SUPPORT -> NETWORKING OPTIONS -> IP: ADVANCED ROUTER)
CONFIG_IPV6_MULTIPLE_TABLES=y
The Mobile Node also needs:
CONFIG_IPV6_SUBTREES=y
For some additional movement indicators on the Mobile Node you may set:
CONFIG_ARPD=y (NETWORKING SUPPORT -> NETWORKING OPTIONS -> IP: ARP DAEMON SUPPORT)
For IPsec support you need at least:
CONFIG_INET6_ESP=y (NETWORKING SUPPORT -> NETWORKING OPTIONS -> IPV6 PROTOCOL -> IPV6 ESP TRANSFORMATION)
If you plan to use IPsec tunnel mode you need:
CONFIG_NET_KEY=y (NETWORKING SUPPORT -> NETWORKING OPTIONS -> PF_KEY SOCKETS)
CONFIG_NET_KEY_MIGRATE=y (NETWORKING SUPPORT -> NETWORKING OPTIONS -> PF_KEY SOCKETS -> PF_KEY MIGRATE)
Do not turn CONFIG_IPV6_MIP6_DEBUG on
In order to be sure, you did it in a proper way, there is a script in the PMIP6D directory which is capable of checking if the kernel settings are set correctly.
To check your kernel, open a new shell, go to your PMIP6D directory and type :
$ ./chkconf_kernel.sh /usr/src/linux-source-XX.XX.XX
1.2) Kernel recompilation
-----------------------------------------------
Now that you gave the good options to your kernel, we need to recompile it.
$ cd /usr/src/linux-source-XX.XX.XX
$ make && make modules_install && make install
N.B: If you have many cores in your CPU and wand to use all of them in order to make the compilation faster, you might add "-jX" option to your "make" command with X=nb of core. For example for a dual-core CPU, type "make -j2". For a quad-core CPU, type "make -j4"
$ mkinitramfs -o /boot/initrd.img-XX.XX.XX XX.XX.XX
$ update-grub
N.B: If your computer does not reboot on the good kernel, edit and update the "default" line inside the following file -> /boot/grub/grub.cfg
You should now reboot your system in order to take into account modifications you made on your kernel
$ reboot
openair3/PMIPv6/README.first deleted 100644 → 0
View file @ 905aee70
/*******************************************************************************
OPENAIRINTERFACE 0/1/2/3
Copyright(c) 1999 - 2010 EURECOM
This program is free software; you can redistribute it and/or modify it
under the terms and conditions of the GNU General Public License,
version 2, as published by the Free Software Foundation.
This program is distributed in the hope it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
more details.
You should have received a copy of the GNU General Public License along with
this program; if not, write to the Free Software Foundation, Inc.,
51 Franklin St - Fifth Floor, Boston, MA 02110-1301 USA.
The full GNU General Public License is included in this distribution in
the file called "COPYING".
Contact Information:
Openair Admin <openair_admin@eurecom.fr>
Mailing List <openair_tech@eurecom.fr>
Forums http://forums.eurecom.fr/openairinterface
Eurecom, 2229, route des cretes, 06560 Valbonne Sophia Antipolis, France
*******************************************************************************/
/*________________________OPENAIR/OPENAIR3/________________________
File : README
Authors : OpenAir3
Company : EURECOM
Emails : openair3@eurecom.fr
________________________________________________________________*/
-------------------------
Table of contents
-------------------------
The content of this README is the following:
1) What is this block about in OpenAirInterface
2) Folders and files description
3) Organization of the folders and their dependencies
4) Hardware requirement and How to build PMIP6D
5) How to run a simple experimentation
------------------------------------------------
1) What is this block about in OpenAirInterface ?
-----------------------------------------------
Proxy Mobile IPv6 (or PMIPv6, or PMIP) is a network-based mobility management protocol standardized by IETF. It is a protocol for building a common and access technology independent of mobile core networks, accommodating various access technologies such as WiMAX, 3GPP, 3GPP2 and WLAN based access architectures. Proxy Mobile IPv6 is the only network-based mobility management protocol standardized by IETF.
-----------------------------------------
2) Folders and files description
-----------------------------------------
File/Folder Description
----------- -----------
- freeradius-client-1.1.6/ contains files for the Radius client
- examples contains FreeRADIUS server configuration file examples
- mipv6-daemon-umip-0.4/ contains files distributed with MIPL linux package
- extras/ contains example configuration files and scripts for lauching executables
- include/ contains files distributed with MIPL linux package
- libmissing/ contains files distributed with MIPL linux package
- libnetlink/ contains files distributed with MIPL linux package
- man/ contains manual files of MIPL and PMIP
- src/ contains files distributed with MIPL linux package
- src/pmip/ contains PMIP files
----------------------------------------------------
3) Organization of the folders and their dependencies
----------------------------------------------------
The 2 folders have the following structures :
- freeradius-client-1.1.6/ is the FreeRADIUS client v1.1.6 source code that we modified.
- pmipv6-daemon-umip-0.4/ is the Proxy Mobile IPv6 code built on top of UMIP 0.4
PMIP6D is quite independent from the other OpenAirInterface blocks.
-----------------------------------------
4) Hardware requirement and How to build PMIP6D
-----------------------------------------
4.1) HARDWARE REQUIREMENT
In our PMIP6D implementation, the Mobile Node's attachment and detachment phases are done at layer 2 using SYSLOG messages exchanged between the Access Point and the MAG.
Thus, it's mandatory for your Access Point to act as SYSLOG client.
4.2) HOW TO BUILD PMIP6D
WARNING: The PMIP6D has been developped and validated under Linux UBUNTU 10.04 LTS x86 distribution.