Installation

Version 4.2

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

IF ALLOWED BY P+Z ENGINEERING GMBH. display. Except when expressly provided by P+Z Engineering GmbH in writing. MUST DISPLAY THIS NOTICE OF COPYRIGHT AND OWNERSHIP IN FULL. ALL COPIES OF THE INFORMATION. The information contained herein is the property of P+Z Engineering GmbH. June 2012 ® 2 . THESEUS-FE is a copyright protected and registered trademark of P+Z Engineering GmbH. implication. whether by e stoppel. distribution. Printed in Germany.Legal Notices Copyright © 2012 P+Z Engineering GmbH. 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. copy. or otherwise. possession of this information shall not be construed to confer any license or rights under any of P+Z Engineering GmbH’s intellectual property rights. All Rights Reserved. All other brand and product names mentioned herein are the trademarks and registered trademarks of their respective owners. Any use. publication.

com 3 . This document describes the installation process of THESEUS-FE. availability and general issues should be directed to: sales@theseus-fe.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. please visit our web site at: http://www.com Questions about pricing.com Technical and scientific support issues should be addressed to: support@theseus-fe. sales. 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.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. If you have any further questions. P+Z Engineering GmbH has however made every effort to ensure that the information contained in this Manual is accurate.

................................. 15 3................. 6 2.....................2 Setting up OpenMPI .................. Installation on Linux ............................ 18 4 .....................................3............ 14 3.......................3...................................... THESEUS-FE ON LINUX PLATFORMS ..................................................... 15 3........1..........1 Setting up THESEUS-FE 4.......................................................................................1......... 5 License File ....3...............1.... 12 2........................... 8 2.... 17 4.................................................. 2......................2.................... 5 1.. 12 2...... FIRST STEPS .....1 Step 1: Check Integrity and Setup LMTOOLS........................................2........................................1........................ 5 Important Notes ....... 12 2.................... Installation on Windows ................ 15 3...................... Setting up FlexNet Licensing on Windows ...........1....3............................... 16 3... THESEUS-FE ON MICROSOFT® WINDOWS PLATFORMS .......................... 11 2.3............................................................ 13 2.....2 Step 2: Use Services ................................................................ 8 Uninstallation on Windows .......................... 1........... System Requirements ...................................... INSTALLATION .........3.......... Setting up FlexNet Licensing on Linux .............................................2..................4 Step 4: Check for success ...........................................................2 ...........................1.......................................... 1..3 Step 3: Restart License Server ...........................................................................

Windows Vista SP2 or Windows 7 SP1 Intel/AMD 2. License File To run THESEUS-FE on your workstation or PC system a customer-specific license file is required. which can be run as a standalone application on those platforms.5 GHz graphics card with OpenGL 3. some additional third-party software (e.8 GHz RAM ≥ 4 GB graphics memory ≥ 512 MB Red Hat Enterprise Server 4 Intel/AMD 1. The installation of such products is completely independent of the THESEUS-FE installation and described in the documentation of each of these tools individually.0 GHz graphics card with OpenGL 3. Installation 1.org/hdf-javahtml/hdfview/ while information regarding TISC can be found at http://www.tlkthermo.1.hdfgroup.0 capability 2 GB RAM THESEUS-FE is delivered as a full operative release.) may be very useful. To generate license files for you we need to obtain some information about 1 See Keyword Manual.com/. Nevertheless an appropriate FORTRAN90 (or C++) compiler may be necessary if the user wishes to work with individually adjusted user subroutines1.g.2. convenient and time saving in your day-to-day work. Make sure to always use the newest versions of these third-party software programs. TISC. 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.0 capability 2 GB RAM Recommended cpu clock speed ≥ 2. Minimum requirements Windows XP SP2. Furthermore. The actual system requirements are summarized in the following table. 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. Appendix C 5 . 1.1. HDFView can be obtained from http://www. We explicitly recommend the installation of such third-party products to benefit from all features included in THESEUS-FE. various postprocessors etc.

Afterwards we will generate the license file for you and send it back using your provided email address. The THESEUS-FE installer can be downloaded from the internet at www. 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.com. As it is a popular licensing standard in the CAx area. Please run the commands tabled below for your appropriate system and email the output to support@theseus-fe. To install the software on any supported platform. Also you will lose our warranty for proper use of all functionalities. 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. 1. To integrate 6 .3. If you receive an error when attempting to install THESEUS-FE.your license server and/or local workstation.com from the customer area. consequential or incidental damages or data losses arising from the installation or use of the program.lic.theseusfe. On the other hand P+Z Engineering guarantees that the installer has been virus checked and generated under strict quality control. you may have some other Flex-enabled applications already running in your network. The license file will usually be called Theseus. 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. Important Notes P+Z Engineering GmbH explicitly disclaims any liability for any special. Note: We strongly recommend uninstalling any older version of THESEUS-FE before you start the setup process. you must be logged in as a local administrator at least.

This name occurs in a number of places.exe on Windows).THESEUS-FE seamlessly into your licensing environment it is recommended to contact your responsible system administrator. 7 . A very detailed description with further information is covered in the FlexNet License Administration Guide “fnp_LicAdmin_11_9_1. All communication with the license server will take place via the TCP/IP network interface. 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. The FlexNet documentation refers to the vendor daemon name. the vendor daemon of P+Z Engineering is called “puzld” (puzld.pdf” which can be found in the FlexNet installation directory. The license server can be located on a different machine which may even run a different operating system than your THESEUS-FE installation.

If your key was not included within your installation distribution order it via email from support@theseus-fe. you require:      PC system that meets the recommended system requirements (listed in Section 1.1.exe for the Windows 64bit setup). 8 . THESEUS-FE on Microsoft® Windows Platforms 2. Installation on Windows To install and run THESEUS-FE on Microsoft® Windows XP. THESEUS-FE-4.1.com Network license server that is able to run the FlexNet license daemon. At the “Select Components” page you will be asked to select different optional packages . Vista or Windows 7 (older platforms will not be supported). namely the FlexNet License Administration tools and THESEUS-FE Tutorial & Validation models. System Requirements) Administration privileges Active connection to your local network for the license request Valid THESEUS-FE license key.2_winx64_Setup. It is recommended to exit all other software applications before you start the setup process. 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. Start the THESEUS-FE setup file for your platform (e.2.g.

After a successful setup the following dialogue window should appear on the screen and if the checkbox is not deactivated. See chapter 2. if FlexNet licensing had already been set up for this machine. It may make sense to deselect the FlexNet Licensing system if you have a newer version already installed for example. THESEUS-FE will be started directly afterwards. On the other hand you are free to deselect these optional packages without any loss of the THESEUS-FE functionality.3 for information regarding the set up process. Remark: The THESEUS-FE GUI will only start properly. Figure 3: Successful setup completion of the THESEUS-FE installation 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 default options.

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. Anytime you would like to use THESEUS-FE again. which can be found in the standard installation folder (by default this is “C:\Program Files\THESEUS-FE 4. simply double-click the icon created on your desktop while installation or select THESEUS-FE in the “StartProgramsTHESEUS-FE 4.In case the installation did not succeed. a start screen with information about the current release will appear. 10 . please contact our technical support immediately via e-mail or phone. You can exit THESEUS-FE either by clicking on the menu “File” and then selecting the “Exit” option.2”) to start THESEUS-FE 4.bat” file. Figure 5: Splash screen of THESEUS-FE Exiting THESEUS-FE is as easy as starting it. When starting THESEUS-FE. Alternatively you can use the “theseus_gui.2” standard folder.2.

Follow the instructions of the wizard to uninstall THESEUS-FE. go to your THESEUS-FE installation directory on your local hard drive and execute the file uninstall.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. 11 . Alternatively. This means that you do not need to search the registry for failed links. 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. Nevertheless we recommend restarting Windows to ensure that all registry entries are completely deleted. Select “THESEUS-FE 4. The FlexNet Licensing module files will intentionally not be removed as FlexNet might be used by other programs. The uninstaller will start.2.2” and click “Remove” or “Uninstall”.exe manually.

3. 2.exe) and switch to the „Config Services“ tab.2 Step 2: Use Services Switch to the „Service/License File“ tab.exe should be located. Mark check box „Configuration using Services“ and select your service name set up in previous Step 1.pdf distributed with the installation of THESEUS-FE first.lic in this directory.3. 12 . too. as it is the official product guide from Flexera Software™ and contains all required information for advanced license administration topics.1 Step 1: Check Integrity and Setup LMTOOLS Put the license file Theseus. We also recommend placing the license file for THESEUS-FE which usually is named Theseus.lic into the same location where the license manager lmgrd.2.3. Specify your individual settings there. 2. Setting up FlexNet Licensing on Windows Attention: We recommend reading the FlexNet License Administration Guide fnp_LicAdmin_11_9_1.exe is installed (usually c:\flexlm). In this directory the vendor daemon named puzld. Start LMTOOLS (lmtools. The default location of the FlexNet license administration tools after the installation of THESEUS-FE is c:\flexlm.

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.2. Then restart the license manager again and re-read the license file(s).3. 2 1 3 13 .3 Step 3: Restart License Server First stop the license server completely.

4 Step 4: Check for success Push the „Perform Status Enquiry“ button and check the output for success. 14 .2.3. In some cases it is necessary to shut down the computer completely and restart the computer again.

00_linux-x64 will be created in your current directory. 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.tfe inter starting the GUI: .tar.2 on your machine.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: . See chapter 3.1 Setting up THESEUS-FE 4.gz containing THESEUS-FE 4.1. tar -xzvf theseusfe-4.sh gui 15 .tar. System Requirements) Active connection to your local network for the license request Valid THESEUS-FE license key.2 for Linux x64 platforms in a directory where you want it to be installed.00_linux-x64. If you have licensed the THESEUS-FE OVEN module and want to run calibration simulations using the THESEUS-FE Optimizer.2 for further details on setting up FlexNet licensing for THESEUS-FE. After the license server (and optionally OpenMPI) have been set up.00_linux-x64.1.2. 3.2.1. Depending on your way to set up the license server in your local network environment.sh sol job=MyJob.gz A subdirectory named theseusfe-4.2.2 Extract the tar-archive theseusfe-4.2./theseus. 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. If your key was not included within your installation distribution order it via email from support@theseus-fe.1. the program start script in the installation directory named theseus.3.sh might have to be adjusted. See chapter 3. the start script theseus.com Network license server that is able to run the FlexNet license daemon./theseus. This contains all the necessary data to run THESEUS-FE 4. OpenMPI has to be configured.2 for information about configuring it. 3.

The source code for OpenMPI 1.) 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. 3. We recommend using the Intel Fortran Compiler Professional Edition for Linux v11. A command line call of the Optimizier will look similar to this one: mpirun –np NP [-hostfile HOSTFILE] [--mca btl tcp. After compiling and setting up OpenMPI.self] <install-dir>/bin/theseus_opti jobname=<opti-job-name> thsexec=<install-dir>/bin/theseus_sol 16 . It has also been tested successfully with g77 and gfortran as replacements for the Intel Fortran compiler.starting the GUI for the OVEN module: .org/. It is recommended to use this version but it should also work with slightly older and newer versions of OpenMPI. 3.4.1. This might be necessary for job queuing systems and/or high-performance clusters.3 Setting up THESEUS-FE Optimizer to run in the command line (This step is only necessary.open-mpi.sh gui oven running the THESEUS-FE Transformer: .x or newer.sh tf –t=task … The THESEUS-FE Transformer can be called from the command line. adjust the variable named mpidir in start script theseus. OpenMPI must be compiled with interfaces for Fortran90 and Fortran77.1. 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. If you need help to compile OpenMPI please consult the official documentation. Newer versions can be obtained at http://www.1 can be downloaded from the customer area of our homepage.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./theseus.1.sh./theseus.4. It has to contain the root directory of your OpenMPI installation. if the THESEUS-FE Optimizer used in the OVEN module shall be usable from the command line instead of the GUI interface.

sh. you have to adjust this script.d. It is convenient to set up the license server to start automatically whenever Linux boots. "Locating Licenses". 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.lic. 17 . Please have a look especially at chapter 4.2. Administration privileges will be needed to write to this directory.pdf for a detailed explanation of the steps necessary to set up FlexNet licensing. NP is the number of processors that shall be used. 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 a brief guidance to set it up you can follow the steps below: a) To set up FlexNet licensing for THESEUS-FE. 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. The mechanism to make this work is distribution dependent. For information regarding the available options for the OpenMPI process manager mpirun have a look at the OpenMPI documentation. you can conveniently adjust the variables named lic_server and lic_port in theseus. Setting up FlexNet Licensing on Linux We recommend reading the FlexNet License Administration Guide fnp_LicAdmin_11_9_1. For example you could make a script in one of the runlevel directories under /etc/rc.sh located in the installation directory. You can start the license server manually using the script start_lmgrd. 3.self may help to resolve issues with the byte transfer layer used on some machines.Here. Providing a HOSTFILE containing a list of cluster nodes which may be used is optional. If the name or location of the license file has changed. The default port number used the FlexNet license server is 27000. 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. It can found in the <install-dir>/flexlm directory. if a license server is already set up If a FlexNet license server is already set up with the licenses for THESEUS-FE enabled. The Option --mca btl tcp.

or from the command line under Linux. 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. accessible via Help/Theory Manual. we recommend that you work on the THESEUS-FE Tutorials. 18 . As a new user. First Steps Open the THESEUS-FE GUI.4. either from the Start menu under Windows. we suggest you have a look at the Theory Manual.

Sign up to vote on this title
UsefulNot useful