Description

The Mobility First 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, Wi Fi 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

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)

Fig.2 MF Topology setup for Experiment 2

Experiment 3 (OAI)

Fig.3 MF Topology setup for Experiment 3