Installing or upgrading Continia apps in multi-tenant 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 – specifically, whether the apps are to be used in a single- or multi-tenant environment:
- Single-tenant environment - use the fully automated PowerShell script developed by Continia.
- Multi-tenant environment - use the script commands manually.
Using the PowerShell script in a single-tenant environment
Continia has developed a PowerShell script that makes it easy for you to install and upgrade Continia Document Capture and other Continia apps in a single-tenant environment. For more information, see Installing Document Capture on premises and Upgrading Continia Document Capture for app versions of Business Central.
When you run the script, it automatically scans the folder where it's run (including all subfolders) for any existing instances of Document Capture and other Continia apps. If it detects a previous version of an app, it upgrades the app and all dependencies and uninstalls all old versions. If no app is detected, the script automatically installs the app along with any other necessary apps.
This script doesn't work in multi-tenant environments. If your organization needs Document Capture to run on a server that serves multiple tenants, you must install and/or upgrade Document Capture by running the script commands manually in each relevant tenant instead. This process is described in detail in the following section.
Running the script commands manually in a multi-tenant environment
To install or upgrade Continia apps in a multi-tenant 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 Expense Management as an example, but you can also use them to install or upgrade Document Capture. In this case, skip all steps related to Expense Management.
Note
For both guides, note that the Document Capture 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 OCR service, which also requires access to the file system. If you decide to install Document Capture OnPremise, note that you must install the Document Capture server components (service tier libraries) before publishing and installing the app.
To install apps
To install Expense Management, 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: |
| 2 | Continia Delivery Network | Run the commands in this order: |
| 3 | Document Capture | Run the commands in this order: |
| 4 | Document Capture OnPremise (optional) | Run the commands in this order: |
| 5 | Expense Management | Run the commands in this order: |
To upgrade apps
To upgrade Expense Management, 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.
Note
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: |
| 2 | Continia Delivery Network | Run the commands in this order: |
| 3 | Document Capture | Run the commands in this order: |
| 4 | Document Capture OnPremise (if used) | Run the commands in this order: |
| 5 | Expense Management | Run the commands in this order: |
This installs the new apps and runs the upgrade processes. When you're done, you must 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 | Expense Management | Run the commands in this order: |
| 2 | Document Capture OnPremise (if used) | Run the commands in this order: |
| 3 | Document Capture | Run the commands in this order: |
| 4 | Continia Delivery Network | Run the commands in this order: |
| 5 | Continia Core | Run the commands in this order: |