bcd026d141
This way we don't need separate admin.vm.Clone call, which is tricky to handler properly with policy. A VM may not have access to all the properties and other metadata, so add ignore_errors argument, for best-effort approach (copy what is possible). In any case, failure of cloning VM data fails the whole operation. When operation fails, VM is removed. While at it, allow to specify alternative VM class - this allows morphing one VM into another (for example AppVM -> StandaloneVM). Adjust qvm-clone tool and tests accordingly. QubesOS/qubes-issues#2622
55 lines
1.5 KiB
ReStructuredText
55 lines
1.5 KiB
ReStructuredText
.. program:: qvm-clone
|
|
|
|
:program:`qvm-clone` -- Clones an existing VM by copying all its disk files
|
|
===========================================================================
|
|
|
|
.. warning::
|
|
|
|
This page was autogenerated from command-line parser. It shouldn't be 1:1
|
|
conversion, because it would add little value. Please revise it and add
|
|
more descriptive help, which normally won't fit in standard ``--help``
|
|
option.
|
|
|
|
After rewrite, please remove this admonition.
|
|
|
|
Synopsis
|
|
--------
|
|
:command:`qvm-clone` [*options*] *VMNAME* *NEWVM*
|
|
|
|
Options
|
|
-------
|
|
|
|
.. option:: --help, -h
|
|
|
|
Show this help message and exit
|
|
|
|
.. option:: --class=CLASS, -C CLASS
|
|
|
|
Create VM of different class than source VM. The tool will try to copy as
|
|
much as possible data/metadata from source VM, but some information may be
|
|
impossible to preserve (for example target VM have no matching properties).
|
|
|
|
.. option:: -P POOL
|
|
|
|
Pool to use for the new domain. All volumes besides snapshots volumes are
|
|
imported in to the specified POOL. THIS IS WHAT YOU WANT TO USE NORMALLY.
|
|
|
|
.. option:: --pool=POOL:VOLUME, -p POOL:VOLUME
|
|
|
|
Specify the pool to use for the specific volume
|
|
|
|
.. option:: --quiet, -q
|
|
|
|
Be quiet
|
|
|
|
.. option:: --verbose, -v
|
|
|
|
Increase verbosity
|
|
|
|
Authors
|
|
-------
|
|
| Joanna Rutkowska <joanna at invisiblethingslab dot com>
|
|
| Rafal Wojtczuk <rafal at invisiblethingslab dot com>
|
|
| Marek Marczykowski <marmarek at invisiblethingslab dot com>
|
|
| Bahtiar `kalkin-` Gadimov <bahtiar at gadimov dot de>
|