Since Q2 2008, Telerik Reporting offers automatic upgrade for your report projects by using Telerik Upgrade Wizard. It is introduced as guide for the process of upgrading the projects and files of the current open solution to a newer version of Telerik Reporting. Make sure that before proceeding with the upgrade, you have the necessary access permissions to the solution folder and files. If the solution or some of its projects are under source control, make sure that the correct source control plug-in is active in Visual Studio and no files are exclusively checked-out by another user. Once you open a solution, the Upgrade Wizard would check what version of Telerik Reporting is used and if you have a newer one installed, it would offer to upgrade your application. Visual Studio would automatically popup the Upgrade Wizard on opening a solution and you can also manually start it from the Telerik Reporting Menu.

Web Site project:

1. In Solution Explorer, click the "Show All Files" button.
2. Delete all Telerik Reporting assemblies from the Bin folder.
3. From the References tab on the Web Site’s Property Pages remove all references to Telerik Reporting assemblies. Remember the names of assemblies that you delete.
4. Add all needed references to the new version of Telerik Reporting assemblies. They should be the same as the ones that you deleted in the previous step.
5. Open your web.config file and make sure that you change all versions to the new one in the following instances:
   • <configSections> - this is where you can alter the rendering extensions attributes
   • <httpHandlers> - this is where the ReportViewer registers its handler
   • <assemblies> - the Reporting assemblies that are references in the web site
6. Open your .aspx/.master pages and change the version of the ReportViewer in the Register directive
7. Open all report resource files (each .resx file appears under the respective report file) as XML. Locate all occurrences of a Telerik Reporting Assembly and update the version number to the new one. Unlike the version name (Q1 2008) a version number is a more technical identifier such as 2.5.8.414, for example.
8. Restart Visual Studio.
9. Rebuild all updated projects.

1. In Solution Explorer, click the "Show All Files" button.
2. Open the "References" node and locate the references to the old Telerik Reporting assemblies. In case you are installing a Service Pack you will notice that the Telerik Reporting assemblies have an yellow exclamation mark next to them, meaning that they cannot be located. That is because you have uninstalled the version that they belong to and is normal.
3. Select the old assemblies that you located in Step 3 and hit delete to remove them. Remember the names of assemblies that you delete.
4. Right-click on the "References" node and select "Add Reference".
5. Add all needed references to the new version of Telerik Reporting assemblies. They should be the same as the ones that you deleted earlier.
6. Now they should appear in the "References" node without yellow exclamation marks, meaning that they are valid.
7. Open your web.config/app.config file and make sure that you change all versions to the new one in the following instances:
   • <configSections> - this is where you can alter the rendering extensions attributes
   • <httpHandlers> - this is where the ReportViewer registers its handler
   • <assemblies> - the Reporting assemblies that are references in the web site
8. Open your .aspx/.master pages (for web apps only) and change the version of the ReportViewer in the Register directive
9. Open all report resource files (each .resx file appears under the respective report file) as XML. Locate all occurrences of a Telerik Reporting Assembly and update the version number to the new one. Unlike the version name (Q1 2008) a version number is a more technical identifier such as 2.5.8.414, for example.
10. Restart Visual Studio.
11. Rebuild all updated projects.