port from wiki page.
Signed-off-by: Yoshihiro Kaneko <ykaneko0...@gmail.com>
---
doc/source/index.rst | 1 +
doc/source/test-vrrp.rst | 217 ++++++++++++++++++++++++++++++++++++++++++++++
doc/source/tests.rst | 7 ++
3 files changed, 225 insertions(+)
create mode 100644 doc/source/test-vrrp.rst
create mode 100644 doc/source/tests.rst
diff --git a/doc/source/index.rst b/doc/source/index.rst
index c443bc6..c9a0cb4 100644
--- a/doc/source/index.rst
+++ b/doc/source/index.rst
@@ -15,6 +15,7 @@ Contents:
getting_started.rst
developing.rst
configuration.rst
+ tests.rst
using_with_openstack.rst
Indices and tables
diff --git a/doc/source/test-vrrp.rst b/doc/source/test-vrrp.rst
new file mode 100644
index 0000000..6e3783a
--- /dev/null
+++ b/doc/source/test-vrrp.rst
@@ -0,0 +1,217 @@
+===================
+Testing VRRP Module
+===================
+
+This page describes how to test Ryu VRRP service
+
+Running integrated tests
+========================
+
+Some testing scripts are available.
+
+* ryu/tests/integrated/test_vrrp_linux_multi.py
+* ryu/tests/integrated/test_vrrp_multi.py
+
+Each files include how to run in the comment.
+Please refer to it.
+
+
+Running multiple Ryu VRRP in network namespace
+==============================================
+
+The following command lines set up necessary bridges and interfaces.
+
+And then run RYU-VRRP::
+
+ # ip netns add gateway1
+ # ip netns add gateway2
+
+ # brctl addbr vrrp-br0
+ # brctl addbr vrrp-br1
+
+ # ip link add veth0 type veth peer name veth0-br0
+ # ip link add veth1 type veth peer name veth1-br0
+ # ip link add veth2 type veth peer name veth2-br0
+ # ip link add veth3 type veth peer name veth3-br1
+ # ip link add veth4 type veth peer name veth4-br1
+ # ip link add veth5 type veth peer name veth5-br1
+
+ # brctl addif vrrp-br0 veth0-br0
+ # brctl addif vrrp-br0 veth1-br0
+ # brctl addif vrrp-br0 veth2-br0
+ # brctl addif vrrp-br1 veth3-br1
+ # brctl addif vrrp-br1 veth4-br1
+ # brctl addif vrrp-br1 veth5-br1
+
+ # ip link set vrrp-br0 up
+ # ip link set vrrp-br1 up
+
+ # ip link set veth0 up
+ # ip link set veth0-br0 up
+ # ip link set veth1-br0 up
+ # ip link set veth2-br0 up
+ # ip link set veth3-br1 up
+ # ip link set veth4-br1 up
+ # ip link set veth5 up
+ # ip link set veth5-br1 up
+
+ # ip link set veth1 netns gateway1
+ # ip link set veth2 netns gateway2
+ # ip link set veth3 netns gateway1
+ # ip link set veth4 netns gateway2
+
+ # ip netns exec gateway1 ip link set veth1 up
+ # ip netns exec gateway2 ip link set veth2 up
+ # ip netns exec gateway1 ip link set veth3 up
+ # ip netns exec gateway2 ip link set veth4 up
+
+ # ip netns exec gateway1 .ryu-vrrp veth1 '10.0.0.2' 254
+ # ip netns exec gateway2 .ryu-vrrp veth2 '10.0.0.3' 100
+
+
+.. admonition:: Caveats
+
+ Please make sure that all interfaces and bridges are UP.
+ Don't forget interfaces in netns gateway1/gateway2.
+
+::
+
+ ^ veth5
+ |
+ V veth5-br1
+ -----------------------
+ |Linux Brirge vrrp-br1|
+ -----------------------
+ veth3-br1^ ^ veth4-br1
+ | |
+ veth3V V veth4
+ ---------- ----------
+ |netns | |netns |
+ |gateway1| |gateway2|
+ |ryu-vrrp| |ryu-vrrp|
+ ---------- ----------
+ veth1^ ^ veth2
+ | |
+ veth1-br0V V veth2-br0
+ -----------------------
+ |Linux Brirge vrrp-br0|
+ -----------------------
+ ^ veth0-br0
+ |
+ V veth0
+
+
+
+Here's the helper executable, ryu-vrrp::
+
+ #!/usr/bin/env python
+ #
+ # Copyright (C) 2013 Nippon Telegraph and Telephone Corporation.
+ # Copyright (C) 2013 Isaku Yamahata <yamahata at valinux co jp>
+ #
+ # 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.
+
+ from ryu.lib import hub
+ hub.patch()
+
+ # TODO:
+ # Right now, we have our own patched copy of ovs python bindings
+ # Once our modification is upstreamed and widely deployed,
+ # use it
+ #
+ # NOTE: this modifies sys.path and thus affects the following imports.
+ # eg. oslo.config.cfg.
+ import ryu.contrib
+
+ from oslo.config import cfg
+ import logging
+ import netaddr
+ import sys
+ import time
+
+ from ryu import log
+ log.early_init_log(logging.DEBUG)
+
+ from ryu import flags
+ from ryu import version
+ from ryu.base import app_manager
+ from ryu.controller import controller
+ from ryu.lib import mac as lib_mac
+ from ryu.lib.packet import vrrp
+ from ryu.services.protocols.vrrp import api as vrrp_api
+ from ryu.services.protocols.vrrp import event as vrrp_event
+
+
+ CONF = cfg.CONF
+
+ _VRID = 7
+ _IP_ADDRESS = '10.0.0.1'
+ _PRIORITY = 100
+
+
+ class VRRPTestRouter(app_manager.RyuApp):
+ def __init__(self, *args, **kwargs):
+ super(VRRPTestRouter, self).__init__(*args, **kwargs)
+ print args
+ self.logger.debug('vrrp_config %s', args)
+ self._ifname = args[0]
+ self._primary_ip_address = args[1]
+ self._priority = int(args[2])
+
+ def start(self):
+ print 'start'
+ hub.spawn(self._main)
+
+ def _main(self):
+ print self
+ interface = vrrp_event.VRRPInterfaceNetworkDevice(
+ lib_mac.DONTCARE, self._primary_ip_address, None, self._ifname)
+ self.logger.debug('%s', interface)
+
+ ip_addresses = [_IP_ADDRESS]
+ config = vrrp_event.VRRPConfig(
+ version=vrrp.VRRP_VERSION_V3, vrid=_VRID,
priority=self._priority,
+ ip_addresses=ip_addresses)
+ self.logger.debug('%s', config)
+
+ rep = vrrp_api.vrrp_config(self, interface, config)
+ self.logger.debug('%s', rep)
+
+
+ def main():
+ vrrp_config = sys.argv[-3:]
+ sys.argv = sys.argv[:-3]
+ CONF(project='ryu', version='ryu-vrrp %s' % version)
+
+ log.init_log()
+ # always enable ofp for now.
+ app_lists = ['ryu.services.protocols.vrrp.manager',
+ 'ryu.services.protocols.vrrp.dumper',
+ 'ryu.services.protocols.vrrp.sample_manager']
+
+ app_mgr = app_manager.AppManager.get_instance()
+ app_mgr.load_apps(app_lists)
+ contexts = app_mgr.create_contexts()
+ app_mgr.instantiate_apps(**contexts)
+ vrrp_router = app_mgr.instantiate(VRRPTestRouter, *vrrp_config,
**contexts)
+ vrrp_router.start()
+
+ while True:
+ time.sleep(999999)
+
+ app_mgr.close()
+
+
+ if __name__ == "__main__":
+ main()
diff --git a/doc/source/tests.rst b/doc/source/tests.rst
new file mode 100644
index 0000000..da58f0e
--- /dev/null
+++ b/doc/source/tests.rst
@@ -0,0 +1,7 @@
+*****
+Tests
+*****
+
+.. toctree::
+
+ test-vrrp.rst
--
1.7.9.5
------------------------------------------------------------------------------
Time is money. Stop wasting it! Get your web API in 5 minutes.
www.restlet.com/download
http://p.sf.net/sfu/restlet
_______________________________________________
Ryu-devel mailing list
Ryu-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/ryu-devel
