Procedure 3.2. Preparing to convert a virtual machine

1. Create an NFS export domain. virt-v2v can transfer the converted virtual machine directly to an NFS export storage domain. From the export storage domain, the virtual machine can be imported into a Red Hat Enterprise Virtualization data center. The storage domain must be mountable by the machine running virt-v2v. When exporting to a Red Hat Enterprise Virtualization export domain, virt-v2v must run as root.

   Note

   The export storage domain is accessed as an NFS share. By default, Red Hat Enterprise Linux 6 uses NFSv4, which does not require further configuration. However, for NFSv2 and NFSv3 clients, the rpcbind and nfslock services must be running on the host used to run virt-v2v. The network must also be configured to allow NFS access to the storage server. For more details refer to the Red Hat Enterprise Linux Storage Administration Guide.
2. Specify network mappings in virt-v2v.conf. This step is optional, and is not required for most use cases.
   If your virtual machine has multiple network interfaces, /etc/virt-v2v.conf must be edited to specify the network mapping for all interfaces. You can specify an alternative virt-v2v.conf file with the -f parameter. If you are converting a virtual machine for output to both libvirt and Red Hat Enterprise Virtualization, separate virt-v2v.conf files should be used for each conversion. This is because the destination network bridge corresponding to the same source network bridge is usually different for libvirt and Red Hat Enterprise Virtualization output.
   If your virtual machine only has a single network interface, it is simpler to use the --network or --bridge parameters, rather than modifying virt-v2v.conf.
3. Create a profile for the conversion in virt-v2v.conf. This step is optional. Profiles specify a conversion method, storage location, output format and allocation policy. When a profile is defined, it can be called using --profile rather than individually providing the -o, -os, -of and -oa parameters. See virt-v2v.conf(5) for details.

Procedure 3.8. Importing and running the converted virtual machine

1. In the Red Hat Enterprise Virtualization administration portal, select the export domain from the Storage tab. The export domain must have a status of Active.
2. Select the VM Import tab in the details pane to list the available virtual machines to import.
3. Select one or more virtual machines and click Import. The Import Virtual Machine(s) window will open.
4. In the drop-down menus, select the select the Default Storage Domain, Cluster, and Cluster Quota in the data center.
5. Select the Collapse All Snapshots check box to remove snapshot restore points and include templates in template-based virtual machines. Click OK to import the virtual machines.

Procedure 3.9. Scripting the v2v process

1. Use virt-v2v to convert the virtual machines and copy them to the export storage domain. This step must be run on a Linux host. The process is detailed in Section 3.3.2, "Converting a virtual machine".
2. Once the conversion is complete, use the Red Hat Enterprise Virtualization administration portal to import the virtual machines from the export storage domain. This step must be run on the Red Hat Enterprise Virtualization Manager server.
   

   Figure 3.4. Importing a virtual machine with the Red Hat Enterprise Virtualization administration portal

   
   
   Alternately, the Python SDK or the command line can also be used to import the virtual machines from the export storage domain:
   To import the virtual machines using the SDK, use the following:

   Example 3.4. Importing virtual machines from the export storage domain using the SDK

   api = API(url="http(s)://...:.../api",  username="...",  password="...",  filter=False,  debug=True)sd = api.storagedomains.get(id="from-sd-id")import_candidate = sd.vms.get(id="vm-to-import")import_candidate.import_vm(action=params.Action(cluster=api.clusters.get(id="to-cluster-id"), storage_domain=api.storagedomains.get(id="to-sd-id")))

   
   

   Note

   When using the SDK method, entities can also be fetched and passed using name=.
   To import the virtual machines using the command line, connect to the Red Hat Enterprise Virtualization Manager shell and use the following command:

   Example 3.5. Importing virtual machines from the export storage domain using the command line

   action vm "vm-to-import" import_vm --storagedomain-identifier "from-sd-id" --cluster-id "to-cluster-id" --storage_domain-id "to-sd-id"

   
   

   Note

   When using the command line method, entities can also be fetched and passed using -name.

Procedure 3.10. Configuring and running the scripted bulk v2v process

1. Ensure the REST API is enabled on the Red Hat Enterprise Virtualization Manager, and it is accessible from the Linux host running the v2v process. For more information about the REST API, see the Red Hat Enterprise Virtualization REST API Guide.
2. On the Linux host, create the file v2v.sh with the following contents. Ensure you edit the script to contain appropriate values for your environment.

   Example 3.6. Single host v2v script

   #!/bin/sh# Declare all VMs to importXENDOMAINS=("rhelxen" "rhel5")KVMDOMAINS=("rhelkvm")VMWAREVMS=("rhel54vmware")# Iterate through each Xen domain, performing the conversionfor domain in ${XENDOMAINS[@]}do virt-v2v -ic xen:///localhost -o rhev -os storage.example.com:/exportdomain --network rhevm $domaindone# Iterate through each KVM domain, performing the conversionfor domain in ${KVMDOMAINS[@]}do virt-v2v -o rhev -os storage.example.com:/exportdomain --network rhevm $domaindone# Iterate through each VMware VM, performing the conversionfor vm in ${VMWAREVMS[@]}do virt-v2v -ic esx://esx.example.com/?no_verify=1 -o rhev -os storage.example.com:/exportdomain --network rhevm $vmdone# Call the import VM procedure remotely on the RHEV Managerexport BASE_URL='https://[rhevm-host]'export HTTP_USER='user@internal'export HTTP_PASSWORD='password'curl -o rhevm.cer http://[rhevm-host]/ca.crt# Get the export storage domainscurl -X GET -H "Accept: application/xml" -u "${HTTP_USER}:${HTTP_PASSWORD}" --cacert rhevm.cer ${BASE_URL}/api/storagedomains?search=nfs_export -o exportdomainEXPORT_DOMAIN=`xpath exportdomain '/storage_domains/storage_domain/@id' | sed -e 's/ id=//' | sed -e 's/"//g'`# Get the datacentercurl -X GET -H "Accept: application/xml" -u "${HTTP_USER}:${HTTP_PASSWORD}" --cacert rhevm.cer ${BASE_URL}/api/datacenters?search=NFS -o dcDC=`xpath dc '/data_centers/data_center/@id' | sed -e 's/ id=//' | sed -e 's/"//g'`# Get the clustercurl -X GET -H "Accept: application/xml" -u "${HTTP_USER}:${HTTP_PASSWORD}" --cacert rhevm.cer ${BASE_URL}/api/clusters?search=NFS -o clusterCLUSTER_ELEMENT=`xpath cluster '/clusters/cluster/@id' | sed -e 's/ id=//' | sed -e 's/"//g'`# List contents of export storage domaincurl -X GET -H "Accept: application/xml" -u "${HTTP_USER}:${HTTP_PASSWORD}" --cacert rhevm.cer ${BASE_URL}/api/storagedomains/${EXPORT_DOMAIN}/vms -o vms# For each vm, exportVMS=`xpath vms '/vms/vm/actions/link[@rel="import"]/@href' | sed -e 's/ class="edunwman1" href="//g' | sed -e 's/"/ /g'`for vms in $VMSdo curl -v -u "${HTTP_USER}:${HTTP_PASSWORD}" -H "Content-type: application/xml" -d '<action><cluster><name>cluster_name</name></cluster><storage_domain><name>data_domain</name></storage_domain><overwrite>true</overwrite><discard_snapshots>true</discard_snapshots></action>' --cacert rhevm.cer ${BASE_URL}$vmsdone

   
   

   Note

   Use the POST method to export virtual machines with the REST API. For more information about using the REST API, see the Red Hat Enterprise Virtualization REST API Guide.
3. Run the v2v.sh script. It can take several hours to convert and import a large number of virtual machines.