From c85b09cd7a2688fbe7771252e32ad3bf0371c121 Mon Sep 17 00:00:00 2001 From: Chen Fan Date: Mon, 9 Jun 2014 17:49:22 +0800 Subject: [PATCH] virsh: Add details about specified migration host the 'migration_host' description may be a bit difficult to understand for some users, so enhance the manual Signed-off-by: Chen Fan Signed-off-by: Eric Blake --- tools/virsh.pod | 17 ++++++++++++++--- 1 file changed, 14 insertions(+), 3 deletions(-) diff --git a/tools/virsh.pod b/tools/virsh.pod index 80501f98a3..b2fd53bb06 100644 --- a/tools/virsh.pod +++ b/tools/virsh.pod @@ -1209,8 +1209,6 @@ unsafe unless the disk images are stored on coherent clustered filesystem, such as GFS2 or GPFS. If you are sure the migration is safe or you just do not care, use I<--unsafe> to force the migration. -The I is the connection URI of the destination host, and -I is the migration URI, which usually can be omitted (see below). I is used for renaming the domain to new name during migration, which also usually can be omitted. Likewise, I<--xml> B is usually omitted, but can be used to supply an alternative XML file for use on @@ -1225,6 +1223,12 @@ then the migration will complete offline. It can only be used with I<--live>. Running migration can be canceled by interrupting virsh (usually using C) or by B command sent from another virsh instance. +The I and I parameters can be used to control which +destination the migration uses. I is important for managed +migration, but unused for direct migration; I is required +for direct migration, but can usually be automatically determined for +managed migration. + B: The I parameter for normal migration and peer2peer migration has different semantics: @@ -1239,7 +1243,11 @@ seen from the source machine. =back When I is not specified, libvirt will automatically determine the -hypervisor specific URI, by looking up the target host's configured hostname. +hypervisor specific URI. Some hypervisors, including QEMU, have an optional +"migration_host" configuration parameter (useful when the host has multiple +network interfaces). If this is unspecified, libvirt determines a name +by looking up the target host's configured hostname. + There are a few scenarios where specifying I may help: =over 4 @@ -1264,6 +1272,9 @@ order to comply with local firewall policies. =back +See L for more details on +migration URIs. + Optional I overrides connection parameters used for automatically reconnecting a graphical clients at the end of migration. If omitted, libvirt will compute the parameters based on target host IP address. In case the -- 2.39.5