From 712d599f541f3e7bbc14833e2b6f55de964eebdb Mon Sep 17 00:00:00 2001 From: Yoshihiro Kaneko Date: Mon, 16 Jun 2014 18:40:42 +0900 Subject: add debian files to make packages for Ubuntu Signed-off-by: Yoshihiro Kaneko Signed-off-by: FUJITA Tomonori --- debian/changelog | 5 ++ debian/clean | 3 ++ debian/compat | 1 + debian/control | 67 +++++++++++++++++++++++ debian/copyright | 62 ++++++++++++++++++++++ debian/docs | 1 + debian/log.conf | 21 ++++++++ debian/python-ryu.install | 1 + debian/rules | 24 +++++++++ debian/ryu-bin.dirs | 1 + debian/ryu-bin.install | 4 ++ debian/ryu-bin.manpages | 2 + debian/ryu-bin.postrm | 2 + debian/ryu-bin.ryu.logrotate | 7 +++ debian/ryu-bin.ryu.upstart | 9 ++++ debian/ryu-manager.8.txt | 124 +++++++++++++++++++++++++++++++++++++++++++ debian/ryu.8.txt | 38 +++++++++++++ debian/ryu.conf | 36 +++++++++++++ debian/source/format | 1 + 19 files changed, 409 insertions(+) create mode 100644 debian/changelog create mode 100644 debian/clean create mode 100644 debian/compat create mode 100644 debian/control create mode 100644 debian/copyright create mode 100644 debian/docs create mode 100644 debian/log.conf create mode 100644 debian/python-ryu.install create mode 100755 debian/rules create mode 100644 debian/ryu-bin.dirs create mode 100644 debian/ryu-bin.install create mode 100644 debian/ryu-bin.manpages create mode 100644 debian/ryu-bin.postrm create mode 100644 debian/ryu-bin.ryu.logrotate create mode 100644 debian/ryu-bin.ryu.upstart create mode 100644 debian/ryu-manager.8.txt create mode 100644 debian/ryu.8.txt create mode 100644 debian/ryu.conf create mode 100644 debian/source/format (limited to 'debian') diff --git a/debian/changelog b/debian/changelog new file mode 100644 index 00000000..ec4c6267 --- /dev/null +++ b/debian/changelog @@ -0,0 +1,5 @@ +ryu (3.10-1) trusty; urgency=low + + * Initial release. + + -- Ryu Project Team Mon, 16 Jun 2014 15:21:36 +0900 diff --git a/debian/clean b/debian/clean new file mode 100644 index 00000000..2ce33bb6 --- /dev/null +++ b/debian/clean @@ -0,0 +1,3 @@ +ryu.egg-info/* +debian/ryu-manager.8 +debian/ryu.8 diff --git a/debian/compat b/debian/compat new file mode 100644 index 00000000..ec635144 --- /dev/null +++ b/debian/compat @@ -0,0 +1 @@ +9 diff --git a/debian/control b/debian/control new file mode 100644 index 00000000..11b312ad --- /dev/null +++ b/debian/control @@ -0,0 +1,67 @@ +Source: ryu +Section: net +Priority: optional +Maintainer: Ryu Project Team +Build-Depends: debhelper (>= 9.0.0), python-all (>= 2.6), txt2man +Build-Depends-Indep: + python-eventlet, + python-lxml, + python-msgpack (>= 0.3.0), + python-netaddr, + python-oslo.config (>= 1:1.2.0), + python-paramiko, + python-routes, + python-six (>= 1.4.0), + python-webob (>=1.0.8), + python-setuptools, + python-pip, + python-pbr +Standards-Version: 3.9.5 +Homepage: http://osrg.github.io/ryu/ +Vcs-Git: git://github.com/osrg/ryu.git +Vcs-Browser: http://github.com/osrg/ryu +XS-Python-Version: >= 2.6 + +Package: python-ryu +Architecture: all +Section: python +Depends: + python-eventlet, + python-lxml, + python-msgpack (>= 0.3.0), + python-netaddr, + python-oslo.config (>= 1:1.2.0), + python-paramiko, + python-routes, + python-six (>= 1.4.0), + python-webob (>=1.0.8), + ${misc:Depends}, + ${python:Depends} +Provides: ${python:Provides} +XB-Python-Version: ${python:Versions} +Description: Ryu is a software defined networking framework + 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. + . + This package provides the Python library. + +Package: ryu-bin +Architecture: all +Depends: + python-ryu, + ${misc:Depends}, + ${python:Depends}, + ${shlibs:Depends} +Description: Ryu is a software defined networking framework + 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. + . + This package provides the Ryu manager. diff --git a/debian/copyright b/debian/copyright new file mode 100644 index 00000000..63d77d3b --- /dev/null +++ b/debian/copyright @@ -0,0 +1,62 @@ +Format: http://www.debian.org/doc/packaging-manuals/copyright-format/1.0/ +Upstream-Name: ryu +Source: http://github.com/osrg/ryu + +Files: * +Copyright: 2014 Ryu Project Team +License: Apache-2.0 + +Files: ryu/contrib/_eventlet/* +Copyright: 2005-2006, Bob Ippolito + 2007-2010, Linden Research, Inc. + 2008-2010, Eventlet Contributors (see AUTHORS) +License: MIT + +Files: ryu/contrib/ncclient/* +Copyright: Shikhar Bhushan + Leonidas Poulopoulos + Ebben Aries +License: Apache-2.0 + +Files: ryu/contrib/tinyrpc/* +Copyright: 2013 Marc Brinkmann +License: MIT + +Files: ryu/contrib/ovs/* +Copyright: 2009, 2010, 2011, 2012, 2013 Nicira, Inc. +License: Apache-2.0 + +License: Apache-2.0 + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + . + http://www.apache.org/licenses/LICENSE-2.0 + . + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. + . + On Debian-based systems, the full text of the Apache version 2.0 license + can be found in "/usr/share/common-licenses/Apache-2.0". + +License: MIT + Permission is hereby granted, free of charge, to any person obtaining a copy + of this software and associated documentation files (the "Software"), to deal + in the Software without restriction, including without limitation the rights + to use, copy, modify, merge, publish, distribute, sublicense, and/or sell + copies of the Software, and to permit persons to whom the Software is + furnished to do so, subject to the following conditions: + . + The above copyright notice and this permission notice shall be included in + all copies or substantial portions of the Software. + . + THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR + IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, + FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE + AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER + LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, + OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN + THE SOFTWARE. diff --git a/debian/docs b/debian/docs new file mode 100644 index 00000000..a1320b1b --- /dev/null +++ b/debian/docs @@ -0,0 +1 @@ +README.rst diff --git a/debian/log.conf b/debian/log.conf new file mode 100644 index 00000000..cf1f728f --- /dev/null +++ b/debian/log.conf @@ -0,0 +1,21 @@ +[loggers] +keys = root + +[handlers] +keys = file + +[formatters] +keys = simple + +[logger_root] +level = INFO +handlers = file + +[handler_file] +class = handlers.WatchedFileHandler +formatter = simple +args = ('/var/log/ryu/ryu.log',) + +[formatter_simple] +format = %(asctime)s.%(msecs)03d %(levelname)s %(name)s %(message)s +datefmt = %Y-%m-%d %H:%M:%S diff --git a/debian/python-ryu.install b/debian/python-ryu.install new file mode 100644 index 00000000..036c6b9d --- /dev/null +++ b/debian/python-ryu.install @@ -0,0 +1 @@ +usr/lib/python*/dist-packages/* diff --git a/debian/rules b/debian/rules new file mode 100755 index 00000000..fa1ae9f4 --- /dev/null +++ b/debian/rules @@ -0,0 +1,24 @@ +#!/usr/bin/make -f +# -*- makefile -*- + +# Uncomment this to turn on verbose mode. +#export DH_VERBOSE=1 + +# This has to be exported to make some magic below work. +export DH_OPTIONS + + +%: + dh $@ --with python2 + +override_dh_install: + txt2man -d 'June 2014' -t ryu-manager -v "Ryu Manager's Manual" -s 8 < debian/ryu-manager.8.txt > debian/ryu-manager.8 + txt2man -d 'June 2014' -t ryu -v "Ryu Command's Manual" -s 8 < debian/ryu.8.txt > debian/ryu.8 + dh_install --fail-missing -X/usr/etc -X/usr/bin/quantum + +override_dh_installinit: + dh_installinit --no-start --name=ryu + +override_dh_installlogrotate: + dh_installlogrotate --name=ryu + diff --git a/debian/ryu-bin.dirs b/debian/ryu-bin.dirs new file mode 100644 index 00000000..d1ca8ae8 --- /dev/null +++ b/debian/ryu-bin.dirs @@ -0,0 +1 @@ +/var/log/ryu diff --git a/debian/ryu-bin.install b/debian/ryu-bin.install new file mode 100644 index 00000000..e101cdbf --- /dev/null +++ b/debian/ryu-bin.install @@ -0,0 +1,4 @@ +usr/bin/ryu-manager usr/bin +usr/bin/ryu usr/bin +debian/ryu.conf etc/ryu +debian/log.conf etc/ryu diff --git a/debian/ryu-bin.manpages b/debian/ryu-bin.manpages new file mode 100644 index 00000000..2ad00552 --- /dev/null +++ b/debian/ryu-bin.manpages @@ -0,0 +1,2 @@ +debian/ryu-manager.8 +debian/ryu.8 diff --git a/debian/ryu-bin.postrm b/debian/ryu-bin.postrm new file mode 100644 index 00000000..3ca3d006 --- /dev/null +++ b/debian/ryu-bin.postrm @@ -0,0 +1,2 @@ +update-rc.d -f ryu remove >/dev/null || exit $? +#DEBHELPER# diff --git a/debian/ryu-bin.ryu.logrotate b/debian/ryu-bin.ryu.logrotate new file mode 100644 index 00000000..2801ccbf --- /dev/null +++ b/debian/ryu-bin.ryu.logrotate @@ -0,0 +1,7 @@ +/var/log/ryu/ryu.log { + daily + missingok + compress + delaycompress + notifempty +} diff --git a/debian/ryu-bin.ryu.upstart b/debian/ryu-bin.ryu.upstart new file mode 100644 index 00000000..327f7076 --- /dev/null +++ b/debian/ryu-bin.ryu.upstart @@ -0,0 +1,9 @@ +description "Ryu server" + +start on (starting neutron-server or runlevel [2345]) +stop on runlevel [!2345] + +respawn + +exec start-stop-daemon --start --exec /usr/bin/ryu -- \ + run --config-file /etc/ryu/ryu.conf diff --git a/debian/ryu-manager.8.txt b/debian/ryu-manager.8.txt new file mode 100644 index 00000000..c2270eb2 --- /dev/null +++ b/debian/ryu-manager.8.txt @@ -0,0 +1,124 @@ +NAME + ryu-manager - management for Ryu application + +SYNOPSIS + ryu-manager [-h] + [--app-lists APP_LISTS] [--ca-certs CA_CERTS] + [--config-dir DIR] [--config-file PATH] + [--ctl-cert CTL_CERT] [--ctl-privkey CTL_PRIVKEY] + [--default-log-level DEFAULT_LOG_LEVEL] [--explicit-drop] + [--install-lldp-flow] [--log-config-file LOG_CONFIG_FILE] + [--log-dir LOG_DIR] [--log-file LOG_FILE] + [--log-file-mode LOG_FILE_MODE] + [--neutron-admin-auth-url NEUTRON_ADMIN_AUTH_URL] + [--neutron-admin-password NEUTRON_ADMIN_PASSWORD] + [--neutron-admin-tenant-name NEUTRON_ADMIN_TENANT_NAME] + [--neutron-admin-username NEUTRON_ADMIN_USERNAME] + [--neutron-auth-strategy NEUTRON_AUTH_STRATEGY] + [--neutron-controller-addr NEUTRON_CONTROLLER_ADDR] + [--neutron-url NEUTRON_URL] + [--neutron-url-timeout NEUTRON_URL_TIMEOUT] + [--noexplicit-drop] [--noinstall-lldp-flow] + [--noobserve-links] [--nouse-stderr] [--nouse-syslog] + [--noverbose] [--observe-links] + [--ofp-listen-host OFP_LISTEN_HOST] + [--ofp-ssl-listen-port OFP_SSL_LISTEN_PORT] + [--ofp-tcp-listen-port OFP_TCP_LISTEN_PORT] [--use-stderr] + [--use-syslog] [--verbose] [--version] + [--wsapi-host WSAPI_HOST] [--wsapi-port WSAPI_PORT] + [--test-switch-dir TEST-SWITCH_DIR] + [--test-switch-target TEST-SWITCH_TARGET] + [--test-switch-tester TEST-SWITCH_TESTER] + [app [app ...]] + +DESCRIPTION + ryu-manager is the executable for Ryu applications. ryu-manager loads + Ryu applications and run it. + + 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. + +OPTIONS + app application module name to run + + -h, --help show this help message and exit + --app-lists APP_LISTS + application module name to run + --ca-certs CA_CERTS CA certificates + --config-dir DIR Path to a config directory to pull *.conf files from. + This file set is sorted, so as to provide a + predictable parse order if individual options are + over-ridden. The set is parsed after the file(s) + specified via previous --config-file, arguments hence + over-ridden options in the directory take precedence. + --config-file PATH Path to a config file to use. Multiple config files + can be specified, with values in later files taking + precedence. The default files used are: None + --ctl-cert CTL_CERT controller certificate + --ctl-privkey CTL_PRIVKEY + controller private key + --default-log-level DEFAULT_LOG_LEVEL + default log level + --explicit-drop link discovery: explicitly drop lldp packet in + --install-lldp-flow link discovery: explicitly install flow entry to send + lldp packet to controller + --log-config-file LOG_CONFIG_FILE + Path to a logging config file to use + --log-dir LOG_DIR log file directory + --log-file LOG_FILE log file name + --log-file-mode LOG_FILE_MODE + default log file permission + --neutron-admin-auth-url NEUTRON_ADMIN_AUTH_URL + auth url for connecting to neutron in admin context + --neutron-admin-password NEUTRON_ADMIN_PASSWORD + password for connecting to neutron in admin context + --neutron-admin-tenant-name NEUTRON_ADMIN_TENANT_NAME + tenant name for connecting to neutron in admin context + --neutron-admin-username NEUTRON_ADMIN_USERNAME + username for connecting to neutron in admin context + --neutron-auth-strategy NEUTRON_AUTH_STRATEGY + auth strategy for connecting to neutron in + admincontext + --neutron-controller-addr NEUTRON_CONTROLLER_ADDR + openflow method:address:port to set controller ofovs + bridge + --neutron-url NEUTRON_URL + URL for connecting to neutron + --neutron-url-timeout NEUTRON_URL_TIMEOUT + timeout value for connecting to neutron in seconds + --noexplicit-drop The inverse of --explicit-drop + --noinstall-lldp-flow + The inverse of --install-lldp-flow + --noobserve-links The inverse of --observe-links + --nouse-stderr The inverse of --use-stderr + --nouse-syslog The inverse of --use-syslog + --noverbose The inverse of --verbose + --observe-links observe link discovery events. + --ofp-listen-host OFP_LISTEN_HOST + openflow listen host + --ofp-ssl-listen-port OFP_SSL_LISTEN_PORT + openflow ssl listen port + --ofp-tcp-listen-port OFP_TCP_LISTEN_PORT + openflow tcp listen port + --use-stderr log to standard error + --use-syslog output to syslog + --verbose show debug output + --version show program's version number and exit + --wsapi-host WSAPI_HOST + webapp listen host + --wsapi-port WSAPI_PORT + webapp listen port + + --test-switch-dir TEST-SWITCH_DIR + test files directory + --test-switch-target TEST-SWITCH_TARGET + target sw dp-id + --test-switch-tester TEST-SWITCH_TESTER + tester sw dp-id + +AUTHOR + Ryu Project Team diff --git a/debian/ryu.8.txt b/debian/ryu.8.txt new file mode 100644 index 00000000..11855d72 --- /dev/null +++ b/debian/ryu.8.txt @@ -0,0 +1,38 @@ +NAME + ryu - management for Ryu application + +SYNOPSIS + ryu [-h] [--config-dir DIR] [--config-file PATH] [--version] + [subcommand] ... + +DESCRIPTION + ryu is the executable for Ryu applications. ryu loads a sub-module + corresponding to the sub-command and run it. 'run' sub-command is an + equivalent to ryu-manager. + + 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. + + +OPTIONS + subcommand [rpc-cli|run|of-config-cli] + subcommand_args subcommand specific arguments + + -h, --help show this help message and exit + --config-dir DIR Path to a config directory to pull *.conf files from. + This file set is sorted, so as to provide a predictable + parse order if individual options are over-ridden. The + set is parsed after the file(s) specified via previous + --config-file, arguments hence over-ridden options in + the directory take precedence. + --config-file PATH Path to a config file to use. Multiple config files can + be specified, with values in later files taking + precedence. The default files used are: None + --version show program's version number and exit + +AUTHOR + Ryu Project Team diff --git a/debian/ryu.conf b/debian/ryu.conf new file mode 100644 index 00000000..1155af42 --- /dev/null +++ b/debian/ryu.conf @@ -0,0 +1,36 @@ +[DEFAULT] +log_config_file=/etc/ryu/log.conf +# app_lists = $RYU_APPS +# +# for OpenStack Neutron Ryu plugin: +# mac address based isolation +#app_lists = ryu.app.simple_isolation,ryu.app.rest +# VLAN +#app_lists=ryu.app.quantum_adapter,ryu.app.rest,ryu.app.rest_conf_switch,ryu.app.rest_quantum,ryu.app.rest_tunnel,ryu.app.simple_vlan +# GRE tunneling +#app_lists=ryu.app.gre_tunnel,ryu.app.quantum_adapter,ryu.app.rest,ryu.app.rest_conf_switch,ryu.app.rest_quantum,ryu.app.rest_tunnel,ryu.app.tunnel_port_updater +# +# wsapi_host= +# wsapi_port= +# ofp_listen_host= +# ofp_tcp_listen_port= +#wsapi_host = 0.0.0.0 +#wsapi_port = 8080 +#ofp_listen_host = 0.0.0.0 +#ofp_tcp_listen_port = 6633 +# +# the followings must be set according to neutron settings +# neutron_url = http://$Q_HOST:$Q_PORT +# neutron_admin_username = $Q_ADMIN_USERNAME +# neutron_admin_password = $SERVICE_PASSWORD +# neutron_admin_tenant_name = $SERVICE_TENANT_NAME +# neutron_admin_auth_url=$KEYSTONE_SERVICE_PROTOCOL://$KEYSTONE_SERVICE_HOST:$KEYSTONE_AUTH_PORT/v2.0 +# neutron_auth_strategy = $Q_AUTH_STRATEGY +# neutron_controller_addr = tcp:$RYU_OFP_HOST:$RYU_OFP_PORT +#neutron_url = http://192.168.0.1:9696 +#neutron_admin_username = admin +#neutron_admin_password = password +#neutron_admin_tenant_name = service +#neutron_admin_auth_url = http://192.168.0.1:5000/v2.0 +#neutron_auth_strategy = keystone +#neutron_controller_addr = tcp:192.168.0.1:6633 diff --git a/debian/source/format b/debian/source/format new file mode 100644 index 00000000..163aaf8d --- /dev/null +++ b/debian/source/format @@ -0,0 +1 @@ +3.0 (quilt) -- cgit v1.2.3