1virt-v2v-copy-to-local(1) Virtualization Support virt-v2v-copy-to-local(1)
2
3
4
6 virt-v2v-copy-to-local - Copy a remote guest to the local machine
7
9 virt-v2v-copy-to-local -ic LIBVIRT_URI GUEST
10
11 virt-v2v-copy-to-local -ic xen+ssh://root@xen.example.com xen_guest
12
14 "virt-v2v-copy-to-local" copies a guest from a remote hypervisor to the
15 local machine, in preparation for conversion by virt-v2v(1). Note this
16 tool alone does not do the virt-v2v conversion.
17
18 When to use this tool
19 This tool is not usually necessary, but there are a few special cases
20 (see list below) where you might need it.
21
22 If your case does not fit one of these special cases, then ignore this
23 tool and read virt-v2v(1) instead. The virt-v2v-copy-to-local process
24 is slower than using virt-v2v directly, because it has to copy unused
25 parts of the guest disk.
26
27 · You have a Xen guest using host block devices. Virt-v2v cannot
28 convert such guests directly.
29
30 See virt-v2v-input-xen(1).
31
32 How this tool works
33 This tool uses libvirt to get the libvirt XML (metadata) of the remote
34 guest, essentially equivalent to running "virsh dumpxml guest".
35
36 It then uses the XML to locate the remote guest disks, which are copied
37 over using a hypervisor-specific method. It uses ssh for remote Xen
38 hypervisors.
39
40 It then modifies the libvirt XML so that it points at the local copies
41 of the guest disks.
42
43 The libvirt XML is output to a file called guest.xml (where guest is
44 the name of the guest). The disk(s) are output to file(s) called
45 guest-disk1, guest-disk2 and so on.
46
47 After copying the guest locally, you can convert it using:
48
49 virt-v2v -i libvirtxml guest.xml [-o options ...]
50
51 Virt-v2v finds the local copies of the disks by looking in the XML.
52
54 Copy and convert from Xen hypervisor that uses host block devices
55 For full instructions, see virt-v2v-input-xen(1).
56
57 virt-v2v-copy-to-local -ic xen+ssh://root@xen.example.com xen_guest
58 virt-v2v -i libvirtxml xen_guest.xml -o local -os /var/tmp
59 rm xen_guest.xml xen_guest-disk*
60
62 --help
63 Display help.
64
65 -ic libvirtURI
66 Specify a libvirt connection URI
67
68 -ip file
69 Instead of asking for password(s) interactively, pass the password
70 through a file. Note the file should contain the whole password,
71 without any trailing newline, and for security the file should have
72 mode 0600 so that others cannot read it.
73
74 Currently this option does not have any effect on xen+ssh
75 transfers, but that is a bug.
76
77 -q
78 --quiet
79 This disables progress bars and other unnecessary output.
80
81 -v
82 --verbose
83 Enable verbose messages for debugging.
84
85 -V
86 --version
87 Display version number and exit.
88
90 virt-v2v(1), virsh(1), http://libguestfs.org/,
91 https://libvirt.org/uri.html, https://libvirt.org/remote.html.
92
94 Richard W.M. Jones http://people.redhat.com/~rjones/
95
97 Copyright (C) 2009-2020 Red Hat Inc.
98
100 This program is free software; you can redistribute it and/or modify it
101 under the terms of the GNU General Public License as published by the
102 Free Software Foundation; either version 2 of the License, or (at your
103 option) any later version.
104
105 This program is distributed in the hope that it will be useful, but
106 WITHOUT ANY WARRANTY; without even the implied warranty of
107 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
108 General Public License for more details.
109
110 You should have received a copy of the GNU General Public License along
111 with this program; if not, write to the Free Software Foundation, Inc.,
112 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
113
115 To get a list of bugs against libguestfs, use this link:
116 https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
117
118 To report a new bug against libguestfs, use this link:
119 https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
120
121 When reporting a bug, please supply:
122
123 · The version of libguestfs.
124
125 · Where you got libguestfs (eg. which Linux distro, compiled from
126 source, etc)
127
128 · Describe the bug accurately and give a way to reproduce it.
129
130 · Run libguestfs-test-tool(1) and paste the complete, unedited output
131 into the bug report.
132
133
134
135virt-v2v-1.43.1 2020-06-19 virt-v2v-copy-to-local(1)