Dundas.Dashboard.Deployment.InstallationTaskException: The database upgrader has failed.

Modified on Wed, 26 Feb 2014 04:58 PM by nikhilb@dundas.com — Categorized as: Errors, Troubleshooting


Dundas.Dashboard.Deployment.InstallationTaskException: The database upgrader has failed.
at Dundas.Dashboard.Deployment.Task.UpgradeDatabaseTask.UpgradeDatabase()
at Dundas.Dashboard.Deployment.Task.UpgradeDatabaseTask.RunTask()


This error is seen when an attempt to upgrade the dashboard instance fails. The error appears at the end of the installation log.


The known causes and their respective resolutions are given below in this article. However, each scenario is different and to know the exact cause of this failure, the datastore needs to be sent for investigation. Contact Dundas Support to get the upload details of the datastore. See this link on what information is sent with datastore in case there are any concerns: What does the project export contain?

The alternate options listed below can also be tried for upgrading.

Known reasons and resolutions

The known reasons for this error to appear are:

Upgrading options

The following options can also be tried out first in order to upgrade before sending the datastore:

Use Clone Existing Databases option

This option is under the installation section of the deployment center and will install a new instance and clone the old instance. After this process, both new and the old version will be running simultaneously. You can deactivate the old version instance if the cloning is successful. See this link for details on the cloning process: Clone existing databases

Use Project Manager

This option will require a new instance of the new version to be installed. Then export all the projects in the old version using the project manager and import them to the new instance:

How to install a new instance: Advanced Intallation
How to use the project manager to import/export the project between instances:
Project manager
Migrating the Projects and the Dundas Dashboard application

Using the DatabaseUpgradeUtility tool

Use the dashboard upgrader utility tool to upgrade your installation. See this link for details on this tool: DashboardUpgradeUtility The advantage of this is that it’s a command line utility and is different from the installer.

This option may not be necessary if the project manager option is used as both these options require a new instance of the new version to be installed first.

Before you try the steps below, make sure you have a copy of the datastore and sync databases. To use this tool, follow these steps (In this example, assume upgrading from v4.0 to v5.0):

Related Topics