AST Installation Guide
AST Installation Guide
INSTALLATION GUIDE
VERSION 2013.1
Installation Guide
AST v2013.1
Revision
A
B
Date
25-Jan-2013
14-Jul-2013
Description
AST v2013 Installation Guide
AST v2013.1 Installation Guide
Document No.
08.0102.2013
08.0102.2013.1
Installation Guide
AST v2013.1
Table of Contents
1. Introduction _____________________________________________________1-1
1.1. Symbols _____________________________________________________________________ 1-1
1.2. Configurations _______________________________________________________________ 1-1
AST v2013.1
Installation Guide
6. Licensing ________________________________________________________6-1
6.1. Requesting a license __________________________________________________________ 6-1
6.2. Expected FlexNet Hostids _____________________________________________________ 6-1
ii
AST.08.0102.2013.1 14-Jul-2013
Installation Guide
AST v2013.1
List of Figures
Figure 3-1: Installation DVD Contents .............................................................................................. 3-2
Figure 3-2: Installation Extraction ..................................................................................................... 3-2
Figure 3-3: Introduction...................................................................................................................... 3-3
Figure 3-4: Registration Information ................................................................................................. 3-3
Figure 3-5: License Agreement ........................................................................................................... 3-4
Figure 3-6: Installation Folder............................................................................................................ 3-5
Figure 3-7: Platform Selection ............................................................................................................ 3-5
Figure 3-8: Installation Set ................................................................................................................. 3-6
Figure 3-9: Shortcut Folder ................................................................................................................ 3-7
Figure 3-10: Associate File Types ....................................................................................................... 3-7
Figure 3-11: No Licensing Configuration ........................................................................................... 3-8
Figure 3-12: Existing License Server Configuration.......................................................................... 3-9
Figure 3-13: License Configuration Settings...................................................................................... 3-9
Figure 3-14: Local License Server Configuration ............................................................................ 3-10
Figure 3-15: Installation Summary .................................................................................................. 3-11
Figure 3-16: Installation Progress .................................................................................................... 3-12
Figure 3-17: Post-Installation Configuration ................................................................................... 3-12
Figure 3-18: Installation Complete ................................................................................................... 3-13
Figure 3-19: AVL AST Launcher Window........................................................................................ 3-14
Figure 3-20: Control Panel ............................................................................................................... 3-16
Figure 3-21: Programs and Features ................................................................................................ 3-16
Figure 3-22: Uninstall Introduction ................................................................................................. 3-17
Figure 3-23: Uninstall Progress........................................................................................................ 3-17
Figure 3-24: Post-Uninstall Configuration ...................................................................................... 3-18
Figure 3-25: Uninstall Complete ...................................................................................................... 3-18
Figure 4-1: Introduction...................................................................................................................... 4-3
Figure 4-2: License Agreement ........................................................................................................... 4-3
Figure 4-3: Installation Folder............................................................................................................ 4-4
Figure 4-4: Installation Set ................................................................................................................. 4-5
Figure 4-5: No Licensing Configuration ............................................................................................. 4-6
Figure 4-6: Local License Server Configuration ................................................................................ 4-7
Figure 4-7: Installation Summary ...................................................................................................... 4-7
Figure 4-8: Installation Progress ........................................................................................................ 4-8
Figure 4-9: Modify Login Scripts ........................................................................................................ 4-9
Figure 4-10: Post-Installation Configuration ..................................................................................... 4-9
Figure 4-11: Installation Complete ................................................................................................... 4-10
Figure 5-1: Show hidden files and folders ......................................................................................... 5-1
AST.08.0102.2013.1 14-Jul-2013
iii
Installation Guide
AST v2013.1
1. INTRODUCTION
This document describes the basic methods for installing the AST software from DVD on
Linux platforms and Intel Processor-based PCs running under Windows.
1.1. Symbols
The following symbols are used throughout this manual. Safety warnings must be strictly
observed during operation and service of the system or its components.
Convention
Meaning
Italics
monospace
MenuOpt
1.2. Configurations
Software configurations described in this manual were in effect on the publication date.
It is the users responsibility to verify the configuration of the equipment before applying
procedures.
14-Jul-2013
1-1
Installation Guide
AST v2013.1
2. SOFTWARE INSTALLATION
2.1. Supported Platforms and Build Environment
2.1.1. AVL FIRE
FIRE v2013.1 consists of:
FIRE Solver
Interactive tools
FIRE Workflow Manager
CFD Tools
and is currently supported for the platforms listed in the following table:
FIRE v2013.1 Supported Platforms
Interactive tools
Platform
LINUX for X86-64
Operating System
32-bit
64-bit
RHEL 5, RHEL6,
SLES 11
Solver
32-bit serial 32-bit MPI 64-bit serial 64-bit MPI
O
O
O
bit
Operating System
Fortran Compiler *)
C++ Compiler *)
MPI
64
RHEL 5 update 6
Platform-MPI 8.2.1
MS VC++ 2008
MS VC++ 2008
Platform-MPI
8.2.1**)
*) compiler installations are required for compiling user functions. To execute the software the respective
runtime environment is required.
**) compiling user functions for MPI on Microsoft Windows requires a valid Perl installation. A Perl installation
package can be downloaded from e.g. ActiveState.
The compiler libraries are required for the Interactive products and the Solver during runtime. Compiler licenses are required for the Solver only if user-functions or other source
files are to be compiled and linked.
The latest version of the Supported Platforms & Known Issues document is available at
Link to FIRE Known Issues
14-Jul-2013
2-1
AST v2013.1
Installation Guide
Fortran 90 Compiler
C++ Compiler
Known Issues are available on the AST Service World Knowledge Base:
Link to AWS Known Software Issues
RHEL Red Hat Enterprise Linux
SLES SUSE Linux Enterprise Server
1)
2)
1)
Solver
Serial
MPI
O 2)
O in white field The software for this platform is available. The v2013.1 installation is
available on the Service World
grey field
The software for these platforms is not available.
2-2
14-Jul-2013
Installation Guide
AST v2013.1
BOOST
EXCITE
Processor(s)
Main Memory
Graphics Card
~5 GByte for the software (all interactive tools and the solver,
excluding examples)
The graphic boards used on Linux and Windows PCs for testing AVL AST software are
Nvidia Quadro FX1800 and Nvidia Qadro 2000 boards.
Internet Browser
(Microsoft Internet Explorer, Mozilla Firefox or Google Chrome on Windows;
Mozilla Firefox, Google Chrome or Opera on Linux/Unix)
Note: Internet Explorer 8 and higher and Firefox 14 are required for the html online
documentation.
PDF Reader
e.g. Adobe Acrobat Reader for Windows and Linux
14-Jul-2013
2-3
Installation Guide
AST v2013.1
If there are problems starting the installer either from the DVD or the ISO image, a selfextracting executable exists as an additional installation option. Download the executable
and double click it to start the installation.
The following steps are necessary to perform the installation:
1.
2.
3.
4.
If the self-extracting executable is used for the installation the first step is skipped and the
installation GUI is started automatically after double-clicking the executable.
Additionally, the following third party tools are installed:
3.1. Start Up
First insert the DVD in the PC or mount the ISO image. If the setup program does not
start automatically, perform the following steps:
1.
2.
3.
14-Jul-2013
3-1
AST v2013.1
Installation Guide
Note: A user account control dialog might pop up asking to allow the installer
to make changes to the computer. Please confirm by clicking Yes to continue.
3.2. Installation
As soon as the AVL AST software installer is started, it temporarily extracts the required
resources. A window similar to the following displays the progress.
3.2.1. Introduction
The Introduction dialog gives basic information about the installation and allows this
document to be opened in a PDF document reader.
3-2
14-Jul-2013
Installation Guide
AST v2013.1
14-Jul-2013
3-3
AST v2013.1
Installation Guide
3-4
14-Jul-2013
Installation Guide
AST v2013.1
14-Jul-2013
3-5
AST v2013.1
Installation Guide
3-6
14-Jul-2013
Installation Guide
AST v2013.1
Note: This dialog is optional and might not appear during the installation.
14-Jul-2013
3-7
AST v2013.1
Installation Guide
3-8
14-Jul-2013
Installation Guide
AST v2013.1
14-Jul-2013
3-9
AST v2013.1
Installation Guide
3-10
14-Jul-2013
Installation Guide
AST v2013.1
14-Jul-2013
3-11
AST v2013.1
Installation Guide
3-12
14-Jul-2013
Installation Guide
AST v2013.1
14-Jul-2013
3-13
AST v2013.1
Installation Guide
menu.
3-14
14-Jul-2013
Installation Guide
AST v2013.1
Software which might be additionally required depending on the AVL AST product can be
found on the AVL AST Service World.
Create a response file by starting the setup program with the following flags:
setup.exe -r <path-to-response-file>
After running through the setup procedure as described above, a response file with the
name installer.properties is created at the path that was passed via the -r flag.
This file holds information about the responses the user has given during the run of
the setup program. It can now be edited by hand if needed.
2.
Run the installer in silent mode with the information from a response file by starting
the setup program with the following flags:
setup.exe -i silent -f <response-file-including-path>
So in the default case:
setup.exe -r <path-to-response-file>/installer.properties
14-Jul-2013
3-15
AST v2013.1
Installation Guide
3.6. Uninstall
To uninstall an AVL AST software product, open the CONTROL PANEL window (by
clicking Start - Control Panel).
3-16
14-Jul-2013
Installation Guide
AST v2013.1
14-Jul-2013
3-17
AST v2013.1
Installation Guide
3-18
14-Jul-2013
Installation Guide
AST v2013.1
14-Jul-2013
3-19
Installation Guide
AST v2013.1
2.
3.
4.
If the self-extracting executable is used for the installation the first step is skipped and the
installation GUI is started automatically after double-clicking the executable.
1 username groupname
If a line similar to the following line appears then the DVD drive must be mounted
manually:
/DVD/setup.sh: No such file or directory
14-Jul-2013
1.
2.
4-1
AST v2013.1
Installation Guide
3.
4.
If you have problems using the ISO images, a workaround could be to burn the ISO image
on a DVD and perform the installation from the DVD.
C-shell
setenv DISPLAY
<hostname>:0.0
DISPLAY=
<hostname>:0.0
Export DISPLAY
4.3.1. Introduction
The Introduction dialog gives basic information about the installation and allows this
document to be opened in a PDF document reader.
4-2
14-Jul-2013
Installation Guide
AST v2013.1
14-Jul-2013
4-3
AST v2013.1
Installation Guide
4-4
14-Jul-2013
Installation Guide
AST v2013.1
14-Jul-2013
4-5
AST v2013.1
Installation Guide
4-6
14-Jul-2013
Installation Guide
AST v2013.1
14-Jul-2013
4-7
AST v2013.1
Installation Guide
4-8
14-Jul-2013
Installation Guide
AST v2013.1
14-Jul-2013
4-9
AST v2013.1
Installation Guide
other shells
Login File:
$HOME/.login
Define:
Login File:
$HOME/.profile
Define:
<VARIABLE>=<Value>
export <VARIABLE>
4-10
14-Jul-2013
Installation Guide
AST v2013.1
Description
Modify this environment variable if not done during installation.
csh/tcsh:
setenv PATH
PATH
<Installation Path>/bin:$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
(<Installation Path>/license/license.dat).
LM_LICENSE_FILE
csh/tcsh:
setenv LM_LICENSE_FILE
<Installation Path>/license/license.dat
other shells:
LM_LICENSE_FILE=<Installation Path>/license/licens
e.dat ; export LM_LICENSE_FILE
AVLAST_HOME
DISPLAY
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.
14-Jul-2013
4-11
AST v2013.1
Installation Guide
Case
What to do
A new version of an
existing AST product
is installed
(e.g. v2013)
Create symbolic link to another location and start then the installation
tool.
mkdir p <installpath2>/<product>
cd <installpath2>/<product>
ln -s <installpath>/<product>/v2013 v2013
/DVD/setup.sh
4-12
14-Jul-2013
Installation Guide
AST v2013.1
Create a response file by starting the setup program with the following flags:
./setup.sh r <path-to-response-file>
After running through the setup procedure as described above, a response file is
created at the path that was passed via the r flag. This file holds information about
the responses the user has given during the run of the setup program. It can now be
edited by hand if needed.
2.
Run the installer in silent mode with the information from a response file by starting
the setup program with the following flags:
./setup.sh -i silent -f <path-to-response-file>
4.8. Uninstall
Uninstall is supported provided that a local Java installation is available on your machine.
Version requirements: Java 1.6 or later on Linux.
To uninstall <product> change to the top directory of your <product> installation and
execute:
./Uninstall/<product>_v2013/Uninstall\ AVL\ <product>\ v2013
After the uninstall program has started and you have confirmed to uninstall <product>
v2013, all components of <product> v2013 will be removed.
Note: the file name contains space characters, these have to be escaped by a \.
14-Jul-2013
4-13
AST v2013.1
Installation Guide
What to do
AVL Workspace is
to be installed the
first time; a different
AST product (e.g.
FIRE) exists.
-s
-s
-s
-s
-s
-s
-s
-s
-s
<installpath2>/AWS <installpath>/AWS
<installpath2>/AUTOSHAFT <installpath>/AUTOSHAFT
<installpath2>/BOOST <installpath>/BOOST
<installpath2>/EXCITE <installpath>/EXCITE
<installpath2>/EXCITE_PR <installpath>/EXCITE_PR
<installpath2>/EXCITE_TD <installpath>/EXCITE_TD
<installpath2>/FEA <installpath>/FEA
<installpath2>/BOOST_HYD <installpath>/BOOST_HYD
<installpath2>/IMPRESS <installpath>/IMPRESS
/DVD/setup.exe
4-14
14-Jul-2013
Installation Guide
AST v2013.1
Case 2
What to do
A new version of
AVL Workspace is
to be installed; a
previous version
exists already.
<installpath2>
<installpath2>/AWS
<installpath2>/AUTOSHAFT
<installpath2>/BOOST
<installpath2>/EXCITE
<installpath2>/EXCITE_PR
<installpath2>/EXCITE_TD
<installpath2>/FEA
<installpath2>/BOOST_HYD
<installpath2>/IMPRESS
ln -s <installpath2>/AWS/v2013.1 <installpath>/AWS/v2013.1
ln -s <installpath2>/AUTOSHAFT/v2013.1
<installpath>/AUTOSHAFT/v2013.1
ln -s <installpath2>/BOOST/v2013.1 <installpath>/BOOST/v2013.1
ln -s <installpath2>/EXCITE/v2013.1 <installpath>/EXCITE/v2013.1
ln -s <installpath2>/EXCITE_PR/v2013.1 <installpath>/
EXCITE_PR/v2013.1
ln -s <installpath2>/EXCITE_TD/v2013.1
<installpath>/EXCITE_TD/v2013.1
ln -s <installpath2>/FEA/v2013.1 <installpath>/FEA/v2013.1
ln -s <installpath2>/BOOST_HYD/v2013.1
<installpath>/BOOST_HYD/v2013.1
ln -s <installpath2>/IMPRESS/v2013.1 <installpath>/IMPRESS/v2013.1
/DVD/setup.exe
14-Jul-2013
4-15
Installation Guide
AST v2013.1
Windows:
C:\Users\<username>\AppData\Roaming\AVL
Linux:
$HOME/.avl
AVLAST_SITEHOME
14-Jul-2013
Purpose:
Windows:
C:\ProgramData\AVL
Linux:
$AVLAST_HOME
5-1
AST v2013.1
Installation Guide
Windows:
Linux:
$HOME/.avl
AVL_COMMON_APPDATA
Purpose:
see AWS_SITEHOME
Windows:
%AVLAST_HOME%
Linux:
$AVLAST_HOME
AWS_USERHOME
Purpose:
Windows:
%AVL_APPDATA%\AWS\v2013\user
Linux:
$AVL_APPDATA/AWS/v2013/user
AWS_SITEHOME
Purpose:
Windows:
%AVL_COMMON_APPDATA%\AWS\v2013\site
Linux:
$AVL_COMMON_APPDATA/AWS/v2013/site
Windows:
Linux:
$AVL_APPDATA/AWS/tmp
5-2
14-Jul-2013
Installation Guide
AST v2013.1
iexplore
Linux default:
firefox
AWS_FILE_BROWSER
Windows default:
explorer.exe
Linux default:
nautilus
(alternatives: konqueror, )
Windows default:
notepad.exe
(alternatives: write.exe, )
Linux default:
nedit
AWS_WINEDITOR
14-Jul-2013
5-3
Installation Guide
AST v2013.1
6. LICENSING
The installation and setup process is described in the AST Licensing Users Guide.
Software Product
Name
Company
System ID
Local installation:
Network installation:
The above information can be obtained in the License Definition utility. In the AST
launcher select AST | Product Licensing, then select the License Request tab which
contains the necessary information. Please complete the template text and send it to AVL.
Example
Linux
Composite $AVLAST_HOME/bin/ast_license_composite
Hostid
COMPOSITE=
C25C48BF77F9
Windows
Composite %AVLAST_HOME%\bin\ast_license_composite.exe
Hostid
COMPOSITE=
88F360B80245
14-Jul-2013
6-1
Installation Guide
AST v2013.1
14-Jul-2013
7-1
AST v2013.1
Installation Guide
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
If you have any problem using the EXCITE and EXCITE_R command or ANSYS to
EXCITE Interface, contact the technical support at [email protected].
7-2
14-Jul-2013
Installation Guide
AST v2013.1
14-Jul-2013
ANSYS version
AWS and EXCITE version (can be found under Menu Help | About)
hardware platform
body type
if possible, attach
File <bodyname>.PROC_STATUS
7-3