Preface

Copyright

This document refers to MOHID Studio, priority software protected by copyright. All rights are reserved. Copying or other reproduction of this manual, or related documents, is prohibited without prior written consent of Action Modulers, Consultores de Segurança (Action Modulers).

MOHID Water Modelling System is priority software of the Technical University of Lisbon.

Warranty

The warranty given by Action Modulers is limited as specified in your Software License Agreement. Please note that numerical modeling software programs are very complex system and may not be free of errors, so you are advised to validate your work. Action Modulers shall not be responsible for any damage arising out of the use of this document, MOHID Studio, MOHID Water Modelling System or any related program or document.

Further Information

For further information about MOHID Studio please contact:

Action Modulers, Consultores de Segurança Lda.

Rua Cidade de Frehel, Bloco B, Nº 12 A

2640-469 Mafra, Portugal

Tel.: +351 261 813 660

Fax: +351 261 813 666

E-mail: geral@actionmodulers.pt

Web: http://www.actionmodulers.com


Introduction

System Requirements

This document explains how to install MOHID Studio step-by-step. Before start with the installation the user should ensure that all the system requires are fulfilled (check requirements on the Table 1).

Component Requirements
Operating System Windows XP, Vista, 7, 8, Server or later</font>
Processor 1.8 GHz or faster processor
Memory 2GB of RAM
Disk Space[1] 500 MB
Display Resolution 1280x1024 or higher resolution
Display Colour Depth 32 bits
Additional Software Micrososf.NET Framework 4.0
Microsoft Excel 2007 or later [Optional]
Microsoft Report Viewer 2008 or later [Optional]

Table 1 : System Minimum Requirements.

MOHID Studio requires the .NET Framework 4.0, full version, to be installed on your system[2].

To import values from a XLS file to MOHID Studio a version of Microsoft Excel is required. The version recommended is Microsoft Excel 2007 (or later), though MOHID Studio also imports values from Microsoft Excel 97-2003. To display the values from database as a report (on screen or to print) your system will also need the Microsoft Report Viewer 2008 or later. We recommend the use of Microsoft Report Viewer 2010 (download it from http://www.microsoft.com/en-us/download/details.aspx?id=6442).


MOHID Studio

Install MOHID Studio

The MOHID Studio installation package ("MOHIDStudio_Installer.zip") can be downloaded from the Action Modulers website[3]. After the download is complete, the user should extract the package to a temporary folder. Then the user should run the file "setup.exe".

The first step of MOHID Studio installation is a welcome window (represented on Figure 1). Press the "Next" button to continue. During this step, the setup will verify if all the pre-requisites (.NET Framework 4.0, Visual C++ Runtime components, etc.) are fulfilled. It necessary, the system notify the user and will download the necessary packages. The MOHID Studio installation will start after the verification/installation of all necessary packages.

MOHID Studio - Installation Guide (V 1 2 7) 02.png
Figure 1 : Welcome window.

The second step is the License Agreement window (represented on Figure 2). After the user read and accepted the MOHID Studio’s License (represented on Figure 2) press the "Next" button.

MOHID Studio - Installation Guide (V 1 2 7) 03.png
Figure 2 : License Agreement window.

The Plugin window (represented on Figure 3) is the third step of this installation. In this window the user can chose the plugins that will be installed with the MOHID Studio. There are two plugins that are installed by default: Environment Monitoring Plugin and the MOHID File Conversion Plugin. To get more plugins check the MOHID Studio website[4]. Press the button "Next" to continue.

MOHID Studio - Installation Guide (V 1 2 7) 04.png
Figure 3 : Plugin window.

In the next window, the user can choose the installation folder. This window is represented on Figure 4. By default, the installation path is:

32-bit system: C:\Program Files\Action Modulers\MOHID Studio\

64-bit system: C:\Program Files (x86)\Action Modulers\MOHID Studio\
MOHID Studio - Installation Guide (V 1 2 7) 05.png
Figure 4 : Select Installation Folder Window.

The last window of the MOHID Studio installation guide is the confirmation window (represented on Figure 5). In this window the user confirms that want to install MOHID Studio.

MOHID Studio - Installation Guide (V 1 2 7) 06.png
Figure 5 : Confirmation window.

After the user press the "Next" button, on the confirmation window, the installation will start (see Figure 6).

MOHID Studio - Installation Guide (V 1 2 7) 07.png
Figure 6 : Installation window.

MOHID Studio is now successfully installed on your machine. The installation complete window is represented on Figure 7.

MOHID Studio - Installation Guide (V 1 2 7) 08.png
Figure 7 : Installation complete window.

To execute MOHID Studio, click on the Start button, go the Action Modulers folder, then open MOHID Studio folder and press MOHID Studio (steps represented on Figure 8). We recommend reading the next subsection before the user executes MOHID Studio for the first time (subsection 3.2).

MOHID Studio - Installation Guide (V 1 2 7) 09.png
Figure 8: Open MOHID Studio.

MOHID Studio for the First Time

When running MOHID Studio for the first time, the database setup window will be prompted (represented on Figure 9). This window helps the user to set up the MOHID Studio database. To setup the database just press the button "Start"[5].

MOHID Studio - Installation Guide (V 1 2 7) 10.png
Figure 9 : Database Setup window.

After the database is successfully installed (represented on Figure 10) the MOHID Studio is ready to run for the first time. Just press the "Close" button and MOHID Studio will start (represented on Figure 11). When MOHID Studio is completely loaded, the License Management window will be presented (represented on Figure 14). For more information about the MOHID Studio License process check section 4 of this installation guide.

MOHID Studio - Installation Guide (V 1 2 7) 11.png
Figure 10 : Database Setup window – Complete.
MOHID Studio - Installation Guide (V 1 2 7) 12.png
Figure 11 : MOHID Studio splash screen.

Troubleshoot

If the database setup finish without success (not like the one represented on Figure 10), the user should press the "Start" button again. If the error persists, the user should check for:

  • Administrative privileges;

If the error still persists, please send us an e-mail (support@actionmodulers.com) describing the problem.


License

License Management

The License Management allows the user to check, request and validate the MOHID Studio license. There are two different ways to access the License Manager: through the Administration tab (represented on Figure 12) or through the Orb button (represented on Figure 13). The License Manager window is also presented whenever the License is out of date.

MOHID Studio - Installation Guide (V 1 2 7) 13.png
Figure 12 : Reach License Manager through Administration Tab.
MOHID Studio - Installation Guide (V 1 2 7) 14.png
Figure 13: Reach License Manager through Orb button menu.

The License Management window, represented on Figure 14, allows the user to check the current license status, request for a new license or to validate the current license of MOHID Studio.

MOHID Studio - Installation Guide (V 1 2 7) 15.png
Figure 14: License Management window.

The License status or the Evaluation Period is shown on the top of the window. Inside the box is displayed the list of limitations of the current version of MOHID Studio.

To request a license for MOHID Studio, press the button "License Request" and read the subsection 4.2.

To validate your license for MOHID Studio, press the button "License Validation" and read the subsection 4.4.

License Request

The License Request window, represented on Figure 15, allows the user to request a new MOHID Studio’s license. The user should fill all the mandatory fields of the registration form (represented with "*") and choose the license type (for more information, please read the "MOHID Studio – License Overview"). After the registration form is complete, press the "Request…" button (highlighted on Figure 16) to generate the License Request Info.

MOHID Studio - Installation Guide (V 1 2 7) 16.png
Figure 15: License Request window.

The License Request Info window, represented on Figure 16, allows the user to review all the information from the registration form and to view all the information that will be sent to Action Modulers.

MOHID Studio - Installation Guide (V 1 2 7) 17.png
Figure 16: License Request Info window.

After reviewing all the information that will be submitted, the user should press the "Copy" button (highlighted on Figure 16) to copy all the information to clipboard. Then, the user should paste the information from clipboard to an e-mail and send it to: sales@actionmodulers.com (e-mail represented on Figure 17).

MOHID Studio - Installation Guide (V 1 2 7) 18.png
Figure 17: E-mail with the license request code.

In the e-mail, the user can check again all the information that will be sent to Action Modulers. After sending the e-mail to Action Modulers, the license request process is complete.

If the user uses any other e-mail client (or web based mails), the process is the same: just copy the License Request Info from clipboard to the e-mail body and send the e-mail to: sales@actionmodulers.com.

License Emission

If the user requests a MOHID Studio Express license, it will be emitted within 48h and send back to your e-mail.

If the user requests a MOHID Studio Professional license, the user will receive detail payment instructions within 48h. License fee must be paid by bank transfer. Your license will be emitted and send by e-mail, within 48h, after receiving the license fee on our bank account.

License Validation

To validate your copy of MOHID Studio, go to the License Management window (Figure 14) and press the "License Validation" button. The License Validator window will open (represented on Figure 18). This window allows the user to validate the MOHID Studio License.

After receiving the e-mail with your MOHID Studio license, the validation of MOHID Studio License is ready to be complete. The License Validation is a very simple process and can be made by two different ways, as represented on Figure 18:

1. License Data File (read subsection 4.4.1) – the simple and traditional way.

2. License Validation Key (read subsection 4.4.2) – for users without internet connection.

MOHID Studio - Installation Guide (V 1 2 7) 19.png
Figure 18: License Validator window – License File.

License Data File

This is the easiest way to validate the MOHID Studio license. The user needs to select the option "I received the authorization file by e-mail and have saved it to disk", on the License Validator window (represented on Figure 18), and then click on the browse button (highlighted on Figure 18). Browse for the file "MOHIDStudioLicense.dat" that was attached on the MOHID Studio License mail. To complete the validation process of MOHID Studio the user must press the "Ok" button. The MOHID Studio is now validated. The MOHID Studio must be restarted in order to apply the changes (Figure 19).

MOHID Studio - Installation Guide (V 1 2 7) 20.png
Figure 19: License Validation complete.

Validation Key

If for some reason the user has some trouble sending the registration form by e-mail, it is also possible to contact Action Modulers by phone or fax to get the Validation Key for your MOHID Studio. In this case, the user should choose the option "I received the authorization key by fax or phone and need to validate manually", on the License Validator window (represented on Figure 20), and then type the Validation Key and press the "Validate" button, as represented on Figure 20. After validating the MOHID Studio License the text "Genuine Key!" will appear. To complete the validation process of MOHID Studio the user must press the "Ok" button (as represented on Figure 21). The MOHID Studio is now validated. The MOHID Studio must be restarted in order to apply the changes (Figure 19).

Figure 20: License Validator window – License Validation Key.
Figure 21: License Validator window – Genuine key.

  1. – Disk Space required by MOHID Studio only. The disk space requited for additional software and projects is not included.
  2. .NET Framework 4.0 will be installed, if necessary, automatically by the MOHID Studio installer. It is also possible to download from the Microsoft Website: http://www.microsoft.com/en-us/download/details.aspx?id=17851
  3. http://www.actionmodulers.com
  4. http://mohidstudio.actionmodulers.com
  5. – The user might need administrator privileges.