The Dashboard is still an experimental feature which will gradually replace the existing Frontend. Both applications and services can be installed simultaneously but need different ports for IIS to run in parallel. Advantages of the Dashboard are: 

  • Leaner interface, easier to modify and manage
    • Dashboards can be public or personal
    • Dashboards are always assigned to an Organization Unit
  • Dashboards have a owner (creator) which can: 
    • Set public (no login required)
    • Change all Properties
    • Can delete
  • Optional Support for Power-BI Reporting
     This requires a BI-Pro account and shared URL. (info) Refer to: Managing BI User and Data access.

Installation

Execute the following installation steps:

  1. Locate the "LUCS.Dashboard.Setup.msi" (may come within a subfolder called "LUCS.FE.Site.WebSpa.Setup")

  2. Run the installation wizard

  3. On the opened "Welcome" screen: Click Next. 

    LUCS – Dashboard setup wizard

  4. On the opened "Destination Folder" screen:

    1. Enter the path, where LUCS Dashboard should be installed.

    2. Click Next.

  5. On the opened "Configuration settings" screen:

    1. Enter the settings according to your infrastructure setup. Example is in the table below.

      Example Dashboard Configuration Settings

    2. The LUCS front end installation wizard settings are explained in the table below:

      Key in LUCS Configurator

      How to get the value

      Instance Name

      Server instance name

      (info) The setting is stored in: C:\Program Files\Luware AG\LUCS-Dashboard\AppSettings.config as

      <add key="InstanzName" value="LUCS"/>

      Port Number

      Server-internal communication port number

      (info) The setting is stored in: C:\Program Files\Luware AG\LUCS-Dashboard\AppSettings.config as

      <add key="PortNumberToAdd" value="3500"/>

      Site Port Number

      Enter the site port number for the external site access .

      (lightbulb) The port number 80 is recommended for http and 443 for https.

      (warning) The used site port number should be not used by other sites, e.g. by FE - Frontend.

      (info) The setting is stored in: IIS (Internet information services, see post-installation verification chapter below).

      Security Protocol

      (Selection)

      Choose between http and https

      (info) The setting is stored in: IIS (Internet information services, see post-installation verification chapter below).

      System Administrator Group

      Enter the distinguished name value of the System Administrator Group from Active Directory

      In the following format without spaces:

      CN=GroupName,OU=OrganizationalUnitName,OU=OrganizationalUnitName,DC=DomainComponent,DC=DomainComponent
      CODE


      The setting is stored in      :       C:\Program Files\Luware AG\LUCS-Dashboard\AppSettings.config as

      <add key="SystemAdministratorGroup" value="CN=LUCS2,OU=LUCS2,OU=Development,DC=dev,DC=local"/>

      User Domain

      If the "User Domain" field is empty:

      • If user enters his login on FE without domain → the system uses the domain, where FE is installed.
      • If user enters his login on FE with a domain → the system uses the entered by the user domain.

      If the "User Domain" field is filled:

      • If user enters his login on FE without domain → the system uses the domain from the "User Domain" field.
      • If user enters his login on FE with a domain,→ the system uses the entered by the user domain.


      The setting is stored in: C:\Program Files\Luware AG\LUCS-Dashboard\AppSettings.config as:

      <add key="UserDomain" value="dev.local"/>

      Disable Windows Authentication

      If the check box is "true",  windows credentials are not applied automatically and user will be redirected to Login page.

      (lightbulb) By default is set to "false".

      (info) Refer to Optional FE Access Scenarios →  "Client Certificate ..." chapters if you want to use this feature.

      Configure Certificate Security

      If the check box is "true"  the certificate settings has to be defined during the installation:

      • server settings specify which settings other services will use while connecting to FE and FE Core

      • client settings specify which settings FE and FE Core will use while connecting to PS

      (info) Note: The system reports all errors related to  connection or certificate issues to a log file under:
      "C:\Program Files\Luware AG\LUCS-ICH\log\connectionIssues.log"

      PowerBI.com Report URL

      (optional)

      (tick) Precondition: Needs to be generated as described in Managing BI User and Data access. 

      Field to specify the shared BI Report URL needed to display Dashboard Reporting via embedded 

      (lightbulb) The URL can be changed later via appsetting.config if not known during installation. Can be left empty if no BI features are used.

      (info) This allows select LUCS users (with Power BI Pro account) to access Dashboard Reporting when corresponding Role Based Access - RBAC "Reporting" permissions were granted. 

  6. Click "Next" → Installation procedure will commence.

  7. Once all files are installed you can click "Finish" to complete the installation.

Post-Install Verification  

  • All the settings are automatically saved in the app settings file (default path: "C:\Program Files\Luware AG\LUCS-Dashboard\AppSettings.config"). When this file already exists from a previous installation, the settings in the next installation are pre-populated.
  • After the installation a new "Luware-LUCS-DashboardCore" service should be present in your Task Manager. If not started, start it manually. (question) If the service stops again or won't start at all, check the log files.
  • You can start Windows "Internet Information Services" (ISS) to check if the Dashboard is running and accessible via the "Browse" link under the Port you specified during installation.

Follow-Up Steps

At this point you may want to: