{"title":"Upgrading the Application Code in Dynamics 365 Business Central","url":"https://jonas-paprotka.de/docs/dev-itpro/upgrade/upgrading-the-application-code/","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-the-application-code, 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-the-application-code","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":"The article explains how to upgrade the application code to version 14 and how to merge code from different versions of the application.","date":"2024-04-18","meta":{"topic":"upgrade-and-migration-article"},"outline":[{"level":1,"title":"Upgrading the Application Code in Dynamics 365 Business Central","slug":"upgrading-the-application-code-in-dynamics-365-business-central","at":0,"chars":29354},{"level":2,"title":"Application Upgrade Overview","slug":"application-upgrade-overview","at":1530,"chars":3694},{"level":3,"title":"Single-tenant and multitenant deployments","slug":"single-tenant-and-multitenant-deployments","at":2846,"chars":1242},{"level":3,"title":"Different ways of upgrading application code","slug":"different-ways-of-upgrading-application-code","at":4088,"chars":1136},{"level":2,"title":"Task 1: Install the Prerequisites and Tools","slug":"task-1-install-the-prerequisites-and-tools","at":5224,"chars":1205},{"level":4,"title":"Dynamics NAV to Business Central upgrade","slug":"dynamics-nav-to-business-central-upgrade","at":5452,"chars":479},{"level":4,"title":"Business Central to Business Central upgrade","slug":"business-central-to-business-central-upgrade","at":5931,"chars":498},{"level":2,"title":"Task 2: Prepare the Application Object Text Files","slug":"task-2-prepare-the-application-object-text-files","at":6429,"chars":4614},{"level":3,"title":"Create the application text files","slug":"create-the-application-text-files","at":7660,"chars":3383},{"level":2,"title":"Task 3: Merge Versions","slug":"task-3-merge-versions","at":11043,"chars":9331},{"level":3,"title":"Merge the application object versions into text files","slug":"merge-the-application-object-versions-into-text-files","at":12224,"chars":8150},{"level":2,"title":"Task 7: (Dynamics NAV upgrade only) Configure pages and reports to be searchable","slug":"task-7-dynamics-nav-upgrade-only-configure-pages-and-reports-to-be-searchable","at":20374,"chars":464},{"level":2,"title":"Task 8: Build object search index","slug":"task-8-build-object-search-index","at":20838,"chars":368},{"level":2,"title":"Task 9. (Dynamics NAV upgrade only) Transition the custom code from old codeunit 1 to use the new implementation","slug":"task-9-dynamics-nav-upgrade-only-transition-the-custom-code-from-old-codeunit-1-to-use-the-new-implementation","at":21206,"chars":620},{"level":2,"title":"Task 10: (Single-tenant mode only) Export all objects","slug":"task-10-single-tenant-mode-only-export-all-objects","at":21826,"chars":867},{"level":2,"title":"Task 11: (Multitenant mode only) Import the upgrade toolkit objects","slug":"task-11-multitenant-mode-only-import-the-upgrade-toolkit-objects","at":22693,"chars":1175},{"level":2,"title":"Task 12: (Multitenant mode only) Publish extensions","slug":"task-12-multitenant-mode-only-publish-extensions","at":23868,"chars":5415},{"level":2,"title":"Related information","slug":"related-information","at":29283,"chars":71}],"text":"# Upgrading the Application Code in Dynamics 365 Business Central\n> NOTE\n > If you're coming from version 13 or earlier, Business Central Spring 2019 (v14) is a required step to upgrade to the latest version of Business Central. However, mainstream support for version 14 ends in October 2023, and minor updates to the version are no longer available. New customers can't use version 14 in production, but only as a path for upgrading to latest version. Existing customers on version 14 remain supported by Microsoft as defined in the Fixed Lifecycle Policy<https://learn.microsoft.com/lifecycle/products/dynamics-365-business-central-onpremises-fixed-policy>.\nTypically, customers want all the customizations that have been implemented in their existing databases to be migrated to their new Business Central databases. Depending on the version of Business Central that a database is being upgraded from, the amount of code changes between the two versions can vary. To upgrade the application code, you must merge code from different versions of the application. This merge process is known as a code upgrade or application upgrade. You must upgrade the application before you upgrade the data.\n> IMPORTANT\n> Before you begin, read the article Important Information and Considerations for Before Upgrading<upgrade-considerations>. This article contains information about limitations and things that might require you to perform extra tasks before you upgrade, such as the use of extensions V1 and the deprecation of codeunit 1.\n## Application Upgrade Overview\nDuring an upgrade, you have to first identify which changes you have to make, and then you'll have to upgrade the application objects and the application code, and finally, you might have to upgrade data so that it fits the new database schema.\nFor the application portion of the upgrade, you must analyze and process code changes by comparing and merging three separate versions of the database:\nVersion|Description\nOriginal version|This is the baseline version of the solution that you want to upgrade, such as the original release of Business Central October 2018 or Microsoft Dynamics NAV 2018.\nModified version|This is the version that you want to upgrade, such as a customer's Business Central October 2018 or Microsoft Dynamics NAV 2018 database with customizations and add-on solutions.\nTarget version|This is the target of the merge process that you want to upgrade your application to, such as the standard version of the Business Central database.\nWhen you merge the application objects from these three versions, you can import the result into a new Business Central database that then contains the upgraded application. At the end of the process, you export the merged Business Central objects from this database to a .fob file that you will use during the data upgrade.\n### Single-tenant and multitenant deployments\nThe process for upgrading the application code is basically the same for a single-tenant and multitenant deployment. However, there are some inherent differences because with a single-tenant deployment, the application and business data is included in the same database, while with a multitenant deployment application code is in a separate database than the business data (tenants). Here is the general process for each deployment type. In the tasks that follow this section, tasks are marked as Single-tenant only or Multitenant only where applicable.\nSingle-tenant\n1. Upgrade the application code.\n2. Create a new database on the new platform.\n3. Import the upgraded application to the new database.\n4. Export the application to a .fob file.\n5. Upgrade the data. Here you will import the .fob file.\nMultitenant\n1. Upgrade the application code.\n2. Create a new database on the new platform.\n3. Import the upgraded application to the new database.\n5. Upgrade the data by mounting the tenant on the application database.\nWith a multitenant deployment, you will perform the steps in this article on the application database, that is, the database that contains the application object definitions.\n### Different ways of upgrading application code\nYou can use any tool or set of tools to help you compare and merge code. Dynamics NAV and Business Central include Windows PowerShell cmdlets and sample scripts that can help you upgrade your application. The cmdlets are available through the Microsoft Dynamics NAV Development Shell and Dynamics NAV Development Shell, or by importing the Microsoft.Dynamics.NAV.Model.Tools.psd1 module into the Windows PowerShell Integrated Scripting Environment (ISE). You can find the sample scripts on the product installation media, in the WindowsPowerShellScripts\\ApplicationMergeUtilities folder.\nWe recommend that you use these cmdlets and sample scripts because they can make it faster to merge most changes. For example, you can combine several steps in a command that uses a cmdlet such as the https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.model.tools/merge-navapplicationobject. The sections in this article describe how you can use the Merge-NAVApplicationObject cmdlet and other Windows PowerShell cmdlets. See comparing-and-merging-application-object-source-files.\n## Task 1: Install the Prerequisites and Tools\nTo complete the tasks in this article, you will use various tools and components of the old Dynamics NAV version and Business Central. Ensure that you have the following installed:\n#### Dynamics NAV to Business Central upgrade\nProduct|Tool/Component\nOld Dynamics NAV version|<ul><li>Dynamics NAV Development Environment</li><li>Dynamics NAV Development Shell</li></ul>\nBusiness Central|<ul><li>Business Central Server</li><li>Dynamics NAV Development Shell(DISCONTINUED AFTER: Business Central Spring 2019)</li><li>Business Central Administration Shell</li><li>Dynamics NAV Development Environment (DISCONTINUED AFTER: Business Central Spring 2019)</li> </ul>\n#### Business Central to Business Central upgrade\nProduct|Tool/Component\nOld Business Central version|<ul><li>Dynamics NAV Development Environment</li><li>Dynamics NAV Development Shell</li></ul>\nNew Business Central version|<ul><li>Business Central Server</li><li>Dynamics NAV Development Shell(DISCONTINUED AFTER: Business Central Spring 2019)</li><li>Business Central Administration Shell</li><li>Dynamics NAV Development Environment(DISCONTINUED AFTER: Business Central Spring 2019)</li> </ul>\n## Task 2: Prepare the Application Object Text Files\nYou must prepare text files that contain the application objects for the different application versions previously described (original, modified, and target). The text files provide the input for the application merge process.\nThere are three ways to export application objects to text files:\n Use the Dynamics NAV Development Environment version that matches the application database version.\n  For more information see To export objects by using the development environment UI<../cside/cside-import-objects#ExportObjectsDevEnv>.\n Use the finsql.exe that matches the application database version to run the ExportObjects command.\n  See To export objects by running finsql.exe with the ExportObjects command <../cside/cside-import-objects#ExportObjectsFinSQL>.\n Use the Microsoft Dynamics NAV Development Shell or Dynamics NAV Development Shell version that matches the application database version.\n  This is the way that is described in the tasks of this article. Note that the Microsoft Dynamics NAV Development Shell is not available for Microsoft Dynamics NAV 2013 and Microsoft Dynamics NAV 2013 R2. For these versions, you must use development environment or finsql.exe.\n### Create the application text files\n> NOTE\n> Be sure to upload a valid developer license to the database before doing the following steps.\n1. Create four folders on the computer, and name them as follows:\n  ORIGINAL\n   This folder will be used to store the application object text file(s) from the baseline version, such as the original release of Business Central October 2018, Microsoft Dynamics NAV 2018, or Microsoft Dynamics NAV 2017.\n  MODIFIED\n   This folder will be used to store the application object text file(s) from the modified version, such as the customer's database.\n  TARGET\n   This folder will be used to store the application object text file(s) from the latest Business Central version.\n  RESULT\n   This folder will be used to store the application object text file(s) that are the result of the application merge. It will also contain zero or more .CONFLICT files that describe conflicting code.\n2. Export all application objects except system tables from the original version of the old application database, such as the original Microsoft Dynamics NAV 2018 database.\n Do not export system tables, which have the IDs in the 2000000000 range. Name the file OldBaseVersion.txt, and then save the file in the ORIGINAL folder that you created earlier.\n For example, start the Microsoft Dynamics NAV Development Shell version that matches the database version, and run the Export-NAVApplicationObject function as follows:\n ```\n Export-NAVApplicationObject –DatabaseServer MyServer –DatabaseName \"Demo Database NAV (11-0)\" –Path C:\\Upgrade\\ORIGINAL\\OldBaseVersion.txt -Filter 'Id=1..1999999999'\n ```\n3. Export all application objects, except system tables, from the old modified application database, such as the customer's customized Microsoft Dynamics NAV 2018 database.\n Name the file OldCustomVersion.txt, and then save the file in the MODIFIED folder that you created earlier.\n For example (using the Microsoft Dynamics NAV Development Shell version that matches the database version), if the customer's database is called MyCustomerNAV2016Database, you can run the following command:\n ```\n Export-NAVApplicationObject –DatabaseServer MyServer –DatabaseName \"MyCustomerNAV2018Database\" –Path C:\\Upgrade\\MODIFIED\\OldCUSTOMVersion.txt -Filter 'Id=1..1999999999'\n ```\n> TIP\n> In some cases, existing customizations might be irrelevant after the upgrade because they correspond to new functionality in Business Central.\n4. Export all application objects, except system tables, from the new base version, such as the original Business Central database.\n Name the file NewBaseVersion.txt, and then save the file in the TARGET folder that you created earlier.\n For example, using the Dynamics NAV Development Shell for Business Central, run the following command:\n ```\n Export-NAVApplicationObject –DatabaseServer MyServer –DatabaseName \"Demo Database BC (14-0)\" –Path C:\\Upgrade\\Target\\NewBaseVersion.txt -Filter 'Id=1..1999999999'\n ```\nOptionally, you can use the https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.model.tools/split-navapplicationobjectfile cmdlet to split each text file into separate text files for each application object. This can make it easier to keep track of the process. The end result at this stage is three folders with one or more text files that contain the three sets of application objects that you want to merge.\n## Task 3: Merge Versions\nYou now merge the three sets of application objects to create the application for the new database. This section illustrates how to do this by using the https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.model.tools/merge-navapplicationobject cmdlet.\nThe product installation media contains sample scripts that provide examples of how you can use the https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.model.tools/merge-navapplicationobject cmdlet to merge application objects. See merge-application-changes.\n> NOTE\n> In certain scenarios, you can choose to use the https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.model.tools/compare-navapplicationobject cmdlet to identify the changes between the existing customized application and the new application. You can then choose to use the https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.model.tools/update-navapplicationobject cmdlet to apply all or some of the changes to the new version. See compare-update-application-object-source-files. However, we recommend that you use the Merge-NAVApplicationObject cmdlet in most cases.\n### Merge the application object versions into text files\n1. Run the new Dynamics NAV Development Shell as an administrator.\n2. At the command prompt, change to the directory that contains the four folders that contain the application text files, and then run the following command:\n ```\n Merge-NAVApplicationObject -OriginalPath ORIGINAL -TargetPath TARGET -ModifiedPath MODIFIED -ResultPath RESULT\n ```\\\n For example:\n\n ```\n Merge-NAVApplicationObject -OriginalPath C:\\Upgrade\\ORIGINAL -TargetPath C:\\Upgrade\\TARGET -ModifiedPath C:\\Upgrade\\MODIFIED -ResultPath C:\\Upgrade\\RESULT\n ```\n Depending on the number of objects that you are merging and the number of differences found, this can take a few seconds, a few minutes, or longer. When the cmdlet completes, the result of the merge is shown, including a description of any application objects with conflicting code. The **RESULT** folder will contain a text file (.TXT) for each merged application object and possibly one or more .CONFLICT files that describe the code conflicts that occurred during the merge.\n\n At this point, you can either go to Task 4 to analyze and eventually resolve the conflicts, or you can go directly to Task 5 to import the merged objects as-is from the **RESULT** folder to the new Business Central database.\n\n ## Task 4: Handling Conflicts\n\n Depending on the application that you are upgrading, you can choose to analyze and fix the conflicting code before you import the merged objects into the Dynamics NAV Development Environment for Business Central. The conflicts are shown in the merged text files but are also identified in .CONFLICT files in the subfolders of the **RESULT** folder. The subfolders **ConflictOriginal**, **ConflictModified**, and **ConflictTarget** folders then contain copies of the source files from the versions that have conflicting code.\n\n You can analyze the conflicts in any tool, make the relevant changes, and then run the merge operation again. For more information, see [Handling Merge Conflicts](/dev-itpro/upgrade/handling-merge-conflicts). Alternatively, you can go directly to task 5 to import the merged files into the Dynamics NAV Development Environment, and resolve the conflicts there.\n\n ## Task 5: Import and Compile Merged Objects in an Empty Database\n\n After you have completed the merge, you import the new merged application objects as text files into a new (empty) Business Central database, and then compile all objects. You must resolve any compilation errors before you can continue. The text files include successfully merged code, and code that is partially merged. You can import the partially merged objects into the Business Central development environment and resolve the conflicts there.\n\n 1. Create a new Business Central database for the new upgraded application. The database should be empty, except for the system tables.\n\n For example, give the database the name *My Upgraded App*. For more information, see [Creating and Altering Databases](/dev-itpro/cside/cside-create-databases).\n\n >[!IMPORTANT]\\\n > You must set the collation of the new database to match the collation of the old application database. To see the collation of the old database, open it in the old Dynamics NAV Development Environment version, then choose **File** > **Database** > **Alter** > **Collation**.\n\n 2. Make sure the database includes a valid Business Central license.\n\n For more information, see [Uploading a License File for a Specific Database](/dev-itpro/cside/cside-upload-license-file)\n\n 3. Import the new merged application object text files (.TXT) from the **Result** folder into the new database.\n\n There are three ways to import the files:\n\n - Use the Dynamics NAV Development Environment for Business Central.\n\n     For more information see [To import objects by using the development environment UI](/dev-itpro/cside/cside-import-objects#ImportObjectsDevEnv).\n - Use the finsql.exe to run the [ImportObjects](https://learn.microsoft.com/dynamics-nav/importobjects) command.\n\n     For more information, see [To import objects by running finsql.exe with the ImportObjects command  ](/dev-itpro/cside/cside-import-objects#ImportObjectsFinSQL).\n\n - Use the Dynamics NAV Development Shell (or Microsoft.Dynamics.NAV.Model.Tools.psd1 module).\n\n     The shell includes the **Join-NAVApplicationObjectFile** cmdlet and **Import-NAVApplicationObject** function. The **Join-NAVApplicationObjectFile** cmdlet combines multiple application object text files into one text file. The **Import-NAVApplicationObject** function runs the [ImportObjects](https://learn.microsoft.com/dynamics-nav/importobjects) command to import an object file.\n\n     This means that you can run a command similar to following to create a single text file from the merge application text files in the **Result** folder:\n\n ```\n Join-NAVApplicationObjectFile -Source C:\\Upgrade\\RESULT*.txt -Destination C:\\Upgrade\\all-merged.txt\n ```\n\n Then, you can run this command to import the text file:\n ```\n Import-NAVApplicationObject -DatabaseServer MyServer -DatabaseName \"My Upgraded App\" -Path C:\\Upgrade\\all-merged.txt\n ```\n\n 4. Connect the new Business Central Server instance to the database.\n\n You can do this with the Business Central Server Administration tool or the [Set-NAVServerConfiguration cmdlet](https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.management/set-navserverconfiguration) in the Dynamics NAV Administration Shell. In addition, you must add the service account that is used by the Business Central Server instance as a member of the **db\\_owner** role in the Business Central database on SQL Server.\n\n For more information about how to do this using the Business Central Server Administration tool, see [How to: Connect a Microsoft Dynamics NAV Server Instance to a Database](/dev-itpro/administration/connect-server-to-database) and [Giving the account necessary database privileges in SQL Server](/dev-itpro/deployment/provision-server-account#dbo).\n\n 5. Compile all the newly imported objects. Choose to synchronize **later**.\n\n You can use the Dynamics NAV Development Environment or finsql.exe. For more information, see [Compiling Objects](/dev-itpro/cside/cside-compiling-objects).\n\n If you use the Dynamics NAV Development Environment, you will first have to set it to use the Business Central Server instance that connects to the database. For more information, see [Change the Server Instance Used in C/SIDE](/dev-itpro/cside/cside-change-server-instance).\n\n When you compile the objects, an error is thrown for each code conflict, and you can use the tools that are available in the development environment to resolve the conflicts.\n\n ## Task 6: Check/change the application family and version\n\n The application and tenant databases are tagged with `Family` and `Version`. To perform the data upgrade, the `Family` on the application must match that tenant's `Family`. The `Version` of the application must be greater than or equal to the tenant's `Version`. The easiest way to ensure that `Family` and `Version` of the upgraded application are compatible for data upgrade is to set `Family` to the same value as the old application, and set the `Version` to a higher value than the old application.\n\n To get the `Family` and `Version`, use the [Get-NAVApplication](https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.management/get-navapplication) cmdlet, for example:\n\n ```powershell\n Get-NAVApplication -ServerInstance BC\n ```\nTo set the Family and Version, use the https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.management/set-navapplication cmdlet. For example, to set the family, run the following command:\n```powershell\nSet-NAVApplication -ServerInstance <ServerInstanceName> -ApplicationFamily <Family>\n```\nTo increase the version by 1, run the following command:\n```powershell\nSet-NAVApplication -ServerInstance <ServerInstanceName> -IncrementApplicationVersion\n```\nOr, to specify change to another version, run the following command:\n```powershell\nSet-NAVApplication -ServerInstance <ServerInstanceName> -ApplicationVersion <N.N.N.N> -Force\n```\n## Task 7: (Dynamics NAV upgrade only) Configure pages and reports to be searchable\nThe MenuSuite is no longer used to control whether a page or report can be found in the search feature of the Web client. This is now determined by specific properties on the page and report objects. This task is not required at this point, and can be done after the data upgrade as well.\nSee Making Pages and Reports Searchable After an Upgrade<upgrade-pages-report-for-search>.\n## Task 8: Build object search index\nBuild the object search index to make objects able to be searched from Tell Me in the client. If you completed step 7, you can skip this step.\nIn the Tools menu of the Dynamics NAV Development Environment, select Build Object Search Index.\nSee Making Pages and Reports Searchable After an Upgrade<upgrade-pages-report-for-search>.\n## Task 9. (Dynamics NAV upgrade only) Transition the custom code from old codeunit 1 to use the new implementation\nBecause codeunit 1 has been deprecated in Business Central, you must move any custom logic that was included in the old codeunit 1 into the management codeunits and methods described in the article Transitioning from Codeunit 1<transition-from-codeunit1>.\nYou now have a new database with a fully upgraded application. For a multitenant deployment, you can start the data upgrade. For this, you will use the new server instance that connects to the upgraded application database. See upgrading-the-data.\n## Task 10: (Single-tenant mode only) Export all objects\nWith a single-tenant deployment, export all objects of the new database to a .fob type file, such as objects.fob file. You will use this .fob file as part of the data upgrade process. The export must include customized objects, upgraded reports, and all other Business Central objects.\nAs with exporting objects in Task 1, you can use either the development environment, finsql.exe, or Dynamics NAV Development Shell.\nWith the Dynamics NAV Development Shell, you can run a command that is similar to the following:\n```\nExport-NAVApplicationObject c:\\Upgrade\\objects.fob -DatabaseName \"My Upgraded App\" -DatabaseServer [server_name]\\[database_instance]\n```\nThis completes the upgrade of the application code for single-tenant deployment. Next, you must upgrade the data in the database. See upgrading-the-data.\n## Task 11: (Multitenant mode only) Import the upgrade toolkit objects\nThe upgrade toolkit includes upgrade codeunits for handling the data upgrade.\nFor W1 versions, you can find the default upgrade toolkit objects in the UpgradeToolKit\\Data Conversion Tools folder on the Business Central installation media (DVD). Choose the FOB that matches the Dynamics NAV version from which you are upgrading:\nFrom|To Business Central April 2019|To Business Central October 2018\nMicrosoft Dynamics NAV 2015|Upgrade80014x.FOB|Upgrade800130.FOB\nMicrosoft Dynamics NAV 2016|Upgrade90014x.FOB|Upgrade900130.FOB\nMicrosoft Dynamics NAV 2017|Upgrade100014x.FOB|Upgrade1000130.FOB\nMicrosoft Dynamics NAV 2018|Upgrade110014x.FOB|Upgrade1100130.FOB\nBusiness Central Fall 2018|Upgrade13x14x.FOB|Not applicable\nFor local versions, you will find the upgrade toolkit objects in the UpgradeToolKit\\Local Objects folder. The files follow the same naming convention except they include the 2-letter local version, such as Upgrade110014x.DK.fob for Denmark, Upgrade110014x.DE.fob for Germany, or Upgrade90014x.IN.fob for India.\nFor information about importing objects, see ../cside/cside-import-objects.\n## Task 12: (Multitenant mode only) Publish extensions\n1. Unpublish the existing system, test, and application symbols by using the Unpublish-NAVAPP cmdlet<https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.apps.management/unpublish-navapp>:\n ```\n Unpublish-NAVApp -ServerInstance <ServerInstanceName> -Name <name> -Version <n.n.n.n>\n ```\n2. Publish the system and test symbols.\n Symbols are a prerequisite for extensions. If you installed the AL Development Environment, you can find the symbol files where your installed the environment, which by default is C:\\\\Program Files \\(x86\\)\\\\Microsoft Dynamics 365 Business Central\\\\NNN. Otherwise, you can find the files in the ModernDev folder on the installation media.\n To publish the symbols, open the Business Central Administration Shell as an administrator, and run the following command for each of the symbol files:\n ```\n Publish-NAVApp -ServerInstance <ServerInstanceName> -Path <SymbolFilePath> -PackageType SymbolsOnly\n ```\n3. Generate the application symbol references by using the finsql.exe file as follows:\n 1. Make sure that Enable loading application symbol references at server startup (EnableSymbolLoadingAtServerStartup) is set on the Business Central Server instance.\n  See Configuring Dynamics NAV Server<../administration/configure-server-instance>.\n 2. Open a command prompt as an administrator, change to the directory where the finsql.exe file has been installed as part of Dynamics NAV Development Environment, and then run the following command:\n  ```\n  finsql.exe Command=generatesymbolreference, Database=\"<MyDatabaseName>\", ServerName=<DatabaseServerName>\\<DatabaseInstance>\n  ```\n  Replace values for the Database and ServerName settings to suit.\n  If the application database contains test objects (ID 130000-139999), then make sure to exclude these objects when generating symbols. You can do this by using the `-Filter` parameter and running the command twice:\n  ```\n  finsql.exe command=generatesymbolreference, ServerName=<DatabaseServerName>\\<DatabaseInstance>, Database=<MyDatabaseName>, filter=\"Object ID=1..129999\"\n  ```\n  ```\n  finsql.exe command=generatesymbolreference, ServerName=<DatabaseServerName>\\<DatabaseInstance>, Database=<MyDatabaseName>, filter=\"Object ID=140000..1999999999\"\n  ```\n> NOTE\n> This command does not generate a file. It populates the Object Metadata table in the database.\n3. When you run the command, the console returns to an empty command prompt, and does not display or provide any indication about the status of the run. However, the finsql.exe may still be running in the background. It can take several minutes for the run to complete, and the symbols will not be generated until such time. You can see whether the finsql.exe is still running by using Task Manager and looking on the Details tab for finsql.exe.\n When the process ends, a file named navcommandresult.txt is saved to the Dynamics NAV Client connected to Business Central installation folder. If the command succeeded, the file will contain text like `[0] [06/12/17 14:36:17] The command completed successfully in '177' seconds.` If the command failed, another file named naverrorlog.txt will be generated. This file contains details about the error(s) that occurred.\nFor more information about generation symbols, see Running C/SIDE and AL Side-by-Side<../developer/devenv-get-started>.\n4. Publish new versions of the Microsoft extensions.\n The Business Central installation media (DVD) includes several new versions of Microsoft extensions (that is, extensions that have Microsoft as the publisher). If your old deployment uses these extensions, you have to upgrade the old versions to the new versions.\n> IMPORTANT\n> For Denmark (DK), German (DE), and India (IN) versions. Some of the local functionality has been moved from the base application to extensions.\n> If you are upgrading from a Denmark (DK) version of Dynamics NAV 2017 or earlier, you must publish and install the following extensions to get the local functionality:\n> Name|Extension package\n> OIOUBL|OIOUBL.app\n> Payroll Data Import Definitions (DK)|ImportDKPayroll.app\n> Payment and Reconciliation Formats (DK)|FIK.app\n> Tax File Formats (DK)|VATReportsDK.app\n> If you are upgrading from a German (DE) version of Dynamics NAV or Business Central October 2018 (Cumulative Update 2 or earlier), you must publish and install the following extensions to get the local functionality:\n> Name|Extension package\n> ELSTER VAT Localization for Germany|Elster.app\n> If you are upgrading from an India (IN) version of Dynamics NAV 2016, you must publish and install the following extensions to get the local functionality:\n> Name|Extension package\n> India Tax Base|IndiaTaxBase.app\n> India Tax Engine|IndiaTaxEngine.app\n> India Tax GST|IndiaTaxGST.app\n> India Upgrade Tables|IndiaUpgradeTables.app\n> India TCS|IndiaUPGTCS.app\n> India TDS|IndiaUPGTDS.app\n> Fixed Asset Depreciation for India|INFADepreciation.app\n> India Gate Entry|INGateEntry.app\n> India Voucher Interface|INVoucherInterface.app\n> India Data Migration|UPGIndia.app\nThe new versions are found in the `\\Extensions` folder of the installation media.\nTo publish the new extension version, run the https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.apps.management/publish-navapp cmdlet:\n```\nPublish-NAVApp -ServerInstance <ServerInstanceName> -Path <ExtensionFileName>\n```\n## Related information\nupgrading-the-data\nupgrading-to-business-central"}