Chapter 7. References This chapter contains reference information for virt-v2v . 7.1. virt-v2v Parameters The following parameters can be used with virt-v2v : -i input Specifies the input method to obtain the guest for conversion. The default is libvirt. Supported options are: libvirt Guest argument is the name of a libvirt domain. libvirtxml Guest argument is the path to an XML file containing a libvirt domain. -ic URI Specifies the connection to use with the libvirt input method. If omitted, this defaults to qemu:///system . Note, this only works when virt-v2v is run as root. virt-v2v can currently automatically obtain guest storage from local libvirt connections, ESX / ESX(i) connections, and connections over SSH. Other types of connection are not supported. -o method Specifies the output method. If no output method is specified, the default is libvirt. Supported output methods are: libvirt Create a libvirt guest. See the -oc and -os options. -os must be specified for the libvirt output method. rhev Create a guest on a Red Hat Enterprise Virtualization export storage domain, which can later be imported using the Manager. The export storage domain must be specified using -os for the rhev output method. -oc URI Specifies the libvirt connection to use to create the converted guest. If omitted, this defaults to qemu:///system if virt-v2v is run as root. Note that virt-v2v must be able to write directly to storage described by this libvirt connection. This makes writing to a remote connection impractical at present. -os storage Specifies the location where new storage will be created for the converted guest. This is dependent on the output method, specified by the -o parameter. For the libvirt output method, this must be the name of a storage pool. For the rhev output method, this specifies the NFS path to a Red Hat Enterprise Virtualization export storage domain. Note that the storage domain must have been previously initialized by the Red Hat Enterprise Virtualization Manager. The domain must be in the format < host >:< path >, for example, rhev-storage.example.com:/rhev/export . The NFS export must be mountable and writable by the host running virt-v2v . -op pool (deprecated) This parameter is still supported, but is deprecated in favor of -os . -osd domain (deprecated) This parameter is still supported, but is deprecated in favor of -os . -of format Specifies the on-disk format which will be used for the converted guest. Currently supported options are raw and qcow2 . The output format does not need to be the same as the source format - virt-v2v can convert from raw to qcow2 and vice versa. If not specified, the converted guest will use the same format as the source guest. -oa allocation Specifies whether the converted guest should use sparse or preallocated storage. The allocation scheme does not need to be the same as the source scheme: virt-v2v can convert from sparse to preallocated and vice versa. If not specified, the converted guest will use the same allocation scheme as the source. -on outputname Renames the guest. If this option is not used, then the output name is the same as the input name. -f file | --config file Load a virt-v2v configuration from file. Multiple configuration files can be specified; these will be searched in the order in which they are specified. If no configuration is specified, the defaults are /etc/virt-v2v.conf and /var/lib/virt-v2v/virt-v2v.db in that order. Important When overriding the default configuration details, we recommend also specifying /var/lib/virt-v2v/virt-v2v.db , as it contains default configuration data required for conversions. -n network | --network network Map all guest bridges or networks which do not have a mapping in the configuration file to the specified network. This option cannot be used in conjunction with --bridge . -b bridge | --bridge bridge Map all guest bridges or networks which do not have a mapping in the configuration file to the specified bridge. This option cannot be used in conjunction with --network . -p profile | --profile profile Use the default values for output method, output storage and network mappings from profile in the configuration file. --root= filesystem In a multi-boot virtual machine, select the root file system to be converted. The default value for this option is --root=ask . When this option is selected, virt-v2v lists the possible root file systems and asks the user which file system should be used. Warning In versions of Red Hat Enterprise Linux earlier than version 6.3, the default value was --root=single , which could cause virt-v2v to fail when a multi-boot virtual machine was detected. Other available options include: first Selects the first root device if multiple devices are detected. Since this is a heuristic, the choice may not always be correct. single Specifies that there is only one root device available to use. virt-v2v will fail if more than one device is detected. <path> Specifies a particular root device to use, for example, --root=/dev/sda2 would specify the second partition on the first hard drive. If the specified device does not exist or was not detected as a root device, virt-v2v will fail. --list-profiles Display a list of target profile names specified in the configuration file. --help Display brief help. --version Display version number and exit.

Commands: