{"title":"Business Central Technical Upgrade Quick Reference","url":"https://jonas-paprotka.de/docs/dev-itpro/upgrade/technical-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/technical-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/technical-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 Technical Upgrade Quick Reference","slug":"business-central-technical-upgrade-quick-reference","at":0,"chars":4086},{"level":2,"title":"Prerequisites","slug":"prerequisites","at":213,"chars":232},{"level":2,"title":"Prepare the old application database","slug":"prepare-the-old-application-database","at":445,"chars":1220},{"level":2,"title":"Run the technical upgrade","slug":"run-the-technical-upgrade","at":1665,"chars":1336},{"level":2,"title":"Post-upgrade tasks","slug":"post-upgrade-tasks","at":3001,"chars":1085}],"text":"# Business Central Technical Upgrade Quick Reference\nThis article provides an overview of the technical upgrade process for Business Central. For more detailed steps, see Technical Upgrade<converting-a-database>.\n## Prerequisites\n|Step|More info|Done|\n|----|-----------|--|\n|Convert custom V1 extensions to V2 extensions.|See...<../developer/devenv-upgrade-v1-to-v2-overview>||\n|Transitioning from codeunit 1.|See...<transition-from-codeunit1>|\n## Prepare the old application database\n|Step|More info|Done|\n|----|-----------|--|\n|Backup the database(s).|See...<https://learn.microsoft.com/sql/relational-databases/backup-restore/create-a-full-database-backup-sql-server>||\n|(Single-tenant mode only) Uninstall all extensions. (Multitenant mode) Unintsall all V1 extensions.|See...<https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.apps.management/uninstall-navapp>||\n|(Optional) Unpublish unwanted extension versions .|See...<https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.apps.management/unpublish-navapp>||\n|Ensure all objects are compiled, unlocked, and tables are synchronized.|See...<../cside/cside-compiling-objects>||\n|Upload a Business Central partner license.|See...<../cside/cside-upload-license-file>||\n|(Multitenant mode only) Dismount the tenant|See...<https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.management/dismount-navtenant?view=dynamicsnav-ps-2018>||\n|Stop the Dynamics NAV or old Business Central Server Instance|||\n|Clear the dbo.Server Instance and dbo.Debugger Breakpoint tables in SQL Server.|See...<converting-a-database#clearsql>||\n|Close all connections to the database.|||\n## Run the technical upgrade\n|Step|More info|Done|\n|----|-----------|--|\n|Install Business Central.|See...<../deployment/install-using-setup>|\n|Open the Dynamics NAV Development Environment as an administrator.|||\n|Connect to and convert the application database.|See...<../cside/cside-open-database>||\n|Add custom control add-ins to the server instance.|See...<converting-a-database#controladdins>||\n|Connect a Business Central Server instance to the converted application database.|See...<../administration/connect-server-to-database>||\n|Connect development environment to the server instance.|See...<../cside/cside-change-server-instance>||\n|Import codeunit 1 replacement.|See...<codeunit1-replacement>||\n|Compile all objects. Important: Choose to synchronize schema later.|See...<../cside/cside-compiling-objects>||\n|Fix compilation errors.|See...<resolve-compile-errors-when-converting-dynamics-nav-2018-database>||\n|Repair published V2 extensions.|See...<https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.apps.management/repair-navapp>||\n|(Multitenant mode only) Mount the tenant database.|See...<https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.management/mount-navtenant>||\n|Synchronize the tenant/database.|See...<../administration/synchronize-tenant-database-and-application-database>||\n## Post-upgrade tasks\n|Step|More info|Done|\n|----|-----------|--|\n|Upgrade Javascript-based control add-ins to new versions available on Business Central Server.|See...<converting-a-database#extensions>|\n|(Single-tenant mode only) Install the V2 extensions that were previously uninstalled.|See...<https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.apps.management/install-navapp>|\n|If the old database used first-party V1 extensions, publish and install the V2 extensions that replace them.<br /><br />Important As part of this step, make sure to publish the system and test symbols and generate application symbols.|See...<converting-a-database#extensions>||\n|Transition custom code from old codeunit 1 to management codeunits. (Dynamics NAV 2018 and earlier)|See...<transition-from-codeunit1>||\n|Configure pages and reports included in the MenuSuite to be searchable in the Web client (Dynamics NAV 2018 and earlier)|See...<upgrade-pages-report-for-search>||\n|Build object search index.|||\n|Upload the customer license.|See...<../cside/cside-upload-license-file>||"}