From f69cfd23cbd6329f1e7b9ecccb6b51300e2ea7e1 Mon Sep 17 00:00:00 2001 From: Dietmar Maurer Date: Tue, 5 Jan 2016 10:19:10 +0100 Subject: [PATCH] import qm docs --- qm.adoc | 79 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 79 insertions(+) create mode 100644 qm.adoc diff --git a/qm.adoc b/qm.adoc new file mode 100644 index 0000000..0b8aa92 --- /dev/null +++ b/qm.adoc @@ -0,0 +1,79 @@ +include::attributes.txt[] +ifdef::manvolnum[] +PVE({manvolnum}) +================ + +NAME +---- + +qm - Qemu/KVM Virtual Machine Manager + + +SYNOPSYS +-------- + +include::qm.1-synopsis.adoc[] + +DESCRIPTION +----------- +endif::manvolnum[] + +ifndef::manvolnum[] +Qemu/KVM Virtual Machines +========================= +endif::manvolnum[] + + +qm is a script to manage virtual machines with Qemu/Kvm. You can +create and destroy virtual machines, and control execution +(start/stop/suspend/resume). Besides that, you can use qm to set +parameters in the associated config file. It is also possible to +create and delete virtual disks. + +Configuration +------------- + +All configuration files consists of lines in the form + + PARAMETER: value + +See 'man vm.conf' for a complete list of options. + +Configuration files are stored inside the Proxmox configuration file +system, and can be access at '/etc/pve/qemu-server/.conf'. + +The default for option `keyboard` is read from +'/etc/pve/datacenter.conf'. + +Locks +----- + +Online migration and backups ('vzdump') set a lock to prevent +unintentional action on such VMs. Sometimes you need remove such lock +manually (power failure). + + qm unlock + +Examples +-------- + +Create a new VM with 4 GB IDE disk. + + qm create 300 -ide0 4 -net0 e1000 -cdrom proxmox-mailgateway_2.1.iso + +Start the new VM + + qm start 300 + +Send a shutdown request, then wait until the VM is stopped. + + qm shutdown 300 && qm wait 300 + +Same as above, but only wait for 40 seconds. + + qm shutdown 300 && qm wait 300 -timeout 40 + + +ifdef::manvolnum[] +include::pve-copyright.adoc[] +endif::manvolnum[] -- 2.39.2