Difference between revisions of "Vnx-plugin-ospf"
(→OSPF Plugin Example Scenario) |
(→OSPF Plugin Example Scenario) |
||
| Line 96: | Line 96: | ||
</pre> | </pre> | ||
| + | For example, you can stop | ||
=== Scenario Specification === | === Scenario Specification === | ||
Revision as of 11:25, 11 September 2011
OSPF Plugin
...to be completed...
Authors: David Fernández (david at dit.upm.es) Miguel Ferrer (mferrer at dit.upm.es) Francisco Jose Martin (fjmarin at dit.upm.es) Fermín Galán (galan at dit.upm.es) version 2.0, September 11th, 2011
Contents
Introduction
OSPF plugin is an example VNX extension plugin designed to facilitate the configuration of OSPF in virtual machines. It provides a simple XML language to express OSPF configurations which are independent of the OSPF implementation used in the virtual machine. At present, OSPF Plugin is implemented only for quagga based OSPF routers, but can be extended to support other OSPF implementations.
To use OSPF plugin in a VNX scenario, you have to add the following tag after <vm_defaults> section of <global> tag:
<extension plugin="ospf" conf="ospfd_conf.xml" />
The plugin configuration file or PCF contains the OSPF configuration written in a XML language. Using that language the configuration of a router looks like:
...
<vm name="r1" type="quagga" subtype="lib-install">
<hostname>r1</hostname>
<password>xxxx</password>
<network area="0.0.0.0">10.0.0.0/16</network>
<passive_if>eth1</passive_if>
<binaries>
<zebra>/usr/lib/quagga/zebra</zebra>
<ospfd>/usr/lib/quagga/ospfd</ospfd>
</binaries>
</vm>
...
OSPF plugin just processes that configuration and translates it into the necessary quagga configuration files (zebra.conf and ospfd.conf) and manages the routing daemons. See the complete example below to know more about OSPF plugin capabilities.
OSPF Plugin Example Scenario
OSPF Plugin example is a simple scenario made of two routers (r1 and r2) and two hosts (h1 and h2) designed to show the capabilities of the plugin. The example is included in VNX distribution.
To start the scenario, just type:
cd /usr/share/vnx/plugins/examples vnx -f example_ospf-plugin.xml -v -t
Once started, you can check the conectivity among h1 and h2 hosts:
root@h1:~# traceroute -n 10.0.2.2 traceroute to 10.0.2.2 (10.0.2.2), 30 hops max, 60 byte packets 1 10.0.1.1 2.520 ms 2.388 ms 2.297 ms 2 10.0.0.2 2.214 ms 2.133 ms 2.059 ms 3 10.0.2.2 1.939 ms 1.502 ms 0.779 ms
To know the scenario commands made available to the user by the plugin, you can use the "exe-info" mode of VNX:
# vnx -f example_ospf-plugin.xml --exe-info ---------------------------------------------------------------------------------- Virtual Networks over LinuX (VNX) -- http://www.dit.upm.es/vnx - vnx@dit.upm.es Version: 2.0b.893 (built on 11/09/2011_03:14) ---------------------------------------------------------------------------------- Using configuration file: /etc/vnx.conf TMP dir=/tmp VNX dir=/root/.vnx ---------------------------------------------------------------------------------- VNX exe-info mode: User-defined command sequences for scenario 'example_ospf-plugin' ---------------------------------------------------------------------------------- stop-www Stop apache2 web server start-www Start apache2 web server Plugin 'ospf' command sequences for scenario 'example_ospf-plugin' ---------------------------------------------------------------------------------- restart Restarts OSPF daemons stop Stops OSPF daemons ospf-redoconf Plugin specific synonym of 'redoconf' ospf-restart Plugin specific synonym of 'restart' ospf-stop Plugin specific synonym of 'stop' on_shutdown Stops OSPF daemons (executed before shutdown) on_boot Creates OSPF config files and starts daemons (executed after startup) ospf-on_boot Plugin specific synonym of 'on_boot' redoconf Recreate the OSPF config files ospf-start Plugin specific synonym of 'start' start Starts OSPF daemons ---------------------------------------------------------------------------------- Total time elapsed: 0 seconds
For example, you can stop
Scenario Specification
<?xml version="1.0" encoding="UTF-8"?>
<!--
~~~~~~~~~~~~~~~~~~~~
VNX Sample scenarios
~~~~~~~~~~~~~~~~~~~~
Name: example_ospf-plugin
Description: Example scenario to show the use of ospf plugin. It is made of two
routers: r1 (ubuntu) and r2(uml) and two hosts: h1 (ubuntu) and h2 (uml).
This file is part of the Virtual Networks over LinuX (VNX) Project distribution.
(www: http://www.dit.upm.es/vnx - e-mail: vnx@dit.upm.es)
Departamento de Ingenieria de Sistemas Telematicos (DIT)
Universidad Politecnica de Madrid
SPAIN
-->
<vnx xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="/usr/share/xml/vnx/vnx-2.00.xsd">
<global>
<version>2.0</version>
<scenario_name>example_ospf-plugin</scenario_name>
<ssh_key>~/.ssh/id_dsa.pub</ssh_key>
<automac offset="4"/>
<!--vm_mgmt type="none" /-->
<vm_mgmt type="private" network="10.250.0.0" mask="24" offset="16">
<host_mapping />
</vm_mgmt>
<vm_defaults>
<console id="0" display="no"/>
<console id="1" display="yes"/>
</vm_defaults>
<extension plugin="ospf" conf="example_ospf-plugin-conf.xml" />
</global>
<net name="lan1" mode="virtual_bridge" />
<net name="lan2" mode="virtual_bridge" />
<net name="ptp12" mode="virtual_bridge" />
<!-- NODES -->
<vm name="r1" type="libvirt" subtype="kvm" os="linux" exec_mode="cdrom">
<filesystem type="cow">/usr/share/vnx/filesystems/rootfs_ubuntu</filesystem>
<mem>256M</mem>
<if id="1" net="lan1">
<ipv4>10.0.1.1/24</ipv4>
<ipv6>2001:db8:1::1/64</ipv6>
</if>
<if id="2" net="ptp12">
<ipv4>10.0.0.1/30</ipv4>
<ipv6>2001:db8:12::1/64</ipv6>
</if>
<forwarding type="ip" />
</vm>
<vm name="r2" type="uml" subtype="" os="" exec_mode="mconsole">
<filesystem type="cow">/usr/share/vnx/filesystems/rootfs_uml</filesystem>
<mem>64M</mem>
<kernel>/usr/share/vnx/kernels/linux</kernel>
<if id="1" net="lan2" name="fxp0">
<ipv4>10.0.2.1/24</ipv4>
<ipv6>2001:db8:2::1/64</ipv6>
</if>
<if id="2" net="ptp12" name="fxp1">
<ipv4>10.0.0.2/30</ipv4>
<ipv6>2001:db8:12::2/64</ipv6>
</if>
<forwarding type="ip" />
</vm>
<vm name="h1" type="libvirt" subtype="kvm" os="linux" exec_mode="cdrom">
<filesystem type="cow">/usr/share/vnx/filesystems/rootfs_ubuntu</filesystem>
<mem>256M</mem>
<if id="1" net="lan1">
<ipv4>10.0.1.2/24</ipv4>
<ipv6>2001:db8:1::2/64</ipv6>
</if>
<route type="ipv4" gw="10.0.1.1">default</route>
<route type="ipv6" gw="2001:db8:1::1">default</route>
</vm>
<vm name="h2" type="uml" exec_mode="mconsole">
<filesystem type="cow">/usr/share/vnx/filesystems/rootfs_uml</filesystem>
<mem>64M</mem>
<kernel>/usr/share/vnx/kernels/linux</kernel>
<if id="1" net="lan2">
<ipv4>10.0.2.2/24</ipv4>
<ipv6>2001:db8:2::2/64</ipv6>
</if>
<route type="ipv4" gw="10.0.2.1">default</route>
<route type="ipv6" gw="2001:db8:2::1">default</route>
</vm>
<host>
<hostif net="lan1">
<ipv4>10.0.1.3/24</ipv4>
<ipv6>2001:db8:1::3/64</ipv6>
</hostif>
<route type="ipv4" gw="10.0.1.1">10.0.0.0/16</route>
<route type="ipv6" gw="2001:db8:1::1">2001:db8::/32</route>
</host>
</vnx>
Plugin Configuration File (PCF)
<ospf_conf xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="/usr/share/xml/vnx/ospf.xsd">
<vm name="r1" type="quagga" subtype="lib-install">
<hostname>r1</hostname>
<password>xxxx</password>
<network area="0.0.0.0">10.0.0.0/16</network>
<passive_if>eth1</passive_if>
<binaries>
<zebra>/usr/lib/quagga/zebra</zebra>
<ospfd>/usr/lib/quagga/ospfd</ospfd>
</binaries>
</vm>
<vm name="r2" type="quagga" subtype="lib-install">
<hostname>r2</hostname>
<password>xxxx</password>
<network area="0.0.0.0">10.0.0.0/16</network>
<passive_if>eth1</passive_if>
</vm>
</ospf_conf>
