Tutorials on running simple mfping application using mobilityfirst routers, host stack and GNRS.

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 workflow page to get started (currently ORBIT sb4 is used for the experiments described below).

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

4. 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)

5. Download the bash script into your console environment

   console:~$ git clone https://gitlab.orbit-lab.org/pnetalkar/cosmos-mf-tutorial.git
   

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 mfstack1.conf and 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
  

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 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. Use the stop script 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