From ec25f65e929813530d4ff5bbf027bccaf2137b2b Mon Sep 17 00:00:00 2001 From: "Richard W.M. Jones" Date: Tue, 16 Feb 2016 12:29:41 +0000 Subject: [PATCH] v2v: glance: Add "OUTPUT TO GLANCE" section to the documentation. (cherry picked from commit bae3d92e88b7e74af11a5d0905710cf00f2504e3) --- v2v/virt-v2v.pod | 25 ++++++++++++++++++++++--- 1 file changed, 22 insertions(+), 3 deletions(-) diff --git a/v2v/virt-v2v.pod b/v2v/virt-v2v.pod index b8caebc..876d5f6 100644 --- a/v2v/virt-v2v.pod +++ b/v2v/virt-v2v.pod @@ -116,7 +116,7 @@ run on OpenStack (only KVM-based OpenStack is supported), you can do: virt-v2v -i disk disk.img -o glance -To control the name of the image in Glance, use the I<-on> option. +See L below. =head2 Convert disk image to disk image @@ -309,8 +309,7 @@ This is the same as I<-o local>. =item B<-o glance> Set the output method to OpenStack Glance. In this mode the converted -guest is uploaded to Glance. You can control the image name by setting -the I<-on> option. +guest is uploaded to Glance. See L below. =item B<-o libvirt> @@ -1139,6 +1138,26 @@ additional details. If you export several guests, then you can import them all at the same time through the UI. +=head1 OUTPUT TO GLANCE + +To output to OpenStack Glance, use the I<-o glance> option. + +This runs the L CLI program which must be installed on the +virt-v2v conversion host. For authentication to work, you will need +to set C environment variables. In most cases you can do this +by sourcing a file called something like F. + +Virt-v2v adds metadata for the guest to Glance, describing such things +as the guest operating system and what drivers it requires. The +command C will display the metadata as "Property" +fields such as C and C. + +=head2 Glance and sparseness + +Glance image upload doesn't appear to correctly handle sparseness. +For this reason, using qcow2 will be faster and use less space on the +Glance server. Use the virt-v2v S> option. + =head1 RESOURCE REQUIREMENTS =head2 Network -- 1.8.3.1