License Registration Errors
Most non-trial MTP/IP software requires a valid license code. This
code is typically entered once when the software is first installed and
then saved for future operation.
Refer to the Setup chapter of your product documentation for more information about how to register a license code.
If a license code is not valid, MTP/IP will return an error code and may display one of the following MTP0 diagnostic messages below.
- License not initialized
- You have purchased a host bound license, but have not yet completed the binding process. See Tech Note 0007 for details. If you have already provided binding information, make sure that you have downloaded and are running the bound software.
- Software does not match license
- The license code you entered does not match the application you are registering. For example, you may have entered a movedat license code into servedat.
- Host does not match license
- Some applications, commonly servedat, are bound to run only on a specific host machine. The license code you have entered is for a different machine than the one you are installing upon. See Tech Note 0007 for more information about host binding.
- Improperly formatted license code
- An MTP/IP license code consists of 16 hexadecimal characters, possibly with dashes or spaces separating them. For example: 1A1A-2B2B-3C3C-4D4D. The code you have entered does not fit this format. Verify that you correctly typed the correct code.
- The license period for this software has expired
- This most likely means that you are running a trial version of the software when you meant to be running a production version. See Tech Note 0012 for guidelines on upgrading from a Trial to a Production version.
- Configuration Error
- This may indicate that the license code you entered does not match the application you are registering, that the code was not typed correctly, or that there was a problem setting up a new license. Verify that you correctly typed the correct code. If the problem persists, contact DEI technical support for help.
- License not yet configured, software may require an update
- This indicates that you have entered a newly assigned license code into an older copy of the software. Download the latest distribution package from your customer site or verify with your administrator that you have the most recent package. See Tech Note 0012 for guidelines on updating MTP/IP software.
- License code required
- Either no license code was given, or it does not match any valid license configurations. Follow the steps below to correct the problem.
- Invalid license code
- If you just entered a license code and you receive this error without any other explanation, it means that the code you entered does not match any valid license configurations. Follow the steps below to correct the problem.
- If this error appears at run-time, after a seemingly successful installation, it may indicated a corrupted license file or a registry conflict. See License Files below for instructions.
Steps to Correct
Download the latest license code document from your customer site or verify with your administrator that you have the latest code.
Download the latest distribution package from your customer site or verify with your administrator that you have the most recent package. See Tech Note 0001 for guidance on determining the software version you are running.
Make sure that the license code you are using matches the software you are registering.
For host-bound server licenses, make sure that the host identifier of the system you are installing on matches that of the license. See Tech Note 0007 for more information about host binding.
Make sure that you are not trying to install a trial or older version of the software. See Tech Note 0012 for guidelines on installing new MTP/IP software over existing MTP/IP software.
Contact DEI technical support for help.
After an MTP license code is validated, a license token is stored in a host-specific file for future use. This token is specific to the CPU on which it was created and will not work if copied to other CPUs.
On unix systems, including Mac OS X, the license token will be saved in ~/.dei-mtp and copied into /etc/dei-mtp if this file is writeable. Tokens in /etc/dei-mtp register an application for all users of the system.
On Windows systems, the license token will be saved in the Current User class under dei\mtp\ and copied into the Local Machine class if that is writeable. A backup token will also be placed in the LocalAppData folder in the file dei\dei-mtp.dat.
When installing server software on a Windows system, do so while logged into a local Administrator account. Installing server software as a domain user may result in "Invalid license code" errors at run time.
If you change your hardware configuration, you may be required to re-enter your license code. For example, the first time you switch from an ethernet to a wireless network, you may need to re-enter your code.
If an application repeatedly asks for a license code, or if it fails to start with an "Invalid license code" error, then the license tokens may be corrupt or there may exist multiple conflicting codes. Check the locations cited above, including the Windows registry if applicable. If tokens already exist in one or more of these places, delete the token for the affected application from each location. Make sure you are logged in to a local administrator account and try installing and entering your license code again. Windows users must launch the installer by right-clicking and selecting "Run as Administrator". If the problem persists, delete all "dei-mtp" files and registry entries, then re-enter license codes for all installed MTP software.