Installing or Upgrading Continia Apps in Multitenant Environments

When you need to install or upgrade one or more Continia apps, the method to use depends on your organization's overall software architecture – more specifically, whether the apps are to be used in a singletenant or a multitenant environment:

Using the PowerShell script in a singletenant environment

Continia has developed a PowerShell script that makes it easy for you to install and upgrade Continia Document Output and other Continia apps in a singletenant environment. For more information, see Installing Continia Document Output On-Premises and Upgrading Continia Document Output for app versions of Business Central.

When you execute the script, it automatically scans the folder that it's executed in (including all subfolders) for any existing instances of Document Output and other Continia apps. If it detects a previous version of an app, it upgrades the app and all dependencies and then uninstalls all old versions. If no app is detected, the script automatically installs the app along with any other necessary apps.

As indicated above, the script doesn't work in multitenant environments, so if your organization needs Document Output to run on a server that serves multiple tenants, you must install and/or upgrade Document Output yourself by running the script commands manually in each relevant tenant instead. This process is described in more detail in the following section.

Executing the script commands manually in a multitenant environment

To install or upgrade Continia apps in a multitenant environment, you must manually run the commands from the PowerShell script in all relevant tenants. For details on how to do this, see the following installation and upgrade guides. Both guides are based on Continia Document Output as an example.

Note

For both guides, note that the Document Output OnPremise app is optional. The app gives you access to features only available in on-premises installations of Business Central, and it's necessary if you want to use the document storage type File System or the on-premises .dll files, which also requires access to the file system.

If you decide to install Document Output OnPremise, note that you must install the Document Output server components (service tier libraries) before publishing and installing the app.

To install apps

In order to install Document Output, you must run the same three commands for each of the listed apps in the following order:


StepApp nameCommands
1Continia CoreRun the commands in this order:
1. Publish-NavApp > 2. Sync-NavApp > 3. Install-NavApp
2Continia Delivery NetworkRun the commands in this order:
1. Publish-NavApp > 2. Sync-NavApp > 3. Install-NavApp
3Document OutputRun the commands in this order:
1. Publish-NavApp > 2. Sync-NavApp > 3. Install-NavApp

To upgrade apps

In order to upgrade Document Output, you must install the new versions of the apps using the same three commands for each of the listed apps in the order described below.

Tip

Note that this set of commands is slightly different from the one used in the installation process described above.


StepApp nameCommands
1Continia CoreRun the commands in this order:
1. Publish-NavApp > 2. Sync-NavApp > 3. Start-NAVAppDataUpgrade
2Continia Delivery NetworkRun the commands in this order:
1. Publish-NavApp > 2. Sync-NavApp > 3. Start-NAVAppDataUpgrade
3Document OutputRun the commands in this order:
1. Publish-NavApp > 2. Sync-NavApp > 3. Start-NAVAppDataUpgrade

This will install the new apps and run the upgrade processes. When you're done, you must then uninstall the old versions of the apps by running the following two commands for each of the listed apps in reverse order:


StepApp nameCommands
1Document Output OnPremise (if used)Run the commands in this order:
1. UnInstall-NavApp > 2. UnPublish-NavApp
2Document OutputRun the commands in this order:
1. UnInstall-NavApp > 2. UnPublish-NavApp

See also

Installing Continia Document Output On-Premises
Upgrading Continia Document Output for app versions of Business Central