App Installation

  • How do I install the COSMO Data Integration Framework in a SaaS environment?
  • How do I install the COSMO Data Integration Framework in an on-premises environment?
  • What are the dependencies of the COSMO Data Integration Framework app?
  • How do I install the COSMO Data Integration Framework app in a docker container?
  • How do I install the COSMO Data Integration Framework app in a server instance?
Tip

Summary: This article provides instructions for installing the COSMO Data Integration Framework in both SaaS and On-Premises environments. In SaaS environments, the app can be installed from AppSource or the Extension Marketplace. In On-Premises environments, the app can be installed using Docker or a Server Instance. Additionally, the app requires the installation of the COSMO Licensing, COSMO Template Catalog, and COSMO Data Integration Framework apps in the correct order.

This section covers the installation of the COSMO Data Integration Framework app. Typically an installation is only performed once by an administrator and is not executed by the user. The installation differs for SaaS and On-Premises (OnPrem) environments.

To install in SaaS environment

In SaaS environments, the app can be installed from Microsoft AppSource either from Business Central or directly from the Microsoft site. All dependencies are installed automatically.

Depending on the current Microsoft upgrade policy, you may not have the most current version of the app. To upgrade to the most current version, go to the Dynamics 365 Business Central admin center and perform the app upgrade for your environment.

Business Central

  1. In Business Central, choose the Lightbulb that opens the Tell me feature icon, enter Microsoft AppSource apps, and then choose the related link.
  2. If a message opens asking to allow the request to an external service, choose whether to Allow Always or Allow Once and then choose the OK button.
  3. In the Microsoft AppSource apps page, search for and choose COSMO Data Integration Framework.
  4. In the App overview page, choose the Install App action.
    Note

    If you choose the View on AppSource action, you're taken to the Microsoft AppSource Site.

  5. Follow the wizard instructions to complete the installation.
  6. After installation, go to the Business Central home page and license/register the app.

Microsoft AppSource Site

  1. ​Open the Microsoft AppSource site.
  2. Choose the Free trial button.
  3. You will be forwarded to a page where you must log in with your Business Central user credentials and select an environment to install the app to.
  4. Follow the wizard instructions to complete the installation.
  5. After installation, go to the Business Central home page and license/register the app.

To install in on-premises environment

To install the COSMO Data Integration Framework app and its requirements in an on-premises environment, you can find the app files in the App Versions (Download Area) of the COSMO CONSULT Solution Store. Check the technical specifications of each version to find the minimum dependent version of Business Central and the Base Application. For customer installations without a Business Central developer license, you must create and install a runtime package of the app (Microsoft Documentation).

Besides the Business Central Base Application, the app depends on additional apps that must be installed in the correct order first.

  1. COSMO Licensing app
  2. COSMO Template Catalog app
  3. COSMO Data Integration Framework app

Feedback
Submit feedback for this page .