{"title":"Installing a Business Central 2021 Release Wave 2 Update","url":"https://jonas-paprotka.de/docs/dev-itpro/upgrade/upgrading-cumulative-update-v19/","by":"JOP-AL","license":"Copyright (c) Microsoft Corporation. CC BY 4.0, https://creativecommons.org/licenses/by/4.0/; code samples MIT. From https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/upgrade/upgrading-cumulative-update-v19, MicrosoftDocs/dynamics365smb-devitpro-pb at 828b6ee (2026-11-19). Changed: includes filled in, links to this site, and for agents shortened without dropping a fact.","credit":"Microsoft Corporation, CC BY 4.0","origin":"https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/upgrade/upgrading-cumulative-update-v19","source":{"name":"Business Central developer and IT pro docs","repo":"https://github.com/MicrosoftDocs/dynamics365smb-devitpro-pb","commit":"828b6ee72fcd75755627cd6011f3d20899217ab2","date":"2026-11-19"},"checked":"2026-11-19","description":"This article describes the tasks required for getting the monthly version 19 update applied to your Dynamics 365 Business Central on-premises.","date":"2024-04-18","meta":{"topic":"install-set-up-deploy"},"outline":[{"level":1,"title":"Installing a Business Central 2021 Release Wave 2 Update","slug":"installing-a-business-central-2021-release-wave-2-update","at":0,"chars":39248},{"level":2,"title":"Overview","slug":"overview","at":437,"chars":5297},{"level":3,"title":"Application stack","slug":"application-stack","at":934,"chars":2131},{"level":3,"title":"Single-tenant and multitenant deployments","slug":"single-tenant-and-multitenant-deployments","at":3065,"chars":637},{"level":3,"title":"Business Central server and web server instances","slug":"business-central-server-and-web-server-instances","at":3702,"chars":1129},{"level":3,"title":"Platform versus application update","slug":"platform-versus-application-update","at":4831,"chars":903},{"level":2,"title":"PREPARATION","slug":"preparation","at":5734,"chars":15},{"level":2,"title":"PowerShell variables used in tasks","slug":"powershell-variables-used-in-tasks","at":5749,"chars":2124},{"level":2,"title":"Download update package","slug":"download-update-package","at":7873,"chars":918},{"level":2,"title":"Save copies of server configuration files","slug":"save-copies-of-server-configuration-files","at":8791,"chars":1278},{"level":2,"title":"Prepare existing databases","slug":"prepare-existing-databases","at":10069,"chars":2217},{"level":2,"title":"Install Business Central components","slug":"install-business-central-components","at":12286,"chars":1715},{"level":2,"title":"PLATFORM UPDATE","slug":"platform-update","at":14001,"chars":536},{"level":2,"title":"Convert existing database to new platform","slug":"convert-existing-database-to-new-platform","at":14537,"chars":2004},{"level":2,"title":"Connect server instance to database","slug":"connect-server-instance-to-database","at":16541,"chars":706},{"level":2,"title":"Import Business Central partner license","slug":"import-business-central-partner-license","at":17247,"chars":538},{"level":2,"title":"Recompile published extensions","slug":"recompile-published-extensions","at":17785,"chars":841},{"level":2,"title":"Synchronize tenant","slug":"synchronize-tenant","at":18626,"chars":981},{"level":2,"title":"(Single-tenant only) Reinstall extensions","slug":"single-tenant-only-reinstall-extensions","at":19607,"chars":1556},{"level":2,"title":" APPLICATION UPDATE","slug":"application-update","at":21163,"chars":402},{"level":2,"title":"Upgrade System Application","slug":"upgrade-system-application","at":21565,"chars":1621},{"level":2,"title":"Upgrade Base Application","slug":"upgrade-base-application","at":23186,"chars":2446},{"level":3,"title":"Microsoft Base Application","slug":"microsoft-base-application","at":23214,"chars":1513},{"level":3,"title":"Upgrade custom Base Application","slug":"upgrade-custom-base-application","at":24727,"chars":905},{"level":2,"title":" Upgrade Microsoft extensions","slug":"upgrade-microsoft-extensions","at":25632,"chars":2450},{"level":3,"title":"Publish and install Microsoft_Application extension","slug":"publish-and-install-microsoft_application-extension","at":26291,"chars":1047},{"level":3,"title":"Publish and install Microsoft extensions","slug":"publish-and-install-microsoft-extensions","at":27338,"chars":744},{"level":2,"title":"Upgrade Third-Party extensions","slug":"upgrade-third-party-extensions","at":28082,"chars":517},{"level":2,"title":"Post Upgrade","slug":"post-upgrade","at":28599,"chars":10055},{"level":3,"title":"Upgrade control add-ins","slug":"upgrade-control-add-ins","at":28615,"chars":4068},{"level":3,"title":"Update application version","slug":"update-application-version","at":32683,"chars":3642},{"level":4,"title":"Change the application version in the database","slug":"change-the-application-version-in-the-database","at":33395,"chars":1734},{"level":4,"title":"Change the application version shown on the Help and Support page in the client","slug":"change-the-application-version-shown-on-the-help-and-support-page-in-the-client","at":35129,"chars":1196},{"level":3,"title":"Import the customer license","slug":"import-the-customer-license","at":36325,"chars":486},{"level":3,"title":"Upgrade other web server instances","slug":"upgrade-other-web-server-instances","at":36811,"chars":1843},{"level":2,"title":"Related information","slug":"related-information","at":38654,"chars":594}],"text":"# Installing a Business Central 2021 Release Wave 2 Update\nThis article describes how to install an update for Business Central on-premises. An update is a set of files that includes all hotfixes and regulatory features that have been released for Business Central.\nYou can choose to update only the platform or both the platform and application code. The installation guidelines are separated into PLATFORM tasks and APPLICATION tasks.\n## Overview\nThe following figure provides a high-level representation of a Business Central solution and the components that are involved in the installation of an update.\n![Business Central application stack.]\nThe databases store the application metadata and business data. If you have a single-tenant deployment, this data is stored in a single database. A multitenant deployment stores the application metadata in the application database and the business data in one or more tenant databases.\n### Application stack\nThe application includes AL extensions that define the objects and code that makes up the business logic. For example, objects include tables, report, pages, codeunits, and more. Each extension is compiled and delivered as an .app file, which is published to the Business Central Server instance.\n System Application extension\n  The Microsoft System Application extension includes functionality that isn't directly related the business logic. See ../developer/devenv-system-application-overview. When using the Microsoft Base Application, your solution uses the System Application. With a custom Base Application, your solution may or may not use the System Application. If it doesn't, you can skip any steps in this article related to the System Application.\n Base application extension\n  As a minimum, the solution always includes the Base Application. The Base Application contains the objects (such as table, pages, codeunits, and reports) that define the business logic and functionality of the solution. The Base Application can be either the Microsoft Base Application or a customized Base Application. The Microsoft Base Application is the standard application that is on the installation media (DVD). A customized Base Application is an application that includes customized code.\n Application extension\n  The Application extension logically encapsulates all of the extensions making up a solution, for example, version `19.0.0.0` of the base and system application package files, and it provides a convenient way to define and refer to this solution identity. This extension is required for Microsoft extensions, but is optional for third-party extensions. See The Microsoft_Application.app File<../developer/devenv-application-app-file>.\n Customization extensions\n  Customization extensions add functionality and features to the Base Application or System Application. Extensions can be either Microsoft extensions or third-party extensions. Microsoft extensions are available on the DVD. Third-party extensions are extensions developed by your organization or by another organization, like an ISV.\n### Single-tenant and multitenant deployments\nThe process for upgrading is similar for a single-tenant and multitenant deployment. However, there are some inherent differences. With a single-tenant deployment, the application code and business data are in the same database. In a multitenant deployment, application code is in a separate database (the application database) than the business data (tenant). In the procedures that follow, for a single-tenant deployment, consider references to the application database and tenant database as the same database. Steps are marked as Single-tenant only or Multitenant only where applicable.\n### Business Central server and web server instances\nThe steps in this article will delete the default Business Central Server and Business Central Web Server of the old version. The default instances are those instances that were created using the Business Central Setup (setup.exe) program. A new Business Central Server and Business Central Web Server instance that run on the new platform will be added to replace the old ones.\nYour current deployment, however, may using multiple Business Central Server or Business Central Web Server instances. If so, you might need to do some extra tasks at the end of the process for each instance:\n With Business Central Server instances, all extra instances, like the new default instance, will automatically use new platform assemblies and file installed by the setup program. The only task you might have to do on the extra instances is to modify some configuration file settings (.config).\n Extra Business Central Web Server instances aren't upgraded automatically. With these instances, you'll have to remove the old instances, then create new instances using the latest platform.\n### Platform versus application update\nA platform update doesn't change the application. It involves converting your databases to the new platform and recompiling the existing extensions to ensure that they're compatible with the new platform.\nAn application update involves:\n Publishing new versions of extensions that include the latest application modifications\n Synchronizing the databases with any schema change introduced by the new extensions\n Updating affected data.\nThe installation media (DVD) includes new versions of Microsoft's Base Application, System Application, and extensions. The DVD also includes the AL source code for the Microsoft Base Application. This code is useful if you have a custom base application. You can use the code to compare and merge updates into your application. You'll only have to recompile third-party extensions that you don't have a new version to publish.\n## PREPARATION\n## PowerShell variables used in tasks\nMany of the steps in this article use PowerShell cmdlets, which require that you provide values for various parameters. To make it easier for copying or scripting in PowerShell, the steps use the following variables for parameter values. Replace the text between the `\" \"` with the correct values for your environment.\n```powershell\n$BcServerInstance = \"The name of the Business Central server instance, for example: BC190\"\n$TenantId = \"The ID of the tenant to be upgraded. If not using a multitenant server instance, set the variable to default, or omit -Tenant parameter.\"\n$TenantDatabase = \"The name of the Business Central tenant database to be upgraded, for example: Demo Database BC (19-0)\"\n$ApplicationDatabase = \"The name of the Business Central application database in a multitenant environment, for example: My BC App DB.\"\n$DatabaseServer= \"The SQL Server instance that hosts the databases. The value has the format server_name\\instance_name, For example: localhost\\BCDEMO\"\n$BaseAppPath = \"The file path and name of the Base Application extension for the update, for example: C:\\DVD\\Applications\\BaseApp\\Source\\Microsoft_Base Application.app\"\n$SystemAppPath = \"The file path and name of the System Application extension for the update, for example: C:\\DVD\\Applications\\system application\\Source\\\\Microsoft_System Application.app\"\n$ApplicationAppPath = \"The path and file name to the Application application extension for the update, for example: C:\\DVD\\Applications\\Application\\Source\\Microsoft_Application.app\"\n$NewBcVersion = \"The version number for the update, for example: 19.1.24582.0\"\n$ExtPath = \"The path and file name to an extension package\"\n$ExtName = \"The name of an extension\"\n$ExtVersion = \"The version of an extension, for example, 1.0.0.0\"\n$AddinsFolder = \"The file path to the Add-ins folder of Business Central Server installation, for example: C:\\Program Files\\Microsoft Dynamics 365 Business Central\\190\\Service\\Add-ins\"\n$PartnerLicense= \"The file path and name of the partner license\"\n$CustomerLicense= \"The file path and name of the customer license\"\n```\n## Download update package\nThe first thing to do is to download the update package that matches your Business Central solution.\n1. Go to the list of available updates<../deployment/update-versions-19> for your on-premises version of Business Central. Then, choose the update that you want.\n2. From the update page, under the Resolution section, select the link for downloading the update, and follow the instructions.\n3. On the computer where you downloaded the update .zip file, extract the all the files to a selected location.\n When extracted, the update includes the DVD folder. This folder contains the full Business Central product. For example, the folder includes the Business Central installation program (setup.exe), tools for upgrading to the platform, and the Microsoft extensions.\nWhen this step is completed, you can continue to update your Business Central solution to the new platform and application.\n## Save copies of server configuration files\nIt's a good idea to save copies of the configuration files for the Business Central Server instance (CustomSettings.config) and Business Central Web Server instances (navsettings.json and web.config). Having copies will help you configure the components after upgrade to match the setup you had before upgrade.\n For the Business Central Server instance, the default location of the CustomSettings.config file is C:\\Program Files\\Microsoft Dynamics 365 Business Central\\NNN\\Service.\n For the Business Central Web Server instances, the navsettings.json file is in the physical path of the web server instance. By default, the path is *C:\\\\inetpub\\\\wwwroot\\\\[WebServerInstanceName]* on the computer's hard drive. *[WebServerInstanceName]* corresponds to the name (alias) of the web server instance in IIS, for example, C:\\inetpub\\\\wwwroot\\\\BCNNN. The web.config file that is located in the physical path of the web application for the Business Central Web client. The path is *rootdrive\\\\inetpub\\\\wwwroot\\\\\\[VirtualDirectoryName\\]\\*. For example, the folder for the default Business Central Web client application is C:\\\\inetpub\\\\wwwroot\\\\BCNNN\\\\.\n  BCNNN indicates the name of the Business Central Server instance chosen during setup.\n## Prepare existing databases\n1. Back up your databases.\n2. Run the Business Central Administration Shell as an administrator.\n3. (Single-tenant only) Uninstall all extensions from the all tenants.\n In this step, you uninstall the Base Application, System Application (if used), and any other extensions that are currently installed on the database.\n 1. Get a list of installed extensions.\n  This step is optional, but it can be useful to the names and versions of the extensions.\n  To get a list of installed extensions, use the Get-NAVAppInfo cmdlet<https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.apps.management/get-navappinfo>.\n  ```powershell\n  Get-NAVAppInfo -ServerInstance $BcServerInstance\n  ```\n 2. Uninstall the extensions.\n  To uninstall an extension, you use the https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.apps.management/uninstall-navapp cmdlet.\n  ```powershell\n  Uninstall-NAVApp -ServerInstance $BcServerInstance -Tenant $TenantId -Name <extensions name> -Version $ExtVersion -Force\n  ```\n  Replace `$ExtName` and `$ExtVersion` with the exact name and version the installed extension. For single-tenant deployment, set `$TenantId` to default or omit the `-Tenant` parameter.\n  For example, together with the Get-NAVApp cmdlet, you can uninstall all extensions with a single command:\n  ```powershell\n  Get-NAVAppInfo -ServerInstance $BcServerInstance -Tenant $TenantId | % { Uninstall-NAVApp -ServerInstance $BcServerInstance -Tenant $TenantId -Name $_.Name -Version $_.Version -Force}\n  ```\n4. Unpublish the existing system symbols.\n To unpublish the system symbols, use the Unpublish-NAVApp cmdlet<https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.apps.management/unpublish-navapp> as follows:\n ```powershell\n Unpublish-NAVApp -ServerInstance $BcServerInstance -Name System\n ```\n What are symbols?<upgrade-overview-v15#Symbols>.\n5. (Multitenant only) Dismount the tenants from the application database.\n To dismount a tenant, use the https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.management/dismount-navtenant cmdlet:\n ```powershell\n Dismount-NAVTenant -ServerInstance $BcServerInstance -Tenant $TenantId\n ```\n## Install Business Central components\nFrom the installation media (DVD), run setup.exe to uninstall the current Business Central components and install the Business Central components included in the update.\n1. Stop the Business Central Server instance.\n ```powershell\n Stop-NAVServerInstance -ServerInstance $BcServerInstance\n ```\n2. Run setup.exe to uninstall your current version of Business Central.\n3. Run setup.exe again to install components of the update.\n 1. Follow setup pages until you get to the Microsoft Dynamics 365 Business Central Setup page.\n 2. Select Advanced installation options > Choose an installation option > Custom.\n 3. On the Customize the installation page, select the following components as a minimum:\n   AL Development Environment (optional but recommended)\n   Server\n   Web Server Components.\n> NOTE\n> When install the Web Server Components, a Business Central Web Server instance with the same name that you define for the Business Central Server instance will be created on Internet Information Services (IIS). If you're existing deployment has multiple web server instances that you want to reuse, you'll have to upgrade these instances later in this article.\n4. Select Next.\n5. On the Specify parameters page, set the fields as needed.\n> IMPORTANT\n> Clear the SQL Database field so that it is blank. At this time, do not set this to the database that you want to update; otherwise, the installation of the Business Central Server will fail. You will connect the database to the Business Central Server later after it is converted to the new platform.\n6. Select Apply to complete the installation.\nSee Installing Business Central Using Setup<../deployment/install-using-setup>.\n## PLATFORM UPDATE\nFollow the next few tasks to convert your database to the new platform of the update. A multitenant deployment includes the application and tenant databases. Running the database conversion will:\n Update the system tables of the database to the new schema (data structure)\n Provide the latest platform features and performance enhancements\n Automatically publish the system symbols for the new platform\nAlso, to ensure that the existing published extensions work on the new platform, you'll recompile the extensions.\n## Convert existing database to new platform\n1. Run the Business Central Administration Shell as an administrator.\n See Run Business Central Administration Shell<../administration/administration-shell>.\n2. Run the Invoke-NAVApplicationDatabaseConversion cmdlet<https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.management/invoke-navapplicationdatabaseconversion> to start the database conversion to the new platform.\n ```powershell\n Invoke-NAVApplicationDatabaseConversion -DatabaseServer $DatabaseServer -DatabaseName $TenantDatabase|$ApplicationDatabase -Force\n ```\n For example, in a single tenant deployment:\n ```powershell\n Invoke-NAVApplicationDatabaseConversion -DatabaseServer $DatabaseServer -DatabaseName $TenantDatabase -Force\n ```\n In a multitenant deployment, run this cmdlet against the application database. For example:\n ```powershell\n Invoke-NAVApplicationDatabaseConversion -DatabaseServer $DatabaseServer -DatabaseName $ApplicationDatabase -Force\n ```\n When completed, a message like the following displays in the console:\n ```powershell\n DatabaseServer      : .\\BCDEMO\n DatabaseName        : Demo Database BC (19-0)\n DatabaseCredentials :\n DatabaseLocation    :\n Collation           :\n ```\n> NOTE\n> Depending on the update that you're installing, you might get a message similar to the following:\n> `Invoke-NAVApplicationDatabaseConversion : A technical upgrade of database <database name> on server '.\\<database instance>' cannot be run, because the database's application version 'NNNNNN' is greater than or equal to the platform version 'NNNNNN'`\n> This isn't an error. This message is recorded as a warning in the event log as well. This message indicates that the application database is already compatible with the new platform, which happens when the update does not make any schema changes to the system tables.\n> You'll see this message if you ran the cmdlet without the `-Force` parameter. Run the cmdlet again, but be sure to include `-Force` parameter.\n## Connect server instance to database\n1. (Multitenant only) Enable the server instance as a multitenant instance:\n ```powershell\n Set-NAVServerConfiguration -ServerInstance $BcServerInstance -KeyName Multitenant -KeyValue true\n ```\n2. Connect the server instance to connect to the database.\n ```powershell\n Set-NAVServerConfiguration -ServerInstance $BcServerInstance -KeyName DatabaseName -KeyValue $ApplicationDatabase\n ```\n In a multitenant deployment, the database is the application database. See Connecting a Server Instance to a Database<../administration/connect-server-to-database>.\n3. Restart the server instance.\n ```powershell\n Restart-NAVServerInstance -ServerInstance $BcServerInstance\n ```\n## Import Business Central partner license\nTo import the license, use the Import-NAVServerLicense cmdlet<https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.management/import-navserverlicense>. You'll have to restart the server instance afterwards:\n```powershell\nImport-NAVServerLicense -ServerInstance $BcServerInstance -LicenseFile $PartnerLicense\nRestart-NAVServerInstance -ServerInstance $BcServerInstance\n```\nSee Uploading a License File for a Specific Database<../cside/cside-upload-license-file#UploadtoDatabase>.\n## Recompile published extensions\nCompile all published extensions against the new platform.\n> NOTE\n> If you plan on updating the application, you can skip this step for extensions for which you have new versions built on the new platform. For example, this includes Microsoft extensions that are on the DVD.\n1. To compile an extension, use the https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.apps.management/repair-navapp cmdlet, For example:\n ```powershell\n Repair-NAVApp -ServerInstance $BcServerInstance -Name $ExtName -Version $ExtVersion\n ```\n To compile all published extensions at once, you can use this command:\n ```powershell\n Get-NAVAppInfo -ServerInstance $BcServerInstance | Repair-NAVApp\n ```\n2. Restart the server instance.\n ```powershell\n Restart-NAVServerInstance -ServerInstance $BcServerInstance\n ```\n## Synchronize tenant\n1. (Multitenant only) Mount the tenant to the new Business Central Server instance.\n You'll have to do this step and the next for each tenant. See ../administration/mount-dismount-tenant.\n ```powershell\n Mount-NAVTenant -ServerInstance $BCServerInstanceName -DatabaseName $TenantDatabase -Tenant $TenantId\n ```\n2. Synchronize the tenant.\n Use the https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.management/sync-navtenant cmdlet:\n ```powershell\n Sync-NAVTenant -ServerInstance $BcServerInstance -Tenant $TenantId -Mode Sync\n ```\n For a single-tenant deployment, you can either set the `$TenantId` to default or omit the `-Tenant $TenantId` parameter. For more information about syncing, see Synchronizing the Tenant Database and Application Database<../administration/synchronize-tenant-database-and-application-database>.\n> NOTE\n> At this point, if you want to update the application, you can skip the next step and proceed #Application.\n## (Single-tenant only) Reinstall extensions\nIn this task, you reinstall the same extensions that were installed on the tenant before. If you're planning on updating the application, then skip this step.\nTo install an extension, you use the Install-NAVApp cmdlet<https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.apps.management/install-navapp>.\n1. If your solution uses the System Application, install this first.\n ```powershell\n Install-NAVApp -ServerInstance $BcServerInstance -Name \"System Application\" -Version $ExtVersion\n ```\n Replace `$ExtVersion` with the exact version of the published System Application.\n2. Install the Base Application.\n ```powershell\n Install-NAVApp -ServerInstance $BcServerInstance -Name \"Base Application\" -Version $ExtVersion\n ```\n Replace `$ExtVersion` with the exact version of the published Base Application.\n3. Install the Application extension as needed.\n ```powershell\n Install-NAVApp -ServerInstance $BcServerInstance -Name \"Application\" -Version $ExtVersion\n ```\n Replace `$ExtVersion` with the exact version of the published Application extension.\n4. Install other extensions, including Microsoft and third-party extensions.\n ```powershell\n Install-NAVApp -ServerInstance $BcServerInstance -Name $ExtName -Version $ExtVersion\n ```\nAt this point, your solution has been updated to the latest platform.\n> IMPORTANT\n> If your solution uses any Microsoft control add-ins, you must upgrade the add-ins to the latest version. Go to Upgrade control add-ins<#controladdins> under Post Upgrade section.\n##  APPLICATION UPDATE\nFollow the next tasks to update the application code to the new features and hotfixes. The tasks include publishing new versions of the System Application, Base Application, and add-on extensions.\nYou publish the System Application extension only if it was used in old solution. Add-on extensions include Microsoft and third- party extensions that were used in the old solution.\n## Upgrade System Application\nFollow these steps if your existing solution uses the Microsoft System Application. Otherwise, you can skip this procedure.\n1. Publish the System Application extension (Microsoft_System Application.app).\n You find the (Microsoft_System Application.app in the Applications\\System Application\\Source folder of installation media (DVD).\n ```powershell\n Publish-NAVApp -ServerInstance $BcServerInstance -Path \"<path to Microsoft_System Application.app>\"\n ```\n2. Synchronize the tenant(s) with the System Application extension (Microsoft_System Application):\n Use the https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.apps.management/sync-navapp cmdlet:\n ```powershell\n Sync-NAVApp -ServerInstance $BcServerInstance -Tenant $TenantId -Name \"System Application\" -Version $NewBcVersion\n ```\n Replace `$NewBcVersion` with the exact version of the published System Application.\n> TIP\n> To get a list of all published extensions, along with their names and versions, use the Get-NAVAppInfo cmdlet<https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.apps.management/get-navappinfo>.\n3. Run the data upgrade on the System Application.\n To run the data upgrade, use the https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.apps.management/start-navappdataupgrade cmdlet:\n ```powershell\n Start-NAVAppDataUpgrade -ServerInstance $BcServerInstance -Tenant $TenantId -Name \"System Application\" -Version $NewBcVersion\n ```\n Upgrading data updates the data in the tables of the tenant database to the schema changes made to tables of the System Application.\n## Upgrade Base Application\n### Microsoft Base Application\nFollow these steps if your existing solution uses the Microsoft Base Application.\n1. Publish the Business Central Base Application extension (Microsoft_Base Application.app).\n The Base Application extension contains the application business objects. You find the Microsoft_Base Application.app in the Applications\\BaseApp\\Source folder of installation media (DVD).\n ```powershell\n Publish-NAVApp -ServerInstance $BcServerInstance -Path \"<path to Microsoft_Base Application.app>\"\n ```\n2. Synchronize the tenant with the Business Central Base Application extension (Microsoft_BaseApp):\n ```powershell\n Sync-NAVApp -ServerInstance $BcServerInstance -Tenant $TenantId -Name \"Base Application\" -Version $NewBcVersion\n ```\n Replace `$NewBcVersion` with the exact version of the published Base Application.\n With this step, the base app takes ownership of the database tables. When completed, in SQL Server, the table names will be suffixed with the base app extension ID. This process can take several minutes.\n3. Run the data upgrade on the Base Application.\n To run the data upgrade, use the https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.apps.management/start-navappdataupgrade cmdlet:\n ```powershell\n Start-NAVAppDataUpgrade -ServerInstance $BcServerInstance -Tenant $TenantId -Name \"Base Application\" -Version $NewBcVersion\n ```\n Upgrading data updates the data in the tables of the tenant database to the schema changes made to tables of the Base Application.\n### Upgrade custom Base Application\nWith a custom Base Application, you may want the new application features and hotfixes in the Microsoft Base Application. If so, you'll have to merge the modifications made in the Microsoft Base Application into your custom Base Application. Then, create a new version of your custom Base Application.\nThe source code for the new Microsoft Base Application version is in the Base Application.Source.zip file. This file is on the installation media (DVD), in the Applications\\BaseApp\\Source folder. You can compare this source code with the source code of the previous Microsoft Base Application and your custom application source. Then merge the code into a new custom application version.\nAfter you've created the new version of your custom application, you publish it to the application server instance. Then, you synchronize and run the data upgrade on the tenants.\n##  Upgrade Microsoft extensions\nIf your old solution used Microsoft extensions, then you upgrade these extensions to the new versions that are available on the Business Central installation media (DVD). The new versions are in the Applications folder, which contains a subfolder for each extension. The extension package (.app file) that you need for publishing the extension is in the Source folder, for example, Applications\\SalesAndInventoryForecast\\Source\\SalesAndInventoryForecast.app.\nThe general steps for this task are listed below. For detailed steps, see Publishing, Upgrading, and Installing Extensions During Upgrade<upgrade-publish-extensions>.\n### Publish and install Microsoft_Application extension\nThe Microsoft_Application extension was introduced in 15.3. In short, it's used to contain the dependency declarations on the system and base application extensions. For more information about this extension, see The Microsoft_Application.app File<../developer/devenv-application-app-file>.\n1. Publish the Microsoft_Application.app package.\n The installation media path to the extension package (.app file) is Applications\\Application\\Source\\Microsoft_Application.app\"\n ```powershell\n Publish-NAVApp -ServerInstance $BcServerInstance -Path \"<folder path>\\Microsoft_Application.app\"\n ```\n2. Synchronize the tenant database with the schema changes of the Microsoft_Application extension.\n ```powershell\n Sync-NavApp -ServerInstance $BcServerInstance -Tenant $TenantId -Name Application -Version $NewBcVersion\n ```\n3. Upgrade the Microsoft_Application extension on your tenants.\n ```powershell\n Start-NAVAppDataUpgrade -ServerInstance $BcServerInstance -Tenant $TenantId -Name Application\n ```\n### Publish and install Microsoft extensions\nComplete these steps for each Microsoft extension that you want to upgrade.\n1. Publish the new extension versions from the installation media (DVD).\n ```powershell\n Publish-NAVApp -ServerInstance $BcServerInstance -Path $ExtPath\n ```\n2. Synchronize the tenant database with the schema changes of the extensions.\n ```powershell\n Sync-NavApp -ServerInstance $BcServerInstance -Tenant $TenantId -Name $ExtName -Version $NewBcVersion\n ```\n3. Upgrade the data associated with the Microsoft extensions. This step will automatically install the new version on the tenant\n ```powershell\n Start-NAVAppDataUpgrade -ServerInstance $BcServerInstance -Tenant $TenantId -Name $ExtName -Version $NewBcVersion\n ```\n## Upgrade Third-Party extensions\nIf the old solution used third-party extensions, and you still want to use them, they must be compiled to work on the new platform. See Recompile published extensions<#repair>. You then reinstall the extensions on tenants using the Install-NAVApp cmdlet.\nAs an alternative, if you have the source for these extensions, you can build and compile a new version of the extension in the AL development environment. Then, you upgrade to the new version as described in the previous task.\n## Post Upgrade\n### Upgrade control add-ins\nThe Business Central Server installation includes new versions of the Microsoft-provided Javascript-based control add-ins, like Microsoft.Dynamics.Nav.Client.BusinessChart, Microsoft.Dynamics.Nav.Client.VideoPlayer, and more. If your solution uses any of these control add-ins, upgrade them to the latest version.\nTo upgrade the control add-ins from the client, do the following steps:\n1. Open the Business Central client.\n1. Search for and open the Control Add-ins page.\n1. Choose Actions > Control Add-in Resource > Import.\n1. Locate and select the .zip file for the control add-in and choose Open.\n The .zip files are located in the Add-ins folder of the Business Central Server installation. There's a subfolder for each add-in. For example, the default path to the Business Chart control add-in is `C:\\Program Files\\Microsoft Dynamics 365 Business Central\\NNN\\Service\\Add-ins\\BusinessChart\\Microsoft.Dynamics.Nav.Client.BusinessChart.zip`, where NNN represents the Business Central release version such as 240 and 250.\n1. After you've imported all the new control add-in versions, restart Business Central Server instance.\nAlternatively, you can use the Set-NAVAddin cmdlet<https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.management/set-navaddin> of the Business Central Administration Shell. For example, the following commands update the control add-ins installed by default. Modify the commands to suit:\n```powershell\nSet-NAVAddIn -ServerInstance $NewBcServerInstance -AddinName 'Microsoft.Dynamics.Nav.Client.BusinessChart' -PublicKeyToken 31bf3856ad364e35 -ResourceFile ($AppName = Join-Path $AddinsFolder 'BusinessChart\\Microsoft.Dynamics.Nav.Client.BusinessChart.zip')\nSet-NAVAddIn -ServerInstance $NewBcServerInstance -AddinName 'Microsoft.Dynamics.Nav.Client.FlowIntegration' -PublicKeyToken 31bf3856ad364e35 -ResourceFile ($AppName = Join-Path $AddinsFolder 'FlowIntegration\\Microsoft.Dynamics.Nav.Client.FlowIntegration.zip')\nSet-NAVAddIn -ServerInstance $NewBcServerInstance -AddinName 'Microsoft.Dynamics.Nav.Client.OAuthIntegration' -PublicKeyToken 31bf3856ad364e35 -ResourceFile ($AppName = Join-Path $AddinsFolder 'OAuthIntegration\\Microsoft.Dynamics.Nav.Client.OAuthIntegration.zip')\nSet-NAVAddIn -ServerInstance $NewBcServerInstance -AddinName 'Microsoft.Dynamics.Nav.Client.PageReady' -PublicKeyToken 31bf3856ad364e35 -ResourceFile ($AppName = Join-Path $AddinsFolder 'PageReady\\Microsoft.Dynamics.Nav.Client.PageReady.zip')\nSet-NAVAddIn -ServerInstance $NewBcServerInstance -AddinName 'Microsoft.Dynamics.Nav.Client.PowerBIManagement' -PublicKeyToken 31bf3856ad364e35 -ResourceFile ($AppName = Join-Path $AddinsFolder 'PowerBIManagement\\Microsoft.Dynamics.Nav.Client.PowerBIManagement.zip')\nSet-NAVAddIn -ServerInstance $NewBcServerInstance -AddinName 'Microsoft.Dynamics.Nav.Client.RoleCenterSelector' -PublicKeyToken 31bf3856ad364e35 -ResourceFile ($AppName = Join-Path $AddinsFolder 'RoleCenterSelector\\Microsoft.Dynamics.Nav.Client.RoleCenterSelector.zip')\nSet-NAVAddIn -ServerInstance $NewBcServerInstance -AddinName 'Microsoft.Dynamics.Nav.Client.SatisfactionSurvey' -PublicKeyToken 31bf3856ad364e35 -ResourceFile ($AppName = Join-Path $AddinsFolder 'SatisfactionSurvey\\Microsoft.Dynamics.Nav.Client.SatisfactionSurvey.zip')\nSet-NAVAddIn -ServerInstance $NewBcServerInstance -AddinName 'Microsoft.Dynamics.Nav.Client.VideoPlayer' -PublicKeyToken 31bf3856ad364e35 -ResourceFile ($AppName = Join-Path $AddinsFolder 'VideoPlayer\\Microsoft.Dynamics.Nav.Client.VideoPlayer.zip')\nSet-NAVAddIn -ServerInstance $NewBcServerInstance -AddinName 'Microsoft.Dynamics.Nav.Client.WebPageViewer' -PublicKeyToken 31bf3856ad364e35 -ResourceFile ($AppName = Join-Path $AddinsFolder 'WebPageViewer\\Microsoft.Dynamics.Nav.Client.WebPageViewer.zip')\nSet-NAVAddIn -ServerInstance $NewBcServerInstance -AddinName 'Microsoft.Dynamics.Nav.Client.WelcomeWizard' -PublicKeyToken 31bf3856ad364e35 -ResourceFile ($AppName = Join-Path $AddinsFolder 'WelcomeWizard\\Microsoft.Dynamics.Nav.Client.WelcomeWizard.zip')\n```\n### Update application version\nAfter you upgrade your application, we recommend changing the value of application build number that's stored in the database and shown on the Help and Support page to match the new current version. This version isn't updated automatically when you upgrade. If you want the version to reflect the version of the update or your own version, you change it manually. This task serves two purposes. It ensures that personalization works as expected after upgrade. It's also useful for support purposes and answering a common question about the application version.\nFor more information about version numbers, see Version numbers in Business Central<../administration/version-numbers>.\n#### Change the application version in the database\n1. Run the Set-NAVApplication cmdlet<https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.management/set-navapplication>:\n ```powershell\n Set-NAVApplication -ServerInstance $NewBcServerInstance -ApplicationVersion $NewBCVersion -Force\n ```\n For example:\n ```powershell\n Set-NAVApplication -ServerInstance BC260 -ApplicationVersion 26.0.38071.0 -Force\n ```\n2. Run the https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.management/sync-navtenant cmdlet to synchronize the tenant with the application database.\n ```powershell\n Sync-NAVTenant -ServerInstance $NewBcServerInstance -Mode Sync -Tenant $TenantId\n ```\n With a single-tenant deployment, you can omit the `-Tenant` parameter and value.\n3. Run the https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.management/start-navdataupgrade cmdlet to change the version number:\n ```powershell\n Start-NAVDataUpgrade -ServerInstance $NewBcServerInstance -FunctionExecutionMode Serial -Tenant $TenantId\n ```\n The data upgrade process will be running in the background after running the above Start-NAVDataUpgrade cmdlet. You check on the progress using the Get-NAVDataUpgrade cmdlet: such as: `Get-NAVDataUpgrade -ServerInstance $NewBcServerInstance -Tenant $TenantId -Progress` or `Get-NAVDataUpgrade -ServerInstance $NewBcServerInstance -Tenant $TenantId -Detailed`.\nDon't stop the Business Central Server instance until the process is complete, that is, when you see `State = Completed` in the results from the Get-NAVDataUpgrade cmdlet. Also, you can't do operations like installing extensions until the state is operational. It can take several minutes before the process completes.\n#### Change the application version shown on the Help and Support page in the client\nThe Business Central Server includes a configuration setting called Solution Version Extension (SolutionVersionExtension). This setting lets you specify an extension whose version number will show as the Application Version on the client's Help and Support page. Typically, you'd use the extension considered to be your solution's base application. You set Solution Version Extension to ID of the extension. For example, if your solution uses the Microsoft Base Application, set the value to `437dbf0e-84ff-417a-965d-ed2bb9650972`.\nYou can set Solution Version Extension by using the Business Central Server Administration tool or the https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.management/set-navserverconfiguration cmdlet of the Business Central Administration Shell.\nThe following example uses the Set-NAVServerConfiguration cmdlet to set the Solution Version Extension to the Microsoft Base Application:\n```powershell\nSet-NAVServerConfiguration -ServerInstance $NewBcServerInstance -KeyName SolutionVersionExtension -KeyValue \"437dbf0e-84ff-417a-965d-ed2bb9650972\" -ApplyTo All\n```\n### Import the customer license\nImport the customer license by using the Import-NAVServerLicense cmdlet<https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.management/import-navserverlicense>, as you did with the partner license. You'll have to restart the server instance afterwards.\n```powershell\nImport-NAVServerLicense -ServerInstance $BcServerInstance -LicenseFile $CustomerLicense\n```\n```powershell\nRestart-NAVServerInstance -ServerInstance $BcServerInstance\n```\n### Upgrade other web server instances\nAt this point, the only Business Central Web Server instance that's been upgraded to the new version is the one you installed earlier using the setup.exe file. If you had multiple web server instances running on the old version that you still want multiple instances, complete the following steps:\n1. Save a copy of the navsettings.json and web.config file.\n2. Run the https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.management/remove-navwebserverinstance cmdlet to delete the instance. For example:\n ```powershell\n Remove-NAVWebServerInstance -WebServerInstance MyWebServerInstance\n ```\n Replace MyWebServerInstancewith the name of the instance you want to remove.\n3. Run the https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.management/new-navwebserverinstance cmdlet to create a new instance.\n For example, the following command creates a subsite instance named MyWebServerInstance under the default container Microsoft Dynamics 365 Business Central Web Client on port 8081.\n ```powershell\n New-NAVWebServerInstance -WebServerInstance MyWebServerInstance -Server localhost -ServerInstance $BcServerInstance -SiteDeploymentType SubSite -ContainerSiteName \"Microsoft Dynamics 365 Business Central Web Client\" -WebSitePort 8081 -PublishFolder \"C:\\Program Files\\Microsoft Dynamics 365 Business Central\\BCNNN\\Web Client\"\n ```\n The `-PublishFolder` parameter specifies the path to the Business Central Web Server components for the version. If you're working on a computer where the Business Central Web Server components are installed, you don't have to set the `-PublishFolder` parameter.\nFor more information about multiple web server instances, see Setting Up Multiple Business Central Web Server Instances<../deployment/configure-multiple-web-server-instances>.\n## Related information\nDynamics 365 Business Central On-Premises Release Wave 2 Updates<../deployment/update-versions-17>\nUpgrading to Dynamics 365 Business Central 2019 Release Wave 2<upgrade-overview-v15>\nSynchronizing the Tenant Database and Application Database<../administration/synchronize-tenant-database-and-application-database>\nVersion numbers in Business Central<../administration/version-numbers>\n../developer/devenv-how-publish-and-install-an-extension-v2\nGetting Started in AL<../developer/devenv-get-started>\nVersion numbers in Business Central<../administration/version-numbers>"}