Difference between revisions of "Example-simple"

From VNUML-WIKI
Jump to: navigation, search
(VNUML Description)
(VNUML Description)
 
(15 intermediate revisions by 3 users not shown)
Line 4: Line 4:
 
  Authors:
 
  Authors:
 
  '''David Fernández (david at dit.upm.es)'''
 
  '''David Fernández (david at dit.upm.es)'''
  '''version 1.6, January 15th, 2006'''
+
  '''version 1.8, October 3rd, 2007'''
 
</big>
 
</big>
  
Line 12: Line 12:
 
== Scenario ==
 
== Scenario ==
  
This is the most simple example you can build using VNUML. It just starts one virtual machine named "host1" without any virtual network. It can be used to test and tune the kernel and root filesystem you plan to use in a simulation. The example has been updated from 1.3 to 1.6 thanks to Esteban Martín.
+
This is the most simple example you can build using VNUML. It just starts one virtual machine named "host1" without any virtual network. It can be used to test and tune the kernel and root filesystem you plan to use in a simulation.  
  
 
It is always recomended to first test kernel and filesystems in your machine using a simple scenario like this before using them in more complex scenarios. That will save you a lot of time, allowing to detect and correct typical problems related to the virtual machines boot process.
 
It is always recomended to first test kernel and filesystems in your machine using a simple scenario like this before using them in more complex scenarios. That will save you a lot of time, allowing to detect and correct typical problems related to the virtual machines boot process.
  
Once the simulation is started, you can access the virtual machine using several methods (see the [../../1.6/reference/index.html#vm_mgmt <vm_mgmt>] tag):
+
Once the simulation is started, you can access the virtual machine using several methods (see the [[Reference#<vm_mgmt>|<vm_mgmt>]] tag):
  
 
* Using the xterm console started by default (see line "<con0>xterm</con0>" in VNUML spec). In this case, the simulation has to be started from an X terminal. <font color="red">'''NOTE:'''</font> if you are experiencing problems with the conventional xterm, we recommend you to uncomment the [[Reference#<xterm>|<xterm>]] tag in each virtual machine, in order to use gnome-terminal, that seems to be more stable. Of course, you will need the gnome-terminal installed in your system.
 
* Using the xterm console started by default (see line "<con0>xterm</con0>" in VNUML spec). In this case, the simulation has to be started from an X terminal. <font color="red">'''NOTE:'''</font> if you are experiencing problems with the conventional xterm, we recommend you to uncomment the [[Reference#<xterm>|<xterm>]] tag in each virtual machine, in order to use gnome-terminal, that seems to be more stable. Of course, you will need the gnome-terminal installed in your system.
Line 27: Line 27:
  
 
The first and second methods are recomended, because they allow you to see all log messages showed by the virtual machine when starting, as well as to access it even if the management interface has not been started correctly.
 
The first and second methods are recomended, because they allow you to see all log messages showed by the virtual machine when starting, as well as to access it even if the management interface has not been started correctly.
 
You can download the simulation file from [simple.xml here].
 
 
  
 
== VNUML Description ==
 
== VNUML Description ==
  
</br>
+
<br/>
  
 
<pre>
 
<pre>
 
<?xml version="1.0" encoding="UTF-8"?>
 
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE vnuml SYSTEM "/usr/local/share/xml/vnuml/vnuml.dtd">
+
<!DOCTYPE vnuml SYSTEM "/usr/share/xml/vnuml/vnuml.dtd"
 
+
[
 +
  <!ENTITY VNUMLDIR "/usr/share/vnuml/">
 +
]>
 
<!--
 
<!--
 
Simple simulation
 
Simple simulation
 
Just one virtual machine. Use this specification for testing
 
Just one virtual machine. Use this specification for testing
NOTE: if you are experiencing problems with the conventional xterm, we recommend you to uncomment the <xterm> tag, in order to use gnome-terminal, that seems to be more stable. Of course, you will need the gnome-terminal installed in your system.
+
 
 +
NOTE: if you are experiencing problems with the conventional xterm, we  
 +
recommend you to uncomment the <xterm> tag, in order to use gnome-terminal,  
 +
that seems to be more stable. Of course, you will need the gnome-terminal  
 +
installed in your system.
 
-->
 
-->
 
 
<vnuml>
 
<vnuml>
  
 
   <global>
 
   <global>
     <version>1.7</version>
+
     <version>1.8</version>
 
     <simulation_name>simple</simulation_name>
 
     <simulation_name>simple</simulation_name>
 
     <automac/>
 
     <automac/>
     <vm_mgmt type="none" />
+
     <vm_mgmt type="none"/>
 
     <vm_defaults>
 
     <vm_defaults>
       <filesystem type="cow">/usr/local/share/vnuml/filesystems/root_fs_tutorial</filesystem>
+
       <filesystem type="cow">&VNUMLDIR;filesystems/root_fs_tutorial</filesystem>
       <kernel>/usr/local/share/vnuml/kernels/linux</kernel>
+
       <kernel>&VNUMLDIR;kernels/linux</kernel>
       <console id="0">xterm</console>
+
       <console id="1">xterm</console>
 
       <!--xterm>gnome-terminal,-t,-x</xterm-->
 
       <!--xterm>gnome-terminal,-t,-x</xterm-->
 
     </vm_defaults>
 
     </vm_defaults>
Line 61: Line 63:
  
 
   <!-- NODES -->
 
   <!-- NODES -->
   <vm name="host1" />
+
   <vm name="host1"/>
  
 
</vnuml>
 
</vnuml>
 
</pre>
 
</pre>
 +
 +
== Download ==
 +
 +
* VNUML specification file: [http://jungla.dit.upm.es/~vnuml/doc/examples/simple/simple.xml Simple.xml]
  
 
== Old Releases ==
 
== Old Releases ==
  
 
* [http://jungla.dit.upm.es/~vnuml/doc/examples/simple/1.3/simple.html 1.3]
 
* [http://jungla.dit.upm.es/~vnuml/doc/examples/simple/1.3/simple.html 1.3]
 +
* [http://jungla.dit.upm.es/~vnuml/doc/examples/simple/1.6/simple.html 1.6]
 +
* [[Example-simple-1.7|1.7]]

Latest revision as of 11:31, 4 October 2007

VNUML Simple Example

Authors:
David Fernández (david at dit.upm.es)
version 1.8, October 3rd, 2007


Scenario

This is the most simple example you can build using VNUML. It just starts one virtual machine named "host1" without any virtual network. It can be used to test and tune the kernel and root filesystem you plan to use in a simulation.

It is always recomended to first test kernel and filesystems in your machine using a simple scenario like this before using them in more complex scenarios. That will save you a lot of time, allowing to detect and correct typical problems related to the virtual machines boot process.

Once the simulation is started, you can access the virtual machine using several methods (see the <vm_mgmt> tag):

  • Using the xterm console started by default (see line "<con0>xterm</con0>" in VNUML spec). In this case, the simulation has to be started from an X terminal. NOTE: if you are experiencing problems with the conventional xterm, we recommend you to uncomment the <xterm> tag in each virtual machine, in order to use gnome-terminal, that seems to be more stable. Of course, you will need the gnome-terminal installed in your system.
  • Through a pseudo tty (pts) using "screen" application (or any other terminal emulation application). In this case you have to:
    • change "xterm" by "pts"
    • start the simulation using: "vnuml -t simple.xml -e screen.cfg"
    • access the console using: "screen -c screen.cfg"
  • Through the management interface using SSH. For example: "slogin 192.168.0.2" (if you add the <host_mapping> tag to global section you can use the virtual machine name: "slogin host1").

The first and second methods are recomended, because they allow you to see all log messages showed by the virtual machine when starting, as well as to access it even if the management interface has not been started correctly.

VNUML Description


<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE vnuml SYSTEM "/usr/share/xml/vnuml/vnuml.dtd" 
[
  <!ENTITY VNUMLDIR "/usr/share/vnuml/">
]>
<!--
Simple simulation
Just one virtual machine. Use this specification for testing

NOTE: if you are experiencing problems with the conventional xterm, we 
recommend you to uncomment the <xterm> tag, in order to use gnome-terminal, 
that seems to be more stable. Of course, you will need the gnome-terminal 
installed in your system.
-->
<vnuml>

  <global>
    <version>1.8</version>
    <simulation_name>simple</simulation_name>
    <automac/>
    <vm_mgmt type="none"/>
    <vm_defaults>
       <filesystem type="cow">&VNUMLDIR;filesystems/root_fs_tutorial</filesystem>
       <kernel>&VNUMLDIR;kernels/linux</kernel>
       <console id="1">xterm</console>
       <!--xterm>gnome-terminal,-t,-x</xterm-->
    </vm_defaults>
  </global>

  <!-- NODES -->
  <vm name="host1"/>

</vnuml>

Download

Old Releases