{"title":"Upgrade data for Dynamics GP cloud migration","url":"https://jonas-paprotka.de/docs/dev-itpro/administration/migration-data-upgrade-gp/","by":"JOP-AL","license":"Copyright (c) Microsoft Corporation. CC BY 4.0, https://creativecommons.org/licenses/by/4.0/; code samples MIT. From https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/administration/migration-data-upgrade-gp, MicrosoftDocs/dynamics365smb-devitpro-pb at 828b6ee (2026-11-19). Changed: includes filled in, links to this site, and for agents shortened without dropping a fact.","credit":"Microsoft Corporation, CC BY 4.0","origin":"https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/administration/migration-data-upgrade-gp","source":{"name":"Business Central developer and IT pro docs","repo":"https://github.com/MicrosoftDocs/dynamics365smb-devitpro-pb","commit":"828b6ee72fcd75755627cd6011f3d20899217ab2","date":"2026-11-19"},"checked":"2026-11-19","description":"Learn how Dynamics GP data is transformed into Business Central data, control automatic migration, monitor company progress, and handle upgrade failures.","date":"2026-11-17","meta":{"topic":"upgrade-and-migration-article"},"outline":[{"level":1,"title":"Upgrade data for Dynamics GP cloud migration","slug":"upgrade-data-for-dynamics-gp-cloud-migration","at":0,"chars":3092},{"level":2,"title":"Prerequisites","slug":"prerequisites","at":326,"chars":305},{"level":2,"title":"Prepare for data transformation","slug":"prepare-for-data-transformation","at":631,"chars":588},{"level":2,"title":"Run data upgrade","slug":"run-data-upgrade","at":1219,"chars":851},{"level":2,"title":"Recover from upgrade failures","slug":"recover-from-upgrade-failures","at":2070,"chars":506},{"level":2,"title":"Next steps","slug":"next-steps","at":2576,"chars":225},{"level":2,"title":"Related information","slug":"related-information","at":2801,"chars":291}],"text":"# Upgrade data for Dynamics GP cloud migration\nThis article explains the process for running the data upgrade as part of cloud migration. Data upgrade transforms Dynamics GP tables into Business Central tables.\nSee Dynamics GP migration to Business Central online: End-to-end overview<migrate-gp-overview#end-to-end-process>.\n## Prerequisites\nYou ran data replication on the company or companies that you're migrating to the online environment. See Run and manage data replication<migrate-data-replication-run>.\nYou have the SUPER permission set. Complete company setup and resolve replication errors before starting data upgrade.\n## Prepare for data transformation\nDynamics GP migration transforms data for individual companies in background tasks or sessions. It doesn't use the environment-wide upgrade process that disconnects all users. Keep users from entering data in the companies being migrated until migration is complete.\nOn GP Migration Settings, Run migration after replication is on by default. Transformation starts automatically after successful replication. Turn this option off before replication if you want to start the upgrade manually. The manual upgrade action is hidden while this option is on.\n## Run data upgrade\n1. Search for and open the Cloud Migration Management page.\n1. Select the latest successful replication run, then select Run Data Upgrade Now.\nThe data upgrade process starts in the background. Use Refresh Status to update the page. In the GP Migration Overview FactBox, select Migration Errors, Failed Companies, or Failed Batches to investigate problems.\n> NOTE\n> Dynamics GP uses the previous Cloud Migration Management interface. If Run Data Upgrade Now isn't visible after you turn off automatic migration, reopen the page.\n> TIP\n> If telemetry is enabled, view data about the success or failure of cloud migration operations like setup, data replication, and data upgrade. See Enable environment telemetry<telemetry-enable-application-insights> and Analyzing cloud migration trace telemetry<telemetry-cloud-migration-trace>.\n## Recover from upgrade failures\nInvestigate and fix the reported errors before continuing. A failed Dynamics GP company upgrade can't be restarted by selecting Run Data Upgrade Now again. The migration requires you to delete the failed target companies and migrate them again. Don't use Data Migration Overview to restart this cloud migration.\n> WARNING\n> Deleting a company removes its Business Central data. Confirm that the failed target company contains no data you need to retain before deleting it.\n## Next steps\nAfter data upgrade completes, verify the migrated data by running validation tests. See Validate Dynamics GP data migration<migrate-gp-validation>.\nThen proceed to Complete cloud migration<migration-finish-gp>.\n## Related information\nDynamics GP migration to Business Central online: End-to-end overview<migrate-gp-overview>\nCompare work processes in Dynamics GP to Business Central<migrate-dynamics-gp-videos>\nFAQ about migrating to Business Central online from on-premises solutions<faq-migrate-data>"}