Installation
This section describes the installation of the IIS and MIKE OPERATIONS Web.
Prerequisites¶
The MIKE OPERATIONS website requires a MIKE OPERATIONS database containing a MIKE OPERATIONS real-time configuration.
Installation of the IIS on Windows 10 and Windows Server 2016¶
The following instructions outlines how to install IIS on a Windows 10 machine.
| Instructions | Screen |
|---|---|
| IIS in windows is an optional “Windows Feature”. To install it, press the Windows + R key combination to bring up a run box. Then type appwiz.cpl and press OK … |
 |
| This will open the Program and Features part of Control Panel, on the left hand side click on the “Turn Windows features on or off” link. |  |
| Now click on the Internet Information Services… check box. Expand it and make a selection of sub-components as shown if not yet selected. Click OK … Note: If you have an earlier version of ASP.NET than 4.7, use it. |
 |
| After clicking OK, the dialog will appear on the screen for a while. |  |
| When it’s done, press Close … to close the wizard and complete the installation. |  |
| When it’s done, fire up your browser and navigate to localhost. This is the default page which indicates that the IIS Server is up and running. |
 |
Installation of the IIS on Windows 2012 R2 Server¶
Open the Server Manager
Click Add roles and feature and continue clicking next until you get to the Server Roles. Select “Web Server (IIS)”
And press Add Features. Under the Features Selection, expand .NET Framework 4.5 Features and select ASP.NET 4.5
Press next and finish the installation.
Deploying the web application on the IIS¶
After developing a web application, the next important step is to deploy the web application. The web application needs to be deployed so that it can be accessed by other users. The deployment is done to an IIS Web server.
| Instructions | Screen |
|---|---|
| After successfully installing the MIKE OPERATIONS web and its files, copy the application folder “C:\Program Files (x86)\DHI\2019\MIKE OPERATIONS WEB 2019\Web” to "C:\intepub\wwwroot" [default] folder. |  |
| Rename application folder to any name relevant to your database e.g. “NAPA …” |  |
| The database connection must be specified. Open the file “…\App_Data\connection.json” file in a text editor as administrator. Edit by specifying: - The name of your PostgreSQL database (e.g. “NAPA”) - The host to use in the connection strings for each connection. By default, the system assumes that the database is found on the current workstation (i.e. host = localhost). Don’t forget to Save! Note: This is case sensitive! |
 |
| Open the Internet Information Services. Press the Windows + R key combination to bring up a run box. Then type “inetmgr” and press OK … |
 |
| The following screen will come. This is the main page for any application. Expand the tree in the left hand side panel. NAPA is the recently pasted webapplication on your wwwroot folder. |
 |
| Now we have some basic information to fill out for the static site which have placed in the wwwroot folder. Click on the Default Web Site, and press Basic Settings in the right panel and modify: Physical Path - The location on the local server that will hold the files for the website. |
  |
| Application pools allows for a level of isolation between different Web applications. For example, if you want to isolate all the Web applications running in the same computer, you can do this by creating a separate application pool for every Web application and placing them in their corresponding application pool. Because each application pool runs in its own worker process, errors in one application pool will not affect the applications running in other application pools. So for deployed MO Web sites, a new application pool should be created. Now one most important part is to set the Application Pool for your application. Select “Application Pools…” in the left panel, then select “DefaultAppPool…” in the middle panel and choose “Advanced Settings …” in the right panel. |
 |
| Ensure that the “Enable 32-Bit Application …” is set to “False …” Note: Since version 2017, MIKE no longer releases a 32 bit version |
 |
| Modify the Identity by selecting an existing administrator on the machine. Insert the credentials … Press OK … |
 |
| Press OK … |  |
| Now we will modify security for the App_Data\accounts.json file and allow IIS_IUSRS to Modify the file. Navigate to the App_Data\accounts.json file and right click and select Properties from the context menu. |
 |
| From the Security tab, select the IIS_IUSRS user and Press Edit … |  |
| Select “Modify …” to allow IIS users to modify then Select Apply … |  |
| Open browser and type “locahost” The website will appear |   |
Installation of MIKE OPERATIONS Web¶
Install MIKE OPERATIONS Web using the MIKE OPERATIONS Web installer: MIKE OPERATIONS Web 2019.msi
The installer is part of the official MIKE OPERATIONS Release.
Click Next
Read and accept the License Agreement.
Click Next
Make sure that both MIKE OPERATIONS Web and the IIS Express is selected.
Internet Information Services (IIS) 10.0 Express is a free, simple and self-contained version of IIS that is optimized for developers. IIS 10.0 Express makes it easy to use the most current version of IIS to develop and test websites. IIS 10.0 Express has all the core capabilities of IIS 10.0 and additional features to ease website development.
The benefits of using IIS 10.0 Express include:
-
The same web server that runs on your production server is now available on your development computer.
-
Most tasks can be done without the need for administrative privileges.
-
IIS Express runs on Windows 7 Service Pack 1 and all later versions of Windows.
-
Many users can work independently on the same computer.
Click Next
Click Install to start the installation.
Wait until the installation completes.
Click Finish.
Database connection¶
Before the website can be started, the database connection must be specified.
Go to the installation folder using the Windows Explorer. By default, the MIKE OPERATIONS Web installer will install into:
C:\Program Files (x86)\DHI\2019\MIKE OPERATIONS WEB\Web\App_Data
Edit the “connections.json” file, specifying the name of the correct PostgreSQL database to use in the connection strings for each connection.
By default, the connections.json file assumes that the database is found on the current workstation. If the PostgreSQL database is found on remote computer, specify “host=\<remote computer name>.
The syntax is “keyword1=value1;keyword2=value2”. Possible keywords are: host (default: localhost), database (no default), userName (default: admin) , password (default: dssadmin), workspace (default: workspace1)
In general when the connections.json file is changed, it is imperative that the web server is restarted to pick up the changes. This is done either through the IIS where the Application Pool is restarted, or modifying the web.config file (i.e changing its file modified stamp) or creating and removing a file in the bin folder
Starting the website¶
The MIKE OPERATIONS Web Installer will create the following shortcuts:
-
Configuration and IIS Deployment
Information about setting up the Website and IIS for a production website. -
Demo Website Install Guide
This guide, for setting up a demo website using IIS Express. -
MIKE OPERATIONS Web
Shortcut for starting the MIKE OPERATIONS Demo website.
When selecting the shortcut for starting the MIKE OPERATIONS Demo Web, IIS Express will start in a separate console window and the Website will be shown using the default browser.
After closing the browser, the IIS Express console window must be closed manually (hit the “q” key when the IIS Express console window is active).