Difference between revisions of "Example-basic"
(→Scenario) |
|||
| (6 intermediate revisions by 2 users not shown) | |||
| Line 5: | Line 5: | ||
'''Fermín Galán (galan at dit.upm.es)''' | '''Fermín Galán (galan at dit.upm.es)''' | ||
'''David Fernández (david at dit.upm.es)''' | '''David Fernández (david at dit.upm.es)''' | ||
| − | '''version 1. | + | '''version 1.8, October 3rd, 2007''' |
</big> | </big> | ||
| Line 21: | Line 21: | ||
In both examples xterm consoles are disabled, so you have to access virtual machines using ssh from the host, for example: | In both examples xterm consoles are disabled, so you have to access virtual machines using ssh from the host, for example: | ||
| − | slogin uml1 | + | host> slogin uml1 |
<center> | <center> | ||
| Line 39: | Line 39: | ||
<?xml version="1.0" encoding="UTF-8"?> | <?xml version="1.0" encoding="UTF-8"?> | ||
| − | <!DOCTYPE vnuml SYSTEM "/usr/share/xml/vnuml/vnuml.dtd" | + | <!DOCTYPE vnuml SYSTEM "/usr/share/xml/vnuml/vnuml.dtd" [ |
| − | [ | ||
<!ENTITY VNUMLDIR "/usr/share/vnuml/"> | <!ENTITY VNUMLDIR "/usr/share/vnuml/"> | ||
<!ENTITY BASEDIR "/usr/share/vnuml/examples/basic/"> | <!ENTITY BASEDIR "/usr/share/vnuml/examples/basic/"> | ||
<!ENTITY REDIR "</dev/null >/dev/null 2>&1 &"> | <!ENTITY REDIR "</dev/null >/dev/null 2>&1 &"> | ||
]> | ]> | ||
| − | |||
<vnuml> | <vnuml> | ||
<global> | <global> | ||
| − | <version>1. | + | <version>1.8</version> |
<simulation_name>basic</simulation_name> | <simulation_name>basic</simulation_name> | ||
<ssh_key>/root/.ssh/identity.pub</ssh_key> | <ssh_key>/root/.ssh/identity.pub</ssh_key> | ||
| Line 59: | Line 57: | ||
<filesystem type="cow">&VNUMLDIR;filesystems/root_fs_tutorial</filesystem> | <filesystem type="cow">&VNUMLDIR;filesystems/root_fs_tutorial</filesystem> | ||
<kernel>&VNUMLDIR;kernels/linux</kernel> | <kernel>&VNUMLDIR;kernels/linux</kernel> | ||
| − | <shell>/bin/sh</shell> | + | <shell>/bin/sh</shell> |
</vm_defaults> | </vm_defaults> | ||
</global> | </global> | ||
| Line 74: | Line 72: | ||
</if> | </if> | ||
<route type="ipv4" gw="10.0.0.3">default</route> | <route type="ipv4" gw="10.0.0.3">default</route> | ||
| − | <filetree root="/" | + | <filetree root="/" seq="start">/tmp/uml1-conf</filetree> |
<exec seq="start" type="verbatim">ls</exec> | <exec seq="start" type="verbatim">ls</exec> | ||
<exec seq="start" type="verbatim">pwd</exec> | <exec seq="start" type="verbatim">pwd</exec> | ||
| Line 148: | Line 146: | ||
<global> | <global> | ||
| − | <version>1. | + | <version>1.8</version> |
<simulation_name>basic</simulation_name> | <simulation_name>basic</simulation_name> | ||
<ssh_key>/root/.ssh/identity.pub</ssh_key> | <ssh_key>/root/.ssh/identity.pub</ssh_key> | ||
| Line 173: | Line 171: | ||
</if> | </if> | ||
<route type="ipv6" gw="2001:db8:0::3">2000::/3</route> | <route type="ipv6" gw="2001:db8:0::3">2000::/3</route> | ||
| − | <filetree root="/" | + | <filetree root="/" seq="start">/tmp/uml1-conf</filetree> |
<exec seq="start" type="verbatim">ls</exec> | <exec seq="start" type="verbatim">ls</exec> | ||
<exec seq="start" type="verbatim">pwd</exec> | <exec seq="start" type="verbatim">pwd</exec> | ||
| Line 181: | Line 179: | ||
</vm> | </vm> | ||
| − | <vm name="uml2"> | + | <vm name="uml2"> |
<if id="1" net="Net0"> | <if id="1" net="Net0"> | ||
<ipv6>2001:db8:0::2/64</ipv6> | <ipv6>2001:db8:0::2/64</ipv6> | ||
| Line 188: | Line 186: | ||
</vm> | </vm> | ||
| − | <vm name="uml3"> | + | <vm name="uml3"> |
<if id="1" net="Net0"> | <if id="1" net="Net0"> | ||
<ipv6>2001:db8:0::3/64</ipv6> | <ipv6>2001:db8:0::3/64</ipv6> | ||
| Line 204: | Line 202: | ||
</vm> | </vm> | ||
| − | <vm name="uml4"> | + | <vm name="uml4"> |
<if id="1" net="Net1"> | <if id="1" net="Net1"> | ||
<ipv6>2001:db8:1::4/64</ipv6> | <ipv6>2001:db8:1::4/64</ipv6> | ||
| Line 244: | Line 242: | ||
* [http://jungla.dit.upm.es/~vnuml/doc/examples/basic/1.3/tutorial.html 1.3] (note that in this version the example was named "Tutorial" instead of "Basic"). | * [http://jungla.dit.upm.es/~vnuml/doc/examples/basic/1.3/tutorial.html 1.3] (note that in this version the example was named "Tutorial" instead of "Basic"). | ||
* [http://jungla.dit.upm.es/~vnuml/doc/examples/basic/1.6/basic.html 1.6]<br /> | * [http://jungla.dit.upm.es/~vnuml/doc/examples/basic/1.6/basic.html 1.6]<br /> | ||
| + | * [[Example-basic-1.7|1.7]] | ||
Latest revision as of 11:00, 3 October 2007
VNUML Basic Example
Authors: Fermín Galán (galan at dit.upm.es) David Fernández (david at dit.upm.es) version 1.8, October 3rd, 2007
Scenario
The following example builds the basic topology shown in the figures. We provide an IPv4 version and an IPv6 version. The IPv6 version is slightly different; it uses the eth0 host interface as external connection for UML3.
Note that the /tmp/uml1-conf directory must exists in the host machine in order for the <filetree> tag to work in UML1 (for example, you can create it with 'mkdir /tmp/uml1-conf' and create and empty file inside with 'touch /tmp/uml1-conf/foobar.conf' to test). In addition, the <exec> tags are intented to test the command execution mode (more information in the User Manual). For example, use 'vnumlparser.pl -x start@basic.xml -v' to run the commands with seq="start" (in addition, the content of /root/uml1-conf directory will be copied to the virtual machine uml1) and 'vnumlparser.pl -x stop@basic.xml -v' to run the commands with seq="stop".
Before running the IPv6 version you have to edit the specification and change the IP data inside the <host> section to reflect your settings (in this example, 10.1.1.200/24 is the address/mask of the host and 10.1.1.1 the ip address of the router).
In both examples xterm consoles are disabled, so you have to access virtual machines using ssh from the host, for example:
host> slogin uml1
Figure 1: Basic IPv4 scenario
Figure 2: Basic IPv6 scenario
VNUML Description (IPv4)
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE vnuml SYSTEM "/usr/share/xml/vnuml/vnuml.dtd" [
<!ENTITY VNUMLDIR "/usr/share/vnuml/">
<!ENTITY BASEDIR "/usr/share/vnuml/examples/basic/">
<!ENTITY REDIR "</dev/null >/dev/null 2>&1 &">
]>
<vnuml>
<global>
<version>1.8</version>
<simulation_name>basic</simulation_name>
<ssh_key>/root/.ssh/identity.pub</ssh_key>
<automac offset="0"/>
<vm_mgmt type="private" network="192.168.0.0" mask="24" offset="100">
<host_mapping/>
</vm_mgmt>
<vm_defaults>
<filesystem type="cow">&VNUMLDIR;filesystems/root_fs_tutorial</filesystem>
<kernel>&VNUMLDIR;kernels/linux</kernel>
<shell>/bin/sh</shell>
</vm_defaults>
</global>
<net name="Net0" mode="uml_switch"/>
<net name="Net1" mode="uml_switch"/>
<net name="Net2" mode="uml_switch"/>
<net name="Net3" mode="virtual_bridge"/>
<vm name="uml1">
<mem>50M</mem>
<if id="1" net="Net0">
<ipv4>10.0.0.1</ipv4>
</if>
<route type="ipv4" gw="10.0.0.3">default</route>
<filetree root="/" seq="start">/tmp/uml1-conf</filetree>
<exec seq="start" type="verbatim">ls</exec>
<exec seq="start" type="verbatim">pwd</exec>
<exec seq="start" type="verbatim">touch /root/example.start</exec>
<exec seq="stop" type="verbatim">rm /root/example.start</exec>
<exec seq="stop" type="verbatim">touch /root/example.stop</exec>
</vm>
<vm name="uml2">
<if id="1" net="Net0">
<ipv4>10.0.0.2</ipv4>
</if>
<route type="ipv4" gw="10.0.0.3">default</route>
</vm>
<vm name="uml3">
<if id="1" net="Net0">
<ipv4>10.0.0.3</ipv4>
</if>
<if id="2" net="Net1">
<ipv4>10.0.1.1</ipv4>
</if>
<if id="3" net="Net3">
<ipv4>10.0.3.1</ipv4>
</if>
<route type="ipv4" gw="10.0.1.2">10.0.2.0/24</route>
<route type="ipv4" gw="10.0.3.2">default</route>
<forwarding type="ip"/>
</vm>
<vm name="uml4">
<if id="1" net="Net1">
<ipv4>10.0.1.2</ipv4>
</if>
<if id="2" net="Net2">
<ipv4>10.0.2.1</ipv4>
</if>
<route type="ipv4" gw="10.0.1.1">default</route>
<forwarding type="ip"/>
</vm>
<vm name="uml5">
<if id="1" net="Net2">
<ipv4 mask="255.255.255.0">10.0.2.2</ipv4>
</if>
<route type="ipv4" gw="10.0.2.1">default</route>
</vm>
<host>
<hostif net="Net3">
<ipv4>10.0.3.2</ipv4>
</hostif>
<route type="ipv4" gw="10.0.3.1">10.0.0.0/16</route>
</host>
</vnuml>
VNUML Description (IPv6)
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE vnuml SYSTEM "/usr/share/xml/vnuml/vnuml.dtd"
[
<!ENTITY VNUMLDIR "/usr/share/vnuml/">
<!ENTITY BASEDIR "/usr/share/vnuml/examples/basic/">
<!ENTITY REDIR "</dev/null >/dev/null 2>&1 &">
]>
<vnuml>
<global>
<version>1.8</version>
<simulation_name>basic</simulation_name>
<ssh_key>/root/.ssh/identity.pub</ssh_key>
<automac offset="0"/>
<vm_mgmt type="private" network="192.168.0.0" mask="24" offset="0">
<host_mapping/>
</vm_mgmt>
<vm_defaults>
<filesystem type="cow">&VNUMLDIR;filesystems/root_fs_tutorial</filesystem>
<kernel>&VNUMLDIR;kernels/linux</kernel>
<shell>/bin/sh</shell>
</vm_defaults>
</global>
<net name="Net0" mode="uml_switch" />
<net name="Net1" mode="uml_switch" />
<net name="Net2" mode="uml_switch" />
<net name="Net3" mode="virtual_bridge" external="eth0" />
<vm name="uml1">
<mem>50M</mem>
<if id="1" net="Net0">
<ipv6>2001:db8:0::1/64</ipv6>
</if>
<route type="ipv6" gw="2001:db8:0::3">2000::/3</route>
<filetree root="/" seq="start">/tmp/uml1-conf</filetree>
<exec seq="start" type="verbatim">ls</exec>
<exec seq="start" type="verbatim">pwd</exec>
<exec seq="start" type="verbatim">touch /root/example.start</exec>
<exec seq="stop" type="verbatim">rm /root/example.start</exec>
<exec seq="stop" type="verbatim">touch /root/example.stop</exec>
</vm>
<vm name="uml2">
<if id="1" net="Net0">
<ipv6>2001:db8:0::2/64</ipv6>
</if>
<route type="ipv6" gw="2001:db8:0::3">2000::/3</route>
</vm>
<vm name="uml3">
<if id="1" net="Net0">
<ipv6>2001:db8:0::3/64</ipv6>
</if>
<if id="2" net="Net1">
<ipv6>2001:db8:1::3/64</ipv6>
</if>
<if id="3" net="Net3">
<ipv6>2001:db8:3::3/64</ipv6>
</if>
<route type="ipv6" gw="2001:db8:1::4">2001:db8:2::/64</route>
<route type="ipv6" gw="2001:db8:3::254">2000::/3</route>
<forwarding type="ipv6"/>
<exec seq="start" type="verbatim">touch filesample</exec>
</vm>
<vm name="uml4">
<if id="1" net="Net1">
<ipv6>2001:db8:1::4/64</ipv6>
</if>
<if id="2" net="Net2">
<ipv6>2001:db8:2::4/64</ipv6>
</if>
<route type="ipv6" gw="2001:db8:1::3">2000::/3</route>
<forwarding type="ipv6"/>
</vm>
<vm name="uml5">
<if id="1" net="Net2">
<ipv6>2001:db8:2::5/64</ipv6>
</if>
<route type="ipv6" gw="2001:db8:2::4">2000::/3</route>
</vm>
<host>
<hostif net="Net3">
<ipv4 mask="255.255.255.0">10.1.1.200</ipv4>
<ipv6>2001:db8:3::254/64</ipv6>
</hostif>
<physicalif name="eth0" type="ipv4" ip="10.1.1.200" mask="255.255.255.0" gw="10.1.1.1"/>
<route type="ipv4" gw="10.1.1.1">default</route>
<route type="ipv6" gw="2001:db8:3::3">2001:db8::/32</route>
</host>
</vnuml>
Download
- VNUML specification file: basic-ipv4.xml
- VNUML specification file: basic-ipv6.xml
