2:28 a.m.
---
source/migrate.xml | 168 +++++++++++++++++++++++++++++++++++++++++++++++++++-
1 files changed, 166 insertions(+), 2 deletions(-)
diff --git a/source/migrate.xml b/source/migrate.xml
index a85851b..4c88e74 100644
--- a/source/migrate.xml
+++ b/source/migrate.xml
@@ -9,13 +9,177 @@
</text>
</description>
- <options />
+ <options>
+ <parameter requirement="optional">
+ <keyword requirement="optional">--live</keyword>
+ <description>
+ <text>
+ live migration
+ </text>
+ </description>
+ </parameter>
+ <parameter requirement="optional">
+ <keyword requirement="optional">--p2p</keyword>
+ <description>
+ <text>
+ peer-2-peer migration
+ </text>
+ </description>
+ </parameter>
+ <parameter requirement="optional">
+ <keyword requirement="optional">--direct</keyword>
+ <description>
+ <text>
+ direct migration
+ </text>
+ </description>
+ </parameter>
+ <parameter requirement="optional">
+ <keyword requirement="optional">--tunnelled</keyword>
+ <description>
+ <text>
+ tunnelled migration
+ </text>
+ </description>
+ </parameter>
+ <parameter requirement="optional">
+ <keyword requirement="optional">--persistent</keyword>
+ <description>
+ <text>
+ persist VM on destination
+ </text>
+ </description>
+ </parameter>
+ <parameter requirement="optional">
+ <keyword requirement="optional">--undefinesource</keyword>
+ <description>
+ <text>
+ undefine VM on source
+ </text>
+ </description>
+ </parameter>
+ <parameter requirement="optional">
+ <keyword requirement="optional">--suspend</keyword>
+ <description>
+ <text>
+ do not restart the domain on the destination host
+ </text>
+ </description>
+ </parameter>
+ <parameter requirement="optional">
+ <keyword requirement="optional">--copy-storage-all</keyword>
+ <description>
+ <text>
+ migration with non-shared storage with full disk copy
+ </text>
+ </description>
+ </parameter>
+ <parameter requirement="optional">
+ <keyword requirement="optional">--copy-storage-inc</keyword>
+ <description>
+ <text>
+ migration with non-shared storage with incremental copy
+ (same base image shared between source and destination)
+ </text>
+ </description>
+ </parameter>
+ <parameter requirement="optional">
+ <keyword
requirement="optional">--change-protection</keyword>
+ <description>
+ <text>
+ prevent any configuration changes to domain until migration ends
+ </text>
+ </description>
+ </parameter>
+ <parameter requirement="optional">
+ <keyword requirement="optional">--verbose</keyword>
+ <description>
+ <text>
+ display the progress of migration
+ </text>
+ </description>
+ </parameter>
+ <parameter requirement="required">
+ <keyword requirement="optional">--domain</keyword>
+ <value type="string"
requirement="required">domain</value>
+ <description>
+ <text>
+ domain name, id or uuid
+ </text>
+ <text>
+ "--domain" itself is optional
+ </text>
+ </description>
+ </parameter>
+ <parameter requirement="required">
+ <keyword requirement="optional">--desturi</keyword>
+ <value type="string"
requirement="required">desturi</value>
+ <description>
+ <text>
+ connection URI of the destination host as seen from the
+ client(normal migration) or source(p2p migration)
+ </text>
+ <text>
+ "--desturi" itself is optional
+ </text>
+ </description>
+ </parameter>
+ <parameter requirement="optional">
+ <keyword requirement="optional">--migrateuri</keyword>
+ <value type="string"
requirement="required">migrateuri</value>
+ <description>
+ <text>
+ migration URI, usually can be omitted
+ </text>
+ <text>
+ "--migrateuri" itself is optional
+ </text>
+ </description>
+ </parameter>
+ <parameter requirement="optional">
+ <keyword requirement="optional">--dname</keyword>
+ <value type="string"
requirement="required">dname</value>
+ <description>
+ <text>
+ rename to new name during migration(if supported)
+ </text>
+ <text>
+ "--dname" itself is optional
+ </text>
+ </description>
+ </parameter>
+ <parameter requirement="optional">
+ <keyword requirement="optional">--timeout</keyword>
+ <value type="number"
requirement="required">timeout</value>
+ <description>
+ <text>
+ force guest to suspend if live migration exceeds timeout(in seconds)
+ </text>
+ </description>
+ </parameter>
+ <parameter requirement="optional">
+ <keyword requirement="optional">--xml</keyword>
+ <value type="string"
requirement="required">xmlfile</value>
+ <description>
+ <text>
+ filename containing updated XML for the target
+ </text>
+ </description>
+ </parameter>
+</options>
<availability from="0.3.2" />
<notes />
- <examples type="usage" />
+ <examples type="usage">
+ <example>
+ <terminal>virsh # <bold>migrate</bold>
<value>example-domain</value>
<value>qemu+ssh://root@192.168.0.10/system</value></terminal>
+ <text>
+ migrates domain <value>example-domain</value> to host
<value>192.168.0.10</value>.
+ </text>
+ </example>
+ </examples>
<examples type="fullcontext" />
--
1.7.3.1