Business Central Technical Upgrade Quick Reference

This article provides an overview of the technical upgrade process for Business Central. For more detailed steps, see Technical Upgrade.

Prerequisites

Step More info Done
Convert custom V1 extensions to V2 extensions. See...
Transitioning from codeunit 1. See...

Prepare the old application database

Step More info Done
Backup the database(s). See...
(Single-tenant mode only) Uninstall all extensions. (Multitenant mode) Unintsall all V1 extensions. See...
(Optional) Unpublish unwanted extension versions . See...
Ensure all objects are compiled, unlocked, and tables are synchronized. See...
Upload a Business Central partner license. See...
(Multitenant mode only) Dismount the tenant See...
Stop the Dynamics NAV or old Business Central Server Instance
Clear the dbo.Server Instance and dbo.Debugger Breakpoint tables in SQL Server. See...
Close all connections to the database.

Run the technical upgrade

Step More info Done
Install Business Central. See...
Open the Dynamics NAV Development Environment as an administrator.
Connect to and convert the application database. See...
Add custom control add-ins to the server instance. See...
Connect a Business Central Server instance to the converted application database. See...
Connect development environment to the server instance. See...
Import codeunit 1 replacement. See...
Compile all objects. Important: Choose to synchronize schema later. See...
Fix compilation errors. See...
Repair published V2 extensions. See...
(Multitenant mode only) Mount the tenant database. See...
Synchronize the tenant/database. See...

Post-upgrade tasks

Step More info Done
Upgrade Javascript-based control add-ins to new versions available on Business Central Server. See...
(Single-tenant mode only) Install the V2 extensions that were previously uninstalled. See...
If the old database used first-party V1 extensions, publish and install the V2 extensions that replace them.

Important As part of this step, make sure to publish the system and test symbols and generate application symbols.
See...
Transition custom code from old codeunit 1 to management codeunits. (Dynamics NAV 2018 and earlier) See...
Configure pages and reports included in the MenuSuite to be searchable in the Web client (Dynamics NAV 2018 and earlier) See...
Build object search index.
Upload the customer license. See...