AVL WORKSPACE:

Version 5.1

Installation Guide

January 2008

Installation Guide

AVL Workspace v5.1

AVL LIST GmbH Hans-List-Platz 1, A-8020 Graz, Austria http://www.avl.com AST Local Support Contact: www.avl.com/ast_support

Revision A B C D E

Date 13-Oct-2006 09-Feb-2007 31-May-2007 31-Oct-2007 31-Jan-2008

Description AWS v5.0 Installation Guide AWS v5.0.1 Installation Guide AWS v5.0.2 Installation Guide AWS v5.0.3 Installation Guide AWS v5.1 Installation Guide

Document No. 18.0102.0500 18.0102.0501 18.0102.0502 18.0102.0503 18.0102.0510

Copyright 2008, AVL All rights reserved. No part of this publication may be reproduced, transmitted, transcribed, stored in a retrieval system, or translated into any language, or computer language, in any form or by any means, electronic, mechanical, magnetic, optical, chemical, manual or otherwise, without prior written consent of AVL. This document describes how to run the AVL Workspace software. It does not attempt to discuss all the concepts required to obtain successful solutions. It is the users responsibility to determine if he/she has sufficient knowledge to apply this software appropriately. This software and document are distributed solely on an "as is" basis. The entire risk as to their quality and performance is with the user. Should either the software or this document prove defective, the user assumes the entire cost of all necessary servicing, repair, or correction. AVL and its distributors will not be liable for direct, indirect, incidental, or consequential damages resulting from any defect in the software or this document, even if they have been advised of the possibility of such damage. All mentioned trademarks and registered trademarks are owned by the corresponding owners.

Installation Guide

AVL Workspace v5.1

Table of Contents
1. Introduction _____________________________________________________1-1
1.1. Symbols _____________________________________________________________________1-1

2. AWS Platform Information & System Requirements _____________2-1

2.1. Platforms Availability_________________________________________________________2-2 2.2. Hardware Requirements ______________________________________________________2-3 2.2.1. EXCITE Power Unit, EXCITE Timing Drive (including IMPRESS) ____________2-3 2.2.2. BOOST, EXCITE Designer, EXCITE Piston & Rings and HYDSIM ____________2-3 2.3. Software Requirements _______________________________________________________2-3

3. Installation for Windows_________________________________________3-1

3.1. Start Up_____________________________________________________________________3-1 3.2. Software License Agreement___________________________________________________3-2 3.3. AWS Installation _____________________________________________________________3-2 3.4. Uninstall and Maintenance ____________________________________________________3-7 3.5. Cygwin for AVL Workspace___________________________________________________3-10

4. Installation for UNIX ____________________________________________4-1

4.1. Overview ____________________________________________________________________4-1 4.2. Mounting the DVD ___________________________________________________________4-1 4.3. Start the Installation GUI _____________________________________________________4-3 4.3.1. Description of the Interface ________________________________________________4-4 4.3.2. Starting the Installation Process ___________________________________________4-7 4.4. Environment Variables _______________________________________________________4-8 4.4.1. How to Setup Environment Variables _______________________________________4-8 4.4.2. Important Environment Variables __________________________________________4-8 4.5. Verifying the Installation _____________________________________________________4-9 4.5.1. AVL Workspace GUI ______________________________________________________4-9 4.5.2. Simulation Program ______________________________________________________4-9 4.6. How to proceed if disk space is low ____________________________________________4-10

5. Settings and Templates __________________________________________5-1

5.1. Location of Settings and Templates ____________________________________________5-1 5.2. Location of Temporary Files ___________________________________________________5-2 5.3. Browser and Editor Settings___________________________________________________5-2

6. Licensing ________________________________________________________6-1
6.1. Requesting a license __________________________________________________________6-1 6.2. Expected FLEXnet Hostids ____________________________________________________6-1

7. ANSYS Interface Installation ____________________________________7-1

AST.18.0102.0510 31-Jan-2008

AVL Workspace v5.1

Installation Guide

ii

AST.18.0102.0510 31-Jan-2008

Installation Guide

AVL Workspace v5.1

List of Figures
Figure 3-1: AWS Setup Welcome Window............................................................................................................ 3-1 Figure 3-2: Software License Agreement Window............................................................................................... 3-2 Figure 3-3: User Information Window ................................................................................................................. 3-2 Figure 3-4: Choose Destination Location Window............................................................................................... 3-3 Figure 3-5: Setup Type Window ........................................................................................................................... 3-4 Figure 3-6: Component Selection Window ........................................................................................................... 3-4 Figure 3-7: Select Program Folder Window ......................................................................................................... 3-5 Figure 3-8: GNU General Public License Window .............................................................................................. 3-6 Figure 3-9: Register AVL Workspace Window ..................................................................................................... 3-6 Figure 3-10: Setup Complete Window .................................................................................................................. 3-7 Figure 3-11: Add/Remove Programs Properties Window.................................................................................... 3-7 Figure 3-12: Maintenance Setup Window ............................................................................................................ 3-8 Figure 3-13: Component Selection Window ......................................................................................................... 3-8 Figure 3-14: Confirm File Deletion Window ........................................................................................................ 3-9 Figure 3-15: Maintenance Complete Window ...................................................................................................... 3-9 Figure 4-1: GUI Main Window.............................................................................................................................. 4-4 Figure 4-2: File-Modify Window ........................................................................................................................... 4-6 Figure 4-3: Change-Request Module Window...................................................................................................... 4-7 Figure 5-1: Show hidden files and folders ............................................................................................................ 5-1

AST.18.0102.0510 31-Jan-2008

iii

Installation Guide

AVL Workspace v5.1

1. INTRODUCTION
This document describes the basic concepts and methods for installing the AVL Workspace (AWS) program from DVD on UNIX platforms and Intel Processor-based PCs running under Windows NT.

1.1. Symbols
The following symbols are used throughout this manual. Safety cautions must be strictly observed during operation and service of the system or its components.

Caution: Cautions describe conditions, practices or procedures which

could result in damage to, or destruction of data if not strictly observed or remedied.

Note: Notes provide important supplementary information.

Convention Italics monospace

Meaning For emphasis, to introduce a new term or for manual titles. To indicate a command, a program or a file name, messages, or input / output on a screen or file contents. AVL Workspace software uses files with lower case extensions only.

SCREEN-KEYS

A SCREEN font is used for the names of windows and keyboard keys, e.g. to indicate that you should type a command and press the ENTER key. A MenuOpt font is used for the names of menu options, submenus and screen buttons.

MenuOpt

31-Jan-2008

1-1

Installation Guide

AVL Workspace v5.1

2. AWS PLATFORM INFORMATION & SYSTEM REQUIREMENTS

AVL supports the following platforms and compilers for the AVL Workspace v5.1: Platform INTEL Architecture (32-bit) MS Windows XP Pro SP2 INTEL Architecture (32-bit) Intel Fortran v9.1.032 Intel C++ 9.1.038 LINUX Kernel v2.4 glibc 2.3.x Fortran 90 Compiler Intel Fortran 9.1.024 C++ Compiler MS VC++ 2003 Pro

Linux
RH 9 + RHEL 3 update 6 + SuSE 9.x + SLES 9 + used for builds: RHEL 3 update 7 INTEL EM64T and AMD64 Architecture (64-bit) Linux RHEL 3 + SLES 9 + used for builds: SLES 9 update 2 INTEL Itanium (64-bit)1) Linux RHEL 3 SLES 9 HP2) PA-RISC 2.0 HP-UX 11.11 IBM2) RS 6000 Power 3 + AIX 5.1 AIX 5.2
1) 2)

PGI Fortran 6.0-8

GCC 3.3.3 LINUX Kernel v2.6 glibc 2.3.x

Intel Fortran v9.1.032

Intel C++ 9.1.038 LINUX Kernel v2.4 glibc 2.3.x

HP F90 v2.9

HP aC++/C B3910B A.03.60

XL Fortran Compiler 8.1

VisualAge C++ 6.0 built with vacpp.cmp.core 6.0.0.9 use xlC.aix50.rte 6.0.0.9 or higher

can be executed also on SGI Altix Pro Pack 3 and 4 only solvers are supported on this platform, pre- and postprocessing is not supported RH Red Hat RHEL Red Hat Enterprise Linux SLES SuSE Linux Enterprise Server

31-Jan-2008

2-1

AVL Workspace v5.1

Installation Guide

2.1. Platforms Availability

Platform
BOOST EXCITE Power Unit EXCITE FEA & EIA EXCITE Piston & Rings EXCITE Timing Drive EXCITE Designer HYDSIM

INTEL Architecture (32-bit) MS Windows XP Pro SP2 1) INTEL Architecture (32-bit)

X X

X X

X X

X X

X X

X X

X X

Linux RH 9 + RHEL 3 update 6 + SuSE 9.x + SLES 9 + used for builds: RHEL 3 update 7
INTEL EM64T and AMD64 Architecture (64-bit)

Linux
RHEL 3 + SLES 9 +

used for builds: SLES 9 update 2

INTEL Itanium (64-bit)1) Linux RHEL 3 SLES 9 HP 2)
PA-RISC 2.0 HP-UX 11.11

IBM 2)
RS 6000 Power 3 + AIX 5.1 AIX 5.2
1) 2)

Pentium 4 or higher only solvers are supported on this platform, pre- and postprocessing (AWS and IMPPRESS) is not supported

Note: The AVL Workspace v5.1 Graphical User Interface for Pre- and
Postprocessing is not supported for HP and IBM. To submit simulation jobs to HP and IBM hosts, we recommend to use AVL Workspace v5.1 on Linux for Pre- and Postprocessing and to use the Remote AWS Queuing System. Please refer to chapter 2.8.1 of the Graphical User Interface Users Guide for information on how to submit jobs to a remote host.

2-2

31-Jan-2008

Installation Guide

AVL Workspace v5.1

2.2. Hardware Requirements

2.2.1. EXCITE Power Unit, EXCITE Timing Drive (including IMPRESS)
Recommended Hardware Requirements Processor(s) Main Memory Graphics Card Disk Pentium 4 > 2GHz 2GB High end 128 MB >80 GB

2.2.2. BOOST, EXCITE Designer, EXCITE Piston & Rings and HYDSIM
Minimum Hardware Requirements Processor(s) Main Memory Disk 500 MHz 256 MB 20 GB Recommended Hardware Requirements >2GHz > 512 MB 80 GB

2.3. Software Requirements

Internet Browser (Microsoft Internet Explorer or Mozilla Firefox) Adobe Acrobat Reader

Note: Ensure AcroRd32.exe for Windows (acroread for Unix) is located

in your systems search path.

31-Jan-2008

2-3

Installation Guide

AVL Workspace v5.1

3. INSTALLATION FOR WINDOWS

AWS can be installed on a PC with the Windows operating system. The installation process involves installation of the software from a DVD.

3.1. Start Up
To begin installation, insert the DVD in the PC. If the setup program does not start automatically, perform the following steps: 1. 2. 3. Use Explorer to show the contents of the DVD. Find the file Setup.exe. Execute this file by double clicking it.

The WELCOME window appears as shown below. Select Next to continue with the installation.

Figure 3-1: AWS Setup Welcome Window

31-Jan-2008

3-1

AVL Workspace v5.1

Installation Guide

3.2. Software License Agreement

The SOFTWARE LICENSE AGREEMENT window appears as shown below. After reading and accepting the agreement, select Yes to continue with the installation.

Figure 3-2: Software License Agreement Window

3.3. AWS Installation

The USER INFORMATION window appears as shown below. Enter the requested information and then select Next to continue with the installation.

Figure 3-3: User Information Window

3-2

31-Jan-2008

Installation Guide

AVL Workspace v5.1

The CHOOSE DESTINATION LOCATION window appears as shown in Figure 3-4. The user may select where AWS will be installed. A default destination is identified. Select Next to accept the default destination. To choose a different destination, select Browse and enter the desired destination (there should not be a space ( ) in the installation path).

Figure 3-4: Choose Destination Location Window Select the required setup type as shown in the following SETUP TYPE window. The default is Full, which installs the recommended components including examples and manuals. Compact only installs the components required to run AWS and Custom allows the user to select the components to be installed. Select the desired setup type and then select Next to continue.

31-Jan-2008

3-3

AVL Workspace v5.1

Installation Guide

Figure 3-5: Setup Type Window If Custom is selected the following window appears where the user can select the required components:

Figure 3-6: Component Selection Window Select Next to start the file copy process.

3-4

31-Jan-2008

Installation Guide

AVL Workspace v5.1

The SELECT PROGRAM FOLDER window appears as shown in the following figure which displays the existing program folders. The user may identify the name of the program folder where the AWS icons will be located. Select from an existing folder or define a new program folder in the field provided. Select Next to continue.

Figure 3-7: Select Program Folder Window An additional shell environment is needed to successfully run AWS. This public domain software is installed after selecting Yes to accept the GPL license agreement as shown in the following window. For further information refer to www.cygwin.com.

31-Jan-2008

3-5

AVL Workspace v5.1

Installation Guide

Figure 3-8: GNU General Public License Window The REGISTER AVL WORKSPACE window appears as shown in the following figure.

Figure 3-9: Register AVL Workspace Window Once the displayed file types have been associated with AVL Workspace, models (i.e. files of these file types) can be loaded into AVL Workspace by double-clicking model files in the Windows Explorer.

3-6

31-Jan-2008

Installation Guide

AVL Workspace v5.1

If IMPRESS is not deselected manually in the Custom setup type, IMPRESS will be installed during the AVL Workspace installation. The installation procedure is the same as for the Workspace and so this chapter will also guide you through the IMPRESS installation. The SETUP COMPLETE window appears as shown in the following figure. Select Finish to complete the AWS installation process.

Figure 3-10: Setup Complete Window

3.4. Uninstall and Maintenance

To uninstall, repair or modify AWS, open the CONTROL PANEL window by clicking Start - Settings - Control Panel. Double click the Add/Remove Programs symbol to open the ADD OR REMOVE PROGRAM PROPERTIES window as shown below. Select AVL Workspace v5.x and then select Change/Remove. (Administrator privileges are required to proceed with reinstallation.)

Figure 3-11: Add/Remove Programs Properties Window

31-Jan-2008

3-7

AVL Workspace v5.1 A SETUP MAINTENANCE PROGRAM window opens as shown below.

Installation Guide

Figure 3-12: Maintenance Setup Window Three options are available: 1. Modify This option allows the user to install or remove components according to the first setup. Select Next to open the COMPONENT SELECTION window as shown below. Select the required components and then select Next to continue.

Figure 3-13: Component Selection Window

3-8

31-Jan-2008

Installation Guide 2. Repair

AVL Workspace v5.1

This option allows the user to transfer original files from the DVD to replace files that may have been damaged or erased during installation. Select Next to start the repair process. 3. Remove This option allows the user to remove the whole program. Select Next and the CONFIRM FILE DELETION window appears as shown below. Select OK to remove the selected program files.

Figure 3-14: Confirm File Deletion Window The MAINTENANCE COMPLETE window opens as shown in Figure 3-15. Select Finish to exit.

Figure 3-15: Maintenance Complete Window

31-Jan-2008

3-9

AVL Workspace v5.1

Installation Guide

3.5. Cygwin for AVL Workspace

The AVL Workspace scripting environment is based on Cygwin (http://www.cygwin.com), a Linux-like environment for Windows. The AVL Workspace installer will create a Cygwin installation directory in <installDir>\common\cygwin, and set up this Cygwin or any existing Cygwin installation for AVL Workspace automatically, depending on whether a Cygwin installation exists before installing AVL Workspace or not. The Cygwin version installed by the AVL Workspace installer is a snapshot from Sep 26 2007, only the minimal base packages from the Cygwin distribution are contained. To install additional packages, or to update to a more recent version, you may run <installDir>\common\cygwin\Installation\setup.exe. Updates will not be overwritten by the AVL Workspace installer. Background information The mapping of Win32 drives into Cygwin's internal POSIX directory tree is stored in the current user's Cygwin mount table in the Windows registry. The current user's table is located under HKEY_CURRENT_USER/Software/Cygnus Solutions/Cygwin/mounts. The system-wide table is located under the same subkeys under HKEY_MACHINE. The AVL Workspace installer identifies existing Cygwin installation by the existence of a mount point for "/bin" from the current user's mount table or from the system-wide table. If the AVL Workspace installer detects an existing Cygwin installation, AVL Workspace will not modify any mount point. AVL Workspace will be set up to use the existing Cygwin installation in this case. All AVL Workspace v5.0.3 settings for interfacing to the Cygwin installation can be found in <installDir>\bin\avlast_sh_cfg.bat. If AVL Workspace v5.0.2 or older exists, the AVL Workspace installer will update <installDir>\bin\bash.bat as required. To recover from a damaged Cygwin installation, we recommend to delete the registry keys HKEY_CURRENT_USER/Software/Cygnus Solutions and HKEY_LOCAL_MACHINE/Software/Cygnus Solutions before reinstalling Cygwin. After that, edit <installDir>\bin\avlast_sh_cfg.bat.

3-10

31-Jan-2008

Installation Guide

AVL Workspace v5.1

4. INSTALLATION FOR UNIX

This guide describes how to install the AVL Workspace software from a DVD drive on Unix platforms and how to setup the software. The DVD contains the software for the most commonly used platforms. For other platforms, please contact your local representative or the AVL support team.

4.1. Overview
The following steps are necessary to perform the installation: 1. 2. 3. 4. 5. Insert the appropriate DVD. Mount the DVD. Run the installation GUI. Setup new path. Setup the license.

4.2. Mounting the DVD

AVL DVD's contain data stored in ISO 9660 format. If the DVD has not been mounted as a file system, login as root and use the appropriate command for the system. On some systems DVDs are mounted automatically when attempting to access setup.exe as follows: Type ls -l /DVD/setup.exe or ls -l /dvd/setup.exe or ls -l /dvd/dvd0/setup.exe. A line similar to the following should appear:
-rwxrwxr-x 1 jrp ts 1024 Apr 16 11:36 /DVD/setup.exe

or
-rwxrwxr-x 1 jrp ts 1024 Apr 16 11:36 /dvd/setup.exe

If the following line appears then the DVD drive must be mounted manually: /DVD/setup.exe: No such file or directory or /dvd/setup.exe: No such file or directory

31-Jan-2008

4-1

AVL Workspace v5.1 To mount a DVD on HP, use: 1. Start the pfs daemons: /usr/sbin/pfs_mountd & /usr/sbin/pfsd & 2. Mount the DVD: mkdir /DVD pfs_mount /dev/dsk/c0t2d0 /DVD

Installation Guide

HP:

Note: Replace the device name c0t2d0 as required for your system.

To mount an iso file on HP, use: 1. Start the pfs daemons: /usr/sbin/pfs_mountd & /usr/sbin/pfsd & 2. Mount the iso image: mkdir /anyMountPoint pfs_mount -o xlat=UNIX IBM: 1. /anyMountPoint

Before mounting, create a directory on the system that will be used as the mount directory of the DVD drive. Commonly /DVD or /dvd are used. mkdir /DVD

2.

To list available DVDs, use: /etc/lsdev -C -c cd -H (list available DVDs)

3.

To mount the DVD, use: mount -v cdrfs -r /dev/cd1 /DVD

Note: Replace the device name cd1 as required for your system.

4-2

31-Jan-2008

Installation Guide

AVL Workspace v5.1

4.3. Start the Installation GUI

There are no root privileges needed for installing the software. Start the installation script located on the DVD. The installation tool runs using a Graphical User Interface, so the environment variable DISPLAY must be set up before starting the installation GUI (hostname is the name of the computer where you sit in front of). C-shell setenv DISPLAY hostname:0.0 Bourne / Korn shell DISPLAY= hostname:0.0 Export DISPLAY Type /DVD/setup.exe or /dvd/setup.exe depending on what your DVD directory is called. The default size of the window is setup up for small screen resolutions. Resize the window to the desired size.

Note: If a previous product version has been installed, it is strongly

recommended to install this software into the existing installation directory (i.e. $AVLAST_HOME). Otherwise job submission problems may occur. Chapter 4.6 describes how to proceed if disk space is low.

31-Jan-2008

4-3

AVL Workspace v5.1

Installation Guide

4.3.1. Description of the Interface

Figure 4-1: GUI Main Window

1 Product Selection
Depending on the settings of the Install type and Show settings, a list of products that can be installed is displayed. The symbols are described as follows: ... The item and all its sub items are selected. ... Not all of the sub items are selected, but at least one. ... Neither the item itself nor any of its sub items are selected. Change the selection by clicking the mouse. Items with sub elements have a collapse or an expand symbol, whether the sub tree is shown or not. The symbols behave as follows: ... Expand the sub tree (click to show the sub items). ... Collapse the sub tree (click to hide the sub items). Toggle the view by clicking the mouse.

4-4

31-Jan-2008

Installation Guide

AVL Workspace v5.1

2 Install type
On the right side below the AVL Logo, three predefined installation types are shown (compact, typical, and full). Choose one of these or use custom to compose your own selection. ..... compact .....Selects all essential components to run the AST Software (does not include the online manual). ..... typical.........Selects components for a standard installation (includes the online manual). ..... full...............Selects all available components. ..... custom .......Does not change the current selection, but lets you compose your individual installation. This mode is automatically taken in case of changing the installation contents of any of the three predefined components.

3 Show
Choose between available and supported operating systems. If available is activated, all platforms are shown (e.g. HP-UX, SGI, IBM,) that are available on this DVD. Supported shows the platform(s) that match the current operating system (where setup.exe is running) only. If supported operating systems is grayed out, switch to installation type custom and select the desired options.

4 Documentation
Select A4 format for the manuals.

5 Permissions
Allows the file protections and access permissions to be changed. Every combination of user, group and others is possible. If none of these is activated, the protections will be setup according to the present umask value. user ............Enables access for a single user. Files and folders will belong to this user. No other user will be able to see or use the software. group..........Enables access for group. Files and folders will belong to this group. Users that do not belong to that group will not be able to see or use the software. others .........Enables access for everybody.

6 Status Window
Displays information about the present task (during installation) and informs about the state of each step of the installation. During this phase, the following symbols are used: ... Gives some additional information. ... Indicates a fatal error (the software will not work properly). ... Indicates something did not work as desired (installation will work). ... Indicates correct execution. If an error or warning occurs, a popup help with detailed information is shown when moving the mouse over the error-/warning icon.

31-Jan-2008

4-5

AVL Workspace v5.1

Installation Guide

7 Start/Stop Installation
This button has two functions: ... Start the installation process of all selected items. ... Stop the currently running installation process.

8 Exit
Click to exit the AST-Installer. This button is not available during installation.

When AST-Installer has finished copying data, the interactive FILE-MODIFY window will appear.

Figure 4-2: File-Modify Window

9 Original
This window shows the original (not modified) contents of the file that should be changed (e.g. .login or .profile). The shows the location of change.

10 Modified
This window shows the modified contents of the file that should be changed (e.g. .login or .profile). The suggested modification is written in bold letters and marked with

11 Add (Delete, Replace, Comment)

Click this button to apply the suggested change to the file.

4-6

31-Jan-2008

Installation Guide

AVL Workspace v5.1

12 Add all (Delete all, Replace all, Comment all)

This will apply the current suggested change and all following changes of this type (Add, Delete, Replace, Comment) without further confirmation.

13 Accept all changes

This will apply the current suggested changes and all following changes independent of the type without further confirmation.

14 Do not Add (Do not Delete, Do not Replace, Do not Comment)

Click this button to discard the suggested changes.

4.3.2. Starting the Installation Process

To start the installation process of all selected products, click .

When AST-Installer has finished copying data, the interactive File-Modify-module appears. For a complete installation, all the suggested changes (e.g. in .login) should be accepted. Then choose whether the changes should be done in the original file or in a duplicate.

Figure 4-3: Change-Request Module Window Choose between the following options:

15 ... Adapt the modifications to the original file 16 ... Make a copy of the original file and adapt the modification to the original file 17 ... Make a copy of the original file and adapt the modifications to the copy
When installation is done, a summary is displayed in the status window that looks like Installation completed with 0 Error(s) and 2 Warning(s). Select Yes to remove all temporary files/folders. The installation process is also logged to the file install.log in users home directory. This installation protocol will be used (if available) as a reference for further installations. The installation is now finished.

31-Jan-2008

4-7

AVL Workspace v5.1

Installation Guide

Note: It may happen that during the installation, especially when reinstalling the software, some warnings concerning already existing files appear. These warnings can be ignored.

Open a new terminal window (login shell). The software will be ready for usage as soon as the license is activated.

4.4. Environment Variables

4.4.1. How to Setup Environment Variables
The variables described below should be setup in each user login file so that they are setup every time a new terminal window is opened. It may happen that a terminal window is opened without activating the settings in your login file. This behavior can be changed, please ask your system administrator. A possible solution is to insert the definitions in the .cshrc file, but this is not recommended by AVL. csh or tcsh Login File: Define: Login File: other shells Define: $HOME/.login setenv VARIABLE Value $HOME/.profile VARIABLE=Value export VARIABLE

4.4.2. Important Environment Variables

Variable Description Modify this environment variable if not done during installation. csh/tcsh: PATH setenv PATH Other shells: PATH=<Installation Path>/bin:$PATH ; export PATH Setup this environment variable if the license file is not placed in the default location. LM_LICENSE_FILE csh/tcsh: setenv LM_LICENSE_FILE <Installation Path>/license/license.dat Other shells: LM_LICENSE_FILE=<Installation Path>/license/license.dat <Installation Path>/bin:$PATH

4-8

31-Jan-2008

Installation Guide

AVL Workspace v5.1

Variable

Description Setup the installation base directory: csh/tcsh:

AVLAST_HOME

setenv AVLAST_HOME <Installation Path> Others: AVLAST_HOME=<Installation Path> ; export AVLAST_HOME The graphic display is redirected to the specified screen. Common used values are

DISPLAY

:0.0 localhost:0.0 hostname:0.0

4.5. Verifying the Installation

Verify the installation to check that the AVL Workspace GUI can start the simulation program can start

Login as the AVL Software user (do not use the root account) and open a new window or a new shell. The necessary environment will be set up automatically.

4.5.1. AVL Workspace GUI

Enter the command aws to start AVL Workspace Graphic User Interface. Ensure the environment variable DISPLAY is set up correctly. The command echo $DISPLAY should report :0.0 if AVL Workspace runs on the local host, otherwise hostname:0.0 where hostname is the name or TCP/IP address of the computer where AVL Workspace should be used. In the startup window, select the required client, e.g. BOOST. Then the main window for the required client appears on the screen. After writing some information lines on the screen, a startup window will appear. sgi3:> aws A V L / W o r k s p a c e v5.1 Select File |Open to open an existing model from the examples under $AVLAST_HOME/EXCITE/v7.0.4/examples/Primer/excite. Load the file primer_v70.ex and save the model in your working directory.

4.5.2. Simulation Program

Each client has is own characteristic on how to start the calculation run. In the case of a software update, an advanced user should do this with one of his models.

31-Jan-2008

4-9

AVL Workspace v5.1

Installation Guide

4.6. How to proceed if disk space is low

As mentioned before: if a previous product version has been installed, it is strongly recommended to install this software into the existing installation directory (i.e. $AVLAST_HOME). Otherwise job submission problems may occur when submitting jobs to remote hosts, or when using the Workspaces optimization interface. Installing the software to a new location after a previous product version has been installed is valid only if symbolic links are created as outlined in the table below:

Case 1 AVL Workspace is to be installed the first time; a different AST product (e.g. FIRE) exists.

What to do <installpath> ... Installation location of AST software products, i.e. $AVLAST_HOME <installpath2> ... Path to some free disk space Create symbolic links to a new location where the free disk space is available. Prerequisite: the directories AWS, AUTOSHAFT, BOOST, etc. must not yet exist in <installpath>
mkdir <installpath2> ln -s <installpath2>/AWS <installpath>/AWS <installpath>/AUTOSHAFT

ln -s <installpath2>/AUTOSHAFT ln -s <installpath2>/BOOST ln -s <installpath2>/EXCITE

<installpath>/BOOST <installpath>/EXCITE <installpath>/EXCITE_PR <installpath>/EXCITE_TD

ln -s <installpath2>/EXCITE_PR ln -s <installpath2>/EXCITE_TD ln -s <installpath2>/FEA

<installpath>/FEA

ln -s <installpath2>/HYDSIM <installpath>/HYDSIM ln -s <installpath2>/IMPRESS <installpath>/IMPRESS

/DVD/setup.exe

4-10

31-Jan-2008

Installation Guide

AVL Workspace v5.1

Case 2

What to do

A new version of AVL <installpath> ... Installation location of AST software products Workspace is to be <installpath2> ... Path to some free disk space installed; a previous version exists already. Create symbolic links to a new location where the free disk space is available. Prerequisite: the directories AWS, AUTOSHAFT etc. must exist in <installpath>; the directories AWS/v5.1, AUTOSHAFT/v3.0.4 etc. must not exist in <installpath>
mkdir <installpath2> mkdir <installpath2>/AWS mkdir <installpath2>/AUTOSHAFT mkdir <installpath2>/BOOST mkdir <installpath2>/EXCITE mkdir <installpath2>/EXCITE_PR mkdir <installpath2>/EXCITE_TD mkdir <installpath2>/FEA mkdir <installpath2>/HYDSIM mkdir <installpath2>/IMPRESS

ln -s <installpath2>/AWS/v5.1

<installpath>/AWS/v5.1

ln -s <installpath2>/AUTOSHAFT/v3.0.4 <installpath>/AUTOSHAFT/v3.0.4 ln -s <installpath2>/BOOST/v5.1 <installpath>/BOOST/v5.1 <installpath>/EXCITE/v7.0.4 <installpath>/ EXCITE_PR v7.0.4 <installpath>/EXCITE_TD/v7.0.4

ln -s <installpath2>/EXCITE/v7.0.4

ln -s <installpath2>/EXCITE_PR/v7.0.4 ln -s <installpath2>/EXCITE_TD/v7.0.4 ln -s <installpath2>/FEA/v7.0.4

<installpath>/FEA/v7.0.4 <installpath>/HYDSIM v4.5.2 <installpath>/IMPRESS/v1.4.4

ln -s <installpath2>/HYDSIM/v4.5.2 ln -s <installpath2>/IMPRESS/v1.4.4

/DVD/setup.exe

31-Jan-2008

4-11

Installation Guide

AVL Workspace v5.1

5. SETTINGS AND TEMPLATES

Note: On Windows, some folders like Application Data and Local
Settings may be hidden. To make them visible, edit the Folder Options via the Windows Control Panel and select Show hidden files and folders as shown in Figure 5-1.

Figure 5-1: Show hidden files and folders

5.1. Location of Settings and Templates

AVL Workspace stores user-specific data and site-specific data (i.e. data to be shared by all users) in the following default locations. To change these locations, any of the environment variables below may be predefined (i.e. customized) by the user. AVL_APPDATA Purpose: Windows: Linux/Unix: see AWS_USERHOME, AWS_LOCAL_APPDATA C:\Documents and Settings\...\Application Data\AVL $HOME/.avl

AVL_COMMON_APPDATA Purpose: Windows: Linux/Unix: see AWS_SITEHOME C:\Documents and Settings\All Users\Application Data\AVL $AVLAST_HOME

31-Jan-2008

5-1

AVL Workspace v5.1

Installation Guide

AWS_USERHOME Purpose: user-specific settings such as unit system, IMPRESS Chart templates, Python utility scripts, user defined results functions, user joints, etc. %AVL_APPDATA%\AWS\v5.1\user $AVL_APPDATA/AWS/v5.1/user

Windows: Linux/Unix: AWS_SITEHOME Purpose: Windows: Linux/Unix:

same settings as AWS_USERHOME but shared by all users %AVL_COMMON_APPDATA%\AWS\v5.1\site $AVL_COMMON_APPDATA/AWS/v5.1/site

5.2. Location of Temporary Files

AVL Workspace stores temporary data in the following location. To change this location the environment variable AWS_LOCAL_APPDATA may be predefined AWS_LOCAL_APPDATA Purpose: Windows: Linux/Unix: temporary IMPRESS Chart data etc. C:\Documents and Settings\...\Local Settings\ Application Data\AVL\AWS\tmp $AVL_APPDATA/AWS/tmp

5.3. Browser and Editor Settings

At different places AVL Workspace opens standard applications for viewing the contents of files or directories. To control which applications shall be used, the environment variables below may be predefined (i.e. customized) by the user. AWS_HTML_BROWSER Windows default: iexplore (alternatives: firefox, opera, netscape) (alternatives: firefox, mozilla, opera, )

Linux/Unix default: netscape AWS_FILE_BROWSER Windows default: explorer.exe

Linux/Unix default: nautilus AWS_WINEDITOR Windows default: notepad.exe

(alternatives: konqueror, )

(alternatives: write.exe, ) (alternatives: kedit, gedit, )

Linux/Unix default: nedit

5-2

31-Jan-2008

Installation Guide

AVL Workspace v5.1

6. LICENSING
The installation and setup process is described in the AST Licensing Users Guide.

6.1. Requesting a license

If you have not received a license key, request one from your local representative or from AVL Graz (ast_license@avl.com). Include the following information: Software Product Name Telephone, Fax, E-Mail address Company System ID Local installation: Network installation: on every computer where the AVL Workspace software should be used on the license server computer

Installation Type (Node locked, Network)

For Windows this information can be extracted by using a utility under Start | Programs | AVL | License | License Request.

6.2. Expected FLEXnet Hostids

The program lmhostid (or lmcomposite on Windows and Linux) will print the exact hostid that FLEXnet expects to use on any given machine. The following table lists alternate methods to obtain the required hostid for each machine architecture. FLEXnet also supports a group of special hostids and vendor-defined hostids.

31-Jan-2008

6-1

AVL Workspace v5.1

Installation Guide

Hardware Platform AIX (RS/6000, PPC)

Hostid

Type this command on the license server: Uname -m

Example

32-bit hostid

(returns 000276513100), then remove last two digits and use remaining last eight digits Netstat -i Uname -i and convert to hex, or prepend with # Lanscan (station address without leading "0x")

02765131

Compaq Alpha

ethernet address 32-bit hostid

080020005532 778DA450 or #2005771344 0000F0050185 COMPOSITE= C25C48BF77F9 ID_STRING= SCO00354 69064C3C or #1762020412 170a3472 COMPOSITE= 88F360B80245

HP ethernet address Linux

Composite $AVLAST_HOME/bin/lmcomposite Hostid Hostid String 32-bit hostid 32-bit hostid Uname -x (Serial is SCO00354), then prefix with "ID_STRING=" /etc/sysinfo -s, convert to hex, or prefix # Hostid

SCO

SGI

SUN Windows

Composite FLEXnet/v10.1/bin/lmcomposite.exe Hostid

6-2

31-Jan-2008

Installation Guide

AVL Workspace v5.1

7. ANSYS INTERFACE INSTALLATION

The ANSYS to AVL EXCITE Interface can be installed on each platform and operating system that is supported by ANSYS. Administration privileges are required for editing ANSYS installation files. The installation process involves copying the interface files, which can be found in AWS Installation DVD ( folder: <AWS_installation_folder>\EXCITE\version\fem\ansys\ ) or downloaded from the AVL Service World. The installation procedure requires the following steps: Case 1: Downloading from the AVL Service World 1. Uncompress the file Ansys2Excite.zip or Ansys2Excite.tar.gz to your <folder>/<directory> 2. Define ANSYS environment variable ANSYS_MACROLIB to point to the <folder>/<directory> where the interface files are located (to define environment variable refer to the ANSYS Installation and Configuration Manual or ask your system administrator) 3. Update the file: <ANSYS_installation_ folder>\vXX\ANSYS\gui\en-us\UIDL\ menulistXX.ans (where XX is the ANSYS version) by adding the name of the granula file (excite.grn with full path name) at the end of this file (administration privileges are required for this and next step) 4. Update the file <ANSYS_installation_ folder>\vXX\ANSYS\gui\en-us\toolbars\tlbrlistXX.ans (where XX is the ANSYS version) by adding the name of the menu file (AVL.TLB with full path name) at the end of this file The ANSYS to AVL EXCITE Interface is now ready for use. Start the ANSYS.

Case 2: Interface Files are in folder <AWS_installation_folder>\EXCITE\version\fem\ansys\ 1. Define ANSYS environment variable ANSYS_MACROLIB to point to the <AWS_installation_folder>\EXCITE\version\fem\ansys\, where the interface files are located (to define the environment variable refer to the ANSYS Installation and Configuration Manual or ask your system administrator) 2. Update the file: <ANSYS_installation_ folder>\vXX\ANSYS\gui\en-us\UIDL\ menulistXX.ans (where XX is the ANSYS version) by adding the name of the granula file (excite.grn with full path name) at the end of this file (administration privileges are required for this and next step)

31-Jan-2008

7-1

AVL Workspace v5.1 3. Update the file

Installation Guide

<ANSYS_installation_ folder>\vXX\ANSYS\gui\en-us\toolbars\tlbrlistXX.ans (where XX is the ANSYS version) by adding the name of the menu file (AVL.TLB with full path name) at the end of this file The ANSYS to AVL EXCITE Interface is now ready for use.

Start the ANSYS session. If the AVL EXCITE menu is not visible then place the mouse cursor near the bottom of the ANSYS window (above Pick a menu item or ) and when cursor change the shape to both side arrows, drag upward about 2 cm. Now, the AVL EXCITE Menu is visible (see following for details).

7-2

31-Jan-2008

Installation Guide

AVL Workspace v5.1

The ANSYS to AVL EXCITE Interface is independent from the hardware platforms. It was developed with ANSYS version 9.0, but it will also work with newer versions, as it based on pure APDL macro language. The interface can be used with the following ANSYS products: Multi-physics Mechanical Structural Professional (only static condensation possible)

The user may also refer to: ANSYS Documentation: Advanced Analysis Technique Guide - Chapter 8 - Substructuring Advanced Analysis Technique Guide - Chapter 10 - Rigid Body Dynamics and the ANSYS-ADAMS Interface Advanced Analysis Technique Guide - Chapter 12 - User-Programmable Features and Nonstandard Uses Structural Analysis Guide - Chapter 3 - Modal Analysis Structural Analysis Guide - Chapter 5 - Transient Dynamic Analysis Structural Analysis Guide - Chapter 6 - Spectrum Analysis AVL EXCITE Documentation

If you have any problem using the EXCITE and EXCITE_R command or ANSYS to EXCITE Interface, contact the technical support at excite_support@avl.com. Please specify the following: ANSYS version AWS & EXCITE version (can be found under Menu Help | About) hardware platform body type short description of the problem if possible, attach Ansys model database or model input file Ansys ERR file File <bodyname>.PROC_STATUS any other information that might help in detecting the problem

31-Jan-2008

7-3