Visit our QuickStart guide and explore our Table of Contents below to review the project's documentation.
The VMware Architecture Migration Tool (VAMT) is designed to provide an easy and automated process to cold migrate machines between clusters of different architecture types within the same vCenter or across vCenter Server instances. In an effort to provide a useful and intuitive tool, the following features have been implemented:
- Change Window Support - Ability to schedule migration within a time frame and stop new migrations if the defined time frame is exceeded.
- Process Throttling - Control of how many parallel migrations tasks that vSphere will be asked to execute.
- Syslog Support - Ability to send logs to a syslog server.
- Email Notifications Support - A report of the logs and individual VM migration status can be sent to an email address.
- Best Effort Migrated VM Success Validation - The tool will wait for VMware Tools to load successfully after the VM has been migrated.
- Extensibility Stubs - The tool provides a stub of functions to add customization before and after VM is migrated.
- Maintain the VM's UUID - In an effort to ensure external tools still recognize the VM after migration the UUID is maintained.
- Rollback - Ability to rollback a migration after initial migration execution.
Below is a list of known limitations. This by no means can be a complete list as there may be limitations that have not been considered.
- Designed to be executed from Windows only.
- Rollback process will send VM back to its original vCenter, ESXi host, resource pool, datastore(s), and network(s). Not supporting cluster for rollback allows the widest array of supported scenarios. If rollback target needs to be modified, it can be updated in the VM properties/attributes.
- Migrations will start up until the end of the change window and run until complete, possibly past the defined window.
- Cold migrations initiated by this script are constrained by the limitations and requirements of vSphere & PowerCLI.
- For example, initiating a migration between major vSphere versions (i.e., vSphere 7 -> 8) could have special requirements or limitations that cannot be documented here.
Visit Design.md to review the details of VAMT's design including:
Visit Script_Prerequisites.md to review the prerequisites for running the VAMT.
Visit Script_Usage.md to review the details for running VMwareArchitectureMigrationTool.ps1.
The vmware-architecture-migration-tool project team welcomes contributions from the community. Before you start working with this project please read and sign our Contributor License Agreement (https://cla.vmware.com/cla/1/preview). If you wish to contribute code and you have not signed our Contributor License Agreement (CLA), our bot will prompt you to do so when you open a Pull Request. For any questions about the CLA process, please refer to our FAQ. For more detailed information, refer to CONTRIBUTING.md.
VMware Architecture Migration Tool is available under the GPL v3.0 license. Please see LICENSE.
