topic hubPlatform, DevOps & Performanceofficial - Microsoftreviewed - checked by Opus

Business Central 2025 release wave 2 (v27)

Upgrade guidance for on-premises Business Central 2025 release wave 2 (version 27). It answers questions about upgrade paths, pre-upgrade considerations, installing a version 27 update, and upgrading the System and Base Application from versions 25 and 26.

Path: Business Central on-premises > Upgrade > Business Central 2025 release wave 2 (v27) · tier official · system platform · narrative reviewed (checked by Opus)

Overview

This section covers moving an on-premises Business Central deployment to 2025 release wave 2 (version 27). It has four pages: an overview of upgrade paths, a page of considerations before upgrading, a procedure for installing a version 27 update, and a step-by-step procedure for upgrading the Microsoft System and Base Application.

Start with the overview page on upgrade paths. It covers deprecated features and the system application refactoring. Then read the considerations page, which lists items to check before you begin. Finally, follow either the update installation page or the System and Base Application upgrade page, depending on your scenario.

The technical steps are similar in both procedures: database conversion, extension publishing, tenant synchronization, and data upgrade. The upgrade page also covers permission set migration and encryption management.

Key points

  • The overview page covers upgrade paths to version 27, deprecated features, system application refactoring, the base application, and add-on extensions.
  • The pre-upgrade considerations page covers versions 26 to 29. It addresses deprecated or redesigned functionality, deleted objects (v24 and earlier), and the performance impact of installed extensions.
  • Schema changes in the Subscription Billing extension (v25 to v26 and later) are covered, including force sync for schema migration.
  • Deployment changes from v23 are noted: server port 7085 and SPN delegation configuration.
  • Microsoft recommends transitioning to AL-based permissions.
  • The update installation page covers database conversion, extension publishing, tenant synchronization, platform upgrade, and data upgrade, including multitenant deployments.
  • The System and Base Application upgrade page gives steps for upgrading from versions 25 and 26 to version 27. It includes permission set migration and encryption management.

Learn pages

Source: Microsoft Learn (CC BY 4.0). Descriptions are Learn’s own.

What Learn documents here 4 Learn pages