# The Migration Execution Guide
This repo contains a Migration Execution Guide, which has been authored and developed by a team of FastTrack for Azure Program Managers and Engineers working with the Microsoft SMC team, the Azure Advanced Cloud Engineering team and the Customer Success Unit. It provides prescriptive guidance for the structure and running of a successful migration project. The guidance includes digital estate discovery, defining the migration scope with common business drivers, selection and implementation of migration tooling, project management, risk management and many other related templates. Objectives include:
* Provide consistent, well-considered migration execution guidance at the business, project and technical levels.
* Reduce the time required on Azure migration readiness by taking the complexity out of the different architectures, methodologies and prerequisite work.
* Pre-empt support incidents, service outages and project delays by detailing a clear phase-by-phase migration journey with FastTrack for Azure best practices. These best practices are based on field experience, incident root cause analysis, highlighting of common risks, and additional risk mitigation through request for change templates, and other templates with attributes that specifically address common mistakes and oversights during migrations.
This is a sample of the checklist with various recommendations. The list can be filtered based on the different stages of your migration, the relevant topics, source environments, etc.
[](/images/list.png)
## Artifacts
[MEG v0.97 Framework (draft release)](https://github.com/Azure/migration/blob/main/excel/MEG%20v0.97%20-%20Framework.xlsx)
[MEG v0.96 Checklist (draft release)](https://github.com/Azure/migration/blob/main/excel/MEG%20v0.96%20-%20Checklist.xlsx)
[MEG v0.95 Checklist (Japanese) (draft release)](https://github.com/Azure/migration/blob/main/excel/MEG%20v0.95%20-%20Checklist_ja.xlsx)
## Migration Framework
The Migration Execution Guide defines the migration framework as detailed in the graphic below. In addition, the [design of a new, or validation of an existing landing zone](https://github.com/Azure/review-checklists) for migrated workloads is recommended along with a [cloud operating model and operations plan](https://github.com/Azure/cloud-rolesandops) to manage migrated workloads. However, neither of these are within the scope of the Migration Execution Guide. FastTrack for Azure have separate resources to assist with these areas.
[](/images/migrationlifecycle.png)
## Microsoft Programs and Funding
|Program |Description|
| ------------ | ------------ |
|[FastTrack for Azure](https://www.microsoft.com/azure/partners/fasttrack-for-azure)|FastTrack for Azure is a technical enablement program for organizations with cloud projects that enables the rapid, effective design, and deployment of Azure solutions in the cloud. It includes tailored guidance from Azure engineers that leverages proven practices and architectural guides.|
|[Microsoft Solution Assessment Program](https://www.microsoft.com/en-us/solutionassessments/)|To ensure you use data driven insights to plan your digital transformation.|
|[Azure Migration and Modernisation Program](https://azure.microsoft.com/en-us/migration/migration-modernization-program/#overview)|End-to-end migration assistance with the migration of workloads like, SQL, SAP, AVD and application modernisation.|
|[Azure Migration and Modernization Program (Partners)](https://www.microsoft.com/azure/partners/ammp)|Microsoft Partners to assist with your program of work.|
|[Azure Migration and Modernization Program (Partner-led)](https://partner.microsoft.com/en-US/partnership/partner-incentives/azure-migration-and-modernization-program)|Partner investments and incentives can help drive the technical and workplace innovations you need to advance your business and your customers’ digital transformation.|
|[Azure Analytics and AI Accelerate Program](https://partner.microsoft.com/en-US/solutions/azure/azure-accelerate-program)|The Azure Analytics and AI Accelerate Program (AAAP) is a proven approach to help partners accelerate customer demand and consumption of Analytics & AI Services. The program decreases the time to solution and increases your ability to win!|
**Please Note! Microsoft programs and funding are subject to change. Please discuss with your Microsoft representative if you would like to participate in any of the programs.**
## Content
Work through the steps, or navigate directly to a topic of interest. Refer to the below summary of the content in the Excel Spreadsheet.
|Step |Item |Description |
| ------------ | ------------ | ------------ |
|1| Review the migration phases to get an understanding of the end-to-end procedure |Migration Lifecycle|
|2| Review workshop questions |Sample questions to use during workshops with the business and technical teams in order to populate the migration templates and make migration decisions.
[](/images/questions.png)|
|3| Review the DACI matrix to understand the roles and responsibilities within a typical migration project |Resource Management
[](/images/daci.png)|
|4| Assign resources to roles and responsibilities using the Team worksheet |Resource Management|
|5| Familiarize or refresh knowledge using recommended training resources and reference material |Training|
|6| Reference the 'Tooling...' worksheets for a visual summary of the different discovery, assessment and migration strategies. |Tooling|
|7| Use the Checklist to ensure that key business, project management and technical recommendations are followed, and common issues are avoided |Best practice, field experience and incident root cause driven guidance.
[](/images/list.png)|
|8| Consider templates for your project, including: ||
|| Project Plan Template |Project Management
[](/images/projectplan.png)|
|| Digital Estate Discovery Template |The purpose of the digital estate discovery is to present an inventory of applications and services to the business in order to determine the scope and nature of a migration project. Important dates should be captured and mapped to milestones in the project plan.
[](/images/digitalestate.png)|
|| Workload Template |The purpose of the workload resource is to document and map the current technical attributes of the individual components of a workload to the future attributes of the migrated state. The information in this resource is used as input when configuring replication and migration options. It is also an important input to pre-and-post migration tasks that form the migration-day runbook.
[](/images/workload.png)|
|| Wave Template |The purpose of a wave plan is to document the workloads that will be grouped together in a single migration sprint. Dependent services are typically included in the same Migration Wave. In the portal, you can select up to 10 VMs at once for migration. To migrate more machines, add them to groups in batches of 10.
[](/images/wave.png)|
|| Runbook Template |The purpose of a migration-day runbook is to provide migration engineers with a proven list of tasks to perform during test and production migration windows. The migration runbook in this guide is an example of what should be created for every machine, in all environments, for each workload.
[](/images/runbook.png)|
|| Change Template |The purpose of the request for change template is to provide migration specific details for consideration by the business, service management and migration teams for inclusion in their change management process. It is also an additional checkpoint to help ensure that important migration decisions are made and relevant tasks carried out. It is recommended to seek approval early, clarify expectations and roles of approvers in advance and to establish a Cloud Change Authority.
[](/images/rfc.png)|
|| Risk Register Template |The risk register is a very important part of every migration project. The purpose of the example in this guide is to detail common risks that need to be evaluated along with any available mitigation, and plans to migrate services that are subject to these risks.
[](/images/risk.png)|
------------
## Related FastTrack for Azure Resources
- [Landing Zone Review Checklist](https://github.com/Azure/review-checklists)
- [Cloud Roles and Operations Management](https://github.com/Azure/cloud-rolesandops)
- [FastTrack for Azure on Microsoft Learn](https://learn.microsoft.com/en-us/training/azure/fasttrack)
## Contributing
This project welcomes contributions and suggestions. Most contributions require you to agree to a
Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us
the rights to use your contribution. For details, visit https://cla.opensource.microsoft.com.
When you submit a pull request, a CLA bot will automatically determine whether you need to provide
a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions
provided by the bot. You will only need to do this once across all repos using our CLA.
This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or
contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.
## Trademarks
This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft
trademarks or logos is subject to and must follow
[Microsoft's Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).
Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.
Any use of third-party trademarks or logos are subject to those third-party's policies.