Installation

Version 4.2

P+Z Engineering GmbH, Munich www.theseus-fe.com

Legal Notices
Copyright 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 the prior express written permission of P+Z Engineering GmbH is strictly prohibited. Except when expressly provided by P+Z Engineering GmbH in writing, possession of this information shall not be construed to confer any license or rights under any of P+Z Engineering GmbHs intellectual property rights, whether by e stoppel, implication, or otherwise. ALL COPIES OF THE INFORMATION, IF ALLOWED BY P+Z ENGINEERING GMBH, MUST DISPLAY THIS NOTICE 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 their respective owners. Printed in Germany. June 2012

About this document

P+Z Engineering GmbH reserves the right to make changes or improvements to the software product described in this document without notice. P+Z Engineering GmbH assumes 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 that the 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 3 80939 Munich Germany Phone: +49 89 31857 466 Fax: +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: sales@theseus-fe.com Technical and scientific support issues should be addressed to: support@theseus-fe.com

1. INSTALLATION ................................................................................... 5
1.1. 1.2. 1.3. System Requirements ..................................................................................... 5 License File ...................................................................................................... 5 Important Notes ............................................................................................... 6

2. THESEUS-FE ON MICROSOFT WINDOWS PLATFORMS .............. 8

2.1. 2.2. Installation on Windows ................................................................................. 8 Uninstallation on Windows .......................................................................... 11

2.3. Setting up FlexNet Licensing on Windows ................................................. 12 2.3.1 Step 1: Check Integrity and Setup LMTOOLS.......................................... 12 2.3.2 Step 2: Use Services ................................................................................ 12 2.3.3 Step 3: Restart License Server ................................................................ 13 2.3.4 Step 4: Check for success ....................................................................... 14

3. THESEUS-FE ON LINUX PLATFORMS ........................................... 15

3.1. Installation on Linux ..................................................................................... 15 3.1.1 Setting up THESEUS-FE 4.2 ................................................................... 15 3.1.2 Setting up OpenMPI ................................................................................. 16 3.2. Setting up FlexNet Licensing on Linux ....................................................... 17

4. FIRST STEPS .................................................................................... 18

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 below may be supported by specific arrangement with P+Z Engineering GmbH. The actual system requirements are summarized in the following table. Minimum requirements

Windows XP SP2, Windows Vista SP2 or Windows 7 SP1 Intel/AMD 2,0 GHz graphics card with OpenGL 3.0 capability 2 GB RAM Recommended cpu clock speed 2,8 GHz RAM 4 GB graphics memory 512 MB

Red Hat Enterprise Server 4 Intel/AMD 1,5 GHz graphics card with OpenGL 3.0 capability 2 GB RAM

THESEUS-FE is delivered as a full operative release, which can be run as a standalone application on those platforms. Nevertheless an appropriate FORTRAN90 (or C++) compiler may be necessary if the user wishes to work with individually adjusted user subroutines1. Furthermore, some additional third-party software (e.g. HDFView, TISC, various postprocessors etc.) may be very useful, convenient and time saving in your day-to-day work. We explicitly recommend the installation of such third-party products to benefit from all features included in THESEUS-FE. Make sure to always use the newest versions of these third-party software programs. The installation of such products is completely independent of the THESEUS-FE installation and described in the documentation of each of these tools individually. Freely available tools will be available on the THESEUS-FE homepage in the customer area as long as it is allowed by their license agreement. HDFView can be obtained from http://www.hdfgroup.org/hdf-javahtml/hdfview/ while information regarding TISC can be found at http://www.tlkthermo.com/.

1.2. License File

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

See Keyword Manual, Appendix C

your license server and/or local workstation. Please run the commands tabled below for your appropriate system and email the output to support@theseus-fe.com. Afterwards we will generate the license file for you and send it back using your provided email address. The license file will usually be called Theseus.lic. type in these commands in a terminal (Linux) or DOS shell (Windows) to get MAC addresses such as

platform

host ID

If FlexNet is available: Linux ethernet address hostname lmhostid /sbin/ifconfig 00:A1:D2:BF:4B:12

otherwise:

If FlexNet is available Windows ethernet address lmtools tab: System Settings lmutil lmhostid -ether ipconfig /all 00-A1-D2-BF-4B-12

otherwise: Even though the license file is a readable and pure ASCII-based text file, it is not recommended to change the content of the file. Otherwise you may destroy your current license and lose your access to THESEUS-FE. Also you will lose our warranty for proper use of all functionalities.

1.3. Important Notes

P+Z Engineering GmbH explicitly disclaims any liability for any special, consequential or incidental 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.theseusfe.com from the customer area. Note: We strongly recommend uninstalling any older version of THESEUS-FE before you start the setup process. To install the software on any supported platform, you must be logged in as a local administrator at least. If you receive an error when attempting to install THESEUS-FE, contact your responsible systems administrator to determine if you have the correct privileges THESEUS-FE is a FlexNet Licensing protected application using served and/or nodelocked license files. As it is a popular licensing standard in the CAx area, you may have some other Flex-enabled applications already running in your network. To integrate 6

THESEUS-FE seamlessly into your licensing environment it is recommended to contact your responsible system administrator. In the following we assume that you or your responsible system administrator are familiar with this licensing system and will not explain all features of the FlexNet Licensing module. A very detailed description with further information is covered in the FlexNet License Administration Guide fnp_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 a number of places, the vendor daemon of P+Z Engineering is called puzld (puzld.exe on Windows). The license server can be located on a different machine which may even run a different operating system than your THESEUS-FE installation. All communication with the license server will take place via the TCP/IP network interface.

2. THESEUS-FE on Microsoft Windows Platforms

2.1. Installation on Windows
To install and run THESEUS-FE on Microsoft Windows XP, Vista or Windows 7 (older platforms will not be supported), you require: PC system that meets the recommended system requirements (listed in Section 1.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 your installation distribution order it via email from support@theseus-fe.com 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 setup process. Start the THESEUS-FE setup file for your platform (e.g. THESEUS-FE-4.2_winx64_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 the Select Components page you will be asked to select different optional packages , namely the FlexNet License Administration tools and THESEUS-FE Tutorial & Validation models. 8

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

If you have enough space on your hard disk available, we recommend using the default options. On the other hand you are free to deselect these optional packages without any loss of the THESEUS-FE functionality. It may make sense to deselect the FlexNet Licensing system if you have a newer version already installed for example. After a successful setup the following dialogue window should appear on the screen and if the checkbox is not deactivated, THESEUS-FE will be started directly afterwards. Remark: The THESEUS-FE GUI will only start properly, if FlexNet licensing had already been set up for this machine. See chapter 2.3 for information regarding the set up process.

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

In case the installation did not succeed, please contact our technical support immediately via e-mail or phone. Anytime you would like to use THESEUS-FE again, simply double-click the icon created 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 default this 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 release will appear.

Figure 5: Splash screen of THESEUS-FE

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

10

2.2. Uninstallation on Windows

There 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 the Control Panel. Select THESEUS-FE 4.2 and click Remove or Uninstall. The uninstaller 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 and execute 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 the registry for failed links. Nevertheless we recommend restarting Windows to ensure that all registry entries are completely deleted. The FlexNet Licensing module files will intentionally not be removed as FlexNet might be used by other programs.

11

2.3. Setting up FlexNet Licensing on Windows

Attention: We recommend reading the FlexNet License Administration Guide fnp_LicAdmin_11_9_1.pdf distributed with the installation of THESEUS-FE first, as it is the 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 of THESEUS-FE is c:\flexlm. In this directory the vendor daemon named puzld.exe should be located, too. We also recommend placing the license file for THESEUS-FE which usually is named Theseus.lic in this directory.

2.3.1 Step 1: Check Integrity and Setup LMTOOLS

Put the license file Theseus.lic into the same location where the license manager lmgrd.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 Services and select your service name set up in previous Step 1.

12

2.3.3 Step 3: Restart License Server

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

13

2.3.4 Step 4: Check for success

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

14

3. THESEUS-FE on Linux Platforms

Remark: The term <install-dir> 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 Linux

To install and run THESEUS-FE on Linux platforms you require: PC system that meets the recommended system requirements (listed in Section 1.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 support@theseus-fe.com 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.gz containing THESEUS-FE 4.2 for 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 current directory. 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 be adjusted. See chapter 3.2 for further details on setting up FlexNet licensing for THESEUS-FE. If you have licensed the THESEUS-FE OVEN module and want to run calibration simulations using the THESEUS-FE Optimizer, OpenMPI has to be configured. See chapter 3.1.2 for information about configuring it. After the license server (and optionally OpenMPI) have been set up, the start script theseus.sh (or the symbolic link named theseus pointing to it) can be used to start the individual 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

15

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 can get quite lengthy and complex due to the number of arguments needed thus it is advisable to use the GUI frontend for the Transformer which is accessible through the THESEUS-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 OVEN module) 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 and newer versions of OpenMPI. The source code for OpenMPI 1.4.1 can be downloaded from the customer area of our homepage. Newer versions can be obtained at http://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 or newer. It has also been tested successfully with g77 and gfortran as replacements for the Intel Fortran compiler. After compiling and setting up OpenMPI, adjust the variable named mpidir in start script theseus.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 module shall 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 the OpenMPI installation called mpirun to fulfill its purpose of running several THESEUS-FE simulations in parallel. A command line call of the Optimizier will look similar to this one:
mpirun np NP [-hostfile HOSTFILE] [--mca btl tcp,self] <install-dir>/bin/theseus_opti jobname=<opti-job-name> thsexec=<install-dir>/bin/theseus_sol

16

Here, NP is the number of processors that shall be used. Providing a HOSTFILE containing a list of cluster nodes which may be used is optional. The Option --mca btl tcp,self may help to resolve issues with the byte transfer layer used on some machines. The options jobname= and thsexec= are not interpreted by mpirun but rather passed on to the Optimizer. To guarantee that the Optimizer and the OpenMPI process manager can run properly, the following environment variables should be adjusted: PATH: add <inst-dir>/bin and <OpenMPI-inst-dir>/bin LD_LIBRARY_PATH: add <OpenMPI-inst-dir>/lib COMPONENT_PATH: add <OpenMPI-inst-dir>/lib/openmpi For additional information on using the Optimizer please consult the Oven Tutorial manual. For information regarding the available options for the OpenMPI process manager mpirun have a look at the OpenMPI documentation.

3.2. Setting up FlexNet Licensing on Linux

We recommend reading the FlexNet License Administration Guide fnp_LicAdmin_11_9_1.pdf for a detailed explanation of the steps necessary to set up FlexNet licensing. It can found in the <install-dir>/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 up If a FlexNet license server is already set up with the licenses for THESEUS-FE enabled, you can conveniently adjust the variables named lic_server and lic_port in theseus.sh. The default port number used the FlexNet license server is 27000. Variable lic_server has to contain either the host name or the IP address under which the license server can 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 <install-dir>/flexlm directory and name it Theseus.lic. You can start the license server manually using the script start_lmgrd.sh located in the installation 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.

17

4. First Steps
Open the THESEUS-FE GUI, either from the Start menu under Windows, or from the command 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 via Help/Tutorial Manual. If you are interested in learning about the mathematical and physical background of THESEUS-FE, we suggest you have a look at the Theory Manual, accessible via Help/Theory Manual.

18