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
.
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
- IIS Express
- IIS
IIS Express
IIS
Need to provide the Port number, Location and Application Name to host the Dashboard Server into the IIS.
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.
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
-
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
Note
By default, it will show a random port number. An unused port can also be chosen to host in that port.
- 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.
-
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
-
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 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.
And Fill the following details as below figure
- Alias name
- Application pool
- Physical path
Convert the sub folders as application
We have the following folders to be converted as application.
- API
- WindowsAuthentication
Right click the folder and choose Convert to Application
as below figure
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.
Choose the type of configuration required and click on Save
button.
Note
code192DashboardServiceConfigurationManager.exe requires administrator mode.