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:
- Singletenant environment: Use the fully automated PowerShell script developed by Continia.
- Multitenant environment: Execute the script commands manually yourself, as described below.
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:
| Step | App name | Commands |
|---|---|---|
| 1 | Continia Core | Run the commands in this order: 1. Publish-NavApp > 2. Sync-NavApp > 3. Install-NavApp |
| 2 | Continia Delivery Network | Run the commands in this order: 1. Publish-NavApp > 2. Sync-NavApp > 3. Install-NavApp |
| 3 | Document Output | Run 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.
| Step | App name | Commands |
|---|---|---|
| 1 | Continia Core | Run the commands in this order: 1. Publish-NavApp > 2. Sync-NavApp > 3. Start-NAVAppDataUpgrade |
| 2 | Continia Delivery Network | Run the commands in this order: 1. Publish-NavApp > 2. Sync-NavApp > 3. Start-NAVAppDataUpgrade |
| 3 | Document Output | Run 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:
| Step | App name | Commands |
|---|---|---|
| 1 | Document Output OnPremise (if used) | Run the commands in this order: 1. UnInstall-NavApp > 2. UnPublish-NavApp |
| 2 | Document Output | Run 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