Edit

Share via

Upgrading to Dynamics 365 Business Central 2024 release wave 2

  • Article

Business Central 2024 Release wave 2 (version 25) is the 11th major release that is fully AL-based. Business Central 2019 release wave 2 (version 15) marked the release in which C/AL was replaced by AL. The classic development environment, known as C/SIDE, was deprecated. From an application perspective, Business Central is now extension-based only. The Business Central base application is delivered as an AL extension. Also, application functionality that isn't related to the business logic has moved into separate modules. These modules are combined into an extension known as the System Application. This change influences how you do the upgrade compared to earlier releases.

Upgrade path

Depending on your current version, a direct upgrade to version 25 isn't always possible. You might have to first upgrade to an intermediate version. The following table describes the upgrade paths for supported versions:

Source version Path
  • Microsoft Dynamics NAV 2015 (version 8)
  • Microsoft Dynamics NAV 2016 (version 9)
  • Microsoft Dynamics NAV 2017 (version 10)
  • Microsoft Dynamics NAV 2018 (version 11)
  • Business Central October 2018 (version 13)
  1. Business Central Spring 2019 (version 14)
  2. Business Central 2024 release wave 2 (version 25)
This path requires you convert your application from C/AL to AL.
  • Business Central Spring 2019 (version 14)
  • Business Central 2019 Release Wave 2 (version 15)
  • Business Central 2020 release wave 1 (version 16)
  • Business Central 2020 release wave 2 (version 17)
  • Business Central 2021 release wave 1 (version 18)
  • Business Central 2021 release wave 2 (version 19)
  • Business Central 2022 release wave 1 (version 20)
  • Business Central 2022 release wave 2 (version 21)
  • Business Central 2023 release wave 1 (version 22)
  • Business Central 2023 release wave 2 (version 23)
  • Business Central 2024 release wave 1 (version 24)
 Direct to version 25

Your current version doesn't have to be the latest update for the version. However, for intermediate versions, use to the latest available update.

Upgrade overview

When upgrading your Business Central Spring 2019 (version 14) solution to version 25, the goal is to move towards a full uptake of the Business Central base and system applications, as they are, and migrating code customizations to add-on extensions. There are different upgrade levels that you follow to get to this state, as illustrated in the following figure. We recommend that you refactor to the system application as a minimum.

Upgrade path on Business Central application.

New and changed features

There are several new and changed platform and application features available in Business Central 2024 release wave 2. These changes affect users, administrators, and developers. Learn more at Overview of Dynamics 365 Business Central 2024 Release Wave 2.

Business Foundation extension

This extension is introduced in version 25 and currently contains objects and logic for number series, which was previously part of the base application. It will contain more functionality in future releases. The base application now has a dependency on the business foundation extension in addition to the system application. This change affects the upgrade process because the business foundation extension needs to be published and installed on the tenant before the base application.

Deprecated features

Before you upgrade, review the following articles to get an overview of features deprecated in this release:

From these articles, use the links in the table of contents to view more deprecated features, like features specific to local versions.

Migrating from on-premises to online

For information about migrating an on-premises solution to online, see Migrate to Business Central Online from Business Central On-premises.

Upgrading to Business Central
Upgrading Extensions
Dynamics 365 Business Central Upgrade Compatibility Matrix