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