Installation Guide for Linux

ANSYS, Inc. Release 2020 R1

Southpointe January 2020
2600 ANSYS Drive 000408
Canonsburg, PA 15317 ANSYS, Inc. and
ansysinfo@ansys.com ANSYS Europe,
Ltd. are UL
http://www.ansys.com registered ISO
(T) 724-746-3304 9001: 2015
(F) 724-514-9494 companies.
Revision Information

The information in this guide applies to all ANSYS, Inc. products released on or after this date, until superseded
by a newer version of this guide. This guide replaces individual product installation guides from previous releases.

Copyright and Trademark Information

© 2020 ANSYS, Inc. Unauthorized use, distribution or duplication is prohibited.

ANSYS, ANSYS Workbench, AUTODYN, CFX, FLUENT and any and all ANSYS, Inc. brand, product, service and feature
names, logos and slogans are registered trademarks or trademarks of ANSYS, Inc. or its subsidiaries located in the
United States or other countries. ICEM CFD is a trademark used by ANSYS, Inc. under license. CFX is a trademark
of Sony Corporation in Japan. All other brand, product, service and feature names or trademarks are the property
of their respective owners. FLEXlm and FLEXnet are trademarks of Flexera Software LLC.

Disclaimer Notice

THIS ANSYS SOFTWARE PRODUCT AND PROGRAM DOCUMENTATION INCLUDE TRADE SECRETS AND ARE CONFID-
ENTIAL AND PROPRIETARY PRODUCTS OF ANSYS, INC., ITS SUBSIDIARIES, OR LICENSORS. The software products
and documentation are furnished by ANSYS, Inc., its subsidiaries, or affiliates under a software license agreement
that contains provisions concerning non-disclosure, copying, length and nature of use, compliance with exporting
laws, warranties, disclaimers, limitations of liability, and remedies, and other provisions. The software products
and documentation may be used, disclosed, transferred, or copied only in accordance with the terms and conditions
of that software license agreement.

ANSYS, Inc. and ANSYS Europe, Ltd. are UL registered ISO 9001: 2015 companies.

U.S. Government Rights

For U.S. Government users, except as specifically granted by the ANSYS, Inc. software license agreement, the use,
duplication, or disclosure by the United States Government is subject to restrictions stated in the ANSYS, Inc.
software license agreement and FAR 12.212 (for non-DOD licenses).

Third-Party Software

See the legal information in the product help files for the complete Legal Notice for ANSYS proprietary software
and third-party software. If you are unable to access the Legal Notice, contact ANSYS, Inc.

Published in the U.S.A.

Table of Contents
1. Installation Prerequisites for Linux ........................................................................................................ 1
1.1. System Prerequisites ......................................................................................................................... 3
1.1.1. CAD Support ............................................................................................................................ 3
1.2. Disk Space and Memory Requirements ............................................................................................. 4
1.3. Requirements for the GPU Accelerator in Mechanical APDL ............................................................... 5
1.4. Additional Hardware and Software Requirements ............................................................................. 5
1.5. Third-Party Software and Other Security Considerations .................................................................... 7
2. Platform Details ...................................................................................................................................... 9
2.1. Utilizing CPU Hyperthreading Technology with ANSYS CFD Solvers .................................................. 15
2.2. Compiler Requirements for Linux Systems ....................................................................................... 15
2.3. Select Your Installation .................................................................................................................... 15
3. Installing ANSYS Products for a Stand-alone Linux System ................................................................. 17
3.1. Pre-Installation Instructions for Download Installations .................................................................... 18
3.2. Product Download Instructions ....................................................................................................... 18
3.3. Installing from a USB Drive .............................................................................................................. 19
3.4. Mounting the DVD Instructions for DVD Installations (Linux x64 Only) .............................................. 20
3.5. Product Installation ......................................................................................................................... 21
3.5.1. Specifying CAD Configurations ............................................................................................... 24
3.5.2. ANSYS License Manager Installation ....................................................................................... 25
3.5.2.1. Registering the License Server ....................................................................................... 26
4. Installing ANSYS Products and the License Server on Different Linux Machines ................................ 29
4.1. Pre-Installation Instructions for Download Installations .................................................................... 30
4.2. Product Download Instructions ....................................................................................................... 30
4.3. Installing from a USB Drive .............................................................................................................. 31
4.4. Mounting the DVD Instructions for DVD Installations (Linux x64 Only) .............................................. 32
4.5. Product Installation ......................................................................................................................... 33
4.5.1. Specifying CAD Configurations ............................................................................................... 36
4.5.2. ANSYS License Manager Installation ....................................................................................... 37
4.5.2.1. Registering the License Server ....................................................................................... 39
4.5.3. Network Installation and Product and CAD Configuration ....................................................... 39
4.5.3.1. Export the /ansys_inc Directory ............................................................................... 39
4.5.3.2. Run the Product & CAD Configuration Manager on All Client Machines ........................... 40
5. Post-Installation Instructions ............................................................................................................... 43
5.1. Post-Installation Procedures for Mechanical APDL and ANSYS Workbench Products ......................... 44
5.1.1. Post-Installation Procedures for ANSYS CFX ............................................................................. 45
5.1.1.1. Setting up ANSYS TurboGrid Release 2020 R1 ................................................................. 46
5.1.1.2. Using the ANSYS CFX Launcher to Set Up Users .............................................................. 47
5.1.2. Post-Installation Procedures for ANSYS Fluent ......................................................................... 47
5.1.3. Post-Installation Procedures for ANSYS Polyflow ..................................................................... 48
5.1.4. Post-Installation Procedures for ANSYS ICEM CFD .................................................................... 48
5.1.5. Post-Installation Procedures for ANSYS Autodyn ..................................................................... 48
5.1.6. Post-Installation Procedures for ANSYS FENSAP-ICE ................................................................. 49
5.1.7. Post-Installation Procedures for Other Products ...................................................................... 50
5.2. Product Localization ....................................................................................................................... 51
5.2.1. Translated Message File Installation for Mechanical APDL ....................................................... 51
5.3. Launching ANSYS, Inc. Products ....................................................................................................... 52
6. Silent Mode Operations ........................................................................................................................ 53
6.1. Silent Product and License Manager Installation .............................................................................. 54
6.2. Silent Product Configuration/Unconfiguration ................................................................................. 56
6.3. Silent Media Installation .................................................................................................................. 57

Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. iii
Linux Installation Guide

6.3.1. Silent Uninstall ....................................................................................................................... 57

7. Configuring CAD Products .................................................................................................................... 59
7.1. Using the Product & CAD Configuration Manager ............................................................................ 59
7.1.1. Unconfiguring ........................................................................................................................ 60
7.1.2. Running the Product & CAD Configuration Manager in Batch Mode .................................... 60
7.1.3. NX Configuration ................................................................................................................... 61
8. Uninstalling the Software ..................................................................................................................... 63
9. Troubleshooting .................................................................................................................................... 65
9.1. Installation Troubleshooting ............................................................................................................ 65
9.1.1. Gathering Diagnostic Information .......................................................................................... 65
9.1.2. The GUI Installation Process Hangs ......................................................................................... 65
9.1.3.The Target Machine Does Not Have a DVD Drive ...................................................................... 66
9.1.4. Product & CAD Configuration Manager Help Does Not Load .................................................... 66
9.1.5. Cannot Enter Data in Text Fields .............................................................................................. 66
9.1.6. Download and Installation Error Messages .............................................................................. 66
9.1.7. System-related Error Messages ............................................................................................... 67
9.1.8. High Performance Computing Error Messages ........................................................................ 67
9.1.9. INSTALL Command Appears as Lowercase in USB Installation .................................................. 67
9.2. Installation Troubleshooting - Graphics ........................................................................................... 67
9.2.1. DesignModeler and Mechanical APDL Crash When Using the Latest AMD Graphics
Drivers .......................................................................................................................................... 67
9.3. Installation Troubleshooting - Mechanical APDL .............................................................................. 68
9.3.1.Your batch jobs terminate when you log out of a session ......................................................... 68
9.3.2. Mechanical APDL Documentation File for User Interface Error Messages .................................. 68
9.3.3. Launcher Error Messages ........................................................................................................ 68
9.3.4. FORTRAN Runtime Error Messages ......................................................................................... 69
9.3.4.1. Intel Linux 64 Systems ................................................................................................... 69
9.3.4.2. Intel EM64T Linux x64 Systems ....................................................................................... 69
9.3.4.3. AMD Opteron Linux x64 Systems ................................................................................... 69
9.4. Installation Troubleshooting - ANSYS Workbench ............................................................................ 69
9.4.1. Startup or Graphics Problems ................................................................................................. 69
9.5. Installation Troubleshooting - ANSYS CFX ........................................................................................ 70
9.5.1. CFX Distributed Parallel Runs Fail ............................................................................................ 70
9.6. Contacting Technical Support ......................................................................................................... 70
10. Applications Included with Each Product ........................................................................................... 71

Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
iv of ANSYS, Inc. and its subsidiaries and affiliates.
List of Tables
1.1. Supported Linux Platforms ..................................................................................................................... 3
1.2. CAD Support by Platform ........................................................................................................................ 3
2.1. Compiler Requirements for All Linux Versions ........................................................................................ 15
5.1. Startup Commands ............................................................................................................................... 52

Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. v
 Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
vi of ANSYS, Inc. and its subsidiaries and affiliates.
Chapter 1: Installation Prerequisites for Linux
This document describes the steps necessary to correctly install and configure all ANSYS, Inc. products
on Linux platforms for Release 2020 R1. These products include:

• ANSYS Explicit Dynamics

– ANSYS Autodyn

– ANSYS LS-DYNA

• ANSYS Fluid Dynamics

– ANSYS CFD-Post only

– ANSYS CFX (includes ANSYS CFD-Post)

– ANSYS Chemkin

– ANSYS Energico

– ANSYS Model Fuel Library

– ANSYS Reaction Workbench

– ANSYS EnSight

– ANSYS FENSAP-ICE

– ANSYS Fluent (includes ANSYS CFD-Post)

– ANSYS Forte

– ANSYS TurboGrid

– ANSYS Polyflow (includes ANSYS CFD-Post)

• ANSYS ICEM CFD

• ANSYS Offshore

– ANSYS Aqwa

• ANSYS Structural Mechanics

– ANSYS Customization Files for User Programmable Features

– ANSYS Mechanical Products (includes Mechanical APDL, Mechanical and ANSYS Composite PrepPost,
where supported)

• ANSYS Additional Tools

Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 1
Installation Prerequisites for Linux

– ANSYS Composite PrepPost

– ANSYS Icepak (includes ANSYS CFD-Post)

– Remote Solve Manager Standalone Services

• ANSYS Geometry Interfaces

– ACIS

– CATIA, Version 5

– NX

– Parasolid

Notes Not all products may be available on all Linux platforms. See the remainder of this document
for detailed information on which products are available on which platforms.

At Release 2020 R1, ANSYS BladeGen, Vista CCD, Vista CPD, Vista RTD, and Vista AFD are not supported
on Linux platforms.

ANSYS Workbench is installed by default as product components to most ANSYS, Inc. products. ANSYS
Workbench is not installed as part of the products under ANSYS Additional Tools. ANSYS Workbench
includes the following applications:

• DesignModeler

• Design Exploration

• Meshing

• Remote Solve Manager

• Fluent Meshing

• EKM Client

Important Notice
If you wish to run multiple releases of ANSYS, Inc. software, you MUST install them chronologically (i.e.,
Release 2019 R3 followed by Release 2020 R1). If you install an earlier release after installing Release
2020 R1, you will encounter licensing issues that may prevent you from running any products/releases.
If you need to install an earlier release after you have already installed Release 2020 R1, you MUST un-
install Release 2020 R1, then re-install the releases in order.

Summary of New and Changed Features

The following features are new or changed at Release 2020 R1. Review these items carefully.

• The product installation CAD configuration process has been enhanced to include automatic recognition
and configuration of the associative interfaces. Additionally, you can still manually configure the associative
interfaces during product installation or perform the configuration after the product installation is complete.

• The ANSYS AQWA product has been added to the ANSYS installation program for Linux.

Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
2 of ANSYS, Inc. and its subsidiaries and affiliates.
 System Prerequisites

1.1. System Prerequisites

ANSYS, Inc. Release 2020 R1 products are supported on the Linux platforms and operating system levels
listed in the following tables. Patches listed may be superseded by newer versions; see your vendor for
the most current version. See the individual Platform Certification Specifics in this guide for more in-
formation on specific platform requirements. For up-to-date information on hardware platforms or op-
erating systems that have been certified, go to the Platform Support section of the ANSYS Website.

Table 1.1: Supported Linux Platforms

Platform Processor Operating System Platform Availability

architecture
(directory name)
Linux x64 EM64T/Opteron 64 Red Hat Enterprise Linux 7.4 - linx64 Download
7.6, SUSE Linux Enterprise / USB
Server and Desktop 12 SP2 -
SP4, CentOS 7.4 - 7.6
For detailed and current support information, see the Platform Support section of the ANSYS Website.

Supported Platforms for High Performance Computing See the discussions on Configuring Distrib-
uted ANSYS and Configuring ANSYS CFX Parallel for detailed information on supported platforms for
distributed computing.

Supported Products By Platform For a complete list of products supported by each platform, see
the Platform Support by Application PDF on the Platform Support section of the ANSYS Website.

1.1.1. CAD Support

The following CAD and auxiliary programs are supported on the indicated products and platforms.
Products are:

A = Mechanical APDL
W = ANSYS Workbench
I = ANSYS ICEM CFD (standalone and ANSYS Workbench Readers)

Table 1.2: CAD Support by Platform

Linux x64
CATIA 4.2.4 A, I
CATIA V5–6R2018 W, I
Parasolid 30.0 A, W, I
ACIS 2018 A, W, I 1
NX 10.0 A, W, I
NX 11.0 A, W, I
NX 12.0 A, W, I
STEP AP203, AP214 A, W, I
IGES A 2, W, I 3
GEMS I

Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 3
Installation Prerequisites for Linux

Linux x64
Rhinoceros I4

1. For ANSYS ICEM CFD standalone, ACIS 18.0.1 is the supported version for all platforms.

2. MAPDL supports 5.1 by default, but 5.2 is also supported if the IOPTN command is used.

3. IGES Versions 4.0, 5.2, and 5.3 are supported.

4. Support limited to Rhinoceros 3 and earlier.

1.2. Disk Space and Memory Requirements

You will need the disk space shown here for each product for installation and proper functioning. The
numbers listed here are the maximum amount of disk space you will need. Depending on the options
selected for each product and shared product features, you may require less disk space when installing
multiple products.

Product Disk Space

ANSYS Autodyn 15.2 GB
ANSYS LS-DYNA 15.7 GB
ANSYS CFD Post only 15.4 GB
ANSYS CFX 15.7 GB
ANSYS Chemkin 16.9 GB
ANSYS Energico 16.9 GB
ANSYS Model Fuel Library (Encrypted) 16.9 GB
ANSYS Reaction Workbench 16.9 GB
ANSYS EnSight 18.8 GB
ANSYS FENSAP-ICE 16.1 GB
ANSYS Fluent 18.7 GB
ANSYS Forte 15.9 GB
ANSYS Polyflow 19.6 GB
ANSYS TurboGrid 15.5 GB
ANSYS ICEM CFD 15.9 GB
ANSYS Aqwa 15.3 GB
ANSYS Aqwa
ANSYS Customization Files for User Programmable Features 14.9 GB
ANSYS Mechanical Products 17.6 GB
Distributed Computing Services 15.2 GB
ANSYS Icepak 19.1 GB
ANSYS Remote Solve Manager 14.9 GB
ANSYS Geometry Interfaces 15.2 GB
Disk space required to install all products: 34.4 GB

Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
4 of ANSYS, Inc. and its subsidiaries and affiliates.
 Additional Hardware and Software Requirements

Memory Requirements You must have a minimum of 8 GB of memory to run product installations;
16 or 32 GB of memory is recommended.

1.3. Requirements for the GPU Accelerator in Mechanical APDL

Your system must meet the following requirements to use the GPU accelerator capability in Mechanical
APDL. For information on the most recently tested NVIDIA GPU cards, see the GPU Accelerator Capab-
ilities PDF on the Platform Support section of the ANSYS Website.

• The machine(s) being used for the simulation must contain at least one NVIDIA GPU card. The following
cards are recommended:

NVIDIA Tesla Series (any model)

NVIDIA Quadro RTX 6000
NVIDIA Quadro RTX 8000
NVIDIA Quadro GV100
NVIDIA Quadro GP100
NVIDIA Quadro P6000
NVIDIA Quadro P5000

• When using the sparse solver or eigensolvers based on the sparse direct solver (for example, Block Lanczos
or subspace), only NVIDIA GPU devices with significant double precision performance (FP64) are recommended
in order to achieve optimal performance. These include the following models:

NVIDIA Tesla Series P100

NVIDIA Tesla Series V100
NVIDIA Quadro GV100
NVIDIA Quadro GP100

• NVIDIA GPU devices with at least 16GB of on-card memory are recommended in order to achieve meaningful
acceleration for most simulations in which the GPU card can be used.

• For NVIDIA GPU cards, the driver version must be 410.93 or newer.

• To utilize a NVIDIA GPU device that is not on the recommended list of cards, set the following environment
variable:

ANSGPU_OVERRIDE=1

This is most beneficial when you wish to run on newer NVIDIA GPUs that were not available at the
time of release of this version of the ANSYS program. If you choose to use this environment variable,
you should ensure that the NVIDIA GPU device that you wish to use is sufficiently powerful, in terms
of both double-precision compute power and on-card memory, to achieve meaningful acceleration
for your simulation. Using this environment variable with an underpowered CPU may actually decel-
erate your simulation.

1.4. Additional Hardware and Software Requirements

• Intel 64 / AMD64 system with a supported operating system version installed

Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 5
Installation Prerequisites for Linux

• 8 GB of RAM

• 128 GB free on the hard drive is recommended

• A current default web browser must be installed to view the ANSYS internet-based help documentation.

For a complete list of supported browsers, see the Browser Support PDF on the Platform Support
section of the ANSYS Website.

Note that Google Chrome does not support the Linux platforms that ANSYS supports.

For a local copy of the product documentation on your system, download an installable version from
the ANSYS Download Center. Instructions for installing the Local Help are included with the download
package.

• TCP/IP for the license manager (see the ANSYS Licensing Guide for more information on TCP/IP)

• Approximately twice as much swap space as memory. The amount of memory swap space on the system
may limit the size of the model that can be created and/or solved.

• Discrete graphics card with the latest drivers and compatible with the supported operating systems. For full
functionality, use of a recent NVIDIA Quadro or AMD FirePro card with at least 1 GB of discrete video memory
and supporting OpenGL version 4.5 or above. Intel Iris Pro Integrated graphics has also been used successfully.

For information on the most recently tested graphics cards, see the Graphics Cards TestedPDF on
the Platform Support section of the ANSYS Website.

Note:

– Vendor Legacy Support: To be compatible, legacy GL 4.5 compliant cards should

still be within the official legacy support period of their respective graphics vendor,
and must still be receiving regular driver updates. Visit the vendor websites (AMD
and NVIDIA) to review legacy hardware lists.

• A minimum screen resolution of: 1024 x 768 (4:3 aspect ratio), 1366 x 768 (16:9 aspect ratio) or 1280 x 800
(16:10 aspect ratio) with minimum 24 bit color. A higher screen resolution such as 1920x1080 (16:9) or
1920x1200 (16:10) is strongly recommended for most applications.

Note:

– A number of cosmetic display issues have been reported when running the installation
program on Linux platforms using AMD graphics cards. These issues do not affect the
installation functionality.

– Ultra High Definition (4K) Graphics Cards: Use of Ultra High Definition (4K) graphics
cards may cause a number of cosmetic display issues (including enlarged or reduced
text and incorrect positioning of option labels). These issues do not affect the function-
ality of the installation program.

• X11, OpenGL graphics libraries

Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
6 of ANSYS, Inc. and its subsidiaries and affiliates.
 Third-Party Software and Other Security Considerations

• Mesa-libGL (OpenGL) is required to run data-integrated ANSYS Workbench applications such as Mechanical.

• For most applications, a three-button mouse is required to access all available functionality.

• PDF reader software is required to read the installation guides and other user documentation.

• Running ANSYS Fluent or ANSYS CFX on Cray systems requires a minimum of Cray Linux Environment 6.0
update 03 (based on SUSE Linux Enterprise Server 12).

• For ANSYS CFX on Cray systems, in order to use the command-line application cfx5mondata, you must
ensure that library libsmime3.so is installed.

1.5. Third-Party Software and Other Security Considerations

The following third-party products are used as part of the installation process. In order for the installation
to work properly, you must allow access to these products.

Product Name Executable Name

Tcl tclsh
Tk wish
Perl perl
GNU gzip gzip
GNU tar tar

ANSYS, Inc. products may have softlinks that require 777 permissions. In addition, the following third-
party products are known to contain softlinks that require 777 permissions:

• CPython

• GCC

• IMPI

• INTELMPI

• MainWin

• Mono

• MPICH

• OPENMPI

• IBMMPI

• Perl

• Python

• Qt

• Qwt

Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 7
 Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
8 of ANSYS, Inc. and its subsidiaries and affiliates.
Chapter 2: Platform Details
Linux
For ALL 64-bit Linux platforms, OpenMotif, and Mesa libraries should be installed. These libraries are
typically installed during a normal Linux installation. You will also need the xpdf package to view the
online help.

SUSE Linux Enterprise Server and Desktop 12 SP2 - SP4 You need to install the following libraries
based on your OS version:

• libjpeg62 (SLE 12)

• motif (SLE 12)

Red Hat Enterprise Linux 7.4 - 7.6 You need to install the following libraries:

• libjpeg-turbo.x86_64

• libjpeg-turbo.i686

• libpng12

• libXp.x86_64

• xorg-x11-fonts-cyrillic.noarch

• xterm.x86_64

• openmotif.x86_64

• compat-gcc-44

• compat-libstdc++-33.i686

• compat-libstdc++-33.x86_64

• libstdc++.x86_64

• libstdc++.i686

• gcc-c++.x86_64

• compat-libstdc++-33.i686

• libstdc++-devel.x86_64

• libstdc++-devel.i686

• compat-gcc-34.x86_64

Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 9
Platform Details

• gtk2.i686

• libXxf86vm.i686

• libSM.i686

• libXt.i686

• xorg-x11-fonts-ISO8859-1-75dpi.noarch

• glibc-2.12-1.166.el6_7.1 (or greater)

• motif.x86_64

• motif.i686

Red Hat no longer includes the 32-bit libraries in the base configuration so you must install those sep-
arately.

For more information on Red Hat Enterprise Linux libraries, see the Red Hat Libraries site.

CentOS 7.4 - 7.6 You need to install the following libraries:

• libjpeg-turbo.x86_64

• libjpeg-turbo.i686

• glibc.i686

• glib2.i686

• bzip2-lib-s.i686

• compat-gcc-44.x86_64

• compat-gcc-44-c++.x86_64

• compat-libstdc++-33.i686

• compat-libstdc++-33.x86_64

• libpng.i686

• libtiff.i686

• libXft.i686

• libXxf86vm.i686

• sssd-client.i686

• libpng12

• libpng12.i686

• libXp

Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
10 of ANSYS, Inc. and its subsidiaries and affiliates.
• libXp.i686

• libXp

• openmotif

• zlib

• motif.x86_64

• motif.i686

If running ANSYS License Manager, also install

• redhat-lsb

• compat-libtiff3

• libldap-2_4-2

Additional requirements for Intel, AMD Opteron, and EM64T Linux systems are detailed below.

ANSYS, Inc. License Manager Linux x64 systems running the ANSYS, Inc. License Manager require
the Linux Standard Base (LSB) 3.0 package.

CATIA V4 with Mechanical APDL To run CATIA V4 with Mechanical APDL on Linux 64-bit platforms,
you must have the following Linux 32-bit i686 libraries:

• glibc

• libstdc++

ANSYS Workbench If you are running ANSYS Workbench using the KDE desktop environment, set
the focus stealing prevention level to "None" to prevent the project save dialog boxes from appearing
behind the application window:

1. Use the kcontrol command to launch the KDE Control Center.

2. In the Control Center window, select Desktop> Window Behavior> Advanced.

3. Change Focus Stealing Prevention Level to None.

4. Click Apply.

If you are running on KDE 4 or if the kcontrol command does not exist, use System Settings to set
the focus stealing prevention setting level to "None":

1. Use the systemsettings command to launch the System Settings.

2. In the System Settings window, select General> Window Behavior> Focus.

3. Change Focus Stealing Prevention Level to None.

4. Click Apply.

Semaphore Limit On some Linux systems, ANSYS Workbench reaches a system limit on the number
of semaphores in the Linux configuration. In this case, you will see a message similar to the following:

Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 11
Platform Details

sem_lock->semop->op_op: Invalid argument

sem_unlock->semctl: Invalid argument

To increase the number of semaphores, run the following command as owner or root:
% echo 256 40000 32 32000 > /proc/sys/kernel/sem

This modification takes effect immediately, but is reset at the next reboot. To avoid resetting the limit
when rebooting, add the above command to one of your system’s startup scripts by copying the com-
mand into a file called mod_sem and then setting up the following links to execute the file each time
you restart your system:
cp mod_sem /etc/init.d
ln -s /etc/init.d/mod_sem /etc/rc3.d/S61mod_sem
ln -s /etc/init.d/mod_sem /etc/rc5.d/S61mod_sem

ANSYS Icepak If you are running ANSYS Icepak on Redhat 7.4 and CentOS 7.3 and receive the following
error while launching the application, you must install libXScrnSaver as root user.

error while loading shared libraries: libXss.so.1: cannot open shared

object file: No such file or directory

Enter the following command to install libXScrnSaver as root user:

yum install libXScrnSaver

Mechanical, Meshing, and DesignModeler Applications If you are using a localized operating system
(such as French or German), you must set the mwcontrol VisualMainWin control on any machines
running these applications in order for these applications to recognize the correct numerical format.
ANSYS Workbench must already be installed before setting this control.

First, you need to ensure that the /v201/aisol/WBMWRegistry/ directory has write permissions.
From the /v201/aisol/ directory, issue the following command:
chmod -R 777 WBMWRegistry/

Then, use the following procedure to set mwcontrol for your locale:

1. cd to <wb_install directory>/v201/aisol

2. Issue the following command:

./.workbench -cmd mwcontrol

3. On the MainWin Control Panel, select Regional Settings.

4. Select the Regional Settings tab.

5. Change the language in the dropdown to match the language you want to use.

6. Check the Set as system default locale option.

7. Click Apply to accept the changes, and then click OK to dismiss the Change Regional Settings notification.

Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
12 of ANSYS, Inc. and its subsidiaries and affiliates.
Using Fluent with MPI On some operating systems, the default amount of physical memory that
can be pinned/locked by a user application is set to a low value and must be explicitly increased. A
value recommended by Intel is 90% of the physical memory. Therefore, the following should be added
to the /etc/security/limits.conf file:
* hard memlock unlimited
* soft memlock unlimited

The need for increasing the limits may be indicated by the following error message with Platform MPI:
fluent_mpi.16.0.0: Rank 0:1: MPI_Init: ibv_create_cq() failed
fluent_mpi.16.0.0: Rank 0:1: MPI_Init: Can't initialize RDMA device
fluent_mpi.16.0.0: Rank 0:1: MPI_Init: MPI BUG: Cannot initialize RDMA protocol
libibverbs: Warning: RLIMIT_MEMLOCK is 32768 bytes.
This will severely limit memory registrations

When Fluent is launched by a scheduler (like PBSPro, SGE, etc.), these limits may be reset by the
scheduler. You may check running the “limit” command within and without the scheduler to compare.
Any differences indicate the issue above.

If you use PBSPro, add ulimit -l unlimited directly in the pbs_mom startup script, and let PBS
reload the pbs_mom.

If you use SGE, you must change the startup script /etc/init.d/sgeexecd to include the ulimit
-l unlimited command as shown in the following example:
-- BEGIN --
if [ "$startup" = true ]; then
# execution daemon is started on this host!
echo " starting SGE_execd"
exec 1>/dev/null 2>&1
ulimit -l unlimited
$bin_dir/SGE_execd
else
-- END --

Once this modification is in place, restart SGE to set the correct memory limits on the SGE daemon and
any invoked processes.

Using Mechanical APDL with MPI On some operating systems, the default amount of physical
memory that can be pinned/locked by a user application is set to a low value and must be explicitly
increased. A value recommended by Intel is 90% of the physical memory. Therefore, the following
should be added to the /etc/security/limits.conf file:
* hard memlock unlimited
* soft memlock unlimited

This behavior has been observed on Intel MPI 4.1.3, but might also occur on Platform MPI 9.1.4.2.

Using the Fluent Launcher On Linux systems, you must have the following package (as appropriate
for your platform) installed in order to use the Fluent launcher:

SUSE 11 pr 12: libstdc++33

Using ANSCUSTOM If you use ANSCUSTOM to link your own version of ANSYS Release 2020 R1 on
a SUSE SLES 12.x computer, you may see two unsatisfied externals that are system, not ANSYS files, due
to the linker looking for some system files in a Red Hat directory on a SUSE computer.

Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 13
Platform Details

To work around this problem, run the following as root:

mkdir –p /usr/lib/gcc/x86_64-redhat-linux/3.4.6
ln -sf /usr/lib/gcc/i586-suse-linux/2.95.3/crtbegin.o /usr/lib/gcc/x86_64-redhat-linux/
3.4.6/crtbegin.o
ln -sf /usr/lib/gcc/i586-suse-linux/2.95.3/crtend.o /usr/lib/gcc/x86_64-redhat-linux/
3.4.6/crtend.o

The revision numbers shown in the examples (2.95.3 and 3.4.6) may be different on your system. The
linker will specify where it is trying to find the crtbegin.o and crtend.o files; that location will be
the last part of the above commands. You can use the Linux locate command to find the existing
crtbegin.o and crtend.o files; that location would be the first part of the above commands.

System Libraries On 64-bit Linux (linx64) systems, the ANSYS Release 2020 R1 executable is looking
for system libraries that do not have revision numbers appended to the end of their file names. On
some SUSE systems, the graphics libraries all have revision numbers appended to the end of the library
filenames. In these cases, ANSYS quits because the loader cannot find all of the libraries that it is looking
for. When running ANSYS Release 2020 R1, the loader will inform you that it is unable to locate a spe-
cific library (for example, libXm.so). Using the Linux locate command, find the library (libXm.so
in this example) on your system and add the appropriate symbolic link as seen below.

To overcome this possible problem, run the following as root:

ln -sf /usr/lib64/libGLU.so.1.3.060402 /usr/lib64/libGLU.so
ln -sf /usr/X11R6/lib64/libXm.so.3.0.3 /usr/X11R6/lib64/libXm.so
ln -sf /usr/X11R6/lib64/libXp.so.6.2 /usr/X11R6/lib64/libXp.so
ln -sf /usr/X11R6/lib64/libXt.so.6.0 /usr/X11R6/lib64/libXt.so
ln -sf /usr/X11R6/lib64/libXext.so.6.4 /usr/X11R6/lib64/libXext.so
ln -sf /usr/X11R6/lib64/libXi.so.6.0 /usr/X11R6/lib64/libXi.so
ln -sf /usr/X11R6/lib64/libX11.so.6.2 /usr/X11R6/lib64/libX11.so
ln -sf /usr/X11R6/lib64/libSM.so.6.0 /usr/X11R6/lib64/libSM.so
ln -sf /usr/X11R6/lib64/libICE.so.6.4 /usr/X11R6/lib64/libICE.so
ln -sf /lib64/libgcc_s.so.1 /lib64/libgcc.so

For Linux, you may need the following:

ln -sf /usr/lib64/libXm.so.4.0.0 /usr/lib64/libXm.so.3

The revision numbers appended to the filenames on the left may be different on your system.

Intel Linux
ANSYS was built and tested on Red Hat using the compilers as noted in Table 2.1: Compiler Requirements
for All Linux Versions (p. 15).

For ANSYS Workbench and ANSYS Autodyn, you may need to increase the stack size; we recommend
setting it to 1 GB. Add the following to your configuration file:

For the Bourne (bash) shell:

ulimit -s 1024000

For the C (csh) shell:

limit stacksize 1024000

Other shells may have different settings; refer to your shell documentation for specific details.

Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
14 of ANSYS, Inc. and its subsidiaries and affiliates.
 Select Your Installation

Intel Xeon EM64T

If you are running on Intel's Xeon EM64T system, we recommend that you turn CPU hyperthreading off
(default is on). A system administrator needs to reboot the system and enter the BIOS to turn the hyper-
threading option off.

2.1. Utilizing CPU Hyperthreading Technology with ANSYS CFD Solvers

Hyperthreading technology uses one processor core to run more than one task at a time. ANSYS does
not recommend using hyperthreading technology in conjunction with ANSYS CFD Solvers (Fluent, CFX
and AIM Fluids). We recommend that you turn CPU hyperthreading off (default is on). A system admin-
istrator needs to reboot the system and enter the BIOS to turn the hyperthreading option off.

2.2. Compiler Requirements for Linux Systems

Table 2.1: Compiler Requirements for All Linux Versions

Mechanical APDL, CFX Fluent Compilers* AUTODYN

ANSYS Workbench Compilers* Compilers*
Compilers*
Intel 2019.3.199 Intel 2019.3.199 GCC 6.3.0 (typically Intel
(FORTRAN, C, C++) FORTRAN (for installed as part of the 2019.3.199
and GCC 6.3.0 (for custom solver operating system) (FORTRAN, C,
user programmable modeling using C++) and GCC
features) User Fortran) 6.3.0 (for user
and GCC 6.3.0 programmable
(for custom features)
mesh
import/export
executables)

* Compilers are required only if you will be using User Programmable Features (UPF), User Defined
Functions (UDF), or other customization options.

When installing the GCC 6.3.0 compiler for use with ANSYS Mechanical APDL and Autodyn, see Down-
loading and Installing the GCC Compiler for detailed installation instructions.

Note:

The software compiler versions listed above may not correspond to the latest releases
available from Intel but can be downloaded separately from the respective vendors' customer
sites. If you need to purchase/obtain Intel Fortran, note that you must register on Intel's
customer website with your Intel Fortran license information. Once logged into Intel's cus-
tomer site, you have the option of downloading previous releases.

2.3. Select Your Installation

The next step is to select your installation type. Select the option below that matches your installation.

• Installing ANSYS Products for a Stand-alone Linux System (p. 17)

Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 15
Platform Details

• Installing ANSYS Products and the License Server on Different Linux Machines (p. 29)

Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
16 of ANSYS, Inc. and its subsidiaries and affiliates.
Chapter 3: Installing ANSYS Products for a Stand-alone Linux System
This section explains how to install ANSYS, Inc. products, including ANSYS client licensing, as well as
the ANSYS, Inc. License Manager.

The default installation expects you to be logged in as root. You can install as non-root; however, if you
are not logged in as root, you will not be able to set the /ansys_inc symbolic link and may potentially
experience permission problems. The inability to set the /ansys_inc symbolic link will in no way in-
hibit your ability to run ANSYS, Inc. products; it is provided as a convenience.

If you do not use the /ansys_inc symbolic link, you must install all releases into a common directory
to ensure license manager compatibility and availability among releases and products.

If you did not use the /ansys_inc symbolic link, you must replace all references to /ansys_inc/v201
or <install_dir> with the actual installation path you used.

Before You Begin

We recommend that you have the following information available before you begin this installation:

• An account on the ANSYS customer site. If you do not have an account, you may register at www.an-
sys.com/customercommunity to receive your own account.

• Your license file from ANSYS, Inc., saved to a temporary directory. For more information, see Registering the
License Server (p. 26).

• Open port numbers for both the FLEXlm and ANSYS Licensing Interconnect. Defaults are 1055 and 2325,
respectively. To verify that these port numbers are available, open a command line and enter the following
command:
netstat -a -t

You will see a list of active ports. If 1055 and 2325 are listed, they are already in use and cannot be
used for ANSYS, Inc. licensing. In this case, you will need to specify different port numbers where in-
dicated later in this installation.

• Your local machine's name, to specify as the license server.

You should also verify that you are running on a supported platform. ANSYS, Inc. products support 64-
bit Linux systems running Red Hat (7.4 through 7.6), SUSE Linux Enterprise 12 (SP2 through SP4) and
CentOS-7.4 through 7.6. For current platform information, see the Platform Support section of the ANSYS
Website.

Verify that you have sufficient disk space to download, uncompress, and install the products you will
be installing. Approximate disk space requirements for each product are shown in Disk Space and
Memory Requirements (p. 4).

Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 17
Installing ANSYS Products for a Stand-alone Linux System

If you have any problems with--or questions about--the installation process, log a Service Request on
the ANSYS customer site to have a Systems Support Specialist assist you.

This section is divided into four sets of instructions:

• Product Download Instructions: This set of instructions describes the download and extraction process.

• Product Installation with Client Licensing: This set of instructions describes the product installation, including
the client licensing portion.

• License Manager Installation: This set of instructions describes the license manager installation.

• Post-Installation Procedures for All Products: This is a set of instructions that describes any configuration
steps that may be required for the various products.

Both the product and the license manager will be installed on the same machine. You must complete
both the client licensing portion and the license manager installation in order to run ANSYS, Inc. products.

3.1. Pre-Installation Instructions for Download Installations

Before downloading the installation files, you need to accurately determine your platform type. Versions
that are optimized for different chip sets from the same vendor can have similar names, causing confu-
sion. We strongly recommend that you run the getFLEXid script on each machine first. This script
will output the correct platform name for each machine on which it is run. This script can be obtained
from the ANSYS website, by clicking Support>Licensing>Capture License Server Info.

3.2. Product Download Instructions

To download the installation files from our website, you will need to have a current technical support
agreement.

Depending on the product/platform combination(s) you choose, you may need to download multiple
files.

1. From the ANSYS customer site, www.ansys.com/customercommunity, click Downloads > Current Release.

2. Select your installation operating system (Windows x64 or Linux x64).

3. Select the type of files you wish to download:

• Primary Packages: Individual full packages for the primary ANSYS products.

• ISO Images: ISO images for the DVD installation.

4. Click the appropriate download option.

5. Select your desired download directory and click Save.

6. Repeat this process for each download file.

7. To download Add-On Packages, Tools or Academic Packages, click the + to the right of the appropriate
product group title to display the download options and download as required.

Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
18 of ANSYS, Inc. and its subsidiaries and affiliates.
 Installing from a USB Drive

8. After all downloads have been completed, uncompress each package using standard uncompression
utilities for your specific platform. We strongly recommend that you extract the files into new, temporary
directories.

• Continue with the steps described in Product Installation (p. 21).

3.3. Installing from a USB Drive

Note:

Do not use the mounted directory as your working directory. Do not "cd" or "Change Directory"
to /run/media/<user>/ANSYS201 or /media/ANSYS201 and then run INSTALL as this may
cause unmounting and ejecting issues.

CentOS 7.4 through 7.6

Insert the USB drive into an appropriate USB slot on your computer. Continue with the steps described
in Product Installation (p. 21).

Note:

With some SuSE Linux configurations, the USB auto-mount function may cause the IN-
STALL command to appear as lowercase. Using the lowercase install command may
cause extraneous files to be left behind after the ANSYS product installation. To correct
this lowercase issue, un-mount the USB drive and manually re-mount the drive prior to
installing ANSYS products.

Red Hat Enterprise 7.4 through 7.6 and SUSE Linux Enterprise 12 SP2 through SP4

For these versions, the default auto-mount function permission shows read-only which does not allow
you to install the ANSYS products. To address this issue, manually mount the USB by following the steps
below.

1. In a root shell, run the following command to determine the usb drive location:

df -ht

From the results of the df -ht command, locate the device boot data. The device boot data
should be in a format similar to /dev/xxxx, where xxxx is the USB location. You will use the
device boot data when editing the fstab below.

2. Create a mounting point by running the following command:

mkdir -p/run/media/<username>/ANSYS201

3. Edit the fstab to mount the USB with read/execute permissions.

vi /etc/fstab

Inserting the following line:

/dev/xxxx /run/media/<username>/ANSYS201 auto owner,defaults 0 0

Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 19
Installing ANSYS Products for a Stand-alone Linux System

Replace "xxxx" with USB location from the device boot data.

4. Run the following command to execute the fstab:

mount -a

5. Continue with the steps described in Product Installation (p. 21).

3.4. Mounting the DVD Instructions for DVD Installations (Linux x64 Only)

Note:

Do not use the mounted directory as your working directory. Do not "cd" or "Change Directory"
to /run/media/<user>/ANSYS201 or /media/ANSYS201 and then run INSTALL as this may
cause unmounting and ejecting issues.

If you install ANSYS, Inc. products from the installation media (DVD), you will need to run the installation
procedure using either a locally- or remotely-mounted DVD, depending on your site's system.

Note:

Typically, a Linux system will mount a local DVD for you under /media/ANSYS201 or
/media/<user>/ANSYS201/INSTALL.

Locally-Mounted DVD Procedure

1. Insert the first installation DVD.

2. In a root shell, run the following command to determine the device drive location:

df -ht

3. Continue with the steps described in Product Installation (p. 21).

If the target machine does not have a DVD reader, first follow the steps for locally-mounted DVD, and
then follow the procedure below for remotely-mounted DVDs:

Remotely-Mounted DVD Procedure

1. Add the dvdrom_dir directory to the /etc/exports file on the machine with the DVD device. A
sample /etc/exports entry is:
/dvdrom_dir *(ro)

or
/dvdrom_dir (ro)

2. Run exportfs to export the dvdrom_dir directory:

exportfs –a

Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
20 of ANSYS, Inc. and its subsidiaries and affiliates.
 Product Installation

Check the manual page for 'exports' for the correct syntax, as different Linux versions can have
different syntax.

3. Log on to the machine where you wish to install ANSYS, Inc. products and issue the following commands:
mkdir dvdrom_dir2
mount -t nfs Host:cdrom_dir dvdrom_dir2

where Host is the hostname of the machine where the DVD device is located.

Run man exports for more information.

4. Continue with the steps described in Product Installation (p. 21).

3.5. Product Installation

1. Depending on your media type, start the installation process:

For downloaded installation packages:

After uncompressing your downloaded installation packages (<PRODUCT>_<REVN>_<platform>.zip

& tar), navigate to the directory where you extracted the files. Run ./INSTALL. This file will reside
in the directory where you untarred the downloaded files.

For USB or DVD installations:

Run ./INSTALL which is found in the mounted location of the USB or DVD. You should not use
the mounted directory as your current working directory to run the INSTALL as this may cause
unmounting and ejecting issues.

The installer should be run using the absolute path which may vary depending on your platform
and configuration. Common examples are:

/media/<user>/ANSYS201/INSTALL

/media/ANSYS201/INSTALL

Note:

In order to eject the DVD on RedHat, you may need to use the eject command.
eject /media/ANSYS201

2. The ANSYS, Inc. Installation Launcher appears.

Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 21
Installing ANSYS Products for a Stand-alone Linux System

From the options along the left side of the launcher you can install ANSYS products and the ANSYS
License Manager.

The ANSYS Quick Start Installation Guide, ANSYS Quick Start Licensing Guide, System Requirements
Guide and complete Installation Help Guide can be accessed through the options located along
the bottom of the launcher.

Select the language you want to use from the drop-down menu in the upper right corner. English
is the default.

3. Click the Install ANSYS Products option.

4. The license agreement appears. Read the agreement, and if you agree to the terms and conditions, select
I Agree. Click Next, located on the right side of the screen.

Note:

The question mark icon located in the upper right side of each installation screen displays
an explanation of the functionality available on that screen. The letter "I" icon displays
information about the release version of the installation software.

5. The directory where you wish to install the ANSYS, Inc. products is shown in the Install Directory field.
You can install the products into any directory you wish, but you must have write permissions to the dir-
ectory you choose. The default is /ansys_inc. We recommend using the default directory.

The Symbolic Link option is available only if you are installing as root and is enabled (checked)
by default. If you choose to disable (uncheck) the symbolic link or are installing as a non-root user,
substitute the directory path where you installed the product for all subsequent occurrences of
/ansys_inc in this guide.

Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
22 of ANSYS, Inc. and its subsidiaries and affiliates.
 Product Installation

We strongly recommend that you use the Symbolic Link option. If you do not use this option, you
must install all releases into a common directory to ensure license manager compatibility and
availability among releases and products.

If you have already installed the ANSYS Workbench Framework for Ansoft, you must install any
additional ANSYS, Inc. products into the same directory.

Click Next.

6. If this is a first time installation, you are prompted to enter your license server specification. If you already
have an existing license server specification file, you will not see this window and proceed directly to the
next step.

Enter your ANSYS Licensing Interconnect port number and your ANSYS FlexNet port number. Defaults
are provided and will work in most cases. You may need to check with your IT department to
confirm that the default port numbers are valid or to get different port numbers if necessary.

Specify the hostname for your license server machine(s).

Click Next.

7. All products available in the installation package(s) you downloaded are listed in a tree view. A checkmark
to the left of the product signifies that the product and all related "child" products are enabled for install-
ation while a grey box indicates that some, but not all products are enabled for installation. You can expand
the tree to select any additional products you wish to install.

The installation program attempts to query your license server to pre-select your installation options.
If the query is successful, the following message is displayed:

Your installation options were pre-selected based upon information from your license server.

You can select or deselect any combination of products. ANSYS Workbench is automatically installed
with most ANSYS, Inc. products; there is no individual product selection for ANSYS Workbench.

If you select the ANSYS Geometry Interfaces option, you are presented with additional installation
steps. These steps are completed on the CAD Configuration screens which are displayed when
you click Next. For additional information on completing these steps, see Specifying CAD Config-
urations (p. 24).

You will also see an estimate of the disk space required to install all of the selected components,
and the disk space you have available. The actual amount of disk space required may be less, but
if you choose to run the installation with insufficient disk space available, we strongly recommend
that you review the log files at the end of the installation to verify that all products were installed
correctly. Installation log files are written to the installation directory.

Note:

On a first time installation, if you chose to install any ANSYS Geometry Interfaces, en-
sure that you have also selected at least one ANSYS, Inc. product as part of the in-
stallation. Installing an ANSYS Geometry Interface without an underlying ANSYS,
Inc. product on a first time installation may cause installation errors.

Select the products you want to install and click Next.

Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 23
Installing ANSYS Products for a Stand-alone Linux System

The dates on the licensing files being installed are compared to any that may already exist on your
machine. (This may take a few moments.)

8. A summary screen appears listing your installation selections. Review this list carefully to verify that it is
correct. When you are sure all selections are correct, click Next to begin the installation.

9. The installation progress screen displays a status bar towards the bottom of the installation window. This
status bar tracks the percentage of packages that have been installed on your computer. Depending on
the number of products you have selected, the installation time required could be lengthy. You will not
be able to interrupt the installation process. Please be patient while the installation completes.

Note:

Clicking the View Details Progress Log button opens a second window that displays
the name of each product package as it is uncompressed and installed.

Click Next to continue the installation.

10. The product installation window reappears with a message noting that the installation is complete. A
Launch Survey Upon Exiting option is included here. Clicking Exit while the Launch Survey Upon Ex-
iting is enabled causes your default browser to open, displaying the product survey. Disabling (un-
checking) the Launch Survey Upon Exiting option and then clicking Exit skips the survey.

The ANSYS, Inc. Installation Launcher appears. For this stand-alone installation, you must complete
the License Manager installation (next) to run ANSYS, Inc. products.

3.5.1. Specifying CAD Configurations

Selecting the ANSYS Geometry Interfaces option, from the product selection screen and clicking
Next displays a series of configuration screens for your geometry interfaces.

1. On the first screen, you are asked to select one of the following three configuration options:

• Selecting the Yes, I will make my selections option and clicking Next walks you through
a several configuration steps. If you select this option, you can configure the appropriate
geometry interface properties by following the steps described below.

• Selecting the No. Skip configuration. I will configure later option and clicking Next ig-
nores the geometry interface configuration at this time. After you make this selection, the
installation continues as described in the Product Installation (p. 21) step #8. You can use
this option if you have not yet installed the related CAD programs, or do not know the
requested information. If you skip these steps, you will need to configure these geometry
interfaces using the Product & CAD Configuration Manager before you can successfully
import models into ANSYS products. See Configuring CAD Products (p. 59) for more inform-
ation on using the Product & CAD Configuration Manager.

2. After selecting the Yes, I will make my selections option and clicking Next (bullet point #1 above),
you are presented with a check list of the geometry interfaces. You can choose which geometry in-
terfaces you would like to configure by enabling the appropriate check box(es). Note that the con-
figuration is not performed for any geometry interface check box that is disabled. You will have to
do that at a later time by following the steps in the Configuring CAD Products (p. 59) section.

When you have selected the appropriate interfaces, click Next.

Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
24 of ANSYS, Inc. and its subsidiaries and affiliates.
 Product Installation

3. If you selected the interface for NX, a third screen is displayed. In this case follow the steps below.
If you did not select NX the installation continues as described in the Product Installation (p. 21)
step #8.

NX

If you choose the associative interface and the UGII environment variables were not set, you
will need to specify the NX installation path for an existing NX installation.

4. Once you have completed the NX configuration, click Next. The installation continues as described
in the Product Installation (p. 21) step #8.

3.5.2. ANSYS License Manager Installation

Follow the instructions below to install the ANSYS, Inc. License Manager on your Linux machine. Be-
cause you will not be using a network server, you must install and configure the ANSYS, Inc. License
Manager on your machine. The License Manager controls access to the ANSYS, Inc. products you have
purchased.

1. Navigate to the directory where you extracted the files. Run ./INSTALL -LM. If you downloaded the
license manager installation package, this file will reside in the directory where you untarred the
downloaded files. If you are running from a DVD, this file will reside in the top level of the DVD.

2. You may see a warning stating that if the license manager is currently running, it will be shut down.
This installation assumes that you have not previously installed the products or the licensing on this
machine, and you are not pointing to a network license server machine. You may safely ignore this
message and click OK.

3. Select the language you want to use. English is the default.

4. The license agreement appears. Read the agreement, and if you agree to the terms and conditions, select
I Agree. Click Next, located on the right side of the screen.

5. The directory where you wish to install the ANSYS, Inc. License Manager is shown in the Install Directory
field. You can install the License Manager into any directory you wish, but you must have write permis-
sions to the directory you choose. The default is /ansys_inc. We recommend using the default dir-
ectory. You must use the same directory where the products were installed.

Note:

You are unable to change the installation directory for a computer that currently
contains an instance of the ANSYS, Inc. License Manager or ANSYS Electromagnetics
License Manager. To change the installation directory location, you must first uninstall
any previous versions of both products.

6. The ANSYS, Inc. License Manager is selected as the only product available to install. As with the product
installation, the required and available disk space numbers are shown. Click Next.

7. A summary screen appears that lists the products to be installed. Because this is a license manager in-
stallation, the ANSYS, Inc. License Manager is the only product listed.

Click Next. The license manager installation begins.

Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 25
Installing ANSYS Products for a Stand-alone Linux System

The ANSYS, Inc. License Manager is now being installed and configured on your system. After
the License Manager installation has been completed, the Launch License Management Center
upon exiting option is included on the screen. The ANSYS License Management Center is a
browser-based user interface that centralizes many of the ANSYS product licensing administrative
functions. If you do not wish to launch the License Management Center, clear the Launch License
Management Center upon exiting option.

8. Click Exit to close the License Manager Installation screen.

9. Click Exit to close the ANSYS, Inc. Installation Manager.

10. Open a terminal window and navigate to your ANSYS installation. The following table lists the default
paths to start the ANSYS products you have installed.

Application Locations
Application How to Launch
ACP /ansys_inc/v201/ACP.sh
CFD Post /ansys_inc/v201/cfdpost
CFX /ansys_inc/v201/CFX/bin/<productname>

Where <productname> can be cfx5, cfx5launch, cfx5pre, cfx-

solve, or cfx5post.
FLUENT /ansys_inc/v201/fluent/bin/fluent
ICEM CFD /ansys_inc/v201/icemcfd/icemcfd
ICEPAK /ansys_inc/v201/icepak/icepak
PolyFlow /ansys_inc/v201/polyflow/bin/polyflow
Turbogrid /ansys_inc/v201TurboGrid/bin/cfxtg
Workbench /ansys_inc/v201/Framework/bin/Linux64/runwb2

3.5.2.1. Registering the License Server

If you are a new user who has not received a license file for your server or if you add or change a
license server machine, follow this procedure to register your license server information. See the
ANSYS Licensing Guide for more information on selecting license servers (Selecting License Server
Machines) and on using the ANSYS License Management Center (License Server Administration
Using ANSYS License Management Center).

1. Open the ANSYS License Management Center. To run the ANSYS License Management Center on
Linux run the following script:
/shared_files/licensing/start_lmcenter

2. Click the Get System Hostid Information option to display your system ID code(s).

3. Select the system ID you wish to use and click SAVE TO FILE.

A text file containing your system ID information is created.

4. Forward this text file to your ANSYS sales representative so that a license file can be created for you.

Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
26 of ANSYS, Inc. and its subsidiaries and affiliates.
 Product Installation

5. Add your license files though the ANSYS License Management Center. For these steps, see Adding
a License.

After completing the installation process, refer to Post-Installation Instructions (p. 43).

Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 27
 Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
28 of ANSYS, Inc. and its subsidiaries and affiliates.
Chapter 4: Installing ANSYS Products and the License Server on
Different Linux Machines
This section explains how to install ANSYS, Inc. products, including ANSYS client licensing, as well as
the ANSYS, Inc. License Manager.

This installation process requires you to perform the following steps:

1. Install the ANSYS License Manager on one or more “server” computers. (This step is not necessary if
a license server is already available on your network.) See ANSYS License Manager Installation (p. 37)
for more information.

2. Install the ANSYS Products on one or more “client” computers. (It is not necessary to install the ANSYS
License Manager on the “client” computers.) See Product Installation (p. 33) for more information.

The default installation expects you to be logged in as root. You can install as non-root; however, you
will not be able to set the /ansys_inc symbolic link and may potentially experience permission
problems. The inability to set the /ansys_inc symbolic link will in no way inhibit your ability to run
ANSYS, Inc. products; it is provided as a convenience when navigating to the /ansys_inc directory.

If you do not use the /ansys_inc symbolic link, you must install all releases into a common directory
to ensure license manager compatibility and availability among releases and products.

If you did not use the /ansys_inc symbolic link, you must replace all references to /ansys_inc/v201
or <install_dir> with the actual installation path you used.

Before You Begin

We recommend that you have the following information available before you begin this installation:

• An account on the ANSYS customer site. If you do not have an account, you may register at www.an-
sys.com/customercommunity to receive your own account.

• Your license file from ANSYS, Inc., saved to a temporary directory. For more information, see Registering the
License Server (p. 39).

• Open port numbers for both the FLEXlm and ANSYS Licensing Interconnect. Defaults are 1055 and 2325,
respectively. To verify that these port numbers are available, open a command line and enter the following
command:
netstat -a -t

You will see a list of active ports. If 1055 and 2325 are listed, they are already in use and cannot be
used for ANSYS, Inc. licensing. In this case, you will need to specify different port numbers where in-
dicated later in this installation.

• Your local machine's name, to specify as the license server.

Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 29
Installing ANSYS Products and the License Server on Different Linux Machines

You should also verify that you are running on a supported platform. ANSYS, Inc. products support 64-
bit Linux systems running Red Hat (7.4 through 7.6), SUSE Linux Enterprise 12 (SP2 through SP4) and
CentOS-7.4 and 7.6. For current platform information, see the Platform Support section of the ANSYS
Website.

Verify that you have sufficient disk space to download, uncompress, and install the products you will
be installing. Approximate disk space requirements for each product are shown in Disk Space and
Memory Requirements (p. 4).

If you have any problems with--or questions about--the installation process, log a Service Request on
the ANSYS customer site to have a Systems Support Specialist assist you.

This section is divided into four sets of instructions:

• Product Download Instructions: This set of instructions describes the download and extraction process.

• Product Installation with Client Licensing: This set of instructions describes the product installation, including
the client licensing portion.

• License Manager Installation: This set of instructions describes the license manager installation.

• Post-Installation Procedures for All Products: This is a set of instructions that describes any configuration
steps that may be required for the various products.

For this procedure, the product and the license manager will be installed on separate machines. You
must complete both the client licensing portion and the license manager installation in order to run ANSYS,
Inc. products.

4.1. Pre-Installation Instructions for Download Installations

Before downloading the installation files, you need to accurately determine your platform type. Versions
that are optimized for different chip sets from the same vendor can have similar names, causing confu-
sion. We strongly recommend that you run the getFLEXid script on each machine first. This script
will output the correct platform name for each machine on which it is run. This script can be obtained
from the ANSYS website, in the Licensing Support area under “Capture License Server Info”.

4.2. Product Download Instructions

To download the installation files from our website, you will need to have a current technical support
agreement.

Depending on the product/platform combination(s) you choose, you may need to download multiple
files.

1. From the ANSYS customer site, www.ansys.com/customercommunity, click Downloads > Current Release.

2. Select your installation operating system (Windows x64 or Linux x64).

3. Select the type of files you wish to download:

• Primary Packages: Individual full packages for the primary ANSYS products.

• ISO Images: ISO images for the DVD installation.

Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
30 of ANSYS, Inc. and its subsidiaries and affiliates.
 Installing from a USB Drive

4. Click the appropriate download option.

5. Select your desired download directory and click Save.

6. Repeat this process for each download file.

7. To download Add-On Packages, Tools or Academic Packages, click the + to the right of the appropriate
product group title to display the download options and download as required.

8. After all downloads have been completed, uncompress each package using standard uncompression
utilities for your specific platform. We strongly recommend that you extract the files into new, temporary
directories.

• Continue with the steps described in Product Installation (p. 33).

4.3. Installing from a USB Drive

Note:

Do not use the mounted directory as your working directory. Do not "cd" or "Change Directory"
to /run/media/<user>/ANSYS201 or /media/ANSYS201 and then run INSTALL as this may
cause unmounting and ejecting issues.

CentOS 7.4 through 7.6

Insert the USB drive into an appropriate USB slot on your computer. Navigate to the root directory of
the USB drive and run ./INSTALL. Continue with the steps described in Product Installation (p. 33).

Note:

With some SuSE Linux configurations, the USB auto-mount function may cause the IN-
STALL command to appear as lowercase. Using the lowercase install command may
cause extraneous files to be left behind after the ANSYS product installation. To correct
this lowercase issue, un-mount the USB drive and manually re-mount the drive prior to
installing ANSYS products.

Red Hat Enterprise 7.4 through 7.6 and SUSE Linux Enterprise 12 SP2 through SP4

For these versions, the default auto-mount function permission shows read-only which does not allow
you to install the ANSYS products. To address this issue, manually mount the USB by following the steps
below.

1. In a root shell, run the following command to determine the usb drive location:

df -ht

From the results of the df -ht command, locate the device boot data. The device boot data
should be in a format similar to /dev/xxxx, where xxxx is the USB location. You will use the
device boot data when editing the fstab below.

2. Create a mounting point by running the following command:

Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 31
Installing ANSYS Products and the License Server on Different Linux Machines

mkdir -p/run/media/<username>/ANSYS201

3. Edit the fstab to mount the USB with read/execute permissions.

vi /etc/fstab

Inserting the following line:

/dev/xxxx /run/media/<username>/ANSYS201 auto owner,defaults 0 0

Replace "xxxx" with USB location from the device boot data.

4. Run the following command to execute the fstab:

mount -a

5. Continue with the steps described in Product Installation (p. 21).

4.4. Mounting the DVD Instructions for DVD Installations (Linux x64 Only)

Note:

Do not use the mounted directory as your working directory. Do not "cd" or "Change Directory"
to /run/media/<user>/ANSYS201 or /media/ANSYS201 and then run INSTALL as this may
cause unmounting and ejecting issues.

If you install ANSYS, Inc. products from the installation media (DVD), you will need to run the installation
procedure using either a locally- or remotely-mounted DVD, depending on your site's system.

Note:

Typically, a Linux system will mount a local DVD for you under /media/ANSYS201.

Locally-Mounted DVD Procedure

1. Insert the first installation DVD.

2. In a root shell, run the following command to determine the device drive location:

df -ht

3. Continue with the steps described in Product Installation (p. 21).

If the target machine does not have a DVD reader, first follow the steps for locally-mounted DVD, and
then follow the procedure below for remotely-mounted DVDs:

Remotely-Mounted DVD Procedure

1. Add the dvdrom_dir directory to the /etc/exports file on the machine with the DVD device. A
sample /etc/exports entry is:
/dvdrom_dir *(ro)

or

Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
32 of ANSYS, Inc. and its subsidiaries and affiliates.
 Product Installation

/dvdrom_dir (ro)

2. Run exportfs to export the dvdrom_dir directory:

exportfs –a

Check the manual page for 'exports' for the correct syntax, as different Linux versions can have
different syntax.

3. Log on to the machine where you wish to install ANSYS, Inc. products and issue the following commands:
mkdir dvdrom_dir2
mount -t nfs Host:cdrom_dir dvdrom_dir2

where Host is the hostname of the machine where the DVD device is located.

Run man exports for more information.

4. Continue with the steps described in Product Installation (p. 21).

4.5. Product Installation

1. Depending on your media type, start the installation process:

For downloaded installation packages:

After uncompressing your downloaded installation packages (<PRODUCT>_<REVN>_<platform>.zip

& tar), navigate to the directory where you extracted the files. Run ./INSTALL. This file will reside
in the directory where you untarred the downloaded files.

For USB or DVD installations:

Run ./INSTALL which is found in the mounted location of the USB or DVD. You should not use
the mounted directory as your current working directory to run the INSTALL as this may cause
unmounting and ejecting issues.

The installer should be run using the absolute path which may vary depending on your platform
and configuration. Common examples are:

/media/<user>/ANSYS201/INSTALL

/media/ANSYS201/INSTALL

Note:

In order to eject the DVD on RedHat, you may need to use the eject command.
eject /media/ANSYS201

2. The ANSYS, Inc. Installation Launcher appears.

Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 33
Installing ANSYS Products and the License Server on Different Linux Machines

From the options along the left side of the launcher you can install ANSYS products and the ANSYS
License Manager.

The ANSYS Quick Start Installation Guide, ANSYS Quick Start Licensing Guide, System Requirements
Guide and complete Installation Help Guide can be accessed through the options located along
the bottom of the launcher.

Select the language you want to use from the drop-down menu in the upper right corner. English
is the default.

3. Click the Install ANSYS Products option.

4. The license agreement appears. Read the agreement, and if you agree to the terms and conditions, select
I Agree. Click Next, located on the right side of the screen.

Note:

The question mark icon located in the upper right side of each installation screen displays
an explanation of the functionality available on that screen. The letter "I" icon displays
information about the release version of the installation software.

When installing more than one platform or if you are installing a platform other than your current
machine type, you will need to select the platform(s) on which you want to install the ANSYS, Inc.
products. The platform on which you launched the installation will be selected by default and is
shown at the bottom of the window. You can choose as many platforms as you want; however,
you must run the platform configuration procedure (see Run the Product & CAD Configuration
Manager in Network Installation and Product and CAD Configuration (p. 39)) for each platform
other than your current machine type. See Network Installation and Product and CAD Configura-
tion (p. 39) for specific instructions on how to configure a shared installation directory across
multiple machines using a common network file system.

Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
34 of ANSYS, Inc. and its subsidiaries and affiliates.
 Product Installation

5. The directory where you want to install the ANSYS, Inc. products is shown in the Install Directory field.
You can install the products into any directory you want, but you must have write permissions to the
directory you choose. The default is /ansys_inc. We recommend using the default directory.

The Symbolic Link option is available only if you are installing as root and is enabled (checked)
by default. If you choose to disable (uncheck) the symbolic link or are installing as a non-root user,
substitute the directory path where you installed the product for all subsequent occurrences of
/ansys_inc in this guide.

We strongly recommend that you use the Symbolic Link option. If you do not use this option, you
must install all releases into a common directory to ensure license manager compatibility and
availability among releases and products.

If you have already installed the ANSYS Workbench Framework for Ansoft, you must install any
additional ANSYS, Inc. products into the same directory.

Click Next.

6. If this is a first time installation, you are prompted to enter your license server specification. If you already
have an existing license server specification file, you will not see this window and proceed directly to the
next step.

Enter your ANSYS Licensing Interconnect port number and your ANSYS FlexNet port number. Defaults
are provided and will work in most cases. You may need to check with your IT department to
confirm that the default port numbers are valid or to get different port numbers if necessary.

Specify the hostname for your license server machine(s).

Click Next.

7. All products available in the installation package(s) you downloaded are listed in a tree view. A checkmark
to the left of the product signifies that the product and all related "child" products are enabled for install-
ation while a grey box indicates that some, but not all products are enabled for installation. You can expand
the tree to select any additional products you wish to install.

The installation program attempts to query your license server to pre-select your installation options.
If the query is successful, the following message is displayed:

Your installation options were pre-selected based upon information from your license server.

You can select or deselect any combination of products. ANSYS Workbench is automatically installed
with most ANSYS, Inc. products; there is no individual product selection for ANSYS Workbench.

If you select the ANSYS Geometry Interfaces option, you are presented with additional installation
steps. These steps are completed on the CAD Configuration screens which are displayed when
you click Next. For additional information on completing these steps, see Specifying CAD Config-
urations (p. 36).

You will also see an estimate of the disk space required to install all of the selected components,
and the disk space you have available. The actual amount of disk space required may be less, but
if you choose to run the installation with insufficient disk space available, we strongly recommend

Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 35
Installing ANSYS Products and the License Server on Different Linux Machines

that you review the log files at the end of the installation to verify that all products were installed
correctly. Installation log files are written to the installation directory.

Note:

On a first time installation, if you chose to install any ANSYS Geometry Interfaces, en-
sure that you have also selected at least one ANSYS, Inc. product as part of the in-
stallation. Installing an ANSYS Geometry Interface without an underlying ANSYS,
Inc. product on a first time installation may cause installation errors.

Select the products you want to install and click Next. The dates on the licensing files being installed
are compared to any that may already exist on your machine. (This may take a few moments.)

8. A summary screen appears listing your installation selections. Review this list carefully to verify that it is
correct. When you are sure all selections are correct, click Next to begin the installation.

9. The installation progress screen displays a status bar towards the bottom of the installation window. This
status bar tracks the percentage of packages that have been installed on your computer. Depending on
the number of products you have selected, the installation time required could be lengthy. You will not
be able to interrupt the installation process. Please be patient while the installation completes.

Note:

Clicking the View Details Progress Log button opens a second window that displays
the name of each product package as it is uncompressed and installed.

Click Next to continue the installation.

10. The product installation window reappears with a message noting that the installation is complete. A
Launch Survey Upon Exiting option is included here. Clicking Exit while the Launch Survey Upon Ex-
iting is enabled causes your default browser to open, displaying the product survey. Disabling (un-
checking) the Launch Survey Upon Exiting option and then clicking Exit skips the survey.

11. If you have installed ANSYS, Inc. products on a file server, follow the instructions under Network Installation
and Product and CAD Configuration (p. 39).

4.5.1. Specifying CAD Configurations

Selecting the ANSYS Geometry Interfaces option, from the product selection screen and clicking
Next displays a series of configuration screens for your geometry interfaces.

1. On the first screen, you are asked to select one of the following three configuration options:

• Selecting the Yes, I will make my selections option and clicking Next walks you through
a several configuration steps. If you select this option, you can configure the appropriate
geometry interface properties by following the steps described below.

• Selecting the No. Skip configuration. I will configure later option and clicking Next ig-
nores the geometry interface configuration at this time. After you make this selection, the
installation continues as described in the Product Installation (p. 21) step #8. You can use
this option if you have not yet installed the related CAD programs, or do not know the
requested information. If you skip these steps, you will need to configure these geometry

Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
36 of ANSYS, Inc. and its subsidiaries and affiliates.
 Product Installation

interfaces using the Product & CAD Configuration Manager before you can successfully
import models into ANSYS products. See Configuring CAD Products (p. 59) for more inform-
ation on using the Product & CAD Configuration Manager.

2. After selecting the Yes, I will make my selections option and clicking Next (bullet point #1 above),
you are presented with a check list of the geometry interfaces. You can choose which geometry in-
terfaces you would like to configure by enabling the appropriate check box(es). Note that the con-
figuration is not performed for any geometry interface check box that is disabled. You will have to
do that at a later time by following the steps in the Configuring CAD Products (p. 59) section.

When you have selected the appropriate interfaces, click Next.

3. If you selected the interface for NX, a third screen is displayed. In this case follow the steps below.
If you did not select NX the installation continues as described in the Product Installation (p. 21)
step #8.

NX

If you choose the associative interface and the UGII environment variables were not set, you
will need to specify the NX installation path for an existing NX installation.

4. Once you have completed the NX configuration, click Next. The installation continues as described
in the Product Installation (p. 21) step #8.

4.5.2. ANSYS License Manager Installation

After you have installed the ANSYS products on your client machines, follow the instructions below
to install the ANSYS, Inc. License Manager on your license server machine. The License Manager
controls access to the ANSYS, Inc. products you have purchased.

Note:

It is not necessary to install the ANSYS License Manager on the client computers.

1. Navigate to the directory where you extracted the files. Run ./INSTALL -LM. If you downloaded the
license manager installation package, this file will reside in the directory where you untarred the
downloaded files. If you are running from a DVD, this file will reside in the top level of the DVD.

2. You may see a warning stating that if the license manager is currently running, it will be shut down. If
you have not previously installed the products or the licensing on this machine, and you are not
pointing to a network license server machine, you may safely ignore this message and click OK.

3. Select the language you want to use. English is the default.

4. The license agreement appears. Read the agreement, and if you agree to the terms and conditions, select
I Agree. Click Next, located on the right side of the screen.

5. The directory where you want to install the ANSYS, Inc. License Manager is shown in the Install Directory
field. You can install the License Manager into any directory you want, but you must have write permis-

Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 37
Installing ANSYS Products and the License Server on Different Linux Machines

sions to the directory you choose. The default is /ansys_inc. We recommend using the default dir-
ectory. You must use the same directory where the products were installed.

Note:

You are unable to change the installation directory for a computer that currently
contains an instance of the ANSYS, Inc. License Manager or ANSYS Electromagnetics
License Manager. To change the installation directory location, you must first uninstall
any previous versions of both products.

6. The ANSYS, Inc. License Manager is selected as the only product available to install. As with the product
installation, the required and available disk space numbers are shown. Click Next.

7. A summary screen appears that lists the products to be installed. Because this is a license manager in-
stallation, the ANSYS, Inc. License Manager is the only product listed.

Click Next. The license manager installation begins.

The ANSYS, Inc. License Manager is now being installed and configured on your system. After
the License Manager installation has been completed, the Launch License Management Center
upon exiting option is included on the screen. The ANSYS License Management Center is a
browser-based user interface that centralizes many of the ANSYS product licensing administrative
functions. If you do not want to launch the License Management Center, clear the Launch License
Management Center upon exiting option.

8. Click Exit to close the License Manager Installation screen.

9. Click Exit to close the ANSYS, Inc. Installation Manager.

10. Open a terminal window and navigate to your ANSYS installation. The following table lists the default
paths to start the ANSYS products you have installed.

Application Locations
Application How to Launch
ACP /ansys_inc/v201/ACP.sh
CFD Post /ansys_inc/v201/cfdpost
CFX /ansys_inc/v201/CFX/bin/<productname>

Where <productname> can be cfx5, cfx5launch, cfx5pre, cfx-

solve, or cfx5post.
FLUENT /ansys_inc/v201/fluent/bin/fluent
ICEM CFD /ansys_inc/v201/icemcfd/icemcfd
ICEPAK /ansys_inc/v201/icepak/icepak
PolyFlow /ansys_inc/v201/polyflow/bin/polyflow
Turbogrid /ansys_inc/v201TurboGrid/bin/cfxtg
Workbench /ansys_inc/v201/Framework/bin/Linux64/runwb2

Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
38 of ANSYS, Inc. and its subsidiaries and affiliates.
 Product Installation

4.5.2.1. Registering the License Server

If you are a new user who has not received a license file for your server or if you add or change a
license server machine, follow this procedure to register your license server information. See the
ANSYS Licensing Guide for more information on selecting license servers (Selecting License Server
Machines) and on using the ANSYS License Management Center (License Server Administration
Using ANSYS License Management Center).

1. Open the ANSYS License Management Center. To run the ANSYS License Management Center on
Linux run the following script:
/shared_files/licensing/start_lmcenter

2. Click the Get System Hostid Information option to display your system ID code(s).

3. Select the system ID you wish to use and click SAVE TO FILE.

A text file containing your system ID information is created.

4. Forward this text file to your ANSYS sales representative so that a license file can be created for you.

5. Add your license files though the ANSYS License Management Center. For these steps, see Adding
a License.

4.5.3. Network Installation and Product and CAD Configuration

To complete a network installation (where the product is installed on one machine and one or more
clients access that installation to run the product) to a file server machine, follow the steps below.
These steps apply to the following products: Mechanical APDL, ANSYS Workbench, ANSYS CFX, ANSYS
ICEM CFD, ANSYS Fluent, ANSYS Polyflow, ANSYS Icepak, NX, and Remote Solve Manager (RSM).

A network installation must be homogeneous, although you can install on different operating systems.

You must complete the following steps to run products across a network:
4.5.3.1. Export the /ansys_inc Directory
4.5.3.2. Run the Product & CAD Configuration Manager on All Client Machines

We strongly recommend that these steps be performed by the same non-root user. Installing and
configuring as different users may create permissions problems. Likewise, installing and/or configuring
as a root user may also result in permissions problems.

4.5.3.1. Export the /ansys_inc Directory

If you are installing an ANSYS, Inc. product on a file server, you need to export the /ansys_inc
directory to all client machines so that all users can access the program. You will also need to share
the ANSYS directory if the machine you are installing on does not have a DVD/USB drive or an in-
ternet connection for downloading files and you need to share files with a machine that does have
a DVD/USB drive or internet connection.

The instructions below assume ANSYS, Inc. products were installed in the specified directory.

1. Install the ANSYS, Inc. products. The following example uses /usr/ansys_inc.

Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 39
Installing ANSYS Products and the License Server on Different Linux Machines

2. Export the ansys_inc directory by adding the following line to the /etc/exports file:
/usr/ansys_inc

The default behavior on Linux provides read-only access from all clients. To enable read/write
permission from all clients, use *(rw):
/usr/ansys_inc *(rw)

Alternatively, if the installing user is root, use:

/usr/ansys_inc *(rw,no_root_squash)

3. Run
exportfs -a

4. On all client computers, mount the ansys_inc directory.

If you perform a network install where you want the clients to be able to modify the licensing
configuration, you need to consider the NFS write options for the exported file system as shown
in the above examples. You also need local permissions to the licensing directory
(/shared_files/licensing/) if you want to be able to create the install_licconfig.log
that the license configuration produces.

If you need to transfer the files from a Windows machine with a DVD drive to a Linux machine
without one, copy the DVD contents using a Samba mount or some other transfer method that is
safe to use between Windows and Linux.

If sharing the ANSYS directory between Linux machines, you must use the same mount point for
both the client and server. For example, if you installed to a file server in a directory named
/apps/ansys_inc and you did not choose the symbolic link to /ansys_inc, then you must
mount this directory on the client machine using /apps/ansys_inc as the mount point. If you
did choose the symbolic link to /ansys_inc during installation on the file server, you must either
use /ansys_inc as the mount point on the client or you must create a symbolic link to /an-
sys_inc on the client machine. (The symbolic link is created by default during installation if you
installed as root).

4.5.3.2. Run the Product & CAD Configuration Manager on All Client Machines
For network installations, you must run this step on every client machine.

Note:

The username and user ID utilized when running the Product & CAD Configuration
Manager must be the same as the installing server user.

1. On each client machine, issue the following command to run the Product & CAD Configuration
Manager:
/ansys_inc/v201/ProductConfig.sh

2. Select Configure Products & CAD.

Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
40 of ANSYS, Inc. and its subsidiaries and affiliates.
 Product Installation

3. Select the products you want to configure and click Next.

Note:

ANSYS Workbench is configured when Mechanical APDL, ANSYS CFX, ANSYS Fluent,
ANSYS Polyflow, or Remote Solve Manager Standalone Services is selected. CFD-
Post is configured when either ANSYS CFX, ANSYS Fluent, ANSYS Polyflow or ANSYS
Icepak is configured.

4. When the configuration is complete, click Exit.

After completing the installation process, refer to Post-Installation Instructions (p. 43).

Important:

If you use network installation and wish to disable the ANSYS Product Improvement
Program (APIP) for all clients from a central location, perform the following steps on the
file server:

1. Navigate to the installation directory: [Drive:]\v201\commonfiles\global-

settings

2. Open the file ANSYSProductImprovementProgram.txt.

3. Change the value from "on" to "off" and save the file.

Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 41
 Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
42 of ANSYS, Inc. and its subsidiaries and affiliates.
Chapter 5: Post-Installation Instructions
The following post-installation procedures apply to all ANSYS, Inc. products. Individual products may
have additional post-installation procedures; refer to the following sections for each product.
5.1. Post-Installation Procedures for Mechanical APDL and ANSYS Workbench Products
5.2. Product Localization
5.3. Launching ANSYS, Inc. Products

Note:

If the installation program reported any errors, review the installation error file (install.err)
located in the ANSYS Inc directory. Contact your ANSYS Support representative if you have
any questions.

After the product is installed, you need to establish some system settings, including path names and
environment variables. See your shell documentation or man pages file for the shell being used for
specific instructions on setting paths and environment variables.

1. Add the following paths to all users' login startup files (i.e., .cshrc, .profile, or .login files).

/ansys_inc/v201/ansys/bin (or appropriate path to the

individual products'
executables)
/ansys_inc/shared_files/licensing/lic_admin (contains ANSLIC_ADMIN
utility)

2. Set the following environment variables based on the behavior you want. Set the environment variables
following the conventions of your shell. For example, to set an environment variable in the C shell, type:
setenv environment_variable value

For example, to set the DISPLAY environment variable, you type the following, where dev is the
workstation hostname or IP address on which to display graphics:
setenv DISPLAY dev:0.0

DISPLAY - set this to the IP address or hostname of the workstation to which the users will
output their analysis results. Note that the X server must have permission to connect to the
host machine.

If you will be using connection functionality, you may have additional environment variables to
set. See the section Configuring CAD Products (p. 59) later in this guide for more information.

3. Set the license manager to start automatically at boot time. For platform-specific instructions, see License
Manager Automatic Startup Instructions in the ANSYS Licensing Guide.

Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 43
Post-Installation Instructions

4. Designate server(s) for license checkout and establish necessary user privileges (recommended but not
required). For information on these tasks, see Post-Installation Instructions in the ANSYS Licensing Guide.

5. Make a backup copy of the /ansys_inc directory using a tape backup command such as tar.

6. Verify the installation by logging out as root (if you installed as root) and logging back in as a regular user
and then starting the product to verify that it starts and runs correctly.

Quality Assurance Services: If you require verification of Mechanical APDL, the Mechanical Application,
Fluent, or CFX, ANSYS, Inc. offers Quality Assurance services. If you are interested in this service, go to
the Quality Assurance Services site on the ANSYS customer site or call the ANSYS, Inc. Corporate Quality
Group at (724) 746-3304.

5.1. Post-Installation Procedures for Mechanical APDL and ANSYS

Workbench Products
The following post-installation procedures apply only to the Mechanical APDL and ANSYS Workbench
products. These are in addition to the post-installation procedures in the previous section.

1. Set the following environment variables based on the behavior you want. Set the environment variables
following the conventions of your shell. Not all of these are required for all integrated ANSYS Workbench
products (such as ANSYS Autodyn), but setting them correctly for ANSYS Workbench will in no way hinder
the performance of the other products.

The ANSYS201_DIR environment variable sets the location of the ANSYS directory hierarchy.
The default value is /ansys_inc/v201/ansys. You probably will not need to reset this
variable, unless you change the location of the installed files.
The ANSYSLIC_DIR environment variable sets the location of the ANSYS licensing directory
hierarchy. The default value is /ansys_inc/shared_files/licensing. You probably
will not need to reset this variable, unless you change the location of the licensing files.
ANSYS201_PRODUCT - set this to the correct product variable to run Mechanical APDL to
start with the correct product without specifying the -p command modifier each time. See the
ANSYS Product to License Feature Mapping table located on Installation and Licensing
Help and Tutorials page of the ANSYS Customer Portal for a list of valid product variables.
ANSYS_LOCK - set to ON (default) to create file locks to prevent users from opening a new
job with the same name and in the same directory as the current job.
ANSYS201_WORKING_DIRECTORY - set this variable to the directory you want designated as
your working directory. The working directory setting in the launcher will reflect this setting.
ANSYS201_MAT161 - set this environment variable to 1 to enable use of the LS-DYNA
*MAT_COMPOSITE_MSC material (requires an LS-DYNA MAT_161 license).
ANSYS201_MAT162 - set this environment variable to 1 to enable use of the LS-DYNA
*MAT_COMPOSITE_DMG_MSG material (requires an LS-DYNA MAT_162 license).
ANSBROWSER - set this environment variable to the browser on your system (specify the full
path) if the automatic browser detection fails. A browser is needed to view HTML reports and
help for the ANS_ADMIN utility and the Mechanical APDL launcher. By default, ANSBROWSER
points to one of several Linux browsers, based on the browser specified in your path (if any).

If you will be using connection functionality, you may have additional environment variables to
set. See the section Configuring CAD Products (p. 59) later in this guide for more information.

Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
44 of ANSYS, Inc. and its subsidiaries and affiliates.
 Post-Installation Procedures for Mechanical APDL and ANSYS Workbench Products

2. Create or update the at. files. The at.allow file should contain the username of all users allowed to
run batch jobs; the at.deny file should contain the username of users who are not permitted to run
batch jobs. The files consist of one username per line and can be modified only by the superuser. If neither
file exists, only root will be able to run batch jobs.

The at. files are located in the /etc directory on Linux machines.

3. Specify the product order as it will appear in the Mechanical APDL launcher (optional). If you want to
specify product order, use the ANSLIC_ADMIN utility. See the ANSYS Licensing Guide for more information.

Explicit Dynamics, Rigid Dynamics, My Computer Background, and Remote Solve Manager (RSM)
Users: If you are running ANSYS Workbench on a multi-user RSM machine, the ‘My Computer, Back-
ground’ Solve Process Settings will likely not function as expected due to write permissions for RSM
working directories. In this situation, we strongly recommend that you set up RSM as a daemon. For
more information see Starting the RSM Launcher Service Automatically at Boot Time for Linux in the
Remote Solve Manager User's Guide.

This issue also affects Rigid Dynamics and Explicit Dynamics using both ‘My Computer’ and ‘My Computer,
Background’ Solve Process Settings.

5.1.1. Post-Installation Procedures for ANSYS CFX

The following post-installation procedures apply only to the ANSYS CFX product.

The Linux installation of ANSYS CFX or ANSYS TurboGrid automatically installs the Sun Java 2 Runtime
Environment in the /ansys_inc/v201/commonfiles/jre directory. Regardless of whether you
have modified your setup files, you can still run ANSYS CFX commands by specifying the full pathname
of the commands you want to run. This procedure may be useful if you have several releases of ANSYS
CFX installed and you want to run more than one release.

Unless you want to run ANSYS CFX commands by typing their full path names, for example cfx-
root/bin/cfx5 (where cfxroot is the directory in which ANSYS CFX is installed), your command
search paths must be modified to search the directory cfxroot/bin. This can be done by one of
the following methods:

Modification of individual user setup files You can select Tools> Configure User Startup Files
from the ANSYS CFX Launcher to modify your own setup files: .login for the C shell, .profile
for the Bourne and Korn shells. The utility can also be run from the command line by entering:
cfxroot/bin/cfx5setupuser

If this modification is done, the ANSYS CFX software will be available every time you log in, just by
running the ANSYS CFX commands by name. This method has the advantage that it need not be
done by the system administrator, but has the disadvantage that it must be done by each user.

Use the -h option to view the optional commands.

If you choose to modify your setup files, you will see a message indicating that your setup files have
been changed. You will then need to log out and log in again or source your setup files before you
can use the software.

Manual execution of a setup script each time the software is used You can also use the Tools
menu of the launcher to launch an editor to create new setup scripts which need to be run each time
you want to use the ANSYS CFX software. This method has the advantage of not requiring changes

Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 45
Post-Installation Instructions

to existing setup files and allows you to use different versions of ANSYS CFX software by running
different setup files. The disadvantages are that all users must create their own setup files and run
them manually in every session in which they want to run ANSYS CFX software.

Having created the setup files, users of the C shell then need to do the following to run ANSYS CFX:
source ~/cfx5.login
cfx5

Having created the setup files, users of the Bourne or Korn shell then need to do the following before
running ANSYS CFX:
.$HOME/cfx5.profile
cfx5

Modification of system setup files The system administrator modifies the setup files (normally
/etc/profile), which are run by all users during login, to include the directory cfxroot/bin
in the command search path. While this has the advantage of only one file needing to be modified
in order to allow all users to use the software, it also:

• Affects users regardless of whether they use ANSYS CFX

• Can only be done by the root user

• Is system dependent

Refer to your system documentation for information about which files to change for your workstations.

5.1.1.1. Setting up ANSYS TurboGrid Release 2020 R1

Manual modification of individual user setup files To start ANSYS TurboGrid without using
full pathnames every time you want to run the ANSYS TurboGrid software, your path must be
altered to include the ANSYS TurboGrid directory. This can be done by adding the following line
to the .login and .cshrc files in your home directory:
set path=(cfxroot/bin $path)

and these lines to the .profile file in your home directory, and also the .bash_profile if it
exists:
PATH=cfxroot/bin:$PATH
export PATH

and these lines to the .dtprofile file in your home directory:

PATH=cfxroot/bin:$PATH \
export PATH

With the path altered in this way, you can start ANSYS TurboGrid in the current working directory
by typing cfxtg.

Modification of system setup files The system administrator modifies the setup files ( normally
etc/profile), which are run by all users during login, to include the directory cfxroot/bin
in the command search path. While this method has the advantage that only one file must be
modified to allow all users to use the software, it:

Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
46 of ANSYS, Inc. and its subsidiaries and affiliates.
 Post-Installation Procedures for Mechanical APDL and ANSYS Workbench Products

• Affects users regardless of whether they use ANSYS TurboGrid

• Can only be done by the root user

• Is system dependent

Refer to your system documentation for information about which files to change for your worksta-
tions.

5.1.1.2. Using the ANSYS CFX Launcher to Set Up Users

To create setup files to be merged or run manually, start the ANSYS CFX Launcher using the com-
mand:
cfxroot/bin/cfx5

and select Tools> Configure User Startup Files. This option runs cfxroot/bin/cfx5setupuser
that modifies your setup files or writes the necessary commands to files, which you can merge
manually with your existing setup files.

If you choose to modify your setup files, you will see a message indicating that your setup files
have been changed. You will then need to log out and log in again or source your setup files before
you can use the software.

User setup can also be run from the command line by entering:
cfxroot/bin/cfx5setupuser

Enter the flag -h to view the optional commands.

5.1.2. Post-Installation Procedures for ANSYS Fluent

To start ANSYS Fluent without using full pathnames every time you want to run the Fluent software,
your path must be altered to include the ANSYS Fluent bin directory. You can do this in the C shell
and its derivatives by entering:
set path = (/ansys_inc/v201/fluent/bin $path)

or in the Bourne/Korn shell or bash, by entering:

PATH=(/ansys_inc/v201/fluent/bin $path)
export PATH

We recommend adding these statements to your $HOME/.cshrc (C shell), $HOME/.profile

(Bourne/Korn shell), or $HOME/.bashrc (bash shell) file for regular use.

After installing the ANSYS Fluent software, you will need to reset the default values in the ANSYS
Fluent launcher as follows:

1. Verify that the FLUENT_INC environment variable is not set.

Remove the FLUENT_INC setting from your .cshrc, .profile, or .bashrc file if you have
added it for previous versions. Verify that the environment variable is unset by typing:
printenv FLUENT_INC

Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 47
Post-Installation Instructions

This command should not return anything.

2. Add the following paths to all users' login startup files:

<install_dir>/ansys_inc/v201/fluent/bin

3. Run the following command:

<install_dir>/ansys_inc/v201/fluent/bin/fluent

4. Click Default.

5. Click Yes when asked if you want to discard the LAUNCHER history.

6. Click Cancel if you do not want to start Fluent at this time. The new defaults will have been saved.

Refer to the ANSYS Fluent Quick Start Guide for more information.

5.1.3. Post-Installation Procedures for ANSYS Polyflow

Polyflow no longer requires the FLUENT_INC environmental variable. It should be deleted as is re-
commended for Fluent:

• Remove the FLUENT_INC setting from your .cshrc, .profile, or .bashrc file if you have added
it for previous versions. Verify that the environment variable is unset by typing:
printenv FLUENT_INC

This command should not return anything.

5.1.4. Post-Installation Procedures for ANSYS ICEM CFD

The following post-installation procedures apply only to the ANSYS ICEM CFD product.

1. Add the following paths to all users' login startup files (i.e., .cshrc or .login files).

/ansys_inc/v201/icemcfd/linux64_amd/bin

2. Add the following environment variable to all users' login startup files.

ICEM_ACN - set to /ansys_inc/v201/icemcfd/linux64_amd

3. Start ANSYS ICEM CFD by typing icemcfd.

5.1.5. Post-Installation Procedures for ANSYS Autodyn

The following post-installation procedures apply only to the AUTODYN product.

Add the following paths to all users' login startup files (i.e., .cshrc or .login files).
/ansys_inc/v201/autodyn/bin

Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
48 of ANSYS, Inc. and its subsidiaries and affiliates.
 Post-Installation Procedures for Mechanical APDL and ANSYS Workbench Products

5.1.6. Post-Installation Procedures for ANSYS FENSAP-ICE

Software Launch
To launch FENSAP-ICE, execute:

<install_dir>/ansys_inc/v201/fensapice/bin/fensapiceGUI

Command Line Tools

To use ANSYS FENSAP-ICE command line tools without using full pathnames, you will want to run
FENSAP-ICE with your path altered to include the fensapice/bin directory. You can do this in the C
shell and its derivatives by entering:

setenv PATH <install_dir>/ansys_inc/v201/fensapice/bin/:$PATH

or in the Bourne/Korn shell or bash, by entering:

export PATH=<install_dir>/ansys_inc/v201/fensapice/bin/:$PATH

We recommend adding these statements to your $HOME/.cshrc (C shell), $HOME/.profile (Bourne/Korn

shell), or $HOME/.bashrc (bash shell) file for regular use.

To run fensapiceGUI or nti_3dview from the $PATH, without a leading access path, the environment
must define the location of the installation directory. This is done by setting the NTI_PATH variable
to the proper <install_dir>/ansys_inc/v201/fensapice/bin/ directory.

Launching ANSYS FENSAP-ICE with a Wrapper Script

For convenience, a wrapper script can be set-up by the system administrator in order to quickly launch
FENSAP-ICE along with any required environment variables. For example, a fensapiceR18.sh file could
contain:

#!/bin/bash

export ANSYS_LIC_DIR=<install_dir>/ansys_inc/shared_files/licensing/

<install_dir>/ansys_inc/v201/fensapice/bin/fensapiceGUI $*

The script then requires to be set in the $PATH and have execution permissions set (chmod a+rx).

Workbench Extension
Some features of FENSAP-ICE are available in Workbench through the use of an extension. The plug-
in is provided in the following directory:

<install_dir>/ansys_inc/v180/fensapice/workbench/FENSAPICE-WB R20.1.wbex

While in ANSYS Workbench, install the plug-in using the Extensions > Install Extension menu. You
can then set it to load automatically at startup in the Extensions > Manage Extensions menu.

See Getting Started with FENSAP-ICE in Workbench for further details on running FENSAP-ICE in
Workbench.

Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 49
Post-Installation Instructions

ANSYS Licensing
The ANSYS Licensing System is used by default. No special configuration is required if the ANSYS Li-
cense contains a feature enabling FENSAP-ICE and the ANSYS R2020 R1 package is installed.

ANSYS License Server Information will be recognized from the environment variables set on the system.
See the Client Environment Variable Settings section of the ANSYS Licesing Guide for more information.

If the NTI_LICENSE_FILE environment variable has been set, FENSAP-ICE will instead use legacy NTI
FLEXLm licensing. To force the use of ANSYS Licensing and ignore the NTI_LICENSE_FILE option, set
an environment variable as ANSYS_LICENSE_FILE_ONLY=1

NTI Licensing
Legacy license keys from prior to ANSYS R2020 R1 use the NTI FLEXLm license system. The option for
NTI licensing must then be enabled in the licensing.txt file <install_dir>/ansys_inc/v201/fensapice/con-
fig/licensing.txt or by setting up the NTI_LICENSE_FILE environment variable.

Modify the licensing.txt file to contain the license server information NTI_LICENSE_FILE=port@server.

The default port is 27000.

For instructions on how to set-up the NTI license server or on how to force a specific licensing system,
refer to the FENSAP-ICE Installation and Licensing Guide.

5.1.7. Post-Installation Procedures for Other Products

BladeEditor In order to use BladeEditor, you must set the Geometry license preference to ANSYS
BladeModeler as follows:

1. In the ANSYS Workbench menu, select Tools> License Preferences.

2. In the License Preferences dialog box, click the Geometry tab.

3. If ANSYS BladeModeler is not the first license listed, then select it and click Move up as required to
move it to the top of the list. If ANSYS BladeModeler is not in the list, then you need to obtain an
ANSYS BladeModeler license.

4. Select ANSYS DesignModeler in the list and set its value to 0 (which means “Don't Use”). This step prevents
DesignModeler from using an ANSYS DesignModeler license when an ANSYS BladeModeler license is
not available.

5. Click OK to close the dialog box.

You can inadvertently destroy your BladeEditor models by updating a project or otherwise processing
a Geometry cell, depending on your license preference settings. This problem can affect you if you
have any ANSYS DesignModeler licenses. To avoid this problem, configure the license preferences as
described above. For more details, see Configuring the BladeModeler License in the ANSYS BladeEd-
itor documentation.

ACP When running ACP on Red Hat Enterprise Linux 7, the libpng12 and compat-libtiff3 libraries
are required to be installed. You can install these by issuing the following commands with superuser
privileges:

Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
50 of ANSYS, Inc. and its subsidiaries and affiliates.
 Product Localization

yum install libpng12

yum install compat-libtiff3

5.2. Product Localization

Some ANSYS, Inc. products are available in multiple languages, including English, German, and French.
For those products that are localized, you are able to view the GUI and messages in the specified lan-
guage. See your specific product documentation for instructions on choosing a localized version of the
product.

Note:

To view Localization Support Requirements for the current release of ANSYS products, see
ANSYS customer site> Knowledge Resources> Online Documentation> Documentation
Information.

All products that are localized define the language via the languagesettings.txt file. In most
cases, you will not have to manually edit this file. If you do need to edit it manually, you can use one
of the following values:

en-us (English, default)

de (German)
fr (French)

ANSYS, Inc. applications will look for the languagesettings.txt file in the following locations, in
order:

1. $Home/.ansys/v201

2. <install_dir>/ansys_inc/v201/commonfiles/language

ANSYS, Inc. licensing also looks for the languagesettings.txt in the licensing languages subdir-
ectories in order to display the ANSLIC_ADMIN utility and the ANSYS, Inc. Licensing Interconnect
message and log files in a different language.

Some products are not fully localized but offer only the messages in a translated version. See the fol-
lowing section for instructions on translated message file installation.

5.2.1. Translated Message File Installation for Mechanical APDL

If your ANSYS sales representative has supplied you with message files in your local language, use
the following procedures to install and access these files. You must create new message files for each
release because error messages may occur in a different order for each release.

1. Create a language-named subdirectory (for example, fr for French) under the /docu directory:
mkdir /ansys_inc/v201/ansys/docu/fr

2. Copy the message files msgcat.201, msgidx.201, and msgfnm.201 into that subdirectory.

Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 51
Post-Installation Instructions

3. Access these files from the Language Selection option of the launcher or via the -l command line option:
ansys201 -l fr

5.3. Launching ANSYS, Inc. Products

To launch ANSYS, Inc. products on Linux platforms, issue the appropriate command from the list below.
The paths specified assume that you installed the product using the symbolic link to /ansys_inc. If you
did not, substitute your installation path for the path given below.

Table 5.1: Startup Commands

Product Command Notes

Mechanical /ansys_inc/v201/ansys/bin/an- For a complete list of command line
APDL sys201 options, see Starting an ANSYS
Session from the Command Level in
the Operations Guide.
ANSYS /ansys_inc/v201/Frame-
Workbench work/bin/<platform>/runwb2
ANSYS CFX /ansys_inc/v201/CFX/bin/cfx5
ANSYS Fluent /ansys_inc/v201/fluent/bin/fluent For a complete list of command line
and launcher options, see Starting
ANSYS Fluent in the Fluent Users Guide.
ANSYS ICEM CFD /ansys_inc/v201/icemcfd/<plat-
form>/bin/icemcfd
ANSYS Polyflow /ansys_inc/v201/polyflow/bin/poly-Starts the POLYFLOW MANager. For
man any other tool, use /an-
sys_inc/v201/poly-
flow/bin/<tool>
ANSYS CFD-Post /ansys_inc/v201/CFD-Post/bin/cfd-
post
ANSYS Icepak /ansys_inc/v201/Icepak/bin/icepak
ANSYS /ansys_inc/v201/TurboGrid/bin/cfx-
TurboGrid tg
ANSYS Autodyn /ansys_inc/v201/autodyn/bin/auto- solver only
dyn201
ANSYS ACP /ansys_inc/v201/ACP/ACP.sh

Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
52 of ANSYS, Inc. and its subsidiaries and affiliates.
Chapter 6: Silent Mode Operations
ANSYS, Inc. supports silent mode operations, including installation, product configuration/unconfiguration,
and uninstall.

You can specify the following product flags. These flags are all valid for a silent install. However, because
of the way the products are packaged, not all of these flags may be valid for a silent configuration/un-
configuration, or uninstall.

Product Flags
Product product_flag
ANSYS Aqwa -aqwa
ANSYS Autodyn -autodyn
ANSYS CFX -cfx
ANSYS CFD-Post -cfdpost
ANSYS Chemkin -chemkinpro
ANSYS Customization Files -ansyscust
ANSYS Energico -energico
ANSYS EnSight -ensight
ANSYS FENSAP-ICE -fensapice
ANSYS Forte -forte
ANSYS Fluent -fluent
ANSYS ICEM CFD -icemcfd
ANSYS Mechanical APDL -mechapdl
ANSYS LS-DYNA -lsdyna
ANSYS Model Fuel Library (Encrypted) -mfl
ANSYS Polyflow -polyflow
ANSYS Reaction Workbench -reactionwb
ANSYS TurboGrid -turbogrid
Note: Installing any of the above products will install ANSYS Workbench.

ACIS Geometry Interface -acis

ANSYS Icepak -icepak
ANSYS Remote Solve Manager Standalone Services -rsm
CATIA 5 Reader -catia5_reader
Distributed Compute Services -dcs
NX Geometry Interface Plugin -ug_plugin

Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 53
Silent Mode Operations

Product product_flag
Parasolid Geometry Interface -parasolid

For more information on which products are included with each installation, see Applications Included
with Each Product (p. 71).

6.1. Silent Product and License Manager Installation

Caution:

A silent license manager installation could shut down the ANSYS, Inc. License Manager, af-
fecting other users who are using that license server machine.

You can deploy an ANSYS, Inc. product installation in silent mode. The general form to run a silent
product installation, including the client licensing, is:
INSTALL -silent -install_dir path -product_flag

If no product flags from the list above are specified, all available products will be installed. To install
specific products, run the silent install with any combination of the product flags listed above (not all
products are available on all platforms). For example, to install only TurboGrid and Icepak, issue the
following command:
INSTALL -silent —install_dir “/ansys_inc/” -turbogrid -icepak

Additional command line arguments are available; see the list below.

To install the ANSYS, Inc. License Manager on Linux systems that will act as license servers, you must
run the INSTALL command with the -LM option:
INSTALL -silent -LM -install_dir path

The silent license manager installation is valid only for the default Licensing Configuration option "Run
the ANSYS Licensing Interconnect with FLEXlm." See the ANSYS Licensing Guide for more information.

You can use the following arguments when running a silent installation. Note that some options are
available only for a silent license manager installation.

-silent Initiates a silent installation.

-help Displays a list of valid arguments for a silent installation.
-install_dir Specifies the directory to which the product or license manager is to be installed.
path If you want to install to the default location, you can omit the -install_dir
argument. The default location is /ansys_inc if the symbolic link is set; otherwise,
it will default to /usr/ansys_inc.
-product_flag Specifies one or more products to install specific products. If you omit the
-product_flag argument, all products will be installed. See the list of valid
product_flags below.
-productfile You can specify an options file that lists the products you want to install. To do
path so, you must provide a full path to a file containing desired products. See Specifying
Products with an Options File (p. 56) below for more details.

Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
54 of ANSYS, Inc. and its subsidiaries and affiliates.
 Silent Product and License Manager Installation

-licfilepath Specifies the location of the license file to install. If the path is not specified or if
path the path is the same as the existing license file, the license file will not be installed.
Valid only when doing a silent license manager installation (INSTALL -LM).
-setliclang Specifies a language to use for the ANSLIC_ADMIN utility and the ANSYS, Inc.
language Licensing Interconnect log file. Use the language directory name in the language
subdirectory of the licensing directory (en-us, fr, de, etc.) as the language
value. This flag can be used during a GUI installation as well. Valid only when
doing a license manager installation (INSTALL -LM).
-licserverinfo Specifies information to be used by the client for the license server. Valid only in
conjunction with a silent installation (INSTALL). The format is:

Single license server:

LI_port_number:FLEXlm_port_number:hostname

Example:

2325:1055:abc

Three license servers:

LI_port_number:FLEXlm_port_number:hostname1,hostname2,host-
name3

Example:

2325:1055:abc,def,xyz

The default values for the Licensing Interconnect and FlexNet port numbers
(2325 and 1055, respectively) will be used if they are not specified. However,
you do need to include the colons.

Example:

::abc

or

::abc,def,xyz

Information specified via -licserverinfo will be appended to existing

information in the ansyslmd.ini file. To change information already in
your ansyslmd.ini file, you must use the ANSLIC_ADMIN utility.
-lang Specifies a language to use for the products.

Any messages will be written to the appropriate installation log files. Installation log files are located
in the installation directory: install.log contains installation messages, and install_liccon-
fig.log contains licensing installation messages. In rare circumstances with a silent licensing installation,
the licensing installation messages may not be written to the install_licconfig.log (for example,
if the silent licensing installation aborts); in these cases, you may find error messages in the .ansys_in-
stall_temp_licconfig_<user>_<index>.log file, located in $HOME/.ansys.

For more information on the silent license manager installation, see the ANSYS Licensing Guide.

Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 55
Silent Mode Operations

Specifying Products with an Options File

You can also specify an options file on the command line using the -productfile path option.
The options file can have any name and extension, but the path must include the full path and filename,
including any extension used. The options file can specify which products you want to install. The options
file can contain all possible products, with the products you do not want to install commented out, or
it can contain only the products you want to install. An example options file is shown below. In the
example, NX is commented out using an acceptable comment indicator. When using the options file,
do not include the dash (-) before the product name.
mechapdl
ansyscust
autodyn
lsdyna
cfdpost
cfx
turbogrid
fluent
polyflow
icepak
aqwa
#ug

6.2. Silent Product Configuration/Unconfiguration

You can also run the ProductConfig utility via command line (i.e., silent mode) to configure products.

To run in silent mode, from each client machine, run the ProductConfig with the -silent option:
/ansys_inc/v201/ProductConfig.sh -silent

Note:

On an HPC cluster environment, prerequisites must be installed on each cluster execution

node.

Use the -product_flag argument to specify which products should be configured. If you do not
specify one or more products, all products that have been installed will be configured. The valid
product_flags are:

Product product_flag
ANSYS Aqwa -aqwa
ANSYS CFD-Post -cfdpost
ANSYS CFX -cfx
ANSYS FENSAP-ICE -fensapice
ANSYS Fluent -fluent
ANSYS ICEM CFD -icemcfd
ANSYS Icepak -icepak
ANSYS Mechanical APDL -mechapdl
ANSYS Polyflow -polyflow

Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
56 of ANSYS, Inc. and its subsidiaries and affiliates.
 Silent Media Installation

Product product_flag
ANSYS Remote Solve Manager Standalone Services -rsm
ANSYS TurboGrid -turbogrid

Errors will be written to the ${HOME}/.ansys/v201/ directory on the client machine.

6.3. Silent Media Installation

To run a silent installation from the media, you can either:

• Copy the contents of each DVD to a folder on the machine's hard disk such that the 201-<number>.dvd
files of each DVD are located in the same directory. You can then proceed with the silent installation as de-
scribed earlier.

• Place all of the media in separate drives (any combination of virtual ISO mounts or hardware drives) so that
they can be accessed simultaneously during the installation. Then run the silent installation as described
earlier, but include the additional -media_dir2 <path> and -media_dir3 <path> options as needed
for each drive:
INSTALL -silent -install_dir <path> -product_flag -media_dir2 <path> -media_dir3 <path>

The installer uses the mount directory from which it was launched as the first media path; you need
to specify only the location of the subsequent DVD(s) using the -media_dir2 and -media_dir3
options shown in the example above.

6.3.1. Silent Uninstall

You can also run the uninstall silently by issuing the following command:
/ansys_inc/v201/ans_uninstall201 –silent

The silent uninstall will automatically uninstall all products for this release and delete the v201 directory
and all subdirectories. You will not be prompted for confirmation.

To uninstall individual products, use the following product options in conjunction with the -silent
argument:

Product product_flag
ANSYS Aqwa -aqwa
ANSYS Autodyn -autodyn
ANSYS CFX -cfx
ANSYS CFD-Post -cfdpost
ANSYS Chemkin -chemkinpro
ANSYS Customization Files -ansyscust
ANSYS Energico -energico
ANSYS EnSight -ensight
ANSYS FENSAP-ICE -fensapice
ANSYS Forte -forte

Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 57
Silent Mode Operations

Product product_flag
ANSYS Fluent -fluent
ANSYS ICEM CFD -icemcfd
ANSYS Mechanical APDL -mechapdl
ANSYS LS-DYNA -lsdyna
ANSYS Model Fuel Library (Encrypted) -mfl
ANSYS Polyflow -polyflow
ANSYS Reaction Workbench -reactionwb
ANSYS TurboGrid -turbogrid
ANSYS Icepak -icepak
ANSYS Remote Solve Manager Standalone Services -rsm
Distributed Compute Services -dcs

For example, to uninstall only TurboGrid and Icepak, issue the following command:
/ansys_inc/v201/ans_uninstall201 –silent -turbogrid -icepak

You can also issue the -help option to see a list of valid arguments for a silent uninstall.

A record of the uninstall process will be written to ansys_inc/install.log. Any error messages
will be written to ansys_inc/install.err.

Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
58 of ANSYS, Inc. and its subsidiaries and affiliates.
Chapter 7: Configuring CAD Products
The connection functionality of all supported CAD products is included with the ANSYS release media,
and all CAD functionality except NX is installed by default. To use the connection functionality, you
need to ensure that the product is properly licensed and set any necessary environment variables or
other configuration as appropriate. See the manuals for the individual CAD products for information
about environment variables and other configuration requirements.

For complete information about the files you can import, see the Mechanical APDL ANSYS Connection
User's Guide.

Caution:

Be sure to install Mechanical APDL and the connection functionality from the same release.
If you attempt to run the latest connection functionality on a machine that is running an
earlier release of Mechanical APDL, or vice versa, the connection may fail.

If you are running NX, some additional configuration may be required, especially if you chose to skip
configuring these products during the installation process. The following sections describe any post-
installation configuration procedures that are required and how to manually configure NX if you did
not configure NX during installation or if you are updating your CAD versions. These methods are all
described in the following sections.

7.1. Using the Product & CAD Configuration Manager

The Product & CAD Configuration Manager utility allows you to configure geometry interfaces for
ANSYS Workbench on Linux systems. CAD configuration is typically handled during the product install-
ation; however, if you chose to skip those steps, or if you make changes to your local CAD configuration
between releases (for example, you move or update your CAD package, or remove it entirely), you can
use this utility. Note that only Associative Interface mode for NX is supported on Linux. However, the
ANSYS NX menu and the active connection for the Associative Interface is NOT available on Linux because
the interface operates in passive mode Linux.

This document describes how to use the Product & CAD Configuration Manager to progress through
the configuration process.

1. Run the following command to start the Product & CAD Configuration Manager, substituting the full
installation path if different than /ansys_inc:
/ansys_inc/v201/ProductConfig.sh.

2. From the Product & CAD Configuration Manager, click Configure Products & CAD.

3. From the product selection screen, verify that the ANSYS Geometry Interfaces selection is enabled and
click Next to continue the configuration.

Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 59
Configuring CAD Products

4. The next screen the provides you with the option to select which geometry interfaces to configure. Select
the desired interfaces and click Next .

5. If you chose the NX interface and the UGII environment variables were not set, you will need to specify
the NX installation path for an existing NX installation. Once you have completed NX configuration,
cluck Next.

Once you have completed the NX configuration, click Next.

6. When all of your CAD products have been successfully configured, click Exit.

Administrative users can review the log file produced by the most recent Product & CAD Configuration
in ansys_inc/v201/CADConfigLogs/Latest/CADConfigurationMgr.log, while the non-admin user
configuration record is stored in /tmp/ANSYS/v191/CADConfigLogs/Latest. Historical configurations are
maintained in the corresponding <Ansys Version>/<Date>/CADConfigurationMgr_<Time>.log.
Any errors are recorded in CADConfigurationMgr.err located immediately in CADConfigLogs
directory.

You can review the Product & CAD Configuration Manager log file, CADConfigurationMgr.log,
in /ansys_inc. If you do not have write permissions to the /ansys_inc directory, the log file will
be written to $TEMP. If you have not defined $TEMP, the log file is written to /tmp. When /tmp is not
accessible, this file will be written to the current working directory.

7.1.1. Unconfiguring
If you need to unconfigure any of your CAD products, follow the steps above, but choose Unconfigure
Products & CAD from the Product & CAD Configuration Manager.

7.1.2. Running the Product & CAD Configuration Manager in Batch Mode
You can configure ANSYS Geometry Interfaces by supplying the Product & CAD Configuration
Manager with arguments specific to the CAD sources you want to make available. The following
table contains a list of supported arguments.

The command to run the Product & CAD Configuration Manager in batch mode on Linux is:
/ansys_inc/v201/aisol/.workbench -cmd -NoMW mono /ansys_inc/v201/commonfiles/CAD/bin/linx64/
Ans.CadInt.CADConfigurationUtility.exe -arguments

Argument Value Comment

UNCONFIGURE_SPECIFIED None Results in any specified CAD sources being
unconfigured. When this flag is absent, the Product
& CAD Configuration Manager will attempt to
unconfigure all designated CAD sources.
UNCONFIGURE None Results in all CAD sources being disabled along
with prerequisite libraries.
UG_CONFIG_WB None Configure/unconfigure NX Geometry Interface to
Workbench. The argument UGII_BASE_DIR must also
be specified for the configure operation.

Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
60 of ANSYS, Inc. and its subsidiaries and affiliates.
 Using the Product & CAD Configuration Manager

Argument Value Comment

UGII_BASE_DIR Full path to NX This should agree with environment variable
installation UGII_BASE_DIR. Not required with unconfigure
(quotations are operation.
required if there are
spaces in the path).
CATIA_READER None Configure/unconfigure CatiaV5 Reader.

Note:

All arguments require a dash (-) before them in order to be properly recognized by the
Product & CAD Configuration Manager. Arguments' values should not have a dash pre-
ceding them.

For example, you can configure the NX Geometry Interface to ANSYS Workbench from the command
line by using the following:
/ansys_inc/v201/aisol/.workbench -cmd -NoMW mono /ansys_inc/v201/commonfiles/CAD/bin/linx64/
Ans.CadInt.CADConfigurationUtility.exe -UG_CONFIG_WB -UGII_BASE_DIR "<pathtonx>"

where /ansys_inc/v201 is the installation directory you specified.

To unconfigure the same CAD Interface, the command would be:

/ansys_inc/v201/aisol/.workbench -cmd -NoMW mono /ansys_inc/v201/commonfiles/CAD/bin/linx64/
Ans.CadInt.CADConfigurationUtility.exe -unconfigure_specified -UG_CONFIG_WB

Although the argument order does not matter, an argument value must immediately follow its argu-
ment.

7.1.3. NX Configuration
Running the Product & CAD Configuration Manager for NX performs the following steps to activate
the NX associative reader:

• Registers the NX Associative Geometry Interface for ANSYS Workbench by copying the file UGNX#.Com-
ponent.XML from /ansys_inc/v201/aisol/CADIntegration/UG to either /an-
sys_inc/v201/commonfiles/registry/linx64/append when the configuration manager is
in administrative mode or to $HOME/.config/ANSYS/201/UserRegFiles_NNNN/append, when
the Product & CAD Configuration Manager is run by a non-administrator. The Product & CAD Config-
uration Manager ensures that only one version of the file exists in the target location.

UGNX# is the NX version detected by the Product & CAD Configuration Manager, and NNNN is
a numeric identifier appended to the UserRegFiles directory.

• You must specify the environment variable UGII_BASE_DIR. The UGII_BASE_DIR must point to the install
location supplied to the Product & CAD Configuration Manager. The Workbench Associative Interface
for NX will not work without this variable being set properly, as this is required for proper startup of the
CAD.

• Prior to configuring a client of a network install, the client system must have its UGII_BASE_DIR point to
the same version of NX as designated on the server system. This must be done before running Product

Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 61
Configuring CAD Products

& CAD Configuration Manager or the Product Configuration Tool. For more information, see Network
Installation and Product and CAD Configuration (p. 39).

Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
62 of ANSYS, Inc. and its subsidiaries and affiliates.
Chapter 8: Uninstalling the Software
To uninstall a product, issue the following command:
/ansys_inc/v201/ans_uninstall201

Alternatively, if you are using the Mechanical APDL product, you can use the Uninstall option of the
ANS_ADMIN utility. To launch ANS_ADMIN, issue the following command:
/ansys_inc/v201/ansys/bin/ans_admin201

1. From the uninstall panel, click Select Products to Uninstall.

If you are not a superuser, you will see a warning message, and then the uninstall continues.

2. A list of products that are installed appears. Select those products you want to uninstall and click Continue.
Then click OK to confirm the list of products to be uninstalled.

3. When the uninstall has completed, click Finish.

In the case of a platform (file server) installation, the uninstall will remove the selected product(s) from
all of the Linux platforms.

Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 63
 Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
64 of ANSYS, Inc. and its subsidiaries and affiliates.
Chapter 9: Troubleshooting

9.1. Installation Troubleshooting

This section lists problems and error messages that you may encounter while installing and/or running
ANSYS, Inc. products. After each situation description or error message is the user action required to
correct the problem.

You can also find answers to commonly-asked questions on our ANSYS customer site. After you log in
to the ANSYS customer site, select Knowledge Resources> Solutions.

For information on licensing-related errors, see the Troubleshooting section of the ANSYS Licensing
Guide.

9.1.1. Gathering Diagnostic Information

There are situations which require licensing-related information to be gathered for diagnostic and
troubleshooting purposes. At times it may be necessary to provide this information to technical support.

The client-related diagnostic information can be gathered by using the Client ANSLIC_ADMIN utility.
For more information, see, Gather Client Diagnostic Information in the License Administration Using
ANSLIC_ADMIN section of the ANSYS Licensing Guide.

The server-related diagnostic information can be gathered by using ANSYS License Management
Center or by using the standalone gatherdiagnostics script. For more information, see, Gathering
Diagnostic Information in the License Server Administration Using ANSYS License Management
Center section of the ANSYS Licensing Guide.

9.1.2. The GUI Installation Process Hangs

• If the GUI installation process appears to “hang” during file extraction, with no activity appearing in the
message window, press ENTER on the command window used to start the installation. When the install-
ation is complete, check the message window carefully for any installation errors or warnings; however,
this situation rarely causes installation errors.

• If the installation does not progress beyond the extraction of any single file during the file extraction
phase, you may have insufficient disk space in the temporary directory that the file extraction utility uses.
Be aware that some components require a lengthy extraction time; we recommend allowing up to 30
minutes for these components to extract if you are running on a particularly old or slow system.

To resolve this problem, remove files from your $TEMP directory to free up disk space, or increase
the size of any disk quotas on your $TEMP directory.

Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 65
Troubleshooting

9.1.3. The Target Machine Does Not Have a DVD Drive

If the target machine does not have a DVD drive, we recommend that you download the installation
files from the ANSYS customer site. For more information on downloading files from the ANSYS cus-
tomer site, see Product Download Instructions (p. 18). Use a USB Flash drive or follow the instructions
in Mounting the DVD Instructions for DVD Installations (Linux x64 Only) (p. 20) to mount to a machine
that does have a DVD drive.

9.1.4. Product & CAD Configuration Manager Help Does Not Load
If the help for the Product & CAD Configuration Manager does not load into your default browser,
set the BROWSER environment variable to the path of your HTML viewer (such as Mozilla or Firefox)
and restart the Product & CAD Configuration Manager.

9.1.5. Cannot Enter Data in Text Fields

SUSE On some SUSE Linux systems, if you cannot enter data in text fields during the installation
or when using the ANSLIC_ADMIN utility, you may be encountering a Tcl incompatibility. To correct
the problem, unset the following environment variables before running the installation or the AN-
SLIC_ADMIN utility:

QT_IM_MODULE
XMODIFIERS
GTK_IM_MODULE

You should reset these environment variables when you are finished running the installation or using
ANSLIC_ADMIN. Do not permanently unset these environment variables as doing so could affect
other applications.

9.1.6. Download and Installation Error Messages

The current platform type is not selected and is not included in current download files. Make
sure that you are using the correct media or downloaded file. Continuing with a platform in-
stallation may require additional post-install configuration.

Do you want to continue?

This message occurs if you have selected a platform for installation that does not match the files
you are trying to install (either from the installation DVD, USB or from downloaded installation
files).

Cannot find file <product>.tar in directory <dvd_dir>

This error may appear during the ANSYS installation if you have entered the wrong DVD pathname.
Check Mounting the DVD Instructions for DVD Installations (Linux x64 Only) (p. 20) and enter the
correct pathname for your platform.

Licensing files currently installed for <platform> are more recent than those on the installation
media. The <platform> files will not be installed and will be deselected.

Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
66 of ANSYS, Inc. and its subsidiaries and affiliates.
 Installation Troubleshooting - Graphics

This message appears during an ANSYS, Inc. product installation if the installed license manager
files are newer than the ones being installed. You should always use the newest files. However,
due to system format changes or other unlikely scenarios, the date check could produce incorrect
results. To override the date check and force the installation to always install the files from the
media, regardless of the file dates, re-run the installation with the -nodatecheck option. We
strongly recommend that you exercise caution when running the installation with the -nodat-
echeck option; installing older license files can result in licensing errors and the inability to run
ANSYS, Inc. products.

9.1.7. System-related Error Messages

Error, could not open display.

Either the DISPLAY environment variable is not correct or the xhosts command was not properly
set. See the Mechanical APDL Basic Analysis Guide for specific graphics information.

***Error, ANSYS201_DIR environment variable is not set. This is a fatal error – exiting.

This message indicates that the ANSYS201_DIR environment variable was not set where necessary
for licensing. This environment variable (which is set in the scripts that run ANSYS) should be set
to the release-specific installation directory.

9.1.8. High Performance Computing Error Messages

The following error messages are associated with the High Performance Computing solvers.

mpid: Error: HP MPI version incompatibility detected

You may encounter this or a similar message if you attempt to use ANSYS 2020 R1 with a different
version of MPI than is supported. See the Parallel Processing Guide for a complete list of supported
MPI versions.

9.1.9. INSTALL Command Appears as Lowercase in USB Installation

With some SuSE Linux configurations, the USB auto-mount function may cause the INSTALL command
to appear as lowercase. Using the lowercase install command may cause extraneous files to be left
behind after the ANSYS product installation.

To correct this lowercase issue, un-mount the USB drive and manually re-mount the drive prior to
installing ANSYS products.

9.2. Installation Troubleshooting - Graphics

The items listed below apply to issue relating to graphics cards and drivers.

9.2.1. DesignModeler and Mechanical APDL Crash When Using the Latest
AMD Graphics Drivers
With the AMD 18.Q1 graphics driver two issues have been discovered:

Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 67
Troubleshooting

• Launching DesignModeler causes a libgl error to output in the terminal. Immediately after this error the
ANSYS application crashes and forces you back to the login screen.

• Importing a geometry file into a static structural system shows a green check mark, but upon launching
Mechanical APDL the ANSYS application crashes and forces you back to the login screen.

AMD is aware of this issue and plans to address the problem.

If you experience either issue, perform the following work-around suggested by AMD.

Issue the following commands:

ln -sf /opt/amdgpu-pro/lib64/libGL.so.1.2 /usr/lib64/libGL.so.1

ln -sf /opt/amdgpu-pro/lib64/libGL.so.1.2 /usr/lib64/libGL.so

9.3. Installation Troubleshooting - Mechanical APDL

The items listed below apply only to the Mechanical APDL product.

9.3.1. Your batch jobs terminate when you log out of a session
On some systems, you may need to use the ‘nohup’ option to allow batch jobs to continue running
after you log out of a session. If you are running via the Launcher, select Options> Use ‘nohup’ To
Start Batch Runs With Output Sent to ‘File Only.’ We do not recommend using this setting on
systems that automatically set ‘nohup.’

9.3.2. Mechanical APDL Documentation File for User Interface Error Messages
Missing or erroneous documentation files for user interface. Command ignored.

Verify that the documentation list file for the user interface exists in the /ansys_inc/v201/an-
sys/gui/en-us/UIDL subdirectory.
ls -l /ansys_inc/v201/ansys/gui/en-us/UIDL/menulist.ans

The system should respond with:

-rw-r--r-- 1 root 23 Jan 8 11:50 /ansys_inc/v201/ansys/gui
/en-us/UIDL/menulist.ans

Make sure that the pathnames in the menulist.ans file are correct.

9.3.3. Launcher Error Messages

Some of the more common error messages follow. See the ANSYS Licensing Guide for licensing-related
launcher messages.

***Cannot create required <profile> file. Therefore, cannot write to profile information during
this launcher session.

If you see this error, you cannot add or modify profile information during this launcher session.
Verify that you have write access to the directory and restart the launcher session. Typically, this

Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
68 of ANSYS, Inc. and its subsidiaries and affiliates.
 Installation Troubleshooting - ANSYS Workbench

directory is C:\Documents and Settings\<user name>\Application Data\AN-

SYS\v201\launcher on Windows or ~/.ansys/v201/launcher on Linux.

9.3.4. FORTRAN Runtime Error Messages

The following error messages occur if you are running Mechanical APDL in a directory in which the
user does not have write permission, or if Mechanical APDL files (i.e., Jobname.RST, Jobname.DB)
exist in the current directory but you do not have write permissions to the files. The specific messages
that appear on each system are shown below.

9.3.4.1. Intel Linux 64 Systems

Input/Output Error 177: Create Failure

In Procedure: fappnd

At Line: 72

Statement: Formatted WRITE

Unit: 19

9.3.4.2. Intel EM64T Linux x64 Systems

forrtl: Permission denied

forrtl: severe (9): permission to access file denied, unit 19, file /build/v201/ansys/objs

9.3.4.3. AMD Opteron Linux x64 Systems

***ERROR

Unable to open file /build/v201/ansys/objs/file.err for WRITE. Check directory and file permis-
sions.

9.4. Installation Troubleshooting - ANSYS Workbench

9.4.1. Startup or Graphics Problems

To minimize graphics problems, always verify that you are running the latest graphics drivers provided
by your computer's hardware manufacturer.

If you are running ANSYS Workbench on Linux and experience problems at startup or with the GUI
or graphics displaying correctly, and you are running in accelerated graphics mode, you may need
to relaunch ANSYS Workbench using the -oglmesa flag to activate software rendering:
runwb2 -oglmesa

If ANSYS Workbench detects that graphics problems are causing crashes, it will automatically switch
to software rendering. ANSYS Workbench also will use software rending mode by default when running
on a remote display, or on a local display if the hardware does not appear to be accelerated.

Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 69
Troubleshooting

To revert to accelerated graphics mode, launch ANSYS Workbench using the -oglhw flag:
runwb2 -oglhw

9.5. Installation Troubleshooting - ANSYS CFX

9.5.1. CFX Distributed Parallel Runs Fail

On some SLES machines (typically ones with more than one network card), the default configuration
of /etc/hosts will cause CFX distributed parallel runs to fail. In such cases, the problem might be
solved by editing the /etc/hosts file to remove all lines that contain redundant loopback addresses.
Do not remove the line with the first loopback address, which is typically 127.0.0.1.

9.6. Contacting Technical Support

Technical Support can be accessed from www.ansys.com/support.

ANSYS Contacts & Locations can be found here.

Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
70 of ANSYS, Inc. and its subsidiaries and affiliates.
Chapter 10: Applications Included with Each Product
The following table displays which ANSYS, Inc. applications are included with each of the product in-
stallation options.

Product Install Option Silent Install What is Included?

Option
ANSYS, Inc. Products
Explicit Dynamics
Autodyn -autodyn Workbench [1], Autodyn

LS-DYNA -lsdyna Workbench [1], ANSYS LS-DYNA

Fluid Dynamics
CFD-Post only -cfdpost Workbench [1], CFD-Post,
Distributed Compute Services
CFX (includes ANSYS CFD-Post) -cfx Workbench [1], CFX, CFD-Post,
Distributed Compute Services
Chemkin -chemkinpro Workbench [1], Chemkin,
Distributed Compute Services
Energico -energico Workbench [1], Chemkin,
Energico, Distributed Compute
Services
Model Fuel Library (Encrypted) -mfl Workbench [1], Chemkin, Model
Fuel Library (Encrypted),
Distributed Compute Services
Reaction Workbench -reactionwb Workbench [1], Chemkin,
Reaction Workbench, Distributed
Compute Services
EnSight -ensight Ensight, Workbench [1],
Distributed Compute Services
FENSAP-ICE -fensapice Workbench [1], FENSAP-ICE,
CFD-Post, Distributed Compute
Services
Fluent (includes ANSYS CFD-Post) -fluent Workbench [1], Fluent, CFD-Post,
Distributed Compute Services
Forte -forte Workbench [1], Forte,
Distributed Compute Services
Polyflow (includes ANSYS -polyflow Workbench [1], CFD-Post,
CFD-Post) Polyflow, Distributed Compute
Services

Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 71
Applications Included with Each Product

Product Install Option Silent Install What is Included?

Option
TurboGrid -turbogrid Workbench [1], TurboGrid,
Distributed Compute Services
ICEM CFD -icemcfd Workbench [1], ICEM CFD
Offshore
Aqwa -aqwa Workbench [1], Aqwa
Structural Mechanics
Customization Files -ansyscust Workbench [1], Mechanical
APDL User-Programmable
Feature, Distributed Compute
Services
Mechanical Products -mechapdl Workbench [1], Mechanical
APDL, ECAD, ANSYS Composite
PrepPost, Distributed Compute
Services
ANSYS Additional Tools
Distributed Compute Services -dcs Distributed Compute Services

Composite PrepPost -acp ACP Only

Icepak (includes ANSYS CFD-Post) -icepak CFD-Post, Icepak, ECAD

Remote Solve Manager Stand -rsm Remote Solve Manager

Alone Services
ANSYS Geometry Interfaces
ACIS Geometry Interface -acis Geometry Interface for ACIS

CATIA, Version 5 Geometry -catia5 Geometry Interface for CATIA,

Interface Version 5

NX Geometry Interface -ug_reader, Geometry Interface for NX

-ug_plugin
Parasolid Geometry Interface -parasolid Geometry Interface for Parasolid

1. Workbench includes the Workbench Framework, DesignModeler, DesignXplorer, Minerva and Remote
Solve Manager.

Release 2020 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
72 of ANSYS, Inc. and its subsidiaries and affiliates.