Cedric Roux
56c66c09aa
Pre-ci test passed git-svn-id: http://svn.eurecom.fr/openair4G/trunk@4000 818b1a75-f10b-46b9-bf7c-635c3b92a50f
127 lines
6.0 KiB
Plaintext
127 lines
6.0 KiB
Plaintext
/*******************************************************************************
|
|
|
|
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.
|
|
We can not confirm it will work with other systems.
|
|
|
|
In this document, "$THEGOODPATH" indicates the directory path where you place the PMIP6D code. (we suggest you to place it there -> /usr/local/src/)
|
|
|
|
4.2.1) Installation of the required packages on MAG and LMA machines :
|
|
libpcap-dev / indent / bison / flex / iproute-dev / macchanger / libc6-dev / libssl-dev / autoconf / libtool / python-netaddr
|
|
Open a new shell and type :
|
|
$ apt-get install libpcap-dev indent bison flex iproute-dev libc6-dev libssl-dev autoconf libtool macchanger python-netaddr
|
|
|
|
4.2.2) Kernel recompilation
|
|
PMIP6D does not require to modify/patch the kernel, however some features are by default disabled inside the official Ubuntu kernels and we need to enable them.
|
|
Follow the "INSTALL.kernel" text file to know how to set up correctly your kernel.
|
|
|
|
4.2.3) Proxy Mobile-IPv6 Daemon and FreeRADIUS installation
|
|
Follow the "INSTALL" text file to know how to build PMIP6D tool.
|
|
|
|
----------------------------------------------------------------
|
|
5) How to run a simple experimentation
|
|
----------------------------------------------------------------
|
|
|
|
In order to create a PMIP domain composed of 3 nodes (1 LMA + 2 MAGS) (see the picture "$THEGOODPATH/pmipv6-daemon-umip-0.4/src/pmip/docs/images/PMIPv6_schema_example_1LMA_2MRs.jpg"):
|
|
|
|
LMA, MAG1 and MAG2 are in the same network which has for IPv6 prefix 2001:100::/64
|
|
With LMA: Ethernet1=2001:100::1 / MAG1: Ethernet1=2001:100::2 & Ethernet2=2001:1::2 / MAG2: Ethernet1=2001:100::3 & Ethernet2=2001:1::3
|
|
|
|
On LMA execute -> ./$THEGOODPATH/pmipv6-daemon-umip-0.4/extras/UMIP0.4_LMA_UBUNTU.10.04.py
|
|
On MAG1 execute -> ./$THEGOODPATH/pmipv6-daemon-umip-0.4/extras/UMIP0.4_MAG1_UBUNTU.10.04.py
|
|
On MAG2 execute -> ./$THEGOODPATH/pmipv6-daemon-umip-0.4/extras/UMIP0.4_MAG2_UBUNTU.10.04.py
|