Bug Reference

tbd

Branch

tbd

Introduction

Users I want to be able to upgrade their data store in vsphere and migrate existing VMs and data to the new store. For this they need to migrate stopped VMs and detached disks which is not possible at the moment. Vmware does provide this functionality. The intention of this FS is to leverage vmware's functionality in existing APIs.

References

• N/A

Glossary

Feature Specifications

• A stopped VM will be able to be migrated to an other datastore in vmware.

• A stand alone volume stored on a primary storage (in vmware) will be able to be migrated to another storage in the same cluster.

cross cluster migrations are not supported. migrations will be checked for supported tags on the target datastore.

compatibility requirements:

this is only applicable to Vmware

performance for this feature is depending on the underlying resources such as vsphere and esxi hosts, network bandwidth and datastore speed.

Use cases

migrating a offline VM or volume is now a copy from primary to secondary and back to the new primary. This can be time consuming and will require large job timeouts. This can be cut in abpout half by letting the hypervisor perform the migration directly.

Architecture and Design description

• for offline VM migration the existing API will be used. a method finalizeMigration is created that returns a set of commands to execute on the resource to perform the migration. for VMWare this returns the needed commands, as default a null will be returned indicating the hypervisor type can not perform this function. (storage migration is to be used in those cases.
• for detached volume migration the vmware storage migration stratgy can return the priority of HYPERVISOR. For vmware this would mean that the copyAsync call as implemented by storage migration strategies would actually do a full migration instad of a copy. The subsequetial delete is mute and will succeed as not needed.

Web Services APIs

No API will be changed to implement this functionality. The semantics of migrateVirtualMachine and migrateVolume will be changed in that these will now yield results on vmware, as opposed to yielding errors. 

UI flow

No UI change will be implemented

Usage Impact

No usage impact is foreseen.

Appendix

Appendix A:

Appendix B: