virt-v2v-copy-to-local(1)

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

NAME

6       virt-v2v-copy-to-local - Copy a remote guest to the local machine
7

SYNOPSIS

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

DESCRIPTION

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

EXAMPLES

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

OPTIONS

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

AUTHORS

94       Richard W.M. Jones http://people.redhat.com/~rjones/
95

COPYRIGHT

97       Copyright (C) 2009-2019 Red Hat Inc.
98

LICENSE

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

BUGS

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
135libguestfs-1.40.2                 2019-02-07         virt-v2v-copy-to-local(1)