NAME

mkve - manage virtual machines

DESCRIPTION

This program is intended for creating and managing virtual machines from bundles.

SYNOPSIS

mkve command [options]

COMMANDS

create

create a new virtual machine

--name NAME - name of machine;
--bundle BUNDLE - path to source bundle;
--kvm-bridge BRIDGE - bridge to connect to;
--memory MEMORY - amount of RAM for VE (in megabytes);
--network NETWORK - virtual network to connect to (see net-* commands);

adopt

adopt an orphaned (i.e., non-mkve) virtual machine

--name NAME - name of machine;
--hypervisor HYPERVISOR - type of virtualization;
--args ARGS - hypervisor-specific args.

For openvz you must tell the CTID of container:
mkve adopt machine --hy openvz --args CTID

destroy

destroy a specified machine

--name NAME - name of destroying machine

list

list machines

--hypervisor hypervisor - list machines for specified hypervisor only. Supported hypervisors are now: kvm, openvz

info

shows information about specified machine

If no or more than one additional options specified, command lists information, prepended by the option name; if an unique option specified, command will echo only the value of this option.

--name NAME - what machine to show;
--hypervisor - under what hypervisor does machine run;
--id - what identificator machine has;
--ip-address - IP address for controling machine (has meaning only for openvz);
--state - human-readable state of machine;
--memory - how much RAM does machine use;
--vcpu - how much virtual CPUs does machine use;
--cpu-time - CPU time in microseconds;
--start-on-boot - extract autostart flag

start

starts specified machine

--name NAME - name of machine

stop

stops specified machine

--name NAME - name of machine

restart

restarts specified machine

--name NAME - name of machine

suspend

suspends specified machine (see resume command)

--name NAME - name of machine

resume

resumes previously suspended machine (see suspend command)

--name NAME - name of machine

autostart

sets or clears machine autostart flag

--name NAME - name of machine; --disable - clear autostart flag

net-create

creates a virtual network

--name NAME - name of creating network;
--bridge BRIDGE - add network to that bridge;
--address ADDRESS - address of default route in this network;
--dhcp-ranges RANGES - DHCP ranges of form BEGIN-END, separated by semicolons

net-destroy

destroys a network

--name NAME - name of network

net-list

lists all virtual networks

--active - list only active networks (default is all); --inactive - list only stopped networks

net-info

prints some information about network

--name NAME - name of network

help

print help

SEE ALSO

mkve-bundle(1), virsh(1)

AUTHOR

Anton S. Protopopov <aspsk at altlinux.org>