Installation and Setup

Dawid Kaczmarek Updated by Dawid Kaczmarek

This article covers installing Cepheo Software Licensing, verifying that registration completes successfully, and confirming your licenses are active.

Prerequisites

  • A Dynamics 365 Finance & Operations environment (cloud-hosted or LCS-managed).
  • System Administrator access.
  • Access to Microsoft Lifecycle Services (LCS) Asset Library.
  • Outbound HTTPS connectivity from the AOS to the Cepheo Licensing API endpoint.

Network Requirements

Direction Protocol Destination Purpose
Outbound HTTPS (443) Cepheo Licensing API Registration, token refresh, license data, telemetry

Note: If your environment uses a proxy or firewall, ensure the AOS service account can reach this endpoint.

Installation

CSL is delivered as part of a Cepheo product deployable package. It is not installed separately.

  1. Obtain the Cepheo deployable package from your Cepheo contact.
  2. Upload the package to LCS > Asset library > Software deployable package.
  3. Deploy the package to your development environment.
  4. Add the CepheoSoftwareLicensing model to source control.
  5. Use your standard Azure DevOps release pipeline to deploy to Test, UAT, and Production environments.

Note: No license file, activation key, or manual import is required. CSL activates automatically on first startup.

Automatic Registration

On the first D365FO startup after installation, CSL automatically registers the environment with the Cepheo Licensing API. The process is fully automatic:

  1. CSL detects the tenant ID and environment ID from D365FO platform APIs.
  2. It sends a registration request to the Cepheo Licensing API endpoint.
  3. On success, encrypted authentication tokens are stored in the database.
  4. The registration status is set to Registered.

If registration fails (for example, due to a network issue), CSL retries up to 3 times with exponential backoff. Persistent failures are logged in the audit log.

Post-Install Verification

After deployment and first startup:

  1. Log in to D365FO as a System Administrator.
  2. Search for License Management in the navigation bar and open the form.
  3. On the License view tab, confirm that Cepheo Software Licensing appears in the module list.
  4. On the Configuration tab, confirm that Registration endpoint shows the API URL and both batch task status fields show Scheduled.
  5. Expand the Token information FastTab and verify Effective registration status is Registered.

If registration has not yet completed, wait for the next AOS restart or check the audit log for error details.

How did we do?

License Management

Contact