f39e95043c
Move some non pure python requirements (namely lxml and paramiko) from pip-requires to test-requires. Document it in README.rst. Motivations: - Make this pip-installable with pypy - Less distribution package requirements (deb/rpm/etc) in case a user do not actually need the functionality Note: while paramiko itself is pure python, it requires pycrypto. Note: msgpack has pure python fallback implementation. Separating ryu into smaller packages would be a better alternative. However, it would involve a lot more work than this workaround. Signed-off-by: YAMAMOTO Takashi <yamamoto@valinux.co.jp> Signed-off-by: FUJITA Tomonori <fujita.tomonori@lab.ntt.co.jp>
61 lines
1.7 KiB
ReStructuredText
61 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 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 `networking-ofagent project <https://github.com/stackforge/networking-ofagent>`_.
|
|
|
|
If you want to write your Ryu application, have a look at
|
|
`Writing ryu application <http://ryu.readthedocs.org/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 (net_cntl) requires paramiko
|
|
|
|
If you want to use the functionalities, please install requirements::
|
|
|
|
% pip install lxml
|
|
% pip install paramiko
|
|
|
|
|
|
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.
|