GeoDict Download, Installation and Licensing 2015 · GeoDict 2015 download, installation, and...

GeoDict 2015 Andreas Wiegmann

Jürgen Becker

Erik Glatt

Text and editing: Barbara Planas

Download,

installation, and licensing

24 May 2016

GEODICT2015 DOWNLOAD, INSTALLATION, AND LICENSING 1

SYSTEM REQUIREMENTS AND RECOMMENDATIONS 1

DOWNLOADING AND INSTALLING GEODICT 2

INSTALLATION ON MICROSOFT® WINDOWS 2

Parallel computing and MPI for Windows 8

INSTALLATION ON LINUX 9

Parallel Computing and MPI for Linux 9

LICENSING GEODICT 11

REQUESTING A NODE-LOCKED OR EVALUATION LICENSE 11

REQUESTING A FLOATING LICENSE 14

INSTALLING A NODE-LOCKED LICENSE 15

Installation as user 15 Installation as administrator 17

INSTALLING A FLOATING LICENSE 18

IF GEODICT DOES NOT START AFTER LICENSING 19

UN-INSTALLING GEODICT 19

GeoDict 2015 User Guide 1

GEODICT2015 DOWNLOAD, INSTALLATION, AND

LICENSING

SYSTEM REQUIREMENTS AND RECOMMENDATIONS

The following are the minimum requirements and some recommendations. For up-to-date recommendations visit our web site at:

http://www.geodict.com/Support/System/hardwareOS.php

8 GB of RAM (16 GB recommended)

300 MB of available hard-disk space

3D video card with a minimum of 128 MB of memory (256 MB recommended)

64 bit OS

o Microsoft® Windows 7, 8 or 10

o Linux (RHEL 6 or 7, SuSE 12, Ubuntu 12, or any other distribution using glibc

with version 2.12 or higher)

OpenGL 2.0 or newer

GeoDict’s internal representation of the structure consists of rectangular 3D arrays of

equal sized boxes, hereafter called volume elements or voxels.

The size of available RAM determines the size of the largest structures handled by GeoDict’s solvers.

The following table gives an impression of the performance of the EJ-Stokes for fibrous materials with 5% solid volume fraction and 5 micron fiber diameter. The table

refers to a stand-alone shared-memory computer.

Memory Processors Graphics

memory

Generation &

Visualization Flow simulation

8 GB 4 1 GB 5123 voxels 1283 voxels





When computing the properties of large structures, pay attention to the Task Manager to detect memory overflow. The Task Manager starts after clicking the

right mouse button on the task bar of the computer. When the program uses unusually large amounts of memory, it is advisable to terminate the executable

and review the settings for structure generation or property solvers.

http://www.geodict.com/Support/System/hardwareOS.php

GeoDict 2015 download, installation, and licensing

2 GeoDict 2015 User Guide

DOWNLOADING AND INSTALLING GEODICT2015

INSTALLATION ON MICROSOFT® WINDOWS

Close all windows applications and be logged on as administrator on the computer.

1. Begin the download and installation by clicking the

Download tab in the GeoDict’s web site (http://www.geodict.com).

2. The page opens. Click the link to the download table page and, there, choose the GeoDict release that fits

your needs (operating system, bits, etc.). Click on the link. The executable file is downloaded to the user’s download folder (C:\Users\Username\Downloads).

3. In the Downloads folder, double-click the executable

file and click Yes in the User Account Control dialog box.

4. The Select Setup Language dialog box, select English or Deutsch as

the installation language and click OK. The installation wizard is

activated. Click Next >.

http://www.geodict.com/Support/Download/DownloadTable.php

Installation on Microsoft® Windows


5. In the License Agreement dialog, check I accept the agreement to agree to

the License Agreement terms and click Next > to continue with the installation.

6. In the Select Destination Location dialog, keep the default destination or

choose a folder for the installation where the intended user has “write” privileges and click Next >.

7. In the Select Start Menu Folder dialog, choose a folder or agree to the suggested folder and click Next >.



8. In the Select Additional Tasks dialog, check if you want to create a desktop

icon and click Next >.

9. In the Ready to Install dialog,

click Install to being the

installation.



The program files are copied to your computer.

During the GeoDict2015 installation, several Microsoft Redistributables are installed.

Among them is Microsoft MPI, a Microsoft implementation of the Message Passing Interface standard for running parallel applications on the Windows platform.

When the Microsoft MPI Setup Wizard dialog appears, click Next to start the installation.

It is crucial that the Destination Folder is not changed from the default path (C:\Program Files\Microsoft MPI\). This is the location where GeoDict2015 looks for Microsoft MPI and changing the path produces an error when trying

to run parallel computations.





After the installation, the Information dialog appears containing several tips and

other data about GeoDict.

To complete the setup of the GeoDict2015 release, the wizard suggests the installation of Notepad++ as text editor and 7Zip, for the compression of large

solver computation results. If these open source programs are already installed on your computer or you do not want to install them, uncheck the boxes. To install them,

click Finish.

For both programs, installation wizards are called to facilitate the set-up. The steps are very similar to those for the installation of GeoDict. Follow the instructions for

installation of Notepad++ and later for the installation of 7Zip.



If you did not un-check Launch

GeoDict 2015 in the wizard, GeoDict2015 launches now and

the GeoDict GUI appears. However, the program does not

run yet and requests a valid license to start.

See pages 11-13 below for

instructions on requesting a license file from Math2Market.

At the end of the installation,

the readme.txt file open. Close the Setup screen and the

GeoDict software for Windows is now installed and ready for licensing.

Two shortcut icons have been saved to the computer desktop:

The GeoDict 2015 icon is a shortcut to the GeoDict2015 edition located (by default) at C:\Program Files

(x86)\Math2Market GmbH\GeoDict2015Win64.

The GeoDexcel 2015 icon is a shortcut to the GeoDexcel spreadsheet, for the

analysis and plotting of results from the FilterDict, FlowDict, MatDict, PoroDict, SatuDict, and ElastoDict modules of GeoDict.

PARALLEL COMPUTING AND MPI FOR WINDOWS

GeoDict uses the MPI message passing interface protocol to run parallel computations

in DiffuDict, ConductoDict, FlowDict, FilterDict-Media, FilterDict-Element, AddiDict, SatuDict and AcoustoDict. GeoDict’s parallel solvers use the MPI library from Microsoft.

If Microsoft MPI is not already installed, the Microsoft MPI v6 redistributable is installed into C:\Program Files\Microsoft MPI during the installation of

GeoDict2015 as indicated in pages 5-6. If a previous version of Microsoft MPI is already installed in C:\Program Files\Microsoft HPC Pack 2012, the newer v6 version cannot be installed and

GeoDict routinely uses the older version. It is possible to manually uninstall the older Microsoft HPC Pack 2012 and install a newer Microsoft MPI from Microsoft’s web page,

but this is not necessary to run GeoDict2015.

Installation on Linux


INSTALLATION ON LINUX

Download the GeoDict version appropriate for your system. To find out if the version runs on your linux system, type

getconf GNU_LIBC_VERSION

and get (for example) glibc 2.19 as output.

For this example, you would have to install a GeoDict version that was linked against a version smaller or equal than glibc 2.19. That is, you can install the glibc 2.12 version provided for download on the web page.

After downloading the .tgz file, move the file to the folder where you want to install GeoDict and extract GeoDict by typing

tar -xzvf *.tgz

The folder (GeoDict2015-Rev****-linux-64-glibc*.**) is created and contains all GeoDict files. The exact folder name and tar-file name depend on build version and

date.

Launch GeoDict by using the script

geodict.sh

from this installation folder.

Optional: As administrator, create a link in /usr/local/bin to the geodict.sh in the

installation folder, such that the program can easily be started by the users.

GeoDict for Linux is now installed and ready for licensing.

PARALLEL COMPUTING AND MPI FOR LINUX

GeoDict uses the MPI message passing interface protocol to run parallel computations. GeoDict’s parallel solvers are linked against the MPICH2 library from

Argonne National Lab. To run these MPI-parallel solvers, the mpiexec executable from the MPICH2 library has to be used. It is not possible to use the mpiexec executable provided by other packages like OpenMPI. It is also not possible to use a

version of MPICH2 older than 1.4.1p1. Therefore, the MPICH2 package (version 1.4.1p1 or higher) has to be installed on the Linux machine. Some Linux distributions,

e.g. Ubuntu, already contain the mpich2 package. In this case, the package can simply be installed by the system administrator with

sudo apt-get install mpich2

GeoDict2015 then automatically finds the mpiexec executable.

Should GeoDict2015 not start properly after licensing, the most likely reason is a missing library on your machine. To identify the missing library, type

ldd geodict2015 > libraries.txt

in the GeoDict installation folder. Check whether one or more libraries are labelled as Not found and send the file libraries.txt by email to

[email protected].



If the Linux distribution does not contain the mpich2 package, MPICH2 has to be compiled and installed as described in the following:

1. Installation of the MPICH2 library from Argonne National Lab

Ask your system administrator to install MPICH2 Version 1.4.1p1 on your

machine. We prefer an installation in the folder /usr/local/mpich2-1.4.1p1:

a. Download Mpich2 from www.mpich.org b. Unpack with tar -xvf mpich2-1.4.1p1.tar

c. cd mpich2-1.4.1p1 d. ./configure --prefix /usr/local/mpich2-1.4.1p1

e. make f. as root: make install

2. Adjust path to MPICH2 library in GeoDict shell script

If /usr/local/mpich2-1.4.1p1 or /usr/local/mpich2 was used as installation path, no changes in the script are necessary. Otherwise, you have to change line 86

MPIRUN=$MPIPATH/bin/mpiexec

in GD2015_externals.sh to point to your own Mpich2 installation path.

3. (optional) Adjusting GeoDict for usage on distributed memory clusters

This step is only necessary, if you want to distribute the parallel processes to computers with different hostnames, e.g. node001, node002, ... but it is not

needed on a shared memory machine.

Make sure, that no password is required when logging onto the machines used for parallel computations. If a password is required for each login, you have to

make your ssh agent password-free, so that no password is required when mpich uses the machines for the parallel computations. This must be done on

every machine and can be achieved by doing the following:

1. cd ~

2. ssh-keygen –t rsa

3. cd $HOME/.ssh

4. cat id_rsa.pub >> authorized_keys

When starting GeoDict for the first time, a settings folder with the name ~/.geodict2015/ is created in the user’s home folder. The names of hosts

and clusters can be defined in the file geodict_hosts.ini contained in this folder. Ask [email protected] if you need additional information.

Attention: Ubuntu allows to install mpich, OpenMpi, and possibly other variants of MPI at the same time. In that case /usr/bin/mpiexec will contain a link to

one of those versions. If this link will not point to mpich, GeoDict’s solvers will not run in parallel. To fix this, run as administrator

sudo update-alternatives --config mpirun

and choose the mpirun.mpich alternative. If this approach is not possible, either install MPICH2 as described below or adjust the path to the MPICH2

library as described in step 2 below to

MPIRUN=usr/bin/mpiexec.mpich

http://www.mpich.org/

Licensing GeoDict – Obtaining a GeoDict license


LICENSING GEODICT

In general, GeoDict licenses can be node-locked or floating.

1. Node-locked license:

A node-locked license is bound to the computer from which the license

request file (.glr) was generated.

Evaluation licenses are always node-locked and time-limited.

2. Floating license

A floating license allows to use the software everywhere in a local network.

To use a floating license, the OLicense Server must be installed before GeoDict can be used.

Evaluation licenses are NOT provided as floating licenses

REQUESTING A NODE-LOCKED OR EVALUATION LICENSE

After downloading and installing GeoDict, the GeoDict GUI opens automatically and requests a valid license to start.

If the GeoDict GUI does not open because you un-checked Launch GeoDict 2015 during the installation, double-click the GeoDict icon on your Windows desktop or, in Linux, call geodict.sh from the installation folder.



Then, in the Menu bar, select File →

Choose License File…. The GeoDict License dialog box (that opens

automatically after installation when Launch GeoDict 2015 was left checked

during installation) opens now.

Check the option that describes your situation. If you are new to GeoDict or already

a customer of Math2Market applying for or renewing a license, check one of these options.

Tool tips guide you through the procedure.

Type Your Name and the name of your

Organization (or Company), and then click OK. This generates a .glr (GeoDict license request) file that is saved at the

default or specified location. The path to the GeoDict license request file is

shown in the message dialog box.

The saved .glr file contains information that identifies the computer on which it

was generated and that is needed to issue a license file that is exclusive for

the computer.

Licensing GeoDict – Obtaining a GeoDict license


Now, as indicated in the message:

1. Write an e-mail with the subject line License request, and

a) If you are new to GeoDict, follow the instructions shown in the message

and enter all the information needed in the body of the e-mail.

b) If you are a customer of Math2Market who is renewing the license, or have contacted us otherwise and we have agreed to provide you with an

evaluation license, there is no need to enter the complete information.

2. Attach the saved .glr (GeoDict license request) file to the e-mail (here:

2015BarbaraPlanasMath2Market.glr).

3. Send the e-mail to [email protected]

After a positive outcome of the application, a reply e-mail is sent containing an attached license file (*.lic). An evaluation license is valid for a limited time and only for the computer on which the GeoDict license request file was generated.

It is a good idea to save the received license file (*.lic) into a subfolder of the folder where you intend to keep GeoDict, e.g. .../GeoDict/GeoDictLicenses/*.lic.



REQUESTING A FLOATING LICENSE

GeoDict uses OLicense (www.olicense.com) to manage floating licenses and, thus, an OLicense server has to be installed to use GeoDict. The operating system of the

computer on which you install the OLicense server is independent of the operating system under which GeoDict is installed. You may run GeoDict on a Windows OS

computer while the OLicense server is installed on a Linux OS computer, and vice versa. The OLicense server and GeoDict may be installed on the same computer.

The OLicense server can be downloaded from:

Math2Market: www.geodict.com/Support/Installation/Olicense.php

OLicense homepage: www.olicense.com

After downloading and unpacking the OLicense server on a Windows or Linux computer, proceed as follows:

1. Start OLicenseServerCtrl.exe (Windows) or OLicenseServerCtrl.lin (Linux). The OLicense-Server-Control dialog box opens.

2. In the Service Mode panel, click Install as Service (Admin Rights Required).

3. In the Actions panel, click Start Local.

4. In the Content panel, click Open Browser Frontend (View/Administrate Content).

5. The OLicense-Server content is then shown in your computer's standard web browser.

6. In the row Server Administration, click Administer Server....

7. Choose a User Name and a Password and click OK.

8. In the OLicense-Server Attributes, click Export Server Info... in the row Preferred Server ID. This creates an OLicense.olsiml file, saved by clicking OK.

The OLicense.olsiml file is similar to the following when opened with a text editor:

< !DOCTYPE OLicenseInfo>

< OLicenseInfo>

< version> 4.0.0

< hostname> psl140

< tcpip> 172.17.1.184

< system> Windows_XP

< release> 5.1 Service Pack 3

< serverId type="MAC"> 001a6bce65b4

< serverId type="UUID"> C7PpKRcr35ciWqKn7syvuQ

< serverId type="HMAC"> 2eb6487abe5ea7ecd1e6-bcb072be60ff563e99ec

< /OLicenseInfo>

9. The port number is shown in the line Server is running on port ... (Local mode).

E-mail the created OLicense.olsiml file and the shown port number to

[email protected] to request a license.

http://www.olicense.com/

http://www.geodict.com/Support/Installation/Olicense.php

http://www.olicense.com/

If GeoDict does not start after licensing


INSTALLING A NODE-LOCKED LICENSE

Having received a GeoDict license file (*lic), you are ready to load and install the license and begin using GeoDict.

INSTALLATION AS USER

In Windows, double-click the GeoDict2015 icon that appeared on the desktop after

downloading GeoDict2015, or find and double click the executable geodict2015.exe.

In Linux, call geodict.sh from the installation folder.

The GeoDict License dialog box

opens.

This time, check Install License

file and click Find License…. Tool tips guide you through the procedure.

In the opening Select File dialog box, navigate the path to the folder

where you saved the received license file (e.g. .../GeoDict/GeoDictLicenses), and

click Open to install the license.

Back in the GeoDict License

dialog box, leave Set license as default checked, so that GeoDict

starts immediately when clicking its icon once the license is installed.



If left un-checked, it would be necessary to click Find License... and to repeat the

process of finding the license every time you want to work with GeoDict.

After the license has been loaded, the license information is updated to reflect the

Status: Valid, the license Expiry Date, the Type of license, the License Owner, its Description, the license File Name, and the Location of the installed license (here

.../M2M/GeoDictLicenses).

A message confirms that the license was installed successfully.

Click OK to close the message.

The GeoDict GUI appears automatically, and you are all set to work with GeoDict.

If GeoDict does not start after licensing


INSTALLATION AS ADMINISTRATOR

To install a GeoDict license for all users, open the file geodict_licenses.ini that can be found in the GeoDict installation folder at:

with a text editor, e.g. Notepad++.

In this file, uncomment the first line by removing the // and then change the path to

where your license file was saved. For example:

Afterwards, the license is automatically available for all users.



INSTALLING A FLOATING LICENSE

The user of a floating license receives two license files from Math2Market GmbH.

The .lic license file is used to operate GeoDict, and the .olixml license file is used to

operate the OLicense-Server.

Proceed as follows to install the .olixml file on the license server:

1. After receiving these license files, save them to your hard drive.

2. Start OLicenseServerCtrl.exe (Windows) or OLicenseServerCtrl.lin (Linux).

3. The OLicense-Server-Control dialog box opens. Click Open Browser Frontend (View/Administrate Content) to open the OLicense-Server Home page in your

standard web browser.

4. In the License Import row, click Browse... to find the .olixml license file that was

sent to you and you saved on your hard drive.

5. When the path to the .olixml license file appears in the field, click Import Selected XML.

Afterwards, install the .lic file as described for node-locked licenses in pages 15-16.

Un-installing GeoDict


IF GEODICT DOES NOT START AFTER LICENSING

GeoDict may not recognize the license file after:

GeoDict and your e-mail program are used on different operating systems, and a transfer program might have changed line ends when saving or moving files.

Modifications to the computer hardware have resulted in the license file to become

invalid for your computer. License files are issued for a specific configuration.

Expiration of a GeoDict evaluation license file.

Changes in the connection mode of the computer for which the license request was created.

Contact [email protected] with any questions and, if asked to do so, send a newly generated .glr file following the procedure outlined above in pages 12-13.

UN-INSTALLING GEODICT

Be logged on as administrator on the computer and then,

1. Locate the folder where GeoDict is installed. By default, GeoDict can be found at

Find and double-click unins000.exe.

2. The uninstaller detects the installed GeoDict.

Click Yes to uninstall GeoDict.

3. The uninstaller wizard automatically removes GeoDict and its components. Files that remain in user-created folders may not be removed and should be removed

manually if needed.

4. Click OK to complete the un-installation process.

Math2Market GmbH Stiftplatz 5

67655 Kaiserslautern

Web: http://www.geodict.com

© Fraunhofer Institut Techno- und Wirtschaftsmathematik ITWM, 2003-2011. © Math2Market GmbH, 2011-2016. All rights reserved.

Date post:	27-May-2020
Category:	Documents
Upload:	others
View:	32 times
Download:	1 times

GeoDict Download, Installation and Licensing 2015 · GeoDict 2015 download, installation, and...

Documents