{"title":"Upgrading unmodified C/AL application to version 19","url":"https://jonas-paprotka.de/docs/dev-itpro/upgrade/upgrade-unmodified-application-v14-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/upgrade-unmodified-application-v14-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/upgrade-unmodified-application-v14-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":"Describes how to upgrade an unmodified Business Central 14 application to version 19","date":"2024-04-18","meta":{"topic":"how-to"},"outline":[{"level":1,"title":"Upgrading unmodified C/AL application to version 19","slug":"upgrading-unmodified-cal-application-to-version-19","at":0,"chars":38649},{"level":2,"title":"General information","slug":"general-information","at":583,"chars":1369},{"level":3,"title":"Single-tenant and multitenant deployments","slug":"single-tenant-and-multitenant-deployments","at":606,"chars":637},{"level":3,"title":"Personalization and customizations","slug":"personalization-and-customizations","at":1243,"chars":709},{"level":2,"title":"PowerShell variables used in tasks","slug":"powershell-variables-used-in-tasks","at":1952,"chars":2232},{"level":2,"title":"Prerequisite","slug":"prerequisite","at":4184,"chars":781},{"level":2,"title":"Task 1: Install version 19","slug":"task-1-install-version-19","at":4965,"chars":1368},{"level":2,"title":"Task 2: Upgrade permission sets","slug":"task-2-upgrade-permission-sets","at":6333,"chars":524},{"level":2,"title":"Task 3: Prepare version 14 databases","slug":"task-3-prepare-version-14-databases","at":6857,"chars":3570},{"level":2,"title":"Task 4: Convert the application database to version 19","slug":"task-4-convert-the-application-database-to-version-19","at":10427,"chars":1848},{"level":2,"title":"Task 5: Configure version 19 server for DestinationAppsForMigration","slug":"task-5-configure-version-19-server-for-destinationappsformigration","at":12275,"chars":2532},{"level":2,"title":"Task 6: Import version 19 license","slug":"task-6-import-version-19-license","at":14807,"chars":652},{"level":2,"title":"Task 7: Publish extensions","slug":"task-7-publish-extensions","at":15459,"chars":3521},{"level":2,"title":"Task 8: Restart server instance","slug":"task-8-restart-server-instance","at":18980,"chars":294},{"level":2,"title":"Task 9: Synchronize tenant","slug":"task-9-synchronize-tenant","at":19274,"chars":3622},{"level":2,"title":"Task 10: Upgrade data","slug":"task-10-upgrade-data","at":22896,"chars":2402},{"level":2,"title":"Task 11: Install 3rd-party extensions","slug":"task-11-install-3rd-party-extensions","at":25298,"chars":13351}],"text":"# Upgrading unmodified C/AL application to version 19\nUse this scenario if you have a Business Central Spring 2019 (version 14) application or earlier that doesn't include any code customization. Your solution might include Microsoft (first party) extensions and customization extensions (3rd-party). With this upgrade, you replace the C/AL base application with the new Microsoft System and Base Application extensions. The result is a fully upgraded Business Central 2021 release wave 2 (version 19) application and platform.\n![Upgrade on unmodified Business Central application.]\n## General information\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### Personalization and customizations\nSince version 14, the way user profiles are defined, stored, and customized has undergone a major overhaul. This change means user personalization and profile customizations that were done in the Windows Client are lost after upgrade. The legacy profiles remain available but their associated profile configurations are discarded. Page customizations must be either recreated using the latest Business Central client or as an AL extension. For more information about personalization, customization, and Al profiles, see:\n Customize Pages for Profiles</ui-personalization-manage>\n Personalize Your Workspace</ui-personalization-user>\n ../developer/devenv-design-profiles\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$OldBcServerInstance = \"The name of the Business Central server instance for your previous version, for example: BC140\"\n$NewBcServerInstance = \"The name of the Business Central server instance for version 19, 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. In a single-tenant deployment, this is the same as the $TenantDatabase\"\n$DatabaseServer = \"The SQL Server instance that hosts the databases. The value has the format server_name\\instance_name, For example: localhost\\BCDEMO\"\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$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$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 current System, Base, and Application extensions that you'll reinstall, for example: 19.1.24582.0\"\n$PartnerLicense = \"The file path and name of the partner license\"\n$CustomerLicense = \"The file path and name of the customer license\"\n$AddinsFolder = \"The file path to the Add-ins folder of version 19 server installation, for example, C:\\Program Files\\Microsoft Dynamics 365 Business Central\\190\\Service\\Add-ins.\"\n\n```\n## Prerequisite\n Upgrade to Business Central Spring 2019 (version 14).\n   If your solution is already on version 14, then no action on this step is required.\n   If you're upgrading from Business Central Fall 2018 (version 13) or Dynamics NAV, we recommend you upgrade to the latest update for version 14 that has a compatible update for version 19. See Dynamics 365 Business Central Upgrade Compatibility Matrix<upgrade-v14-v15-compatibility>.\n  To download the latest update, go to Released Cumulative Updates for Microsoft Dynamics 365 Business Central Spring 2019 Update on-premises<https://support.microsoft.com/help/4501292>.\n  For information about how to do the upgrade, see Upgrading to Dynamics 365 Business Central On-Premises<upgrading-to-business-central-on-premises>.\n## Task 1: Install version 19\n1. Download the latest available update for version 19 that is compatible with your version 14.\n To download the latest update, go to Released Updates for Microsoft Dynamics 365 Business Central 2021 Release Wave 2 on-premises<https://support.microsoft.com/topic/released-updates-for-microsoft-dynamics-365-business-central-2021-release-wave-2-0d9263bf-e474-41c1-ae41-d98de5cd6e84>.\n The guidelines in this article assume that you're running the latest available update.\n2. Before you install version 19, it can be useful to create desktop shortcuts to the version 14.0 tools, such as the Business Central Server Administration tool, Business Central Administration Shell, and Dynamics NAV Development Shell because the Start menu items for these tools will be replaced with the version 19 tools.\n3. Install Business Central version 19 components.\n You have to keep version 14 installed to complete some steps in the upgrade process. When you install version 19, you must either specify different port numbers for components (like the Business Central Server instance and web services) or stop the version 14.0 Business Central Server instance before you run the installation. Otherwise, you get an error that the Business Central Server failed to install.\n See Installing Business Central Using Setup<../deployment/install-using-setup>.\n## Task 2: Upgrade permission sets\nVersion 18 introduced the capability to define permissions sets as AL objects, instead of as data. Permissions sets as AL objects is now the default and recommended model for permissions. For now, you can choose to use the legacy model, where permissions are defined and stored as data in the database. Whichever model you choose, there are permission set-related tasks you have to go through before and during upgrade.\nSee Upgrading Permissions Sets and Permissions<upgrade-permissions>.\n## Task 3: Prepare version 14 databases\n1. Make backup of the databases.\n2. Disable data encryption.\n If the current server instance uses data encryption, disable it. You can enable it again after upgrading.\n See Managing Encryption and Encryption Keys<how-to-export-and-import-encryption-keys#encryption>.\n Instead of disabling encryption, you can export the current encryption key, which you'll then import after upgrade. However, we recommend disabling encryption before upgrading.\n3. Start Business Central Administration Shell for version 14 as an administrator.\n See Run Business Central Administration Shell<../administration/administration-shell>.\n4. Uninstall all extensions from the old tenants.\n In this step, you uninstall any 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 $OldBcServerInstance -Tenant $TenantId\n  ```\n  For a single-tenant deployment, set the `<tenant ID>` to default.\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 $OldBcServerInstance -Name <extensions name> -Tenant <tenant ID> -Version <extension version> -Force\n  ```\n  Replace `<extension name>` and `<extension version>` with the exact name and version the published System Application.\n  For example, together with the Get-NAVApp cmdlet, you can uninstall all extensions with a single command:\n  ```powershell\n  Get-NAVAppInfo -ServerInstance $OldBcServerInstance -Tenant $TenantId| % { Uninstall-NAVApp -ServerInstance $OldBcServerInstance -Tenant $TenantId -Name $_.Name -Version $_.Version -Force}\n  ```\n5. Unpublish all extensions from the application server instance.\n To unpublish an extension, use the Unpublish-NAVApp cmdlet<https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.apps.management/unpublish-navapp>:\n ```powershell\n Unpublish-NAVApp -ServerInstance $OldBcServerInstance -Name <extension name> -Version <extension version>\n ```\n Together with the Get-NAVAppInfo cmdlet<https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.apps.management/get-navappinfo>, you can unpublish all extensions by using a single command:\n ```powershell\n Get-NAVAppInfo -ServerInstance $OldBcServerInstance | % { Unpublish-NAVApp -ServerInstance $OldBcServerInstance -Name $_.Name -Version $_.Version }\n ```\n6. Unpublish all system, test, and application symbols.\n To unpublish symbols, use the Unpublish-NAVAPP cmdlet with the `-SymbolsOnly` switch.\n ```powershell\n Get-NAVAppInfo -ServerInstance $OldBcServerInstance -SymbolsOnly | % { Unpublish-NAVApp -ServerInstance $OldBcServerInstance -Name $_.Name -Version $_.Version }\n ```\n What are symbols?<upgrade-overview-v15#Symbols>\n7. (Multitenant only) Dismount the tenants from the application server instance.\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 $OldBcServerInstance -Tenant $TenantId\n ```\n8. Stop the server instance.\n ```powershell\n Stop-NAVServerInstance -ServerInstance $OldBcServerInstance\n ```\n## Task 4: Convert the application database to version 19\nThis task runs a technical upgrade on the application database to convert it from the version 14 platform to the version 19 platform. The conversion updates the system tables of the database to the new schema (data structure). It provides the latest platform features and performance enhancements. The conversion adds the system symbols for the version to the database, so you don't have to manually publish the system's extension, as you had to do with early releases.\n1. If the database is on Azure SQL Database, you may get add your user account to the dbmanager database role on the master database.\n This membership is only required for converting the database, and can be removed afterwards. This step isn't required for Azure SQL Managed Instance.\n2. Start Business Central Administration Shell for version 19 as an administrator.\n3. Run the Invoke-NAVApplicationDatabaseConversion cmdlet to start the conversion:\n ```powershell\n Invoke-NAVApplicationDatabaseConversion -DatabaseServer $DatabaseServer -DatabaseName $ApplicationDatabase\n ```\n When completed, a message like the following displays in the console:\n ```powershell\n DatabaseServer      : .\\BCDEMO\n DatabaseName        : Demo Database BC (14-0)\n DatabaseCredentials :\n DatabaseLocation    :\n Collation           :\n ```\n> NOTE\n> When the database is on Azure SQL Database, you may get the following error:\n> `SQL Server: Execution Timeout Expired. The timeout period elapsed prior to completion of the operation or the server is not responding. The statement has been terminated.`\n> If you do, scale up the database resources in Azure SQL, then run the Invoke-NAVApplicationDatabaseConversion cmdlet again. If the conversion is successful, you can then scale it back down to its original setting and continue the upgrade.\n## Task 5: Configure version 19 server for DestinationAppsForMigration\nWhen you installed version 19 in Task 1, a version 19 Business Central Server instance was created. In this task, you change server configuration settings that are required to complete the upgrade. Some of the changes are only required for version 14 to version 19.0 upgrade and can be reverted after you complete the upgrade.\n1. Set the server instance to connect to the application database.\n ```powershell\n Set-NAVServerConfiguration -ServerInstance $NewBcServerInstance -KeyName DatabaseName -KeyValue $ApplicationDatabase\n ```\n In a single tenant deployment, this command mounts the tenant automatically. See Connecting a Server Instance to a Database<../administration/connect-server-to-database>.\n2. Configure the server instance for migrate extensions to the use the new base application and system application extensions.\n ```powershell\n Set-NAVServerConfiguration -ServerInstance $NewBcServerInstance -KeyName \"DestinationAppsForMigration\" -KeyValue '[{\"appId\":\"63ca2fa4-4f03-4f2b-a480-172fef340d3f\", \"name\":\"System Application\", \"publisher\": \"Microsoft\"},{\"appId\":\"437dbf0e-84ff-417a-965d-ed2bb9650972\", \"name\":\"Base Application\", \"publisher\": \"Microsoft\"}]'\n ```\n This setting serves the following purposes:\n  When you run the data upgrade on a tenant, the server runs the data upgrade for the base and system application extensions. The base and system applications are automatically installed on the tenant also.\n  Lets you republish extensions that haven't been built on version 19. The extensions typically include the third-party extensions that were used in your version 14. When you publish the extensions, the extension manifests are automatically modified with a dependency on the base and system applications.\n For more information about this setting, see upgrade-destinationappsformigration.\n3. If you want to use the permission sets defined as data, set the UserPermissionSetsFromExtensions setting to false.\n ```powershell\n Set-NavServerConfiguration -ServerInstance $NewBcServerInstance -KeyName \"UsePermissionSetsFromExtensions\" -KeyValue false\n ```\n4. Disable task scheduler on the server instance for purposes of upgrade.\n ```powershell\n Set-NavServerConfiguration -ServerInstance $NewBcServerInstance -KeyName \"EnableTaskScheduler\" -KeyValue false\n ```\n Be sure to re-enable task scheduler after upgrade if needed.\n5. Restart the server instance.\n ```powershell\n Restart-NAVServerInstance -ServerInstance $NewBcServerInstance\n ```\n## Task 6: Import version 19 license\nIf you've gotten a new Business Central partner license, make sure that it has been uploaded to the database.\n1. To upload the license, use the Import-NAVServerLicense cmdlet<https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.management/import-navserverlicense>:\n ```powershell\n Import-NAVServerLicense -ServerInstance $NewBcServerInstance -LicenseFile $PartnerLicense\n ```\n2. Restart the server instance.\n ```powershell\n Restart-NAVServerInstance -ServerInstance $NewBcServerInstance\n ```\nSee Uploading a License File for a Specific Database<../cside/cside-upload-license-file#UploadtoDatabase>.\n## Task 7: Publish extensions\nIn this task, you'll publish the extensions. As minimum, you publish the new base application and system application extensions from the installation media (DVD). You also publish new versions of any Microsoft extensions and third-party extensions that were used on your old deployment.\nPublishing an extension adds the extension to the application database that is mounted on the server instance. Once published, it's available for installing on tenants. This task updates internal tables, compiles the components of the extension behind-the-scenes, and builds the necessary metadata objects that are used at runtime.\nThe steps in this task continue to use the Business Central Administration Shell for version 19 that you started in the previous task.\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 $NewBcServerInstance -Path $SystemAppPath\n ```\n What is the System Application?<upgrade-overview-v15#SystemApplication>\n2. 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 $NewBcServerInstance -Path $BaseAppPath\n ```\n3. Publish the Microsoft_Application extension\n The Microsoft_Application extension is a new extension introduced in 15.3. For more information about this extension, see The Microsoft_Application.app File<../developer/devenv-application-app-file>.\n ```powershell\n Publish-NAVApp -ServerInstance $NewBcServerInstance -Path $ApplicationAppPath\n ```\n4. Publish the new versions of Microsoft extensions.\n In this step, you publish new versions of Microsoft extensions that were used on your version 14 deployment. You find the extensions in the Applications folder of the installation media (DVD).\n ```powershell\n Publish-NAVApp -ServerInstance $NewBcServerInstance -Path \"<path to Microsoft extension>\"\n ```\n For example:\n ```powershell\n Publish-NAVApp -ServerInstance $NewBcServerInstance -Path \"C:\\W1DVD\\Applications\\SalesAndInventoryForecast\\Source\\SalesAndInventoryForecast.app\"\n ```\n> NOTE\n> If you are upgrading from an India (IN) version of Dynamics NAV 2016, you must publish the following extensions to get the local functionality. The below extensions available in the DVD under the Application folder in DVD.\n> Folder|Extension Package\n> INTaxEngine|Microsoft_TaxEngine.app\n> INTaxBase|Microsoft_TaxBase.app\n> QRGenerator|Microsoft_QRGenerator.app\n> INGST|Microsoft_India GST.app\n> INTCS|Microsoft_India TCS.app\n> INTDS|Microsoft_India TDS.app\n> INFADepreciation|Microsoft_Fixed Asset Depreciation For India.app\n> INGateEntry|Microsoft_India Gate Entry.app\n> INVoucherInterface|Microsoft_India Voucher Interface.app\n> INReports|Microsoft_India Reports.app\n5. Publish 3rd-party extensions.\n Publish 3rd-party extensions that were used on your version 14 solution. If you have new versions of these extensions, built on the Business Central version 19, then publish the new versions. Otherwise, republish the same versions that were previously published in the old deployment.\n ```powershell\n Publish-NAVApp -ServerInstance $NewBcServerInstance -Path \"<path to extension>\"\n ```\n## Task 8: Restart server instance\nRestart the Business Central Server to free up resources for completing the upgrade.\n```powershell\nRestart-NAVServerInstance -ServerInstance $NewBcServerInstance\n```\nThis step is important, otherwise you might experience issues when you run the data upgrade.\n## Task 9: Synchronize tenant\nIn this task, you synchronize the tenant's database schema with any schema changes in the application database and extensions.\nIf you have a multitenant deployment, do these steps for each tenant.\n1. (Multitenant only) Mount the tenant to the version 19 server instance.\n To mount the tenant, use the https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.management/mount-navtenant cmdlet:\n ```powershell\n Mount-NAVTenant -ServerInstance $NewBcServerInstance -DatabaseServer $DatabaseServer -DatabaseName $TenantDatabase -Tenant $TenantId -AllowAppDatabaseWrite\n ```\n> IMPORTANT\n> You must use the same tenant ID for the tenant that was used in the old deployment; otherwise you'll get an error when mounting or syncing the tenant. If you want to use a different ID for the tenant, you can either use the `-AlternateId` parameter now or after upgrading, dismount the tenant, then mount it again using the new ID and the OverwriteTenantIdInDatabase parameter.\n> For upgrade, set the `-AllowAppDatabaseWrite` parameter. After upgrade, you can dismount and mount the tenant again without the parameter if needed.\nAt this stage, the tenant state is OperationalWithSyncPending.\n2. Synchronize the tenant with the application database.\n Use the https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.management/sync-navtenant cmdlet:\n ```powershell\n Sync-NAVTenant -ServerInstance $NewBcServerInstance -Tenant $TenantId -Mode Sync\n ```\n With a single-tenant deployment, you can omit the `-Tenant` parameter and value.\n3. Synchronize the tenant with the System Application extension.\n Use the https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.apps.management/sync-navapp cmdlet:\n ```powershell\n Sync-NAVApp -ServerInstance $NewBcServerInstance -Tenant $TenantId -Name \"System Application\" -Version $NewBcVersion\n ```\n Replace `<extension version>` with the exact version of the published System Application. To get the version, you can use the Get-NAVAppInfo cmdlet<https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.apps.management/get-navappinfo>.\n4. Synchronize the tenant with the Base Application extension.\n ```powershell\n Sync-NAVApp -ServerInstance $NewBcServerInstance -Tenant $TenantId -Name \"Base Application\" -Version $NewBcVersion\n ```\n Replace `<extension version>` with the exact version of the published Base Application.\n5. Synchronize the tenant with the Application extension.\n ```powershell\n Sync-NAVApp -ServerInstance $NewBcServerInstance -Tenant $TenantId -Name \"Application\" -Version $NewBcVersion\n ```\n6. Synchronize the tenant with Microsoft and 3rd-party extensions.\n For each extension, run the Sync-NAVApp cmdlet:\n ```powershell\n Sync-NAVApp -ServerInstance $NewBcServerInstance -Tenant $TenantId -Name \"<extension name>\" -Version $NewBcVersion\n ```\n> NOTE\n> If you are upgrading from an India (IN) version of Dynamics NAV 2016, you must synchronize the tenant with the India extensions.\n> |Name|\n> |India Tax Engine|\n> |India Tax Base|\n> |QR Generator|\n> |India GSTS|\n> |India TCS|\n> |India TDS|\n> |Fixed Asset Depreciation for India|\n> |India Gate Entry|\n> |India Voucher Interface|\n> |India Reports|\n> TIP\n> When you synchronize an extension, the extension takes ownership of any tables that it includes. In SQL Server, you'll notice that the table names will be suffixed with the extension ID. For example, Base Application tables will have `437dbf0e-84ff-417a-965d-ed2bb9650972` in the name. In addition, the systemId column is added to application tables that are not already part of an extension.\n## Task 10: Upgrade data\nIn this task, you run a data upgrade on tables to handle data changes made by platform and extensions.\nIf you have a multitenant deployment, do these steps for each tenant.\n1. Upgrade the data to the platform, system application, and base application.\n 1. To run the data upgrade, use the https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.management/start-navdataupgrade cmdlet:\n  ```powershell\n  Start-NAVDataUpgrade -ServerInstance $NewBcServerInstance -Tenant $TenantId -FunctionExecutionMode Serial -SkipAppVersionCheck\n  ```\n 2. To view the progress of the data upgrade, you can run Get-NavDataUpgrade cmdlet with the `–Progress` and `–Detailed` switches.\n This step will automatically install the base application and system application on the tenant.\n2. Upgrade the new versions of Microsoft extensions and third-party extensions.\n Complete this task to upgrade any Microsoft extension and third-party extension. Microsoft extensions used in the old deployment to new versions on the installation media. The new versions are in the Application folder of the DVD. There's a folder for each extension. The extension package (.app file) is in the Source folder.\n 1. Install Application extension.\n  You have to install the Application extension first, otherwise you can't upgrade Microsoft extensions.\n  ```powershell\n  Install-NAVApp -ServerInstance $NewBcServerInstance -Tenant $TenantId -Name \"Application\" -Version $NewBcVersion\n  ```\n> NOTE\n> If you are upgrading from an India (IN) version of Dynamics NAV 2016, you must install the India extensions.\n> |Name|\n> |QR Generator|\n> |India Reports|\n2. For each extension, run Start-NAVAppDataUpgrade cmdlet<https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.apps.management/start-navappdataupgrade>:\n ```powershell\n Start-NAVAppDataUpgrade -ServerInstance $NewBcServerInstance -Name \"<extension name>\" -Version \"<extension version>\"\n ```\n This step will also automatically install the new extension version on the tenant.\n> NOTE\n> If you are upgrading from an India (IN) version of Dynamics NAV 2016, you must upgrade the India extensions.\n> |Name|\n> |India Tax Engine|\n> |India Tax Base|\n> |India GSTS|\n> |India TCS|\n> |India TDS|\n> |Fixed Asset Depreciation for India|\n> |India Gate Entry|\n> |India Voucher Interface|\n3. (Multitenant only) Repeat steps 1 through 3 for each tenant.\n## Task 11: Install 3rd-party extensions\nComplete this task to install third-party extensions for which a new version wasn't published. For each extension, run the Install-NAVApp cmdlet<https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.apps.management/install-navapp>:\n```powershell\nInstall-NAVApp -ServerInstance $NewBcServerInstance -Name <extension name> -Version <extension version>\n```\n> NOTE\n> If you are upgrading from an India (IN) version of Dynamics NAV 2016, you must Publish, Sync & Install India Data Migration Extension.\n> Publish the 'India Data Migration' extension by running the PublishNAVApp cmdlet:\n> Run the following command:\n```Powershell\n   > Publish-NAVApp -ServerInstance <ServerInstanceName> -Path <ExtensionFileName>\n   > ```\n   > Synchronize the extension with the database by running the Sync-NAVApp cmdlet for ‘India Data Migration’ extension:\n   > Run the following command:\n   > ```Powershell\n   > Sync-NAVApp -ServerInstance <ServerInstanceName> -Name <Name> -Version <N.N.N.N>\n   > ```\n   > Run the following command to Upgrade the Extension Data:\n   > ```Powershell\n   > Start-NAVAppDataUpgrade -ServerInstance <server instance name> -Name \"<extension name>\" -Version <extension\n   > ```\n   >\n   > **Run assisted setup**\n   > - Start Web Client and search for Assisted Setup and Run Setup Tax Engine for each company.\n   > - Search for Assisted Setup and Run Finalize Data Migration for each company.\n   >\n   > **Uninstall & unpublish extension**\n   > - UnInstall Extension India Data Migration.app\n   > ```Powershell\n   > Uninstall-NAVApp -ServerInstance <server instance name> -Name <extension name> -Version <extension version>\n   > ```\n   > - **Unpublish Extension India Data Migration.app**\n   > ```Powershell\n   > Unpublish-NAVApp -ServerInstance <server instance name> -Name <extension name> -Version <extension version2\n   > ```\n## Task 12: <a id=\"JSaddins\"></a>Upgrade control add-ins\n\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.\n\nTo upgrade the control add-ins from the client, do the following steps:\n\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\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.\n\n1. After you've imported all the new control add-in versions, restart Business Central Server instance.\n\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\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```\nAt this point, the upgrade is complete, and you can open the client.\n## Task 13: Install upgraded permissions sets\nIn this task, you install the custom permission sets that you upgraded earlier in this procedure. The steps depend on whether you've decided to use permission sets as AL objects or as data.\n### For permission sets as AL objects\n1. Publish the extension or extensions that include the permission sets.\n2. Sync the extensions with the tenant.\n3. Install the extensions on the tenant.\n### For permission sets as data in XML\n1. Open the Business Central Web client.\n2. Search for and open the Permission Sets page.\n3. Select Import Permission Sets, and follow the instructions to import the XML file.\nSee /ui-define-granular-permissions#to-export-and-import-a-permission-set.\n## Task 14: Change 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## Post-upgrade tasks\n1. Enable task scheduler on the server instance.\n2. (Multitenant only) For tenants other than the tenant that you use for administration purposes, if you mounted the tenants using the `-AllowAppDatabaseWrite` parameter, dismount the tenants, then mount them again without using the `-AllowAppDatabaseWrite` parameter.\n3. If you want to use data encryption as before, enable it.\n See Managing Encryption and Encryption Keys<how-to-export-and-import-encryption-keys#encryption>.\n Optionally, if you exported the encryption key instead of disabling encryption earlier, import the encryption key file to enable encryption.\n4. Grant users permission to the Open in Excel and Edit in Excel actions.\n Version 18 introduced a system permission that protects these two actions. The permission is granted by the system object 6110 Allow Action Export To Excel. Because of this change, users who had permission to these actions before upgrading, will lose permission. To grant permission again, do one of the following steps:\n  Assign the EXCEL EXPORT ACTION permission set to appropriate users.\n  Add the system object 6110 Allow Action Export To Excel permission directly to appropriate permission sets.\n   For more information about working with permission sets and permissions, see Export and Import Permission Sets</ui-define-granular-permissions#to-export-and-import-a-permission-set>.\n5. Complete the setup of the integration with Dynamics 365 Sales.\n If your Business Central on-premises deployment had an active connection with Dynamics 365 Sales, you must perform the following steps to complete the setup of the connection in Business Central online:\n  Open the Microsoft Dynamics 365 Connection Setup page.\n  To upgrade the connection to use certificate-based authentication, choose Connection, and then choose the Use Certificate Authentication action.\n  Sign in with the administrator credentials for the connected Dynamics 365 Sales organization. Signing in and the subsequent setup of the certificate authentication should take less than a minute.\n> NOTE\n> This is a required step. See /admin-how-to-set-up-a-dynamics-crm-connection#upgrade-connections-from-business-central-online-to-use-certificate-based-authentication in the business functionality content.\n Once the setup of certificate authentication is done, choose Cloud Migration, and then choose Rebuild Coupling Table.\n  This schedules the rebuilding of the coupling table and will open the corresponding job queue entry, so you can monitor its progress and restart it if it ends up in error state.\n> NOTE\n> The step for rebuilding the coupling table is not needed if you have performed cloud migration from Business Central version 15 or later.\n## Related information\n../developer/devenv-how-publish-and-install-an-extension-v2\nupgrading-to-business-central\n../developer/devenv-upgrading-extensions"}