[[TOC(Proto/cModules/b0GNRS*, depth=2)]]

= Installation =

[[CollapsibleStart(Make sure you have appropriate package repository configured.)]][[Include(Documentation/Other/RepositoryConfig)]][[CollapsibleEnd]]

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 [https://mobilityfirst.orbit-lab.org/browser/mf 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/
}}}