The Locator/ID Separation Protocol (LISP) is being developed within the IETF as a potential solution to the routing scalability problem documented in RFC 4984. It uses the concept of Endpoint IDentifiers (EIDs) to name hosts in edge networks, and Routing LOCators (RLOCs) for nodes in transit networks. EIDs and RLOCs are syntactically indistiguishable from current IPv4 and IPv6 addresses, enabling backwards compatibility with the existing Internet architecture. A distributed database, the mapping system, is responsible for maintaining the associations between EIDs and RLOCs.
LISP Mobile Node (LISP-MN) is a specification to enable fast host mobility using LISP. The LISPmob project aims to deliver a full implementation of this specification for Linux, but parts of the implementation may be reusable on other Unix-like operating systems.
LISPmob consists of three major components:
- data plane
- control plane
The data plane is implemented in kernel space, with two modules:
lisp_int.ko, which creates a virtual interface for the EID(s); and
lisp.ko, responsible for encapsulating/decapsulating packets, maintaining
the mapping cache, etc.
The user space daemon
lispd is responsible for control plane functionality,
such as sending and receiving control messages, managing interfaces, etc.
The distribution offers some external tools as well, which can be used for various testing and debugging purposes.
The current reference platform for LISPmob development is Ubuntu Server 10.04.3 LTS (Lucid Lynx). It was also demonstrated on a Nokia N900 mobile phone running MeeGo 1.2 Community Edition.
Running LISPmob host on the public Internet requires the following:
- an EID from a Mapping Service Provider (MSP),
- the RLOC of the Map-Server that will accept registration of this EID,
- an authentication token to register the EID with the Map-Server,
- the RLOC of a Map-Resolver,
- the RLOC of a Proxy-ETR,
- a publicly routable RLOC for the host, which is neither firewalled, nor behind NAT.
Other than the last item, the above information is used for configuring
via the configuration file
The EID will be used by the applications on the host for establishing communications. The RLOC will change, depending on the network point of attachment, i.e., it will be the IP address assigned to the host in the visited network. See the References section for pointers to detailed documentation on the above concepts and network elements.
Visit http://www.lisp4.net/ for more info on the deployment status of the LISP pilot network and how you can join the testbed.
To build LISPmob, you will need:
- a Linux hosts with a fairly recent kernel (tested with 2.6.32)
- header files of the running kernel
- a C compiler (tested with
- GNU make
- git, unless you use a tarball
- OpenSSL development headers
On Debian-derived Linux distributions (including Ubuntu), installing the following packages will provide all necessary dependencies:
The latest version of the LISPmob source code can be obtained from Github:
git clone git://github.com/LISPmob/lispmob.git
To build and install the code, run the following in the top-level directory:
make sudo make install
This will build the kernel modules, which are installed to the
directory, and the executable files, installed to
Once the code is successfully installed on the host,
should be copied to
/etc/lispd.conf and edited with the values obtained from
the MSP (see "Network Prerequisites"). Additionally the host interface used
for physical network connectivity (such as
also be specified in the configuration file.
The user space daemon must be started as the super-user:
sudo lispd -f /etc/lispd.conf
It will load the kernel modules, set up networking and register to the mapping
system, after which you can enjoy all the benefits of LISP-MN. When
running, the EID obtained from the MSP should be associated to the
virtual interface. The previous default gateway (RLOC_GW) on the physical
interface should have its metric set to 100 and the default gateway with metric
0 should now be
$ ip addr 1: lo: <LOOPBACK,UP,LOWER_UP> mtu 16436 qdisc noqueue state UNKNOWN link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00 inet 127.0.0.1/8 scope host lo valid_lft forever preferred_lft forever 2: eth0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc pfifo_fast state UP qlen 1000 link/ether 00:00:00:00:00:00 brd ff:ff:ff:ff:ff:ff inet <RLOC> brd <RLOC_BROADCAST> scope global eth0 valid_lft forever preferred_lft forever 3: lmn0: <BROADCAST,MULTICAST,NOARP,UP,LOWER_UP> mtu 1300 qdisc pfifo_fast state UNKNOWN qlen 1000 link/ether 00:00:00:00:00:00 brd ff:ff:ff:ff:ff:ff inet <EID> scope global lmn0 valid_lft forever preferred_lft forever $ ip route <Visited_Network> dev eth0 proto kernel scope link src <RLOC> 169.254.0.0/16 dev eth0 scope link metric 1000 default via <EID> dev lmn0 default via <RLOC_GW> dev eth0 metric 100
Source routing should also be correctly set up:
$ ip rule 0: from all lookup local 1: from <RLOC> lookup 5 32766: from all lookup main 32767: from all lookup default $ ip route show table 5 default via <RLOC_GW> dev eth0
More interactive help can sometimes be obtained on the
#lispmob IRC channel
Bugs you encounter should be filed at the repository's issue tracker on Github.