Upgrade application and data
Upgrade application and data for Business Central on-premises version 25 (2024 release wave 2). It covers three paths: unmodified C/AL, customized C/AL, and Microsoft System and Base Application upgrades. It answers questions about which steps and tools apply to a given source version.
Path: Business Central on-premises > Upgrade > Business Central 2024 release wave 2 (v25) > Upgrade application and data · tier official · system platform · narrative reviewed (checked by Opus)
Overview
This section describes how to upgrade an on-premises Business Central application and its data to version 25. The right page depends on where you start: a version 14 or earlier C/AL application that is unmodified, a version 14 C/AL application that is customized, or an installation already running the Microsoft System and Base Application.
The unmodified C/AL path replaces the C/AL base application with the Microsoft System and Base Application extensions. The customized path moves your customizations into extensions and transfers table ownership during the data upgrade phases. The System and Base Application page lists steps for source versions 15 through 24, including database conversion, extension publishing, tenant sync and data upgrade.
Start by identifying your current version and whether the base application was modified, then follow the matching page from start to finish.
Key points
- Three upgrade paths: unmodified C/AL, customized C/AL, and Microsoft System and Base Application to version 25.
- Unmodified C/AL upgrade applies to version 14 (Spring 2019) or earlier and replaces the C/AL base application with Microsoft extensions.
- Customized C/AL upgrade starts from version 14 and uses DestinationAppsForMigration, migration.json and a table migration extension.
- Customized path converts code with txt2al and moves application code into extensions, with table ownership transfer in data upgrade phases.
- System and Base Application upgrade covers source versions 15 through 24.
- Steps across the paths include database conversion, publishing extensions, data upgrade, permission sets upgrade and license import; the System and Base Application path also covers tenant synchronization.
- Multitenant deployments are supported in the unmodified C/AL upgrade.
Learn pages
- Upgrading Customized C/AL Application to Microsoft Base Application for version 25: Describes how to do an upgrade from a customized Business Central 14 to Microsoft Base Application for version 25.
- Upgrading Microsoft System and Base Application to Version 25: Describes how to upgrade an unmodified Business Central version 15 through 24 to version 25
- Upgrading Unmodified C/AL Application to version 25: Describes how to upgrade an unmodified Business Central 14 application to version 25
Source: Microsoft Learn (CC BY 4.0). Descriptions are Learn’s own.