Homepage:
    http://www.steve.org.uk/Software/xen-tools/

CVS Repository:
    http://xen-tools.cvsrepository.org/



xen-tools
---------

  The xen-tools package contains a collection of Perl scripts for
 working with Xen images under Debian GNU/Linux.

  It is primarily aimed at users who wish to create virtual instances
 of Debian Sarge, Etch, or Sid.  Although there is support for installing
 non-Debian instances this is both new and experimental.

  There are two ways to use the scripts:

  1. With loopback files (simplest)
  2. With LVM.



Loopback Files
--------------

  If you use the default setup with loopback files then each virtaul
 image will use two files on your host system:

	1. A disk image to be used by Xen as the primary drive.
	2. A disk image to be used by Xen as the swap partition.

  These images will be kept beneath whichever directory you specify 
 as your root directory (via the command line flag "--dir=.." or a 
 configuration file entry "dir = ..")

  Beneath the root directory each virtual instance will have a
 subdirectory, named after the hostname of the image.  

  A typical layout would look like this:

/home/xen/domains/
|-- bar               [Virtual machine named 'bar']
|   |-- disk.img        [Disk image]
|   `-- swap.img        [Swap image]
|   `-- install.log     [Debootstrap installation log]
|-- etch              [Virtual machine named 'etch']
|   |-- disk.img        [Disk image]
|   `-- swap.img        [Swap image]
|   `-- install.log     [Debootstrap installation log]




LVM Support
-----------

  If you wish to use the LVM support then you will give the 
 scripts an LVM volume which will be used to create the storage
 within.

  In this case you'll have two new volumes created, one for
 the swap image and one for the disk storage.



xen-create-image
----------------

  This script is designed to create new images which may be used
 with the Xen virtual machine.  You may create images of Debian
 or the non-Debian distributions which include CentOS 4.

  The virtual images will have their networking settings created and,
 you may optionally cause the new instance to boot once it has
 been created.

  The image may be customised by either hook scripts or a single
 role script - see the manpage for more details.


xen-duplicate-image
---------------

  This script allows a cloning operation to be conducted.  An existing
 image will be copied to a new directory and the networking information
 will be updated.  No other changes are applied.


xen-delete-image
----------------

  This script will delete a images by hostname.


xen-list-images
---------------

  List all the created images beneath a given root directory along
 with their network addresses.

  (In the case of images using DHCP an IP address will not be listed.)


xen-update-image
----------------

  This script runs "apt-get update; apt-get upgrade" for a given
 Xen image.

  NOTE:  The image should not be mounted/live/running or things will
 be corrupted.  (Still if the image is "live" you may just use SSH, right?)


Steve
--
$Id: README,v 1.30 2006-06-07 09:36:20 steve Exp $