License - A license grants you the right to use Semarchy xDM. It may be a trial license or a customer license. It determines the duration that you may use Semarchy and any limits like the data volume you are licensed for.
Instance - One installation of Semarchy xDM. To be precise, one repository installation of xDM.
License Key - A JSON string which authorizes one instance of xDM to use a specified license.
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.
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.
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.
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.
Copy and paste the license key from the email.
Paste the license key into the step that prompts for the license key.
Activate the license key.
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:
Create an account on the Semarchy License Server.
Request a trial license if you don't already have a license assigned to your organization.
Request a license key.
Add your license key to your xDM instance.
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:
Does Auto-Sync work? Check that your server has access to the Internet.
Click SYNC NOW. Does the Manage License information update? If not, check that your server has access to the Internet.
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
Check your spam folder.
Check that you entered your email correctly when you signed up for an account on the License Server.
Do you have a Semarchy admin at your organization who is responsible for your license keys? Email this person to ask if they have received any emails from Semarchy.
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 email@example.com versus firstname.lastname@example.org? 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:
Upgrade to the latest version of xDM, v5.1 or beyond and follow the steps in this License Key tutorial.
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:
You created an account on the Semarchy License Server.
You requested a trial license if you are evaluating Semarchy.
You registered your xDM instance and received a license key.
You added your license key to your xDM instance.
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:
How to use xDM applications as a business user, following the Product Retail Demo and the Customer B2C tutorials
How to design applications as a developer, following the Data Authoring and Data Consolidation tutorials.
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.