Updating RadControls for ASP.NET AJAX to another version or license

HOW-TO

Update Telerik's controls to another version or license.

SOLUTION

Below are the instructions on how to upgrade Telerik's RadControls for ASP.NET AJAX to another version or license:

1. Log in from your account and click on Manage products from the top menu.
2.  In the dropdown that appears choose from your purchased products or trial downloads the Telerik RadControls for ASP.NET AJAX, and click on it. If you have purchased a collection you would need to click on it and the trial downloads page will show all trial downlads directly.
3. Click on Download Installer and other resources (the Download link next to the suite if you are a trial user). You need to choose the RadControls for ASP.NET AJAX suite if you have purchased the collection and click on the Browse all product files link.

 

   4. Download the HOTFIX ZIP (aka DLL, Scripts and Skins only) file. Before the download starts, the page should look similar to this screenshot:

1. Once the download completes, unzip the files at a convenient location.
2. If the upgrade is major (i.e. from one quarterly release to other quarterly release), please check the HELP manual and the general Changes and Backwards Compatibility topic in it (residing under the Controls chapter) or the relevant Changes and Backward Compatibility topics for each control linked at the bottom of the same article. Some new versions may not be backwards compatible with the older ones.
3. Backup your application.
4. Backup all customized files such as ConfigFile.xml, ToolsFile.xml for RadEditor, custom skins, etc.
5. From the newly downloaded and unzipped files, copy the new DLL (located in the binXX* folder) to your web-application's bin folder. Replace the old dll.
   *binXX folder - contains the RadControls assemblies (.dll files), where XX represents the version of the .NET framework against which the assemblies are built.
6. If you are using the installer - it will add the Telerik.Web.Design.dll assembly to the GAC. If you are not using it - you need to manually add the assembly in the GAC. Please check this blog post for more information.
7. If using VS.NET, update the control's reference in your project to point to the new DLL and recompile.
8. If you have added the Telerik.Web.UI assembly in the GAC (Global Assembly Cache), remove it by running a gacUtil to remove the old copy and then add the new one. How to operate with GAC and gacUtil you can learn from the following online resources:
   • GAC basics
   • gacUtil usage
   • Adding a control to the Global Assembly Cache

9. Make sure that you do not specify the version through the fully qualified name of the following http handlers/modules in your web.config file (thus they will operate properly with each new version of Telerik.Web.UI.dll):

   IIS 7 Integrated mode

   <system.webServer>

   <modules>

   <add name="RadUploadModule"type="Telerik.Web.UI.RadUploadHttpModule, Telerik.Web.UI" preCondition="managedHandler" />

   ...................................

   </modules>

   <handlers>

   <add name="ChartImage.axd_*" path="ChartImage.axd" verb="*" type="Telerik.Web.UI.ChartHttpHandler, Telerik.Web.UI, Culture=neutral, PublicKeyToken=121fae78165ba3d4" preCondition="integratedMode" />

   <add name="Telerik.Web.UI.SpellCheckHandler.axd_*" path="Telerik.Web.UI.SpellCheckHandler.axd" verb="*" type="Telerik.Web.UI.SpellCheckHandler, Telerik.Web.UI, Culture=neutral, PublicKeyToken=121fae78165ba3d4" preCondition="integratedMode" />

   <add name="Telerik.Web.UI.DialogHandler.aspx_*" path="Telerik.Web.UI.DialogHandler.aspx" verb="*" type="Telerik.Web.UI.DialogHandler, Telerik.Web.UI, Culture=neutral, PublicKeyToken=121fae78165ba3d4" preCondition="integratedMode" />

   <add name="Telerik.RadUploadProgressHandler.ashx_*" path="Telerik.RadUploadProgressHandler.ashx" verb="*" type="Telerik.Web.UI.Upload.RadUploadProgressHandler, Telerik.Web.UI" preCondition="integratedMode" />

   <add name="Telerik.Web.UI.WebResource.axd_*" path="Telerik.Web.UI.WebResource.axd" verb="*" type="Telerik.Web.UI.WebResource, Telerik.Web.UI" preCondition="integratedMode" />

   </handlers>

   <validation validateIntegratedModeConfiguration="false"/>

   </system.webServer>

   IIS 5.x/6.x/7.x

   <httpHandlers>

   <remove verb="*" path="*.asmx" />

   ...................

   <add verb="*"path="Telerik.RadUploadProgressHandler.ashx" type="Telerik.Web.UI.Upload.RadUploadProgressHandler, Telerik.Web.UI" />

   <add verb="*"path="Telerik.Web.UI.DialogHandler.aspx"type="Telerik.Web.UI.DialogHandler, Telerik.Web.UI, Culture=neutral, PublicKeyToken=121fae78165ba3d4" />

   <add verb="*"path="Telerik.Web.UI.SpellCheckHandler.axd" type="Telerik.Web.UI.SpellCheckHandler, Telerik.Web.UI, Culture=neutral, PublicKeyToken=121fae78165ba3d4" />

   <add verb="*"path="ChartImage.axd"type="Telerik.Web.UI.ChartHttpHandler, Telerik.Web.UI, Culture=neutral, PublicKeyToken=121fae78165ba3d4" validate="false" />

   <add path="Telerik.Web.UI.WebResource.axd"verb="*"type="Telerik.Web.UI.WebResource, Telerik.Web.UI" validate="false" />

   </httpHandlers>

   <httpModules>

   <add name="RadUploadModule"type="Telerik.Web.UI.RadUploadHttpModule, Telerik.Web.UI" />

   ...

   </httpModules>

10. Restore your customized files if needed.
11. Run the project.
12. If you still get the older version then do the following (not related to Telerik controls):
    • Sometimes the .NET Framework wrongly caches the RadControls' DLL (Telerik.Web.UI.dll) and therefore the update may seem to have failed. Try the following to ensure that this has been the exact problem and eliminate it:
      1. Terminate the aspnet_wp.exe process (from the Windows Task Manager)
      2. Open a Windows Explorer and navigate to
         C:\Windows(WINNT)\Microsoft.NET\Framework\vYOUR_VERSION\Temporary ASP.NET Files
      3. Delete all the folders with names, corresponding to your Telerik projects, containing RadEditor, RadTreeView, etc.
    • Delete your Visual Studio web project caches as well - they should be located at C:\Documents and Settings\<YOUR USER>\VSWebCache.
    • Delete your browser cache: Tools -> Internet Options -> Delete Files....
13. In case you upgrade from a trial to a dev version and still get the copywrite message:
    
    The copyright message appears only when using the trial version of Telerik.Web.UI.dll (the Developer versions of Telerik's controls do not throw copyright messages). Make sure you have downloaded the proper, Developer "DLL and Scripts only" file. You will recognize it by the Dev abbreviation in the file name.