How to publish and install/upgrade extension in Microsoft Dynamics NAV 2018?

Network of MS Dynamics D365, AX, NAV, GP, SL, CRM, RMS, POS professionals Forums Microsoft Dynamics NAV / Navision NAV Consulting and Configuration How to publish and install/upgrade extension in Microsoft Dynamics NAV 2018?

This topic contains 2 replies, has 3 voices, and was last updated by  Locus IT 5 months, 4 weeks ago.

Viewing 3 posts - 1 through 3 (of 3 total)
  • Author
    Posts
  • #20733

    Ruth Smith
    Participant

    How to publish and install/upgrade extension in Microsoft Dynamics NAV 2018?

    #21032

    Locus IT
    Participant

    Hello Ruth,

    Microsoft Dynamics NAV 2018 includes several extensions that you publish and install as part of the upgrade process. To enable these extensions, it is important that you follow the steps below.

    1. Download the system and test symbols file from the ModernDev folder on the DVD and the application symbols from here. Make a note of the path where you store the files.

    2. Publish the platform, test, and application symbols one file at a time to the Dynamics NAV server instance:

      Open the Microsoft Dynamics NAV Administration Shell as an administrator, and run the following command for each of the symbol files:

      Publish-NAVApp -ServerInstance <ServerInstanceName> -Path <SymbolFilePath> -PackageType SymbolsOnly
      
    3. Make sure that Enable loading application symbol references at server startup(EnableSymbolLoadingAtServerStartup) are set on the Dynamics NAV server instance.
    4. Generate the application symbol references for running Running C/SIDE and AL Side-by-Side:

    a) Open a command prompt, change to the directory where the finsql.exe file has been installed as part of Microsoft Dynamics NAV 2018, and then run the following command:

    finsql.exe Command=generatesymbolreference, Database=<MyDatabaseName>, ServerName=<DatabaseServerName>\<DatabaseInstance>
    

    Replace values for the Database and ServerName settings to suit.

    b) 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.

    When the process ends, a file named navcommandresult.txt is saved to the Microsoft Dynamics NAV Windows client 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.

    5. Publish all the extensions from the \Extensions folder of the Microsoft Dynamics NAV 2018 installation media (DVD):

      1. From the Microsoft Dynamics NAV Administration Shell, run the following command for each extension.
        Publish-NAVApp -ServerInstance <ServerInstanceName> -Path <ExtensionFileName> 
        

        V1 extensions have the file type .navx. V2 extensions have the file type .app.

      2. For each Extension V2, run the following command to synchronize its schema with the tenant database:
        Sync-NAVApp -ServerInstance <ServerInstanceName> -Name <Name> -Version <N.N.N.N>
        

    6. Upgrade the V1 extensions that you uninstalled previously in Task 3 by reinstalling them. From the Microsoft Dynamics NAV Administration Shell, run the following commands:

      1. To get a list of the published extensions on the server instance, run this command:
        Get-NAVAppInfo -ServerInstance <ServerInstanceName>
        
      2. To determine which V1 extensions to install, inspect the list that appears, and compare it with the list that you gathered in Task 3. V1 extensions are indicated by Extension Type : CSIDE.
        • If there is only one version of an extension, which matches the version in the old list, then go to step 6c to reinstall the version.
        • If there is a newer version of an extension and its Extension Type is also CSIDE, then go to step 6c to install and upgrade to the newer V1 extension.
        • If there is a newer version of an extension but its Extension Type is ModernDev, then go to step 6d to upgrade the old V1 extension to the V2 extension.
      3. For each V1 Extension that you want to reinstall or upgrade, run this command:
        Install-NAVApp -ServerInstance <ServerInstanceName> -Name <Name> -Version <N.N.N.N> –Tenant <TenantID>
        

        Replace <Name> and <N.N.N.N> with the name and version of the Extension V1 as it appeared in the previous step. For <TenantID>, in single-tenant deployments, you either specify default or you omit the –Tenant parameter.

        This will upgrade the V1 extensions.

        Optionally, if you installed a newer version of an extension, unpublish the old version:

        Unpublish-NAVApp -ServerInstance <ServerInstanceName> -Name <Name> -Version <N.N.N.N>
        
      4. For each V1 Extension that you want to upgrade to a V2 Extension, run these commands:
        Sync-NAVApp -ServerInstance <ServerInstanceName> -Name <Name> -Version <N.N.N.N>
        Start-NAVAppDataUpgrade -ServerInstance DynamicsNAV -Name ProswareStuff -Version <N.N.N.N>
        

        This will upgrade the V2 extensions.

        Optionally, unpublish the V1 extension.

        Unpublish-NAVApp -ServerInstance <ServerInstanceName> -Name <Name> -Version <N.N.N.N>
        

    7. For the Denmark (DK) local version of Microsoft Dynamics NAV 2018, you must install the following new V2 extensions to get all the local functionality.

    Name Publisher Version
    Payroll Data Import Definitions (DK) Microsoft 1.0.19502.0 (or later)
    Payment and Reconciliation Formats (DK) Microsoft 1.0.19502.0 (or later)
    Tax File Formats (DK) Microsoft 1.0.19502.0 (or later)

    For each Extension V2, run this command:

    Install-NAVApp -ServerInstance <ServerInstanceName> -Name <Name> -Version <N.N.N.N> 
    

    8. Recompile published V1 extensions.

    Use the Repair-NAVApp cmdlet of the Microsoft Dynamics NAV 2018 Administration Shell to compile the published extensions to make sure they are work with the new platform and application.

    For example, you can run the following command to recompile all extensions:

    Get-NAVAppInfo -ServerInstance <ServerInstanceName> | Repair-NAVApp
    
    #20735

    Lee Min
    Participant

    Hello Ruth,

    To make your extension available to users, the package must be published to a specific Microsoft Dynamics NAV Server instance. The extension can be installed for one or more tenants.

    When you install an extension that includes changes to the menu suites, this does not take effect for any user until you sign out and then sign in again.

Viewing 3 posts - 1 through 3 (of 3 total)

You must be logged in to reply to this topic.

Skip to toolbar