xen-create-image - Easily create new Xen instances with networking and OpenSSH.
-=cut
-
=head1 SYNOPSIS
xen-create-image --hostname=<hostname> <further options>
+
=head1 EXAMPLES
xen-create-image --hostname=some-domu --dist=wheezy --lvm=vg0
See below for more specific examples: LOOPBACK EXAMPLES, LVM EXAMPLE
and EVMS EXAMPLE.
+
=head1 OPTIONS
Help Options:
If you do not wish to use LVM specify --dir or --evms.
(These three options are mutually exclusive.)
-=cut
-
=head1 NOTES
The result of invoking these three scripts, and some minor glue between
them, is a simple means of creating new Xen guest domains.
-=cut
-
=head1 DESCRIPTION
If you wish to install additional packages or do any additional
configuration of your new guests, please read the section on "ROLES".
-=cut
=head1 CONFIGURATION
This makes use of loopback images stored beneath /home/xen and
will be installed via the debootstrap command.
-=cut
-
-
=head1 NETWORKING AUTO-SETUP
and would no longer be available. If all the IP addresses are taken
then the system will fail.
-=cut
-
=head1 PARTITIONING
Now when you create a new image specify the name of this file with as
an argument to the --partition option.
-=cut
-
=head1 XEN CONFIGURATION FILE
Alternatively you can create multiple configuration files and
specify the one to use with the --template option.
-=cut
-
=head1 LOOPBACK EXAMPLES
The '/domains/' subdirectory will be created if necessary.
-=cut
-
=head1 LVM EXAMPLE
mkdir -p /mnt/foo
mount /dev/myvolumegroup/vm01.my.flat-disk /mnt/foo
-=cut
=head1 EVMS EXAMPLE
mkdir -p /mnt/foo
mount /dev/evms/vm01.my.flat-disk /mnt/foo
-=cut
-
=head1 INSTALLATION METHODS
arguments, or settings in the configuration file. Only one installation
method may be specified at a time; they are mutually-exclusive.
-=cut
=head1 INSTALLATION SPEEDUPS
--lvm=myvolumegroup --hostname=vm01.my.flat \
--install-method=copy --install-source=/path/to/copy/from
-=cut
-
=head1 DEBOOTSTRAP CACHING
If you set your cache directory to anything else, simply rm the
contents of the directory.
-=cut
-
=head1 ROLES
NOTE: Multiple role scripts may be invoked if you separate their
names with commas.
-=cut
-
-
=head1 THE SKELETON DIRECTORY
Dmitry Nedospasov, http://nedos.net/
Stéphane Jourdois
-=cut
=head1 LICENSE
--nfs_server Specify the NFS server to mount the root partition from.
--nfs_root Specify the path, upon the NFS server, to mount.
-=cut
-
=head1 OPTIONS
=item B<--version>
Show the version number and exit.
-
=back
-=cut
-
=head1 DESCRIPTION
support more than the minimal number of options to completement the
existing xen-create-image script, however it is hopefully useful.
-=cut
-
=head1 REFERENCE
http://www.debian-administration.org/articles/505
-=cut
-
=head1 AUTHORS
Steve Kemp, http://www.steve.org.uk/
Stéphane Jourdois
-=cut
-
=head1 LICENSE
the same terms as Perl itself.
The LICENSE file contains the full text of the license.
-
=cut
--test Don't complain if we're not invoked by root.
--no-xen-ok Don't complain if xen seems not installed or xend is not running
-=cut
-
=head1 OPTIONS
=item B<--version>
Show the version number and exit.
-
=back
-=cut
-
=head1 DESCRIPTION
but will fail to remove anything which the user does not have permission
to delete.)
-=cut
-
=head1 LOOPBACK EXAMPLE
(The matching Xen configuration files beneath /etc/xen will also be
removed.)
-=cut
-
=head1 LVM EXAMPLE
The Xen configuration files will also be removed from beneath /etc/xen.
-=cut
-
=head1 EVMS EXAMPLE
The Xen configuration files will also be removed.
-=cut
-
=head1 AUTHORS
Axel Beckert, http://noone.org/abe/
Stéphane Jourdois
-=cut
-
=head1 LICENSE
the same terms as Perl itself.
The LICENSE file contains the full text of the license.
-
=cut
Testing options:
--test Specify an alternate Xen configuration directory.
+
=head1 OPTIONS
=over 8
and then either the IP address configured, or "DHCP" to denote
a dynamic host.
-=cut
=head1 TODO
It should be possible to determine the disk(s) used by the images,
and then display their sizes.
-=cut
-
=head1 AUTHORS
Steve Kemp, http://www.steve.org.uk/
Stéphane Jourdois
-=cut
=head1 LICENSE
--force Force the resize to happen without a last-chance delay.
--hostname Specify the hostname of the guest to resize.
-=cut
-
=head1 OPTIONS
=back
-=cut
-
=head1 DESCRIPTION
More than once I've heard of users making mistakes and breaking their
filesystems; hence this tool.
-=cut
=head1 AUTHORS
Steve Kemp, http://www.steve.org.uk/
Axel Beckert, http://noone.org/abe/
-=cut
-
=head1 LICENSE
the same terms as Perl itself.
The LICENSE file contains the full text of the license.
-
=cut
--lvm Specify the LVM volume group which contains the image(s).
--evms Specify the EVMS container which contains the image(s).
-=cut
-
-
=head1 OPTIONS
=back
-=cut
-
=head1 DESCRIPTION
corruption otherwise it will allow you to update your image without
booting it.
-=cut
-
=head1 EXAMPLES
xen-update-images --dir=/home/xen test.my.flat x11.my.flat
-=cut
-
=head1 AUTHORS
Axel Beckert, http://noone.org/abe/
Stéphane Jourdois
-=cut
=head1 LICENSE
xt-create-config - Create a Xen configuration file for a new guest
-=cut
-
=head1 SYNOPSIS
xt-create-config [options]
All other options from xen-create-image, such as the new IP address(es)
to give to the new instance, will be passed as environmental variables.
-=cut
=head1 ABOUT
By default the script will use /etc/xen-tools/xm.tmpl as its input.
-=cut
-
=head1 INVOCATION
=for example end
-=cut
-
-
=head1 ARGUMENT PASSING
This script will be invoked with a full copy of the arguments from
for the "Text::Template" perl module. (If you have the perldoc
package installed you can read this with "perldoc Text::Template".)
-=cut
=head1 AUTHORS
Axel Beckert, http://noone.org/abe/
Stéphane Jourdois
-=cut
=head1 LICENSE
xt-customize-image - Customize a freshly installed copy of GNU/Linux
-=cut
-
=head1 SYNOPSIS
xt-customize-image [options]
All other options from xen-create-image, such as the new IP address(es)
to give to the new instance, will be passed as environmental variables.
-=cut
=head1 NOTES
--location - The temporary installation root of the new install
--dist - The distribution which has been installed.
-=cut
-
=head1 HOOK SCRIPTS
executed from '/usr/share/xen-tools/foo.d'. Each executable will
be loaded and executed in sorted order.
-=cut
-
=head1 AUTHORS
Axel Beckert, http://noone.org/abe/
Stéphane Jourdois
-=cut
-
=head1 LICENSE
xt-guess-suite-and-mirror - Tries to guess the most suitable suite and
mirror for DomUs on Debian and Ubuntu Dom0s.
-=cut
-
=head1 SYNOPSIS
--suite Show suite
--manual Show the manual for this script.
--version Show the version number and exit.
-=cut
=head1 DESCRIPTION
Dom0 is currently using and returns them in a way suitable for
xen-create-image(1) or the backticks feature in xen-tools.conf.
-=cut
=head1 AUTHORS
Axel Beckert, http://noone.org/abe/
Stéphane Jourdois
-=cut
=head1 LICENSE
xt-install-image - Install a fresh copy of GNU/Linux into a directory
-=cut
-
=head1 SYNOPSIS
xt-install-image [options]
All other options from xen-create-image will be passed as environmental
variables.
-=cut
-
=head1 NOTES
configuration, etc.
-=cut
-
=head1 INSTALLATION METHODS
There are several available methods of installation, depending upon the
=back
-=cut
-
=head1 AUTHORS
Dmitry Nedospasov, http://nedos.net/
Stéphane Jourdois
-=cut
=head1 LICENSE
Xen::Tools::Common - Common funtions used in xen-tools' Perl scripts
+
=head1 SYNOPSIS
use Xen::Tools::Common;
projects / people / dariof / xen-tools.git / commitdiff