4.3.2.4. Converting a local KVM virtual machine


Use the following procedure to convert a local KVM virtual machine:

Procedure 4.6. Converting a local KVM virtual machine

  1. Stop the virtual machine.

    1. Ensure that the virtual machine is stopped prior to running the v2v process. If the virtual machine is in a clustered Red Hat Enterprise Linux HA virtual machine environment, stop and disable the virtual machine resource in cluster node using the command:
      clusvcadm -d vm:<guest>
      Copy to Clipboard Toggle word wrap
    2. After stopping the virtual machine, run virsh define <path-to-guest.xml> to place the stopped virtual machine under the control of libvirt. This command allows virt-v2v to recognize the virtual machine and enable it to be converted.
  2. Convert the virtual machine.

    To convert the virtual machine, run:
    virt-v2v -o rhev -os storage.example.com:/exportdomain --network rhevm guest_name
    Copy to Clipboard Toggle word wrap
    Where storage.example.com:/exportdomain is the export storage domain, rhevm is the locally managed network to connect the converted virtual machine's network to, and guest_name is the name of the KVM virtual machine.
    You may also use the --bridge parameter to connect to a locally managed network if your virtual machine only has a single network interface. If your virtual machine has multiple network interfaces, edit /etc/virt-v2v.conf to specify the network mapping for all interfaces.
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2026 Red Hat
Back to top