Welcome to Semarchy.

This tutorial shows you how to get a license key to be able to use Semarchy xDM beyond the 7-day trial period to complete the tutorials available on the Semarchy website.

What you'll learn

What you'll need


Before you start

If you have not already done so, you need to install xDM first. You can follow the tutorials to install xDM on-premises or in the Cloud.


Enjoy this tutorial!

To get a license key, you must have an account on Semarchy's License Server. This section walks you through how to create an account and request your license key.

To create an account on the Semarchy License Server:

  1. Log into your Semarchy xDM instance. You will land on the Welcome Page.
  2. Go to the Manage License page. You should see the "Activation Required" page.
  3. Go to the link license.semarchy.com. Create a new account (if you don't already have an account; if you have an account, log in).
  4. Go to the SIGN UP tab and create a new account.
  5. You should receive an email from the Semarchy License Server to confirm that you have successfully created an account. Follow the instructions in the email.
  6. You should see a message that your email was verified.

In the next section, you will sign into the License Server and request a license key.

Now that you have an account, it is time to request a license key and register your Semarchy instance. If you are evaluating Semarchy and your organization does not yet have a license, this section takes you through the steps to request a trial license. Once your license is approved, you can proceed to the next step to add a new instance.

To request a trial license:

  1. Log into the Semarchy License Server and open the License Server application.
  2. Click on "Request a trial".
  3. Fill out the form with your information to request a trial license.
  4. You should receive a confirmation email that is similar to the one below.

    Once your trial license is granted, you can log in to the License Server and add your new xDM instance.

Once you have been granted a license (whether that is a customer license or a trial license), the next step is to add your new xDM instance as one of the instances using your license.

To get a license key to activate your new xDM instance:

  1. Go back to your Semarchy instance. On the Manage License page, click the Activate button.
  2. Copy the instance ID.
  3. Log into the Semarchy License Server. Click on "Add instance".
  4. Fill in the form to add your instance and click Finish. Be sure to give your instance a meaningful name in the Name field like "Alice's Tutorial Instance" or "Product Domain POV".
    You will receive an email from Semarchy confirming that you added the new instance. This email will contain your license key.
  5. Copy and paste the license key from the email.

  1. Paste the license key into the step that prompts for the license key.
  2. Activate the license key.
  3. You can choose to ENABLE AUTO-SYNC the instance with the Semarchy License Server which will allow updates to your license to automatically apply to your instance.

    If you click CANCEL, you will need to manually apply license key changes to your instance, including annual updates.

If you see this screen, it means you have successfully registered your instance and your license key is valid.


You got a license key and registered your xDM instance to use it beyond the 7-day trial window. In this part, you learned how to:

There are common issues that customer may run into. Your question may be answered in this section. If you run into problems that are not addressed in his FAQ, please contact Semarchy Support.

The license key expired and is not auto-updating

If you have auto-sync turned on and your license key expires, there could be a problem with your instance synchronizing with the license server.

Try these 3 troubleshooting tips to update the server:

  1. Does Auto-Sync work? Check that your server has access to the Internet.
  2. Click SYNC NOW. Does the Manage License information update? If not, check that your server has access to the Internet.
  3. Go to the License Server and request a new license key by choosing the "Send License Key" option. Go back to this Manage License page and click UPDATE. Paste the license key JSON string you will have received in your email

I never received any emails from Semarchy about my license key

When I create an account, I cannot see any licenses granted to me

There might be a problem cross-referencing the email address you used. Are you using a different email address, such as name@company.com versus name@thecompany.com? This has happened before. Please try a different email address that your organization may use. If you still do not see any licenses, contact Semarchy Support.

What does Auto-Sync do?

Auto-sync automatically updates your license information on your instance. This is useful for keeping your licenses up to date. The auto-sync process also collects some license and data usage information. For more details on what the License Server Synchronization process entails, email Semarchy Support.

I have a .SEMKEY license key file. When I want to activate a license, I can't upload any files, only paste a key. How can I use this file?

You may have a license key file with a SEMKEY extension. The file with a .semkey suffix is used for installations of xDM running on versions 4.x and 5.0. For v5.1 and beyond, there is a new licencing mechanism using the Semarchy License Server.

If you are running xDM v5.1 and beyond, you must use the new License Server mechanism to register your xDM instance and request a license key. Follow the instructions above in this tutorial to activate your xDM instance.

You can also communicate with the person in your organisation who administers the licence and ask for help.

After I accept the End-User License Agreement, I am asked to upload a license key instead of installing a repository. How do I register this instance and upload a license key?

You must be running a version 5.0 or earlier of xDM before Semarchy implemented the License Server. You have two options:

  1. Upgrade to the latest version of xDM, v5.1 or beyond and follow the steps in this License Key tutorial.
  2. Discuss whether you need a .semkey license key with the Semarchy sales team (unlikely to happen, see option 1).

How do I get back to the Manage License page?

Go to the About section in the Application Builder.

Go to the Manage License link.

I tried to log in but I ran into this error message. What do I do?

Try logging in again. If you continue to struggle, email Semarchy support to report your problem.

You learned to add a license key to your new xDM instance. Let's summarize:

Great job going through this tutorial!

Now that you have set up xDM, you can continue to other tutorials.

The next step is to proceed to two different tutorial tracks:

  1. How to use xDM applications as a business user, following the Product Retail Demo and the Customer B2C tutorials
  2. How to design applications as a developer, following the Data Authoring and Data Consolidation tutorials.

Go back to the main menu to find these tutorials.


Go further with xDM

This tutorial taught you how to install xDM. xDM is capable of addressing all types of data, including customer data, location data, reference data, organization data, supplier data, and other domains.

Visit our website to learn about the different solutions we provide.