MIKE OPERATIONS

Installation Guide 2019.2

MIKE 2019
DHI headquarters
Agern Allé 5
DK-2970 Hørsholm
Denmark
+45 4516 9200 Telephone
+45 4516 9333 Support
+45 4516 9292 Telefax
[email protected]
www.mikepoweredbydhi.com

mike_operations_installationguide.docx/13-06-2019 - © DHI
PLEASE NOTE

COPYRIGHT This document refers to proprietary computer software, which is

protected by copyright. All rights are reserved. Copying or other
reproduction of this manual or the related programmes is
prohibited without prior written consent of DHI. For details please
refer to your ‘DHI Software Licence Agreement’.

LIMITED LIABILITY The liability of DHI is limited as specified in your DHI Software
License Agreement:

In no event shall DHI or its representatives (agents and suppliers)

be liable for any damages whatsoever including, without
limitation, special, indirect, incidental or consequential damages
or damages for loss of business profits or savings, business
interruption, loss of business information or other pecuniary loss
arising in connection with the Agreement, e.g. out of Licensee's
use of or the inability to use the Software, even if DHI has been
advised of the possibility of such damages.

This limitation shall apply to claims of personal injury to the extent

permitted by law. Some jurisdictions do not allow the exclusion or
limitation of liability for consequential, special, indirect, incidental
damages and, accordingly, some portions of these limitations
may not apply.

Notwithstanding the above, DHI's total liability (whether in

contract, tort, including negligence, or otherwise) under or in
connection with the Agreement shall in aggregate during the term
not exceed the lesser of EUR 10.000 or the fees paid by
Licensee under the Agreement during the 12 months' period
previous to the event giving rise to a claim.

Licensee acknowledge that the liability limitations and exclusions

set out in the Agreement reflect the allocation of risk negotiated
and agreed by the parties and that DHI would not enter into the
Agreement without these limitations and exclusions on its liability.
These limitations and exclusions will apply notwithstanding any
failure of essential purpose of any limited remedy.

MIKE 2019
CONTENTS
MIKE OPERATIONS
Installation Guide

1 Introduction ..................................................................................................................... 1

2 Installation Prerequisites ................................................................................................ 2

3 MIKE OPERATIONS Installation/Upgrade ...................................................................... 3

4 DHI License File .............................................................................................................. 9

5 Set Up Database .............................................................................................................. 9

5.1 Connecting to a database ................................................................................................................... 9
5.2 Create a new MIKE OPERATIONS database ..................................................................................12
5.3 Connect to MIKE OPERATIONS database ......................................................................................13

6 Updating Existing Database ......................................................................................... 15

7 Database Server Update ............................................................................................... 15

APPENDIX A: Install different version of PostgreSQL ............................................................. 17

PostgreSQL Installation ....................................................................................................................................17
PostGIS Installation ..........................................................................................................................................20
Configuration of PostGIS ..................................................................................................................................24

APPENDIX B: Advanced PostgreSQL Database management tool ......................................... 26

APPENDIX C: Configuring the PostgreSQL Database Server for remote access .................. 27
Configuring the Windows Firewall for remote access to MIKE OPERATIONS ................................................28

APPENDIX D: Troubleshooting .................................................................................................. 31

Event Manager will not start (System.PlatformNotSupportedException) .........................................................31
Template_postgis_20 does not exist ................................................................................................................32

i
1 Introduction
This installation guide covers the installation of MIKE OPERATIONS 2019.2 and related
Modules (MIKE WORKBENCH, MIKE INFO) and required 3rd party software

MIKE OPERATIONS and MIKE INFO can be deployed in different ways – ranging from a
personal installation to a corporate installation.

1. Personal installation, which allows users to work in a network independent mode on

their desktop. This requires the installation of a database on the local computer;

2. Corporate installation, which allows for an office to have multiple installations

(clients) all working against a central database.

3. Web installation, which allows for an organisation to access MIKE OPERATIONS

over the Internet.

This installation guide describes the installation process for all the different deployment
patterns and required associated 3rd party software.

Installation of MIKE OPERATONS Web and MIKE INFO Web are described in a separate
installation guides.

Important information: Please be aware that all MIKE software (including the DHI
License Manager) on the same computer must be installed with the same service pack.
This is due to the dependencies between MIKE software products and our wish to use
the latest and technically most advanced development systems.

© DHI - MIKE OPERATIONS Installation Guide 2019.2 1

2 Installation Prerequisites
MIKE OPERATIONS depend on some prerequisites as listed below.

1. A PostgreSQL database server with the PostGIS spatial database extension.

The installation and configuration are part of the standard installer.

MIKE OPERATIONS support the following combinations of the two products:

- PostgreSQL 9.4 and PostGIS 2.1.8 (build 13780)

- PostgreSQL 9.5 and PostGIS 2.2.1 (build 14555)
- PostgreSQL 9.6 and PostGIS 2.3.0 (build 15146)
- PostgreSQL 9.6 and PostGIS 2.3.1 (build 15264)
- PostgreSQL 9.6 and PostGIS 2.3.2 (build 15302)
- PostgreSQL 9.6 and PostGIS 2.4.1 (build 16012)
- PostgreSQL 9.6 and PostGIS 2.4.4 (build 16526)
- PostgreSQL 9.6 and PostGIS 2.5.1 (build 17027)
- PostgreSQL 10.0 and PostGIS 2.4.1 (build 16012)
- PostgreSQL 10.0 and PostGIS 2.4.4 (build 16526)
- PostgreSQL 10.3 and PostGIS 2.4.3 (build 16312)
- PostgreSQL 10.3 and PostGIS 2.4.4 (build 16526)
- PostgreSQL 10.4 and PostGIS 2.4.4 (build 16526)
- PostgreSQL 10.5 and PostGIS 2.5.0 (build 16836)
- PostgreSQL 10.6 and PostGIS 2.5.0 (build 16836)
- PostgreSQL 10.6 and PostGIS 2.5.1 (build 17027)
- PostgreSQL 10.7 and PostGIS 2.5.2 (build 17328)
- PostgreSQL 11.0 and PostGIS 2.5.0 (build 16836)
- PostgreSQL 11.1 and PostGIS 2.5.0 (build 16836)
- PostgreSQL 11.1 and PostGIS 2.5.1 (build 17027)
- PostgreSQL 11.2 and PostGIS 2.5.2 (build 17328)

Combinations of later versions may also work but have not been tested.

Versions accepted by MIKE OPERATIONS can be maintained in the file

“DssDatabases.cfg.xml” of the MIKE OPERATIONS installation folder.

2. A MIKE Zero 2019 Update 1 or MIKE SDK 2019 Update 1 installation. In case none
of those are installed before running the MIKE OPERATIONS 2019.2 installation,
MIKE SDK 2019 Update 1 will be installed together with MIKE OPERATIONS
2019.2.

3. The DHI License Management application. It is included in the MIKE OPERATIONS

installer.

4. .NET framework 4.7.2

© DHI - MIKE OPERATIONS Installation Guide 2019.2 2

3 MIKE OPERATIONS Installation/Upgrade
MIKE OPERATIONS 2019.2 is installed by running the Setup.exe program coming with
the installation media. The installation process consists of two parts.

1. Installation of possible required MIKE 2019 components – only applicable if there is

no MIKE Zero installation present.

2. Installation of MIKE OPERATIONS 2019.2 software files including MIKE Workbench,

MIKE INFO, MIKE OPERATIONS desktop and PostgreSQL + PostGIS

Installation of MIKE OPERATIONS 2019.2 software file is simple and requires no user
interactions beyond accepting the license conditions and specifying the installation folder

The following table explains how to install or upgrade MIKE OPERATIONS, MIKE
WORKBENCH, MIKE INFO and required 3rd party software.

If you are installing MIKE OPERATIONS for the first time, PostgreSQL 11.2 and PostGIS
2.5 will be installed by default. If you want to use a different version, follow the “upgrade”
steps and go to APPENDIX A.

Installation step Screen

Run the setup file from the

installation media/download
folder.

Start of installation

Click Next

© DHI - MIKE OPERATIONS Installation Guide 2019.2 3

 Installation step Screen

Accept the license agreement

Click Next

Select the components to

install.

Install MIKE Workbench

Freeware

SQLite database
MIKE INFO can also be
selected if needed

Install MIKE Workbench

Database server on separate
server

© DHI - MIKE OPERATIONS Installation Guide 2019.2 4

 Installation step Screen

Install MIKE Workbench

Local Database server

Upgrade MIKE Workbench

Any Database

Upgrade MIKE OPERATIONS

Desktop

Any Database

© DHI - MIKE OPERATIONS Installation Guide 2019.2 5

 Installation step Screen

Install MIKE OPERATIONS

Desktop

Local Database

Upgrade MIKE INFO Desktop

Any Database

Install MIKE INFO Desktop

Local Database

Click Next

© DHI - MIKE OPERATIONS Installation Guide 2019.2 6

 Installation step Screen

At the end of the installation, if

the Job Manager fails to start,
this might be because this port
is already used. In that case,
please restart the installation
process and select a different
port number.

Click Next

If you are doing a fresh

installation and want to use a
local database server, you
will be asked to provide a
password for PostgreSQL
database.

Provide Password to the

PostgreSQL database

Click Next
Note: The password is used
whenever the Database
Manager Utility is used or
PostgreSQL native software
PgAdmin is applied

Click Install

© DHI - MIKE OPERATIONS Installation Guide 2019.2 7

 Installation step Screen

Click Finish

If you are doing a fresh

installation, Wait until
installation of PostgreSQL and
PostGIS is complete

And

Click OK to complete the

installation

© DHI - MIKE OPERATIONS Installation Guide 2019.2 8

4 DHI License File
The DHI license is handled through the DHI License Management software, which can be
found under DHI License Administration in the Start Menu.

Installation step Screen

Open the DHI License

Management program in the
start menu as admin

There three different options:

• Internet License

• Network License
• Local License
(dongle)

Note: All Users must be

ticked to allow for job
execution

Please look in the

documentation found by
clicking the Help button or
contact your local MIKE Sales
representative

5 Set Up Database
Once the software is installed for the first time, it is required to set up a database. This
includes connecting to a database file or server, creating a database and making a
database connection.

5.1 Connecting to a database

From your Windows client machine, launch Database Manager Utility, this can be
located by going to the Start menu and search for Database Manager Utility.

MIKE OPERATIONS support three types of database.

5.1.1 Connecting to PostgreSQL

PostgreSQL is the recommended database to use with MIKE OPERATIONS.

© DHI - MIKE OPERATIONS Installation Guide 2019.2 9

 Instructions Screen

Click the server name to expand

the server tree and select the
server type as PostgreSQL.

Selecting a database server

type in the menu will open the
login dialog, where you are
prompted to insert some
connection parameters.

• Name of computer running

the database: localhost

• The communication port:

5432

• Name of the user: postgres

(keep as default)

• Password of the user:

established during
installation

• The path to database

server tools: keeps as
default

Click Ok to establish the connection, and to get the list of databases on the server listed
in the log screen.

5.1.2 Connecting to SQLite (Freeware)

SQLite database is a file based database (similar to Microsoft Access). This can
accessed be by on user at the time. This database is the only one supported by the
Freeware version and should be used only for testing purposes.

© DHI - MIKE OPERATIONS Installation Guide 2019.2 10

 Instructions Screen

Click the server name to expand

the server tree and select the
server type as SQLite.

Selecting a where the database

file will be created.

Click Ok

Wait until the connection is

established.

5.1.3 Connecting to Oracle

MIKE OPERATIONS can work with Oracle database but the GIS information is not
supported.

© DHI - MIKE OPERATIONS Installation Guide 2019.2 11

5.2 Create a new MIKE OPERATIONS database
It is now required to create a new database.

Instructions Screen

Click on the database node, and

select “New”

Give a name (e.g. NAPA) to the

new database and click Create.

Wait until the database has

been created and close the
application.

The log depends on the type of

database used.

In the case of an SQLite

database, ensure the file was
created locally.

© DHI - MIKE OPERATIONS Installation Guide 2019.2 12

5.3 Connect to MIKE OPERATIONS database
Finally, a database connection must be created in MIKE WORKBENCH.

Instructions Screen

When opening MIKE

WORKBENCH, a connection
window appears

Click “Setup…”

A connection manager them

allow you to create a connection

Click “Add…”

For PostgreSQL, you should

define the Server name. In the
current example, we work with a
database installed locally and
the Server name should be set
to “localhost”.

The Database entry should

match the name provided in
chapter 5.1

For SQLite, you should define

the path to the sqlite file.

© DHI - MIKE OPERATIONS Installation Guide 2019.2 13

 Instructions Screen

Connection Name can be any

unique name you chose.

Click OK

The newly created connection

appears in the list.

Click Close

The Connection menu now

shows the newly created
database connection.

By default, the pre-configured

administrator account is called
“admin”. The password is
“dssadmin”

This should be changed after

logging in to the system.

Click “Login”

© DHI - MIKE OPERATIONS Installation Guide 2019.2 14

6 Updating Existing Database

If you are doing an update, you should ensure the database version and the MIKE
OPERATIONS version are consistent. Indeed, from one version to another one, the
database schema usually evolved.

The database must be updated with the Database Utility.

After connecting to your PostgreSQL database server, you should select “Update”.

Finally, you should select the database to update.

Beware that after updating the database, MIKE OPERATIONS users working with the
earlier version of the software will not be able to use the database. After the database
has been updated everybody using the database should update the client.

7 Database Server Update

This chapter concerns users:

- Installing MIKE OPERATIONS on a computer different from the database

server
- Upgrading MIKE OPERATIONS on a computer different from the database
server
- Updating a database with Database Management Utility from a computer
different from the database server

© DHI - MIKE OPERATIONS Installation Guide 2019.2 15

 From version 2017.5, the Mesh Database was implemented in MIKE OPERATIONS. This
requires a specific dll to be located on the database server. The installer and the
Database Management Utility will copy automatically is PostgreSQL is installed locally.
In the case PostgreSQL is not installed locally, the user will need to carry out the
following steps to ensure MIKE OPERATIONS works correctly:
- Locate and copy the file called “DHI_mesh.dll” in the MIKE OPERATIONS bin
folder1
- Log in to the computer on which the database server is installed (PostgreSQL)
- Paste the file to the “lib” folder of the PostgreSQL installation2.

1 E.g. C:\Program Files (x86)\DHI\2019\MIKE OPERATIONS\bin\PostgreSQL

2 C:\Program Files\PostgreSQL\10\lib (or relevant DB folder)

© DHI - MIKE OPERATIONS Installation Guide 2019.2 16

APPENDIX A: Install different version of PostgreSQL
As mentioned in Chapter 2, it is possible to use several versions of PostgreSQL
database.

PostgreSQL Installation
The following table explains how to install a PostgreSQL database downloaded from
internet.

Installation step Screen

Run the database installation

program e.g.
postgresql-XX.X-X-windows-
x64.exe

Start of installation

Click Next

Accept the default installation

folder

Click Next

© DHI - MIKE OPERATIONS Installation Guide 2019.2 17

 Installation step Screen

Accept the default data folder.

Click Next

Type in a password of your

choice for the “postgres” user
(the administrator for the
database server).

Note: Do not forget this

password

Click Next

Accept the default port number

(5432)

Click Next

© DHI - MIKE OPERATIONS Installation Guide 2019.2 18

 Installation step Screen

Leave the "Locale" as “Default

Locale”

Click Next

Click Next

The database server

installation has finished

Click off the “Launch Stack

Builder at exit?” option and
then click Finish

© DHI - MIKE OPERATIONS Installation Guide 2019.2 19

 PostGIS Installation
The following table explains how to install PostgreSQL exemplified by using a PostGIS
postgis-bundle-pgXXx64-setup-X.X.X-X.exe installer from internet.

Installation step Screen

Run the PostGIS installation

program (e.g.
postgis-bundle-pg96x64-
setup-2.3.1-1.exe)

Start of installation

Click I Agree

Check “Create spatial

database”

Click Next

© DHI - MIKE OPERATIONS Installation Guide 2019.2 20

 Installation step Screen

Accept the default folder.

Click Next

Type in the password that was

specified for the “postgres”
user when installing the
PostgreSQL database server

Click Next

Rename the Spatial database:

template_postgis_20

© DHI - MIKE OPERATIONS Installation Guide 2019.2 21

 Installation step Screen

Yes, to the GDAL_Data

environment variable

Click Yes

Yes, to both set of

environment variables

Click Yes

© DHI - MIKE OPERATIONS Installation Guide 2019.2 22

 Installation step Screen

The installation has finished

Click Close

© DHI - MIKE OPERATIONS Installation Guide 2019.2 23

 Configuration of PostGIS

Installation step Screen

Open the Windows Command

Prompt

Click the Windows Start Menu

and type “cmd”

Right-click on cmd.exe and

choose Run as administrator

© DHI - MIKE OPERATIONS Installation Guide 2019.2 24

 Installation step Screen
In the command prompt type
SETX /M PROJSO libproj-
9.dll
and press enter

Restart the computer to

make the environment
variable available to
PostGIS

© DHI - MIKE OPERATIONS Installation Guide 2019.2 25

APPENDIX B: Advanced PostgreSQL Database management tool
The PostgreSQL database password provided during installation can be stored in the
database for easy access in the future. It is an optional configuration.

Installation step Screen

Start the pgAdmin 4 database

administration tool from the
Windows Start menu

An internet browser opens

Right click the database

server entry for localhost
under the Servers node to
access “Connect Server”

Provide the password for the

“postgres” user and check on
the “Store password” option

Note: Clicking on “Store

password” leads to a warning.

Click OK on the warning

dialog

© DHI - MIKE OPERATIONS Installation Guide 2019.2 26

APPENDIX C: Configuring the PostgreSQL Database Server for
remote access
IMPORTANT: This is only needed if the database server shall accept connection from
remote computers.

The section describes how to configure the PostgreSQL database server for running in
corporate mode.

Start by enabling password save as shown in APPENDIX B.

Installation step Screen

Locate the pg_hba.conf file in

the data folder (C:\Program
Files\PostgreSQL\10\data)
and open it in an editor e.g.
Notepad

Insert a new line to open up

for all non-local connections to
database as shown on the
right

host all all 0.0.0.0/0 md5

Adjust spaces!

Save the configuration.

© DHI - MIKE OPERATIONS Installation Guide 2019.2 27

 Installation step Screen

Restart the services to apply

the update

Configuring the Windows Firewall for remote access to MIKE

OPERATIONS
The section describes how to configure the Windows firewall for MIKE OPERATIONS
running in enterprise mode.

Installation step Screen

Open the Firewall applet in the

Windows Control Panel

Click Advanced Settings

Select Inbound Rules

Click New Rule in the Actions

panel to the right

© DHI - MIKE OPERATIONS Installation Guide 2019.2 28

 Installation step Screen

Select Port

Click Next

Select TCP, Specific local

ports and enter 5432 (or the
port number specified when
installing PostgreSQL)

Click Next

Select Allow the connection

Click Next

© DHI - MIKE OPERATIONS Installation Guide 2019.2 29

 Installation step Screen

Click on for all profiles

Click Next

Specify a rule name – e.g.

“PostgreSQL (5432)” – and a
description

Click Finish

The new rule is now added to

the list of Inbound rules

© DHI - MIKE OPERATIONS Installation Guide 2019.2 30

APPENDIX D: Troubleshooting

Event Manager will not start (System.PlatformNotSupportedException)

If the DHI Event Manager is not starting during the installation, the installation cannot
complete and will roll back.

The following stack trace can be found in the Windows Event Viewer.

Service cannot be started. System.PlatformNotSupportedException: Operation is not supported

on this platform.
at System.Net.HttpListener..ctor()
at System.ServiceModel.Channels.SharedHttpTransportManager.OnOpen()
at System.ServiceModel.Channels.TransportManager.Open(TransportChannelListener
channelListener)
at
System.ServiceModel.Channels.TransportManagerContainer.Open(SelectTransportManagersCallb
ack selectTransportManagerCallback)
at System.ServiceModel.Channels.TransportChannelListener.OnOpen(TimeSpan timeout)
at System.ServiceModel.Channels.HttpChannelListener`1.OnOpen(TimeSpan timeout)
at System.ServiceModel.Channels.CommunicationObject.Open(TimeSpan timeout)
at System.ServiceModel.Dispatcher.ChannelDispatcher.OnOpen(TimeSpan timeout)
at System.ServiceModel.Channels.CommunicationObject.Open(TimeSpan timeout)
at System.ServiceModel.ServiceHostBase.OnOpen(TimeSpan timeout)
at System.ServiceModel.Channels.CommunicationObject.Open(TimeSpan timeout)
at DHI.Solutions.EventManager.Service...

To solve the System.PlatformNotSupportedException issue:

a. Start a command prompt “as administrator”.

b. Run “sc config http start=demand”
c. Run “sc start http” (to make sure that the http service is running)

© DHI - MIKE OPERATIONS Installation Guide 2019.2 31

 Template_postgis_20 does not exist
After making a fresh installation of MIKE OPERATIONS, when trying to create a new
database, if you receive an error message mentioning a missing database model
“template_postgis_20”, it means that PostGIS was not installed correctly.

The solution is to reinstall PostGIS (see APPENDIX A). The download file can be found
online.

© DHI - MIKE OPERATIONS Installation Guide 2019.2 32