github.com/xen-tools.xen-tools
1
0
Fork 0
mirror of synced 2026-01-20 17:38:02 +00:00
Code Releases Activity

2006-07-23 00:51:48 by steve

Browse Source 
Updated documentation only.
This commit is contained in:
steve 2006-07-23 00:51:48 +00:00
parent c808860259
commit 5be29098be
1 changed files with 33 additions and 27 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

60
bin/xen-create-image
View File

@ -18,7 +18,7 @@ xen-create-image - Create a new Xen instance
Size / General options:
--accounts Copy all non-system accounts to the guest image
--boot Boot the new instance after creating it.
--cache Cache .deb files on the host when using B<--debootstrap>
--cache Cache .deb files on the host when using --debootstrap
--force Force overwriting existing images.
--fs Specify the filesystem type to use.
--image Specify whether to create "sparse" or "full" disk images.
@ -34,9 +34,9 @@ xen-create-image - Create a new Xen instance
Installation options:
--copy Install the new image by copying from the given directory.
--dist Specify the distribution you wish to install
--debootstrap Use debootstrap to install the distribution B<--dist>
--mirror Setup the mirror to use when installing with B<--debootstrap>.
--rpmstrap Use rpmstrap to install the distribution B<--dist>
--debootstrap Use debootstrap to install the distribution --dist.
--mirror Setup the mirror to use when installing with --debootstrap.
--rpmstrap Use rpmstrap to install the distribution --dist.
--tar Install the new image by untarring the given file.
Networking options:
@ -65,19 +65,19 @@ Start the new virtual instance as soon as the installation has finished.
Cache the .deb files in /var/cache/apt/archives upon the host system when installing a new image with B<--debootstrap> for a large speed improvement. [Defaults to yes.]
=item B<--copy>
Install a new system by copying files recursively from the given directory. This is significantly faster than using B<--rpmstrap> or B<--debootstrap>, but it does require that you have installed a distribution "slowly" at least once.
Install a new system by copying files recursively from the given directory. This is significantly faster than using --rpmstrap or --debootstrap, but it does require that you have installed a distribution "slowly" at least once.
=item B<--debug>
Show the commands this script executes as an aid to debugging, along with their output once it has completed.
=item B<--debootstrap>
Use the B<--debootstrap> tool to install the distribution B<--dist>. When specifying B<--debootstrap> you should choose a local mirror with B<--mirror>
Use the debootstrap tool to install the distribution specified with --dist. When specifying --debootstrap you should choose a local mirror with --mirror.
=item B<--dhcp>
Specify that the virtual image should use DHCP to obtain its networking information. This option conflicts with B<--ip>.
Specify that the virtual image should use DHCP to obtain its networking information. This option conflicts with --ip.
=item B<--dir>
Specify the root directory beneath which the image should be saved. Subdirectories will be created for each virtual image. If you do not wish to use loopback files instead specify an LVM volume group with B<--lvm>.
Specify the root directory beneath which the image should be saved. Subdirectories will be created for each virtual image. If you do not wish to use loopback files instead specify an LVM volume group with --lvm.
=item B<--dist>
Specify the distribution to install, defaults to 'sarge'.
@ -102,13 +102,13 @@ Set the hostname of the new instance. B<Note> this should ideally be a fully qu
Use IDE style device names for the virtual devices.
=item B<--image>
Specify whether to use B<sparse> or B<full> images for the disk and swap volumes.
Specify whether to use sparse or full images for the disk and swap volumes.
=item B<--initrd>
Specify the initial ramdisk to be used by the booting Xen instance.
=item B<--ip>
Set the IP address for the virtual image. Conflicts with B<--dhcp>. This argument may be specified multiple times to give your new instance multiple IP addresses.
Set the IP address for the virtual image. Conflicts with --dhcp. This argument may be specified multiple times to give your new instance multiple IP addresses.
=item B<--kernel>
Specify the kernel which should be used for booting the new Xen instance.
@ -127,7 +127,7 @@ Specify the mirror to use when installing distributions with the debootstrap too
Set the netmask the virtual image should use.
=item B<--passwd>
Setup a password for the root account of the virtual machine. Note that specifying this will avoid copying user accounts into the new guest image. (i.e. The guest image will only have a B<root> account setup.)
Setup a password for the root account of the virtual machine. Note that specifying this will avoid copying user accounts into the new guest image. (i.e. The guest image will only have a root account setup.)
=item B<--role>
Run a single, specific, role-script once the image has been setup.
@ -140,13 +140,13 @@ Specify the size of the virtual swap partition to create. The size may be
suffixed with either Mb, or Gb.
=item B<--tar>
Install a new system by untarring the given file. This is significantly faster than using B<--rpmstrap> or B<--debootstrap>, but it does require that you have installed a distribution "slowly" at least once.
Install a new system by untarring the given file. This is significantly faster than using --rpmstrap or --debootstrap, but it does require that you have installed a distribution "slowly" at least once.
=item B<--version>
Show the version number and exit.
=item B<--lvm>
Specify the LVM volume group to store images within. If you wish to use loopback files instead please specify an output directory with B<--dir>. LVM and loopback files conflict with each other; choose only one.
Specify the LVM volume group to store images within. If you wish to use loopback files instead please specify an output directory with --dir. LVM and loopback files conflict with each other; choose only one.
=back
@ -241,6 +241,14 @@ Create a configuration file in /etc/xen so that xm can create the new image.
gateway = 192.168.1.1
netmask = 255.255.255.0
#
# Installation options.
#
# copy = /path/to/pristine/image
debootstrap = 1
# rpmstrap = 1
# tar = /path/to/img.tar
=for example end
Using this configuration file a new image may be created with the
@ -248,8 +256,8 @@ Create a configuration file in /etc/xen so that xm can create the new image.
xen-create-image --hostname=vm03.my.flat --ip=192.168.1.201
This makes use of loopback images stored beneath B</home/xen> and
will be installed via the B<--debootstrap> command.
This makes use of loopback images stored beneath /home/xen and
will be installed via the debootstrap command.
=cut
@ -257,7 +265,7 @@ Create a configuration file in /etc/xen so that xm can create the new image.
=head1 XEN CONFIGURATION FILE
Once a new image has been created an appropriate configuration file
for Xen will be saved in the directory B</etc/xen>.
for Xen will be saved in the directory /etc/xen.
The configuration file is built up using the template file
B</etc/xen-tools/xm.tmpl> - which is a file processed via
@ -330,24 +338,22 @@ Create a configuration file in /etc/xen so that xm can create the new image.
The new guest images may be installed in several different ways:
1. With the B<debootstrap> command.
2. With the B<rpmstrap> command.
1. With the debootstrap command.
2. With the rpmstrap command.
3. By copying an existing installation.
4. By untarring a file containing a previous installation.
These different methods can be selected by either the command line
arguments, or settings in the configuration file.
arguments, or settings in the configuration file. Only one installation
method may be specified.
The default option would be to install new systems with debootstrap.
This is mostly reliable, but can be quite slow even with caching.
However after your first installation you have the option of tarring
After your first installation you have the option of tarring
up the new system, and specifying that this tarfile should be used
for future installations of the same distribution.
Similarly if you were to mount an existing installation of a given
distribution you could simply copy that filesystem into the new image
with the B<--copy> option.
with the --copy option.
=cut
@ -369,7 +375,7 @@ Create a configuration file in /etc/xen so that xm can create the new image.
apt-get clean
(This feature can be disabled with the command line flag B<--cache=no>,
(This feature can be disabled with the command line flag --cache=no,
or by the matching setting in the configuration file.)
=cut
@ -433,7 +439,7 @@ Install an X11 server, using VNC and XDM
--
http://www.steve.org.uk/
$Id: xen-create-image,v 1.55 2006-07-21 20:17:41 steve Exp $
$Id: xen-create-image,v 1.56 2006-07-23 00:51:48 steve Exp $
=cut
@ -859,7 +865,7 @@ sub parseCommandLineArguments
if ( $VERSION )
{
my $REVISION = '$Revision: 1.55 $';
my $REVISION = '$Revision: 1.56 $';
if ( $REVISION =~ /1.([0-9.]+) / )
{