AWS InstallationGuide
-
Upload
aminarabi4679 -
Category
Documents
-
view
229 -
download
4
Transcript of AWS InstallationGuide
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 Date Description Document No. A 13-Oct-2006 AWS v5.0 – Installation Guide 18.0102.0500 B 09-Feb-2007 AWS v5.0.1 – Installation Guide 18.0102.0501 C 31-May-2007 AWS v5.0.2 – Installation Guide 18.0102.0502 D 31-Oct-2007 AWS v5.0.3 – Installation Guide 18.0102.0503 E 31-Jan-2008 AWS v5.1 – Installation Guide 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 user’s 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 i
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 PC’s 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 Meaning
Italics For emphasis, to introduce a new term or for manual titles.
monospace 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.
MenuOpt A MenuOpt font is used for the names of menu options, submenus and screen buttons.
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 Fortran 90 Compiler C++ Compiler
INTEL Architecture (32-bit)
MS Windows XP Pro SP2
Intel Fortran 9.1.024
MS VC++ 2003 Pro
INTEL Architecture (32-bit) Linux RH 9 + RHEL 3 update 6 + SuSE 9.x + SLES 9 +
used for builds: RHEL 3 update 7
Intel Fortran v9.1.032 Intel C++ 9.1.038
LINUX Kernel v2.4 glibc 2.3.x
INTEL EM64T and AMD64 Architecture (64-bit) Linux RHEL 3 + SLES 9 +
used for builds: SLES 9 update 2
PGI Fortran 6.0-8
GCC 3.3.3
LINUX Kernel v2.6 glibc 2.3.x
INTEL Itanium (64-bit)1)
Linux RHEL 3 SLES 9
Intel Fortran v9.1.032 Intel C++ 9.1.038
LINUX Kernel v2.4 glibc 2.3.x
HP2) PA-RISC 2.0 HP-UX 11.11
HP F90 v2.9 HP aC++/C B3910B A.03.60
IBM2) RS 6000 Power 3 + AIX 5.1 AIX 5.2
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
1) can be executed also on SGI Altix Pro Pack 3 and 4 2) 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)
X X X X X X X
INTEL Architecture (32-bit) Linux RH 9 + RHEL 3 update 6 + SuSE 9.x + SLES 9 +
used for builds: RHEL 3 update 7
X X X X X X X
INTEL EM64T and AMD64 Architecture (64-bit) Linux RHEL 3 + SLES 9 +
used for builds: SLES 9 update 2
X X X X X X X
INTEL Itanium (64-bit)1)
Linux RHEL 3 SLES 9
X X X X X X
HP 2) PA-RISC 2.0 HP-UX 11.11
X X X X X X
IBM 2) RS 6000 Power 3 + AIX 5.1 AIX 5.2
X X X X X X
1) Pentium 4 or higher 2) 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) Pentium 4 > 2GHz
Main Memory 2GB
Graphics Card High end 128 MB
Disk >80 GB
2.2.2. BOOST, EXCITE Designer, EXCITE Piston & Rings and HYDSIM
Minimum Hardware Requirements
Recommended Hardware Requirements
Processor(s) 500 MHz >2GHz
Main Memory 256 MB > 512 MB
Disk 20 GB 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 system’s 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. Use Explorer to show the contents of the DVD.
2. Find the file Setup.exe.
3. 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 Installation Guide
A SETUP MAINTENANCE PROGRAM window opens as shown below.
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 AVL Workspace v5.1
2. Repair
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. Insert the appropriate DVD.
2. Mount the DVD.
3. Run the installation GUI.
4. Setup new path.
5. 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 Installation Guide
HP: 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
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 /anyMountPoint
IBM: 1. 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 Bourne / Korn shell
setenv DISPLAY hostname:0.0 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 re-installing 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: $HOME/.login
Define: setenv VARIABLE Value
other shells
Login File: $HOME/.profile
Define: VARIABLE=Value
export VARIABLE
4.4.2. Important Environment Variables
Variable Description
PATH
Modify this environment variable if not done during installation.
csh/tcsh:
setenv PATH <Installation Path>/bin:$PATH
Other shells:
PATH=<Installation Path>/bin:$PATH ; export PATH
LM_LICENSE_FILE
Setup this environment variable if the license file is not placed in the default location.
csh/tcsh: setenv LM_LICENSE_FILE
<Installation Path>/license/license.dat Other shells: LM_LICENSE_FILE=<Installation Path>/license/license.dat
4-8 31-Jan-2008
Installation Guide AVL Workspace v5.1
Variable Description
AVLAST_HOME
Setup the installation base directory: csh/tcsh: setenv AVLAST_HOME <Installation Path> Others:
AVLAST_HOME=<Installation Path> ; export AVLAST_HOME
DISPLAY
The graphic display is redirected to the specified screen. Common used values are
: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 Workspace’s 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 What to do
AVL Workspace is to be installed the first time; a different AST product (e.g. FIRE) exists.
<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
ln -s <installpath2>/AUTOSHAFT <installpath>/AUTOSHAFT
ln -s <installpath2>/BOOST <installpath>/BOOST
ln -s <installpath2>/EXCITE <installpath>/EXCITE
ln -s <installpath2>/EXCITE_PR <installpath>/EXCITE_PR
ln -s <installpath2>/EXCITE_TD <installpath>/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 Workspace is to be installed; a previous version exists already.
<installpath> ... Installation location of AST software products
<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 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
ln -s <installpath2>/EXCITE/v7.0.4 <installpath>/EXCITE/v7.0.4
ln -s <installpath2>/EXCITE_PR/v7.0.4 <installpath>/ EXCITE_PR v7.0.4
ln -s <installpath2>/EXCITE_TD/v7.0.4 <installpath>/EXCITE_TD/v7.0.4
ln -s <installpath2>/FEA/v7.0.4 <installpath>/FEA/v7.0.4
ln -s <installpath2>/HYDSIM/v4.5.2 <installpath>/HYDSIM v4.5.2
ln -s <installpath2>/IMPRESS/v1.4.4 <installpath>/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: see AWS_USERHOME, AWS_LOCAL_APPDATA
Windows: C:\Documents and Settings\...\Application Data\AVL
Linux/Unix: $HOME/.avl
AVL_COMMON_APPDATA
Purpose: see AWS_SITEHOME
Windows: C:\Documents and Settings\All Users\Application Data\AVL
Linux/Unix: $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.
Windows: %AVL_APPDATA%\AWS\v5.1\user
Linux/Unix: $AVL_APPDATA/AWS/v5.1/user
AWS_SITEHOME
Purpose: same settings as AWS_USERHOME but shared by all users
Windows: %AVL_COMMON_APPDATA%\AWS\v5.1\site
Linux/Unix: $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: temporary IMPRESS Chart data etc.
Windows: C:\Documents and Settings\...\Local Settings\
Application Data\AVL\AWS\tmp
Linux/Unix: $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)
Linux/Unix default: netscape (alternatives: firefox, mozilla, opera, …)
AWS_FILE_BROWSER
Windows default: explorer.exe
Linux/Unix default: nautilus (alternatives: konqueror, …)
AWS_WINEDITOR
Windows default: notepad.exe (alternatives: write.exe, …)
Linux/Unix default: nedit (alternatives: kedit, gedit, …)
5-2 31-Jan-2008
Installation Guide AVL Workspace v5.1
6. LICENSING The installation and setup process is described in the AST Licensing User’s Guide.
6.1. Requesting a license If you have not received a license key, request one from your local representative or from AVL Graz ([email protected]).
Include the following information:
• Software Product
• Name
• Telephone, Fax, E-Mail address
• Company
• System ID
Local installation: on every computer where the AVL Workspace software should be used
Network installation: 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
Hostid Type this command on the license
server: Example
AIX (RS/6000, PPC)
32-bit hostid
Uname -m
(returns 000276513100), then remove last two digits and use remaining last eight digits
02765131
Compaq Alpha ethernet address
Netstat -i 080020005532
32-bit hostid
Uname -i
and convert to hex, or prepend with #
778DA450 or #2005771344
HP ethernet address
Lanscan
(station address without leading "0x") 0000F0050185
Linux Composite Hostid
$AVLAST_HOME/bin/lmcomposite COMPOSITE= C25C48BF77F9
SCO Hostid String
Uname -x
(Serial is SCO00354), then prefix with "ID_STRING="
ID_STRING= SCO00354
SGI 32-bit hostid
/etc/sysinfo -s,
convert to hex, or prefix #
69064C3C or #1762020412
SUN 32-bit hostid
Hostid 170a3472
Windows Composite Hostid
FLEXnet/v10.1/bin/lmcomposite.exeCOMPOSITE= 88F360B80245
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 Installation Guide
3. 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 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 [email protected].
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