Business Central Single-Tenant Full Upgrade Quick Reference
This article provides an overview of the full upgrade process for Business Central in a single-tenant deployment. For more detailed steps, see Upgrading the Data: Single-Tenant Mode.
Prerequisite tasks on old database
| Step | More info | Done |
|---|---|---|
| Upgrade application code. | See... | |
| Convert custom V1 extensions to V2 extensions. | See... | |
| Export permissions and permission sets. Important: Make sure your computer uses the same codepage as the data. |
See... | |
| Export encryption keys from the old deployment. | See... | |
| Prepare for transitioning from codeunit 1. Note: Dynamics NAV upgrade only |
See... | |
| Install Business Central components. | See... |
Prepare the old database for data upgrade
| Step | More info | Done |
|---|---|---|
| Backup the database. | See... | |
| Uninstall all extensions. | See... | |
| Upload a Business Central partner license. | See... | |
| Delete all objects except tables. Important Do not synchronize schema at this point. |
See... | |
| Clear server instance and debugger breakpoint tables. | See... |
Run the data upgrade
| Step | More info | Done |
|---|---|---|
| Open Dynamics NAV Development Environment for Business Central as an administrator | ||
| Connect to and convert the database. | See... | |
| Import upgraded application and upgrade toolkit objects (.fob files). Important: Select to synchronize later. |
See... | |
| Connect a Business Central Server instance to the converted database. | See... | |
| Compile all objects. Important: Choose to synchronize schema later. |
See... | |
| Increase the application version of the database, Note: Dynamics NAV 2018 upgrade only |
See... | |
| Synchronize the database. | See... | |
| Run the data upgrade. | See... | |
| Update Javascipt control add-ins the data upgrade. | See... |
Publish, upgrade, and install extensions
| Step | More info | Done |
|---|---|---|
| Publish system and test symbols, generate application symbols. | See... | |
| Publish, synchronize, and upgrade to new versions of Microsoft extensions from installation media. | '' | |
| Repair, synchronize, and install old extension versions that were not upgraded in previous step. | '' | |
| Run the data upgrade on the new extension versions. | '' | |
| Repair other custom extensions to work on new platform. | '' |
Post-upgrade tasks
| Step | More info | Done |
|---|---|---|
| Import permissions and permission sets. | See... | |
| Import encryption keys | See... | |
| Upload the customer license. | See... |
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for