[[PageOutline]] = VLC DASH Tutorial = In this tutorial, we will show how to run VLC DASH using OpenFlow on GENI. Dynamic Adaptive Streaming over HTTP (DASH) is used to adapt the quality of the video based on the bandwidth between the video streaming server and the client. This exercise builds on the OpenFlow Load Balancer Tutorial that can be found [http://groups.geni.net/geni/wiki/GEC17Agenda/AdvancedOpenFlow/Procedure here]. == Overview == This tutorial leverages resources on the GENI aggregate in order to experiment with VLC DASH. For this tutorial, you will install an Apache server with videos that have already been encoded in a DASH format on one node and install an OMLified VLC client on another node. You will then be able to run the load-balancer using OpenFlow and OVS switches and subsequently use !LabWiki to observe how the quality of the video changes based on available bandwidth between the server and the client. [[Image(OpenFlowLB-topo.png, 20%, nolink)]] == Prerequisites == - A GENI account, if you don't have one [wiki:SignMeUp sign up!] - Familiarity with how to reserve GENI resources with any of the GENI Tools (GENI Experimenter Portal, Omni, Flack). If you don't know you can take any of the tutorials: * Reserving resources using Flack [wiki:GENIExperimenter/Tutorials/RunHelloGENI tutorial] * Reserving resources using Omni [wiki:GENIExperimenter/Tutorials/HelloOmni tutorial] - Familiarity with [wiki:HowTo/LoginToNodes logging in to GENI compute resources]. - Basic understanding of OpenFlow. If you are going over this tutorial at home, flip through the [http://groups.geni.net/geni/attachment/wiki/GEC17Agenda/AdvancedOpenFlowTutorial/AdvancedOpenFlow-GEC17.pptx tutorial's slides] - [wiki:GEC18Agenda/GettingStartedWithGENI_III_GIMI/Procedure/DesignSetup#iRODs Create iRODs account] - Introduction to !LabWiki [http://groups.geni.net/geni/wiki/GEC18Agenda/GettingStartedWithGENI_III_GIMI tutorial] - Familiarity with Unix Command line - See "Tools" section - A moderately deep understanding of the [http://www.openflow.org OpenFlow controller model] and API is required. - The OpenFlow specification, [http://www.openflow.org/documents/openflow-spec-v1.1.0.pdf version 1.0] is a valuable reference for OpenFlow and the controller model. == Tools == '''1. Trema''' [[BR]] Each exercise in this assignment will require you to design and implement an OpenFlow controller. Numerous libraries and controller frameworks are available for this task. The guidelines in this assignment assume that you are using the [http://trema.github.com/trema/ Trema] controller framework. The Trema project web site, http://trema.github.com/trema/, contains documentation, a number of helpful examples, and some tutorial material for learning to use Trema. '''2. Traffic Control (tc)'''[[BR]] The tc command is available in the GNU Linux distributions on GENI nodes, found in the ''/sbin'' directory. This command manipulates the Linux network forwarding tables, allowing for configuration of queuing disciplines, which change the policies controlling which packets are forwarded in what order and which are dropped; and network emulation, which allows the Linux kernel to emulate various network conditions such as delay or loss. These two effects are provided by the qdisc and netem subcommands, respectively. In these exercises, tc will be used to modify network conditions and enable different scheduling policies. Example command lines will be provided. '''3. [http://iperf.sourceforge.net/ Iperf]'''[[BR]] Iperf is available on the GENI nodes, located at ''/usr/local/etc/emulab/emulab-iperf''. Iperf is used to measure the bandwidth performance of Internet links. In these exercises, it is used to study the behavior of TCP in the face of changing link characteristics. Iperf runs as both a server and a client. The server is started with the -s command line option, and listens for connections from the client. The client is started with the ''-c '' command line option, and connects to the server and sends data at either the fastest possible rate (given the underlying network) or a user-specified rate. The -u option causes the sender or receiver to use UDP instead of TCP. Various other options will be required for these exercises, and provided in the appropriate sections. All Iperf measurement data should be recorded from the TCP receiver (server) side. == How to get Help == * Always ask your tutors (tutorial helper/presenter/TA) first. They are the fastest way to solve the problem. * If you are using a specific aggregate or tool, you should consider registering in their [wiki:NikySandbox/GENIExperimenter/GENICommunity#Joinusermailinglists mailing list]. It is a great way to get connected with other GENI users and it is an excellent source of wisdom. * Send mail to the GENI help list: [mailto:help@geni.net]. * If you want to chat real-time with other GENI users and ask questions, [wiki:HowTo/ConnectToGENIChatRoom join us] in a GENI chatroom. == Tutorial Instructions == {{{ #!html
Design/Setup
Execute
  • Part II: Execute
    • 2. Configure and Initialize services
    • 3. Run your experiment
    • Appendix: Hints and Explanations
Finish
}}}