Upgrading Report Server

To upgrade an existing Report Server installation, run a newer version of the Telerik Report Server Installer than the installed one.

Telerik Report Server installer replaces all files in the selected installation folder deployed by the previous installer, including the configuration files /Telerik.ReportServer.Web/Web.config and /Services/Telerik.ReportServer.ServiceAgent.exe.config.

The only configuration files in the installation folder that will be preserved after the upgrade are /Telerik.ReportServer.Web/ReportServerAdmin.config, /Telerik.ReportServer.Web/TelerikReporting.config, and /Services/ServiceAgent.config.

This way the previously configured assets storage will be preserved after the upgrade as well as any report generation engine configuration options applied in the /Telerik.ReportServer.Web/TelerikReporting.config file.

The installer has a step that backs up the assets' storage used from the Report Server. This step is optional and turned on by default. We recommend keeping it. On the first run after the upgrade, the Report Server will upgrade the assets storage schema version if necessary. Keep the backed-up assets' storage at least until the Report Server is up and running again.

Before upgrading the Report Server

We advise performing a file backup before upgrading. This is specifically recommended if you have changed the application configuration files /Telerik.ReportServer.Web/Web.config and /Services/Telerik.ReportServer.ServiceAgent.exe.config

IIS Settings

The Telerik Report Server settings applied in the IIS console, including the HTTPS bindings and AppPool identity, will be preserved if you are with version R3 2023 SP1 (9.2.23.1114) or later and upgrade to a newer version.

When upgrading from Telerik Report Server 9.2.23.1010 or older, you need to reapply the IIS Settings after the upgrade.

This means that if you need to automatically preserve the IIS Settings, first you need to upgrade to 9.2.23.1114 or later and reapply the settings.

Example:

• IIS settings will be lost

  When upgrading from 9.0.23.118 to 10.0.24.131

  When upgrading from 9.2.23.1010 to 9.2.23.1114

• IIS settings will be kept

  When upgrading from 9.2.23.1114 to 10.0.24.131

  When upgrading from 10.0.24.131 to 10.1.24.605

After upgrading the Report Server

After the upgrade progress has passed, open the Report Server Manager (the Finish button of the installer UI will do that by default). This will intrinsically trigger the upgrade of the assets storage schema version if necessary. When the manager loads the default Reports view of the Manager, this upgrade process has passed successfully.

Open the IIS manager and reapply the web application settings, including the Bindings, noted before the upgrade. Make sure the Telerik Report Server web application is working again.

The Report Server Manager is a web application and it is possible to have its styles and scripts cached by the browser, which may result in unpredictable behavior when upgrading or installing a new version. We recommend clearing the browser cache or force-reloading the page, usually with Ctrl+F5.