Installation and Deployment

This section explains on how to install and deploy the Code 192 Dashboard Server.

IIS Minimal required Features

The minimal required features to run the Dashboard Server are listed below

Section   

Features to be Enabled   

Screenshot   

.NET Framework 3.5

.NET Framework 3.5 (includes .NET 2.0 and 3.0)

HTTP Activation

Non-HTTP Activation

.NET Framework 4.5  

.NET Framework 4.5  

ASP.NET 4.5   

  

.NET Framework 4.5  

        WCF Services  

HTTP Activation  

TCP Port Sharing   

  

Web Server IIS  

    Web Server   

        Common HTTP Features   

Default Document   

Directory Browsing   

HTTP Errors  

Static Content   

  

Web Server IIS  

     Web Server   

           Health and Diagnostics  

HTTP Logging   

  

Web Server IIS  

       Web Server   

               Performance  

Static Content Compression   

  

Web Server IIS  

         Web Server   

                    Security  

Request Filtering   

Windows Authentication   

  

Web Server IIS  

       Web Server   

             Application Development   

.Net Extensibility 4.5  

ASP.NET 4.5  

ISAPI Extensions   

ISAPI Filters  

  

Web Server IIS  

       Management Tools   

IIS Management Console   

  

Installation

This topic details the steps required to install the Dashboard Server.

To learn about the system requirements needed to deploy the Dashboard Server in your business environment, see System Requirements.

After you run the Dashboard Server Installer, the extracting files window appears

Then, type in the unlock key that has been sent to your registered e-mail address. You can check the License Agreement of Dashboard Server by clicking on the License Terms and Conditions.

Installation Step 1

After you read the license agreement, click on Next to select the installation server type, location and the port number on where the dashboard server has to be hosted.

We have provided the Dashboard Server to be hosted into the following two web server types

  1. IIS Express
  2. IIS

IIS Express

Installation Location and IIS Port Changes

IIS

Need to provide the Port number, Location and Application Name to host the Dashboard Server into the IIS.

Installation Location, IIS Port Changes and Application Name

Dashboard Server will be installed with the below components in the mentioned installation location.

  • Dashboard Server web application
  • Scheduling Service

Once the installation completes you can start the dashboard server by checking the “Start Dashboard Server” in the last screen and click on finish.

Start Dashboard Server

Or you can also start the dashboard server from the shortcuts available in the desktop.

Desktop shortcuts will be provided for starting and stopping the dashboard server and for the dashboard designer.

Note

Dashboard Server does not support multiple versions installed on the same machine.

Deployment

  • Dashboard Server web application opens in your default browser with the specified port number at http://localhost:[port_number]/

We have shipped two utilities with the Dashboard Server to host the application in IIS and in IIS Express.

Host as website in IIS Express

  1. Run the program DashboardServerIISExpressWindows.exe from the following installed location to host the dashboard server in IIS Express.

    {Installed_ Location}\Code 192\Dashboard Server\Infrastructure\StartDashboardServer\DashboardServerIISExpressWindows.exe

    Host Dashboard Server in IIS

Note

By default, it will show a random port number. An unused port can also be chosen to host in that port.

  1. Click Submit and this program will host the application in IIS Express and Dashboard Server application will be launched in browser.

Host as website in IIS

Dashboard Server can also be hosted in IIS by following the below steps.

  1. Run the program DashboardServerIISWindows.exe from the following installed location to host the dashboard server in IIS

    {Installed_Location}\Code 192\Dashboard Server\Utilities\StartDashboardServerIIS\DashboardServerIISWindows.exe

    Host Dashboard Server in IIS

  2. Type in a unused port for the Dashboard Server and a name for your website name as like in the above image. This program will host the application in IIS and the Dashboard Server can be opened from the browse button in the IIS.

    Host Dashboard Server in IIS

Host as Application in IIS

Dashboard Server can also be hosted as Application in IIS by following the below steps.

Add Dashboard Server as application

Right click the Website hosted in IIS and choose Add Application as below figure.

Host Dashboard Server as application in IIS - Add Application

And Fill the following details as below figure

  1. Alias name
  2. Application pool
  3. Physical path

Host Dashboard Server as application in IIS - Add Application

Convert the sub folders as application

We have the following folders to be converted as application.

  1. API
  2. WindowsAuthentication

Right click the folder and choose Convert to Application as below figure

Host Dashboard Server as application in IIS - Convert to sub Application

Enable SSL

To enable SSL for the Dashboard Server application, you will need a valid SSL certificate. Please check the below link on how to Obtain an SSL certificate and install it to a website in IIS.

how-to-set-up-ssl-on-iis (external link)

Note

If you want to access Dashboard Server from a different machine to the one it’s installed on, use the URL http://machine_name:[port_number] or http://machine_ip_address:[port_number]

SSL for Dashboard Service

It is necessary to enable the SSL for the Dashboard Service if you have configured the SSL for Dashboard Server Application.

To configure SSL for Dashboard Service, run code192 Dashboard Service Configuration Manager application from the following location.

 {Installed_Location}\code192\Dashboard Server\DashboardServer.Web\DashboardService 

Choose the type of configuration required and click on Save button.

Note

code192DashboardServiceConfigurationManager.exe requires administrator mode.