Theseus Installation

7/27/2019 Theseus Installation

1/18

InstallationVersion 4.2

P+Z Engineering GmbH, Munich

www.theseus-fe.com


2/18

2

Legal NoticesCopyright 2012 P+Z Engineering GmbH. All Rights Reserved.

The information contained herein is the property of P+Z Engineering GmbH. Any use, copy, publication, distribution,display, modification, or transmission of the information in whole or in part in any form or by any means without theprior express written permission of P+Z Engineering GmbH is strictly prohibited. Except when expressly provided byP+Z Engineering GmbH in writing, possession of this information shall not be construed to confer any license orrights under any of P+Z Engineering GmbHs intellectual property rights, whether by e stoppel, implication, orotherwise.ALL COPIES OF THE INFORMATION, IF ALLOWED BY P+Z ENGINEERING GMBH, MUST DISPLAY THISNOTICE OF COPYRIGHT AND OWNERSHIP IN FULL.

THESEUS-FE

is a copyright protected and registered trademark of P+Z Engineering GmbH.

All other brand and product names mentioned herein are the trademarks and registered trademarks of theirrespective owners.

Printed in Germany.June 2012


3/18

3

About this document

P+Z Engineering GmbH reserves the right to make changes or improvements to thesoftware product described in this document without notice. P+Z Engineering GmbHassumes no responsibility for any factual or typographical errors or omissions that may

have occurred. P+Z Engineering GmbH has however made every effort to ensure thatthe information contained in this Manual is accurate.

This document describes the installation process of THESEUS-FE.

After installation you will find further information in the

GUI Manual

Theory Manual

Keyword Manual

Tutorial Manual

Validation Manual

Transformer Manual

also shipped with this release.

If you have any further questions, please contact:

P+Z Engineering GmbH

Anton-Ditt-Bogen 380939 MunichGermany

Phone: +49 89 31857 466Fax: +49 89 31857 333

To see the latest THESEUS-FE software and services, please visit our web site at:http://www.theseus-fe.com

Questions about pricing, sales, availability and general issues should be directed to:[email protected]

Technical and scientific support issues should be addressed to:[email protected]
mailto:[email protected]:[email protected]


4/18

4

1. INSTALLATION ................................................................................... 51.1. System Requirements ..................................................................................... 51.2. License File ...................................................................................................... 51.3. Important Notes ............................................................................................... 6

2. THESEUS-FE ON MICROSOFTWINDOWS PLATFORMS .............. 82.1. Installation on Windows ................................................................................. 82.2. Uninstallation on Windows .......................................................................... 112.3.

Setting up FlexNet Licensing on Windows ................................................. 12

2.3.1 Step 1: Check Integrity and Setup LMTOOLS.......................................... 122.3.2 Step 2: Use Services ................................................................................ 122.3.3 Step 3: Restart License Server ................................................................ 132.3.4 Step 4: Check for success ....................................................................... 14

3. THESEUS-FE ON LINUX PLATFORMS ........................................... 153.1. Installation on Linux ..................................................................................... 15

3.1.1 Setting up THESEUS-FE 4.2 ................................................................... 153.1.2 Setting up OpenMPI ................................................................................. 16

3.2. Setting up FlexNet Licensing on Linux ....................................................... 174. FIRST STEPS .................................................................................... 18


5/18

5

1. Installation

1.1. System Requirements

This release of THESEUS-FE is available for Windows (x86 and x64) and Linux (x64)operating systems only. Novel architectures or new hardware platforms not listed belowmay be supported by specific arrangement with P+Z Engineering GmbH. The actualsystem requirements are summarized in the following table.

Minimum requirements

Windows XP SP2, Windows Vista SP2 orWindows 7 SP1Intel/AMD 2,0 GHzgraphics card with OpenGL 3.0 capability2 GB RAM

Red Hat Enterprise Server 4Intel/AMD 1,5 GHzgraphics card with OpenGL 3.0 capability2 GB RAM

Recommended

cpu clock speed 2,8 GHzRAM 4 GBgraphics memory 512 MB

THESEUS-FE is delivered as a full operative release, which can be run as a stand-alone application on those platforms. Nevertheless an appropriate FORTRAN90 (orC++) compiler may be necessary if the user wishes to work with individually adjusteduser subroutines1.Furthermore, some additional third-party software (e.g. HDFView, TISC, various post-processors etc.) may be very useful, convenient and time saving in your day-to-daywork. We explicitly recommend the installation of such third-party products to benefitfrom all features included in THESEUS-FE. Make sure to always use the newestversions of these third-party software programs. The installation of such products iscompletely independent of the THESEUS-FE installation and described in the

documentation of each of these tools individually. Freely available tools will be availableon the THESEUS-FE homepage in the customer area as long as it is allowed by theirlicense agreement. HDFView can be obtained fromhttp://www.hdfgroup.org/hdf-java-html/hdfview/while information regarding TISC can be found athttp://www.tlk-thermo.com/.

1.2. License FileTo run THESEUS-FE on your workstation or PC system a customer-specific license fileis required. To generate license files for you we need to obtain some information about

1See Keyword Manual, Appendix C
http://www.hdfgroup.org/hdf-java-html/hdfview/http://www.hdfgroup.org/hdf-java-html/hdfview/http://www.hdfgroup.org/hdf-java-html/hdfview/http://www.hdfgroup.org/hdf-java-html/hdfview/http://www.tlk-thermo.com/http://www.tlk-thermo.com/http://www.tlk-thermo.com/http://www.tlk-thermo.com/http://www.tlk-thermo.com/http://www.tlk-thermo.com/http://www.hdfgroup.org/hdf-java-html/hdfview/http://www.hdfgroup.org/hdf-java-html/hdfview/


6/18

6

your license server and/or local workstation. Please run the commands tabled below foryour appropriate system and email the output to [email protected] we will generate the license file for you and send it back using your providedemail address.The license file will usually be called Theseus.lic.

platform host IDtype in these commands in a terminal(Linux) or DOS shell (Windows)

to get MACaddresses such as

Linuxethernetaddress

If FlexNet is available:

hostname lmhostid

otherwise:

/sbin/ifconfig

00:A1:D2:BF:4B:12

Windowsethernetaddress

If FlexNet is available

lmtools tab: SystemSettings

lmutil lmhostid -ether

otherwise:

ipconfig /all

00-A1-D2-BF-4B-12

Even though the license file is a readable and pure ASCII-based text file, it is notrecommended to change the content of the file. Otherwise you may destroy your currentlicense and lose your access to THESEUS-FE. Also you will lose our warranty forproper use of all functionalities.

1.3. Important NotesP+Z Engineering GmbH explicitly disclaims any liability for any special, consequential orincidental damages or data losses arising from the installation or use of the program.On the other hand P+Z Engineering guarantees that the installer has been virus

checked and generated under strict quality control.The THESEUS-FE installer can be downloaded from the internet at www.theseus-fe.com from the customer area.

Note:We strongly recommend uninstalling any older version of THESEUS-FE before youstart the setup process.To install the software on any supported platform, you must be logged in as a localadministrator at least. If you receive an error when attempting to installTHESEUS-FE, contact your responsible systems administrator to determine if youhave the correct privileges

THESEUS-FE is a FlexNet Licensing protected application using served and/or node-

locked license files. As it is a popular licensing standard in the CAx area, you may havesome other Flex-enabled applications already running in your network. To integrate
mailto:[email protected]://www.theseus-fe.com/http://www.theseus-fe.com/http://www.theseus-fe.com/http://www.theseus-fe.com/mailto:[email protected]


7/18

7

THESEUS-FE seamlessly into your licensing environment it is recommended to contactyour responsible system administrator. In the following we assume that you or yourresponsible system administrator are familiar with this licensing system and will notexplain all features of the FlexNet Licensing module. A very detailed description withfurther information is covered in the FlexNet License Administration Guidefnp_LicAdmin_11_9_1.pdf which can be found in the FlexNet installation directory.

The FlexNet documentation refers to the vendor daemon name. This name occurs in anumber of places, the vendor daemon of P+Z Engineering is called puzld (puzld.exeon Windows).The license server can be located on a different machine which may even run adifferent operating system than your THESEUS-FE installation. All communication withthe license server will take place via the TCP/IP network interface.


8/18

8

2. THESEUS-FE on Microsoft

Windows

Platforms

2.1. Installation on WindowsTo install and run THESEUS-FE on Microsoft Windows XP, Vista or Windows 7 (olderplatforms will not be supported), you require:

PC system that meets the recommended system requirements (listed in Section1.1, System Requirements)

Administration privileges

Active connection to your local network for the license request

Valid THESEUS-FE license key. If your key was not included within yourinstallation distribution order it via email from [email protected]

Network license server that is able to run the FlexNet license daemon.

It is recommended to exit all other software applications before you start the setupprocess.

Start the THESEUS-FE setup file for your platform (e.g. THESEUS-FE-4.2_win-x64_Setup.exe for the Windows 64bit setup).The following dialog window will appear:

Figure 1: Welcome page of the THESEUS-FE installer

Just follow the installer instructions on the screen to complete the setup. At theSelectComponents page you will be asked to select different optional packages,namely the FlexNet License Administration tools and THESEUS-FE Tutorial &Validation models.
mailto:[email protected]:[email protected]:[email protected]


9/18

9

Figure 2: Component selection in the THESEUS-FE installation routine

If you have enough space on your hard disk available, we recommend using the defaultoptions. On the other hand you are free to deselect these optional packages without anyloss of the THESEUS-FE functionality. It may make sense to deselect the FlexNetLicensing system if you have a newer version already installed for example. After asuccessful setup the following dialogue window should appear on the screen and if thecheckbox is not deactivated, THESEUS-FE will be started directly afterwards.

Remark: The THESEUS-FE GUI will only start properly, if FlexNet licensing had alreadybeen set up for this machine. See chapter 2.3 for information regarding the set upprocess.

Figure 3: Successful setup completion of the THESEUS-FE installation


10/18

10

In case the installation did not succeed, please contact our technical supportimmediately via e-mail or phone.

Anytime you would like to use THESEUS-FE again, simply double-click the iconcreated on your desktop while installation or select THESEUS-FE in the

StartProgramsTHESEUS-FE 4.2 standard folder. Alternatively you can use the

theseus_gui.bat file, which can be found in the standard installation folder (by defaultthis is C:\Program Files\THESEUS-FE 4.2) to start THESEUS-FE 4.2.

When starting THESEUS-FE, a start screen with information about the current releasewill appear.

Figure 5: Splash screen of THESEUS-FE

Exiting THESEUS-FE is as easy as starting it. You can exit THESEUS-FE either byclicking on the menu File and then selecting the Exit option, by clicking the standardexit icon in the upper right-hand corner like in every Windows application or alternativelyby using the keyboard shortcut [Ctrl]+Q.


11/18

11

2.2. Uninstallation on WindowsThere are different ways to uninstall THESEUS-FE from your local Windows system:

Figure 6: Removal of the THESEUS-FE program installation

Go to the Add/Remove Program menu of your Windows version accessible via theControl Panel. Select THESEUS-FE 4.2 and click Remove or Uninstall. Theuninstaller will start. Follow the instructions of the wizard to uninstall THESEUS-FE.Alternatively, go to your THESEUS-FE installation directory on your local hard drive andexecute the file uninstall.exe manually.After a successful removal of the program the following dialog window should appear:

Figure 7: Removal of the THESEUS-FE program installation

Technical Note:The automated uninstall process also deletes all related entries in the Windows

registry and environmental variables. This means that you do not need to search theregistry for failed links. Nevertheless we recommend restarting Windows to ensurethat all registry entries are completely deleted. The FlexNet Licensing module files willintentionally not be removed as FlexNet might be used by other programs.


12/18

12

2.3. Setting up FlexNet Licensing on WindowsAttention: We recommend reading the FlexNet License Administration Guidefnp_LicAdmin_11_9_1.pdfdistributed with the installation of THESEUS-FE first, as it isthe official product guide from Flexera Software and contains all required information

for advanced license administration topics.The default location of the FlexNet license administration tools after the installation ofTHESEUS-FE is c:\flexlm. In this directory the vendor daemon namedpuzld.exe shouldbe located, too. We also recommend placing the license file for THESEUS-FE whichusually is named Theseus.licin this directory.

2.3.1 Step 1: Check Integrity and Setup LMTOOLS

Put the license file Theseus.licinto the same location where the license managerlmgrd.exe is installed (usually c:\flexlm). Start LMTOOLS (lmtools.exe) and switch to the

Config Services tab. Specify your individual settings there.

2.3.2 Step 2: Use Services

Switch to the Service/License File tab. Mark check box Configuration using Servicesand select your service name set up in previous Step 1.


13/18

13

2.3.3 Step 3: Restart License Server

First stop the license server completely. Take care that all programs which havechecked out licenses at this moment might lose their connection to the correspondingvendor daemon and possibly will fail to operate. Then restart the license manager againand re-read the license file(s).

12 3


14/18

14

2.3.4 Step 4: Check for success

Push the Perform Status Enquiry button and check the output for success. In somecases it is necessary to shut down the computer completely and restart the computeragain.


15/18

15

3. THESEUS-FE on Linux Platforms

Remark:The term will be used throughout the Linux installation guide and should be

replaced with the directory where you install THESEUS-FE 4.2 on your machine.

3.1. Installation on LinuxTo install and run THESEUS-FE on Linux platforms you require:

PC system that meets the recommended system requirements (listed in Section1.1, System Requirements)

Active connection to your local network for the license request

Valid THESEUS-FE license key. If your key was not included within your

installation distribution order it via email from [email protected] Network license server that is able to run the FlexNet license daemon.

3.1.1 Setting up THESEUS-FE 4.2

Extract the tar-archive theseusfe-4.2.00_linux-x64.tar.gzcontaining THESEUS-FE 4.2for Linux x64 platforms in a directory where you want it to be installed.

tar -xzvf theseusfe-4.2.00_linux-x64.tar.gz

A subdirectory named theseusfe-4.2.00_linux-x64 will be created in your currentdirectory. This contains all the necessary data to run THESEUS-FE 4.2.

Depending on your way to set up the license server in your local network environment,the program start script in the installation directory named theseus.sh might have to beadjusted. See chapter 3.2 for further details on setting up FlexNet licensing forTHESEUS-FE.If you have licensed the THESEUS-FE OVEN module and want to run calibrationsimulations using the THESEUS-FE Optimizer, OpenMPI has to be configured. Seechapter 3.1.2 for information about configuring it.

After the license server (and optionally OpenMPI) have been set up, the start scripttheseus.sh (or the symbolic link named theseus pointing to it) can be used to start theindividual programs in the THESEUS-FE package:

Examples:running the solver from the command line:

./theseus.sh sol job=MyJob.tfe inter

starting the GUI:./theseus.sh gui
mailto:[email protected]:[email protected]:[email protected]


16/18

16

starting the GUI for the OVEN module:

./theseus.sh gui oven

running the THESEUS-FE Transformer:

./theseus.sh tf t=task

The THESEUS-FE Transformer can be called from the command line. But the call canget quite lengthy and complex due to the number of arguments needed thus it isadvisable to use the GUI frontend for the Transformer which is accessible through theTHESEUS-FE GUI in the "Tools" menu.

3.1.2 Setting up OpenMPI

(This step is only necessary to set up the THESEUS-FE Optimizer used in the OVENmodule)

The THESEUS-FE Optimizer has been compiled and tested with OpenMPI 1.4.1.It is recommended to use this version but it should also work with slightly older andnewer versions of OpenMPI.The source code for OpenMPI 1.4.1 can be downloaded from the customer area of ourhomepage. Newer versions can be obtained athttp://www.open-mpi.org/.OpenMPI must be compiled with interfaces for Fortran90 and Fortran77.We recommend using the Intel Fortran Compiler Professional Edition for Linux v11.x ornewer.

It has also been tested successfully with g77and gfortran as replacements for the IntelFortran compiler.After compiling and setting up OpenMPI, adjust the variable named mpidirin start scripttheseus.sh. It has to contain the root directory of your OpenMPI installation.If you need help to compile OpenMPI please consult the official documentation.

3.1.3 Setting up THESEUS-FE Optimizer to run in the command line

(This step is only necessary, if the THESEUS-FE Optimizer used in the OVEN moduleshall be usable from the command line instead of the GUI interface. This might be

necessary for job queuing systems and/or high-performance clusters.)

THESEUS-FE Optimizer has to be called using the process manager provided with theOpenMPI installation called mpirun to fulfill its purpose of running several THESEUS-FEsimulations in parallel.

A command line call of the Optimizier will look similar to this one:

mpirun np NP [-hostfile HOSTFILE] [--mca btl tcp,self]/bin/theseus_opti jobname=thsexec=/bin/theseus_sol
http://www.open-mpi.org/http://www.open-mpi.org/http://www.open-mpi.org/http://www.open-mpi.org/


17/18

17

Here, NPis the number of processors that shall be used. Providing a HOSTFILEcontaining a list of cluster nodes which may be used is optional. The Option --mca btltcp,selfmay help to resolve issues with the byte transfer layer used on some machines.The optionsjobname= and thsexec= are not interpreted by mpirun but rather passed onto the Optimizer.

To guarantee that the Optimizer and the OpenMPI process manager can run properly,the following environment variables should be adjusted:

PATH: add /bin and /binLD_LIBRARY_PATH: add /libCOMPONENT_PATH: add /lib/openmpi

For additional information on using the Optimizer please consult the Oven Tutorialmanual. For information regarding the available options for the OpenMPI processmanagermpirun have a look at the OpenMPI documentation.

3.2. Setting up FlexNet Licensing on LinuxWe recommend reading the FlexNet License Administration Guidefnp_LicAdmin_11_9_1.pdffor a detailed explanation of the steps necessary to set upFlexNet licensing. It can found in the /flexlm directory.Please have a look especially at chapter 4, "Locating Licenses".For a brief guidance to set it up you can follow the steps below:

a) To set up FlexNet licensing for THESEUS-FE, if a license server is already set upIf a FlexNet license server is already set up with the licenses for THESEUS-FE enabled,

you can conveniently adjust the variables named lic_serverand lic_portin theseus.sh.The default port number used the FlexNet license server is 27000. Variable lic_serverhas to contain either the host name or the IP address under which the license servercan be reached in the network.

b) To set up a FlexNet license server on your local machine:Place the license file you received for THESEUS-FE in the /flexlm directoryand name it Theseus.lic.You can start the license server manually using the script start_lmgrd.sh located in theinstallation directory.If the name or location of the license file has changed, you have to adjust this script.

It is convenient to set up the license server to start automatically whenever Linux boots.The mechanism to make this work is distribution dependent.For example you could make a script in one of the runlevel directories under/etc/rc.d.Administration privileges will be needed to write to this directory.


18/18

18

4. First Steps

Open the THESEUS-FE GUI, either from the Start menu under Windows, or from thecommand line under Linux. As a new user, we recommend that you work on the

THESEUS-FE Tutorials. The Tutorial Manual can be opened from the main menu viaHelp/Tutorial Manual.If you are interested in learning about the mathematical and physical background ofTHESEUS-FE, we suggest you have a look at the Theory Manual, accessible viaHelp/Theory Manual.

Theseus Installation

Documents

Transcript of Theseus Installation