openstack/os-ken
Code Issues Proposed changes
A component-based software defined networking framework for OpenStack.
395 Commits 10 Branches 42 Tags 9.9 MiB
Python 86.1%
Erlang 13.3%
C 0.4%
Shell 0.2%
0ae9c29687
Go to file
Isaku Yamahata 0ae9c29687 prepare contrib directory which holds third party library 
- create ryu/contrib directory
- adjust module load path for third party library and prioritize our own copy
  than system's
- teach ryu-manager ryu/contrib
- run_tests.sh: exclude contrib dir for pep8
  third party files will be included under ryu/contrib.
  Third party files aren't suitable to our pep8 check because they aren't under
  our control.

Signed-off-by: Isaku Yamahata <yamahata@valinux.co.jp>
2012-11-03 15:02:57 +09:00
bin prepare contrib directory which holds third party library 2012-11-03 15:02:57 +09:00
doc doc: update packet library 2012-10-06 13:16:18 +09:00
etc/ryu ryu.conf: eliminate obsolete config 2012-01-24 11:54:53 +09:00
ryu prepare contrib directory which holds third party library 2012-11-03 15:02:57 +09:00
tools test: add unittests for packet library 2012-10-12 02:29:23 +09:00
.gitignore Added test framework, ported from Quantum 2012-05-07 21:29:47 +09:00
.pylintrc test: improve the framework 2012-06-27 20:57:07 +09:00
LICENSE Switch to Apache 2.0 license 2012-04-06 08:38:45 +09:00
MANIFEST.in remote COPYRIGHT file from MANIFEST.in 2012-05-07 21:52:52 +09:00
README.rst doc: use README as getting_started 2012-09-17 13:15:45 +09:00
run_tests.sh prepare contrib directory which holds third party library 2012-11-03 15:02:57 +09:00
setup.cfg update setup.py and setup.cfg for better packaging 2012-06-06 12:45:46 +09:00
setup.py Removed leading '/' from data_files 2012-10-02 11:32:23 +09:00
SubmittingPatches.rst doc: integrate HACKING.rst into SubmittingPatches.rst 2012-09-04 06:47:58 +09:00

README.rst

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, please refer detailed documents. 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 write your Ryu application, have a look at Writing ryu application document. 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. The ML archive at Gmane is also available.