.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Podwrapper::Man 2.4.0 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "virt-v2v-input-vmware 1"
.TH virt-v2v-input-vmware 1 2024-01-04 virt-v2v-2.4.0 "Virtualization Support"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH 名前
.IX Header "名前"
virt\-v2v\-input\-vmware \- Using virt\-v2v to convert guests from VMware
.SH 書式
.IX Header "書式"
.Vb 1
\& virt\-v2v \-i vmx GUEST.vmx [\-o* options]
\&
\& virt\-v2v \-i vmx
\&    \-it ssh
\&    \-ip passwordfile
\&    \*(Aqssh://root@esxi.example.com/vmfs/volumes/datastore1/guest/guest.vmx\*(Aq
\&    [\-o* options]
\&
\& virt\-v2v
\&    \-ic \*(Aqvpx://root@vcenter.example.com/Datacenter/esxi?no_verify=1\*(Aq
\&    \-it vddk
\&    \-io vddk\-libdir=/path/to/vmware\-vix\-disklib\-distrib
\&    \-io vddk\-thumbprint=xx:xx:xx:...
\&    "GUEST NAME"
\&    [\-o* options]
\&
\& virt\-v2v \-i ova DISK.ova [\-o* options]
\&
\& virt\-v2v
\&    \-ic \*(Aqvpx://root@vcenter.example.com/Datacenter/esxi?no_verify=1\*(Aq
\&    \-ip passwordfile
\&    "GUEST NAME" [\-o* options]
.Ve
.SH 説明
.IX Header "説明"
This page documents how to use \fBvirt\-v2v\fR\|(1) to convert guests from VMware.  There are currently five different methods to access VMware:
.IP "\fB\-i vmx\fR GUEST\fB.vmx\fR" 4
.IX Item "-i vmx GUEST.vmx"
Full documentation: "INPUT FROM VMWARE VMX"
.Sp
If you either have a \fIGUEST.vmx\fR file and one or more \fIGUEST.vmdk\fR disk image files, or if you are able to NFS-mount the VMware storage, then you can use the \fI\-i vmx\fR method to read the source guest.
.IP "\fB\-i vmx\fR \fB\-it ssh\fR ssh://..." 4
.IX Item "-i vmx -it ssh ssh://..."
Full documentation: "INPUT FROM VMWARE VMX"
.Sp
This is similar to the method above, except it uses an SSH connection to ESXi to read the \fIGUEST.vmx\fR file and associated disks.  This requires that you have enabled SSH access to the VMware ESXi hypervisor \- in the default ESXi configuration this is turned off.
.Sp
This transport is incompatible with guests that have snapshots; refer to "NOTES".
.IP "\fB\-ic vpx://...\fR \fB\-it vddk\fR" 4
.IX Item "-ic vpx://... -it vddk"
.PD 0
.IP "\fB\-ic esx://...\fR \fB\-it vddk\fR" 4
.IX Item "-ic esx://... -it vddk"
.PD
Full documentation: "INPUT FROM VDDK"
.Sp
This method uses the proprietary VDDK library (a.k.a. VixDiskLib) to access the VMware vCenter server or VMware ESXi hypervisor.
.Sp
If you have the proprietary library then this method is usually the fastest and most flexible.  If you don't have or don't want to use non-free software then the VMX or SSH methods above will be best.
.IP "\fB\-i ova\fR DISK\fB.ova\fR" 4
.IX Item "-i ova DISK.ova"
Full documentation: "INPUT FROM VMWARE OVA"
.Sp
With this method you must first export the guest (eg. from vSphere) as an \fI.ova\fR file, which virt\-v2v can then read directly.  Note this method only works with files exported from VMware, not OVA files that come from other hypervisors or management systems, since OVA is only a pretend standard and is not compatible or interoperable between vendors.
.IP "\fB\-ic vpx://...\fR ""GUEST NAME""" 4
.IX Item "-ic vpx://... ""GUEST NAME"""
Full documentation: "INPUT FROM VMWARE VCENTER SERVER"
.Sp
If none of the above methods is available, then use this method to import a guest from VMware vCenter.  This is the slowest method.
.SH 注記
.IX Header "注記"
When accessing the \fIguest.vmx\fR file on ESXi over an SSH connection (that is, when using the \fI\-i vmx\fR \fI\-it ssh\fR options), the conversion will not work if the guest has snapshots (files called \fIguest\-000001.vmdk\fR and similar).  Either collapse the snapshots for the guest and retry the conversion with the same \fI\-i vmx\fR \fI\-it ssh\fR options, or leave the snapshots intact and use a transport different from SSH: just \fI\-i vmx\fR, or \fI\-ic vpx://...\fR \fI\-it vddk\fR or \fI\-ic esx://...\fR \fI\-it vddk\fR.  Refer to https://bugzilla.redhat.com/1774386.
.SH "INPUT FROM VMWARE VMX"
.IX Header "INPUT FROM VMWARE VMX"
Virt\-v2v is able to import guests from VMware’s vmx files.
.PP
This is useful in two cases:
.IP 1. 4
VMware virtual machines are stored on a separate NFS server and you are able to mount the NFS storage directly.
.IP 2. 4
You have enabled SSH access to the VMware ESXi hypervisor and there is a \f(CW\*(C`/vmfs/volumes\*(C'\fR folder containing the virtual machines.
.PP
If you find a folder of files called \fIguest.vmx\fR, \fIguest.vmxf\fR, \fIguest.nvram\fR and one or more \fI.vmdk\fR disk images, then you can use this method.  The SSH transport is not usable if the guest has snapshots; refer to "NOTES".
.SS "VMX: Guest must be shut down"
.IX Subsection "VMX: Guest must be shut down"
\&\fBThe guest must be shut down before conversion starts\fR.  If you don't shut it down, you will end up with a corrupted VM disk on the target.  With other methods, virt\-v2v tries to prevent concurrent access, but because the \fI\-i vmx\fR method works directly against the storage, checking for concurrent access is not possible.
.SS "VMX: Access to the storage containing the VMX and VMDK files"
.IX Subsection "VMX: Access to the storage containing the VMX and VMDK files"
If the vmx and vmdk files aren't available locally then you must \fIeither\fR mount the NFS storage on the conversion server \fIor\fR enable passwordless SSH on the ESXi hypervisor.
.PP
\fIVMX: SSH authentication\fR
.IX Subsection "VMX: SSH authentication"
.PP
You can use SSH password authentication, by supplying the name of a file containing the password to the \fI\-ip\fR option (note this option does \fInot\fR take the password directly).  You may need to adjust \fI/etc/ssh/sshd_config\fR on the VMware server to set \f(CW\*(C`PasswordAuthentication yes\*(C'\fR.
.PP
If you are not using password authentication, an alternative is to use ssh-agent, and add your ssh public key to \fI/etc/ssh/keys\-root/authorized_keys\fR (on the ESXi hypervisor).  After doing this, you should check that passwordless access works from the virt\-v2v server to the ESXi hypervisor.  For example:
.PP
.Vb 2
\& $ ssh root@esxi.example.com
\& [ logs straight into the shell, no password is requested ]
.Ve
.PP
Note that support for non-interactive authentication via the \fI\-ip\fR option is incomplete.  Some operations remain that still require the user to enter the password manually.  Therefore ssh-agent is recommended over the \fI\-ip\fR option.  See https://bugzilla.redhat.com/1854275.
.PP
\fIVMX: Construct the SSH URI\fR
.IX Subsection "VMX: Construct the SSH URI"
.PP
When using the SSH input transport you must specify a remote \f(CW\*(C`ssh://...\*(C'\fR URI pointing to the VMX file.  A typical URI looks like:
.PP
.Vb 1
\& ssh://root@esxi.example.com/vmfs/volumes/datastore1/my%20guest/my%20guest.vmx
.Ve
.PP
The username is not required if it is the same as your local username.
.PP
You may optionally supply a port number after the hostname if the SSH server is not listening on the default port (22).
.PP
For determining the pathname component of the URI, log in to the ESXi server via SSH interactively, and identify the absolute pathname of the VMX file on the ESXi server, such as:
.PP
.Vb 1
\& /vmfs/volumes/datastore1/my guest/my guest.vmx
.Ve
.PP
Subsequently, on the virt\-v2v command line, percent-encode any reserved characters that you find in the individual pathname components.  For example, space characters must be specified as \f(CW%20\fR:
.PP
.Vb 1
\& /vmfs/volumes/datastore1/my%20guest/my%20guest.vmx
.Ve
.PP
Refer to https://bugzilla.redhat.com/1938954.
.SS "VMX: Importing a guest"
.IX Subsection "VMX: Importing a guest"
To import a vmx file from a local file or NFS, do:
.PP
.Vb 1
\& $ virt\-v2v \-i vmx guest.vmx \-o local \-os /var/tmp
.Ve
.PP
To import a vmx file over SSH, add \fI\-it ssh\fR to select the SSH transport and supply a remote SSH URI:
.PP
.Vb 4
\& $ virt\-v2v \e
\&     \-i vmx \-it ssh \e
\&     "ssh://root@esxi.example.com/vmfs/volumes/datastore1/guest/guest.vmx" \e
\&     \-o local \-os /var/tmp
.Ve
.PP
Virt\-v2v processes the vmx file and uses it to find the location of any vmdk disks.
.SH "INPUT FROM VDDK"
.IX Header "INPUT FROM VDDK"
Virt\-v2v is able to import guests using VMware’s proprietary VDDK library (a.k.a. VixDiskLib).
.SS "VDDK: Prerequisites"
.IX Subsection "VDDK: Prerequisites"
.IP 1. 4
As the VDDK library is not open source, and the license of this library does not permit redistribution or commercial use, you must obtain VDDK yourself and satisfy yourself that your usage of the library is permitted by the license.
.IP 2. 4
nbdkit ≥ 1.6 is recommended, as it ships with the VDDK plugin enabled unconditionally.
.IP 3. 4
You must find the SSL "thumbprint" of your VMware server.  How to do this is explained in \fBnbdkit\-vddk\-plugin\fR\|(1), also available at the link above.
.IP 4. 4
VDDK imports require a feature added in libvirt ≥ 3.7.
.SS "VDDK: ESXi NFC service memory limits"
.IX Subsection "VDDK: ESXi NFC service memory limits"
In the verbose log you may see errors like:
.PP
.Vb 3
\& nbdkit: vddk[3]: error: [NFC ERROR] NfcFssrvrProcessErrorMsg:
\& received NFC error 5 from server: Failed to allocate the
\& requested 2097176 bytes
.Ve
.PP
This seems especially common when there are multiple parallel connections open to the VMware server.
.PP
These can be caused by resource limits set on the VMware server.  You can increase the limit for the NFC service by editing \fI/etc/vmware/hostd/config.xml\fR and adjusting the \f(CW\*(C`<maxMemory>\*(C'\fR setting:
.PP
.Vb 6
\& <nfcsvc>
\&   <path>libnfcsvc.so</path>
\&   <enabled>true</enabled>
\&   <maxMemory>50331648</maxMemory>
\&   <maxStreamMemory>10485760</maxStreamMemory>
\& </nfcsvc>
.Ve
.PP
and restarting the \f(CW\*(C`hostd\*(C'\fR service:
.PP
.Vb 1
\& # /etc/init.d/hostd restart
.Ve
.PP
For more information see https://bugzilla.redhat.com/1614276.
.SS "VDDK: ""error: VixDiskLibVim: Failed to open disk using NFC. VixError 1"""
.IX Subsection "VDDK: ""error: VixDiskLibVim: Failed to open disk using NFC. VixError 1"""
If you see an error similar to:
.PP
.Vb 1
\& nbdkit: vddk[2]: error: VixDiskLibVim: Failed to open disk using NFC. VixError 1 at 1166.
.Ve
.PP
then it is caused by a bug in VDDK ≤ 6.7.  The suggested solution it to upgrade to the latest VDDK.  See also https://bugzilla.redhat.com/1684075
.SS "VDDK: URI"
.IX Subsection "VDDK: URI"
Construct the correct \f(CW\*(C`vpx://\*(C'\fR (for vCenter) or \f(CW\*(C`esx://\*(C'\fR (for ESXi)  URL. It will look something like these:
.PP
.Vb 1
\& vpx://root@vcenter.example.com/Datacenter/esxi
\&
\& esx://root@esxi.example.com
.Ve
.PP
To verify that you have the correct URL, use the \fBvirsh\fR\|(1) command to list the guests on the server:
.PP
.Vb 2
\& $ virsh \-c \*(Aqvpx://root@vcenter.example.com/Datacenter/esxi\*(Aq list \-\-all
\& Enter root\*(Aqs password for vcenter.example.com: ***
\& 
\&  Id    Name                           State
\& \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
\&  \-     Fedora 20                      shut off
\&  \-     Windows 2003                   shut off
.Ve
.PP
If you get an error "Peer certificate cannot be authenticated with given CA certificates" or similar, then you can either import the vCenter host’s certificate, or bypass signature verification by adding the \f(CW\*(C`?no_verify=1\*(C'\fR flag:
.PP
.Vb 1
\& $ virsh \-c \*(Aqvpx://root@vcenter.example.com/Datacenter/esxi?no_verify=1\*(Aq list \-\-all
.Ve
.PP
You should also try dumping the metadata from any guest on your server, like this:
.PP
.Vb 6
\& $ virsh \-c \*(Aqvpx://root@vcenter.example.com/Datacenter/esxi\*(Aq dumpxml "Windows 2003"
\& <domain type=\*(Aqvmware\*(Aq>
\&   <name>Windows 2003</name>
\&   [...]
\&   <vmware:moref>vm\-123</vmware:moref>
\& </domain>
.Ve
.PP
If \f(CW\*(C`<vmware:moref>\*(C'\fR does not appear in the metadata, then you need to upgrade libvirt.
.PP
\&\fBIf the above commands do not work, then virt\-v2v is not going to work either\fR.  Fix your URI and/or your VMware server before continuing.
.SS "VDDK: Importing a guest"
.IX Subsection "VDDK: Importing a guest"
The \fI\-it vddk\fR parameter selects VDDK as the input transport for disks.
.PP
To import a particular guest from vCenter server or ESXi hypervisor, use a command like the following, substituting the URI, guest name and SSL thumbprint:
.PP
.Vb 7
\& $ virt\-v2v \e
\&     \-ic \*(Aqvpx://root@vcenter.example.com/Datacenter/esxi?no_verify=1\*(Aq \e
\&     \-it vddk \e
\&     \-io vddk\-libdir=/path/to/vmware\-vix\-disklib\-distrib \e
\&     \-io vddk\-thumbprint=xx:xx:xx:... \e
\&     "Windows 2003" \e
\&     \-o local \-os /var/tmp
.Ve
.PP
Other options that you might need to add in rare circumstances include \fI\-io vddk-config\fR, \fI\-io vddk-cookie\fR, \fI\-io vddk-nfchostport\fR, \fI\-io vddk-port\fR, \fI\-io vddk-snapshot\fR, and \fI\-io vddk-transports\fR, which are all explained in the \fBnbdkit\-vddk\-plugin\fR\|(1) documentation.  Do not use these options unless you know what you are doing.
.SS "VDDK: Debugging VDDK failures"
.IX Subsection "VDDK: Debugging VDDK failures"
The VDDK library can be operated in a verbose mode where it gives (very) verbose messages.  Use ‘virt\-v2v \-v \-x’ as usual to enable verbose messages.
.SS "VDDK: Slow imports and repeated NBD_ClientOpen messages"
.IX Subsection "VDDK: Slow imports and repeated NBD_ClientOpen messages"
If imports over VDDK are slow, and ‘virt\-v2v \-v \-x’ shows many \f(CW\*(C`NBD_ClientOpen\*(C'\fR messages, then you are hitting an apparent bug in VDDK\ 6.7 (https://bugzilla.redhat.com/1901489).  Upgrade to at least VDDK\ 7 to resolve the issue.
.SH "INPUT FROM VMWARE OVA"
.IX Header "INPUT FROM VMWARE OVA"
Virt\-v2v is able to import guests from VMware’s OVA (Open Virtualization Appliance) files.  Only OVAs exported from VMware vSphere will work.
.SS "OVA: Create OVA"
.IX Subsection "OVA: Create OVA"
To create an OVA in vSphere, use the "Export OVF Template" option (from the VM context menu, or from the File menu).  Either "Folder of files" (OVF) or "Single file" (OVA) will work, but OVA is probably easier to deal with.  OVA files are really just uncompressed tar files, so you can use commands like \f(CW\*(C`tar tf VM.ova\*(C'\fR to view their contents.
.PP
\fICreate OVA with ovftool\fR
.IX Subsection "Create OVA with ovftool"
.PP
You can also use VMware’s proprietary \f(CW\*(C`ovftool\*(C'\fR:
.PP
.Vb 3
\& ovftool \-\-noSSLVerify \e
\&   vi://USER:PASSWORD@esxi.example.com/VM \e
\&   VM.ova
.Ve
.PP
To connect to vCenter:
.PP
.Vb 3
\& ovftool  \-\-noSSLVerify \e
\&   vi://USER:PASSWORD@vcenter.example.com/DATACENTER\-NAME/vm/VM \e
\&   VM.ova
.Ve
.PP
For Active Directory-aware authentication using down-level logon names (\f(CW\*(C`DOMAIN\eUSER\*(C'\fR), you have to express the \f(CW\*(C`\e\*(C'\fR character in the form of its ascii hex-code (\f(CW%5c\fR):
.PP
.Vb 1
\& vi://DOMAIN%5cUSER:PASSWORD@...
.Ve
.SS "OVA: Importing a guest"
.IX Subsection "OVA: Importing a guest"
To import an OVA file called \fIVM.ova\fR, do:
.PP
.Vb 1
\& $ virt\-v2v \-i ova VM.ova \-o local \-os /var/tmp
.Ve
.PP
If you exported the guest as a "Folder of files", \fIor\fR if you unpacked the OVA tarball yourself, then you can point virt\-v2v at the directory containing the files:
.PP
.Vb 1
\& $ virt\-v2v \-i ova /path/to/files \-o local \-os /var/tmp
.Ve
.SS "OVA: Permissions issues with oVirt/RHV import"
.IX Subsection "OVA: Permissions issues with oVirt/RHV import"
oVirt/RHV provides a graphical user interface for importing from OVA files which uses this method.  It requires that RHV is able to access the OVA file which can be a problem if the file is owned by root (RHV runs as a non-root user).
.PP
The suggested workaround is to copy the OVA to a public directory such as \fI/var/tmp\fR before doing the import and perhaps change the user and group ownership of the file.
.PP
For more information see these links:
.IP \(bu 4
https://access.redhat.com/documentation/en\-us/red_hat_virtualization/4.4/html\-single/virtual_machine_management_guide/index#Importing_a_virtual_machine_from_a_host
.IP \(bu 4
https://bugzilla.redhat.com/show_bug.cgi?id=2039597
.SH "INPUT FROM VMWARE VCENTER SERVER"
.IX Header "INPUT FROM VMWARE VCENTER SERVER"
Virt\-v2v is able to import guests from VMware vCenter Server.
.PP
vCenter ≥ 5.0 is required.  If you don’t have vCenter, using OVA or VMX is recommended instead (see "INPUT FROM VMWARE OVA" and/or "INPUT FROM VMWARE VMX").
.PP
Virt\-v2v uses libvirt for access to vCenter, and therefore the input mode should be \fI\-i libvirt\fR.  As this is the default, you don't need to specify it on the command line.
.SS "vCenter: URI"
.IX Subsection "vCenter: URI"
The libvirt URI of a vCenter server looks something like this:
.PP
.Vb 1
\& vpx://user@server/Datacenter/esxi
.Ve
.PP
where:
.ie n .IP """user@""" 4
.el .IP \f(CWuser@\fR 4
.IX Item "user@"
is the (optional, but recommended) user to connect as.
.Sp
If the username contains a backslash (eg. \f(CW\*(C`DOMAIN\eUSER\*(C'\fR) then you will need to URI-escape that character using \f(CW%5c\fR: \f(CW\*(C`DOMAIN%5cUSER\*(C'\fR (5c is the hexadecimal ASCII code for backslash.)  Other punctuation may also have to be escaped.
.Sp
The user's password must be supplied in a local file using the separate \fI\-ip\fR parameter.
.ie n .IP """server""" 4
.el .IP \f(CWserver\fR 4
.IX Item "server"
is the vCenter Server (\fInot\fR hypervisor).
.ie n .IP """Datacenter""" 4
.el .IP \f(CWDatacenter\fR 4
.IX Item "Datacenter"
is the name of the datacenter.
.Sp
If the name contains a space, replace it with the URI-escape code \f(CW%20\fR.
.ie n .IP """esxi""" 4
.el .IP \f(CWesxi\fR 4
.IX Item "esxi"
is the name of the ESXi hypervisor running the guest.
.PP
If the VMware deployment is using folders, then these may need to be added to the URI, eg:
.PP
.Vb 1
\& vpx://user@server/Folder/Datacenter/esxi
.Ve
.PP
For full details of libvirt URIs, see: http://libvirt.org/drvesx.html
.PP
Typical errors from libvirt / virsh when the URI is wrong include:
.IP \(bu 4
Could not find datacenter specified in [...]
.IP \(bu 4
Could not find compute resource specified in [...]
.IP \(bu 4
Path [...] does not specify a compute resource
.IP \(bu 4
Path [...] does not specify a host system
.IP \(bu 4
Could not find host system specified in [...]
.SS "vCenter: Test libvirt connection to vCenter"
.IX Subsection "vCenter: Test libvirt connection to vCenter"
Use the \fBvirsh\fR\|(1) command to list the guests on the vCenter Server like this:
.PP
.Vb 2
\& $ virsh \-c \*(Aqvpx://root@vcenter.example.com/Datacenter/esxi\*(Aq list \-\-all
\& Enter root\*(Aqs password for vcenter.example.com: ***
\& 
\&  Id    Name                           State
\& \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
\&  \-     Fedora 20                      shut off
\&  \-     Windows 2003                   shut off
.Ve
.PP
If you get an error "Peer certificate cannot be authenticated with given CA certificates" or similar, then you can either import the vCenter host’s certificate, or bypass signature verification by adding the \f(CW\*(C`?no_verify=1\*(C'\fR flag:
.PP
.Vb 1
\& $ virsh \-c \*(Aqvpx://root@vcenter.example.com/Datacenter/esxi?no_verify=1\*(Aq list \-\-all
.Ve
.PP
You should also try dumping the metadata from any guest on your server, like this:
.PP
.Vb 5
\& $ virsh \-c \*(Aqvpx://root@vcenter.example.com/Datacenter/esxi\*(Aq dumpxml "Windows 2003"
\& <domain type=\*(Aqvmware\*(Aq>
\&   <name>Windows 2003</name>
\&   [...]
\& </domain>
.Ve
.PP
\&\fBIf the above commands do not work, then virt\-v2v is not going to work either\fR.  Fix your libvirt configuration and/or your VMware vCenter Server before continuing.
.SS "vCenter: Supplying the password"
.IX Subsection "vCenter: Supplying the password"
The vCenter password (usually for the root account, or the account specified by \f(CW\*(C`user@\*(C'\fR in the vpx URL) has to be written to a local file, and the name of that file specified on the virt\-v2v command line using \fI\-ip passwordfile\fR.
.SS "vCenter: Importing a guest"
.IX Subsection "vCenter: Importing a guest"
To import a particular guest from vCenter Server, do:
.PP
.Vb 4
\& $ virt\-v2v \-ic \*(Aqvpx://root@vcenter.example.com/Datacenter/esxi?no_verify=1\*(Aq \e
\&   \-ip passwordfile \e
\&   "Windows 2003" \e
\&   \-o local \-os /var/tmp
.Ve
.PP
where \f(CW\*(C`Windows 2003\*(C'\fR is the name of the guest (which must be shut down).
.PP
In this case the output flags are set to write the converted guest to a temporary directory as this is just an example, but you can also write to libvirt or any other supported target.
.SS "vCenter: Non-administrator role"
.IX Subsection "vCenter: Non-administrator role"
Instead of using the vCenter Administrator role, you can create a custom non-administrator role to perform the conversion.  You will however need enable the following permissions (or as many as are available, older versions of VMware were missing some of these settings):
.IP 1. 4
Create a custom role in vCenter.
.IP 2. 4
Enable (check) the following objects:
.Sp
.Vb 3
\& Datastore:
\&  \- Browse datastore
\&  \- Low level file operations
\& 
\& Sessions:
\&  \- Validate session
\& 
\& Virtual Machine:
\&   Interaction:
\&     \- Guest operating system management by VIX API
\&   Provisioning:
\&     \- Allow disk access
\&     \- Allow read\-only disk access
\&     \- Allow virtual machine download
\& 
\& Cryptographic operations:
\&  \- Decrypt
\&  \- Direct Access
.Ve
.SS "vCenter: Firewall and proxy settings"
.IX Subsection "vCenter: Firewall and proxy settings"
\fIvCenter: Ports\fR
.IX Subsection "vCenter: Ports"
.PP
If there is a firewall between the virt\-v2v conversion server and the vCenter server, then you will need to open port 443 (https) and port 5480.
.PP
Port 443 is used to copy the guest disk image(s).  Port 5480 is used to query vCenter for guest metadata.
.PP
These port numbers are only the defaults.  It is possible to reconfigure vCenter to use other port numbers.  In that case you would need to specify those ports in the \f(CW\*(C`vpx://\*(C'\fR URI.  See "vCenter: URI" above.
.PP
These ports only apply to virt\-v2v conversions.  You may have to open other ports for other vCenter functionality, for example the web user interface. VMware documents the required ports for vCenter in their online documentation.
.PP
.Vb 6
\& ┌────────────┐   port 443 ┌────────────┐        ┌────────────┐
\& │ virt\-v2v   │────────────▶ vCenter    │────────▶ ESXi       │
\& │ conversion │────────────▶ server     │        │ hypervisor │
\& │ server     │  port 5480 │            │        │   ┌─────┐  │
\& └────────────┘            └────────────┘        │   │guest│  │
\&                                                 └───┴─────┴──┘
.Ve
.PP
(In the diagram above the arrows show the direction in which the TCP connection is initiated, \fInot\fR necessarily the direction of data transfer.)
.PP
Virt\-v2v itself does not connect directly to the ESXi hypervisor containing the guest.  However vCenter connects to the hypervisor and forwards the information, so if you have a firewall between vCenter and its hypervisors you may need to open additional ports (consult VMware documentation).
.PP
The proxy environment variables (\f(CW\*(C`https_proxy\*(C'\fR, \f(CW\*(C`all_proxy\*(C'\fR, \f(CW\*(C`no_proxy\*(C'\fR, \f(CW\*(C`HTTPS_PROXY\*(C'\fR, \f(CW\*(C`ALL_PROXY\*(C'\fR and \f(CW\*(C`NO_PROXY\*(C'\fR) are \fBignored\fR when doing vCenter conversions.
.SS "vCenter: SSL/TLS certificate problems"
.IX Subsection "vCenter: SSL/TLS certificate problems"
You may see this error:
.PP
.Vb 2
\&  CURL: Error opening file: SSL: no alternative certificate subject
\&  name matches target host name
.Ve
.PP
(You may need to enable debugging with ‘virt\-v2v \-v \-x’ to see this message).
.PP
This can be caused by using an IP address instead of the fully-qualified DNS domain name of the vCenter server, ie.  use \f(CW\*(C`vpx://vcenter.example.com/...\*(C'\fR instead of \f(CW\*(C`vpx://11.22.33.44/...\*(C'\fR
.PP
Another certificate problem can be caused by the vCenter server having a mismatching FQDN and IP address, for example if the server acquired a new IP address from DHCP.  To fix this you need to change your DHCP server or network configuration so that the vCenter server always gets a stable IP address.  After that log in to the vCenter server’s admin console at \f(CW\*(C`https://vcenter:5480/\*(C'\fR.  Under the \f(CW\*(C`Admin\*(C'\fR tab, select \f(CW\*(C`Certificate regeneration enabled\*(C'\fR and then reboot it.
.SS "vCenter: ""Out of HTTP sessions: Limited to ..."""
.IX Subsection "vCenter: ""Out of HTTP sessions: Limited to ..."""
VMware vCenter appears to limit HTTP sessions and in some circumstances virt\-v2v may exceed this number.  You can adjust or remove the limit by editing \fI/etc/vmware\-vpx/vpxd.cfg\fR on the vCenter server.  Increase the \f(CW\*(C`<maxSessionCount>\*(C'\fR field, or set it to \f(CW0\fR which makes it unlimited:
.PP
.Vb 3
\& <soap>
\&   <maxSessionCount>0</maxSessionCount>
\& </soap>
.Ve
.SH 関連項目
.IX Header "関連項目"
\&\fBvirt\-v2v\fR\|(1).
.SH 著者
.IX Header "著者"
Richard W.M. Jones
.SH COPYRIGHT
.IX Header "COPYRIGHT"
Copyright (C) 2009\-2020 Red Hat Inc.
.SH LICENSE
.IX Header "LICENSE"
.SH BUGS
.IX Header "BUGS"
To get a list of bugs against libguestfs, use this link:
https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
.PP
To report a new bug against libguestfs, use this link:
https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
.PP
When reporting a bug, please supply:
.IP \(bu 4
The version of libguestfs.
.IP \(bu 4
Where you got libguestfs (eg. which Linux distro, compiled from source, etc)
.IP \(bu 4
Describe the bug accurately and give a way to reproduce it.
.IP \(bu 4
Run \fBlibguestfs\-test\-tool\fR\|(1) and paste the \fBcomplete, unedited\fR
output into the bug report.