This is a module to be installed within Floodlight🔗 to facilitate the installation and removal of Queues in Open vSwitches.
With the intention of providing an interface inside the Floodlight controller to ease the process of queue creation within an OF enabled switch, in particular the Open vSwitch (OVS), the QueuePusher was created. This entity presents itself as an extension to Floodlight, a module per se, rather than as a standalone application; following this approach allows the QueuePusher to be easily embedded in every Floodlight installation and also to enable Floodlight to handle all the event processing, avoiding the creation of additional overheads on the controller communication.
- Uses OVSDB protocol to communicate with Open vSwitches
- Complete integration with Floodlight REST API
To successfully install and run Floodlight with the QueuePusher, the following requirements should be met. Though it might work with earlier or later versions of the given software, as well as different releases (like OpenJDK), it has not been tested:
- Oracle Java Virtual Machine ≥ 1.6
- Floodlight == 0.9
- Open vSwitch ≥ 1.9.3 (tested with == 2.0.0 as well)
- curl ≥ 7.22.0
Note: Since this is provided as a module, it is at least expected from you to know how to build Floodlight.
Assuming that all the above requirements are met:
- Place the QueuePusher package inside the source of Floodlight
- That's it!
###Short examples:
The REST API is quite straightforward and should be simple to use. A couple of examples follow:
Queue Creation
Request (for the specified OpenFlow Switch ID and desired port):
$ curl -d '{"switchid": "00:00:00:00:00:00:00:51", "port":"eth3", "rate":20}' http://127.0.0.1:8080/wm/queuepusher/qpc/json
Response (QueueID, QueueUUID, QoSUUID, Std. Error, Exit Code and Std. Out)
{"id":"1","queueuuid":"f8de823c-a4cb-4098-8eef-800aece60fc5","qosuuid":"99172e77-79fd-467b-8e13-7ca9df49ec7e","err":"","exitcode":"SUCCESS","out":""}
The output provided by the QueuePusher consists of output returned by the chosen Open vSwitch when using OVSDB (Std. Out and Std. Err.). The same applies to the Queue and QoS IDs, being the exit code mapped in QueuePusherResponseCode.java file.
Further Queue creations in the same port will result in different incrementing IDs.
Example:
$ curl -d '{"switchid": "00:00:00:00:00:00:00:51", "port":"eth3", "rate":20}' http://127.0.0.1:8080/wm/queuepusher/qpc/json
{"id":"2","queueuuid":"a6acf0b4-f794-44d6-8a62-9f221842f386","qosuuid":"99172e77-79fd-467b-8e13-7ca9df49ec7e","err":"","exitcode":"SUCCESS","out":""}
Queue Deletion
Request (for the specified OpenFlow Switch ID and desired port):
$ curl -X DELETE -d '{"switchid": "00:00:00:00:00:00:00:51", "queueuuid":"a6acf0b4-794-44d6-8a62-9f221842f386","qosuuid":"99172e77-79fd-467b-8e13-7ca9df49ec7e"}' http://127.0.0.1:8080/wm/queuepusher/qpd/json
Response (Std. Error, Exit Code and Std. Out)
{"err":"","exitcode":"SUCCESS","out":""}
If not doing so already, you can download the latest version of the Floodlight QueuePusher module by cloning the github repository.
Copyright (c) 2014 OneSource Consultoria Informatica, Lda. 🔗
Copyright (c) 2014 RedZinc 🔗
This project has been developed in the scope of the CityFlow project🔗 by João Gonçalves and David Palma
Distributed under the Apache 2 license. See LICENSE for more information.
##About
OneSource is the core institution that supported this work. Regarding queries about further development of custom solutions and consultancy services please contact us by email: geral✉️onesource.pt or through our website: http://www.onesource.pt
OneSource is a Portuguese SME specialised in the fields of data communications, security, networking and systems management, including the consultancy, auditing, design, development and lifetime administration of tailored IT solutions for corporate networks, public-sector institutions, utilities and telecommunications operators.
Our company is a start-up and technological spin-off from Instituto Pedro Nunes (IPN), a non-profit private organisation for innovation and technology transfer between the University of Coimbra and the industry and business sectors. Faithful to its origins, OneSource keeps a strong involvement in R&D activities, participating in joint research projects with academic institutions and industrial partners, in order to be able to provide its customers with state-of-art services and solutions.
RedZinc was founded in July 2004 by Donal Morris, with a vision to provide quality of service capabilities on the public internet. In September 2004 RedZinc joined the EuQoS research consortium on end to end quality of service over heterogeneous networks.
Between 2004 and 2008 RedZinc focused on research and development on public internet Quality of Service in partnership with leading research institutes including University of Coimbra, University of Bern, Laboratoire D'analyse Et D'architecture Des Systemes, University of Pisa and Warsaw Technical University.