``````````````````````````````` Tutorials (FGRE 2014 edition) ``````````````````````````````` Getting started with GENI and Fed4FIRE ====================================== Introduction ------------ Introduction on FIRE testbeds and Fed4FIRE: :download:`introduction_fed4fire.pptx<_static/introduction_fed4fire.pptx>` Part 1 ------ The accompanying slides can be downloaded here: :download:`gettingstarted_part1.pptx<_static/gettingstarted_part1.pptx>` Part 2 ------ See http://groups.geni.net/geni/wiki/GENIExperimenter/Tutorials/iMinds/GettingStarted_PartII_ccn/Procedure/Setup .. _wilabttutorial: Sensor tutorial =============== `Tutorial `_ NEPI ==== 1. NEPI installation: --------------------- http://nepi.inria.fr/Install/WebHome 2. Step by step hands-on introduction to NEPI: ----------------------------------------------- http://nepi.inria.fr/Nepi/StepByStepExperiment 3. Putting everything together in one experiment: -------------------------------------------------- http://nepi.inria.fr/Nepi/LinuxNodeExperiments#File_transfer_using_netcat Each attendee will use 2 PlanetLab nodes during the tutorial which can be provisioned at the beginning using jFed. The node hostnames for each attendee will be pre-assigned from a list. Wireless tutorial: Part 1: Access point and client (incl. mobility) =================================================================== | The intro slides can be downloaded here: :download:`FGREwirelessIntro.pptx<_static/FGREwirelessIntro.pptx>` | The accompanying slides for the tutorial can be downloaded here: :download:`FGREwirelessIminds.pptx<_static/FGREwirelessIminds.pptx>` In this tutorial, we will show you how to set up one wireless access point and connect with 1 client. The access point will start an iPerf server instance, after which we will run an iPerf client instance on the second node. By using the correct IP addresses, we make sure that the iPerf traffic stream is routed over the wireless interfaces. In this tutorial, we will use a mobile node for setting up the access point. The client will be configured on a fixed wireless node. The following steps should guide you through the entire process. 1. Reserve 3 wireless nodes using jFed --------------------------------------- | There are currently 6 mobile nodes available. | Every group has 3 nodes (2 fixed and 1 mobile) which you have to swap in using jFed. You should choose specific nodes in jFed by right clicking the node. Name them: ap, client and backup. See the table on the slides to see which nodes you can use. 2. Configure the access point (on the mobile node) -------------------------------------------------- Before running the experiment, we will use the shell script option in the RSpec to install hostapd. We will also configure the OMF6 RC so it can be used in the labwiki tutorial. If you are doing this tutorial afterwards, you can skip this step. Go to the Raw RSpec view and add the following in the node part of the ap (first line is already there):: Note: it should be valid XML, so if you want to use &&, then escape it. See http://fed4fire-testbeds.ilabt.iminds.be/ilabt-documentation/urnsrspecs.html#install-software-when-provisioning-and-run-a-script-after-provisioning for more examples. 3. Configuration of Access Point (on your mobile node) ------------------------------------------------------- SSH to your mobile node (from jFed). Become root:: sudo su Create a config file for the hostapd program:: nano /root/hostapd.conf Add the following content to the config file (X=group number, Y=channel, Z=mode lines should be left aligned):: interface=wlan0 driver=nl80211 country_code=BE ssid=demoX hw_mode=Z channel=Y | Replace X with your demo number. Replace Y with your channel and Z with the WiFi mode. | Start hostapd. The above config will setup an AP on wlan0 using 802.11a or g, channel Y, with SSID demoX:: hostapd /root/hostapd.conf Open a second ssh terminal and give an IP address to the wlan0 interface so we can test the connection to the clients (in the next steps):: ifconfig wlan0 192.168.X.1/24 4. Configure the client (on one of the fixed nodes) ---------------------------------------------------- Become root:: sudo su Put the wireless interface into managed mode and specify the SSID so it knows to which AP it should connect :: iwconfig wlan0 mode managed iwconfig wlan0 essid demoX Specify an IP address and bring up the interface:: ifconfig wlan0 192.168.X.10/24 up Check if you can ping the AP:: ping 192.168.X.1 5. iPerf measurement --------------------- Start an iPerf server instance (UDP in this case) on the mobile node (AP):: iperf -s -u -i 1 & Configure the iPerf client:: iperf -u -c 192.168.X.1 -b 40M -i 1 -t 6000 | If the iperf reports an actual 40Mbit/sec throughput, you probably lost the connection. By tweaking the transmit power (values of 0 to 20dBm) of the access point, you should be able to see a difference in throughput of the iPerf stream:: iwconfig wlan0 txpower <0-20> For this tutorial, leave the txpower to 20 for the first experiment runs. If the effect of moving the mobile node is too limited, you can try lowering the txpower. Note that each antenna at the w-iLab.t is equipped with a 10dB attenuator (so 20dB attenuation per link). 6. Move the mobile nodes ------------------------- | Once everything works fine, you can start driving the mobile node and check the impact on the iPerf throutput. | The robot control software can be accessed at http://am.wilab2.ilabt.iminds.be:4000/index_ipv6.html. | You can log in with the demoX accounts. For example, the demo5 account will give you the rights to move mobile5. | Instructions on how to use the framework: http://ilabt.iminds.be/wilabt/use/mobilitytoolkit , scroll down to "Setting up paths". | VERY IMPORTANT : You will only be able to SSH to the mobile node while it is docked. (If you want an SSH connection during your experiment, you will have to set up a wireless connection to a fixed node and SSH over the wireless.) .. _virtualwalltutorial: Wireless tutorial: Part 2: WiMax ================================ See http://nitlab.inf.uth.gr/NITlab/index.php/testbed/fgre-tutorials. (credentials will be passed during the tutorial) Emulation and cloud tutorial ====================================================================== The accompanying slides can be downloaded here: :download:`TutorialPart2_virtualwall.pptx<_static/Tutorial_emulation_full.pptx>` Openflow ======== Openflow with Open VSwitch -------------------------- See here: http://groups.geni.net/geni/wiki/GENIExperimenter/Tutorials/OpenFlowOVS Hardware Openflow on i2cat and Bristol -------------------------------------- The main set of slides for the tutorial: http://univbrisofeliaf4f.blogs.ilrt.org/files/2014/07/Fed4FIRE_FGRE-2014_7_9-Ghent.pdf The RSpecs for the tutorial: http://univbrisofeliaf4f.blogs.ilrt.org/files/2014/07/rspecs.zip Youtube video of Optical OpenFlow demo: https://www.youtube.com/watch?v=CtZguEvxwzA Labwiki ======= | http://groups.geni.net/geni/wiki/GENIFIRE/Labwiki | http://groups.geni.net/geni/wiki/GENIFIRE/Labwiki/Part1/Introduction | http://groups.geni.net/geni/wiki/GENIFIRE/Labwiki/Part2a/Introduction