Upgrading to a newer version of Telerik Reporting

1. Uninstall the old version if you are installing a Service Pack, for example from Q3 2007 to Q3 2007 SP1. Even if you forget to remove the old version, when you start the installer of the Service Pack you will be prompted to do so.
2. Install the new version of Telerik Reporting.

Auto Upgrade

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.

Manual Upgrade

1. For all projects that need to use the new version of Telerik Reporting:
   • 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 (or write down) 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've deleted in the previous step.
     5. 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 to the new one (those files are not compulsory, so don't worry in case you do not have any .resx files) .
     6. 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
     7. Open your .aspx/.master pages and change the version of the ReportViewer in the Register directive
   • Class Library/Windows Forms/Web application project:
     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 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 to the new one.
     8. 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 attribute
                * <httpHandlers> - this is where the ReportViewer registers its handle
                * <assemblies> - the Reporting assemblies that are references in the web site
     9. Open your .aspx/.master pages (for web apps only) and change the version of the ReportViewer in the Register directive

    You can quickly find all occurrences of a Telerik Reporting assembly with the old version by doing the following:

• Go to Edit -> Find and Replace -> Find in Files.
• Look In = Current Project.
• Find What = “Version=<the old version here>”.
• Click Find All.
• All matches will appear in the Find Results Window. You can navigate to each one by double clicking it.
• Have in mind that the search string can find other occurrences of assemblies beside the Telerik ones if the version is the same (for example some .NET assemblies) so make sure you review each match carefully and change the version only if it is a Telerik Reporting assembly.

   3. Rebuild all updated projects.