Table of Contents

Installing a DMS Dashboard Gateway

Important

This information is applicable to the DMS Dashboards module, which is being retired as of DataMiner version 10.4.x. See DataMiner functionality evolution and retirement. We recommend using the Dashboards app instead.

It is possible to give users access to the legacy DataMiner Dashboards even if they do not have access to DataMiner, by means of a DMS Dashboard Gateway.

For a Dashboard Gateway to function correctly, an additional Windows component, Internet Information Services, must also be installed. On some Windows versions this is installed by default, but on others you will need to install it yourself.

Installing a Dashboard Gateway on Windows Server 2012

To install a Dashboard Gateway on Windows Server 2012, you must first install IIS, then install the dashboards, configure IIS, and finally configure the web.config file.

Installing IIS

  1. Go to Start > Server Manager.

  2. On the Dashboard page, click Add roles and features.

  3. In the Add Roles and Features Wizard, click Next to go to the Server Roles step.

  4. On the Server Roles tab, select Web Server (IIS) and Management Tools.

  5. Expand the Application Development node to select ASP.NET 3.5, ASP.NET 4.5, .NET Extensibility 3.5, and .NET Extensibility 4.5.

  6. Click Install to start the installation process.

  7. After the installation, which can take a few minutes, open the start menu and type "iis manager" to open the Internet Information Services (IIS) Manager.

  8. In the navigation menu on the left, select Application Pools.

  9. Right-click the DefaultAppPool and select the item Advanced Settings.

  10. In the Process model section, set the item Idle Time-out (minutes) to 0 and click OK to confirm.

  11. Right-click the DefaultAppPool again and select the item Recycling.

  12. Disable the property Regular time interval (in minutes).

Installing the dashboards

  1. Copy the directory C:\Skyline DataMiner\Webpages\Dashboards from the DataMiner Agent to a location on the DataMiner Gateway, such as C:\Skyline DataMiner.

  2. Remove all the files and subfolders in the directory ...\Dashboards\db.

Configuring IIS

  1. Go to Start > Control Panel > Administrative Tools > Internet Information Services (IIS) Manager.

  2. Click the root (name of the DataMiner Gateway) and select Feature Delegation.

  3. For the items Handler Mappings, Modules, Authentication - Anonymous and Authentication - Windows, change the delegation from Read Only to Read/Write.

  4. In the navigation menu on the left, select COMPUTERNAME > Web Sites > Default Web Site.

  5. Right-click and select Add Virtual Directory.

  6. Fill in the alias, "Example dashboards", and the correct path to the dashboard folder.

  7. Right-click the new item and select Convert to Application.

  8. Click OK.

  9. Select COMPUTERNAME > Web Sites > Default Web Site > Dashboards in the navigation menu on the left.

  10. In the HTTP Features section of the Feature View tab, double-click the item Mime Types.

  11. To the list of Mime Types, add the Mime Type fcss by right-clicking in the list and selecting Add.

  12. Choose the file name extension fcss and the Mime Type text/plain, and click OK to confirm.

Configuring the web.config file

  1. In DataMiner, create a new user profile with access to all elements in the DMS. The user also has to have the permission Modules > System configuration > Tools > Admin tools. See Adding a user.

    Note

    This user will be used by the Dashboard Gateway to access the DMA. The username and password of this user will be used in step 4 of this procedure.

  2. On the Dashboard Gateway, open the file web.config with Notepad.

  3. In the file, search for the term appName = "Dashboard".

  4. Change the attributes from the "add" tag from:

    <add id="local" connectionstring="localhost" description="Local DataMiner Cluster">
    

    to:

    <add id="local" connectionstring="[IP DMA]" user="[name dashboard user]"
    password="[password of Dashboard user]" description="Dashboard DMA">
    

Installing a Dashboard Gateway on Vista Server

To install a Dashboard Gateway on Windows Vista Server, you must first install IIS, and then install the dashboards.

Installing IIS

  1. Go to Start > Control Panel > Programs and features.

  2. Click Turn Windows features on or off.

  3. In the feature list, select Internet Information Services.

  4. In the World Wide Web subdirectory Application Development Features, select the following features:

    • .Net Extensibility

    • ASP

    • ASP.NET

    • ISAPI Extensions

    • ISAPI Filter

  5. Also under World Wide Web, select the checkbox of the directory Security.

  6. Click OK to start the installation.

  7. After the installation, which can take several minutes, go to Start > Control Panel > Administrative Tools > Internet Information Services (IIS) Manager.

  8. In the navigation menu on the left, select Application Pools.

  9. Right-click the DefaultAppPool and select the item Advanced Settings.

  10. Set the item Idle Time-out (minutes) in the Process model section to 0 and click OK to confirm.

  11. Right-click the DefaultAppPool again and select the item Recycling.

  12. Disable the property Regular time interval (in minutes).

Installing the dashboards

  1. Copy the directory C:\Skyline DataMiner\Webpages\Dashboards from the DataMiner Agent to a location on the DataMiner Gateway, such as C:\Skyline DataMiner.

  2. Remove all the files and subfolders in the directory ...\Dashboards\db.