416.467.9100 | Dundas Data Visualization | Login
Welcome Guest
This is the support page for the legacy Dundas Dashboard application. For assistance with the current Dundas BI application please click here.
Dashboard v5.0

This site makes extensive use of JavaScript.

Please enable JavaScript in your web browser and reload the page before proceeding.

Dundas Dashboard Licensing

Hide navigation
Modified on Thu, 21 Nov 2013 12:05 PM Categorized as Administration, Licenses
Click to return to: Documentation | Installing and Administering Dundas Dashboard

How licensing works

Dundas Dashboard licenses are installed on the server, and are specific to that server. If a valid license isn't present on the server, Dundas Dashboard will not start.

Each license file specifies the number of Dashboard Designer, Dashboard Developer and Viewer Access licenses available to the server. If the number of Dashboard Designer or Dashboard Developer accounts exceeds the number in the license, Dundas Dashboard will start but only the “admin” user can log in.

  • Dashboard Designer and Dashboard Developer licenses must be assigned to specific local or Windows user accounts, they cannot be assigned to Windows domain groups.
  • Viewer Access Licenses (VALs) can be “named” or “floating.” Named licenses are assigned to specific local or Windows domain user accounts and guarantee that the user will be able to log in and view dashboards. The remaining, floating licenses can be used by any session limited to viewing dashboards.
  • Named license users can only be logged in from one computer at a time. Logging in from another computer will give them the option of canceling or continuing, which will log them out of the other computer.

Note: Disabled accounts do not consume any licenses.

License types

Dashboard Developer

These users can change all aspects of dashboard projects and designs, including data and KPI definitions.

Tip: The default administrator is given the Dashboard Developer role (and license) by default upon installation. You can change the administrator's role to Viewer in order to free up the developer license for another user. See Managing Users for more details.

Dashboard Designer

These users can create and modify the design of dashboards (though they can't modify KPIs or data connections associated with them).

Viewer Access

These users can view the finished dashboards. Viewer Access licenses (VALs) are floating/concurrent licenses, so you aren't pinned down in naming all the users who will access the dashboards. All you have to do is determine how many users you need to access the system at any one time. If your demand grows, then simply purchase more licenses.

Tip: You can also assign a VAL to a specific user. This uses up one of the VALs, but that user can always log in to view dashboards.


The Dundas Dashboard Server License allows the licensee to install and use one instance of Dundas Dashboard on a server computer. For the exact details and conditions of the server license, please refer to the Dundas Dashboard License Agreement which you must accept when installing the software.

Licenses and roles

  • Dashboard Designer role — Dashboard Analyst
  • Dashboard Developer role — Dashboard Analyst and one or more of Data Connector Analyst, Virtual Data Structure Analyst, Dimension Analyst or Business Metrics Analyst.
  • Viewer role — No additional application privileges. Administrators may be assigned as viewers to conserve developer licenses.

License files

Dundas Dashboard licensing is controlled by a license file installed in the web application on the server. You don't need to install any license files on the client workstations because client licensing is handled automatically by the server. Each instance of Dundas Dashboard requires its own license file.

When you want to upgrade to a new version of Dundas Dashboard, you may need to obtain a new license file from Dundas (depending on the type of version you want to upgrade to). See Upgrading Dundas Dashboard for more details.

A license file can be applied during the installation process or afterwards by using the License Installer tool.

Obtaining a license file

Generally, you can download a new license file from the Dundas Support Site or contact your Dundas account manager to obtain a new license file.

To download license files, you must have a user account on the Support Site.

  1. Go to the Your Account page on the Dundas Support Site.
  2. Go to the Licenses tab and generate the license for the application version you want. Note that you must have the privilege to generate a license (obtained previously from your account manager).

The file that you download from the Support Site will be a PDF document. Open the PDF document, right-click the paper clip icon, and select Save Embedded File to Disk. This will save the actual license file to your computer.

The license file is named Dundas.Dashboard.lic.

Installing license files using the License Installer

Tip: You can launch the License Installer from the Programs menu for your Dundas Dashboard instance, under the Tools submenu.

To install the license file for a Dundas Dashboard instance:

  1. Navigate to the Dundas Dashboard installation folder where the License Installer can be found. The default location is: C:\Program Files\Dundas Data Visualization Inc\Dundas Dashboard\{InstanceName}\Tools\LicenseInstaller
  2. Launch the License Installer application (Dundas.Dashboard.LicenseInstaller.exe).
  3. Click the Browse… link to find and select your Dundas Dashboard license file, Dundas.Dashboard.lic.
  4. Select the Destination Path Type. You can choose to install the license file to a target Dundas Dashboard instance, or to a target folder.
    • If you chose the Dashboard Instance option, select the specific instance you want to install to from the dropdown list.
      License Installer instance option.
    • If you chose the Folder option, click the Select… link to select your Licenses folder. The default path should be: C:\Program Files\Dundas Data Visualization Inc\Dundas Dashboard\{InstanceName}\www\App_Data\Licenses
      License Installer folder option.
  5. Select Restart Dundas Dashboard Application to restart the application pool that Dundas Dashboard is running under in IIS. The restart will occur after the license file has been copied.
  6. Click Install.

Note: If you didn't select the restart option, you will have to manually restart the Dundas Dashboard website for the license changes to take effect.

Troubleshooting tips:

License file structure

License files (Dundas.Dashboard.lic) are XML documents:

1545d638-0e04-4186-88b2-c06509cba0da Dundas Data Visualization, Inc. Retail 1 0 0 0 9999-12-31T23:59:59.9999999 2147483647 2147483647 32767 32767 true 549A1B2C0E8151E69BC97A617036F0D78E81EAE89D9C837FBA45 FabcdGtIbOQSIx/EzJUi9mXB5TWSXZe1GDfF7eq7OtkOAkttwZ3eJXRCcFUtWw==

Dashboard license files have at least the following elements:

  • <Accepted> — Records whether the end-user licensing agreement for Dundas Dashboard was accepted or not.
  • <ApplicationLicense> — Container for the license information.
  • <Checksum> — A checksum to ensure that the license contents haven't changed.
  • <ExpiresAt> — The date/time when this particular license expires.
  • <Licensee> — Who this license was issued to.
  • <LicenseKey> — The license key associated with this license.
  • <LicenseType> — The type of license, Evaluation or Retail. Other values are reserved for Dundas' use.
  • <MaxDashboardDesignerAccounts> — The number of Dashboard Designer licenses available.
  • <MaxDashboardDeveloperAccounts> — The number of Dashboard Developer licenses available.
  • <MaxProcessors> — The number of CPU cores allowed by this license. Currently ignored.
  • <MaxViewerSessions> — The number of Viewer licenses available.
  • <Signature> — The digital signature associated with this license.
  • <VersionBuild> — The build number associated with this version of Dundas Dashboard.
  • <VersionMajor> — The major number associated with this version of Dundas Dashboard.
  • <VersionMinor> — The minor number associated with this version of Dundas Dashboard.
  • <VersionPrivate> — The private number associated with this version of Dundas Dashboard.

The <Version*> elements define the highest version of Dundas Dashboard that this license will support.

Editing a Dundas Dashboard license file will render it invalid. If this happens, please contact your sales representative.

Exceeding license limits

It is possible for the license limits of your Dundas Dashboard installation to be exceeded after installing a license file that downgrades the number of available designer/developer licenses. In this case, designers/developers will not be permitted to log in. However, the default administrator will always be allowed to log in so that he/she can adjust user roles to match the updated license limits.

License limits exceeded.

License limits exceeded.

Licensing API

For server add-on (&ie; plug-in) developers:

  • Use the ILicenseProvider interface to provide a custom implementation of application licensing.

Related topics

Click to return to: Documentation | Installing and Administering Dundas Dashboard

About Dundas | Contact Us Follow us on Twitter! | Privacy Statement | Report Site Issues

Copyright © 2009-2014 Dundas Data Visualization, Inc.