diff options
author | Richard Maw <richard.maw@gmail.com> | 2014-11-26 12:49:45 +0000 |
---|---|---|
committer | Richard Maw <richard.maw@gmail.com> | 2014-11-26 12:49:45 +0000 |
commit | f034691cba14d1919a3c8d1ffa41872ff754e1d3 (patch) | |
tree | 4d879db03c9bedcd65e965e29914433a7545f2f7 /morphlib/exts/kvm.write.help | |
parent | 69a413473a337f9789454ee0fc512f1a47910252 (diff) | |
parent | cb63069fc8a6eb8ba52e5a307cfa03e417e3bc0c (diff) | |
download | morph-f034691cba14d1919a3c8d1ffa41872ff754e1d3.tar.gz |
Merge remote-tracking branch 'pf/pf-document-extensions'
Reviewed-by: Richard Maw
Reviewed-by: Pete Fotheringham
Diffstat (limited to 'morphlib/exts/kvm.write.help')
-rw-r--r-- | morphlib/exts/kvm.write.help | 29 |
1 files changed, 26 insertions, 3 deletions
diff --git a/morphlib/exts/kvm.write.help b/morphlib/exts/kvm.write.help index 8b5053a5..ad0e25f0 100644 --- a/morphlib/exts/kvm.write.help +++ b/morphlib/exts/kvm.write.help @@ -1,4 +1,27 @@ help: | - The INITRAMFS_PATH option can be used to specify the location of an - initramfs for syslinux to tell Linux to use, rather than booting - the rootfs directly. + + Create a KVM/LibVirt virtual machine during Morph's deployment. + + Parameters: + + * location: a custom URL scheme of the form `kvm+ssh://HOST/GUEST/PATH`, + where: + * HOST is the name of the host on which KVM/LibVirt is running + * GUEST is the name of the guest VM on that host + * PATH is the path to the disk image that should be created, + on that host. For example, + `kvm+ssh://alice@192.168.122.1/testsys/home/alice/testys.img` where + * `alice@192.168.122.1` is the target host as given to ssh, + **from within the development host** (which may be + different from the target host's normal address); + * `testsys` is the name of the new guest VM'; + * `/home/alice/testys.img` is the pathname of the disk image files + on the target host. + * HOSTNAME: the hostname of the **guest** VM within the network into which + it is being deployed + * DISK_SIZE: the size of the VM's primary virtual hard disk + * RAM_SIZE: The amount of RAM that the virtual machine should allocate for + itself from the host. + * VCPUS: the number of virtual CPUs for the VM + * INITRAMFS_PATH: the location of an initramfs for the bootloader to tell + Linux to use, rather than booting the rootfs directly. |