Business Central 2024 release wave 2 (v25)
Upgrading Business Central on-premises to 2024 release wave 2 (version 25): upgrade paths, installing a version 25 update, report and permission changes, and application and data upgrade steps. It answers questions about which steps and tools apply to a given source version and what changes to expect.
Path: Business Central on-premises > Upgrade > Business Central 2024 release wave 2 (v25) · tier official · system platform · narrative reviewed (checked by Opus)
Overview
This section covers upgrading Business Central on-premises to 2024 release wave 2 (version 25). The main upgrade page describes the upgrade paths, technical and application code upgrades, and the Business Foundation extension, which now contains number series logic. A general considerations page covers changes across versions 23, 24 and 25, including online migration, deprecated functionality, deployment changes and report platform updates.
The “Install a version 25 update” page walks through installing platform and application components, converting the database, synchronizing tenants, publishing extensions, running the data upgrade and importing the license. The pages on upgrading reports and on upgrading permission sets cover two areas that often need rework: the report rendering model and the move from legacy data-based permissions to AL object-based permissions.
The subtopic “Upgrade application and data” holds the step-by-step paths for unmodified C/AL, customized C/AL, and Microsoft System and Base Application upgrades. Start with the main upgrade page to pick your path, read the general considerations, then follow the install and data upgrade steps for your source version.
Key points
- The main upgrade page describes upgrade paths, technical and application code upgrades, and on-premises to online migration.
- The Business Foundation extension now contains number series logic, tied to System Application refactoring.
- The general considerations page covers versions 23, 24 and 25: cloud migration, deprecated functionality, deployment changes, server port and delegation configuration.
- Installing a version 25 update involves component installation, database conversion, tenant synchronization, extension publishing, data upgrade and license import.
- Report upgrade guidance covers the new rendering model, obsoleted events, Word layouts and custom report renderers, affecting version 24 and later.
- Permission upgrade moves from legacy data-based permissions to AL object-based permissions, using Permission Set and Permission Set Extension objects.
- The Upgrade application and data subtopic has three paths: unmodified C/AL, customized C/AL, and Microsoft System and Base Application upgrades.
Subtopics
- Upgrade application and data (3 pages)
More Learn pages
- General Information and Considerations When Upgrading to Business Central: This article provides tips and considerations to prepare a solution when you’re planning to upgrade to Business Central 2023 release wave 2 and later.
- Install a version 25 update: This article describes the tasks required for getting the monthly version 25 update applied to your Dynamics 365 Business Central on-premises.
- Upgrade reports: Describes how to upgrade reports in Business Central.
- Upgrading Permission Sets and Permissions: Describes how to upgrade permissions and permission sets
- Upgrading to Dynamics 365 Business Central 2024 release wave 2: Provides an overview of Business Central 2024 Release Wave 2 upgrade process.
Source: Microsoft Learn (CC BY 4.0). Descriptions are Learn’s own.
What Learn documents here 8 Learn pages
- learnGeneral Information and Considerations When Upgrading to Business Central2024-09-02
- learnInstall a version 25 update2025-01-10
- learnUpgrade reports2024-03-09
- learnUpgrading Customized C/AL Application to Microsoft Base Application for version 252024-09-04
- learnUpgrading Microsoft System and Base Application to Version 252024-09-04
- learnUpgrading Permission Sets and Permissions2026-01-08
- learnUpgrading to Dynamics 365 Business Central 2024 release wave 22024-02-09
- learnUpgrading Unmodified C/AL Application to version 252024-11-20