You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: source/adminguide/virtual_machines/importing_vmware_vms_into_kvm.rst
+24-25Lines changed: 24 additions & 25 deletions
Original file line number
Diff line number
Diff line change
@@ -13,18 +13,16 @@
13
13
specific language governing permissions and limitations
14
14
under the License.
15
15
16
-
.. note:: This functionality requires to install the **virt-v2v** (https://www.libguestfs.org/virt-v2v.1.html) binary installed on destination cluster hosts, as it is not a dependency of the CloudStack agent installed on the hosts.
17
-
18
-
As of CS 4.19, it is possible to select a VMware VM from an external or existing VMware datacenter, convert it to a KVM Virtual Machine and importing it into an existing KVM cluster.
16
+
.. note:: This functionality requires **virt-v2v** (https://www.libguestfs.org/virt-v2v.1.html) binary installed on destination cluster hosts (needs to be installed manually as it's not a dependency of the CloudStack agent during the agent installation.
19
17
20
18
Requirements on the KVM hosts
21
19
-----------------------------
22
20
23
-
The CloudStack agent does not install the virt-v2v binary as a dependency, for which this functionality is not supported by default. To enable this functionality, the virt-v2v binary must be installed on the destination KVM hosts where to import the Virtual Machines.
21
+
The CloudStack agent does not install the virt-v2v binary as a dependency. The virt-v2v binary must be installed manually on KVM hosts.
24
22
25
23
In case virt-v2v is not installed on a KVM host attempting a Virtual Machine conversion from VMware, the process fails.
26
24
27
-
The virt-v2v output is logged on the CloudStack agent logs to help administrators tracking the progress on the Virtual Machines conversion processes. The verbose mode for virt-v2v can be enabled by adding the following line to /etc/cloudstack/agent/agent.properties and restart cloudstack-agent:
25
+
The virt-v2v output (progress) is logged in the CloudStack agent logs, to help administrators track the progress on the Virtual Machines conversion processes. The verbose mode for virt-v2v can be enabled by adding the following line to /etc/cloudstack/agent/agent.properties and restart cloudstack-agent:
28
26
29
27
::
30
28
@@ -49,7 +47,7 @@ Linux Distribution Supported Versions
49
47
Alma Linux 8, 9
50
48
Red Hat Enterprise Linux 8, 9
51
49
Rocky Linux 8, 9
52
-
Ubuntu 22.04 LTS
50
+
Ubuntu 22.04 LTS, 24.04 LTS
53
51
======================== ========================
54
52
55
53
@@ -68,9 +66,9 @@ For Debian-based distributions:
68
66
69
67
::
70
68
71
-
apt install virtio-win
69
+
apt install virtio-win (if the package is not available, then manual steps will be required to install the virtio drivers for windows)
72
70
73
-
The OVF tool (ovftool) must be installed on the destination KVM hosts if the hosts should import VM files (OVF) from vCenter directly, if not management server imports them.
71
+
The OVF tool (ovftool) must be installed on the destination KVM hosts if the hosts should import VM files (OVF) from vCenter directly. If not, management server imports them (management server is not using ovftool, so no need to install it on the management server hosts.
74
72
75
73
Usage
76
74
-----
@@ -115,41 +113,42 @@ In the UI import wizard, you can optionally select a KVM host and temporary dest
115
113
116
114
When importing an instance from VMware to KVM, CloudStack performs the following actions:
117
115
118
-
- Import the VM files (OVF) of the instance to a temporary storage location
119
-
(which can be selected by the administrator).The import is performed on a
120
-
KVM host if ovftool installed or management server (can be forced by the
121
-
administrator). The existence of ovftool on the host is checked using
116
+
- Export the VM files (OVF) of the instance to a temporary storage location
117
+
(which can be selected by the administrator). The export is performed by a
118
+
KVM host if ovftool is installed or management server (can be forced by the
119
+
administrator, doesn't need ovftool installed on the management server).
120
+
The existence of ovftool on KVM host is checked using
122
121
``ovftool --version`` command.
123
122
124
123
- If the instance on VMWare is in **running** state, we clone the instance on
125
-
VMWare and use the new cloned instance for conversion. This is to
126
-
prevent issues with the data consistency of the instance being
127
-
imported. For large instances, the cloning process can take a long time.
124
+
VMWare and use the new cloned instance to export OVF files.
125
+
The cloning process may take some time to complete and is used to ensure data consistency,
126
+
disk consolidation, etc.
128
127
- If the instance on VMWare is in **stopped** state, we directly use the
129
-
instance for conversion.
128
+
instance to export it's OVF files.
130
129
- Converts the OVF on the temporary storage location to KVM using
131
130
**virt-v2v**. CloudStack (or the administrator) selects a running and
132
-
enabled KVM host to perform the conversion from VMware to KVM using
133
-
**virt-v2v**. If the binary is not installed, then the host will fail the
134
-
migration. In case it is installed, it will perform the conversion into
131
+
enabled KVM host to perform the conversion (of the previously exported OVF files) from VMware to KVM using
132
+
**virt-v2v**. If the binary is not installed, then the host will fail to convert the Instance.
133
+
In case it is installed, it will perform the conversion into
135
134
the temporary location to store the converted QCOW2 disks of the instance.
136
135
The disks are then moved into the destination storage pools for the
137
-
instance. The conversion is a long-lasting process which can be set to
136
+
instance. The virt-v2v conversion is a long-lasting process which can be set to
138
137
time out by the global setting ``convert.vmware.instance.to.kvm.timeout``.
139
138
The conversion process takes a long time because virt-v2v creates a
140
139
temporary instance to inspect the source VM and generate the converted
141
140
disks with the correct drivers. Additionally, it needs to copy the
142
141
converted disks into the temporary location.
143
-
- The converted instance is then imported into the selected KVM cluster.
144
-
If no host is selected for importing, the host for qcow2 conversion is
145
-
selected randomly from the selected destination cluster. Only enabled
146
-
cluster & enabled host are considered for importing.
142
+
- The converted instance is then imported into the chosen KVM cluster.
143
+
Administraator can choose the KVM host or let CloudStack choose it. . Only enabled
144
+
cluster & enabled host are considered.
147
145
148
146
.. note:: Please consider not restarting the management servers while importing as it will lead to the interruption of the process and you will need to start again.
149
147
150
148
.. note:: As mentioned above, the migration/conversion process uses an external tool, virt-v2v, which supports most but not all the operating systems out there (this is true for both the host on which the virt-v2v tool is running as well as the guest OS of the instances being migrated by the tool). Thus, the success of the import process will, almost exclusively, depend on the success of the virt-v2v conversion. In other words, the success will vary based on factors such as the current OS version, installed packages, guest OS setup, file systems, and others. Success is not guaranteed. We strongly recommend testing the migration process before proceeding with production deployments.
151
149
152
-
.. note:: The resulting imported VM uses the default Guest OS: CentOS 4.5 (32-bit). After importing the VM, please Edit the Instance to change the Guest OS Type accordingly.
150
+
.. note:: The resulting imported VM uses the default Guest OS type: **CentOS 4.5 (32-bit)**.
151
+
After importing the VM, please Edit the Instance to change the Guest OS Type accordingly.
0 commit comments