Skip to main content

#msdyn365bc - How Do I Install New Version of Extension (on-Prem)?

Hi Readers,

In this article we will discuss about installing a new version of extension on-prem & docker containers.

With Extension model, when we change apps that we build for our customers, there are certain steps to be followed for Installation of new version of app in tenant.

This is based on a question that received on email. You will need to follow steps in same order when there a new version of Per Tenant Extension (PTE) or ISV/Apps on-Prem version.

For this demo, I will build an app called "Upgrade Extension Demo".

1. Assuming that version 1 of app is installed in the tenant as shown below.

2. A table which is part of the extension also have data as shown below.

3. Adding a new feature in app. During addition of that feature I also updated the app version to 2.0 (as shown below).

4. To Publish to new version of app we will have to running following PowerShell command in this order.

  • Un-install old app.
  • Publish New app.
  • Sync New app.
  • App Data upgrade.
  • Unpublish old app.

For Reference - 

Uninstall app - Does not remove data from the tenant.

For the Demo I am using docker environment so commands are bit different then local environment.

Docker Commands (as shown below) - 

  • Uninstall-BcContainerApp
  • Publish-BcContainerApp
  • Sycn-BcContainerApp
  • Start-BcContainerAppDataUpgrade
  • Unpublish-BcContainerApp

5. After all commands are executed, we will see Version 2 of app available in tenant.

6. Let's check the data in the table. As we can see below data is still exist in table with a new field added.

If you are using on-Prem server then commands are (after loading module) - 

  • Uninstall-NavApp -ServerInstance Servicename -Name AppName
  • Publish-NavApp -ServerInstance Servicename -Path NewAppPath
  • Sync-NavApp -ServerInstance Servicename -Version AppNewVersion -Name AppName
  • Start-NavAppDataUpgrade -ServerInstance Servicename -Version AppNewVersion -Name AppName
  • Unpublish-NavApp -ServerInstance Servicename -Version AppOldVersion -Name AppName

Hope this article helps you for installing new version of Apps.

Let me know your views as comment to article.

Saurav Dhyani


  1. Thank youn Saurav, I think in last screen shot, a small correction required, in Sync NavApp command, it should have the new App name not the one which get uninstall

    1. In my Scenario the new and old app name is same.
      If you have changed the name then you should change the name in publish, sync and install commands.


Post a Comment

Popular posts from this blog

Send Mail with Attachment From Navision.

Hi all, We have seen how to save a report into PDF and how to send mail to a customer. Let's link these two post in one i.e. Mailing statement to a customer into PDF Format. This article is part of the Series. Please Refer  Table of Content here . If you have the old objects set let me brief you what I will be changing - 

BC 21 and Higher - PowerShell Cmdlet (Replacement of Business Central Administration).

Hi Readers, As discussed in last article about deprecating of Business Central Administration, there are few common actions that we use in administration till Business Central 20. For our on-prem customers, we will still require doing activities. As Microsoft suggest we need to start using PowerShell cmdlet.    Let's see how to do those via PowerShell, or Administration Shell. I will be keep adding commands as you comment to this article.

MSDYN365BC - Data Upgrade To Microsoft Dynamics 365 Business Central on premises.

Hi Readers, We have already talked about the number of steps for upgrading to Business Central on Premises from different NAV versions. After that article, I received multiple requests for an article which list down steps for Data Migration. In this article, we will discuss steps of data migration to MSDYN365BC (on-Prem) from NAV 2017. For this article, I am considering a Cronus Demo Database without any customization. For an actual upgrade project, we will have to complete object merge using compare and Merge process. After the Merge Process, the next step is data migration. Let's discuss those steps. Direct Upgrade to Microsoft Dynamics 365 Business Central (on-Prem) is from following versions - 1. NAV 2015. 2. NAV 2016. 3. NAV 2017. 4. NAV 2018.