NAME

prov_virtual - a command line interface for provisioning virtual machines

SYNOPSIS

prov_virtual --action=  [--name example.com]

Action is one of the following:

create   - creates a new virtual environment/machine/server
destroy  - remove a VE from the system

start    - start up a VE
stop     - shut down a VE
restart  - restart a VE

enable   - enable/restore a VE
disable  - disable/suspend a VE

modify   - make changes to an existing VE
set_password - update root password in VE
migrate  - move VE to new hardware node

probe    - get status of a VE (returns a hash)
mount    - mount the VE disk image
unmount  - unmount VE disk image
console  - start a console session

help     - display this help document

required arguments: action, name

optional arguments: ip, hostname, template, config, password, nameservers, searchdomain

USAGE

prov_virtual --name=555 --action=create
prov_virtual --name=555 --action=mount
prov_virtual --name=555 --action=unmount
prov_virtual --name=555 --action=start
prov_virtual --name=555 --action=console
prov_virtual --name=555 --action=stop
prov_virtual --name=555 --action=destroy

DESCRIPTION

prov_virtual is a command line interface for provisioning virtual environments on various virtualization platforms. Support is included for OpenVZ, Xen, and FreeBSD jails. The syntax for provisioning a VPS on all supported platforms is identical.

See also Provision::Unix::VirtualOS and its subclasses.

CONFIGURATION AND ENVIRONMENT

See the [VirtualOS] section in provision.conf

DEPENDENCIES

Config::Tiny
Getopt::Long
Params::Validate
Digest::MD5 
LWP::UserAgent

AUTHOR

Matt Simerson, <matt at tnpi.net>

LICENCE AND COPYRIGHT

Copyright (c) 2009 The Network People, Inc. (info@tnpi.net)

This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See perlartistic.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.