{"title":"<a id=\"AddExtensions\"></a>Publishing, Upgrading, and Installing Extensions During Upgrade","url":"https://jonas-paprotka.de/docs/dev-itpro/upgrade/upgrade-publish-extensions/","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-publish-extensions, 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-publish-extensions","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 publishing, upgrading, and installing extensions during upgrade to Dynamics 365 Business Central.","date":"2021-04-01","meta":{"topic":"upgrade-and-migration-article"},"outline":[{"level":1,"title":" Publishing, Upgrading, and Installing Extensions During Upgrade","slug":"publishing-upgrading-and-installing-extensions-during-upgrade","at":0,"chars":7475},{"level":2,"title":"Get a list of current extensions","slug":"get-a-list-of-current-extensions","at":331,"chars":299},{"level":2,"title":"Publish new system, test, and application symbols","slug":"publish-new-system-test-and-application-symbols","at":630,"chars":3602},{"level":2,"title":"Publish and synchronize new versions of extensions","slug":"publish-and-synchronize-new-versions-of-extensions","at":4232,"chars":727},{"level":2,"title":"Synchronize the database with the schema changes of the extensions","slug":"synchronize-the-database-with-the-schema-changes-of-the-extensions","at":4959,"chars":477},{"level":2,"title":"Upgrade the data of the extensions","slug":"upgrade-the-data-of-the-extensions","at":5436,"chars":465},{"level":2,"title":"Install new extensions on the tenants","slug":"install-new-extensions-on-the-tenants","at":5901,"chars":440},{"level":2,"title":"Repair, synchronize, and install any custom extensions (third-party) that are currently published and that you still want to use","slug":"repair-synchronize-and-install-any-custom-extensions-third-party-that-are-currently-published-and-that-you-still-want-to-use","at":6341,"chars":860},{"level":2,"title":"Related information","slug":"related-information","at":7201,"chars":274}],"text":"#  Publishing, Upgrading, and Installing Extensions During Upgrade\nThis article describes how to publish, upgrade and install extension when upgrading to a new version of Business Central.\n> IMPORTANT\n> To complete the step in this article, you use the Business Central Administration Shell. You must run this as an administrator.\n## Get a list of current extensions\nIt is useful to get a list of the extensions that are currently published for future reference. To get list of the extensions currently published on the application, run the following command:\n```powershell\nGet-NAVAppinfo -ServerInstance <ServerInstanceName>\n```\n## Publish new system, test, and application symbols\nIf 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.\n1. Unpublish the system, test, and application symbols.\n 1. To get a list of the currently published symbols, use the Get-NAVAppInfo cmdlet:\n  ```\n  Get-NAVAppinfo -ServerInstance <ServerInstanceName> -SymbolsOnly\n  ```\n 2. Unpublish the symbols 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 new system.app and test.app symbol files.\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 Business Central 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. Restart the Business Central Server instance.\n## Publish and synchronize new versions of extensions\nYou must upgrade the Microsoft extensions that were published in the old deployment to new versions. For Denmark (DK) and German (DE), you must also complete this step to install the new local functionality extensions, such as ELSTER.\nThe new extension versions are found in the `\\Extensions` folder of the installation media (DVD). Follow these steps for each extension by using the Business Central Administration Shell.\nTo publish the new extension version, run the https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.apps.management/publish-navapp cmdlet:\n```powershell\nPublish-NAVApp -ServerInstance <ServerInstanceName> -Path <ExtensionFileName>\n```\n## Synchronize the database with the schema changes of the extensions\nFor each extension, run the https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.apps.management/sync-navapp cmdlet:\n```powershell\nSync-NavApp -ServerInstance <ServerInstanceName> -Name  <ExtensionFileName>  -Version N.N.N.N -Tenant <TenantID>\n```\nReplace `<TenantID>` with the tenant ID of the database. If you do not have a multitenant server instance, use default or omit this parameter.\n## Upgrade the data of the extensions\nThis step is not required for the newly published local functionality extensions.\nTo run the data upgrade, run the https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.apps.management/start-navappdataupgrade cmdlet:\n```powershell\nStart-NAVAppDataUpgrade -ServerInstance <ServerInstanceName> -Name <Name> -Version <N.N.N.N>\n```\nApart from upgrading the data, this command will install the new extension version.\n## Install new extensions on the tenants\nInstall the newly published local functionality extensions by running the https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.apps.management/install-navapp cmdlet:\n```powershell\nInstall-NAVApp -ServerInstance <ServerInstanceName> -Name <Name> -Version <N.N.N.N>\n```\nFor more information about publishing extensions, see ../developer/devenv-how-publish-and-install-an-extension-v2.\n## Repair, synchronize, and install any custom extensions (third-party) that are currently published and that you still want to use\nThis ensures that the extensions work on the new platform and application versions. For each extension, complete the following steps from the Business Central Administration Shell:\n1. Compile the extension to make it work with the new platform by running the https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.apps.management/repair-navapp cmdlet:\n ```\n Repair-NAVApp -ServerInstance <ServerInstanceName> -Name <Extension Name> -Version <N.N.N.N>\n ```\n2. Synchronize the schema with the database:\n ```\n Sync-NAVApp -ServerInstance <ServerInstanceName> -Name <Name> -Version <N.N.N.N>\n ```\n3. Install the extension:\n ```\n Install-NAVApp -ServerInstance <ServerInstanceName> -Name <Name> -Version <N.N.N.N>\n ```\n## Related information\nupgrading-the-application-code\nupgrading-to-business-central\nSynchronizing the Tenant Database and Application Database<../administration/synchronize-tenant-database-and-application-database>\n../developer/devenv-how-publish-and-install-an-extension-v2"}