[libvirt] [PATCH] virsh: Better document --copy-storage migrate options
Both --copy-storage-{all,inc} options require disk images to be present on destination host. --- tools/virsh.pod | 9 ++++++--- 1 files changed, 6 insertions(+), 3 deletions(-) diff --git a/tools/virsh.pod b/tools/virsh.pod index fbde57f..0e7acfa 100644 --- a/tools/virsh.pod +++ b/tools/virsh.pod @@ -727,9 +727,12 @@ and I<--suspend> leaves the domain paused on the destination host. I<--copy-storage-all> indicates migration with non-shared storage with full disk copy, I<--copy-storage-inc> indicates migration with non-shared storage with incremental copy (same base image shared between source and destination). -I<--change-protection> enforces that no incompatible configuration changes -will be made to the domain while the migration is underway; this flag is -implicitly enabled when supported by the hypervisor, but can be explicitly +In both cases the disk images have to exist on destination host, the +I<--copy-storage-...> options only tell libvirt to transfer data from the +images on source host to the images found at the same place on the destination +host. I<--change-protection> enforces that no incompatible configuration +changes will be made to the domain while the migration is underway; this flag +is implicitly enabled when supported by the hypervisor, but can be explicitly used to reject the migration if the hypervisor lacks change protection support. I<--verbose> displays the progress of migration. -- 1.7.6.1
On 09/26/2011 07:11 AM, Jiri Denemark wrote:
Both --copy-storage-{all,inc} options require disk images to be present on destination host. --- tools/virsh.pod | 9 ++++++--- 1 files changed, 6 insertions(+), 3 deletions(-)
ACK for documenting existing behavior. It points out a potential for future improvement patches that make migration v3 pass, as part of its cookies, a directive for the destination to create such files if they don't already exist, rather than the current status quo of making the user ensure this fact. But we can touch up the docs if we ever make a future patch like this. -- Eric Blake eblake@redhat.com +1-801-349-2682 Libvirt virtualization library http://libvirt.org
On Mon, Sep 26, 2011 at 17:00:32 -0600, Eric Blake wrote:
On 09/26/2011 07:11 AM, Jiri Denemark wrote:
Both --copy-storage-{all,inc} options require disk images to be present on destination host. --- tools/virsh.pod | 9 ++++++--- 1 files changed, 6 insertions(+), 3 deletions(-)
ACK for documenting existing behavior.
It points out a potential for future improvement patches that make migration v3 pass, as part of its cookies, a directive for the destination to create such files if they don't already exist, rather than the current status quo of making the user ensure this fact. But we can touch up the docs if we ever make a future patch like this.
Yup. Thanks and pushed. Jirka
participants (2)
-
Eric Blake -
Jiri Denemark