Installation Guide for Linux

ANSYS, Inc. Release 19.0

Southpointe January 2018
2600 ANSYS Drive 000408
Canonsburg, PA 15317 ANSYS, Inc. and
[email protected] ANSYS Europe,
Ltd. are UL
http://www.ansys.com registered ISO
(T) 724-746-3304 9001: 2008
(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

© 2017 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: 2008 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 .................................................................... 6
2. Platform Details ...................................................................................................................................... 9
2.1. Utilizing CPU Hyperthreading Technology with ANSYS CFD Solvers .................................................. 14
2.2. Compiler Requirements for Linux Systems ....................................................................................... 14
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 ....................................................................................... 24
3.5.2.1. Registering the License Server ....................................................................................... 26
4. Installing ANSYS Products and the License Server on Different Linux Machines ................................ 27
4.1. Pre-Installation Instructions for Download Installations .................................................................... 28
4.2. Product Download Instructions ....................................................................................................... 28
4.3. Installing from a USB Drive .............................................................................................................. 29
4.4. Mounting the DVD Instructions for DVD Installations (Linux x64 Only) .............................................. 30
4.5. Product Installation ......................................................................................................................... 31
4.5.1. Specifying CAD Configurations ............................................................................................... 34
4.5.2. ANSYS License Manager Installation ....................................................................................... 35
4.5.2.1. Registering the License Server ....................................................................................... 36
4.5.3. Network Installation and Product and CAD Configuration ....................................................... 37
4.5.3.1. Export the /ansys_inc Directory ............................................................................... 37
4.5.3.2. Run the Product & CAD Configuration Manager on All Client Machines ........................... 38
5. Post-Installation Instructions ............................................................................................................... 39
5.1. Post-Installation Procedures for Mechanical APDL and ANSYS Workbench Products ......................... 40
5.1.1. Post-Installation Procedures for ANSYS CFX ............................................................................. 41
5.1.1.1. Setting up ANSYS TurboGrid Release 19.0 ....................................................................... 42
5.1.1.2. Using the ANSYS CFX Launcher to Set Up Users .............................................................. 43
5.1.2. Post-Installation Procedures for ANSYS Fluent ......................................................................... 43
5.1.3. Post-Installation Procedures for ANSYS Polyflow ..................................................................... 44
5.1.4. Post-Installation Procedures for ANSYS ICEM CFD .................................................................... 44
5.1.5. Post-Installation Procedures for ANSYS Autodyn ..................................................................... 44
5.1.6. Post-Installation Procedures for ANSYS FENSAP-ICE ................................................................. 44
5.1.7. Post-Installation Procedures for Other Products ...................................................................... 46
5.2. Product Localization ....................................................................................................................... 46
5.2.1. Translated Message File Installation for Mechanical APDL ....................................................... 47
5.3. Launching ANSYS, Inc. Products ....................................................................................................... 48
6. Silent Mode Operations ........................................................................................................................ 49
6.1. Silent Product and License Manager Installation .............................................................................. 50
6.2. Silent Product Configuration/Unconfiguration ................................................................................. 52
6.3. Silent Media Installation .................................................................................................................. 52

Release 19.0 - © 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 ....................................................................................................................... 53

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

Release 19.0 - © 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. OpenMotif Versions for SUSE Linux Enterprise ......................................................................................... 9
2.2. OpenMotif Versions for Red Hat Enterprise Linux ..................................................................................... 9
2.3. Compiler Requirements for All Linux Versions ........................................................................................ 14
5.1. Startup Commands ............................................................................................................................... 48

Release 19.0 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. v
 Release 19.0 - © 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 19.0. These products include:

• ANSYS Structural Mechanics

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

– ANSYS Customization Files for User Programmable Features

• ANSYS Explicit Dynamics

– ANSYS Autodyn

– ANSYS LS-DYNA

• ANSYS Fluid Dynamics

– ANSYS CFX (includes ANSYS CFD-Post)

– ANSYS Fluent (includes ANSYS CFD-Post)

– ANSYS TurboGrid

– ANSYS Polyflow (includes ANSYS CFD-Post)

– ANSYS CFD-Post only

• ANSYS ICEM CFD

• ANSYS Additional Tools

– ANSYS Icepak (includes ANSYS CFD-Post)

– Remote Solve Manager Standalone Services

• ANSYS Geometry Interfaces

– ACIS

– CATIA, Version 4

– CATIA, Version 5

– NX

– Parasolid

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

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 19.0, ANSYS BladeGen, Vista CCD, Vista CPD, Vista RTD, and Vista AFD are not supported on
Linux platforms.

ANSYS Workbench and ANSYS EKM Desktop are 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

• FE Modeler

• EKM Client

Important Notice
If you wish to run multiple releases of ANSYS, Inc. software, you MUST install them chronologically (i.e.,
Release 18.0 followed by Release 19.0). If you install an earlier release after installing Release 19.0, 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 19.0, you MUST uninstall Release
19.0, then re-install the releases in order.

Summary of New and Changed Features

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

• The INSTALL.LM and INSTALL.EKMSVR files have been removed and replaced with -LM and -ekmsvr
command flags. These command flags can be used in conjunction with the INSTALL file (example: INSTALL
-LM or INSTALL -silent -LM) for both command line and silent installation. Additionally, the INSTALL.DOCONLY
file has also been removed. The stand-alone ANSYS product documentation has been replaced by our new
ANSYS online product documentation.The product installation now configures your default browser to
access the ANSYS Internet Help website. For a local copy of the product documentation on your system,
download an installable version from the ANSYS Download Center.

• The product selection screen displayed during the ANSYS product installation has been modified to more
clearly display which products are being installed. A check-mark to the left of the product signifies that the
product and all related "child" products are enabled for installation while a grey box indicates that some,
but not all products are enabled for installation.

• In conjunction with our new ANSYS online product documentation, the Install Documentation (to your
computer) option has been removed from the ANSYS product installation. The product installation now
configures your default browser to access the ANSYS Internet Help website. With online documentation,
you have access to the best and latest content, updated as soon as it is available. You also gain access to
our help, tutorials, and videos in a single, convenient location, accessible from all your Internet-connected

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

devices. 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 package are included with the
download package.

• ANSYS EnSight is now included as part of the ANSYS product installation and can be selected on the product
selection menu for installation.

• New "Help" and "Information" icons have been added to the installation screens. 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.

1.1. System Prerequisites

ANSYS, Inc. Release 19.0 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 6.8 linx64 Download
and 6.9, Red Hat Enterprise / USB
Linux 7.2 and 7.3, SUSE Linux
Enterprise 11 SP3 and SP4,
SUSE Linux Enterprise Server
and Desktop 12 SP1 and SP2,
CentOS 7.3
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.

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–6R2017 W, I
GAMBIT 2.4 W, I

Release 19.0 - © 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
Parasolid 29.0 A, W, I
ACIS 2017 A, W, I 1
NX 9.0 A, W, I
NX 10.0 A, W, I
NX 11.0 A, W, I
STEP AP203, AP214 A, W, I
IGES A 2, W, I 3
GEMS I
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 12.0 GB
ANSYS LS-DYNA 12.5 GB
ANSYS CFD Post only 12.2 GB
ANSYS CFX 12.6 GB
ANSYS Chemkin 12.8 GB
ANSYS FENSAP-ICE 12.9 GB
ANSYS Fluent 14.1 GB
ANSYS Forte 12.4 GB
ANSYS Polyflow 14.7 GB
ANSYS TurboGrid 12.3 GB
ANSYS ICEM CFD 12.6 GB
ANSYS Mechanical APDL 14.3 GB
ANSYS Icepak 11.0 GB
ANSYS Remote Solve Manager 7.5 GB
ANSYS Geometry Interfaces 7.6 GB
Disk space required to install all products: 23.1 GB

Release 19.0 - © 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:

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

NVIDIA Tesla Series (any model)

NVIDIA Quadro GP100
NVIDIA Quadro P6000
NVIDIA Quadro P5000
NVIDIA Quadro M6000
NVIDIA Quadro K6000
NVIDIA Quadro K5200
NVIDIA Quadro K5000

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

NVIDIA Tesla Series (any model except the following: K10/M4/M40/M6/M60/P4/P40)

NVIDIA Quadro GP100
NVIDIA Quadro K6000

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

1.4. Additional Hardware and Software Requirements

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

• 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.
Minimum supported versions are:

– Firefox 52 or greater

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 package 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.

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

• Discrete graphics card with the latest drivers and compatible with the supported operating systems. When
working with 3D models, use of a recent NVIDIA Quadro, AMD FirePro or similar card with at least 1 GB of
memory that supports, at a minimum, OpenGL version 4.2 (OpenGL 4.5 or higher is recommended).

For information on the most recently tested graphics cards, see ANSYS.com> Support> Platform
Support and view the Graphics Cards Tested PDF for your release.

Note

– Vendor Legacy Support: To be compatible, legacy GL 4.2+ 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

• 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.

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

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

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

Release 19.0 - © 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

Product Name Executable Name

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 19.0 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 7
 Release 19.0 - © 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.

ANSYS products require OpenMotif. After installing your Linux platform, review the tables below and
install the appropriate version of OpenMotif. (You may need to use "rpm -iv -force" to install these.)

Table 2.1: OpenMotif Versions for SUSE Linux Enterprise

SUSE Linux Enterprise Release OpenMotif Version OpenMotif Zypper Package

SUSE Linux Enterprise 11 SP 3 openmotif22-libs-2.2.4-139.1 or openmotif22-libs or
openmotif22-libs-32bit-2.2.4-139.1.x86_64
openmotif22-libs-32bit
SUSE Linux Enterprise 11 SP 4 SLES 11 SP4: motif-2.3.4-1 motif
SUSE Linux Enterprise 12 SP 0 SLES 11 SP4: motif-2.3.4-1 motif
SUSE Linux Enterprise 12 SP 1 SLES 12 SP1: motif
motif-2.3.4-4.15.x86_64

Table 2.2: OpenMotif Versions for Red Hat Enterprise Linux

Red Hat Enterprise Linux Release OpenMotif Version

Red Hat Enterprise Linux 6.x motif-2.3.4-1
Red Hat Enterprise Linux 7.x motif-2.2.4-0

For More information on OpenMotif libraries for your platform, see the Motif download site.

Red Hat Enterprise Linux 6.8 through 6.9 and 7.2 through 7.3 You need to install the following
libraries:

• libXp.x86_64

• xorg-x11-fonts-cyrillic.noarch

• xterm.x86_64

• openmotif.x86_64

• compat-libstdc++-33.x86_64

• compat-libstdc++-44.x86_64

• libstdc++.x86_64

• libstdc++.i686

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

• gcc-c++.x86_64

• compat-libstdc++-33.i686

• compat-libstdc++-44.i686

• libstdc++-devel.x86_64

• libstdc++-devel.i686

• compat-gcc-34.x86_64

• 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)

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.3 You need to install the following libraries:

• glibc.i686

• glib2.i686

• bzip2-lib-s.i686

• libpng.i686

• libtiff.i686

• libXft.i686

• libXxf86vm.i686

• sssd-client.i686

• libpng12

• libpng12.i686

• libXp

• libXp.i686

• libXp

Release 19.0 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
10 of ANSYS, Inc. and its subsidiaries and affiliates.
• openmotif

• zlib

If running ANSYS License Manager, also install

• redhat-lsb

• compat-libtiff3

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:

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

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

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

Mechanical, Meshing, DesignModeler, and FE Modeler 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 numer-
ical format. ANSYS Workbench must already be installed before setting this control.

First, you need to ensure that the /v190/aisol/WBMWRegistry/ directory has write permissions.
From the /v190/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>/v190/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.

Using Fluent with Infiniband 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.

Release 19.0 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
12 of ANSYS, Inc. and its subsidiaries and affiliates.
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 Infiniband 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 19.0 on a
SUSE SLES 11.x or 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.

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 19.0 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 file-
names. In these cases, ANSYS quits because the loader cannot find all of the libraries that it is looking
for. When running ANSYS Release 19.0, the loader will inform you that it is unable to locate a specific
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

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

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.3: Compiler Requirements
for All Linux Versions (p. 14). The ANSYS solver is built on Red Hat Enterprise Linux AS release 4 (Update
5).

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.

Intel Xeon EM64T

ANSYS was built and tested on a generic Intel EM64T system running Red Hat Enterprise Linux AS release
5.3.

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 hyperthreading 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.3: Compiler Requirements for All Linux Versions

Mechanical APDL, CFX Fluent Compilers* AUTODYN

ANSYS Workbench Compilers* Compilers*
Compilers*
Intel 15.0.2 (FORTRAN, Intel 15.0.2 GCC 4.8.3 (typically Intel 15.0.2
C, C++) and GCC 4.8.3 FORTRAN (for installed as part of the (FORTRAN, C,
(for user custom solver operating system) C++)

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

Mechanical APDL, CFX Fluent Compilers* AUTODYN

ANSYS Workbench Compilers* Compilers*
Compilers*
programmable modeling using
features) User Fortran)
and GCC 4.8.3
(for custom
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.

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 customer 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)

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

Release 19.0 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 15
 Release 19.0 - © 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/v190
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 (6.8 through 6.9 and 7.2 through 7.3), SUSE Linux Enterprise 11 (SP3
or SP4), SUSE Linux Enterprise 12 (SP1 through SP2) and CentOS-7.3. 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.

Release 19.0 - © 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

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.

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.

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

• 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>/ANSYS190 or /media/ANSYS190 and then run INSTALL as this may
cause unmounting and ejecting issues.

Red Hat Enterprise 6.8 through 6.9, SUSE Linux Enterprise 11 SP3 and SP4 and CentOS-7.3

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.2 through 7.3 and SUSE Linux Enterprise 12 SP1 through SP2

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>/ANSYS190

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

vi /etc/fstab

Inserting the following line:

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

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

4. Run the following command to execute the fstab:

Release 19.0 - © 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

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>/ANSYS190 or /media/ANSYS190 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/ANSYS190 or
/media/<user>/ANSYS190/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

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

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

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>/ANSYS190/INSTALL

/media/ANSYS190/INSTALL

Note

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

2. The ANSYS, Inc. Installation Launcher appears.

Release 19.0 - © 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, ANSYS EKM
Server, and the ANSYS License Manager. You can access the installation guide for the ANSYS EKM
Server from the Downloads page on the customer site.

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.

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.

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

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 Catia V5 or NX, you will have additional installation steps. These steps are completed
on the CAD Configuration screen which is displayed when you click Next. For additional inform-
ation on completing these steps, see Specifying CAD Configurations (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.

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-

Release 19.0 - © 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

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 NX from the product selection screen and clicking Next displays the CAD Configuration screen.
This screen contains the configuration properties for each CAD product that you have selected in an
expanded "accordion" view.

You can use the following instructions to configure the appropriate CAD properties. If you wish to skip
the configuration step, you can do so by selecting either the Perform Configuration at a later time
or the Skip all and configure later using Product & CAD Configuration Manager options. You will
need to manually configure these CAD interfaces at a later time, using the Product & CAD Configuration
Manager. See Configuring CAD Products (p. 55) for more information on using the Product & CAD
Configuration Manager.

NX

1. If you selected NX, you can choose the Workbench Associative Interface (requires that the CAD product
be installed), or skip and configure later (using the Product & CAD Configuration Manager).

2. If you choose the Workbench Associative Interface and the UGII environment variables were not set, you
may need to specify the NX installation path for an existing NX installation. Alternatively, you can run the
Product & CAD Configuration Manager after the installation and provide the NX installation path under
the NX tab.

3. If you selected the ANSYS ICEM CFD NX Interface product but not the NX Geometry Interface product on
the product selection screen, you may need to specify the NX installation path or choose to skip config-
uring NX and use the Product & CAD Configuration Manager to configure later.

3.5.2. ANSYS License Manager Installation

Follow the instructions below to install the ANSYS, Inc. License Manager on your Linux machine. Because
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 down-
loaded 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.

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

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 permissions
to the directory you choose. The default is /ansys_inc. We recommend using the default directory.
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 pre-
vious 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 install-
ation, 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 wish to launch the License Management Center, clear the Launch License Manage-
ment 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/v190/ACP.sh
CFD Post /ansys_inc/v190/cfdpost
CFX /ansys_inc/v190/CFX/bin/<productname>

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

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

Release 19.0 - © 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

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.

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

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

Release 19.0 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
26 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. 35)
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. 31) 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/v190
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. 36).

• 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 19.0 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 27
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 (6.8 through 6.9 and 7.2 through 7.3), SUSE Linux Enterprise 11 (SP3
or SP4), SUSE Linux Enterprise 12 (SP1 through SP2) and CentOS-7.3. 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 19.0 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
28 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. 31).

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>/ANSYS190 or /media/ANSYS190 and then run INSTALL as this may
cause unmounting and ejecting issues.

Red Hat Enterprise 6.8 through 6.9, SUSE Linux Enterprise 11 SP3 and SP4 and CentOS-7.3

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. 31).

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.2 through 7.3 and SUSE Linux Enterprise 12 SP1 through SP2

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>/ANSYS190

Release 19.0 - © 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

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

vi /etc/fstab

Inserting the following line:

/dev/xxxx /run/media/<username>/ANSYS190 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>/ANSYS190 or /media/ANSYS190 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/ANSYS190.

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)

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

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>/ANSYS190/INSTALL

/media/ANSYS190/INSTALL

Note

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

2. The ANSYS, Inc. Installation Launcher appears.

Release 19.0 - © 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

From the options along the left side of the launcher you can install ANSYS products, ANSYS EKM
Server, and the ANSYS License Manager. You can access the installation guide for the ANSYS EKM
Server from the Downloads page on the customer site.

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. 37)) for each platform
other than your current machine type. See Network Installation and Product and CAD Configura-
tion (p. 37) for specific instructions on how to configure a shared installation directory across
multiple machines using a common network file system.

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.

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

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 Catia V5 or NX, you will have additional installation steps. These steps are completed
on the CAD Configuration screen which is displayed when you click Next. For additional inform-
ation on completing these steps, see Specifying CAD Configurations (p. 34).

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-

Release 19.0 - © 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

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. 37).

4.5.1. Specifying CAD Configurations

Selecting Catia V5 or NX from the product selection screen and clicking Next displays the CAD Config-
uration screen. This screen contains the configuration properties for each CAD product that you have
selected in an expanded "accordion" view.

You can use the following instructions to configure the appropriate CAD properties. If you wish to skip
the configuration step, you can do so by selecting either the Perform Configuration at a later time
or the Skip all and configure later using Product & CAD Configuration Manager options. You will
need to manually configure these CAD interfaces at a later time, using the Product & CAD Configuration
Manager. See Configuring CAD Products (p. 55) for more information on using the Product & CAD
Configuration Manager.

NX

1. If you selected NX, you can choose the Workbench Associative Interface (requires that the CAD product
be installed), or skip and configure later (using the Product & CAD Configuration Manager).

2. If you choose the Workbench Associative Interface and the UGII environment variables were not set, you
may need to specify the NX installation path for an existing NX installation. Alternatively, you can run the
Product & CAD Configuration Manager after the installation and provide the NX installation path under
the NX tab.

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

3. If you selected the ANSYS ICEM CFD NX Interface product but not the NX Geometry Interface product on
the product selection screen, you may need to specify the NX installation path or choose to skip config-
uring NX and use the Product & CAD Configuration Manager to configure later.

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 down-
loaded 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 permissions
to the directory you choose. The default is /ansys_inc. We recommend using the default directory.
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 pre-
vious 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 install-
ation, 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.

Release 19.0 - © 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

If you do not want to launch the License Management Center, clear the Launch License Manage-
ment 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/v190/ACP.sh
CFD Post /ansys_inc/v190/cfdpost
CFX /ansys_inc/v190/CFX/bin/<productname>

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

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

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 Li-
cense.

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

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 con-
figuring 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 dir-
ectory 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 internet
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.

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 configur-
ation, 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.

Release 19.0 - © 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

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/an-
sys_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 /ansys_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/v190/ProductConfig.sh

2. Select Configure Products & CAD.

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. 39).

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:]\v190\commonfiles\globalset-

tings

2. Open the file ANSYSProductImprovementProgram.txt.

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

Release 19.0 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
38 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/v190/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. 55) 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 19.0 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 39
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 ANSYS190_DIR environment variable sets the location of the ANSYS directory hierarchy.
The default value is /ansys_inc/v190/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.
ANSYS190_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
page of the ANSYS Help 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.
ANSYS190_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.
ANSYS190_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).
ANSYS190_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. 55) later in this guide for more information.

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

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

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. Run the ANS_ADMIN utility to properly configure ANSYS (depending on the products you are running)
or relink ANSYS.

4. 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
RSM 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/v190/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 to

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

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 19.0

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:

• Affects users regardless of whether they use ANSYS TurboGrid

• Can only be done by the root user

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

• Is system dependent

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

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 command:
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/v190/fluent/bin $path)

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

PATH=(/ansys_inc/v190/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

This command should not return anything.

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

<install_dir>/ansys_inc/v190/fluent/bin

3. Run the following command:

<install_dir>/ansys_inc/v190/fluent/bin/fluent

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

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 recom-
mended 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/v190/icemcfd/linux64_amd/bin

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

ICEM_ACN - set to /ansys_inc/v190/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/v190/autodyn/bin

5.1.6. Post-Installation Procedures for ANSYS FENSAP-ICE

Software Launch
To launch FENSAP-ICE, execute:

<install_dir>/ansys_inc/v190/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:

Release 19.0 - © 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

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

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

export PATH=<install_dir>/ansys_inc/v190/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/v190/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/v190/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 R19.0.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.

ANSYS Licensing
The ANSYS Licensing System is used by default. No special configuration is required if the ANSYS License
contains a feature enabling FENSAP-ICE and the ANSYS R19.0 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

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

NTI Licensing
Legacy license keys from prior to ANSYS R19.0 use the NTI FLEXLm license system. The option for NTI
licensing must then be enabled in the licensing.txt file <install_dir>/ansys_inc/v190/fensapice/config/li-
censing.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 BladeEditor document-
ation.

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 priv-
ileges:

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-

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

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/v190

2. <install_dir>/ansys_inc/v190/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/v190/ansys/docu/fr

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

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

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

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

Release 19.0 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
48 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
Mechanical APDL -mechapdl
ANSYS Customization Files -ansyscust
ANSYS Autodyn -autodyn
ANSYS LS-DYNA -lsdyna
ANSYS CFD-Post -cfdpost
ANSYS CFX -cfx
ANSYS EnSight -ensight
ANSYS TurboGrid -turbogrid
ANSYS Fluent -fluent
ANSYS Polyflow -polyflow
ANSYS ICEM CFD -icemcfd
ANSYS Forte -forte
ANSYS Chemkin -chemkinpro
ANSYS Energico -energico
ANSYS FENSAP-ICE -fensapice
ANSYS Reaction Workbench -reactionwb
ANSYS Model Fuel Library (Encrypted) -mfl

Note: Installing any of the above products will install ANSYS Workbench.

ANSYS Remote Solve Manager Standalone Services -rsm

Parasolid Geometry Interface -parasolid
ACIS Geometry Interface -acis
NX Geometry Interface Plugin -ug_plugin
ANSYS Icepak -icepak
CATIA 5 Reader -catia5_reader

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

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

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. 51) below for more details.
-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

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

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.

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

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

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
#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/v190/ProductConfig.sh -silent

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
Mechanical APDL -mechapdl
ANSYS CFD-Post -cfdpost
ANSYS CFX -cfx
ANSYS TurboGrid -turbogrid
ANSYS Fluent -fluent
ANSYS Polyflow -polyflow
ANSYS Icepak -icepak
ANSYS ICEM CFD -icemcfd
ANSYS FENSAP-ICE -fensapice
ANSYS Remote Solve Manager Standalone Services -rsm

Errors will be written to the ${HOME}/.ansys/v190/ 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 190-<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

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

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/v190/ans_uninstall190 –silent

The silent uninstall will automatically uninstall all products for this release and delete the v190 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:

Mechanical APDL -mechapdl

ANSYS CFX -cfx
ANSYS CFD-Post -cfdpost
ANSYS Fluent -fluent
ANSYS Polyflow -polyflow
ANSYS ICEM CFD -icemcfd
ANSYS TurboGrid -turbogrid
ANSYS Icepak -icepak
ANSYS FENSAP-ICE -fensapice
ANSYS Remote Solve Manager Standalone Services -rsm

For example, to uninstall only TurboGrid and Icepak, issue the following command:
/ansys_inc/v190/ans_uninstall190 –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 19.0 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 53
 Release 19.0 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
54 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/v190/aisol/.workbench -cmd -NoMW mono /ansys_inc/v190/commonfiles/CAD/
bin/linx64/Ans.CadInt.CADConfigUtilityGUI.exe.

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

3. From the selection screen, choose the CAD products that you need to configure. Click Next.

4. Configure the appropriate CAD products as described below:

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

NX

1. If you selected NX, you can choose the Workbench Associative Interface (requires that the CAD
product be installed), or skip and configure later (using the Product & CAD Configuration Manager).

2. If you choose the Workbench Associative Interface and the UGII environment variables were not set,
you may need to specify the NX installation path for an existing NX installation. Alternatively, you
can run the Product & CAD Configuration Manager after the installation and provide the NX install-
ation path under the NX tab.

3. If you selected the ANSYS ICEM CFD NX Interface product but not the NX Geometry Interface product
on the product selection screen, you may need to specify the NX installation path or choose to skip
configuring NX and use the Product & CAD Configuration Manager to configure later.

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

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/v190/aisol/.workbench -cmd -NoMW mono /ansys_inc/v190/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.
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).

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

Argument Value Comment

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 preceding
them.

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

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

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

/ansys_inc/v190/aisol/.workbench -cmd -NoMW mono /ansys_inc/v190/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 argument.

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

• Registers the NX Associative Geometry Interface for ANSYS Workbench by copying the file UGNX#.Compon-
ent.XML from /ansys_inc/v190/aisol/CADIntegration/UG to either /ansys_inc/v190/com-
monfiles/registry/linx64/append when the configuration manager is in administrative mode or
to $HOME/.config/ANSYS/190/UserRegFiles_NNNN/append, when the Product & CAD Config-
uration Manager is run by a non-administrator. The Product & CAD Configuration 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 variables UGII_BASE_DIR and UGII_ROOT_DIR. The UGII_BASE_DIR must
point to the install location supplied to the Product & CAD Configuration Manager. The UGII_ROOT_DIR
must point to the /ugii or /bin subdirectory in the NX install location. The Workbench Associative Interface
for NX will not work without these two variables set properly, as these are 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 &
CAD Configuration Manager or the Product Configuration Tool. For more information, see Network In-
stallation and Product and CAD Configuration (p. 37).

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

7.2. Configuring the Geometry Interface for NX for ANSYS Workbench

Products
If you chose to skip configuring the Geometry Interface for NX during the ANSYS Workbench installation,
you may need to run the CAD Configuration Utility's CAD Interface Configuration > Configure UG
NX Reader for Workbench option.

1. Launch CAD Configuration Utility.

2. Select CAD Interface Configuration to continue.

3. Select Configure UG NX Reader for Workbench to continue.

4. Enter the directory path to the NX installation path. Select OK to continue.

5. Select EXIT to close CAD Configuration Utility.

Release 19.0 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
58 of ANSYS, Inc. and its subsidiaries and affiliates.
Chapter 8: Uninstalling the Software
To uninstall a product, issue the following command:
/ansys_inc/v190/ans_uninstall190

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/v190/ansys/bin/ans_admin190

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 19.0 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 59
 Release 19.0 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
60 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 installation
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.

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. Use a USB Flash drive or follow the instructions in Mounting the

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

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 ANSLIC_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 installation
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.

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, re-
gardless of the file dates, re-run the installation with the -nodatecheck option. We strongly re-

Release 19.0 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
62 of ANSYS, Inc. and its subsidiaries and affiliates.
 Installation Troubleshooting - Mechanical APDL

commend that you exercise caution when running the installation with the -nodatecheck 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, ANSYS190_DIR environment variable is not set. This is a fatal error – exiting.

This message indicates that the ANSYS190_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 19.0 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 in-
stalling ANSYS products.

9.2. Installation Troubleshooting - Mechanical APDL

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

9.2.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.2.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/v190/an-
sys/gui/en-us/UIDL subdirectory.
ls -l /ansys_inc/v190/ansys/gui/en-us/UIDL/menulist.ans

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

The system should respond with:

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

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

9.2.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
directory is C:\Documents and Settings\<user name>\Application Data\AN-
SYS\v190\launcher on Windows or ~/.ansys/v190/launcher on Linux.

9.2.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.2.4.1. Intel Linux 64 Systems

Input/Output Error 177: Create Failure

In Procedure: fappnd

At Line: 72

Statement: Formatted WRITE

Unit: 19

9.2.4.2. Intel EM64T Linux x64 Systems

forrtl: Permission denied

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

9.2.4.3. AMD Opteron Linux x64 Systems

***ERROR

Release 19.0 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
64 of ANSYS, Inc. and its subsidiaries and affiliates.
 Contacting Technical Support

Unable to open file /build/v190/ansys/objs/file.err for WRITE. Check directory and file permissions.

9.3. Installation Troubleshooting - ANSYS Workbench

9.3.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 re-
launch 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.

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

9.4. Installation Troubleshooting - ANSYS CFX

9.4.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.5. Contacting Technical Support

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

ANSYS Contacts & Locations can be accessed from http://www.ansys.com/about-ansys/contacts-and-

locations.

Release 19.0 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 65
 Release 19.0 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
66 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
CFX (includes ANSYS CFD-Post) -cfx Workbench [1], CFX, CFD-Post
Chemkin -chemkinpro Workbench [1], Chemkin
Energico -energico Workbench [1], Chemkin,
Energico
Model Fuel Library (Encrypted) -mfl Workbench [1], Chemkin, Model
Fuel Library (Encrypted)
Reaction Workbench -reactionwb Workbench [1], Chemkin,
Reaction Workbench
EnSight -ensight Ensight, Workbench [1]
FENSAP-ICE -fensapice Workbench [1], FENSAP-ICE,
CFD-Post
Fluent (includes ANSYS CFD-Post) -fluent Workbench [1], Fluent, CFD-Post
Forte -forte Workbench [1], Forte
Polyflow (includes ANSYS -polyflow Workbench [1], CFD-Post,
CFD-Post) Polyflow
TurboGrid -turbogrid Workbench [1], TurboGrid
ICEM CFD -icemcfd Workbench [1], ICEM CFD
Structural Mechanics
Customization Files -ansyscust Workbench [1], Mechanical
APDL User-Programmable
Feature
Mechanical Products -mechapdl Workbench [1], Mechanical
APDL, ECAD, ANSYS Composite
PrepPost
ANSYS Additional Tools
Composite PrepPost -acp ACP Only

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

Product Install Option Silent Install What is Included?

Option
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, and Remote Solve Manager.

Release 19.0 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
68 of ANSYS, Inc. and its subsidiaries and affiliates.