SHELL 22.1

LINUX Installation

LINUX Installation

On LINUX systems the SHELL is accessed via the "oasys_22" command. If you have installed the software using the install script then the oasys_22 command file (in the /executables directory) will automatically be updated to contain the correct path for the directory the software was installed in and the name of the license server for the software installation. .

In addition to specifying the installation directory and the license server the "oasys_22" command file can also be set a number of other options on LINUX systems.

After installing the software the "oasys_22" command file should contain the following. ( This assumes the software was loaded in a directory called /prg and that the license server in a machine called atghps50 .

#!/bin/csh -f
onintr start_flush
#
# Set OA_INSTALL to point to the directory containing the software
#
setenv OA_INSTALL "/prg/oasys20/executables"
#
# Set OA_ADMIN directory
#
# setenv OA_ADMIN
#
# Set ARUP_LICENSE_PATH to either the Oasys LM-X license file or
# the license server
#
# e.g setenv ARUP_LICENSE_PATH $OA_INSTALL/arup.lic
# or setenv ARUP_LICENSE_PATH @hostname
#
setenv ARUP_LICENSE_PATH @atghp02
#
# Set LSTC_FILE to either the lstc license file or the server
#
# e.g. setenv LSTC_LICENSE local
# setenv LSTC_FILE $OA_INSTALL/LSTC_FILE
#
# e.g. setenv LSTC_LICENSE_SERVER hostname
# setenv LSTC_INTERNAL_CLIENT OFF
# setenv LSTC_LICENSE network
#
setenv LSTC_FILE $OA_INSTALL/LSTC_FILE
#
# Other environment variables
#
setenv USERID `whoami`
set noglob
#
# This environment variable gives a more stable animation frame rate on
# machines equipped with NVidia graphics cards
#
setenv __GL_CONSTANT_FRAME_RATE_HINT 1
#
#
# Set EDITOR (if not set) to the command to invoke an external editor. This
# EDITOR is currently used for editing comment lines in Oasys Ltd. PRIMER.
#
# if(! $?EDITOR) then
#setenv EDITOR /usr/bin/kedit # LINUX
# endif
#
# Environment variables for post processors
#
# If FILE_SKIP has not been set then set it to 5
#
if(! $?FILESKIP) then
setenv FILE_SKIP 5
endif
#
# MACHINE SPECIFIC LINES
# ======================
#
# extra line needed for some IBM machines
# setenv LANG En_US
#
# Extra line needed for SUN Solaris Machines
# setenv LD_LIBRARY_PATH /usr/openwin/lib
#
#
# Now start the main shell executable
#
set cwd = `pwd`
setenv PWD $cwd
$OA_INSTALL/xshell_20 $*
#
# exit
#
exit:
exit

The following parameters will require modifying in accordance with your system layout

setenv OA_INSTALL<option>
setenv OA_ADMIN / OA_ADMIN_22<option> (optional)
setenv ARUP_LICENSE_PATH / LMX_LICENSE_PATH <option>
setenv LSTC_FILE / LSTC_LICENSE_SERVER <option>
setenv MENU_AUTO_CONFIRM <option> (optional)
setenv FILE_EXIST_ACTION <option> (optional)
setenv ECHO_PREFERENCE <option> (optional)

setenv OA_INSTALL <option>

The 'OA_INSTALL' SHELL variable must be modified so that it references the directory in which the SHELL is loaded. i.e if the software has been loaded in:

/prg/oasys22/executables

set this line to:

setenv OA_INSTALL"/prg/oasys22/executables"

This line should be set automatically by the installation script.

setenv OA_ADMIN / OA_ADMIN_22<option>

If a top level administration directory is to be used then OA_ADMIN_22 (for release 22.1) must be defined for all machines on which the software is to be run. This variable should be set to the full pathname of the administration directory.

A description of the installation organisation is given in the Appendix.

setenv ARUP_LICENSE_PATH / LMX_LICENSE_PATH <option>

Either ARUP_LICENSE_PATH or LMX_LICENSE_PATH can be used to locate a valid license for the Oasys LS-DYNA Environment software. It is recommended that ARUP_LICENSE_PATH is used as this can speed up the checkout of licenses on systems where LMX_LICENSE_PATH is used to find other license servers as well.

Floating Network License

If you are running the software using a license server then this variable should be set to point to the license server machine using the machine's hostname.

i.e setenv ARUP_LICENSE_PATH hostname
or setenv ARUP_LICENSE_PATH port@hostname if you have specified a non default port for the server.

Fixed Stand-alone Licenses

If you are using a node locked license file then this variable should be set to point to the location of the license file.

i.e setenv ARUP_LICENSE_PATH<INSTALL_DIR>/arup.lic

Multiple LMX license files

If you have other software that uses LMX then this Environment variable may already be set to point to a license file or a license server. If this variable is already set then you may add the license server or file for this software by specifying a colon separated list of values.

i.e setenv ARUP_LICENSE_PATHport@hostname1: @hostname2

setenv LSTC_FILE / LSTC_LICENSE_SERVER <option>

On LINUX machines Ansys LS-DYNA can use either a nodelocked license or a floating license system.

If you are using a nodelocked license then LSTC_FILE should be set to the full pathname of the license file. By default this file should be called 'LSTC_FILE' and it should be located in the 'executables' directory. The variable LSTC_LICENSE should also be set to "local"

i.e setenv LSTC_FILE$OA_INSTALL/LSTC_FILE
     setenv LSTC_LICENSE  local

If you are using the floating license system then the variables LSTC_LICENSE_SERVER, LSTC_INTERNAL_CLIENT and LSTC_LICENSE should be set as follows.

i.e setenv LSTC_LICENSE_SERVER  hostname where hostname is the LSTC license server
     setenv LSTC_INTERNAL_CLIENT  OFF
     setenv LSTC_LICENSE  network

setenv MENU_AUTO_CONFIRM <option>

This variable is often used when replaying command files which, when recorded, paused and asked the user to confirm things. (For example HELP and Warning messages.) Possible options for this variable are, true and false .

If the variable is set (true) then these will not pause and will behave as if the user had pressed "OK" - meaning that command files can play back without user intervention.

setenv FILE_EXIST_ACTION <option>

This variable controls the action to be taken when opening a file for output, and the file already exists. Possible options for this variable are "none" , overwrite and append .

Normally you will be prompted for the action to be taken when a file selected for output already exists. However if this variable is set to overwrite or append then the relevant action will be taken automatically.

This is generally used when playing automatic post-processing batch scripts

setenv ECHO_PREFERENCE <option>

If this variable is set to "1" then any command line arguments used to start T/HIS, PRIMER or D3PLOT will be echoed to the screen along with any settings read from preference files.