ANSYS is a finite-element-based, general-purpose solver, mostly used for engineering applications. Local support is minimal; users should make an account at the ANSYS web page to get technical support directly from the vendor.


UVA has a research license that covers most research needs, but it is not the default.  If you do not change your license preferences, you will be directed to the education license, which is very limited.  You can change this in the ANSYS user interface through the licensing utility.  Run


substituting the appropriate version number for <version>, such as 18.1.  This will start a graphical user interface, so you must be running with X11 enabled or else use FastX.

When the interaface starts, on the left choose

Set License Preferences for User mst3k

It should automatically show your correct user ID in place of mst3k.  Select

ANSYS Academic Research

On the right of the interface, click Move Up until this choice is at the top of the list of licensing options.  Click Apply.  Repeat this for each tab in the license wizard.  Once done, click OK.

The number of these licenses is very limited, except for members of groups that have contributed to the UVA overall Research license, or who have their own.  Please consult with your department to be added to the appropriate license if you are a member of one of these groups.

If your group has its own license server, you must edit a configuration file license.preferences.xml to indicate what your group has purchased.  Create a ~/.ansys/<version>/licensing folder in your home directory on Rivanna.  (Note the period in front of the word "ansys.")  You may already have the ~/.ansys directory from earlier versions.  The <version> can be obtained from the module version, with decimal points omitted. If you had one from an older version of ANSYS, you should only need to copy the existing license.preferences.xml file into the folder for the new version.

Multi-Node HPC

If you wish to run in multi-node HPC, please submit a ticket to and ask to be added to the Ansys HPC group.  You must also set up passwordless ssh between nodes to do a multi-node run.  You should specify the IBM PlatformMPI distribution with -mpi=ibmmpi along with the flag -srun to dispatch the MPI tasks using SLURM's task launcher.  Also include the -slurm option.  See this example script below for CFX (other components, such as Fluent, use similar command-line options):

#SBATCH --nodes=2 
#SBATCH --ntasks-per-node=16 
#SBATCH --time=12:00:00 
#SBATCH --partition=parallel
#SBATCH -J myCFXrun 
#SBATCH -A mygroup 
#SBATCH --output=myCFXrun.txt

mkdir /scratch/$USER/myCFXrun
cd /scratch/$USER/myCFXrun
module load ansys/18.1

/share/apps/ansysoft/18.1/ansys/v181/CFX/bin/cfx5solve -def /scratch/$USER/Unstruct_600.def -ini-file/scratch/$USER/Myfile.res -size 1.2 -sizepar 1.2 -parallel -mpi=ibmmpi -srun -slurm -par-local partition 8