Setting Trial License key(s)

ARTICLE CONTENTS
Developer licenses
Trial licenses

• How trial licenses work
• Obtaining a license key
• Setting the license key from the auto-generated LicenseFile.xml
• Setting the license key manually
• Using a single LicenseFile.xml for several Telerik controls
• Changing the location of the LicenseFile.xml
• Trial error messages
• Troubleshooting

Developer licenses come with modified DLLs, which work without license keys. If you have a Developer license for one or more of the Telerik components, you only need to ensure that you are using the developer build when downloading the control(s). These builds have the Dev abbreviation in their file names.

If your application is displaying a license key error, this means that you are using a trial version of the product. Log in to your www.mcmscontrols.com account and download the developer build. To update your project, please take a look at the Upgrading the Trial License to a Production License section in the HELP manual(s) for step-by-step instructions.
 

Trial Licenses

The free trial licenses of all Telerik products are fully functional and will work for an unlimited time without license keys when used on http://localhost and http://127.0.0.1.
  

How trial licenses work
 
The license information for all Telerik components is stored in a LicenseFile.xml file. The structure of the file is as follows:

All trial versions of the Telerik controls come with an empty LicenseFile.xml file, located the RadControls folder of the control:

• If you have installed RadEditor from the EXE file, you can locate the LicenseFile.xml file in
  C:\Program Files\Microsoft Content Management Server\Server\IIS_CMS\RadControls
• If you have used the ZIP file to install the control, the LicenseFile.xml will be in the folder where you have installed the controls, usually
  <your MCMS Web application>\RadControls\

Additionally, all trial versions have a LicenseFile property, which is preset to point to the empty LicenseFile.xml file, located in the RadControls folder of the control,i.e.

Obtaining a license key

To run the trial version of RadEditor outside localhost, and to remove the copyright messages, you need to obtain and set a trial license key. The license key is valid for 30 days from the date of creation and can be extended for another 30 days from your www.mcmscontrols.com account, if needed. To obtain a license key:

1. Log in your www.mcmscontrols.com account.
2. Go to My licenses and click on License Key beside the product you need the keys for.
3. Complete the fields for IP and Domain. Please, review the Guidelines for specifying domain names in order to provide proper domain names.
4. Click the Generate button. The key will be generated immediately and will also be sent to your e-mail in a file, named LicenseFile.xml. You will also see the generated XML file right away.
     

Setting the license key from the auto-generated LicenseFile.xml

1. Locate the empty LicenseFile.xml file mentioned above and delete it.
2. Copy the LicenseFile.xml you have received in your mailbox and paste it in the RadControls folder. This step will remove the trial message. If you still see the copyright message, review the Troubleshooting section below. 
    

Setting the license key manually

1. Locate the empty LicenseFile.xml file mentioned above (if the file is missing, create an empty one).
2. Open the file, delete all information from within and copy the new licensing information from your www.mcmscontrols.com account when creating the license key. The format should be as follows:
    
   

   <root>     <license control="editor" company="YOUR COMPANY" licenseKey="YOUR LICENSE KEY1"/> </root>

    
3. Save the LicenseFile.xml file.
4. Locate and open the aspx/ascx file which has a reference to Radeditor MCMS edition, find an instance of the control and input the following LicenseFile property:
    

   <Telerik:RadEditorplaceholdercontrol LicenseFile="~/RadControls/LicenseFile.xml" ...> </Telerik:RadEditorplaceholdercontrol>

   
   NOTE: the ~ (tilde) represents your application's root directory.
   

    

5. Once you do that, the copyright message should disappear. If you still see the copyright message, review the Troubleshooting section below.
    

Using a single LicenseFile.xml for several Telerik controls

You can use a single LicenseFile.xml for every instance of the editor which you use within this aspx/ascx file. If you are using another aspx/ascx file which has reference to the editor, open the file and input the LicenseFile property in it as well.

You can use a single LicenseFile.xml for all Telerik controls as well - just set the other control(s) to use the already created LicenseFile.xml by setting the LicenseFile property. Below is the LicenseFile.xml convention:

Changing the location of the LicenseFile.xml

You can change the license file’s location and name by setting a valid path and file name in the LicenseFile property, for example:

In this example, all licensing information should be located in a file, named MyLicenseKey.xml, which is not located in the RadControls folder.
 

Trial error messages

If no licenses keys are set, the trial licenses will occasionally display the following message on your webform:
Radeditor 6.x.x Copyright © Telerik 2006. To remove this message, please, obtain a 30-day trial key.

Also, if no licenses keys are set and you try to access RadEditor by IP (e.g. http://123.123.123.123), domain name (http://www.MySite.com), or machine name (http://MyPc/MyWebApplication), you will receive the following license key warning:
Radeditor 6.x.x. You have not provided valid license key or company name, or you are trying to access the control by domain name, IP, or server name. Please, use http://localhost/ instead or contact Telerik's support team through the on-line ticketing system.
 
The same error shows up if you try to acces the control by an IP or domain name/machine name other than what you have already set for the trial key.

If your trial key has expired, you will see the following error message:
RadEditor 6.x.x Copyright © Telerik 2006. Your trial key has expired. To extend your key, please click here.

 
Troubleshooting

If you see the copyright message after the trial key is set:

1. Check whether the license key has not expired. This can be done from your www.mcmscontrols.com account --> My free trials. If the key has expired, you can extend it for another 30 days. In case you need more time to evaluate our products, contact our support staff and we will extend the key for you.
    
2. Check whether the the keys are created correctly - review Guidelines for specifying domain names to check whether the key(s) are created correctly. If not, contact our support staff and ask for resetting the key.
    
3. Check whether the control is accessed via the URL encoded in the key. You can check this from
   your www.mcmscontrols.com account --> "My licenses" --> " RadEditor --> "License Key". If the URL is different, contact our support staff and ask for resetting the key.
    
4. Check whether the control finds the proper LicenseFile.xml. When set correctly, the LicenseFile.xml can be viewed in your browser by using one of the following URLs (substitute the bold fields with the correct ones):
   • http://www.mydomain.com/ApplicationName/RadControls/Licensefile.xml
   • http://myIP/ApplicationName/RadControls/Licensefile.xml
   • http://machinename/ApplicationName/RadControls/Licensefile.xml
       
5. If you still experience problems, contact our support staff and give them details about the problem at hand.