{"title":"Business Central Multitenant Full Upgrade Quick Reference","url":"https://jonas-paprotka.de/docs/dev-itpro/upgrade/multitenant-upgrade-checklist/","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/upgrade/multitenant-upgrade-checklist, 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/upgrade/multitenant-upgrade-checklist","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","date":"2024-04-18","meta":{"topic":"upgrade-and-migration-article"},"outline":[{"level":1,"title":"Business Central Multitenant Full Upgrade Quick Reference","slug":"business-central-multitenant-full-upgrade-quick-reference","at":0,"chars":3527},{"level":2,"title":"Prerequisite tasks","slug":"prerequisite-tasks","at":271,"chars":645},{"level":2,"title":"Upgrade the application and prepare it for data upgrade","slug":"upgrade-the-application-and-prepare-it-for-data-upgrade","at":916,"chars":795},{"level":2,"title":"Prepare the tenant database for data upgrade","slug":"prepare-the-tenant-database-for-data-upgrade","at":1711,"chars":542},{"level":2,"title":"Run the data upgrade on the tenant","slug":"run-the-data-upgrade-on-the-tenant","at":2253,"chars":958},{"level":2,"title":"Post-upgrade tasks","slug":"post-upgrade-tasks","at":3211,"chars":316}],"text":"# Business Central Multitenant Full Upgrade Quick Reference\nThis article provides an overview of the full upgrade process for Business Central in a multitenant deployment. For more detailed steps, see Upgrading the Data: Multitenant Mode<upgrading-the-data-multitenant>.\n## Prerequisite tasks\n|Step|More info|Done|\n|----|-----------|--|\n|In the old deployment, convert custom V1 extensions to V2 extensions.|See...<../developer/devenv-upgrade-v1-to-v2-overview>||\n|Export permissions and permission sets from the old deployment. Important: Make sure computer uses the same codepage as the data.|See...<how-to--import-export-permission-sets-permissions>||\n|Export encryption keys from the old deployment.|See...<how-to-export-and-import-encryption-keys>||\n|Prepare for transitioning from codeunit 1.|See...<transition-from-codeunit1>|\n|Install Business Central components.|See...<../deployment/install-using-setup>||\n## Upgrade the application and prepare it for data upgrade\n|Step|More info|Done|\n|----|-----------|--|\n|Upgrade the application code.|See...<upgrading-the-application-code>|\n|Mount the upgraded application on the Business Central Server instance.|See...<https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.management/mount-navapplication>||\n|Import upgrade toolkit (.fob)|See...<../cside/cside-import-objects>||\n|Publish system and test symbols from the installation media, and generate application symbols.|See...<upgrading-the-application-code#AddExtensions>|\n|Publish the new Microsoft extension versions from the installation media.|See...<upgrading-the-application-code#PublishNew>||\n|Upload a Business Central partner license.|See...<../cside/cside-upload-license-file>||\n## Prepare the tenant database for data upgrade\n|Step|More info|Done|\n|----|-----------|--|\n|Backup the tenant database.|See...<https://learn.microsoft.com/sql/relational-databases/backup-restore/create-a-full-database-backup-sql-server>||\n|Uninstall all V1 extensions.|See...<https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.apps.management/uninstall-navapp>||\n|Dismount the tenant from the old server instance.|See...<https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.management/dismount-navtenant>||\n## Run the data upgrade on the tenant\n|Step|More info|Done|\n|----|-----------|--|\n|Mount the tenant on the Business Central Server instance. Important: Use the `-AllowAppDatabaseWrite` parameter.|See...<https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.management/mount-navtenant>|\n|Synchronize the tenant.|See...<../administration/synchronize-tenant-database-and-application-database>||\n|Synchronize all extensions.|See..<https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.apps.management/sync-navapp>||\n|Run the data upgrade. Important: If there are V2 extensions, you must use the `-FunctionExecutionMode Serial` parameter.|See...<https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.management/start-navdataupgrade>||\n|Install the new V2 extensions that were not installed in the old tenant.|See...<https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.apps.management/install-navapp>|\n## Post-upgrade tasks\n|Step|More info|Done|\n|----|-----------|--|\n|Import permissions and permission sets.|See...<how-to--import-export-permission-sets-permissions>||\n|Import encryption keys|See...<how-to-export-and-import-encryption-keys>||\n|Upload the customer license.|See...<../cside/cside-upload-license-file>||"}