0dc79ddd7e
The hosting site has changed to use readthedocs.io instead of readthedocs.org. Signed-off-by: IWAMOTO Toshihiro <iwamoto@valinux.co.jp> Signed-off-by: FUJITA Tomonori <fujita.tomonori@lab.ntt.co.jp>
60 lines
1.7 KiB
ReStructuredText
60 lines
1.7 KiB
ReStructuredText
What's Ryu
|
|
==========
|
|
Ryu is a component-based software defined networking framework.
|
|
|
|
Ryu provides software components with well defined API that make it
|
|
easy for developers to create new network management and control
|
|
applications. Ryu supports various protocols for managing network
|
|
devices, such as OpenFlow, Netconf, OF-config, etc. About OpenFlow,
|
|
Ryu supports fully 1.0, 1.2, 1.3, 1.4, 1.5 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 write your Ryu application, have a look at
|
|
`Writing ryu application <http://ryu.readthedocs.io/en/latest/writing_ryu_app.html>`_ document.
|
|
After writing your application, just type::
|
|
|
|
% ryu-manager yourapp.py
|
|
|
|
|
|
Optional Requirements
|
|
=====================
|
|
|
|
Some functionalities of ryu requires extra packages:
|
|
|
|
- OF-Config requires lxml
|
|
- NETCONF requires paramiko
|
|
- BGP speaker (ssh console) requires paramiko
|
|
- OVSDB support requires ovs (Note: python 3.4 requires ovs>=2.6.0.dev0)
|
|
|
|
If you want to use the functionalities, please install requirements::
|
|
|
|
% pip install lxml
|
|
% pip install paramiko
|
|
% pip install ovs
|
|
|
|
|
|
Support
|
|
=======
|
|
Ryu Official site is `<http://osrg.github.io/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.
|