virt-v2v-output-local(1)

1virt-v2v-output-local(1)    Virtualization Support    virt-v2v-output-local(1)
2
3
4

NAME

6       virt-v2v-output-local - Using virt-v2v to convert guests to local files
7       or libvirt
8

SYNOPSIS

10        virt-v2v [-i* options] [-o libvirt] -os POOL
11
12        virt-v2v [-i* options] -o local -os DIRECTORY
13
14        virt-v2v [-i* options] -o qemu -os DIRECTORY [--qemu-boot]
15
16        virt-v2v [-i* options] -o null
17

DESCRIPTION

19       This page documents how to use virt-v2v(1) to convert guests to local
20       files or to a locally running libvirt instance.  There are four output
21       modes you can select on the virt-v2v command line:
22
23       -o libvirt -os "POOL"
24       -os "POOL"
25           This converts the guest to a libvirt directory pool call "POOL",
26           and instantiates the guest in libvirt (but does not start it
27           running).  See "OUTPUT TO LIBVIRT" below.
28
29           -o libvirt is the default if no -o option is given, so you can omit
30           it.
31
32       -o local -os "DIRECTORY"
33           This converts the guest to files in "DIRECTORY".  A libvirt XML
34           file is also created, but unlike -o libvirt the guest is not
35           instantiated in libvirt, only files are created.
36
37           The files will be called:
38
39            NAME-sda, NAME-sdb, etc.      Guest disk(s).
40            NAME.xml                      Libvirt XML.
41
42           where "NAME" is the guest name.
43
44       -o qemu -os "DIRECTORY"
45       -o qemu -os "DIRECTORY" --qemu-boot
46           This converts the guest to files in "DIRECTORY".  Unlike -o local
47           above, a shell script is created which contains the raw qemu
48           command you would need to boot the guest.  However the shell script
49           is not run, unless you also add the --qemu-boot option.
50
51       -o null
52           The guest is converted, but the final result is thrown away and no
53           metadata is created.  This is mainly useful for testing.
54

OUTPUT TO LIBVIRT

56       The -o libvirt option lets you upload the converted guest to a libvirt-
57       managed host.  There are several limitations:
58
59       •   You can only use a local libvirt connection [see below for how to
60           workaround this].
61
62       •   The -os pool option must specify a directory pool, not anything
63           more exotic such as iSCSI [but see below].
64
65       •   You can only upload to a KVM hypervisor.
66
67   Workaround for output to a remote libvirt instance and/or a non-directory
68       storage pool
69       1.  Use virt-v2v in -o local mode to convert the guest disks and
70           metadata into a local temporary directory:
71
72            virt-v2v [...] -o local -os /var/tmp
73
74           This creates two (or more) files in /var/tmp called:
75
76            /var/tmp/NAME.xml     # the libvirt XML (metadata)
77            /var/tmp/NAME-sda     # the guest’s first disk
78
79           (for "NAME" substitute the guest’s name).
80
81       2.  Upload the converted disk(s) into the storage pool called "POOL":
82
83            size=$(stat -c%s /var/tmp/NAME-sda)
84            virsh vol-create-as POOL NAME-sda $size --format raw
85            virsh vol-upload --pool POOL NAME-sda /var/tmp/NAME-sda
86
87       3.  Edit /var/tmp/NAME.xml to change /var/tmp/NAME-sda to the pool
88           name.  In other words, locate the following bit of XML:
89
90            <disk type='file' device='disk'>
91              <driver name='qemu' type='raw' />
92              <source file='/var/tmp/NAME-sda' />
93              <target dev='hda' bus='ide' />
94            </disk>
95
96           and change two things: The "type='file'" attribute must be changed
97           to "type='volume'", and the "<source>" element must be changed to
98           include "pool" and "volume" attributes:
99
100            <disk type='volume' device='disk'>
101              ...
102              <source pool='POOL' volume='NAME-sda' />
103              ...
104            </disk>
105
106       4.  Define the final guest in libvirt:
107
108            virsh define /var/tmp/NAME.xml
109

AUTHOR

114       Richard W.M. Jones
115

COPYRIGHT

117       Copyright (C) 2009-2020 Red Hat Inc.
118

LICENSE

120       This program is free software; you can redistribute it and/or modify it
121       under the terms of the GNU General Public License as published by the
122       Free Software Foundation; either version 2 of the License, or (at your
123       option) any later version.
124
125       This program is distributed in the hope that it will be useful, but
126       WITHOUT ANY WARRANTY; without even the implied warranty of
127       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
128       General Public License for more details.
129
130       You should have received a copy of the GNU General Public License along
131       with this program; if not, write to the Free Software Foundation, Inc.,
132       51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
133

BUGS

135       To get a list of bugs against libguestfs, use this link:
136       https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
137
138       To report a new bug against libguestfs, use this link:
139       https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
140
141       When reporting a bug, please supply:
142
143       •   The version of libguestfs.
144
145       •   Where you got libguestfs (eg. which Linux distro, compiled from
146           source, etc)
147
148       •   Describe the bug accurately and give a way to reproduce it.
149
150       •   Run libguestfs-test-tool(1) and paste the complete, unedited output
151           into the bug report.
152
153
154
155virt-v2v-2.2.0                    2023-01-10          virt-v2v-output-local(1)