You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@cloudstack.apache.org by "nvazquez (via GitHub)" <gi...@apache.org> on 2023/09/07 08:58:35 UTC
[GitHub] [cloudstack-documentation] nvazquez opened a new pull request, #342: Migrate VMware VM to KVM template documentation
nvazquez opened a new pull request, #342:
URL: https://github.com/apache/cloudstack-documentation/pull/342
WIP documentation for PR: https://github.com/apache/cloudstack/pull/7881
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Import VMware VMs into KVM - Documentation [cloudstack-documentation]
Posted by "NuxRo (via GitHub)" <gi...@apache.org>.
NuxRo commented on code in PR #342:
URL: https://github.com/apache/cloudstack-documentation/pull/342#discussion_r1374752046
##########
source/adminguide/virtual_machines/importing_vmware_vms_into_kvm.rst:
##########
@@ -0,0 +1,118 @@
+.. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information#
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+ http://www.apache.org/licenses/LICENSE-2.0
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+.. 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.
+
+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.
+
+Requirements on the KVM hosts
+-----------------------------
+
+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.
+
+In case virt-v2v is not installed on a KVM host attempting a Virtual Machine conversion from VMware, the process fails.
+
+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:
+
+ ::
+
+ virtv2v.verbose.enabled=true
+
+
+Installing virt-v2v on Ubuntu KVM hosts does not install nbdkit which is required in the conversion of VMWare VCenter guests. To install it, please execute:
+
+ ::
+
+ apt install nbdkit
+
+
+Supported Distributions for KVM Hypervisor:
+
+
+.. cssclass:: table-striped table-bordered table-hover
+
+======================== ========================
+Linux Distribution Supported Versions
+======================== ========================
+Alma Linux 8, 9
+Red Hat Enterprise Linux 8, 9
+Rocky Linux 8, 9
+Ubuntu 22.04 LTS
+======================== ========================
+
+
+Importing Windows guest VMs from VMware requires installing the virtio drivers on the hypervisor hosts for the virt-v2v conversion.
+
+On (RH)EL hosts:
+
+ ::
+
+ yum install virtio-win
+
+You can also install the RPM manually from https://fedorapeople.org/groups/virt/virtio-win/direct-downloads/stable-virtio/virtio-win.noarch.rpm
+
+
+For Debian-based distributions:
+
+ ::
+
+ apt install virtio-win
+
+Usage
+-----
+
+In the UI, Virtual Machines to import from VMware are listed in *Tools > Import-Export Instances* section, selecting:
+
+.. cssclass:: table-striped table-bordered table-hover
+
+==================== ========================
+Source Destination Hypervisor
+==================== ========================
+Migrate From VMware KVM
+==================== ========================
+
+|import-vm-from-vmware-to-kvm.png|
+
+Selecting the Destination cluster
+---------------------------------
+
+CloudStack administrators must select a KVM cluster to import the VMware Virtual Machines (left side of the image above). Once a KVM cluster is selected, the VMware Datacenter selection part is displayed (right side of the image above).
+
+Selecting the VM from a VMware Datacenter
+-----------------------------------------
+
+CloudStack administrators must select the Source VMware Datacenter:
+
+ - Existing: The existing zones are listed, and for each zone CloudStack will list if there is any VMware Datacenter associated to it. In case it is, it can be selected
+ - External: CloudStack allows listing Virtual Machines from a VMware Datacenter that is not associated to any CloudStack zone. To do so, it needs the vCenter IP address, the datacenter name, and username and password credentials to log in the vCenter.
+
+Once the VMware Datacenter is selected, click on List VMware Instances to display the list of Virtual Machines on the Datacenter
+
+
+Converting and importing a VMware VM
+------------------------------------
+
+.. note:: CloudStack allows importing Running Linux Virtual Machines, but it is recommended that the Virtual Machine to import is powered off and has been gracefully shutdown before the process starts. For Windows Virtual Machines, it is not possible to import them while running.
+
+When importing a Virtual Machine from VMware to KVM, CloudStack performs the following actions:
+
+ - Cloning the Source Virtual Machine on the selected VMware Datacenter: The source Virtual Machine will be cloned in the original state (running or stopped for Linux VMs, or stopped for Windows VMs). The recommended state is the stopped state to prevent data inconsistencies or loss when cloning the virtual machine.
+ - Converting the Cloned Virtual Machine to KVM using virt-v2v: CloudStack (or the administrator) selects a running and Enabled KVM host to perform the conversion from VMware to KVM using virt-v2v. If the binary is not installed, then the host will fail the migration. In case it is installed it will perform the conversion into a temporary location (which can be selected by the administrator) to store the converted QCOW2 disks of the virtual machine. The disks are then moved into the destination storage pools for the virtual machine. The conversion is a long-lasting process which can be set to time out by the global setting 'convert.vmware.instance.to.kvm.timeout'. The conversion processes take a long time because virt-v2v creates a temporary virtual machine to inspect the source VM and generate the converted disks with the correct drivers. Additionally, it needs to copy the converted disks into the temporary location.
+
+.. note:: Please consider not restarting the management servers during the imports since this action can cause failures on the on-going importing processes.
Review Comment:
```suggestion
.. 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.
```
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Import VMware VMs into KVM - Documentation [cloudstack-documentation]
Posted by "NuxRo (via GitHub)" <gi...@apache.org>.
NuxRo commented on code in PR #342:
URL: https://github.com/apache/cloudstack-documentation/pull/342#discussion_r1374603072
##########
source/adminguide/virtual_machines/importing_vmware_vms_into_kvm.rst:
##########
@@ -0,0 +1,116 @@
+.. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information#
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+ http://www.apache.org/licenses/LICENSE-2.0
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+.. 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.
+
+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.
+
+Requirements on the KVM hosts
+-----------------------------
+
+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.
+
+In case virt-v2v is not installed on a KVM host attempting a Virtual Machine conversion from VMware, the process fails.
+
+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:
+
+ ::
+
+ virtv2v.verbose.enabled=true
+
+
+Installing virt-v2v on Ubuntu KVM hosts does not install nbdkit which is required in the conversion of VMWare VCenter guests. To install it, please execute:
+
+ ::
+
+ apt install nbdkit
+
+
+Supported Distributions for KVM Hypervisor:
+
+
+.. cssclass:: table-striped table-bordered table-hover
+
+======================== ========================
+Linux Distribution Supported Versions
+======================== ========================
+Alma Linux 8, 9
+Red Hat Enterprise Linux 8, 9
+Rocky Linux 8, 9
+Ubuntu 22.04 LTS
+======================== ========================
+
+
+Importing Windows guest VMs from VMware requires installing the virtio drivers on the hypervisor hosts for the virt-v2v conversion.
+
+On RHEL9 hosts:
+
+ ::
+
+ yum -y install http://jenkins.openvm.eu/files/virtio-win/virtio-win-1.9.33-0.el9_2.noarch.rpm
+
Review Comment:
```suggestion
You can also install the RPM from https://fedorapeople.org/groups/virt/virtio-win/direct-downloads/stable-virtio/virtio-win.noarch.rpm
```
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Import VMware VMs into KVM - Documentation [cloudstack-documentation]
Posted by "nvazquez (via GitHub)" <gi...@apache.org>.
nvazquez commented on PR #342:
URL: https://github.com/apache/cloudstack-documentation/pull/342#issuecomment-1893562687
Sure @shwstppr
@blueorangutan docbuild
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Import VMware VMs into KVM - Documentation [cloudstack-documentation]
Posted by "borisstoyanov (via GitHub)" <gi...@apache.org>.
borisstoyanov commented on PR #342:
URL: https://github.com/apache/cloudstack-documentation/pull/342#issuecomment-1774740602
It seems like the title of the section is repeating at the end of the section, I don't see a reason this wording to be a paragraph?
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Import VMware VMs into KVM - Documentation [cloudstack-documentation]
Posted by "DaanHoogland (via GitHub)" <gi...@apache.org>.
DaanHoogland closed pull request #342: Import VMware VMs into KVM - Documentation
URL: https://github.com/apache/cloudstack-documentation/pull/342
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Import VMware VMs into KVM - Documentation [cloudstack-documentation]
Posted by "NuxRo (via GitHub)" <gi...@apache.org>.
NuxRo commented on code in PR #342:
URL: https://github.com/apache/cloudstack-documentation/pull/342#discussion_r1374596943
##########
source/adminguide/virtual_machines/importing_vmware_vms_into_kvm.rst:
##########
@@ -0,0 +1,116 @@
+.. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information#
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+ http://www.apache.org/licenses/LICENSE-2.0
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+.. 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.
+
+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.
+
+Requirements on the KVM hosts
+-----------------------------
+
+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.
+
+In case virt-v2v is not installed on a KVM host attempting a Virtual Machine conversion from VMware, the process fails.
+
+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:
+
+ ::
+
+ virtv2v.verbose.enabled=true
+
+
+Installing virt-v2v on Ubuntu KVM hosts does not install nbdkit which is required in the conversion of VMWare VCenter guests. To install it, please execute:
+
+ ::
+
+ apt install nbdkit
+
+
+Supported Distributions for KVM Hypervisor:
+
+
+.. cssclass:: table-striped table-bordered table-hover
+
+======================== ========================
+Linux Distribution Supported Versions
+======================== ========================
+Alma Linux 8, 9
+Red Hat Enterprise Linux 8, 9
+Rocky Linux 8, 9
+Ubuntu 22.04 LTS
+======================== ========================
+
+
+Importing Windows guest VMs from VMware requires installing the virtio drivers on the hypervisor hosts for the virt-v2v conversion.
+
+On RHEL9 hosts:
+
+ ::
+
+ yum -y install http://jenkins.openvm.eu/files/virtio-win/virtio-win-1.9.33-0.el9_2.noarch.rpm
Review Comment:
```suggestion
yum install virtio-win
You can also install virtio-win manually from https://fedorapeople.org/groups/virt/virtio-win/direct-downloads/stable-virtio/virtio-win.noarch.rpm
```
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Import VMware VMs into KVM - Documentation [cloudstack-documentation]
Posted by "shwstppr (via GitHub)" <gi...@apache.org>.
shwstppr merged PR #342:
URL: https://github.com/apache/cloudstack-documentation/pull/342
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Import VMware VMs into KVM - Documentation [cloudstack-documentation]
Posted by "NuxRo (via GitHub)" <gi...@apache.org>.
NuxRo commented on code in PR #342:
URL: https://github.com/apache/cloudstack-documentation/pull/342#discussion_r1374600222
##########
source/adminguide/virtual_machines/importing_vmware_vms_into_kvm.rst:
##########
@@ -0,0 +1,116 @@
+.. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information#
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+ http://www.apache.org/licenses/LICENSE-2.0
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+.. 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.
+
+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.
+
+Requirements on the KVM hosts
+-----------------------------
+
+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.
+
+In case virt-v2v is not installed on a KVM host attempting a Virtual Machine conversion from VMware, the process fails.
+
+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:
+
+ ::
+
+ virtv2v.verbose.enabled=true
+
+
+Installing virt-v2v on Ubuntu KVM hosts does not install nbdkit which is required in the conversion of VMWare VCenter guests. To install it, please execute:
+
+ ::
+
+ apt install nbdkit
+
+
+Supported Distributions for KVM Hypervisor:
+
+
+.. cssclass:: table-striped table-bordered table-hover
+
+======================== ========================
+Linux Distribution Supported Versions
+======================== ========================
+Alma Linux 8, 9
+Red Hat Enterprise Linux 8, 9
+Rocky Linux 8, 9
+Ubuntu 22.04 LTS
+======================== ========================
+
+
+Importing Windows guest VMs from VMware requires installing the virtio drivers on the hypervisor hosts for the virt-v2v conversion.
+
+On RHEL9 hosts:
+
+ ::
+
+ yum -y install http://jenkins.openvm.eu/files/virtio-win/virtio-win-1.9.33-0.el9_2.noarch.rpm
Review Comment:
```suggestion
yum install virtio-win
```
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Import VMware VMs into KVM - Documentation [cloudstack-documentation]
Posted by "nvazquez (via GitHub)" <gi...@apache.org>.
nvazquez commented on PR #342:
URL: https://github.com/apache/cloudstack-documentation/pull/342#issuecomment-1781371602
Thanks @borisstoyanov I have addressed your comments
@blueorangutan docbuild
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Import VMware VMs into KVM - Documentation [cloudstack-documentation]
Posted by "blueorangutan (via GitHub)" <gi...@apache.org>.
blueorangutan commented on PR #342:
URL: https://github.com/apache/cloudstack-documentation/pull/342#issuecomment-1803154612
@nvazquez a Jenkins job has been kicked to build the document. I'll keep you posted as I make progress.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Import VMware VMs into KVM - Documentation [cloudstack-documentation]
Posted by "nvazquez (via GitHub)" <gi...@apache.org>.
nvazquez commented on PR #342:
URL: https://github.com/apache/cloudstack-documentation/pull/342#issuecomment-1803154319
@blueorangutan docbuild
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Import VMware VMs into KVM - Documentation [cloudstack-documentation]
Posted by "blueorangutan (via GitHub)" <gi...@apache.org>.
blueorangutan commented on PR #342:
URL: https://github.com/apache/cloudstack-documentation/pull/342#issuecomment-1794266723
QA-Doc build preview: https://qa.cloudstack.cloud/builds/docs-build/pr/342. (QA-JID 165)
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Import VMware VMs into KVM - Documentation [cloudstack-documentation]
Posted by "andrijapanicsb (via GitHub)" <gi...@apache.org>.
andrijapanicsb commented on code in PR #342:
URL: https://github.com/apache/cloudstack-documentation/pull/342#discussion_r1453627301
##########
source/adminguide/virtual_machines/importing_vmware_vms_into_kvm.rst:
##########
@@ -0,0 +1,120 @@
+.. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information#
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+ http://www.apache.org/licenses/LICENSE-2.0
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+.. 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.
+
+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.
+
+Requirements on the KVM hosts
+-----------------------------
+
+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.
+
+In case virt-v2v is not installed on a KVM host attempting a Virtual Machine conversion from VMware, the process fails.
+
+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:
+
+ ::
+
+ virtv2v.verbose.enabled=true
+
+
+Installing virt-v2v on Ubuntu KVM hosts does not install nbdkit which is required in the conversion of VMWare VCenter guests. To install it, please execute:
+
+ ::
+
+ apt install nbdkit
+
+
+Supported Distributions for KVM Hypervisor:
+
+
+.. cssclass:: table-striped table-bordered table-hover
+
+======================== ========================
+Linux Distribution Supported Versions
+======================== ========================
+Alma Linux 8, 9
+Red Hat Enterprise Linux 8, 9
+Rocky Linux 8, 9
+Ubuntu 22.04 LTS
+======================== ========================
+
+
+Importing Windows guest VMs from VMware requires installing the virtio drivers on the hypervisor hosts for the virt-v2v conversion.
+
+On (RH)EL hosts:
+
+ ::
+
+ yum install virtio-win
+
+You can also install the RPM manually from https://fedorapeople.org/groups/virt/virtio-win/direct-downloads/stable-virtio/virtio-win.noarch.rpm
+
+
+For Debian-based distributions:
+
+ ::
+
+ apt install virtio-win
+
+Usage
+-----
+
+In the UI, Virtual Machines to import from VMware are listed in *Tools > Import-Export Instances* section, selecting:
+
+.. cssclass:: table-striped table-bordered table-hover
+
+==================== ========================
+Source Destination Hypervisor
+==================== ========================
+Migrate From VMware KVM
+==================== ========================
+
+|import-vm-from-vmware-to-kvm.png|
+
+Selecting the Destination cluster
+---------------------------------
+
+CloudStack administrators must select a KVM cluster to import the VMware Virtual Machines (left side of the image above). Once a KVM cluster is selected, the VMware Datacenter selection part is displayed (right side of the image above).
+
+Selecting the VM from a VMware Datacenter
+-----------------------------------------
+
+CloudStack administrators must select the Source VMware Datacenter:
+
+ - Existing: The existing zones are listed, and for each zone CloudStack will list if there is any VMware Datacenter associated to it. In case it is, it can be selected
+ - External: CloudStack allows listing Virtual Machines from a VMware Datacenter that is not associated to any CloudStack zone. To do so, it needs the vCenter IP address, the datacenter name, and username and password credentials to log in the vCenter.
+
+Once the VMware Datacenter is selected, click on List VMware Instances to display the list of Virtual Machines on the Datacenter
+
+
+Converting and importing a VMware VM
+------------------------------------
+
+.. note:: CloudStack allows importing Running Linux Virtual Machines, but it is generally recommended that the Virtual Machine to import is powered off and has been gracefully shutdown before the process starts. In case a Linux VM is imported while running, it will be converted in "crash consistent" state. For Windows Virtual Machines, it is not possible to import them while running, it is mandatory they are shut down gracefully so the filesystem is in a clean state.
+
+When importing a Virtual Machine from VMware to KVM, CloudStack performs the following actions:
+
+ - Cloning the Source Virtual Machine on the selected VMware Datacenter: The source Virtual Machine will be cloned in the original state (running or stopped for Linux VMs, or stopped for Windows VMs). The recommended state is the stopped state to prevent data inconsistencies or loss when cloning the virtual machine.
+ - Converting the Cloned Virtual Machine to KVM using virt-v2v: CloudStack (or the administrator) selects a running and Enabled KVM host to perform the conversion from VMware to KVM using virt-v2v. If the binary is not installed, then the host will fail the migration. In case it is installed it will perform the conversion into a temporary location (which can be selected by the administrator) to store the converted QCOW2 disks of the virtual machine. The disks are then moved into the destination storage pools for the virtual machine. The conversion is a long-lasting process which can be set to time out by the global setting 'convert.vmware.instance.to.kvm.timeout'. The conversion processes take a long time because virt-v2v creates a temporary virtual machine to inspect the source VM and generate the converted disks with the correct drivers. Additionally, it needs to copy the converted disks into the temporary location.
Review Comment:
```suggestion
- Converting the Cloned Virtual Machine to KVM using virt-v2v: CloudStack (or the administrator) selects a running and Enabled KVM host to perform the conversion from VMware to KVM using **virt-v2v**. If the binary is not installed, then the host will fail the migration. In case it is installed it will perform the conversion into a temporary location (which can be selected by the administrator) to store the converted QCOW2 disks of the virtual machine. The disks are then moved into the destination storage pools for the virtual machine. The conversion is a long-lasting process which can be set to time out by the global setting 'convert.vmware.instance.to.kvm.timeout'. The conversion processes take a long time because virt-v2v creates a temporary virtual machine to inspect the source VM and generate the converted disks with the correct drivers. Additionally, it needs to copy the converted disks into the temporary location.
```
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Import VMware VMs into KVM - Documentation [cloudstack-documentation]
Posted by "nvazquez (via GitHub)" <gi...@apache.org>.
nvazquez commented on PR #342:
URL: https://github.com/apache/cloudstack-documentation/pull/342#issuecomment-1894049302
@blueorangutan docbuild
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Import VMware VMs into KVM - Documentation [cloudstack-documentation]
Posted by "nvazquez (via GitHub)" <gi...@apache.org>.
nvazquez commented on PR #342:
URL: https://github.com/apache/cloudstack-documentation/pull/342#issuecomment-1893876230
This PR looks ready @shwstppr - @andrijapanicsb we have this note to warn about that, do you think it should be extended?
<img width="722" alt="Screenshot 2024-01-16 at 11 35 59" src="https://github.com/apache/cloudstack-documentation/assets/5295080/973065e4-1937-491d-b24a-daf5244e24d9">
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Import VMware VMs into KVM - Documentation [cloudstack-documentation]
Posted by "shwstppr (via GitHub)" <gi...@apache.org>.
shwstppr commented on PR #342:
URL: https://github.com/apache/cloudstack-documentation/pull/342#issuecomment-1844814080
@nvazquez is this ready for review or does it need more changes? cc @andrijapanicsb @borisstoyanov
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Import VMware VMs into KVM - Documentation [cloudstack-documentation]
Posted by "borisstoyanov (via GitHub)" <gi...@apache.org>.
borisstoyanov commented on PR #342:
URL: https://github.com/apache/cloudstack-documentation/pull/342#issuecomment-1794243024
@blueorangutan docbuild
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Import VMware VMs into KVM - Documentation [cloudstack-documentation]
Posted by "nvazquez (via GitHub)" <gi...@apache.org>.
nvazquez commented on PR #342:
URL: https://github.com/apache/cloudstack-documentation/pull/342#issuecomment-1773310963
@blueorangutan docbuild
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Import VMware VMs into KVM - Documentation [cloudstack-documentation]
Posted by "NuxRo (via GitHub)" <gi...@apache.org>.
NuxRo commented on code in PR #342:
URL: https://github.com/apache/cloudstack-documentation/pull/342#discussion_r1374594226
##########
source/adminguide/virtual_machines/importing_vmware_vms_into_kvm.rst:
##########
@@ -0,0 +1,116 @@
+.. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information#
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+ http://www.apache.org/licenses/LICENSE-2.0
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+.. 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.
+
+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.
+
+Requirements on the KVM hosts
+-----------------------------
+
+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.
+
+In case virt-v2v is not installed on a KVM host attempting a Virtual Machine conversion from VMware, the process fails.
+
+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:
+
+ ::
+
+ virtv2v.verbose.enabled=true
+
+
+Installing virt-v2v on Ubuntu KVM hosts does not install nbdkit which is required in the conversion of VMWare VCenter guests. To install it, please execute:
+
+ ::
+
+ apt install nbdkit
+
+
+Supported Distributions for KVM Hypervisor:
+
+
+.. cssclass:: table-striped table-bordered table-hover
+
+======================== ========================
+Linux Distribution Supported Versions
+======================== ========================
+Alma Linux 8, 9
+Red Hat Enterprise Linux 8, 9
+Rocky Linux 8, 9
+Ubuntu 22.04 LTS
+======================== ========================
+
+
+Importing Windows guest VMs from VMware requires installing the virtio drivers on the hypervisor hosts for the virt-v2v conversion.
+
+On RHEL9 hosts:
+
+ ::
+
+ yum -y install http://jenkins.openvm.eu/files/virtio-win/virtio-win-1.9.33-0.el9_2.noarch.rpm
Review Comment:
```suggestion
yum install virtio-win
```
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Import VMware VMs into KVM - Documentation [cloudstack-documentation]
Posted by "NuxRo (via GitHub)" <gi...@apache.org>.
NuxRo commented on code in PR #342:
URL: https://github.com/apache/cloudstack-documentation/pull/342#discussion_r1374613949
##########
source/adminguide/virtual_machines/importing_vmware_vms_into_kvm.rst:
##########
@@ -0,0 +1,117 @@
+.. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information#
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+ http://www.apache.org/licenses/LICENSE-2.0
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+.. 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.
+
+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.
+
+Requirements on the KVM hosts
+-----------------------------
+
+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.
+
+In case virt-v2v is not installed on a KVM host attempting a Virtual Machine conversion from VMware, the process fails.
+
+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:
+
+ ::
+
+ virtv2v.verbose.enabled=true
+
+
+Installing virt-v2v on Ubuntu KVM hosts does not install nbdkit which is required in the conversion of VMWare VCenter guests. To install it, please execute:
+
+ ::
+
+ apt install nbdkit
+
+
+Supported Distributions for KVM Hypervisor:
+
+
+.. cssclass:: table-striped table-bordered table-hover
+
+======================== ========================
+Linux Distribution Supported Versions
+======================== ========================
+Alma Linux 8, 9
+Red Hat Enterprise Linux 8, 9
+Rocky Linux 8, 9
+Ubuntu 22.04 LTS
+======================== ========================
+
+
+Importing Windows guest VMs from VMware requires installing the virtio drivers on the hypervisor hosts for the virt-v2v conversion.
+
+On (RH)EL hosts:
+
+ ::
+
+ yum install virtio-win
+
+You can also install the RPM from [https://fedorapeople.org/groups/virt/virtio-win/direct-downloads/stable-virtio/virtio-win.noarch.rpm](https://fedorapeople.org/groups/virt/virtio-win/direct-downloads/stable-virtio/virtio-win.noarch.rpm)
Review Comment:
```suggestion
You can also install the RPM manually from https://fedorapeople.org/groups/virt/virtio-win/direct-downloads/stable-virtio/virtio-win.noarch.rpm
```
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Import VMware VMs into KVM - Documentation [cloudstack-documentation]
Posted by "NuxRo (via GitHub)" <gi...@apache.org>.
NuxRo commented on code in PR #342:
URL: https://github.com/apache/cloudstack-documentation/pull/342#discussion_r1374747742
##########
source/adminguide/virtual_machines/importing_vmware_vms_into_kvm.rst:
##########
@@ -0,0 +1,118 @@
+.. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information#
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+ http://www.apache.org/licenses/LICENSE-2.0
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+.. 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.
+
+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.
+
+Requirements on the KVM hosts
+-----------------------------
+
+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.
+
+In case virt-v2v is not installed on a KVM host attempting a Virtual Machine conversion from VMware, the process fails.
+
+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:
+
+ ::
+
+ virtv2v.verbose.enabled=true
+
+
+Installing virt-v2v on Ubuntu KVM hosts does not install nbdkit which is required in the conversion of VMWare VCenter guests. To install it, please execute:
+
+ ::
+
+ apt install nbdkit
+
+
+Supported Distributions for KVM Hypervisor:
+
+
+.. cssclass:: table-striped table-bordered table-hover
+
+======================== ========================
+Linux Distribution Supported Versions
+======================== ========================
+Alma Linux 8, 9
+Red Hat Enterprise Linux 8, 9
+Rocky Linux 8, 9
+Ubuntu 22.04 LTS
+======================== ========================
+
+
+Importing Windows guest VMs from VMware requires installing the virtio drivers on the hypervisor hosts for the virt-v2v conversion.
+
+On (RH)EL hosts:
+
+ ::
+
+ yum install virtio-win
+
+You can also install the RPM manually from https://fedorapeople.org/groups/virt/virtio-win/direct-downloads/stable-virtio/virtio-win.noarch.rpm
+
+
+For Debian-based distributions:
+
+ ::
+
+ apt install virtio-win
+
+Usage
+-----
+
+In the UI, Virtual Machines to import from VMware are listed in *Tools > Import-Export Instances* section, selecting:
+
+.. cssclass:: table-striped table-bordered table-hover
+
+==================== ========================
+Source Destination Hypervisor
+==================== ========================
+Migrate From VMware KVM
+==================== ========================
+
+|import-vm-from-vmware-to-kvm.png|
+
+Selecting the Destination cluster
+---------------------------------
+
+CloudStack administrators must select a KVM cluster to import the VMware Virtual Machines (left side of the image above). Once a KVM cluster is selected, the VMware Datacenter selection part is displayed (right side of the image above).
+
+Selecting the VM from a VMware Datacenter
+-----------------------------------------
+
+CloudStack administrators must select the Source VMware Datacenter:
+
+ - Existing: The existing zones are listed, and for each zone CloudStack will list if there is any VMware Datacenter associated to it. In case it is, it can be selected
+ - External: CloudStack allows listing Virtual Machines from a VMware Datacenter that is not associated to any CloudStack zone. To do so, it needs the vCenter IP address, the datacenter name, and username and password credentials to log in the vCenter.
+
+Once the VMware Datacenter is selected, click on List VMware Instances to display the list of Virtual Machines on the Datacenter
+
+
+Converting and importing a VMware VM
+------------------------------------
+
+.. note:: CloudStack allows importing Running Linux Virtual Machines, but it is recommended that the Virtual Machine to import is powered off and has been gracefully shutdown before the process starts. For Windows Virtual Machines, it is not possible to import them while running.
+
+When importing a Virtual Machine from VMware to KVM, CloudStack performs the following actions:
+
+ - Cloning the Source Virtual Machine on the selected VMware Datacenter: The source Virtual Machine will be cloned in the original state (running or stopped for Linux VMs, or stopped for Windows VMs). The recommended state is the stopped state to prevent data inconsistencies or loss when cloning the virtual machine.
+ - Converting the Cloned Virtual Machine to KVM using virt-v2v: CloudStack (or the administrator) selects a running and Enabled KVM host to perform the conversion from VMware to KVM using virt-v2v. If the binary is not installed, then the host will fail the migration. In case it is installed it will perform the conversion into a temporary location (which can be selected by the administrator) to store the converted QCOW2 disks of the virtual machine. The disks are then moved into the destination storage pools for the virtual machine. The conversion process is a long-lasting process which can be set to timeout by the global setting 'convert.vmware.instance.to.kvm.timeout'. The conversion processes are long-lasting processes since virt-v2v creates a virtual machine to inspect the source VM and generate the converted disks with the correct drivers. Also, it needs to copy the converted disks into the temporary location.
Review Comment:
```suggestion
- Converting the Cloned Virtual Machine to KVM using virt-v2v: CloudStack (or the administrator) selects a running and Enabled KVM host to perform the conversion from VMware to KVM using virt-v2v. If the binary is not installed, then the host will fail the migration. In case it is installed it will perform the conversion into a temporary location (which can be selected by the administrator) to store the converted QCOW2 disks of the virtual machine. The disks are then moved into the destination storage pools for the virtual machine. The conversion is a long-lasting process which can be set to time out by the global setting 'convert.vmware.instance.to.kvm.timeout'. The conversion processes take a long time because virt-v2v creates a temporary virtual machine to inspect the source VM and generate the converted disks with the correct drivers. Additionally, it needs to copy the converted disks into the temporary location.
```
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Import VMware VMs into KVM - Documentation [cloudstack-documentation]
Posted by "blueorangutan (via GitHub)" <gi...@apache.org>.
blueorangutan commented on PR #342:
URL: https://github.com/apache/cloudstack-documentation/pull/342#issuecomment-1798075620
@borisstoyanov a Jenkins job has been kicked to build the document. I'll keep you posted as I make progress.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Import VMware VMs into KVM - Documentation [cloudstack-documentation]
Posted by "borisstoyanov (via GitHub)" <gi...@apache.org>.
borisstoyanov commented on PR #342:
URL: https://github.com/apache/cloudstack-documentation/pull/342#issuecomment-1798074020
@blueorangutan docbuild
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Import VMware VMs into KVM - Documentation [cloudstack-documentation]
Posted by "blueorangutan (via GitHub)" <gi...@apache.org>.
blueorangutan commented on PR #342:
URL: https://github.com/apache/cloudstack-documentation/pull/342#issuecomment-1803155266
QA-Doc build preview: https://qa.cloudstack.cloud/builds/docs-build/pr/342. (QA-JID 169)
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Import VMware VMs into KVM - Documentation [cloudstack-documentation]
Posted by "shwstppr (via GitHub)" <gi...@apache.org>.
shwstppr commented on PR #342:
URL: https://github.com/apache/cloudstack-documentation/pull/342#issuecomment-1888990163
@nvazquez can you please have a look ^^
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Import VMware VMs into KVM - Documentation [cloudstack-documentation]
Posted by "nvazquez (via GitHub)" <gi...@apache.org>.
nvazquez commented on PR #342:
URL: https://github.com/apache/cloudstack-documentation/pull/342#issuecomment-1893658616
@blueorangutan docbuild
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Import VMware VMs into KVM - Documentation [cloudstack-documentation]
Posted by "blueorangutan (via GitHub)" <gi...@apache.org>.
blueorangutan commented on PR #342:
URL: https://github.com/apache/cloudstack-documentation/pull/342#issuecomment-1893567346
@nvazquez a Jenkins job has been kicked to build the document. I'll keep you posted as I make progress.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Import VMware VMs into KVM - Documentation [cloudstack-documentation]
Posted by "NuxRo (via GitHub)" <gi...@apache.org>.
NuxRo commented on code in PR #342:
URL: https://github.com/apache/cloudstack-documentation/pull/342#discussion_r1374609142
##########
source/adminguide/virtual_machines/importing_vmware_vms_into_kvm.rst:
##########
@@ -0,0 +1,116 @@
+.. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information#
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+ http://www.apache.org/licenses/LICENSE-2.0
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+.. 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.
+
+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.
+
+Requirements on the KVM hosts
+-----------------------------
+
+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.
+
+In case virt-v2v is not installed on a KVM host attempting a Virtual Machine conversion from VMware, the process fails.
+
+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:
+
+ ::
+
+ virtv2v.verbose.enabled=true
+
+
+Installing virt-v2v on Ubuntu KVM hosts does not install nbdkit which is required in the conversion of VMWare VCenter guests. To install it, please execute:
+
+ ::
+
+ apt install nbdkit
+
+
+Supported Distributions for KVM Hypervisor:
+
+
+.. cssclass:: table-striped table-bordered table-hover
+
+======================== ========================
+Linux Distribution Supported Versions
+======================== ========================
+Alma Linux 8, 9
+Red Hat Enterprise Linux 8, 9
+Rocky Linux 8, 9
+Ubuntu 22.04 LTS
+======================== ========================
+
+
+Importing Windows guest VMs from VMware requires installing the virtio drivers on the hypervisor hosts for the virt-v2v conversion.
+
+On RHEL9 hosts:
+
+ ::
+
+ yum -y install http://jenkins.openvm.eu/files/virtio-win/virtio-win-1.9.33-0.el9_2.noarch.rpm
+
+
+For other Linux distributions:
+
+ ::
+
+ yum -y install https://fedorapeople.org/groups/virt/virtio-win/direct-downloads/stable-virtio/virtio-win.noarch.rpm
+
+Usage
+-----
+
+In the UI, Virtual Machines to import from VMware are listed in *Tools > Import-Export Instances* section, selecting:
+
+.. cssclass:: table-striped table-bordered table-hover
+
+==================== ========================
+Source Destination Hypervisor
+==================== ========================
+Migrate From VMware KVM
+==================== ========================
+
+|import-vm-from-vmware-to-kvm.png|
+
+Selecting the Destination cluster
+---------------------------------
+
+CloudStack administrators must select a KVM cluster to import the VMware Virtual Machines (left side of the image above). Once a KVM cluster is selected, the VMware Datacenter selection part is displayed (right side of the image above).
+
+Selecting the VM from a VMware Datacenter
+-----------------------------------------
+
+CloudStack administrators must select the Source VMware Datacenter:
+
+ - Existing: The existing zones are listed, and for each zone CloudStack will list if there is any VMware Datacenter associated to it. In case it is, it can be selected
+ - External: CloudStack allows listing Virtual Machines from a VMware Datacenter that is not associated to any CloudStack zone. To do so, it needs the vCenter IP address, the datacenter name, and username and password credentials to log in the vCenter.
+
+Once the VMware Datacenter is selected, click on List VMware Instances to display the list of Virtual Machines on the Datacenter
+
+
+Converting and importing a VMware VM
+------------------------------------
+
+.. note:: CloudStack allows importing Running Linux Virtual Machines, but it is recommended that the Virtual Machine to import is powered off and has been gracefully shutdown before the process starts. For Windows Virtual Machines, it is not possible to import them while running.
+
+When importing a Virtual Machine from VMware to KVM, CloudStack performs the following actions:
+
+ - Cloning the Source Virtual Machine on the selected VMware Datacenter: The source Virtual Machine will be cloned in the original state (running or stopped for Linux VMs, or stopped for Windows VMs). The recommended state is the stopped state to prevent inconsistencies when cloning the virtual machine.
Review Comment:
```suggestion
- Cloning the Source Virtual Machine on the selected VMware Datacenter: The source Virtual Machine will be cloned in the original state (running or stopped for Linux VMs, or stopped for Windows VMs). The recommended state is the stopped state to prevent data inconsistencies or loss when cloning the virtual machine.
```
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Import VMware VMs into KVM - Documentation [cloudstack-documentation]
Posted by "NuxRo (via GitHub)" <gi...@apache.org>.
NuxRo commented on code in PR #342:
URL: https://github.com/apache/cloudstack-documentation/pull/342#discussion_r1374611060
##########
source/adminguide/virtual_machines/importing_vmware_vms_into_kvm.rst:
##########
@@ -0,0 +1,116 @@
+.. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information#
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+ http://www.apache.org/licenses/LICENSE-2.0
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+.. 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.
+
+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.
+
+Requirements on the KVM hosts
+-----------------------------
+
+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.
+
+In case virt-v2v is not installed on a KVM host attempting a Virtual Machine conversion from VMware, the process fails.
+
+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:
+
+ ::
+
+ virtv2v.verbose.enabled=true
+
+
+Installing virt-v2v on Ubuntu KVM hosts does not install nbdkit which is required in the conversion of VMWare VCenter guests. To install it, please execute:
+
+ ::
+
+ apt install nbdkit
+
+
+Supported Distributions for KVM Hypervisor:
+
+
+.. cssclass:: table-striped table-bordered table-hover
+
+======================== ========================
+Linux Distribution Supported Versions
+======================== ========================
+Alma Linux 8, 9
+Red Hat Enterprise Linux 8, 9
+Rocky Linux 8, 9
+Ubuntu 22.04 LTS
+======================== ========================
+
+
+Importing Windows guest VMs from VMware requires installing the virtio drivers on the hypervisor hosts for the virt-v2v conversion.
+
+On (RH)EL hosts:
+
+ ::
+
+ yum install virtio-win
+You can also install the RPM from https://fedorapeople.org/groups/virt/virtio-win/direct-downloads/stable-virtio/virtio-win.noarch.rpm
Review Comment:
```suggestion
You can also install the RPM from [https://fedorapeople.org/groups/virt/virtio-win/direct-downloads/stable-virtio/virtio-win.noarch.rpm](https://fedorapeople.org/groups/virt/virtio-win/direct-downloads/stable-virtio/virtio-win.noarch.rpm)
```
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Import VMware VMs into KVM - Documentation [cloudstack-documentation]
Posted by "blueorangutan (via GitHub)" <gi...@apache.org>.
blueorangutan commented on PR #342:
URL: https://github.com/apache/cloudstack-documentation/pull/342#issuecomment-1773312131
@nvazquez a Jenkins job has been kicked to build the document. I'll keep you posted as I make progress.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Import VMware VMs into KVM - Documentation [cloudstack-documentation]
Posted by "NuxRo (via GitHub)" <gi...@apache.org>.
NuxRo commented on code in PR #342:
URL: https://github.com/apache/cloudstack-documentation/pull/342#discussion_r1374601078
##########
source/adminguide/virtual_machines/importing_vmware_vms_into_kvm.rst:
##########
@@ -0,0 +1,116 @@
+.. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information#
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+ http://www.apache.org/licenses/LICENSE-2.0
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+.. 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.
+
+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.
+
+Requirements on the KVM hosts
+-----------------------------
+
+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.
+
+In case virt-v2v is not installed on a KVM host attempting a Virtual Machine conversion from VMware, the process fails.
+
+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:
+
+ ::
+
+ virtv2v.verbose.enabled=true
+
+
+Installing virt-v2v on Ubuntu KVM hosts does not install nbdkit which is required in the conversion of VMWare VCenter guests. To install it, please execute:
+
+ ::
+
+ apt install nbdkit
+
+
+Supported Distributions for KVM Hypervisor:
+
+
+.. cssclass:: table-striped table-bordered table-hover
+
+======================== ========================
+Linux Distribution Supported Versions
+======================== ========================
+Alma Linux 8, 9
+Red Hat Enterprise Linux 8, 9
+Rocky Linux 8, 9
+Ubuntu 22.04 LTS
+======================== ========================
+
+
+Importing Windows guest VMs from VMware requires installing the virtio drivers on the hypervisor hosts for the virt-v2v conversion.
+
+On RHEL9 hosts:
+
+ ::
+
+ yum -y install http://jenkins.openvm.eu/files/virtio-win/virtio-win-1.9.33-0.el9_2.noarch.rpm
+
Review Comment:
```suggestion
You can also install the RPM manually from https://fedorapeople.org/groups/virt/virtio-win/direct-downloads/stable-virtio/virtio-win.noarch.rpm
```
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Import VMware VMs into KVM - Documentation [cloudstack-documentation]
Posted by "blueorangutan (via GitHub)" <gi...@apache.org>.
blueorangutan commented on PR #342:
URL: https://github.com/apache/cloudstack-documentation/pull/342#issuecomment-1773604634
QA-Doc build preview: https://qa.cloudstack.cloud/builds/docs-build/pr/342. (QA-JID 156)
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Import VMware VMs into KVM - Documentation [cloudstack-documentation]
Posted by "nvazquez (via GitHub)" <gi...@apache.org>.
nvazquez commented on PR #342:
URL: https://github.com/apache/cloudstack-documentation/pull/342#issuecomment-1773604100
@blueorangutan docbuild
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Import VMware VMs into KVM - Documentation [cloudstack-documentation]
Posted by "nvazquez (via GitHub)" <gi...@apache.org>.
nvazquez commented on PR #342:
URL: https://github.com/apache/cloudstack-documentation/pull/342#issuecomment-1773262841
@blueorangutan docbuild
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Import VMware VMs into KVM - Documentation [cloudstack-documentation]
Posted by "blueorangutan (via GitHub)" <gi...@apache.org>.
blueorangutan commented on PR #342:
URL: https://github.com/apache/cloudstack-documentation/pull/342#issuecomment-1800954141
QA-Doc build preview: https://qa.cloudstack.cloud/builds/docs-build/pr/342. (QA-JID 168)
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Import VMware VMs into KVM - Documentation [cloudstack-documentation]
Posted by "blueorangutan (via GitHub)" <gi...@apache.org>.
blueorangutan commented on PR #342:
URL: https://github.com/apache/cloudstack-documentation/pull/342#issuecomment-1894052644
QA-Doc build preview: https://qa.cloudstack.cloud/builds/docs-build/pr/342. (QA-JID 193)
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Import VMware VMs into KVM - Documentation [cloudstack-documentation]
Posted by "andrijapanicsb (via GitHub)" <gi...@apache.org>.
andrijapanicsb commented on code in PR #342:
URL: https://github.com/apache/cloudstack-documentation/pull/342#discussion_r1453642001
##########
source/adminguide/virtual_machines/importing_vmware_vms_into_kvm.rst:
##########
@@ -0,0 +1,120 @@
+.. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information#
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+ http://www.apache.org/licenses/LICENSE-2.0
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+.. 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.
+
+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.
+
+Requirements on the KVM hosts
+-----------------------------
+
+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.
+
+In case virt-v2v is not installed on a KVM host attempting a Virtual Machine conversion from VMware, the process fails.
+
+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:
+
+ ::
+
+ virtv2v.verbose.enabled=true
+
+
+Installing virt-v2v on Ubuntu KVM hosts does not install nbdkit which is required in the conversion of VMWare VCenter guests. To install it, please execute:
+
+ ::
+
+ apt install nbdkit
+
+
+Supported Distributions for KVM Hypervisor:
+
+
+.. cssclass:: table-striped table-bordered table-hover
+
+======================== ========================
+Linux Distribution Supported Versions
+======================== ========================
+Alma Linux 8, 9
+Red Hat Enterprise Linux 8, 9
+Rocky Linux 8, 9
+Ubuntu 22.04 LTS
+======================== ========================
+
+
+Importing Windows guest VMs from VMware requires installing the virtio drivers on the hypervisor hosts for the virt-v2v conversion.
+
+On (RH)EL hosts:
+
+ ::
+
+ yum install virtio-win
+
+You can also install the RPM manually from https://fedorapeople.org/groups/virt/virtio-win/direct-downloads/stable-virtio/virtio-win.noarch.rpm
+
+
+For Debian-based distributions:
+
+ ::
+
+ apt install virtio-win
+
+Usage
+-----
+
+In the UI, Virtual Machines to import from VMware are listed in *Tools > Import-Export Instances* section, selecting:
+
+.. cssclass:: table-striped table-bordered table-hover
+
+==================== ========================
+Source Destination Hypervisor
+==================== ========================
+Migrate From VMware KVM
+==================== ========================
+
+|import-vm-from-vmware-to-kvm.png|
+
+Selecting the Destination cluster
+---------------------------------
+
+CloudStack administrators must select a KVM cluster to import the VMware Virtual Machines (left side of the image above). Once a KVM cluster is selected, the VMware Datacenter selection part is displayed (right side of the image above).
+
+Selecting the VM from a VMware Datacenter
+-----------------------------------------
+
+CloudStack administrators must select the Source VMware Datacenter:
+
+ - Existing: The existing zones are listed, and for each zone CloudStack will list if there is any VMware Datacenter associated to it. In case it is, it can be selected
+ - External: CloudStack allows listing Virtual Machines from a VMware Datacenter that is not associated to any CloudStack zone. To do so, it needs the vCenter IP address, the datacenter name, and username and password credentials to log in the vCenter.
+
+Once the VMware Datacenter is selected, click on List VMware Instances to display the list of Virtual Machines on the Datacenter
+
+
+Converting and importing a VMware VM
+------------------------------------
+
+.. note:: CloudStack allows importing Running Linux Virtual Machines, but it is generally recommended that the Virtual Machine to import is powered off and has been gracefully shutdown before the process starts. In case a Linux VM is imported while running, it will be converted in "crash consistent" state. For Windows Virtual Machines, it is not possible to import them while running, it is mandatory they are shut down gracefully so the filesystem is in a clean state.
+
+When importing a Virtual Machine from VMware to KVM, CloudStack performs the following actions:
+
+ - Cloning the Source Virtual Machine on the selected VMware Datacenter: The source Virtual Machine will be cloned in the original state (running or stopped for Linux VMs, or stopped for Windows VMs). The recommended state is the stopped state to prevent data inconsistencies or loss when cloning the virtual machine.
+ - Converting the Cloned Virtual Machine to KVM using virt-v2v: CloudStack (or the administrator) selects a running and Enabled KVM host to perform the conversion from VMware to KVM using virt-v2v. If the binary is not installed, then the host will fail the migration. In case it is installed it will perform the conversion into a temporary location (which can be selected by the administrator) to store the converted QCOW2 disks of the virtual machine. The disks are then moved into the destination storage pools for the virtual machine. The conversion is a long-lasting process which can be set to time out by the global setting 'convert.vmware.instance.to.kvm.timeout'. The conversion processes take a long time because virt-v2v creates a temporary virtual machine to inspect the source VM and generate the converted disks with the correct drivers. Additionally, it needs to copy the converted disks into the temporary location.
+
+.. 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.
+
+.. note:: The success of the import process may 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.
Review Comment:
```suggestion
.. 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.
```
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Import VMware VMs into KVM - Documentation [cloudstack-documentation]
Posted by "blueorangutan (via GitHub)" <gi...@apache.org>.
blueorangutan commented on PR #342:
URL: https://github.com/apache/cloudstack-documentation/pull/342#issuecomment-1894050959
@nvazquez a Jenkins job has been kicked to build the document. I'll keep you posted as I make progress.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Import VMware VMs into KVM - Documentation [cloudstack-documentation]
Posted by "blueorangutan (via GitHub)" <gi...@apache.org>.
blueorangutan commented on PR #342:
URL: https://github.com/apache/cloudstack-documentation/pull/342#issuecomment-1773267833
@nvazquez a Jenkins job has been kicked to build the document. I'll keep you posted as I make progress.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Import VMware VMs into KVM - Documentation [cloudstack-documentation]
Posted by "blueorangutan (via GitHub)" <gi...@apache.org>.
blueorangutan commented on PR #342:
URL: https://github.com/apache/cloudstack-documentation/pull/342#issuecomment-1773268815
QA-Doc build preview: https://qa.cloudstack.cloud/builds/docs-build/pr/342. (QA-JID 154)
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Import VMware VMs into KVM - Documentation [cloudstack-documentation]
Posted by "blueorangutan (via GitHub)" <gi...@apache.org>.
blueorangutan commented on PR #342:
URL: https://github.com/apache/cloudstack-documentation/pull/342#issuecomment-1781372787
@nvazquez a Jenkins job has been kicked to build the document. I'll keep you posted as I make progress.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Import VMware VMs into KVM - Documentation [cloudstack-documentation]
Posted by "blueorangutan (via GitHub)" <gi...@apache.org>.
blueorangutan commented on PR #342:
URL: https://github.com/apache/cloudstack-documentation/pull/342#issuecomment-1781374590
QA-Doc build preview: https://qa.cloudstack.cloud/builds/docs-build/pr/342. (QA-JID 162)
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Import VMware VMs into KVM - Documentation [cloudstack-documentation]
Posted by "NuxRo (via GitHub)" <gi...@apache.org>.
NuxRo commented on code in PR #342:
URL: https://github.com/apache/cloudstack-documentation/pull/342#discussion_r1374604440
##########
source/adminguide/virtual_machines/importing_vmware_vms_into_kvm.rst:
##########
@@ -0,0 +1,116 @@
+.. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information#
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+ http://www.apache.org/licenses/LICENSE-2.0
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+.. 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.
+
+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.
+
+Requirements on the KVM hosts
+-----------------------------
+
+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.
+
+In case virt-v2v is not installed on a KVM host attempting a Virtual Machine conversion from VMware, the process fails.
+
+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:
+
+ ::
+
+ virtv2v.verbose.enabled=true
+
+
+Installing virt-v2v on Ubuntu KVM hosts does not install nbdkit which is required in the conversion of VMWare VCenter guests. To install it, please execute:
+
+ ::
+
+ apt install nbdkit
+
+
+Supported Distributions for KVM Hypervisor:
+
+
+.. cssclass:: table-striped table-bordered table-hover
+
+======================== ========================
+Linux Distribution Supported Versions
+======================== ========================
+Alma Linux 8, 9
+Red Hat Enterprise Linux 8, 9
+Rocky Linux 8, 9
+Ubuntu 22.04 LTS
+======================== ========================
+
+
+Importing Windows guest VMs from VMware requires installing the virtio drivers on the hypervisor hosts for the virt-v2v conversion.
+
+On RHEL9 hosts:
+
+ ::
+
+ yum -y install http://jenkins.openvm.eu/files/virtio-win/virtio-win-1.9.33-0.el9_2.noarch.rpm
+
+
+For other Linux distributions:
+
+ ::
+
+ yum -y install https://fedorapeople.org/groups/virt/virtio-win/direct-downloads/stable-virtio/virtio-win.noarch.rpm
Review Comment:
```suggestion
apt install virtio-win
```
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Import VMware VMs into KVM - Documentation [cloudstack-documentation]
Posted by "NuxRo (via GitHub)" <gi...@apache.org>.
NuxRo commented on code in PR #342:
URL: https://github.com/apache/cloudstack-documentation/pull/342#discussion_r1374596943
##########
source/adminguide/virtual_machines/importing_vmware_vms_into_kvm.rst:
##########
@@ -0,0 +1,116 @@
+.. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information#
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+ http://www.apache.org/licenses/LICENSE-2.0
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+.. 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.
+
+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.
+
+Requirements on the KVM hosts
+-----------------------------
+
+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.
+
+In case virt-v2v is not installed on a KVM host attempting a Virtual Machine conversion from VMware, the process fails.
+
+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:
+
+ ::
+
+ virtv2v.verbose.enabled=true
+
+
+Installing virt-v2v on Ubuntu KVM hosts does not install nbdkit which is required in the conversion of VMWare VCenter guests. To install it, please execute:
+
+ ::
+
+ apt install nbdkit
+
+
+Supported Distributions for KVM Hypervisor:
+
+
+.. cssclass:: table-striped table-bordered table-hover
+
+======================== ========================
+Linux Distribution Supported Versions
+======================== ========================
+Alma Linux 8, 9
+Red Hat Enterprise Linux 8, 9
+Rocky Linux 8, 9
+Ubuntu 22.04 LTS
+======================== ========================
+
+
+Importing Windows guest VMs from VMware requires installing the virtio drivers on the hypervisor hosts for the virt-v2v conversion.
+
+On RHEL9 hosts:
+
+ ::
+
+ yum -y install http://jenkins.openvm.eu/files/virtio-win/virtio-win-1.9.33-0.el9_2.noarch.rpm
Review Comment:
```suggestion
yum install virtio-win
You can also install virtio-win manually from https://fedorapeople.org/groups/virt/virtio-win/direct-downloads/stable-virtio/virtio-win.noarch.rpm
```
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [cloudstack-documentation] blueorangutan commented on pull request #342: Migrate VMware VM to KVM template documentation
Posted by "blueorangutan (via GitHub)" <gi...@apache.org>.
blueorangutan commented on PR #342:
URL: https://github.com/apache/cloudstack-documentation/pull/342#issuecomment-1740613515
@shwstppr a Jenkins job has been kicked to build the document. I'll keep you posted as I make progress.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Import VMware VMs into KVM - Documentation [cloudstack-documentation]
Posted by "andrijapanicsb (via GitHub)" <gi...@apache.org>.
andrijapanicsb commented on PR #342:
URL: https://github.com/apache/cloudstack-documentation/pull/342#issuecomment-1885012670
I think we have not added a few lines, to indicate that success of the migration fully depends on the virt-v2v due to what OS are/are not supported as host/guest OS. i.e. the conversion depends on the external tool.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Import VMware VMs into KVM - Documentation [cloudstack-documentation]
Posted by "blueorangutan (via GitHub)" <gi...@apache.org>.
blueorangutan commented on PR #342:
URL: https://github.com/apache/cloudstack-documentation/pull/342#issuecomment-1794265192
@borisstoyanov a Jenkins job has been kicked to build the document. I'll keep you posted as I make progress.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [cloudstack-documentation] shwstppr commented on pull request #342: Migrate VMware VM to KVM template documentation
Posted by "shwstppr (via GitHub)" <gi...@apache.org>.
shwstppr commented on PR #342:
URL: https://github.com/apache/cloudstack-documentation/pull/342#issuecomment-1740598696
@blueorangutan docbuild
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Import VMware VMs into KVM - Documentation [cloudstack-documentation]
Posted by "borisstoyanov (via GitHub)" <gi...@apache.org>.
borisstoyanov commented on PR #342:
URL: https://github.com/apache/cloudstack-documentation/pull/342#issuecomment-1774747653
`yum -y install https://fedorapeople.org/groups/virt/virtio-win/direct-downloads/stable-virtio/virtio-win.noarch.rpm`
This requirement seems to be missing
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Import VMware VMs into KVM - Documentation [cloudstack-documentation]
Posted by "blueorangutan (via GitHub)" <gi...@apache.org>.
blueorangutan commented on PR #342:
URL: https://github.com/apache/cloudstack-documentation/pull/342#issuecomment-1773604266
@nvazquez a Jenkins job has been kicked to build the document. I'll keep you posted as I make progress.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Import VMware VMs into KVM - Documentation [cloudstack-documentation]
Posted by "NuxRo (via GitHub)" <gi...@apache.org>.
NuxRo commented on code in PR #342:
URL: https://github.com/apache/cloudstack-documentation/pull/342#discussion_r1374601078
##########
source/adminguide/virtual_machines/importing_vmware_vms_into_kvm.rst:
##########
@@ -0,0 +1,116 @@
+.. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information#
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+ http://www.apache.org/licenses/LICENSE-2.0
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+.. 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.
+
+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.
+
+Requirements on the KVM hosts
+-----------------------------
+
+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.
+
+In case virt-v2v is not installed on a KVM host attempting a Virtual Machine conversion from VMware, the process fails.
+
+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:
+
+ ::
+
+ virtv2v.verbose.enabled=true
+
+
+Installing virt-v2v on Ubuntu KVM hosts does not install nbdkit which is required in the conversion of VMWare VCenter guests. To install it, please execute:
+
+ ::
+
+ apt install nbdkit
+
+
+Supported Distributions for KVM Hypervisor:
+
+
+.. cssclass:: table-striped table-bordered table-hover
+
+======================== ========================
+Linux Distribution Supported Versions
+======================== ========================
+Alma Linux 8, 9
+Red Hat Enterprise Linux 8, 9
+Rocky Linux 8, 9
+Ubuntu 22.04 LTS
+======================== ========================
+
+
+Importing Windows guest VMs from VMware requires installing the virtio drivers on the hypervisor hosts for the virt-v2v conversion.
+
+On RHEL9 hosts:
+
+ ::
+
+ yum -y install http://jenkins.openvm.eu/files/virtio-win/virtio-win-1.9.33-0.el9_2.noarch.rpm
+
Review Comment:
```suggestion
You can also install the RPM manually from https://fedorapeople.org/groups/virt/virtio-win/direct-downloads/stable-virtio/virtio-win.noarch.rpm
```
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Import VMware VMs into KVM - Documentation [cloudstack-documentation]
Posted by "NuxRo (via GitHub)" <gi...@apache.org>.
NuxRo commented on code in PR #342:
URL: https://github.com/apache/cloudstack-documentation/pull/342#discussion_r1374603913
##########
source/adminguide/virtual_machines/importing_vmware_vms_into_kvm.rst:
##########
@@ -0,0 +1,116 @@
+.. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information#
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+ http://www.apache.org/licenses/LICENSE-2.0
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+.. 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.
+
+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.
+
+Requirements on the KVM hosts
+-----------------------------
+
+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.
+
+In case virt-v2v is not installed on a KVM host attempting a Virtual Machine conversion from VMware, the process fails.
+
+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:
+
+ ::
+
+ virtv2v.verbose.enabled=true
+
+
+Installing virt-v2v on Ubuntu KVM hosts does not install nbdkit which is required in the conversion of VMWare VCenter guests. To install it, please execute:
+
+ ::
+
+ apt install nbdkit
+
+
+Supported Distributions for KVM Hypervisor:
+
+
+.. cssclass:: table-striped table-bordered table-hover
+
+======================== ========================
+Linux Distribution Supported Versions
+======================== ========================
+Alma Linux 8, 9
+Red Hat Enterprise Linux 8, 9
+Rocky Linux 8, 9
+Ubuntu 22.04 LTS
+======================== ========================
+
+
+Importing Windows guest VMs from VMware requires installing the virtio drivers on the hypervisor hosts for the virt-v2v conversion.
+
+On RHEL9 hosts:
+
+ ::
+
+ yum -y install http://jenkins.openvm.eu/files/virtio-win/virtio-win-1.9.33-0.el9_2.noarch.rpm
+
+
+For other Linux distributions:
Review Comment:
```suggestion
For Debian-based distributions:
```
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Import VMware VMs into KVM - Documentation [cloudstack-documentation]
Posted by "NuxRo (via GitHub)" <gi...@apache.org>.
NuxRo commented on code in PR #342:
URL: https://github.com/apache/cloudstack-documentation/pull/342#discussion_r1374593203
##########
source/adminguide/virtual_machines/importing_vmware_vms_into_kvm.rst:
##########
@@ -0,0 +1,116 @@
+.. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information#
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+ http://www.apache.org/licenses/LICENSE-2.0
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+.. 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.
+
+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.
+
+Requirements on the KVM hosts
+-----------------------------
+
+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.
+
+In case virt-v2v is not installed on a KVM host attempting a Virtual Machine conversion from VMware, the process fails.
+
+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:
+
+ ::
+
+ virtv2v.verbose.enabled=true
+
+
+Installing virt-v2v on Ubuntu KVM hosts does not install nbdkit which is required in the conversion of VMWare VCenter guests. To install it, please execute:
+
+ ::
+
+ apt install nbdkit
+
+
+Supported Distributions for KVM Hypervisor:
+
+
+.. cssclass:: table-striped table-bordered table-hover
+
+======================== ========================
+Linux Distribution Supported Versions
+======================== ========================
+Alma Linux 8, 9
+Red Hat Enterprise Linux 8, 9
+Rocky Linux 8, 9
+Ubuntu 22.04 LTS
+======================== ========================
+
+
+Importing Windows guest VMs from VMware requires installing the virtio drivers on the hypervisor hosts for the virt-v2v conversion.
+
+On RHEL9 hosts:
Review Comment:
```suggestion
On (RH)EL hosts:
```
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Import VMware VMs into KVM - Documentation [cloudstack-documentation]
Posted by "NuxRo (via GitHub)" <gi...@apache.org>.
NuxRo commented on code in PR #342:
URL: https://github.com/apache/cloudstack-documentation/pull/342#discussion_r1386239032
##########
source/adminguide/virtual_machines/importing_vmware_vms_into_kvm.rst:
##########
@@ -0,0 +1,120 @@
+.. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information#
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+ http://www.apache.org/licenses/LICENSE-2.0
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+.. 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.
+
+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.
+
+Requirements on the KVM hosts
+-----------------------------
+
+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.
+
+In case virt-v2v is not installed on a KVM host attempting a Virtual Machine conversion from VMware, the process fails.
+
+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:
+
+ ::
+
+ virtv2v.verbose.enabled=true
+
+
+Installing virt-v2v on Ubuntu KVM hosts does not install nbdkit which is required in the conversion of VMWare VCenter guests. To install it, please execute:
+
+ ::
+
+ apt install nbdkit
+
+
+Supported Distributions for KVM Hypervisor:
+
+
+.. cssclass:: table-striped table-bordered table-hover
+
+======================== ========================
+Linux Distribution Supported Versions
+======================== ========================
+Alma Linux 8, 9
+Red Hat Enterprise Linux 8, 9
+Rocky Linux 8, 9
+Ubuntu 22.04 LTS
+======================== ========================
+
+
+Importing Windows guest VMs from VMware requires installing the virtio drivers on the hypervisor hosts for the virt-v2v conversion.
+
+On (RH)EL hosts:
+
+ ::
+
+ yum install virtio-win
+
+You can also install the RPM manually from https://fedorapeople.org/groups/virt/virtio-win/direct-downloads/stable-virtio/virtio-win.noarch.rpm
+
+
+For Debian-based distributions:
+
+ ::
+
+ apt install virtio-win
+
+Usage
+-----
+
+In the UI, Virtual Machines to import from VMware are listed in *Tools > Import-Export Instances* section, selecting:
+
+.. cssclass:: table-striped table-bordered table-hover
+
+==================== ========================
+Source Destination Hypervisor
+==================== ========================
+Migrate From VMware KVM
+==================== ========================
+
+|import-vm-from-vmware-to-kvm.png|
+
+Selecting the Destination cluster
+---------------------------------
+
+CloudStack administrators must select a KVM cluster to import the VMware Virtual Machines (left side of the image above). Once a KVM cluster is selected, the VMware Datacenter selection part is displayed (right side of the image above).
+
+Selecting the VM from a VMware Datacenter
+-----------------------------------------
+
+CloudStack administrators must select the Source VMware Datacenter:
+
+ - Existing: The existing zones are listed, and for each zone CloudStack will list if there is any VMware Datacenter associated to it. In case it is, it can be selected
+ - External: CloudStack allows listing Virtual Machines from a VMware Datacenter that is not associated to any CloudStack zone. To do so, it needs the vCenter IP address, the datacenter name, and username and password credentials to log in the vCenter.
+
+Once the VMware Datacenter is selected, click on List VMware Instances to display the list of Virtual Machines on the Datacenter
+
+
+Converting and importing a VMware VM
+------------------------------------
+
+.. note:: CloudStack allows importing Running Linux Virtual Machines, but it is recommended that the Virtual Machine to import is powered off and has been gracefully shutdown before the process starts. For Windows Virtual Machines, it is not possible to import them while running. In case a Linux VM is imported while running, it will be converted in "crash consistent" state.
Review Comment:
```suggestion
.. note:: CloudStack allows importing Running Linux Virtual Machines, but it is generally recommended that the Virtual Machine to import is powered off and has been gracefully shutdown before the process starts. In case a Linux VM is imported while running, it will be converted in "crash consistent" state. For Windows Virtual Machines, it is not possible to import them while running, it is mandatory they are shut down gracefully so the filesystem is in a clean state.
```
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Import VMware VMs into KVM - Documentation [cloudstack-documentation]
Posted by "andrijapanicsb (via GitHub)" <gi...@apache.org>.
andrijapanicsb commented on code in PR #342:
URL: https://github.com/apache/cloudstack-documentation/pull/342#discussion_r1453644109
##########
source/adminguide/virtual_machines/importing_vmware_vms_into_kvm.rst:
##########
@@ -0,0 +1,120 @@
+.. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information#
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+ http://www.apache.org/licenses/LICENSE-2.0
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+.. 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.
+
+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.
+
+Requirements on the KVM hosts
+-----------------------------
+
+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.
+
+In case virt-v2v is not installed on a KVM host attempting a Virtual Machine conversion from VMware, the process fails.
+
+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:
+
+ ::
+
+ virtv2v.verbose.enabled=true
+
+
+Installing virt-v2v on Ubuntu KVM hosts does not install nbdkit which is required in the conversion of VMWare VCenter guests. To install it, please execute:
+
+ ::
+
+ apt install nbdkit
+
+
+Supported Distributions for KVM Hypervisor:
+
+
+.. cssclass:: table-striped table-bordered table-hover
+
+======================== ========================
+Linux Distribution Supported Versions
+======================== ========================
+Alma Linux 8, 9
+Red Hat Enterprise Linux 8, 9
+Rocky Linux 8, 9
+Ubuntu 22.04 LTS
+======================== ========================
+
+
+Importing Windows guest VMs from VMware requires installing the virtio drivers on the hypervisor hosts for the virt-v2v conversion.
+
+On (RH)EL hosts:
+
+ ::
+
+ yum install virtio-win
+
+You can also install the RPM manually from https://fedorapeople.org/groups/virt/virtio-win/direct-downloads/stable-virtio/virtio-win.noarch.rpm
+
+
+For Debian-based distributions:
+
+ ::
+
+ apt install virtio-win
+
+Usage
+-----
+
+In the UI, Virtual Machines to import from VMware are listed in *Tools > Import-Export Instances* section, selecting:
+
+.. cssclass:: table-striped table-bordered table-hover
+
+==================== ========================
+Source Destination Hypervisor
+==================== ========================
+Migrate From VMware KVM
+==================== ========================
+
+|import-vm-from-vmware-to-kvm.png|
+
+Selecting the Destination cluster
+---------------------------------
+
+CloudStack administrators must select a KVM cluster to import the VMware Virtual Machines (left side of the image above). Once a KVM cluster is selected, the VMware Datacenter selection part is displayed (right side of the image above).
+
+Selecting the VM from a VMware Datacenter
+-----------------------------------------
+
+CloudStack administrators must select the Source VMware Datacenter:
+
+ - Existing: The existing zones are listed, and for each zone CloudStack will list if there is any VMware Datacenter associated to it. In case it is, it can be selected
+ - External: CloudStack allows listing Virtual Machines from a VMware Datacenter that is not associated to any CloudStack zone. To do so, it needs the vCenter IP address, the datacenter name, and username and password credentials to log in the vCenter.
+
+Once the VMware Datacenter is selected, click on List VMware Instances to display the list of Virtual Machines on the Datacenter
+
+
+Converting and importing a VMware VM
+------------------------------------
+
+.. note:: CloudStack allows importing Running Linux Virtual Machines, but it is generally recommended that the Virtual Machine to import is powered off and has been gracefully shutdown before the process starts. In case a Linux VM is imported while running, it will be converted in "crash consistent" state. For Windows Virtual Machines, it is not possible to import them while running, it is mandatory they are shut down gracefully so the filesystem is in a clean state.
+
+When importing a Virtual Machine from VMware to KVM, CloudStack performs the following actions:
+
+ - Cloning the Source Virtual Machine on the selected VMware Datacenter: The source Virtual Machine will be cloned in the original state (running or stopped for Linux VMs, or stopped for Windows VMs). The recommended state is the stopped state to prevent data inconsistencies or loss when cloning the virtual machine.
+ - Converting the Cloned Virtual Machine to KVM using virt-v2v: CloudStack (or the administrator) selects a running and Enabled KVM host to perform the conversion from VMware to KVM using virt-v2v. If the binary is not installed, then the host will fail the migration. In case it is installed it will perform the conversion into a temporary location (which can be selected by the administrator) to store the converted QCOW2 disks of the virtual machine. The disks are then moved into the destination storage pools for the virtual machine. The conversion is a long-lasting process which can be set to time out by the global setting 'convert.vmware.instance.to.kvm.timeout'. The conversion processes take a long time because virt-v2v creates a temporary virtual machine to inspect the source VM and generate the converted disks with the correct drivers. Additionally, it needs to copy the converted disks into the temporary location.
Review Comment:
just bolding it...
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Import VMware VMs into KVM - Documentation [cloudstack-documentation]
Posted by "blueorangutan (via GitHub)" <gi...@apache.org>.
blueorangutan commented on PR #342:
URL: https://github.com/apache/cloudstack-documentation/pull/342#issuecomment-1893660361
@nvazquez a Jenkins job has been kicked to build the document. I'll keep you posted as I make progress.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Import VMware VMs into KVM - Documentation [cloudstack-documentation]
Posted by "nvazquez (via GitHub)" <gi...@apache.org>.
nvazquez commented on PR #342:
URL: https://github.com/apache/cloudstack-documentation/pull/342#issuecomment-1800946214
@blueorangutan docbuild
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Import VMware VMs into KVM - Documentation [cloudstack-documentation]
Posted by "blueorangutan (via GitHub)" <gi...@apache.org>.
blueorangutan commented on PR #342:
URL: https://github.com/apache/cloudstack-documentation/pull/342#issuecomment-1800953575
@nvazquez a Jenkins job has been kicked to build the document. I'll keep you posted as I make progress.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Import VMware VMs into KVM - Documentation [cloudstack-documentation]
Posted by "nvazquez (via GitHub)" <gi...@apache.org>.
nvazquez commented on PR #342:
URL: https://github.com/apache/cloudstack-documentation/pull/342#issuecomment-1800951687
@blueorangutan docbuild
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Import VMware VMs into KVM - Documentation [cloudstack-documentation]
Posted by "blueorangutan (via GitHub)" <gi...@apache.org>.
blueorangutan commented on PR #342:
URL: https://github.com/apache/cloudstack-documentation/pull/342#issuecomment-1773313089
QA-Doc build preview: https://qa.cloudstack.cloud/builds/docs-build/pr/342. (QA-JID 155)
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Import VMware VMs into KVM - Documentation [cloudstack-documentation]
Posted by "NuxRo (via GitHub)" <gi...@apache.org>.
NuxRo commented on code in PR #342:
URL: https://github.com/apache/cloudstack-documentation/pull/342#discussion_r1374594226
##########
source/adminguide/virtual_machines/importing_vmware_vms_into_kvm.rst:
##########
@@ -0,0 +1,116 @@
+.. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information#
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+ http://www.apache.org/licenses/LICENSE-2.0
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+.. 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.
+
+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.
+
+Requirements on the KVM hosts
+-----------------------------
+
+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.
+
+In case virt-v2v is not installed on a KVM host attempting a Virtual Machine conversion from VMware, the process fails.
+
+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:
+
+ ::
+
+ virtv2v.verbose.enabled=true
+
+
+Installing virt-v2v on Ubuntu KVM hosts does not install nbdkit which is required in the conversion of VMWare VCenter guests. To install it, please execute:
+
+ ::
+
+ apt install nbdkit
+
+
+Supported Distributions for KVM Hypervisor:
+
+
+.. cssclass:: table-striped table-bordered table-hover
+
+======================== ========================
+Linux Distribution Supported Versions
+======================== ========================
+Alma Linux 8, 9
+Red Hat Enterprise Linux 8, 9
+Rocky Linux 8, 9
+Ubuntu 22.04 LTS
+======================== ========================
+
+
+Importing Windows guest VMs from VMware requires installing the virtio drivers on the hypervisor hosts for the virt-v2v conversion.
+
+On RHEL9 hosts:
+
+ ::
+
+ yum -y install http://jenkins.openvm.eu/files/virtio-win/virtio-win-1.9.33-0.el9_2.noarch.rpm
Review Comment:
```suggestion
yum install virtio-win
```
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Import VMware VMs into KVM - Documentation [cloudstack-documentation]
Posted by "NuxRo (via GitHub)" <gi...@apache.org>.
NuxRo commented on code in PR #342:
URL: https://github.com/apache/cloudstack-documentation/pull/342#discussion_r1374596943
##########
source/adminguide/virtual_machines/importing_vmware_vms_into_kvm.rst:
##########
@@ -0,0 +1,116 @@
+.. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information#
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+ http://www.apache.org/licenses/LICENSE-2.0
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+.. 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.
+
+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.
+
+Requirements on the KVM hosts
+-----------------------------
+
+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.
+
+In case virt-v2v is not installed on a KVM host attempting a Virtual Machine conversion from VMware, the process fails.
+
+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:
+
+ ::
+
+ virtv2v.verbose.enabled=true
+
+
+Installing virt-v2v on Ubuntu KVM hosts does not install nbdkit which is required in the conversion of VMWare VCenter guests. To install it, please execute:
+
+ ::
+
+ apt install nbdkit
+
+
+Supported Distributions for KVM Hypervisor:
+
+
+.. cssclass:: table-striped table-bordered table-hover
+
+======================== ========================
+Linux Distribution Supported Versions
+======================== ========================
+Alma Linux 8, 9
+Red Hat Enterprise Linux 8, 9
+Rocky Linux 8, 9
+Ubuntu 22.04 LTS
+======================== ========================
+
+
+Importing Windows guest VMs from VMware requires installing the virtio drivers on the hypervisor hosts for the virt-v2v conversion.
+
+On RHEL9 hosts:
+
+ ::
+
+ yum -y install http://jenkins.openvm.eu/files/virtio-win/virtio-win-1.9.33-0.el9_2.noarch.rpm
Review Comment:
```suggestion
yum install virtio-win
You can also install virtio-win manually from https://fedorapeople.org/groups/virt/virtio-win/direct-downloads/stable-virtio/virtio-win.noarch.rpm
```
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Import VMware VMs into KVM - Documentation [cloudstack-documentation]
Posted by "blueorangutan (via GitHub)" <gi...@apache.org>.
blueorangutan commented on PR #342:
URL: https://github.com/apache/cloudstack-documentation/pull/342#issuecomment-1798076994
QA-Doc build preview: https://qa.cloudstack.cloud/builds/docs-build/pr/342. (QA-JID 166)
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [cloudstack-documentation] blueorangutan commented on pull request #342: Migrate VMware VM to KVM template documentation
Posted by "blueorangutan (via GitHub)" <gi...@apache.org>.
blueorangutan commented on PR #342:
URL: https://github.com/apache/cloudstack-documentation/pull/342#issuecomment-1740614963
QA-Doc build preview: https://qa.cloudstack.cloud/builds/docs-build/pr/342. (QA-JID 135)
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Import VMware VMs into KVM - Documentation [cloudstack-documentation]
Posted by "blueorangutan (via GitHub)" <gi...@apache.org>.
blueorangutan commented on PR #342:
URL: https://github.com/apache/cloudstack-documentation/pull/342#issuecomment-1893661672
QA-Doc build preview: https://qa.cloudstack.cloud/builds/docs-build/pr/342. (QA-JID 192)
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org