Re: [libvirt] [patch v2 1/1] manual: Add virsh manual about specified migration host
Chen-san, Looks good to me. Thanks, the 'migration_host' description maybe have a bit of difficulty to understand for user, so add this manual for them. Signed-off-by: Chen Fan chen.fan.f...@cn.fujitsu.com --- tools/virsh.pod | 12 +++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/tools/virsh.pod b/tools/virsh.pod index 02671b4..7b30292 100644 --- a/tools/virsh.pod +++ b/tools/virsh.pod @@ -1208,7 +1208,8 @@ 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 Idesturi is the connection URI of the destination host, and -Imigrateuri is the migration URI, which usually can be omitted (see below). +Imigrateuri is the migration URI for specifying which IP address/URI of the +destination host to tansfer migration data, which usually can be omitted (see below). Idname is used for renaming the domain to new name during migration, which also usually can be omitted. Likewise, I--xml Bfile is usually omitted, but can be used to supply an alternative XML file for use on @@ -1238,6 +1239,15 @@ seen from the source machine. When Imigrateuri is not specified, libvirt will automatically determine the hypervisor specific URI, by looking up the target host's configured hostname. + +For QEMU/KVM hypervisor, when Imigrateuri is not specified, at first libvirt +will ask the destination side whether the optional migration_host is specified +or not, if the migration_host is specified, libvirt will use the specified +network for transferring migration data(the migrateion_host is useful when +hosts has multiple network interface). if the migrateion_host is not specified +too, libvirt will automatically determine the hypervisor specific URI, by looking +up the target host's configured hostname. + There are a few scenarios where specifying Imigrateuri may help: =over 4 -- 1.9.3 -- Yasunori Goto y-g...@jp.fujitsu.com -- libvir-list mailing list libvir-list@redhat.com https://www.redhat.com/mailman/listinfo/libvir-list
Re: [libvirt] [PATCH] manual: Add virsh manual about specified migration host
Chen-san, ping... I suppose it seems to be difficult for users to understand... I think following order of description is desirable. - What is migrateuri? - What is benefit? - If it is ommited, what is happen? The case of migration_host is specified. The case of nothing specified How is the following example? I hope it is good hint for you. (I'm newbie of man page of virsh, and may be I misunderstand migrateuri/migration_host. So please check and correct it.) --- diff --git a/tools/virsh.pod b/tools/virsh.pod index 02671b4..0ce0ca4 100644 --- a/tools/virsh.pod +++ b/tools/virsh.pod @@ -1236,9 +1236,8 @@ seen from the source machine. =back -When Imigrateuri is not specified, libvirt will automatically determine the -hypervisor specific URI, by looking up the target host's configured hostname. -There are a few scenarios where specifying Imigrateuri may help: +Imigrateuri is specifed for which IP/URL is used for transfer migration data. +Specifying Imigrateuri may be helpful on some scenarios. =over 4 @@ -1262,6 +1261,15 @@ order to comply with local firewall policies. =back +When Imigrateuri is not specified, libvirt will ask destination side whether +migration_host is specified or not in qemu.conf at first. If migration_host +is specified in qemu.conf, libvirt will use its network for transfer migration data. +(migration_host is useful when hosts has multiple network interface.) + +If migration_host is not specified too, then libvirt will automatically +determine the hypervisor specific URI, by looking up the target host's +configured hostname. + Optional Igraphicsuri 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 -- Thanks, On Fri, 2014-05-30 at 14:54 +0800, Chen Fan wrote: the 'migration_host' description maybe have a bit of difficulty to understand for user, so add this manual for them. Signed-off-by: Chen Fan chen.fan.f...@cn.fujitsu.com --- tools/virsh.pod | 9 - 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/tools/virsh.pod b/tools/virsh.pod index de9a4f7..8d77a2f 100644 --- a/tools/virsh.pod +++ b/tools/virsh.pod @@ -1238,6 +1238,11 @@ seen from the source machine. When Imigrateuri is not specified, libvirt will automatically determine the hypervisor specific URI, by looking up the target host's configured hostname. +In particular, some hypervisors support having this migration hostname specified +separately by setting 'migration_host' in definition file, if 'migration_host' +is specified, the hostname or IP address will be used to as the default Imigrateuri +while running migration from source host. if 'migration_host' is not specified, +the migration hostname is set to the host's configured hostname by default. There are a few scenarios where specifying Imigrateuri may help: =over 4 @@ -1251,7 +1256,9 @@ explicitly specified, using an IP address, or a correct hostname. interfaces, it might be desirable for the migration data stream to be sent over a specific interface for either security or performance reasons. In this case Imigrateuri should be explicitly specified, using an IP address associated -with the network to be used. +with the network to be used. In particular, Some hypervisors could be easy to +specify the default network interface by setting 'migration_host'. then the +Imigrateuri can be omitted. =item * The firewall restricts what ports are available. When libvirt generates a migration URI, it will pick a port number using hypervisor specific rules. -- Yasunori Goto y-g...@jp.fujitsu.com -- libvir-list mailing list libvir-list@redhat.com https://www.redhat.com/mailman/listinfo/libvir-list
Re: [libvirt] [PATCH] manual: Add virsh manual about specified migration host
On Fri, 2014-06-06 at 15:57 +0900, Yasunori Goto wrote: Chen-san, ping... I suppose it seems to be difficult for users to understand... I think following order of description is desirable. - What is migrateuri? - What is benefit? - If it is ommited, what is happen? The case of migration_host is specified. The case of nothing specified How is the following example? I hope it is good hint for you. (I'm newbie of man page of virsh, and may be I misunderstand migrateuri/migration_host. So please check and correct it.) --- diff --git a/tools/virsh.pod b/tools/virsh.pod index 02671b4..0ce0ca4 100644 --- a/tools/virsh.pod +++ b/tools/virsh.pod @@ -1236,9 +1236,8 @@ seen from the source machine. =back -When Imigrateuri is not specified, libvirt will automatically determine the -hypervisor specific URI, by looking up the target host's configured hostname. -There are a few scenarios where specifying Imigrateuri may help: +Imigrateuri is specifed for which IP/URL is used for transfer migration data. +Specifying Imigrateuri may be helpful on some scenarios. =over 4 @@ -1262,6 +1261,15 @@ order to comply with local firewall policies. =back +When Imigrateuri is not specified, libvirt will ask destination side whether +migration_host is specified or not in qemu.conf at first. If migration_host +is specified in qemu.conf, libvirt will use its network for transfer migration data. +(migration_host is useful when hosts has multiple network interface.) I think directly pointing out the specific file 'qemu.conf' is not good idea. because virsh man page is for all hypervisors including Xen, LXC, etc. Ah, yes. I forgot it. Sorry. I think it should be said For QEMU/KVM to be better. Ok. Thanks, Thanks, Chen + +If migration_host is not specified too, then libvirt will automatically +determine the hypervisor specific URI, by looking up the target host's +configured hostname. + Optional Igraphicsuri 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 -- Thanks, On Fri, 2014-05-30 at 14:54 +0800, Chen Fan wrote: the 'migration_host' description maybe have a bit of difficulty to understand for user, so add this manual for them. Signed-off-by: Chen Fan chen.fan.f...@cn.fujitsu.com --- tools/virsh.pod | 9 - 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/tools/virsh.pod b/tools/virsh.pod index de9a4f7..8d77a2f 100644 --- a/tools/virsh.pod +++ b/tools/virsh.pod @@ -1238,6 +1238,11 @@ seen from the source machine. When Imigrateuri is not specified, libvirt will automatically determine the hypervisor specific URI, by looking up the target host's configured hostname. +In particular, some hypervisors support having this migration hostname specified +separately by setting 'migration_host' in definition file, if 'migration_host' +is specified, the hostname or IP address will be used to as the default Imigrateuri +while running migration from source host. if 'migration_host' is not specified, +the migration hostname is set to the host's configured hostname by default. There are a few scenarios where specifying Imigrateuri may help: =over 4 @@ -1251,7 +1256,9 @@ explicitly specified, using an IP address, or a correct hostname. interfaces, it might be desirable for the migration data stream to be sent over a specific interface for either security or performance reasons. In this case Imigrateuri should be explicitly specified, using an IP address associated -with the network to be used. +with the network to be used. In particular, Some hypervisors could be easy to +specify the default network interface by setting 'migration_host'. then the +Imigrateuri can be omitted. =item * The firewall restricts what ports are available. When libvirt generates a migration URI, it will pick a port number using hypervisor specific rules. -- Yasunori Goto y-g...@jp.fujitsu.com -- libvir-list mailing list libvir-list@redhat.com https://www.redhat.com/mailman/listinfo/libvir-list