Table of Contents
Installation
Make sure you have appropriate package repository configured.
Configure Apt Repository
To begin we'll need to add the Orbit apt repository to the list of sources that our console will pull packages from. This is done by running the following two commands.
Note: It is assumed that you have root access and can run these commands as root if needed
The first installs the orbit repositories gpg-key into the consoles key-ring.
wget -qO - http://packages.orbit-lab.org/downloads/orbitapt.gpg.key | sudo apt-key add -
Next we download the source list for the repository.
wget -qO /etc/apt/sources.list.d/orbit.list http://packages.orbit-lab.org/downloads/orbit-precise.list
Once we have these changes in place, we need to update the repository list via
apt-get update
The GNRS server is installed with:
sudo apt-get install gnrs
This will install the following components:
- gnrs executable: Java implementation of DMap. The binary is provided as a jar file called gnrs-server-1.0.0-SNAPSHOT-jar-with-dependencies.jar installed under /usr/lib/mfjava/
Compiling From Source
1.1. Required Packages
The implementation has been tested on Ubuntu 10.04, 12.04 and 13.04, but it should work on basically any linux distribution (or any platform supporting JAVA). These are the required packages (for Ubuntu).
sudo apt-get update sudo apt-get -y install git-core openjdk-7-jdk maven
openjdk-7-jdk can be replaced with the preferred JAVA version
1.2. Download MobilityFirst Sources
Git: The development versions of the prototype components can be checked out from the MobilityFirst git repository host on orbit-lab:
git clone ssh://username@external1.orbit-lab.org/common/git/mf
Note: cloning the git repository requires setting your ssh agent to use your orbit-lab key pair.
Set and export path of top-level folder to an env. variable 'MF_HOME'
export MF_HOME=/home/username/mobilityfirst
1.3. Compiling the GNRS
After deciding whether to include OML in the created executable compile the Host Protocol Stack:
cd $MF_HOME/gnrs/jserver python install-to-project-repo.py -i #When prompted, the version is "0.6" (option 2) and the artifactId is "patricia-trie" (option 1) mvn clean package
Optionally install the generated jar into your system folder:
sudo install -d /usr/lib/mfjava/ sudo install -m 755 target/gnrs-server-1.0.0-SNAPSHOT-jar-with-dependencies.jar /usr/lib/mfjava/