installation guide dss-p

7/28/2019 Installation Guide DSS-P

1/53

HP-II Generic Decision Support System Software - Planning

Installation Guide

DSS Planning 1.0


2/53

2 DSS Planning 1.0Installation Guide

Revision 1.1

Revision History

Date Version Description Author

12 November 2010 0.1 Initial revision Mario Sales

17 November 2010 0.2 More content and formatting Mario Sales

17 November 2010 1.0 HRS comments included and final

review

Mario Sales

7 January 2011 1.1 Updated for DSS-P Sara Lerer


3/53


Revision 1.1

Table of ContentsRevision History ............................................................................................................................................ 2

Motivation..................................................................................................................................................... 4

What to Install ............................................................................................................................................... 4

MIKE 11 Installation ...................................................................................................................................... 5

MIKE BASIN Installation .............................................................................................................................. 16

PostgreSQL Database Installation ............................................................................................................... 30

Configuring Binary format in PostgreSQL ................................................................................................... 36

PostGIS Installation ..................................................................................................................................... 41

Creating a DSS PLANNING Database ........................................................................................................... 45

.Net Framework 3.5 SP1 Installation .......................................................................................................... 48

DSS PLANNING Installation ......................................................................................................................... 50

DSS PLANNING Service Packs Installation ................................................................................................... 53


4/53


Revision 1.1

MotivationThis guide is intended to be used as a reference during training and during installation of the DSS

PLANNING system that needs to be performed by the IT specialists in each of the states.

A number of different software packages (see what to install in next section) are required in order to

install and run the DSS PLANNING. This install guide includes a typical installation process for all of thesoftware packages required by the DSS PLANNING. It does however not replace the more

comprehensive install guides that come with the individual software packages.

Hence, to support a more customized installation or in order to resolve installation problems you may

need to refer to the specific product installation guides.

What to InstallDSS PLANNING is a software package which builds upon Microsoft .Net Framework 3.5 SP1 and thus

depends on it being installed for the correct functionality.

DSS PLANNING uses PostgreSQL 9 as the database server and PostGIS 1.5.2 as the GIS extension to

PostgreSQL. The PostgreSQL database server can either be installed on the same machine as the

application in a Professional deployment or it can be installed on a CentOS machine located on the

network on a Corporate deployment. This document is only covering the Professional deployment.

Furthermore, the DHI modeling tools MIKE BASIN and/or MIKE 11 need to be installed to run

simulations. Current version of these modeling tools is 2009 SP 5.

MIKE BASIN, in its current form, is an extension to ArcMap and thus requires ArcMap to be installed.

Required version is ArcMap 9.3 SP1.

All of the above software packages must be installed before the installation of the DSS PLANNING can

proceed.


5/53


Revision 1.1

MIKE 11 InstallationInsert the "MIKE by DHI 2009 DVD" in the CD/DVD drive. Start Windows Explorer by right-clicking on

Windows Start" menu and selecting "Open Windows Explorer" or by pressing "Windows Key" + E

simultaneously. Select the CD/DVD drive and double click on "Setup" (or "Setup.exe" if file extensions

are being shown):

The following window shows up with the different setup options:


6/53


Revision 1.1

Select "MIKE 11" and click "Install":


7/53


Revision 1.1

A dialog with the list of pre-requisites shows up:

Click "Install" to proceed. The installation dialog providing progress information shows up:

When all pre-requisites are installed the MikeZero installation wizard is shown:


8/53


Revision 1.1

Click "Next" to proceed. Read the license agreement and check "I accept the terms of the license

agreement". Click "Next" to proceed.

The license selection dialog shows up:


9/53


Revision 1.1

If you already have a valid DHI license installed select "Unchanged. Keep the current type of license

management" followed by "Next".

Otherwise select "Local. License file will be installed locally on the machine"

Click "Next" to proceed as all computers shall run with a local license. The "License File Location" dialog

is shown:


10/53


Revision 1.1

Select "Local copy" and click "Browse" to select the DHI license. Click "Open" to go back to the "License

File Location" dialog and click "Next" to proceed.

Note: Contact NIH DSS PLANNING in case you are entitled a license and don't have one. A USB dongle

is also required.

The "Auto Update Configuration" dialog is shown. Uncheck "Enable DHI Auto Updater to run as startup".

Click "Next". If another MIKE by DHI product is installed the following dialog is shown:


11/53


Revision 1.1

Click "Next" to proceed. Otherwise, the following dialog is shown:

If you want to specify a different folder for the installation, click "Browse" and select a different folder in

the dialog that shows up.

Click "Next" to proceed.


12/53


Revision 1.1

Be sure "MIKE 11" is selected and click "Next". The "Language Selection" dialog is shown:

Select the language(s) of interest and click "Next":


13/53


Revision 1.1

Click "Install" to start installation. The installation dialog providing progress information shows up:

Since the installation comes with service packs, when the installation is finished the following dialog is

shown:


14/53


Revision 1.1

Click "Yes" to install the service pack 5. Service pack files are extracted:

When all files are extracted the "Service Pack Installation" wizard is shown:

Click "Start" to initiate installation of the service pack. The installation dialog providing progress

information shows up:


15/53


Revision 1.1

When finished, the last dialog for the service pack installation is shown:

Click "Finish". The last dialog for the MikeZero installation is shown. Click "Finish".

A new folder called "MIKE by DHI 2009" is created under "All Programs" in the "Start menu". Follow the

MIKE 11 instructions and user manual on how to use these.

When new services packs are available for MIKE 11 do not install them unless DHI recommends the

upgrade. In such case, launch the service pack installation by double clicking on the service pack installer

executable and follow the procedure as described above.


16/53


Revision 1.1

MIKE BASIN InstallationInsert the "MIKE by DHI 2009 DVD" in the CD/DVD drive. Start Windows Explorer by right-clicking on

Windows Start" menu and selecting "Open Windows Explorer" or by pressing "Windows Key" + E

simultaneously. Select the CD/DVD drive and double click on "Setup" (or "Setup.exe" if file extensions

are being shown):

The following dialog shows up with the different setup options:


17/53


Revision 1.1

Select "MIKE BASIN" and click "Install":


18/53


Revision 1.1

A dialog preparing for the installation shows up

After some time the MIKE GIS installation wizard is shown:

Click "Next" to proceed. Read the license agreement and check "I accept the terms of the license

agreement". Click "Next" to proceed.


19/53


Revision 1.1

The license selection dialog shows up. If you already have a valid DHI license installed select

"Unchanged. Keep the current type of license management" followed by "Next".

Otherwise select "Local. License file will be installed locally on the machine"

Click "Next" to proceed as all computers shall run with a local license. The "License File Location" dialog

is shown:


20/53


Revision 1.1

Select "Local copy" and click "Browse" to select the DHI license. Click "Open" to go back to the "License

File Location" dialog and click "Next" to proceed.

Note: Contact NIH DSS PLANNING in case you are entitled a license and don't have one. A USB dongle

is also required.

The "Auto Update Configuration" dialog is shown. Uncheck "Enable DHI Auto Updater to run as startup".

Click "Next".

If another MIKE by DHI product is installed the following dialog is shown:


21/53


Revision 1.1


Otherwise, the following dialog is shown:



Click "Next" to proceed. The "Feature Selection" dialog is shown:


22/53


Revision 1.1

Make sure the selections are according to the dialog above and click "Next".

If ArcMap is not installed the dialog below is shown.

Click "Next":


23/53


Revision 1.1

Click "Install".

If ArcMap is not installed, ArcMap Installer is automatically launched as well as a page describing how to

install ArcMap.


24/53


Revision 1.1

Follow the instruction on this page to install ArcMap.

When ArcMap installation is completed, the following dialog is shown:

Click "Register Now":


25/53


Revision 1.1

Note: At the same time, ArcMap Service pack installation starts

automatically and finishes without user intervention.

Select "I have received an authorization file from ESRI and am now ready to finish the registration

process.


26/53


Revision 1.1

Click "Next":

Click "Browse" to select the ESRI license. Click "Open" to go back to the "License File Location" dialog.



27/53


Revision 1.1

Click "Finish".

Note: Contact NIH DSS PLANNING in case you are entitled a license and don't have one.

If ArcMap service pack installation is still running, wait for its completion.

When finished, since the installation comes with service packs, the following dialog is shown:

Click "Yes" to install the service pack 5. Service pack files are extracted:

When all files are extracted the "Service Pack Installation" wizard is shown:


28/53


Revision 1.1

Click "Start" to initiate installation of the service pack. The installation dialog providing progress

information shows up:

When finished, the last dialog for the service pack installation is shown:


29/53


Revision 1.1

Click "Finish".

The last dialog for the MIKE GIS installation is shown. Click "Finish".

A new folder called "MIKE by DHI 2009" is created under "All Programs" in the "Start menu". With a

subfolder called "MIKE GIS" Follow the MIKE BASIN instructions and user manual on how to use these.

When new services packs are available for MIKE BASIN do not install them unless DHI recommends

the upgrade. In such case, launch the service pack installation by double clicking on the service pack

installer executable and follow the procedure as described above.


30/53


Revision 1.1

PostgreSQL Database InstallationNote: This Install Guide covers only installation of PostgreSQL database as required by a Professional

deployment of the DSS Planning

Insert the "DSS Planning 1.0 Installation disk" in the CD/DVD drive. Start "Windows Explorer" by

right-clicking on Windows Start" menu and selecting "Open Windows Explorer", or by pressing"Windows Key" + E simultaneously. Select the CD/DVD drive, followed by "PostgreSQL 9.0.1" folder and

double click on "postgresql-9.0.1-1-windows" (or "postgresql-9.0.1-1-windows.exe" if file extensions are

being shown).

Some pre-requisites may be automatically installed. In such case a dialog similar to the one below is

shown:

After all pre-requisites are installed the following dialog is shown:

Click "Next":


31/53


Revision 1.1

Accept the default "Installation Directory" by clicking "Next":

Accept the default "Data Directory" by clicking "Next":


32/53


Revision 1.1

Type in the password for the postgres user (the administrator for the database server). This password

needs to be compliant with the domain policy for passwords if the computer belongs to domain. In such

case, password shall contain capital letters, small letters and numbers.

Click "Next" to proceed:


33/53


Revision 1.1

Accept the default "Port" by clicking "Next":

Accept the default "Locale" by clicking "Next". The "Ready to Install" dialog is shown:


34/53


Revision 1.1

Click "Next" to start installation. The installation dialog providing progress information shows up:

When installation is done, the following dialog is shown:


35/53


Revision 1.1

Although we could install PostGIS using the "Stack Builder" this would require an internet connection

and thus we suggest to install PostGIS from the installer in the Installation CD as described in the next

section.

Uncheck "Launch Stack Builder at exit?

Click "Finish" to exit the installation.


36/53


Revision 1.1

Configuring Binary format in PostgreSQLThe default format for binary data supported by PostgreSQL is not compatible with PostGIS.

Start "PGAdmin III" by clicking on "Windows Start" menu, followed by "All Programs", PostgreSQL 9.0

(x86) and finally "pgAdmin III". The main PGAdmin window is shown:

Double click on the node for the server in your machine (it should be the only one) named PostgreSQL

9.0 (x86) (localhost:5432):

Type in the password for the postgres user and check "Store password".


37/53


Revision 1.1

Click "OK". The following dialog is shown:

Click "OK". A connection to the server is performed and PGAdmin shows the contents of the database

(still empty):

Click "Tools" menu followed by "Server Configuration" and "postgresql.conf". The "Backend

Configuration Editor" is shown:


38/53


Revision 1.1

Double click on the line starting with "bytea_output":

Check "Enabled" and change "Value" to "escape":


39/53


Revision 1.1

Click "OK" to be back to the Backend Configuration Editor".

Click "File" menu, followed by "Save" (alternately click on the diskette icon):


40/53


Revision 1.1

Click "Yes".

Then, click "File" menu, followed by "Reload server" (alternatively click on green arrow just next to the

diskette icon):

Click "Yes".

Close the Backend Configuration Editor" and close PGAdmin.


41/53


Revision 1.1

PostGIS InstallationPostGIS required to handle spatial data in PostgreSQL.

Insert the "DSS Planning 1.0 Installation disk" in the CD/DVD drive. Start "Windows Explorer" by

right-clicking on Windows Start" menu and selecting "Open Windows Explorer", or by pressing

"Windows Key" + E simultaneously. Select the CD/DVD drive, followed by "PostGIS 1.5.2" folder anddouble click on "postgis-pg90-setup-1.5.2-3" (or "postgis-pg90-setup-1.5.2-3.exe" if file extensions are

being shown).

The following dialog is shown:

Click "I Agree":


42/53


Revision 1.1

Uncheck "Create spatial database":

Click "Next":

Accept the default "Destination Folder by clicking "Next".

Type in the password of the postgres user (the same as during PostgreSQL database installation)


43/53


Revision 1.1

Click "Next" to start installation. The installation dialog providing progress information shows up:

When installation is completed, the following dialog is shown:


44/53


Revision 1.1

Click "Yes":

Click "Close" to finish installation.


45/53


Revision 1.1

Creating a DSS PLANNING DatabaseBefore DSS PLANNING can run a database must be created.

The installation CD contains a set of scripts that are executed to create the database.

Insert the "DSS Planning 1.0 Installation disk" in the CD/DVD drive. Start "Windows Explorer" byright-clicking on Windows Start" menu and selecting "Open Windows Explorer", or by pressing

"Windows Key" + E simultaneously. Select the CD/DVD drive, followed by DB Scripts" folder and double

click on "createall" (or "createall.bat" if file extensions are being shown).

A Command Line window is shown:

Press a key to proceed:


46/53


Revision 1.1


Again, press a key to proceed:



47/53


Revision 1.1

After pressing a key the Command Line window is closes and the database created.

Note: These scripts create a default DSS PLANNING database in the localhost (the same machine they

are executed from). If a database needs to be created in another machine, for example, to create a

database in the database server on a Corporate deployment scenario, the file defaults.cfg needs to

be edited and the line -h:localhost replaced withh:IP_NUMBER where IP_NUMBER is the ip number of

the server.


48/53


Revision 1.1

.Net Framework 3.5 SP1 Installation

.Net Framework 3.5 SP1 is part of Windows 7 and it is not possible to uninstall it.

However, Service Pack 1 is required and must be installed if not present in other platforms

Insert the "DSS Planning 1.0 Installation disk" in the CD/DVD drive. Start "Windows Explorer" byright-clicking on Windows Start" menu and selecting "Open Windows Explorer", or by pressing

"Windows Key" + E simultaneously. Select the CD/DVD drive, and double click on "dotnetfx35" (or

"dotnetfx35.exe" if file extensions are being shown):

The dialog providing progress information for files extractions is shown:

If Service Pack 1 is already installed, the dialog will simply close and installation is finished.

If Service Pack 1 is not installed, the following dialog shows up:


49/53


Revision 1.1

Click on Reinstall using recommended settings. The installation dialog providing progress information

is shown:

When installation is completed, the dialog closes.


50/53


Revision 1.1

DSS PLANNING InstallationInsert the "DSS Planning 1.0 Installation disk" in the CD/DVD drive. Start "Windows Explorer" by

right-clicking on "Windows Start" menu and selecting "Open Windows Explorer", or by pressing

"Windows Key" + E simultaneously. Select the CD/DVD drive, followed by "DSS Planning" folder and

double click on "dss-p" (or "dss-p.msi" if file extensions are being shown). The following window shows

up:

Click "Next. Read the license agreement and check "I accept the terms in the License Agreement".

Click "Next" to proceed. The Custom Setup dialog shows up:


51/53


Revision 1.1

In case you want to access the documentation for the Application Programming Interface (API), click onthe "DSS PLANNING 1.0 API Documentation" and select "Will be installed on local hard drive".



Click "Next" to proceed

Click "Install" to start installation. The installation dialog providing progress information shows up. When

finished, the completed installation dialog is shown:


52/53


Revision 1.1

Click to "Finish" installation to close the installation wizard.

A new folder called "DHI Solution Software" is created under "All Programs" in the "Start menu".

DSS Planning can be started by clicking "DSS PLANNING 1.0" in this folder.

Documentation can be accessed by clicking "DSS PLANNING 1.0 Help" and the API documentation by

clicking "DSS PLANNING 1.0 API Documentation"

As the help uses some dynamic content, depending on the settings for Internet Explorer, the first time it

is displayed, some features may be missing and not displayed as shown in the figure:

If this is the case, click on the yellow bar and select "Allow Blocked Content..." followed by "Yes" on the

popping dialog.


53/53

The correct Help pages are displayed:

Note: Before start using DSS Planning, a database needs to be created. This process is described in the

System Administration tutorial.

DSS PLANNING Service Packs Installation

When system upgrades are release by DHI they can either require simple copying of files or an installerwill be provided.

Upgrade instructions will also be distributed and shall be followed to perform the upgrade.

installation guide dss-p

Documents