doc: add test-vrrp page
port from wiki page. Signed-off-by: Yoshihiro Kaneko <ykaneko0929@gmail.com> Signed-off-by: FUJITA Tomonori <fujita.tomonori@lab.ntt.co.jp>
This commit is contained in:
Yoshihiro Kaneko
FUJITA Tomonori
parent
f0df43b4b3
commit
6eb3417388
@ -15,6 +15,7 @@ Contents:
|
|||||||
getting_started.rst
|
getting_started.rst
|
||||||
developing.rst
|
developing.rst
|
||||||
configuration.rst
|
configuration.rst
|
||||||
|
tests.rst
|
||||||
using_with_openstack.rst
|
using_with_openstack.rst
|
||||||
|
|
||||||
Indices and tables
|
Indices and tables
|
||||||
|
|||||||
217
doc/source/test-vrrp.rst
Normal file
217
doc/source/test-vrrp.rst
Normal file
@ -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()
|
||||||
7
doc/source/tests.rst
Normal file
7
doc/source/tests.rst
Normal file
@ -0,0 +1,7 @@
|
|||||||
|
*****
|
||||||
|
Tests
|
||||||
|
*****
|
||||||
|
|
||||||
|
.. toctree::
|
||||||
|
|
||||||
|
test-vrrp.rst
|
||||||
Loading…
Reference in New Issue
Block a user