App Licensing and Registration

This section covers the licensing, registration, and license check of the COSMO Unique Device Identification app. When installing the app, COSMO Licensing is automatically installed. After installing the app, you need to register it either with a license activation code or a trial license.

Note

App registration by activation code is available if COSMO Licensing version 2.2 or higher is installed. Customers who purchase new COSMO product subscriptions through our Marketplace will receive an activation code.
If you do not have the option to enter an activation code or have not received an activation code, follow the steps in the Register the app with a trial license section. After you have registered, you can contact appsource@cosmoconsult.com to convert your 30-day trial license to a full license.

To assign licensing permission set

The COSMO Licensing app provides an extension permission set with Role ID = CCS LIC ALL. This permission set must be assigned to all users in the database to allow access to the COSMO License Overview page and, more importantly, to the licensed COSMO CONSULT apps. App-specific permission set(s) must be assigned to users in the database to allow access to the licensed functionality.

To open the COSMO License Overview

  1. If the registration notification does not show in the notification bar, refresh the environment.

    Notification bar with app to register

  2. On the notification line, choose Open License Overview.
    The app is listed in the COSMO License Overview page with Status = Unregistered.

    COSMO License Overview

  3. Choose the Register your Apps action.
    The COSMO App Registration Wizard opens with the registration options.

To register the app with license activation code

  1. If you purchased the Business Central app through our Marketplace, you will have received an activation code by email.
    Enter this activation code in the License Activation Code field on the first page of the COSMO App Registration Wizard.

    COSMO App Registration Wizard with Activation Code

Note

In SaaS environments, an activation code can be used for exactly one production system. The same activation code can additionally be used in multiple SaaS environments (sandbox environments, e.g., test/demo/development environments).
For On-premises, there is no technical distinction between Production and Sandbox, so the activation code is instead connected to the serial number of the Business Central license (.flf / .bclicense) with which it was first activated. Therefore, it is possible to use it On-premises multiple times with the same Business Central license (to allow use in test/demo/development environments). Once it has been redeemed, it cannot be used in BC environments with another BC license.

  1. In order to agree to the Terms of Use, scroll down, turn on the I understand and accept these terms toggle, and then choose the Next button.

  2. You have successfully registered your app. Choose the Finish button to close the wizard.
    The license connected to the entered activation code will then be automatically retrieved.

    COSMO App Registration Wizard

To register the app with a trial license

  1. If you turn on the Register a Trial License instead toggle on the first page of the COSMO App Registration Wizard, the app granule to be registered is displayed.

    COSMO App Registration Wizard with Trial License

  2. In order to agree to the Terms of Use, scroll down, turn on the I understand and accept these terms toggle, and then choose the Next button.

  3. Enter your customer name. The name is used to identify the company. For test purposes, enter any Cronus-related name.

  4. Choose the Next button to sign into the COSMO Platform to link the registration with your account. The COSMO Platform opens in a new browser tab. After signing in you can close this tab and return to the final page of the COSMO App Registration Wizard.

    To skip this step, choose the Skip Login button.

  5. You have successfully registered for a 30-day trial version of the app. Contact appsource@cosmoconsult.com and use the displayed license key to update your trial subscription.

  6. The app has Status = Registered. Choose the Finish button to close the wizard.

    COSMO App Registration Wizard Finished

  7. The status for the app is updated in the COSMO License Overview page. Leave the COSMO License Overview page to return to the Role Center.

Note

You can register the app and perform other administrative licensing tasks from the COSMO License Overview page.

To check the license

The COSMO License Overview page lists the license status of the COSMO app and is accessed using the Tell Me feature.

  1. Choose the Lightbulb that opens the Tell Me feature icon, enter COSMO License Overview, and then choose the related link. This page can also be opened from the UDI Setup page (Related > App Licensing) and from the last page of the COSMO App Registration Wizard by choosing Open License Overview.
  2. In the COSMO License Overview page, the app can be registered if not done on the Role Center notification bar. Other administrative tools are available as well.
  3. Hover over an action on the COSMO License Overview page to read a short description.

See Also

App Installation
App Activation
Role Center
UDI Setup

Feedback

Submit feedback for this page .