---
id: topic/dev-itpro/business-central-on-premises/upgrade/earlier-versions/business-central-2021-release-wave-2
type: topic
title: Business Central 2021 release wave 2
summary: Upgrading on-premises Business Central to 2021 release wave 2 (version 19) from versions 14 to 18. Covers technical upgrade steps, C/AL to AL conversion with Txt2Al, moving tables between extensions with migration.json, permission set upgrades, installing version 19 cumulative updates, the India data migration toolkit, and the upgrade compatibility matrix.
tier: official
language: en
system: platform
review:
  state: reviewed
  by: opus
  at: "2026-10-07T02:18:56.174Z"
  flags: []
generated:
  at: "2026-10-08T00:04:31.553Z"
  pipeline: 0.2.0
  prompts:
    hub-topic: 1
  input_hash: 41c476edf62f616483e8683e04f7b0b70d7c37fa316cae43323046cd849a2ec6
evidence:
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-v14-v15-compatibility
    title: Business Central Upgrade Compatibility Matrix
    date: "2026-10-01"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/devenv-code-conversion
    title: Code Conversion from C/AL to AL
    date: "2021-04-01"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/india-data-migration-toolkit-overview
    title: India Data migration Toolkit Overview
    date: "2022-02-18"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrading-cumulative-update-v19
    title: Install a version 19 update
    date: "2024-04-18"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-migrate-table-fields
    title: Migrating Tables and Fields Between Extensions
    date: "2021-04-01"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-migrate-table-fields-down
    title: Moving Tables and Fields to Extensions Down the Dependency Graph
    date: "2021-04-01"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-migrate-table-fields-up
    title: Moving Tables and Fields to Extensions Up the Dependency Graph
    date: "2021-04-01"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-technical-upgrade-v14-v19
    title: Technical upgrade From version 14 to version 19
    date: "2024-04-18"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-technical-upgrade-v19
    title: Technical upgrade to version 19
    date: "2024-04-18"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-overview-v19
    title: Upgrade to Business Central 2021 Wave 2
    date: "2024-04-18"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-to-microsoft-base-app-v19
    title: Upgrading Customized C/AL Application to Microsoft Base Application for Version 19
    date: "2024-04-18"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-permissions
    title: Upgrading Permission Sets and Permissions
    date: "2026-01-08"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-unmodified-application-v14-v19
    title: Upgrading unmodified C/AL application to version 19
    date: "2024-04-18"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-unmodified-application-to-v19
    title: Upgrading Version 15, 16, 17, or 18 Base Application to Version 19
    date: "2024-04-18"
    commit: null
    t: null
    quote: null
links:
  learn:
    - https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-v14-v15-compatibility
    - https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/devenv-code-conversion
    - https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/india-data-migration-toolkit-overview
    - https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrading-cumulative-update-v19
    - https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-migrate-table-fields
    - https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-migrate-table-fields-down
    - https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-migrate-table-fields-up
    - https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-technical-upgrade-v14-v19
    - https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-technical-upgrade-v19
    - https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-overview-v19
    - https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-to-microsoft-base-app-v19
    - https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-permissions
    - https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-unmodified-application-v14-v19
    - https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-unmodified-application-to-v19
  objects: []
  features: []
  topics:
    - topic/dev-itpro/business-central-on-premises/upgrade/earlier-versions
  localizations: []
  videos: []
  posts: []
  guidelines: []
learn_toc_path:
  - Business Central on-premises
  - Upgrade
  - Earlier versions
  - Business Central 2021 release wave 2
toc_file: dev-itpro/TOC.md
parent: topic/dev-itpro/business-central-on-premises/upgrade/earlier-versions
children: []
coverage:
  learn: 14
  code: 0
  video: 0
  blog: 0
  guideline: 0
bc_forms:
  - 19010
member_hash: ef3913252dea240f8919ecc7691668f6f794bf2c0afb81aabf4fff96a832885e
narrative: generated
---

# Business Central 2021 release wave 2

> Upgrading on-premises Business Central to 2021 release wave 2 (version 19) from versions 14 to 18. Covers technical upgrade steps, C/AL to AL conversion with Txt2Al, moving tables between extensions with migration.json, permission set upgrades, installing version 19 cumulative updates, the India data migration toolkit, and the upgrade compatibility matrix.

Path: [Business Central on-premises](../../../business-central-on-premises.md) > [Upgrade](../../upgrade.md) > [Earlier versions](../earlier-versions.md) > Business Central 2021 release wave 2 · tier official · system platform · narrative reviewed (checked by Opus)

## Overview

This section documents upgrades to Business Central 2021 release wave 2 (version 19). The entry page, "Upgrade to Business Central 2021 Wave 2", describes the two options: a technical upgrade or application refactoring. Pick the path that matches your starting version and how customized your application is.
Separate articles cover each starting point. From versions 16, 17 or 18 there is a technical upgrade. A base application upgrade covers versions 15, 16, 17 and 18. From version 14 there are three cases: an unmodified C/AL application (version 14 or earlier), a customized C/AL application moved to the Microsoft base application, and a technical upgrade that converts a version 14 application with C/AL customizations to the version 19 platform using AL base application extensions. Supporting pages cover Txt2Al code conversion, permission sets as AL objects, moving tables and fields between extensions with migration.json, and installing a version 19 cumulative update.
Start with the overview page and the compatibility matrix to confirm your path. Then follow the matching upgrade article. Use the migration and permission pages when you have customizations. The India Data Migration Toolkit page applies only to Dynamics NAV 2016 India upgrades.

## Key points

- Two upgrade options to version 19: technical upgrade or application refactoring.
- Technical upgrade to version 19 applies from versions 16, 17 or 18, and includes database conversion, extension compilation, tenant mounting and synchronization.
- A base application upgrade page covers versions 15, 16, 17 and 18, including extension publishing, data upgrade and permission sets.
- Version 14 C/AL applications, modified or unmodified, move to the Microsoft System and Base Application extensions using the DestinationAppsForMigration server setting. Customized applications also use migration.json for a two-phase table migration.
- The Txt2Al tool converts version 14 C/AL customizations to AL, including .NET interoperability and test library conversion.
- Tables and fields can move between extensions using migration.json. Moving down the dependency graph is direct. Moving up needs a two-stage process with a transition extension.
- Permissions change from legacy data-based permissions to AL object-based Permission Set and Permission Set Extension objects.
- The India Data Migration Toolkit upgrades Dynamics NAV 2016 India data in two steps. It covers localization data but not customizations.

## Learn pages

- [Business Central Upgrade Compatibility Matrix](https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-v14-v15-compatibility): Provides an overview of the Business Central versions and their compatibility
- [Code Conversion from C/AL to AL](https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/devenv-code-conversion): Description of the conversion process from C/AL to AL.
- [India Data migration Toolkit Overview](https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/india-data-migration-toolkit-overview): Specifies India Data Migration Toolkit Overview
- [Install a version 19 update](https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrading-cumulative-update-v19): This article describes the tasks required for getting the monthly version 19 update applied to your Dynamics 365 Business Central on-premises.
- [Migrating Tables and Fields Between Extensions](https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-migrate-table-fields): Explains how to migrate tables and fields from one extension to another.
- [Moving Tables and Fields to Extensions Down the Dependency Graph](https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-migrate-table-fields-down): Explains how to move tables and fields from an extension to another extension that is down the dependency graph.
- [Moving Tables and Fields to Extensions Up the Dependency Graph](https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-migrate-table-fields-up): Explains how to move tables and fields from an extension to another extension that is up the dependency graph
- [Technical upgrade From version 14 to version 19](https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-technical-upgrade-v14-v19): Describes how to do a technical upgrade from Business Central 14 to 19
- [Technical upgrade to version 19](https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-technical-upgrade-v19): Describes how to do a technical upgrade from Business Central 16, and 17, and V18 to V19
- [Upgrade to Business Central 2021 Wave 2](https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-overview-v19): Provides an overview of Business Central 2021 release wave 2 upgrade
- [Upgrading Customized C/AL Application to Microsoft Base Application for Version 19](https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-to-microsoft-base-app-v19): Describes how to do an upgrade from a customized Business Central 14 to Microsoft Base Application for version 19
- [Upgrading Permission Sets and Permissions](https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-permissions): Describes how to upgrade permissions and permission sets
- [Upgrading unmodified C/AL application to version 19](https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-unmodified-application-v14-v19): Describes how to upgrade an unmodified Business Central 14 application to version 19
- [Upgrading Version 15, 16, 17, or 18 Base Application to Version 19](https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-unmodified-application-to-v19): Describes how to upgrade an unmodified Business Central 15, 16, or 17 application to version 19

## Business Central pages and reports

The pages, reports and queries this hub's Learn pages name (ms.search.form, API reference), joined to the code by exact object id (data/index/docs-objects.json); a page shows the table it runs on.

Learn also names 1 object with no object page: page/19010.

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