=== Description ===
The MobilityFirst project was started in 2010 with funding from the National Science Foundation's Future Internet Architecture (FIA) program as one of the four clean-slate architectures.The major design goals of the architecture are:
* Mobility as a norm with dynamic host and network mobility at scale
* Robustness with respect to intrinsic properties of wireless medium
* Trustworthiness in the form of enhanced security and privacy for both mobile networks and wired infrastructure
* Support for context-aware pervasive mobile services, evolvable network services, manageability and economic viability

This tutorials describes running simple mfping application using mobilityfirst routers, host stack and GNRS with ethernet, WiFi and OAI interfaces.

=== Requirements ===
Five nodes are required to run this experiment (currently ORBIT SB4 is used as described below).

=== Set up ===
1. In order to access the test bed, create a reservation and have it approved by the reservation service. 
2. Access to the resources are granted after the reservation is confirmed. 
3. Please follow the process shown on the COSMOS/ORBIT workflow page to get started .

= Experiment 1 (Ethernet Interfaces) =

=== Topology ===
 || [[Image(exp1.png, width=500px)]] ||
Fig.1 MF Topology setup for Experiment 1

=== Configuration ===
1. Load the images on the nodes using the command below, the image mf-exp1.ndz has all the required source code files for host stack, routers and GNRS.
{{{
console:~$ omf load -i mf-exp1.ndz -t node1-3,node1-4,node1-7,node1-6,node1-8
}}}

2. Please turn on the nodes after loading image
{{{
console:~$ omf tell -a on -t node1-3,node1-4,node1-7,node1-6,node1-8
}}}

3. Open separate terminals for each of the nodes either using mobaxterm or putty. Also, in our above topology {{{eth1}}} represents core interface and {{{eth0}}} represents edge interface.

4. Download the bash script into your console environment
{{{
console:~$ git clone https://gitlab.orbit-lab.org/pnetalkar/cosmos-mf-tutorial.git
}}}

5. Configuration of GNRS
* Login into the GNRS node (node1-8 in this case) {{{console:~$ ssh root@node1-8}}}
* Change the ipv4 address in {{{vim ~/mf/gnrs/jserver/sample-configs/single-server/net-ipv4.xml}}} file to X.X.X.X (eth1 address – 10.14.1.8) 
* Change the ipv4 address and the binding port in {{{vim ~/mf/gnrs/jserver/sample-configs/single-server/as-binding.ipv4}}} file to X.X.X.X (eth1 address-10.14.1.8)

6. Run/Execute the scripts present in {{{exp1}}} folder from the console (see below for more instruction)

7. Configure the config.sh file according to your node setup
{{{
#!/bin/bash

log_level="1"

#Node IDs
n1="1"
n2="2"
n3="3"
n4="4"

#Node Address
node1="node1-3"
node2="node1-4"
node3="node1-7"
node4="node1-6"
nodegnrs="node1-8"
}}}

8. Execute ./setup_interfaces.sh to configure the IP address of the respective {{{eth0}}} interfaces as shown in the topology figure above
{{{
console:~/cosmos_tutorial/exp1$./setup_interfaces.sh
}}}

9. Execute ./copy_router_conf.sh to copy {{{topo}}} file required by click routers 
{{{
console:~/cosmos_tutorial/exp1$./copy_router_conf.sh
}}}

10. Run ./copy_hostconf.sh to copy host stack configuration files to the respective hosts
*  Before copying host config file, make sure you edit these mfstack files present in conf folder.
*  Inside {{{vim mfstack1.conf}}} and {{{vim mfstack4.conf}}}, configure GUID and also the interfaces with the respective next hop IP and MAC address of the router.
{{{
# Required.
DEFAULT_GUID = 1

#INTERFACE = ether,eth0,ip,auto
INTERFACE = ether,eth0,ip,manual,192.168.1.2,d8:50:e6:d4:f5:2d
}}}

{{{
console:~/cosmos_tutorial/exp1$./copy_hostconf.sh
}}}

11. Run ./start_gnrs.sh to start the GNRS at node1-8
{{{
console:~/cosmos_tutorial/exp1$./start_gnrs.sh
}}}

         Verify the status of the GNRS using command: {{{root@node1-8:~# tail -f /var/log/mfgnrs.log}}} at node1-8

12. Run ./start_routers.sh to start the routers on node1-4 and node1-7.
{{{
console:~/cosmos_tutorial/exp1$./start_routers.sh
}}}

         Verify the status of the routers using command: {{{root@node1-4:~# tail -f /var/log/mfrouter2.log}}} to read the logs of router with id 2 and {{{root@node1-7:~# tail -f /var/log/mfrouter3.log}}} to read the logs of router with id 3.

13. Run ./start_hosts.sh to start the host on node1-3, node1-6 respectively.
{{{
console:~/cosmos_tutorial/exp1$./start_hosts.sh
}}}
         Use the command {{{root@node1-3:~# tail -f /var/log/mfhost1.log}}} and {{{root@node1-6:~# tail -f /var/log/mfhost4.log}}} to read the logs/status of host with id 1 and id 4 respectively.

=== Running MFPING ===
1. At Host 4: Server (Start the server first) 
{{{
root@node1-6:~# mfping -m 4 -o 1 -s -d
}}}

2. At Host 1: Client
{{{
root@node1-3:~# mfping -d -m 1 -o 4 -c -n 10
}}} 

3. Stop scripts can be used to stop the respective host, routers and GNRS
{{{
console:~/cosmos_tutorial/exp1$./stop_gnrs.sh
console:~/cosmos_tutorial/exp1$./stop_routers.sh
console:~/cosmos_tutorial/exp1$./stop_hosts.sh
}}}

=== Additional Details ===
1. Starting GNRS:
*  {{{cd mf/gnrs/jserver}}}
*  {{{mf/gnrs/jserver# java -Dlog4j.configuration=file:sample-configs/single-server/log4j.xml -jar target/gnrs-server-1.0.0-SNAPSHOT-jar-with-dependencies.jar sample-configs/single-server/server.xml}}}
2. Starting Routers:
* {{{cd ~/mf/router/click/conf}}}
* {{{~/mf/router/click/conf# click MF_IPAccessMultiRouter.click my_GUID=X topo_file=topo core_dev=ethX GNRS_server_ip=x.x.x.x GNRS_server_port=5000 GNRS_listen_ip=y.y.y.y GNRS_listen_port=5001 edge_dev=ethx edge_dev_ip=z.z.z.z}}}
3. Staring Host:
* {{{cd mf/mfclient/hoststack/conf}}}
* {{{mf/mfclient/hoststack/conf# mfstack -d mfstack.conf}}}

= Experiment 2 (WIFI) =
 || [[Image(exp2.png, width=500px)]] ||
Fig.2 MF Topology setup for Experiment 2
= Experiment 3 (OAI) =
 || [[Image(exp3.png, width=500px)]] ||
Fig.3 MF Topology setup for Experiment 3