Updating RadControls for ASP.NET to another version or license

Article information
Article relates to	all Telerik ASP.NET controls and versions
Created by	Robert, Telerik
Last modified	March 05, 2010
Last modified by	Sebastian, Telerik

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.
2. Go to Downloads (or Free trials if you are a trial user).
3. Locate the RadControls for ASP.NET AJAX and click on the Source Code, Manual Installation, Examples... link.

   4. Download the HOTFIX ZIP (aka DLL and Scripts 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. (New to Q1 2009): 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,runtimeVersionv2.0" />

   <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,runtimeVersionv2.0" />

   <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,runtimeVersionv2.0" />

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

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

   </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.

SOLUTION

Below are the instructions on how to upgrade Telerik's RadControls Classic to another version or license:

1. Log in from your account.
2. Go to Purchases and Downloads (or Free trials if you are a trial user).
3. Locate the RadControls for ASP.NET tab and expand it to reveal the available options. Navigate to RadChart for example. Don't use the RadControls ZIP file as it contains EXE versions of the controls only
4. Click on the Download tab and download the HOTFIX ZIP (aka DLL and Scripts only) file. Before the download starts, the page should look similar to this screenshot:
   
5. Once the download completes, unzip the files at a convenient location.
6. If the upgrade is major (i.e. from v2.x to v3.x), please check the HELP manual of the new version for Changes and Backward Compatibility as some new versions are not backwards compatible with the older ones.
7. Backup your application.
8. Backup all customized files such as ConfigFile.xml, ToolsFile.xml for RadEditor, custom skins, etc.
9. From the newly downloaded ZIP files, copy the new DLL (located in the bin folder) to your web-application's bin folder. Replace the old dll.
10. Locate the old RadControls/<Control> folder and delete it manually, i.e. using Windows Explorer. Copy the RadControls/<Control> folder from the distribution in your project's RadControls folder.
11. If using VS.NET, update the control's reference in your project to point to the new DLL and recompile.
12. If you have added the control in GAC, remove it by running a gacUtil to remove the old copy and then add the new one.
13. Restore your customized files if needed.
14. Run the project.
15. If you still get the older version then do the following (not related to Telerik controls):
    • Sometimes the .NET Framework wrongly caches the RadControls' DLLs 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....

NOTE

Please don't forget that when using a hotfix and changing the RadControls folder, you will need to add permissions for the ASP.NET Machine account to access the folder. You can find this information in the help documentation for all controls.