ANSYS Mechanical

ANSYS Mechanical is a computational structural mechanics software which makes it possible to solve structural engineering problems. It is available in two different software environments – ANSYS Workbench (the newer GUI-oriented environment) and ANSYS Mechanical APDL (sometimes called ANSYS Classic, the older MAPDL scripted environment).

Please note that the clusters do not come with any license. If you want to use ANSYS products on the HPC clusters, you have to have access to suitable licenses. These can be purchased directly from RRZE. To efficiently use the HPC resources, ANSYS HPC licenses are necessary.

Availability / Target HPC systems

Production jobs should be run on the parallel HPC systems in batch mode. For simulations with high memory requirements, a single-node job on TinyFAT can be used.

ANSYS Mechanical can also be used in interactive GUI mode via Workbench for serial pre- and/or post-processing on the login nodes. This should only be used to make quick simulation setup changes.  It is NOT permitted to run computationally/memory intensive ANSYS Mechanical simulations on login nodes.

Different versions of all ANSYS products are available via the modules system, which can be listed by module avail ansys. A special version can be loaded, e.g. by module load ansys/2019R1.

We mostly install the current versions automatically, but if something is missing, please contact


  • Two different parallelization methods are available: shared-memory and distributed-memory parallelization.
  • Shared-memory parallelization: uses multiple cores on a single node; specify via ansys191 -smp -np N, default: N=2
  • Distributed-memory parallelization: uses multiple nodes; specify via ansys191 -dis -b -machines machine1:np:machine2:np:...

Sample job scripts

All job scripts have to contain the following information:

  • Resource definition for the queuing system (more details here)
  • Load ANSYS environment module
  • Generate a variable with names of hosts of the current simulation run and specify the number of processes per host
  • Execute Mechanical with appropriate command line parameters (distributed memory run in batch mode)
  • Specify input and output file

#!/bin/bash -l
#PBS -lnodes=2:ppn=40,walltime=24:00:00
#PBS -N mech
#PBS -j eo

# load environment module
module load ansys/XXXX
# generate machine list, uses 20 processes per node
machines=$(cat $PBS_NODEFILE | uniq | echo $(awk '{print $0":20"}') | sed 's/ /:/g')

# execute mechanical with command line parameters 
# Please insert here the correct version and your own input and output file with its correct name! 
ansys191 -dis -b -machines $machines < input.dat > output.out

Further information

  • Documentation is available within the application help manual. Further information is provided through the ANSYS Customer Portal for registered users.
  • More in-depth documentation is available at LRZ. Please note: not everything is directly applicable to HPC systems at RRZE!