mirror of
https://github.com/faucetsdn/ryu.git
synced 2026-01-30 13:01:23 +01:00
03b42e23d4
As discussed on the mailing list, there is no good packet library (parses and builds various protocol packets). dpkt isn't flexible enough (can't nicely handle stacked protocols such as vlan, mpls, gre). NOX's one is nice but released under GPL3. So we need our own packet library. Signed-off-by: FUJITA Tomonori <fujita.tomonori@lab.ntt.co.jp>
****************************
Ryu Network Operating System
****************************
What's Ryu
==========
Ryu is an Operating System for Software Defined Networking.
Ryu aims to provide a logically centralized control and well defined
API that make it easy for operators to create new network management
and control applications. Currently, Ryu manages network devices by
using OpenFlow. You can say that Ryu is an OpenFlow Controller, which
support OpenFlow v1.0, v1.2, and Nicira Extensions.
All of the code is freely available under the Apache 2.0 license. Ryu
is fully written in Python.
Quick Start
===========
Installing Ryu is quite easy::
% pip install ryu
If you prefer to install Ryu from the source code::
% git clone git://github.com/osrg/ryu.git
% cd ryu; python ./setup.py install
If you want to use Ryu with `OpenStack <http://openstack.org/>`_,
please refer `detailed documents <http://www.osrg.net/ryu/overview.html/>`_.
You can create tens of thousands of isolated virtual networks without
using VLAN. The Ryu application is included in OpenStack mainline as
of Essex release.
If you want to run your Ryu application, have a look at
`a simple example <https://github.com/osrg/ryu/blob/master/ryu/app/simple_switch.py>`_.
After writing your application, just type::
% ryu-manager yourapp.py
Support
=======
Ryu Official site is `<http://osrg.github.com/ryu/>`_.
If you have any
questions, suggestions, and patches, the mailing list is available at
`ryu-devel ML
<https://lists.sourceforge.net/lists/listinfo/ryu-devel>`_.
`The ML archive at Gmane <http://dir.gmane.org/gmane.network.ryu.devel>`_
is also available.