Installing the VAPS

How can I install the VAPS in my on-prem environment?

Learn where and how you get the runtime package of the VAPS

First, you as a partner need to become "VAPS certified". Talk to sales@netronic.com to find out details about the certification process.

Once you are VAPS certified, you'll get access to our "NETRONIC VAPS Partner Community". It is based on Microsoft Teams, and your place to go to get your demo version/ runtime package of the product as well as Marketing and Sales collateral.

Prerequisites to install the VAPS:

  • An up and running full-fledged Dynamics 365 Business Central Installation
  • Minimum required version: Spring 2019/v14 - cumulative update 1
  • Access to the backend via the “Business Central Administration Shell” or the “NAV Container Helper
  • The Web Client needs to be enabled – and using the Web Client is highly recommended

The VAPS D365 on-prem can be installed in two different ways:

1. THE NAVSERVER INSTANCE IS INSTALLED DIRECTLY ON THE COMPUTER

What is needed for the installation:

  • Admin access to the NAV/BC server computer
  • Access to the NAV/BC Admin Shell & Development Shell with admin rights on this computer
  • The “Name” of the NAV/BC ServerInstance into which the extension should be installed
  • An updated NAV/BC license installed, which has the extension objects included
  • Access to the NAV/BC Web Client to test the installation
  • Access as “SUPER” user to NAV/BC, to assign Permission Sets to other users

Installation instructions:

Run the "Business Central Administration Shell" as administrator and enter the following commands:

  • Publish-NAVApp -ServerInstance NAV -Path “NETRONIC Software GmbH_Visual Advanced Production Scheduler_1.x.y.z_runtime.app” -SkipVerification
  • Sync-NAVApp -ServerInstance NAV -Name “Visual Advanced Production Scheduler”
  • Install-NAVApp -ServerInstance NAV -Name “Visual Advanced Production Scheduler”
  • If the install call gives an error regarding “DataUpgrade”, try
    Start-NAVAppDataUpgrade -ServerInstance NAV -Name “Visual Advanced Production Scheduler”
  • Open the NAV/BC Web Client as user with “SUPER” permissions
  • Check the “extension management” page if the extension got installed properly
  • Check if you can open/run the extension
  • Assign the “NETRONIC VAPS” permission set to all users which should work with the extension.

2. THE NAVSERVER INSTANCE IS RUNNING FROM A DOCKER ENVIRONMENT

What is needed for the installation:

  • Admin access to server computer and the corresponding Docker environment
  • Access to a powershell with the NAVContainerHelper module installed
  • The “Name” of the NAV/BC Container into which the extension should be installed
  • An updated NAV/BC license installed, which has the VAPS objects included
  • Access to the NAV/BC Web Client to test the installation
  • Access as “SUPER” user to NAV/BC, to assign Permission Sets to other users

Installation Instructions:

Please enter the following command with the help of the "NAV Container Helper"

  • Publish-NavContainerApp -containerName navserver -appFile “NETRONIC Software GmbH_Visual Advanced Production Scheduler_1.x.y.z_runtime.app” -skipVerification -sync -install
  • If the publish call gives an error regarding “DataUpgrade”, try
    Start-NAVContainerAppDataUpgrade -containerName navserver -Name “Visual Advanced Production Scheduler”
  • Open the NAV/BC Web Client as user with “SUPER” permissions
  • Check the “extension management” page if the extension got installed properly
  • Check if you can open/run the extension
  • Assign the “NETRONIC VAPS” permission set to all users which should work with the extension.