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.