Install Help

Installation and Licensing Documentation
Release 2019 R1
January 2019
Copyright and Trademark Information
© 2018 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 CONFIDENTIAL AND PROPRIETARY PRODUCTS OF ANSYS, INC., ITS SUBSIDIARIES, OR LICENSORS.
The software products and documentation are furnished by ANSYS, Inc., its subsidiaries, or affiliates
under a software license agreement that contains provisions concerning non-disclosure, copying, length
and nature of use, compliance with exporting laws, warranties, disclaimers, limitations of liability, and
remedies, and other provisions. The software products and documentation may be used, disclosed,
transferred, or copied only in accordance with the terms and conditions of that software license
agreement.
ANSYS, Inc. and ANSYS Europe, Ltd. are UL registered ISO 9001: 2015 companies.
U.S. Government Rights
For U.S. Government users, except as specifically granted by the ANSYS, Inc. software license agreement,
the use, duplication, or disclosure by the United States Government is subject to restrictions stated in
the ANSYS, Inc. software license agreement and FAR 12.212 (for non-DOD licenses).
Third-Party Software
See the legal information in the product help files for the complete Legal Notice for ANSYS proprietary
software and third-party software. If you are unable to access the Legal Notice, contact ANSYS, Inc.
Published in the U.S.A.

Licensing Guide
ANSYS, Inc. Release 2019 R1

Southpointe January 2019
2600 ANSYS Drive 000409
Canonsburg, PA 15317 ANSYS, Inc. and
ansysinfo@ansys.com ANSYS Europe,
Ltd. are UL
http://www.ansys.com registered ISO
(T) 724-746-3304 9001: 2015
(F) 724-514-9494 companies.
Revision Information
The information in this guide applies to all ANSYS, Inc. products released on or after this date, until superseded
by a newer version of this guide.
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.
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).
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.

Table of Contents
Preface ........................................................................................................................................................ ix
1. Introduction ............................................................................................................................................ 1
1.1. Explanation of Licensing Terms ......................................................................................................... 1
1.1.1. The FlexNet License Manager Daemon (lmgrd) ......................................................................... 2
1.1.2. The Vendor Daemon (ansyslmd) ............................................................................................... 2
1.1.3. ANSYS Licensing Interconnect (ansysli_server) .......................................................................... 2
1.1.4. The License File ........................................................................................................................ 3
1.1.4.1. Product to License Feature Mapping ................................................................................ 3
1.1.4.2. License File Format .......................................................................................................... 3
1.1.4.2.1. SERVER Lines .......................................................................................................... 4
1.1.4.2.2. VENDOR Lines ......................................................................................................... 4
1.1.4.2.3. INCREMENT Lines ................................................................................................... 5
1.1.5. The License Server Machines .................................................................................................... 5
1.1.5.1. Selecting License Server Machines ................................................................................... 6
2. Basic Licensing Setup .............................................................................................................................. 7
2.1. Accessing the ANSYS License Manager Installation Software .............................................................. 7
2.1.1. Downloading the Installation Files ............................................................................................ 7
2.2. Installing the License Manager .......................................................................................................... 8
2.2.1. License Manager Installation Prerequisites ................................................................................ 9
2.2.2. License Manager Installation Instructions - Windows ................................................................. 9
2.2.3. License Manager Installation Instructions - Linux .................................................................... 11
2.3. Adding Licenses .............................................................................................................................. 12
2.4. Configuring the License Server ........................................................................................................ 13
2.4.1. Specifying Firewall Settings .................................................................................................... 13
2.5. License Server Administrative Functions .......................................................................................... 13
2.5.1. Starting the ANSYS License Manager ...................................................................................... 13
2.5.2. Stopping the ANSYS License Manager .................................................................................... 13
2.5.3. Viewing FlexNet Licenses ........................................................................................................ 14
2.5.4. Displaying the FlexNet License Status ..................................................................................... 14
3. End-User Configuration ........................................................................................................................ 15
3.1. Client Licensing .............................................................................................................................. 15
3.1.1. Specify the License Server Machine ........................................................................................ 15
3.1.1.1. License Files Settings Precedence .................................................................................. 17
3.1.2. Establishing User Licensing Preferences .................................................................................. 18
3.1.2.1. Migrating Custom User Licensing Preferences ................................................................ 19
3.1.3. Borrowing Application Licenses on Windows .......................................................................... 20
3.1.4. Gather Client Diagnostic Information ...................................................................................... 21
3.2. ANSYS Workbench Licensing Methods ............................................................................................ 22
3.3. Client Environment Variable Settings ............................................................................................... 25
4. HPC Licensing ........................................................................................................................................ 27
4.1. HPC Parametric Pack Licensing ........................................................................................................ 28
5. Post-Installation Instructions ............................................................................................................... 31
5.1. Start the ANSYS License Manager at System Boot Time .................................................................... 31
5.2. Starting the ANSYS Licensing Tomcat Server at System Boot Time .................................................... 32
6. Installation Options .............................................................................................................................. 35
6.1. Silent License Manager Installation Instructions ............................................................................... 35
6.2. Uninstalling the ANSYS License Manager ......................................................................................... 36
7. Configuration Options .......................................................................................................................... 39
7.1. Configuring TCP/IP .......................................................................................................................... 39
7.1.1. Changing the Default ANSYS Licensing Interconnect and FlexNet Port Numbers ..................... 40
Release 2019 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. iii
Licensing Guide
7.2. Advanced Licensing Configuration Options ..................................................................................... 40

7.3. Modify License Manager Startup Options ........................................................................................ 41
7.4. Create a Group (Linux Only) ............................................................................................................ 42
7.4.1. Defining Group Restrictions for the Licensing Interconnect ..................................................... 42
7.5. Specify User Privileges .................................................................................................................... 43
7.6. Specifying the License Server and License Files ................................................................................ 43
7.7. Setting Up Redundant (Triad) Servers .............................................................................................. 44
8. License Server Administration Using ANSYS License Management Center ......................................... 47
8.1. ANSYS License Management Center Browser Requirements ............................................................. 47
8.2. Accessing the ANSYS License Management Center .......................................................................... 47
8.3. Using the ANSYS License Management Center ................................................................................ 48
8.3.1. Adding a License .................................................................................................................... 48
8.3.2. Starting the ANSYS License Manager ...................................................................................... 49
8.3.3. Stopping the ANSYS License Manager .................................................................................... 50
8.3.4. Rereading the License Manager Settings ................................................................................ 51
8.3.5. Displaying the License Server Machine Hostid Information ...................................................... 52
8.3.6. Viewing FlexNet Licenses ........................................................................................................ 52
8.3.7. Viewing the Licensing Interconnect Log ................................................................................. 53
8.3.8. Viewing the FlexNet Debug Log ............................................................................................. 53
8.3.9. Viewing the ANSYS License Management Center Log .............................................................. 54
8.3.10. Viewing the Current License Usage ....................................................................................... 54
8.3.11. Viewing the License Usage History ........................................................................................ 55
8.3.12. Viewing the Peak License Usage ........................................................................................... 56
8.3.13. Viewing License Denials ....................................................................................................... 57
8.3.14. Displaying the FlexNet License Status ................................................................................... 58
8.3.15. Gathering Diagnostic Information ........................................................................................ 58
8.3.15.1. Gathering Diagnostic Information outside of ANSYS License Management Center ........ 58
8.3.16. Displaying Queued Licenses ................................................................................................. 59
8.3.17. Specifying the License Manager Run Mode ........................................................................... 60
8.3.18. Accessing the Help Options .................................................................................................. 61
8.4. Enabling Secure Connections to the Web Server (Optional) .............................................................. 61
8.4.1. Understanding Certificates ..................................................................................................... 61
8.4.2. Configuring Tomcat Using Keytool .......................................................................................... 62
8.4.2.1. Preparing the Certificate Keystore .................................................................................. 62
8.4.2.2. Editing the Tomcat Configuration File ............................................................................. 63
8.5. Modifying the Tomcat Port Number ................................................................................................ 64
8.6. Changing the Version of Java Used by ANSYS License Management Center ...................................... 65
8.6.1. Changing the Java Version During a New Installation of ANSYS License Manager ..................... 65
8.6.2. Changing the Java Version on an Existing Installation of ANSYS License Manager .................... 65
9. License Administration Using the ANSLIC_ADMIN Utility .................................................................... 67
9.1. Using the ANSLIC_ADMIN Utility ..................................................................................................... 67
9.1.1. Launch the ANSYS License Management Center ..................................................................... 69
9.1.2. Set License Preferences for User .............................................................................................. 69
9.1.3. Run the ANSYS Borrow Utility ................................................................................................. 70
9.1.3.1. Setting up License Borrowing ........................................................................................ 70
9.1.4. Set Site Preferences ................................................................................................................ 71
9.1.4.1. Specify Product Order .................................................................................................... 71
9.1.4.2. Modify Startup Options ................................................................................................. 72
9.1.4.3. Specify License Servers to Cache .................................................................................... 73
9.1.5. View Status/Diagnostic Options .............................................................................................. 74
9.1.5.1. Display the License Status .............................................................................................. 74
9.1.5.2. Display Queued Licenses ............................................................................................... 74
iv of ANSYS, Inc. and its subsidiaries and affiliates.
Licensing Guide
9.1.5.3. Display the Customer Number ....................................................................................... 75

10. Using Dongles with the ANSYS License Manager ............................................................................... 77
10.1. Assumptions, Restrictions, and Notes ............................................................................................. 77
10.2. File Information and Supported Dongle Driver Versions ................................................................. 78
10.3. Supported Platforms ..................................................................................................................... 79
10.4. Windows Procedures ..................................................................................................................... 79
10.4.1. Installing/Updating the Dongle Driver on Windows ............................................................... 79
10.4.2. Removing an Existing Dongle Driver on Windows ................................................................. 80
10.5. Linux Procedures .......................................................................................................................... 81
10.5.1. Installing/Updating the Dongle Driver on Linux .................................................................... 81
10.5.2. Removing an Existing Dongle Driver on Linux ....................................................................... 83
10.6. Dongle Troubleshooting ............................................................................................................... 83
11. Troubleshooting .................................................................................................................................. 85
11.1. Getting Additional License Debug Information .............................................................................. 85
11.2. Gathering Diagnostic Information ................................................................................................. 86
11.3. Problem Situations ........................................................................................................................ 87
11.3.1. License Manager Will Not Start ............................................................................................. 87
11.3.1.1. License Manager Will Not Start After Adding a License File ............................................ 88
11.3.2. License Manager Will Not Stop .............................................................................................. 89
11.3.3. License Manager Will Not Stop in a Three-Server Environment ............................................... 89
11.3.4. License Manager Installation's Licensing Configuration Step to Update Site Preferences (Product
Order) Fails ..................................................................................................................................... 89
11.3.5. The Application Does Not Show the Correct License(s) .......................................................... 90
11.3.6. FlexNet Log File Shows Unexpected Messages When the License Manager Is Stopped ........... 90
11.3.7. Unable to Check Out Licenses ............................................................................................... 91
11.3.8. Jobs Abort When a License Manager Goes Down in Three-Server Environment ...................... 92
11.3.9. Licensing Log File Not Created .............................................................................................. 92
11.3.10. Queuing Does Not Work ..................................................................................................... 93
11.3.11. No Licensing Interconnect or FlexNet Path Available from Display the License Status Op-
tion ................................................................................................................................................ 93
11.3.12. Unable to Retrieve License Preferences in ANSLIC_ADMIN ................................................... 93
11.3.13. Cannot Enter Data in Text Fields .......................................................................................... 94
11.3.14. Design Point Project Locks Reserved Licenses During a Hang .............................................. 94
11.3.15. See a “File Not Found” Message When Running a Licensing Utility ........................................ 95
11.3.16. Cannot See Attached Dongle .............................................................................................. 95
11.3.17. Unable to Run a Bookmarked Version ANSYS License Management Center .......................... 96
11.3.18. Unable to View PDF Files in ANSYS License Management Center ......................................... 96
11.3.19. Unable to Search PDF Files in ANSYS License Management Center ...................................... 96
11.3.20. Starting ANSYS License Management Center Causes Error Messages (Linux Only) ................ 96
11.3.21. Manually Changing the Tomcat Port Number ...................................................................... 97
11.3.22. Cannot Access a License After Disconnecting from VPN ....................................................... 97
11.3.23. The ANSYS Licensing Interconnect Shuts Down Unexpectedly ............................................. 97
11.4. Licensing Error Messages .............................................................................................................. 97
11.5. License Manager Installation Directory Errors ............................................................................... 103
11.6. ANSYS License Borrowing Errors .................................................................................................. 104
11.7. FlexNet License Log File Errors ..................................................................................................... 105
11.8. Contacting Technical Support ...................................................................................................... 106
Glossary ................................................................................................................................................... 107
Index ........................................................................................................................................................ 113
of ANSYS, Inc. and its subsidiaries and affiliates. v
vi of ANSYS, Inc. and its subsidiaries and affiliates.
List of Tables
1.1. FlexNet Versions ..................................................................................................................................... 1
4.1. ANSYS HPC Pack Licenses Distribution ................................................................................................... 27
4.2. HPC Parametric Pack Simultaneous Design Points .................................................................................. 28
5.1. License Manager Automatic Startup Instructions ................................................................................... 31
5.2. Removing License Manager Automatic Startup Instructions ................................................................... 32
5.3.Tomcat Automatic Startup Instructions .................................................................................................. 33
5.4. Removing Tomcat Automatic Startup Instructions ................................................................................. 33
7.1. Configuring TCP/IP ................................................................................................................................ 39
10.1. 64-bit Windows File Information and Supported Dongle Driver Version ................................................ 78
10.2. 64-bit Linux File Information and Supported Dongle Driver Version ...................................................... 78
10.3. 64-bit Windows Support ..................................................................................................................... 79
10.4. 64-bit Linux Support ........................................................................................................................... 79
of ANSYS, Inc. and its subsidiaries and affiliates. vii
viii of ANSYS, Inc. and its subsidiaries and affiliates.
Preface
This document contains information for running the ANSYS License Manager.
Supported Hardware Platforms

This document details information about running the ANSYS License Manager on the hardware platforms
listed below. The name in parentheses indicates the directory name for each platform (referred to as
<platform> throughout this document).
• Linux x64 (linx64)
• Windows x64 (winx64)
For specific operating system requirements, refer to the installation guide for the platform you are
running. For platform support information, see the Platform Support section of the ANSYS Website.
Intended Audience
The ANSYS Licensing Guide is intended for the person responsible for licensing administration of ANSYS,
Inc. products at a site. This person is typically the system administrator. End users of the product may
also find this information useful, especially the End-User Configuration (p. 15) section.
Summary of New and Changed Features

Listed below is a summary of those licensing items that are either new or have been changed since the
last release. For a list of all major new and changed features of any product, see the Release Notes
document for that product.
• The current version of Tomcat utilized by the ANSYS License Management Center is 9.0.12.
• The current version of Java utilized by the ANSYS License Management Center is 1.8.0_181.
• The current version of OpenSSL utilized with the ANSYS Licensing Interconnect is 1.1.0i.
• The ANSYS License Manager now supports the ANSYS Motion family of products.
of ANSYS, Inc. and its subsidiaries and affiliates. ix
x of ANSYS, Inc. and its subsidiaries and affiliates.
Chapter 1: Introduction
ANSYS, Inc. uses the FlexNet license manager for all of its licensed products. FlexNet is best known for
its ability to allow software licenses to be available (or float) anywhere on a network.
The ANSYS License Manager uses the following versions of FlexNet:
Table 1.1: FlexNet Versions
Platform FlexNet LMGRD Version

Version
Windows Version 11.13.1.3
11.13.1.2
Linux Version 11.13.1.3
11.13.1.2
The communication between the ANSYS applications and FlexNet occurs through an intermediary
process called the ANSYS Licensing Interconnect. The Licensing Interconnect is nearly transparent; you
should not see any noticeable difference in your day-to-day operation of ANSYS products.
To get the full set of files necessary to set up a license server, you will need to run the license manager
installation. For detailed installation instructions, see Installing the License Manager (p. 8).
License administration functions are performed via the ANSYS License Management Center and the
ANSLIC_ADMIN utility (server and client). For more information on the using these tools, see License
Server Administration Using ANSYS License Management Center (p. 47) and License Administration
Using the ANSLIC_ADMIN Utility (p. 67).
Compatibility with Other FlexNet-Licensed Software

Because of FlexNet's popularity, you may have FlexNet licenses from more than one vendor. We do not
recommend or support running the ANSYS License Manager with license files that have been combined
with other software vendors' license files.
Links to FlexNet
For more information on using FlexNet refer to the FlexNet License Administration Guide. You can access
this document from the ANSYS License Management Center.
1.1. Explanation of Licensing Terms

The main components of ANSYS licensing are:
• The ANSYS License Manager, including:
– FlexNet license manager daemon (lmgrd)
of ANSYS, Inc. and its subsidiaries and affiliates. 1
Introduction
– Vendor daemon (ansyslmd)
– Licensing Interconnect (ansysli_server) -- Also includes ansysli_monitor, which ensures

that the license server is functioning correctly and attempts to correct the situation if the license
server is not running or is unresponsive.
• License files
• License server machines
These components are explained in more detail in the following sections.
The ANSYS License Manager monitors what products are being run, who is running them, and from
what computer system. It grants or denies permission to run products. When an ANSYS product begins,
it requests permission to execute from a license server. The ANSYS License Manager checks the pool
of available licenses and grants the request only if the required licenses are available. For each request
that is granted, the licenses are removed from the pool. As each product execution ends, its licenses
are returned to the pool.
1.1.1. The FlexNet License Manager Daemon (lmgrd)

lmgrd is one of the FlexNet components of the ANSYS License Manager. Its primary purpose is to start
and maintain the vendor daemon (ansyslmd). It also refers application checkout requests to the vendor
daemon (ansyslmd).
lmgrd must be running on the license server machine to run ANSYS, Inc. products.
1.1.2. The Vendor Daemon (ansyslmd)

Each vendor who has a FlexNet-licensed product on the network has one process, called the vendor
daemon. The vendor daemon keeps track of how many licenses are checked out, and who has them.
The ANSYS vendor daemon is ansyslmd.
Client programs, including ansysli_server, communicate with ansyslmd, usually through TCP/IP
network communications. The vendor daemon (ansyslmd) is started by lmgrd. The vendor daemon
ansyslmd must be running on the license server machine to run ANSYS, Inc. products.
1.1.3. ANSYS Licensing Interconnect (ansysli_server)

The ANSYS Licensing Interconnect (ansysli_server) is an intermediary process that communicates
with the FlexNet component of the license manager to authenticate and process all license requests.
In a typical configuration, the ANSYS Licensing Interconnect starts the FlexNet component lmgrd,
which then starts ansyslmd.
With the Licensing Interconnect, your license file and license options file are still applicable and in effect.
Using an intermediary process allows us to seamlessly integrate our full range of product offerings to
continually offer you access to the latest products with minimal disruption to your licensing environment.
It also allows us a platform on which to enhance important licensing features.
The Licensing Interconnect must be running on the license server machine to run ANSYS, Inc. products.
2 of ANSYS, Inc. and its subsidiaries and affiliates.
Explanation of Licensing Terms
1.1.4. The License File

Licensing data is stored in a text file called the license file. The license file is created by ANSYS, Inc. and
is installed by the license administrator. It contains information about the server machines and vendor
daemon, and at least one line of data (called INCREMENT lines) for each licensed product. Each INCRE-
MENT line contains a license key based on the data in that line and other vendor-specific information.
1.1.4.1. Product to License Feature Mapping

"Product to License Feature Mapping" refers to which license features are included with each product.
A complete list of the products and license features can be found in the, ANSYS, Inc. Product to License
Feature Mapping table.
To access this table:
1. Log onto the ANSYS Customer Portal.
2. Click Downloads>Installation and Licensing Help and Tutorials.
3. Click Licensing. The most up-to-date ANSYS, Inc. Product to License Feature Mapping table can be
found here.
Note that the information contained in the Product to License Feature Mapping table was previously
included in the Product Variable Table section of the ANSYS Licensing Guide.
1.1.4.2. License File Format

License files usually begin with a SERVER line followed by a VENDOR line, followed by one or more IN-
CREMENT lines. Each INCREMENT line contains a license key based on the data in that line, the hostids
specified in the SERVER lines, and other vendor-specific data.
You can modify only these data items in the license file; all other items must remain unchanged:
• System host names on the SERVER line(s)
• Port numbers on the SERVER line(s)
Note
If you change the FlexNet port number, then you must also change the FlexNet port
number that is specified in the ansyslmd.ini file (see Specify the License Server
Machine (p. 15)) or in the ANSYSLMD_LICENSE_FILE environment variable on all
client machines to match the port number specified in the SERVER line.
• Vendor daemon file paths on the VENDOR line(s)
• Options file paths on the VENDOR line(s)
• Optional port numbers on the VENDOR line(s) (for firewall support only)
Long lines normally use the "\" line-continuation character to break up long lines. A space character
must precede the line-continuation character.
Introduction
1.1.4.2.1. SERVER Lines

The SERVER line specifies the hostname and hostid of the license server machine and the lmgrd port
number. Normally a license file has one SERVER line. Three SERVER lines mean that you are using re-
dundant servers. License administrators do not have the option of deleting SERVER lines from a license
file because the hostids from all of the SERVER lines are computed into the license keys on every INCRE-
MENT line.
The following is an example of a server line:

SERVER enterprise 0800967f42 1055
where:
enterprise is the license server machine host name. The Linux hostname or uname -n command
returns the hostname. On Windows systems, ipconfig /all returns the host name. This can also
be an IP address (nnn.nnn.nnn.nnn format).
0800967f42 is the hostid returned by the Get System Hostid Information option of the ANSYS Li-
cense Management Center.
1055 is the ANSYS default port number for FlexNet TCP. If port 1055 is already in use on your system,
you can change this value.
1.1.4.2.2. VENDOR Lines

The VENDOR line specifies the vendor daemon's name and path. lmgrd uses this line to start the vendor
daemon, and the vendor daemon reads it to find its options file. The format of the VENDOR line is
shown below.
VENDOR ansyslmd [vendor_daemon_path]
[[options=]options_file_path] [[port=]port]
where:
ansyslmd is the name of the ANSYS vendor daemon.
vendor_daemon_path is the path to the executable for this daemon. This path is optional. ANSYS,
Inc. does not supply this field because lmgrd will look for the vendor daemon ansyslmd executable
in the directory where lmgrd is located and all ANSYS products install both of these daemons into the
same directory.
Note
If you do supply this path and the path includes spaces, enclose the entire directory path in
double quotes.
options_file_path is the full path to the end-user options file for this daemon. FlexNet does not
require an options file. The options file need not be specified on this line. As long as the options file
ansyslmd.opt is located in the same directory as the license file (the license_files directory), the
vendor daemon will automatically find and use it.
port is the vendor daemon port number. Note: This is for firewall support only and is otherwise not re-
commended. In the following example, #### would be replaced with the port number you choose:
Explanation of Licensing Terms
VENDOR ansyslmd options="C:\Program Files\ANSYS Inc\Shared Files\

Licensing\ansyslmd.opt" port=####
1.1.4.2.3. INCREMENT Lines

An INCREMENT line describes the license to use a product. The syntax of the INCREMENT line is:
INCREMENT feature ansyslmd feat_version exp_date #lic key
[VENDOR_STRING="vendor_str"] [ISSUED="..."] [START="..."] [SIGN2="..."]
A sample license file is shown here. This file is for 15 ANSYS Mechanical Enterprise tasks.
SERVER gagh 690daec6 1055
VENDOR ansyslmd
INCREMENT ansys ansyslmd 9999.9999 30-sep-2018 15 8C59A481BA50 \
VENDOR_STRING=customer:00012345 ISSUED=10-sep-2017 \
START=10-sep-2017 SIGN2=”007B AC4B D3A2 \
E623 DC66 BC38 7B31 CE00 0055 DE8D 0E27 C6FD 6C07 EE27 BBCC"
where:
• gagh is the hostname of the license server
• 690daec6 is the hostid
• 1055 is the FlexNet port number
• ansyslmd is the vendor daemon
• ansys is the license feature representing ANSYS Mechanical Enterprise
• 9999.9999 indicates that the maintenance agreement is not applicable. Otherwise, this is highest sup-
ported build date for the application.
• 30-sep-2018 is the expiration date
• 15 is the number of tasks for ANSYS Mechanical Enterprise
• 8C59A481BA50 is the encryption key for ANSYS Mechanical Enterprise
• customer:00012345 is the customer number
• ISSUED=10-sep-2017 is the date the license was created
• START=10-sep-2017 is the start date
• SIGN2=<” fifteen 4 character segments” > is the TRL encryption
Note
Some INCREMENTS have additional SIGN and SIGN2 encryption to support ANSYS
Electronics products.
1.1.5. The License Server Machines

License administration is controlled from specific computers on the network called license server ma-
chines. License server machines run the license manager, which controls access to all licenses.
Introduction
The server machines are designated by you--the end user. You have the option of designating one
server or three servers. In a one-server network, if the server machine goes down, the licenses are no
longer available for use until the server machine is back in service. In a three-server (redundant triad)
network, as long as two of the three machines are still running, the licenses are still available for use.
The master server actually controls the license administration. If a network has only one server machine,
then that server machine is automatically the master server. In a three server environment, the order
of the SERVER lines in the license file determines which server is the master. The order of the servers
must match on all machines in a three server environment. The first is the master, the second is the first
backup, etc. If the order of the SERVER lines does not match on the three servers, then the servers will
attempt to determine the master server; however, this attempt may not be successful. In a three-server
network, if the master server is unavailable, then the first backup acts as the master.
1.1.5.1. Selecting License Server Machines

Before running any ANSYS, Inc. software, you must select which machine(s) will be license servers, and
provide the hostid and hostname of those machines to ANSYS, Inc. Use the Get System Hostid Inform-
ation option of the ANSYS License Management Center to capture the necessary system information
and create the text file, which then needs to be forwarded to your ANSYS sales representative.
Consider the following points when deciding which computer(s) will be used as server(s):
• All files used in conjunction with the license manager software must be located on a disk that is physically
local to the server computer(s).
• Computers must have a high-speed, reliable Ethernet connection.
• Computers that experience extremely high levels of network traffic or processing lags due to high CPU
and/or I/O usage are poor candidates for servers.
• Do not use computers that are frequently rebooted as servers.
• Do not enable “sleep mode” for the computer you are using as a license server. Client computers are not
able to connect with a license server that is in sleep mode.
• The license server machine must have a static IP address.
• We do not allow the use of wide area networks (WANs) for license servers (with the standard ANSYS contract).
• If using a three-server network, we recommend that you choose three machines that are of the same platform
type (that is, three Linux or three Windows machines).
• If using a three-server network, we highly recommend that all three server machines be on the same subnet
in the same physical location.
If these guidelines are not followed, the ability of the ANSYS License Manager to perform consistently
will be compromised.
Caution
Do not change the date on the license server machine. Doing so will prohibit the ANSYS
product from running. Restoring the system to its original state prior to the date change
may require significant effort.
Chapter 2: Basic Licensing Setup
The following sections describe the basic steps required to set up your license server. These instructions
follow the ANSYS Licensing Life-Cycle below.
ANSYS Licensing Life-Cycle
The following sections provide basic installation and adminstration instructions for the ANSYS License
Manager. These instructions follow the ANSYS Licensing Life-Cycle.
2.1. Accessing the ANSYS License Manager Installation Software
2.2. Installing the License Manager
2.3. Adding Licenses
2.4. Configuring the License Server
2.5. License Server Administrative Functions
2.1. Accessing the ANSYS License Manager Installation Software

The ANSYS License Manager installation software can be downloaded from the ANSYS customer site
Download Center or obtained on USB media. To download the software, you need an account on the
ANSYS customer site. If you do not have an account, you may register at www.ansys.com/customercom-
munity to receive your own account.
2.1.1. Downloading the Installation Files

To download the ANSYS License Manager installation files, you need to have a current technical support
agreement.
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. Expand the Tools option by clicking the + to the right of the title.
4. Click the Full Package option for the ANSYS License Manager.
Basic Licensing Setup
5. Select your desired download directory and click Save.
6. After the download is complete, uncompress the package using standard uncompression utilities for your
specific platform. We strongly recommend that you extract the files into new, temporary directories.
7. Begin the license manager installation as described in Installing the License Manager (p. 8).
2.2. Installing the License Manager

You must install the license manager software on your server machine(s) at this release in order to be
able to run ANSYS, Inc. products. If you do not install the license manager at this release, your ANSYS,
Inc. products may not run. You will find detailed instructions for installing the license manager on your
server machines later in this chapter.
Note
If you want to run multiple releases of ANSYS, Inc. software, you MUST install them chrono-
logically (i.e., Release 19.2 followed by Release 2019 R1). If you install an earlier release after
installing Release 2019 R1, you will encounter licensing issues that may prevent you from
running any products/releases. If you need to install an earlier release after you have already
installed Release 2019 R1, you must uninstall Release 2019 R1, then re-install the releases in
order.
When you run the license manager installation on the license servers, the licensing installation process
will install all necessary files, as well as set the ANSYSLIC_DIR environment variable in the product-run
scripts. If there is an existing license manager, the installation process will shut it down, so you should
verify that no users will be affected while you run the installation.
Note that the FLEXlm for Ansoft (ansoftd) license manager will also be shut down and uninstalled if it’s
running; all associated license files will be migrated over to the ANSYS License Manager. Once migrated,
you will no longer be able to run the ANSYS License Manager and the FLEXlm for Ansoft License Manager
on the same system.
To support the ANSYS License Management Center, a Tomcat web server and Java will be installed
within the license manager directory during the ANSYS License Manager installation. To view the latest
Tomcat and Java versions installed, access the View Licensing Configuration Details option described
in Accessing the Help Options (p. 61).
Run the license manager installation on all machines that will act as license servers.
Linux Server Installation Notes: If you are installing the License Manager on the same machine
where the product will be run, use the same top level directory path for both the product installation
and the License Manager installation. We strongly recommend that you install the licensing files relative
to the product installation directory to avoid manually editing the product run scripts.
A typical product installation on a Linux machine allows you to install the product anywhere on the
system and then creates a symbolic link from the installation directory to /ansys_inc. If you did not
set the symbolic link during the product installation, or if you installed the licensing files somewhere
other than relative to the installation directory, replace all references to /ansys_inc in this guide
with the name of the installation directory you used. Any reference throughout this manual to the li-
censing directory on Linux platforms means /ansys_inc/shared_files/licensing.
Installing the License Manager
On Linux systems, you can install without administrative privileges but you may encounter permission
problems during the installation.
Windows License Server Installation Notes: The licensing installation on a Windows machine installs
all necessary licensing files into the \Program Files\ANSYS Inc\Shared Files directory by
default, located on the same drive as the operating system or the directory where you installed a pre-
vious license manager release, regardless of where your product installation resides. You must have
administrative privileges on your machine to install the license manager.
Any reference throughout this manual to the licensing directory on Windows platforms means \Program
Files\ANSYS Inc\Shared Files\Licensing, located on the same drive as the operating system.
If you choose to install the ANSYS License Manager to a different location, you must replace any refer-
ences to \Program Files\ANSYS Inc\Shared Files\Licensing with the directory where
you installed the license manager.
2.2.1. License Manager Installation Prerequisites

We recommend that you have the following information available before you begin this installation:
• Your license file from ANSYS, Inc., saved to a temporary directory. Existing customers may not be supplied
with new licenses for the current release. They will be supplied when the current licenses expire or when
TECS expires. For more information, see Adding Licenses (p. 12).
• Open port numbers for FlexNet 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 -p tcp
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, unless they are freed.
• Verify that you are running on a supported platform.
• Verify that you have sufficient disk space to download, uncompress, and install the license manager.
• When installing ANSYS License Manager on Red Hat Enterprise Linux 7 and CentOS, the redhat-lsb, libpng12
and compat-libtiff3 libraries are required.
2.2.2. License Manager Installation Instructions - Windows

Follow the instructions below to install the ANSYS License Manager on Windows systems that will act
as license servers.
1. Right-click the setup.exe file and select Run as administrator. If you downloaded the license manager
installation package, this file will reside in the directory where you unzipped the files. If you are running
from media, this file will reside in the top level of the media.
2. The installation launcher appears. Choose a language from the dropdown.
3. Select Install ANSYS License Manager.
4. You will be notified that the license manager (ANSYS or FLEXlm for Ansoft (ansoftd)), if running, will be
shut down. Click OK.
5. The License Agreement screen appears. Read the license agreement, and if you agree, click I Agree to
accept the terms and click Next, located on the right side of the screen. You must select I Agree to con-
tinue with the installation.
6. Specify the installation directory. You can accept the default or specify an alternate path and the directory
name where the license manager is to be installed. The installation directory is set to
<OS_Drive>\Program Files\ANSYS Inc by default. You must have administrative privileges for
the directory you specify. In addition, the directory:
• Must be a local directory
• Must be a local, fixed-media drive
• Cannot be a UNC or relative path
• Cannot be a short (8.3) file name format path
• Cannot be a symbolic link or junction
• Cannot use wide character names/paths
Note
You are not permitted to change the installation directory for a computer that currently
contains an instance of the ANSYS License Manager. To change the installation directory
location, you must first uninstall any previous versions of the product.
7. The ANSYS License Manager is the only component available and is selected to be installed. The amount
of disk space required and the disk space available appear at the bottom of the window. If the disk space
required exceeds the disk space available, be sure that you have sufficient space before continuing. The
disk space required as calculated by the installation program may be greater than the actual amount
needed. However, if you choose to continue the installation, you should carefully review any log and error
files at the end of the installation to ensure that the installation completed successfully.
Click Next to continue.
8. A summary of the selected installation data appears. Information shown includes platform, installation
directory, and product. Review the information carefully, and if correct, click Next to continue the install-
ation.
9. Once the license manager is installed, the installation program performs a “silent” licensing configuration
which includes merging your custom changes to the product order. Click Next to continue the installation.
The Launch License Management Center upon exiting option is included on the screen. The
ANSYS License Management Center is a browser-based application that centralizes many of the
ANSYS licensing administrative functions. For more information, see License Server Administration
Using ANSYS License Management Center (p. 47).
Launch the ANSYS License Management Center at this time to add a new license file.
Installing the License Manager
If you do not want to launch the ANSYS License Management Center, clear the Launch License
Management Center upon exiting option.
Note
If the installation did not complete or completed with errors, review the progress
log by clicking the View Detailed Progress Log button.
10. When the license manager installation is complete, click Exit. A new Start Menu item named ANSYS, Inc.
License Manager will be created automatically. It will include selections for the License Management
Center, the ANSYS Licensing Guide, the FlexNet License Administration Guide and the server ANSLIC_ADMIN
utility.
On Windows, if you encounter a problem during the licensing installation process that results in a failure
or abort, or if you are concerned that the licensing installation did not complete correctly, we recommend
that you re-run the License Manager installation.
2.2.3. License Manager Installation Instructions - Linux

Follow the instructions below to install the ANSYS License Manager on Linux systems that will act as
license servers. This installation expects you to be logged in as root.
1. Run INSTALL -LM to launch the license manager installation. If you downloaded the license manager
installation package, this file will reside in the directory where you untarred the files. If you are running
from media, this file will reside in the top level of the media.
2. Select a language.
3. You will be notified that the license manager (ansyslmd and/or ansoftd), if running, will be shut down.
Click OK.
accept the terms and click Next. You must select I Agree to continue with the installation.
5. The mount directory (location where the installation is located) is specified. You should accept the default.
You can also accept the default installation directory or specify an alternate path and directory name
where the license manager is to be installed. You cannot use wide character names/paths in the installation
directory.
Note
You are not permitted to change the installation directory for a computer that currently
contains an instance of the ANSYS License Manager. To change the installation directory
location, you must first uninstall any previous versions.
We recommend that you also set the symbolic link /ansys_inc to the directory where the ANSYS,
Inc. product is installed. The /ansys_inc symbolic link is set by default. The symbolic link option
is available only if you are installing as root. If you chose to set the symbolic link during the product
installation, you should set it here as well.
6. The ANSYS License Manager is the only component available and is selected to be installed by default.
The amount of disk space required and the disk space available appear at the bottom of the window. If
the disk space required exceeds the disk space available, be sure that you have sufficient space before
continuing. The disk space required as calculated by the installation program may be greater than the
actual amount needed. However, if you choose to continue the installation, you should carefully review
any log and error files at the end of the installation to ensure that the installation completed successfully.
7. A summary of the selected installation data appears. Information shown includes platform, installation
directory, and product. Review the information carefully, and if correct, click Next to continue the install-
ation.
8. Once the license manager is installed, the installation program performs a “silent” licensing configuration
which includes merging your custom changes to the product order. Click Next to continue the installation.
The Launch License Management Center upon exiting option is included on the screen. The
ANSYS License Management Center is a browser-based application that centralizes many of the
ANSYS licensing administrative functions. For more information, see License Server Administration
Using ANSYS License Management Center (p. 47).
Launch the ANSYS License Management Center at this time to add a new license file.
If you do not want to launch the ANSYS License Management Center, clear the Launch License
Note
If the installation did not complete or completed with errors, review the progress
log by clicking the View Detailed Progress Log button.
9. When the license manager installation is complete, click Exit.
On Linux, if you encounter a problem during the licensing installation process that results in a failure
or abort, or if you are concerned that the licensing installation did not complete correctly, we recommend
that you re-run the License Manager installation.
2.3. Adding Licenses

If you did not add a license when you installed the license manager or do not have a license, you should
complete the steps below:
1. If you do not have a license file, follow these steps:
a. Open the ANSYS License Management Center. For Windows, click Start>All Programs>ANSYS,
Inc. License Manager>ANSYS License Management Center and for Linux run the
/shared_files/licensing/start_lmcenter script.
b. Click the Get System Hostid Information option to display your system ID code(s).
c. Select the system ID you wish to use and click SAVE TO FILE. For more information, see .Displaying
the License Server Machine Hostid Information (p. 52).
License Server Administrative Functions
A text file containing your system ID information is created.
d. Forward this text file to your ANSYS sales representative so that a license file can be created for
you.
2. Add your license file(s)
Add your license files though the ANSYS License Management Center. For these steps, see Adding
a License (p. 48).
If you are running in a three-server environment, the license file must reside on all three servers
and must match on all three servers. Therefore, install the same license file on each machine.
2.4. Configuring the License Server

This section provides information on how to configure your license server machine (post-installation)
and modify your firewall settings to allow server communications.
2.4.1. Specifying Firewall Settings

If you use a firewall at your site and if you run ANSYS products outside the firewall but access the license
server within the firewall, you will need to add the Licensing Interconnect and FlexNet port numbers
to the exceptions list, as well as the PORT designated on the VENDOR line of the license file. By default,
these port numbers are:
Licensing Interconnect: 2325

FlexNet: 1055
PORT designated by PORT=#### on the VENDOR LINE in the ansyslmd.lic file (see VENDOR
Lines (p. 4) for information on this PORT number)
2.5. License Server Administrative Functions

This section highlights the most commonly used license administrative functions using the ANSYS License
Management Center. These functions include, starting and stopping the ANSYS License Manager, re-
reading the ANSYS License Manager settings and viewing the FlexNet license and license status.
For advanced license server adminstrative functions, see License Server Administration Using ANSYS
License Management Center (p. 47) and License Administration Using the ANSLIC_ADMIN Utility (p. 67).
2.5.1. Starting the ANSYS License Manager

To run licensed ANSYS products, the ANSYS License Manager must be running on the license server
with a valid license file.
To start the ANSYS License Manager, open the ANSYS License Management Center and click the
Start button located on the right side of the page. For more information, see Starting the ANSYS License
Manager (p. 49).
2.5.2. Stopping the ANSYS License Manager

To stop the ANSYS License Manager, open the ANSYS License Management Center and click the
Stop button located on the right side of the page. For more information, see Stopping the ANSYS License
Manager (p. 50).
2.5.3. Viewing FlexNet Licenses

To view your FlexNet licenses, open the ANSYS License Management Center and click the View
FlexNet Licenses option. You can view license files that are in use (or will be in use) in the ANSYS License
Manager.
For more information, see Viewing FlexNet Licenses (p. 52).
2.5.4. Displaying the FlexNet License Status

To display the FlexNet license status, open the ANSYS License Management Center and the click
Display FlexNet License Status option. The license server information, vendor daemon status and license
usage information are displayed in the status window, along with the users of those features.
For more information, see Displaying the FlexNet License Status (p. 58).
Chapter 3: End-User Configuration
This section is relevant to users of ANSYS products. Topics such as specifying the license server, setting
license preferences, and license borrowing are covered.
3.1. Client Licensing

Client licensing is installed automatically when the product is installed; you do not have to take any
further steps to run as a client if you have installed a product. Note that the client component will not
be installed with Electronics (Ansoft) products, nor is it needed.
From a client machine, you will have access to the client version of the ANSLIC_ADMIN utility. The
Client ANSLIC_ADMIN utility is accessed via Start > ANSYS 2019 R1 > ANSYS Client Licensing > Client
ANSLIC_ADMIN Utility 2019 R1. The Client ANSLIC_ADMIN utility should be used only to make changes
to the local machine's configuration. Changes made using the Client ANSLIC_ADMIN utility will affect
only this machine and will not affect other users.
To change the language setting locally for only the current session of the client ANSLIC_ADMIN utility,
you can launch the utility using the -lang option:
<os drive>:\Program Files\ANSYS Inc\Shared Files\Licensing\licadmin\anslic_admin
-lang language
or
/ansys_inc/shared_files/licensing/lic_admin/anslic_admin -lang language
The procedures described in the following sections are accessable through the Client ANSLIC_ADMIN
utility.
3.1.1. Specify the License Server Machine

You are asked to specify your license server during the product installation if you have not done so
during a previous product installation. If you did not specify your license server during the product in-
stallation or if your license server has changed, use the Specify the License Server Machine option
on the ANSLIC_ADMIN utility to set the ANSYS Licensing Interconnect and ANSYS FlexNet servers. Using
this option creates or updates (lists, adds, modifies, deletes, or reorders) entries in the ansyslmd.ini
file in the licensing directory for the local machine. With this option, you can specify single servers,
multiple single servers, or redundant triad servers. You also use this option to specify the Licensing In-
terconnect and ANSYS FlexNet port numbers. Run this option on every machine where you installed
an ANSYS product. We recommend using this method for specifying your license server preference.
This option is available for both the server and client versions of ANSLIC_ADMIN on Windows machines.
In most situations, you should use the client version. The client version is appropriate regardless of
where you have installed the product. You should use the server version of this option only to specify
the license server machines for Release 11.0 and lower versions. You can also use the server version to
specify license server machines if you have installed the product into <os drive>\Program Files,
but we recommend using the client version anytime you are working with the current release.
End-User Configuration
If the product is installed in <os drive>\Program Files (by a user with administrative privileges),
you must have administrative privileges in order to add or modify your server specification. If you are
running on a Windows 7 machine, you must run as an administrator, preferably with UAC turned off.
If you are running with UAC turned on, you must launch ANSLIC_ADMIN using the Run as adminis-
trator option. If you are running on a Windows 10 machine, you must run as an administrator. Addition-
ally, you must launch ANSLIC_ADMIN using the Run as administrator option. For more information,
see the User Account Control (UAC) section of the ANSYS, Inc. Windows Installation Guide for more
details on working with Windows and UAC.
To add a server:
1. Click Specify the License Server Machine.
2. Click Add Server Machine Specification.
3. Enter the ANSYS Licensing Interconnect and FlexNet port numbers (2325 and 1055 by default, respectively).
Specify the number of servers and enter the host name(s) of your license server(s). You cannot enter a
path or a filename in place of the hostname.
To specify multiple single servers, click OK on this screen after adding the first server. Then click
the Add Server Machine Specification button again and add information for the next server. Repeat
this process for each single server.
To specify redundant triad servers, click the 3-server (redundant triad) option and enter the
hostname for each of the three servers in the spaces available.
4. Click OK.
To delete a server, highlight the server in the list and click Delete Selected Server Machine.
To edit a server, click one of the listed servers and click Edit Selected Server Machine. You can then
change the ANSYS Licensing Interconnect and the FlexNet port numbers, the number of license servers,
or the hostname(s).
The ansyslmd.ini File The Specify the License Server Machine option creates or updates the an-
syslmd.ini file that is located in the licensing directory. Entries in the ansyslmd.ini file tell ANSYS,
Inc. products which license server(s) to query to find a valid license. Using this option allows all users
at your site to use this setting without having to individually set the ANSYSLMD_LICENSE_FILE or
ANSYSLI_SERVERS environment variables to specify the license server machine(s). It also eliminates
the need to have a copy of the license file on every system at your site.
The order that the SERVER lines are listed in the ansyslmd.ini file dictates the order in which the
license request is granted. To reorder the entries in the list, highlight a server and use the Move up or
Move down buttons.
You are not limited to designating one set of license server machines for your network. You can have
multiple single-server or three-server (redundant triad) licensing systems on your network. In this situation,
you would have certain licenses connected to a set of server machines (one or three) on the network,
and other licenses connected to a different set of server machines (one or three) on the network.
The format of the ansyslmd.ini file created by ANSLIC_ADMIN follows. Each server's specification
entry in this file will typically begin with ANSYSLI_SERVERS= and SERVER= to specify the Licensing In-
terconnect and FlexNet port numbers, respectively.
On a single server:
Client Licensing
ANSYSLI_SERVERS=<ansysliport>@<host>
SERVER=<flexnetport>@<host>
For multiple single servers, each server should have its own ANSYSLI_SERVERS= and SERVER= lines.
On redundant (triad) servers on Linux platforms:

ANSYSLI_SERVERS=<ansysliport>@<host1>:<ansysliport>@<host2>:<ansysliport>@<host3>
SERVER=<flexnetport>@<host1>:<flexnetport>@<host2>:<flexnetport>@<host3>
Windows platforms use semicolons (;) instead of colons:

ANSYSLI_SERVERS=<ansysliport>@<host1>;<ansysliport>@<host2>;<ansysliport>@<host3>
SERVER=<flexnetport>@<host1>;<flexnetport>@<host2>;<flexnetport>@<host3>
Do not use commas as separators; use colons (:) on Linux machines and semicolons (;) on Windows
machines.
The ANSYS Licensing Interconnect default port number is 2325 and the ANSYS FlexNet default port
number is 1055. The host is the license server hostname. For example, if the license server name is alpha1:
ANSYSLI_SERVERS=2325@alpha1
SERVER=1055@alpha1
The order of the ANSYSLI_SERVERS and the SERVER lines in the ansyslmd.ini file specifies the order
in which the requested license will be granted.
You must use the port@host format; you cannot enter a path or a filename in place of the hostname.
Overriding the ansyslmd.ini File If you want to override the server specification settings in the an-
syslmd.ini file, you can do so by setting the ANSYSLMD_LICENSE_FILE and ANSYSLI_SERVERS
environment variables on individual machines. These environment variables are useful if you want to
temporarily point to a different license server machine without disrupting the machine's configuration.
Use the ANSYSLI_SERVERS environment variable to specify the Licensing Interconnect port number.
Use the ANSYSLMD_LICENSE_FILE to specify the FlexNet port number.
If the ANSYSLMD_LICENSE_FILE environment variable is set but the ANSYSLI_SERVERS environment

variable is not set, the same server machines will be used to specify the Licensing Interconnect but the
port number will be replaced by the Licensing Interconnect default port of 2325. When both variables
are set, ANSYSLMD_LICENSE_FILE explicitly defines the FlexNet servers while ANSYSLI_SERVERS ex-
plicitly defines the Licensing Interconnect servers.
If you set the ANSYSLMD_LICENSE_FILE or ANSYSLI_SERVERS environment variables on a three-

server (redundant) system, specify all three systems in the same order as the SERVER lines are listed in
the license file. If you specify only the master and it is down, you could see a “License Server Down” or
“No License Found” message and the search for a license could fail. Join redundant or multiple single
server systems by separating the system names with colons on Linux systems and semicolons on Windows
systems.
To have your license server preference known each time you log in, set the environment variables AN-
SYSLMD_LICENSE_FILE and ANSYSLI_SERVERS (both Windows and UNIX systems). On UNIX systems,
place these environment variables in your login startup file (e.g., .cshrc file).
3.1.1.1. License Files Settings Precedence

In most cases, the Specify the License Server Machine option should be sufficient to specify the license
server. There are additional ways to specify the server.
ANSYS Licensing Interconnect settings have precedence in the following order:
1. ANSYSLI_SERVERS environment variable
2. If ANSYSLI_SERVERS is not set, use ANSYSLMD_LICENSE_FILE environment variable, replacing the

FlexNet port number with the default Licensing Interconnect port number of 2325.
3. Settings in the ansyslmd.ini file in the relative client licensing directory for ANSYSLI_SERV-
ERS=keyword
FlexNet settings have precedence in the following order:
1. ANSYSLMD_LICENSE_FILE environment variable
2. Settings in the ansyslmd.ini file in the relative client licensing directory for SERVER=keyword.
Note
The FlexNet environment variable LM_LICENSE_FILE is not supported with the ANSYS License
Manager.
3.1.2. Establishing User Licensing Preferences

Before running ANSYS, Inc. products, you should establish your licensing preferences, especially if you
have multiple licenses at your site. Use the Set License Preferences for User option of the ANSLIC_AD-
MIN utility or choose Start > ANSYS 2019 R1 > ANSYS Client Licensing > User License Preferences
2019 R1 to set your own licensing preferences. Note, preferences specified with this option apply only
to you on the computer system on which the option was run and will not affect other users at your
site.
You can use this option to review the licenses available, prioritize the licenses, and establish which li-
censes you will use. When you select this option, a dialog box opens. All licenses available to you on
your license server machine(s) are shown under the appropriate tab:
• Solver
• PrepPost
• Geometry
• HPC
You control the order in which the system attempts to check-out a license by moving the licenses up
and down in the list using the Move Up or Move Down buttons. When you open an application, the
license manager attempts to check-out the license listed first in the list. If unable to check-out that license,
then the license manager attempts to check out the next license in the list that can be used by the
application. The license manager will continue through the list until an available license is found. If
none are found, a message displays.
Client Licensing
By default, all licenses available from your license server are shown and marked as available for use. If
you do not want a particular license to be available for your use, select the license in the list, and set
the Use/Don't Use field to 0.
Note
Each time you receive a new license, you should reset your preferences. If you had previously
set your license preferences using this option, add the new license to your list in the desired
order.
If you have made changes to your license preferences, you can return the settings to the default state
by selecting the Reset to Default button.
When you have completed your changes, click OK to make the changes and close the dialog box. Click
Apply to make the changes without closing the dialog box. Selections you make here will take effect
with any new sessions/license checkouts but will not affect the current session or change the license(s)
currently in use.
If you are sending solve jobs to a remote compute cluster via Remote Solve Manager (RSM), note that
your license preferences set for your local machine (the RSM Client) may not be the same as the license
preferences set for the remote cluster machine (the Compute Server). In cases where local and remote
license preferences are different, the preferences for the local RSM Client machine will not be applied
when running on the remote Compute Server; instead, the preferences defined for the remote Compute
Server will be used. If the license preferences and/or the licensing checkout order do not make the
necessary licenses available to your remote solve, you must adjust the Compute Server preferences by
setting your license preferences on the remote machine. Remote license preferences may be defined
according to corporate IT policy, so see your license administrator about adjustments to Compute
Server preferences.
3.1.2.1. Migrating Custom User Licensing Preferences

For ANSYS Workbench users, customized user licensing preferences (if present), are automatically migrated
when you install a new ANSYS release. For example, if you already have ANSYS release 19.2 installed
on your computer and you upgrade to release 2019 R1, your customized user licensing preferences (if
present), are automatically migrated to the new version.
If you are using an ANSYS product other than workbench, you can manually migrate your customized
user licensing preferences by running the ansysli_util.exe file.
To run the ansysli_util.exe, follow the steps for your platform below:
Windows:
Where <Installation Directory> represents the path to the latest ANSYS Product install, open an admin-
istrator command prompt window and issue the following command:
"<Installation Directory>\Shared Files\Licensing\winx64\ansysli_util.exe"

-updateuserprefs -fromrevn <previous release> -torevn <new release>
Example:
"C:\Program Files\ANSYS Inc\Shared Files\Licensing\winx64\ansysli_util.exe"

-updateuserprefs -fromrevn 190 -torevn 191
Linux:
Where <Installation Directory> represents the path to the latest ANSYS Product install, open a command
line window and issue the following command:
"<Installation Directory>/shared_files/licensing/linx64/ansysli_util" -
updateuserprefs -fromrevn <previous release> -torevn <new release>
Example:
"/ansys_inc/shared_files/licensing/linx64/ansysli_util" -updateuserprefs
-fromrevn 190 -torevn 191
Note
For both the automatic and the manual user licensing preferences migration, ansysli_util
reads the ansyslmd.ini file or the ANSYSLMD_LICENSE_FILE environment variables to determine
the correct license server.
3.1.3. Borrowing Application Licenses on Windows

License borrowing (available only on Windows machines) allows a user to take a license for use outside
of the company facility, such as for an engineer to take a license home on his laptop. Before users can
take advantage of license borrowing, the site administrator needs to set up the borrowing environment
(see Run the ANSYS Borrow Utility (p. 70)).
License borrowing is available only if you have borrowable licenses and only on Windows machines;
however, the license server machine that is managing the licenses can be any system that ANSYS, Inc.
supports as a license server. You cannot run both borrowed and non-borrowed licenses simultaneously.
For example, if you borrow licenses but remain connected to a network from which you can use licenses,
you will be able to use only the borrowed licenses. Likewise, if the machine on which you borrowed li-
censes is also a license server from which you could normally use licenses, you would be able to use
only the borrowed licenses. You can borrow only one task of any particular license.
This option is available only for the client version of ANSLIC_ADMIN.
1. Connect to the network where the license server machine is running.
2. Launch the client license borrowing utility: Start > ANSYS 2019 R1 > ANSYS Client Licensing > Client
ANSLIC_ADMIN Utility 2019 R1. Select Run the ANSYS Borrow Utility.
3. On the Borrow tab, specify the version number and return date. The return date defaults to the third day
from the current date.
If you change any of the borrowing criteria, the product list will automatically update in five seconds.
To update the list immediately, click the Update Delay (sec) button.
4. Select the product(s) you want to borrow. The product list includes add-on features or geometry interfaces.
If you do not see a product listed that you think should be available, verify that you have selected the
correct version.
5. Click Borrow.
Client Licensing
6. Disconnect from the network. Note that even when you've disconnected from the network, you must still
run the products from the same account you used to borrow the licenses. For example, if you use a network
account to borrow the licenses, you cannot then run from a local account.
Be sure to verify that you can run the correct product with the borrowed licenses from your machine
AFTER you've disconnected from the network. If you encounter any difficulties, reconnect to the
network, return the license, and then re-borrow the correct license.
If you keep a license for the full amount of time, there is no need to check the license back in. Your
borrowed license will simply expire at the end of the borrow period, and the license will be released
into the pool of available licenses.
To return a license early:
1. Reconnect to the same license server from which you borrowed the license(s).
2. Launch the client license borrowing utility: Start>All Programs> ANSYS 2019 R1> ANSYS Client Licens-
ing> Client ANSLIC_ADMIN Utility 2019 R1. Select Run the ANSYS Borrow Utility.
3. Select the Return tab. Click Return all. If you want to keep some but not all of the licenses you borrowed,
you will need to re-borrow them.
4. Disconnect from the network.
The license(s) you borrowed will be returned to the pool of available licenses.
Note
You must return borrowed licenses from the same account you used to borrow the licenses
originally.
Some multi-feature products include other products and/or add-on features. The utility will automatically
check out any such included products or add-on features. If you borrow one of these multi-feature
products and then click the Return tab, you will see the product you selected, as well as any other
products and add-ons that it includes. If you return a multi-feature product early, these products and
add-on features will also be returned.
Compatibility between versions Flexera Software has created an incompatibility in license borrowing
between FlexNet releases. Since different versions of FlexNet are used at most releases, the borrowed
licenses are not compatible between different ANSYS releases. The ANSBORROW utility includes a selection
for the ANSYS version you are planning to run using the borrowed license. Choose your version carefully,
because you will only be able to run one of the versions at a time with borrowed licenses.
The ANSBORROW utility allows you to borrow either initial release or service pack (SP) versions. The SP
versions for a given platform use the same FlexNet version as the initial release; therefore, licenses se-
lected for an SP should work for the initial release.
3.1.4. Gather Client Diagnostic Information

When you choose this option, ANSLIC_ADMIN gathers various licensing-related files, logs and related
information about your license client system and places them in a single directory.
This feature is useful if you want to easily review the files from a single location, or if you need to
compress the files and send them to a technical support representative. Every time you choose to
gather these files, you are prompted to specify the path of the diagnostics directory or to accept the
default location. If you do not define the path of the diagnostics directory, the log and error files will
be copied into a new, date-stamped subdirectory in your $HOME/.ansys directory on Linux or in the
directory specified by the TEMP environment variable on Windows. Be aware when choosing this option
that some of these files can be large and could require significant disk space. You may want to delete
these directories when you are finished reviewing them because of the disk space usage.
Using the ansys_pid utility:
After all relevant files are gathered (if selected), this option runs the ansys_pid utility, which queries the
system for information that may be useful for troubleshooting certain problems. This operation may
take a few minutes. You can append this information to the session log, or you can write it out directly
to a file using the buttons at the bottom of the window.
When you run this ansys_pid utility, information about your licensing information is displayed in the
ANSLIC_ADMIN log area. Information displayed may include:
• operating system info
• environment information, including environment variable settings
• firewall information
• available license information
The contents of specific log and error files will not be displayed in the ANSLIC_ADMIN log area. You
will need to review these files individually for specific errors and other status/log information.
Note
If you have set the ANS_FLEXLM_DISABLE_DEFLICPATH environment variable, the inform-

ation will be displayed based on the ANSYSLMD_LICENSE_FILE environment variable setting;
settings in the ansyslmd.ini file in the licensing directory will NOT be used.
3.2. ANSYS Workbench Licensing Methods

ANSYS Workbench users can also specify which of two licensing methods to use:
• Share a single license between applications (default) (shared mode)
• Use a separate license for each application (separate mode)
Use the Licensing Preferences dialog box (Start > ANSYS 2019 R1 > ANSYS Client Licensing > User
License Preferences 2019 R1) to specify which method to use and which licenses to use. You must
specify the licensing method before starting an ANSYS Workbench session. If you access the Licensing
Preferences dialog box from the ANSYS Workbench Tools menu, you will not be able to choose a licensing
preference from there.
Single License Sharing ANSYS Workbench allows you to work across multiple applications and
workspaces in ANSYS Workbench while consuming only one of a single type of license per user per
session. Using shared licensing, the active application holds the license, preventing other applications
that are sharing that license from using it during that time. The application or operation requiring use
of the license is called a concurrency event. For example, meshing and solving would each be a concur-
rency event.
ANSYS Workbench Licensing Methods
Single license sharing allows you to progress through your analysis, from specifying engineering data
through building or attaching a geometry, meshing, setup, solving, and finally, reviewing your results,
all under the same license. The application holding the license must close or issue a PAUSE command,
or receive an automatic release request to release the license and allow another application to use it.
Licenses cannot be released while an application is actively performing a concurrency event (for example,
an application cannot release a license in the middle of a solve operation; the license cannot be released
until the solve operation is completed).
Single license sharing applies only to licenses of the same type (e.g., Mechanical Enterprise). Choosing
this option does not affect your ability to use licenses of different types simultaneously (e.g., Mechanical
Enterprise for one task and ANSYS CFD for another).
Because this method is the default, you do not have to take any action to run this way.
Explanation of License Type and Examples License type is primarily by license feature. It is possible
to use both a Mechanical Pro and a Mechanical Enterprise license within a single ANSYS Workbench
session.
The first license checked out within a session will be based on your preferences and what capabilities
are being requested. For all applications other than the first (subsequent) one opened (within ANSYS
Workbench), ANSYS licensing will first look at what other licenses are opened within this session. These
subsequent license requests will look at sharing first to satisfy their request: do any other licenses being
used within this session fulfill the needed capabilities? If yes, share an existing license. If not, preferences
are used and a new, different license is checked out.
Example 1: You have one license for Mechanical Enterprise and one license for Mechanical Pro, with
Mechanical Enterprise listed first in your preferences. The first application starts and only needs capab-
ilities in Mechanical Pro. Since Mechanical Enterprise contains Mechanical Pro capabilities and is first in
your preferences, Mechanical Enterprise will be checked out. The second application starts and needs
Mechanical Enterprise; since Mechanical Enterprise is already checked out, the second application will
share it with the first. Only the Mechanical Enterprise license is consumed in this session.
Example 2: You have one license for Mechanical Enterprise and one license for Mechanical Pro, with
Mechanical Pro listed first in your preferences. The first application starts and only needs capabilities
provided in Mechanical Pro, so Mechanical Pro is checked out. The second application starts and needs
capabilities provided on Mechanical Enterprise; since (the already in use) Mechanical Pro cannot satisfy
its requirements, it checks out Mechanical Enterprise. Both a Mechanical Enterprise and a Mechanical
Pro license are consumed in this session.
Restrictions of Single License Sharing You cannot run two concurrency events simultaneously (for
example, you cannot mesh one model and solve another simultaneously) with one license.
If you are using a license for one application, other applications may still not be able to share that license
if those applications require capabilities not supported by the license. For example, you cannot share
a Mechanical Enterprise license with a Fluent application.
Single License Sharing in ANSYS Workbench Applications ANSYS Workbench applications handle
single license sharing differently:
The Mechanical Application:

You can launch the Mechanical application and move between its components (such as Meshing,
Setup, and Solve). The active component will control the license while completing its operations and
will release the license as soon as the operation is completed. For example, when you mesh, the
Meshing component will control the license during the meshing operation and then immediately
release the license when the operation is completed. The other components will remain in a read-
only mode while Meshing uses the license, allowing you to view the data in other components but
not operate on it.
Note
Applications in read-only mode because of shared licensing do not refresh their li-
cense status automatically. Once the shared license is released by the editor that
had consumed it, you must trigger Mechanical to query the license status. The most
straightforward way to do this is click outside the Mechanical application window
and then click back in the window to cause the license availability to be rechecked.
The Mechanical APDL Application:

This application consumes a license as soon as you launch it, and retains that license until it is finished.
If you launch the Mechanical APDL application interactively, the license is retained until you either
close the application or issue a PAUSE command at the Mechanical APDL command line. PAUSE allows
you to temporarily release the license for another application to use. No other operation other than
SAVE or /EXIT is permitted while PAUSED. When the second application has finished and releases the
license, issue an UNPAUSE command from the Mechanical APDL command line to resume its use of
the license.
CFX, Fluent, Autodyn, Polyflow:

These applications consume a license when launched and retain the license until they receive a request
from another application to release it. For example, if you open CFX-Pre, CFX-Pre will obtain and
control the license. It will retain the license until you close the application or until another application
(such as the CFX solver) requests it.
Autodyn and Polyflow also provide a manual PAUSE feature that allows you to interrupt
Autodyn or Polyflow and release the license, temporarily, for another application to use.
Electronics Applications
Electronics applications do not support license sharing.
Separate Licenses By using the separate-licenses method, ANSYS Workbench requires a separate
license for each application. By using this method, you can move freely between the many applications
that you might require during an analysis in ANSYS Workbench, provided that you have sufficient licenses.
You can leave each application running and easily move between them at any point during the analysis,
even if one of the applications is actively using the license (such as during a solve process). The disad-
vantage to this method is that you could potentially consume many licenses.
To activate the separate licenses method, choose Use a separate license for each application in the
Licensing Preferences dialog box (Start > ANSYS 2019 R1 > ANSYS Client Licensing > User License
Preferences 2019 R1). You must specify the licensing method before starting an ANSYS Workbench
session.
Examples of Using Separate Licenses You have two Mechanical Enterprise licenses. When you open
and mesh or solve a model in the Mechanical application, you consume one Mechanical Enterprise license.
If you link that Mechanical analysis to a Mechanical APDL system, you would consume a second Mech-
anical Enterprise license when you launch the Mechanical APDL application, if you have not closed out
of the Mechanical application. Neither of these licenses would then be available for other users until
you closed out of one or both of the applications.
Client Environment Variable Settings
3.3. Client Environment Variable Settings

You can set the following environment variables on individual machines to control their behavior, espe-
cially if you need it to be different from the general site configuration. These settings are especially
useful for situations where you are testing a new product installation/license manager installation on
a single machine before full site deployment, or other similar situations.
ANSYSLMD_LICENSE_FILE
Can be used to identify a license server machine or license file. If set, this specification is used before
any other license path information. See License Files Settings Precedence (p. 17) for precedence in-
formation. The default port number assigned to ANSYS, Inc. is 1055. Therefore, if your server has the
hostname alpha1 and the IP address of 10.3.1.69, you can identify the server to use as 1055@alpha1
or 1055@10.3.1.69.
ANS_FLEXLM_DISABLE_DEFLICPATH
Indicates that the default license path should not be searched when determining the licensing path
in the ANSYS product. When this environment variable is set:
• Only ANSYSLMD_LICENSE_FILE and ANSYSLI_SERVERS environment variable settings are used.
• Only the ANSYSLMD_LICENSE_FILE environment variable setting is required.
• Settings in the ansyslmd.ini file and the license file in the licensing directory will NOT be used.
It will ignore the local server and will ignore the Specify the License Server setting.
ANSYSLI_SERVERS
Used to identify the server machine for the Licensing Interconnect. Set to port@host. The default
port is 2325. This setting takes precedence over settings specified in the ansyslmd.ini file.
ANSYSLI_TIMEOUT_CONNECT
Used to specify the amount of time that elapses before the client times out if it cannot connect to
the server. Default is 20 seconds. Minimum timeout period you can specify is 5 seconds and the
maximum is 60 seconds. If the client determines that a server is not available in less time, it will cancel
immediately.
ANSYSLI_TIMEOUT_TCP
Used to specify the amount of time that elapses before the client times out if it cannot get a response
from the server. This setting applies only when the license server is running but is responding slowly
(generally because of network issues or server load). Default is 60 seconds. Minimum timeout period
you can specify is 30 seconds and the maximum is 300 seconds.
Chapter 4: HPC Licensing
ANSYS, Inc. offers multiple high performance computing license options, described below.
The HPC license options below cannot be combined with each other in a single solution; for example,
you cannot use both ANSYS HPC and ANSYS HPC Pack licenses in the same analysis solution.
See the applicable product documentation for instructions on configuring and running a distributed
solution.
ANSYS HPC
These physics-neutral licenses can be used to run multiple analysis jobs across multiple processors and
work with most ANSYS, Inc. applications. Some ANSYS applications can utilize any combination of CPU
and GPU processors. Other applications are limited to CPU processors only. Contact your ANSYS sales
representative for a complete list of products that can be used with ANSYS HPC.
A number of ANSYS products allow you to use four cores without using any HPC licenses; ANSYS
HPC licenses add to this base functionality. For example, an ANSYS CFD Enterprise user using twelve
processors (or cores) will consume only eight ANSYS HPC tasks. Contact your ANSYS sales represent-
ative for a complete list of products with this option.
ANSYS HPC licenses do work with ANSYS Workbench's Remote Solve capability; however, ANSYS
HPC licenses are not subject to single license sharing as described in ANSYS Workbench Licensing
Methods (p. 22).
You cannot combine ANSYS HPC licenses with any other type of HPC licenses, including HPC Pack
Licenses, in the same solution.
ANSYS HPC licenses are not valid with academic products; instead, use the appropriate ANSYS
Academic HPC license.
ANSYS HPC Pack Licenses

These physics-neutral licenses can be used to run a single analysis across multiple processors and work
with most ANSYS, Inc. products. Contact your ANSYS sales representative for a complete list of applications
that can be used with ANSYS HPC Pack Licenses. ANSYS HPC Pack Licenses enable parallel for single simu-
lations according to the following table:
Table 4.1: ANSYS HPC Pack Licenses Distribution
ANSYS HPC Pack CPUs Enabled

License
1 8
2 32
3 128
4 512
5 2048
HPC Licensing
ANSYS HPC Pack CPUs Enabled

License
6 8192
7 32768
8 131072
9 524288
10 2097152
11 8388608
12 33554432
13 134217728
14 536870912
You cannot use more than 14 HPC Pack Licenses on a single analysis. Individual HPC Pack Licenses
cannot be split between multiple users or between multiple analyses.
A number of ANSYS products allow you to use four cores without using any HPC licenses; ANSYS
HPC Pack licenses add to this basic functionality. For example, an ANSYS Mechanical Enterprise user
using twelve processors (or cores) will consume only one ANSYS HPC Pack task.
HPC Pack Licenses do work with ANSYS Workbench's Remote Solve capability; however, HPC Pack
Licenses are not subject to single license sharing as described in ANSYS Workbench Licensing
Methods (p. 22).
You cannot combine ANSYS HPC Pack Licenses with any other type of HPC licenses, including ANSYS
HPC licenses, in the same solution.
ANSYS HPC Pack Licenses are not valid with academic products.
One ANSYS HPC Pack License can be borrowed at a time. Multiple HPC Pack Licenses or other HPC
licenses cannot be borrowed.
4.1. HPC Parametric Pack Licensing

ANSYS, Inc. offers additional license options called HPC Parametric Packs for ANSYS Workbench jobs
requiring multiple design point updates. HPC Parametric Packs enable you to simultaneously update
multiple design points of a single design study while using only a single license of each required base
license. You must use the ANSYS Workbench reserved licensing feature to use HPC Parametric Pack li-
censes.
HPC Parametric Packs enable a specific number of simultaneous design points, as follows:
Table 4.2: HPC Parametric Pack Simultaneous Design Points
HPC Parametric Simultaneous Design Points

Pack
1 4
2 8
3 16
4 32
HPC Parametric Pack Licensing
HPC Parametric Simultaneous Design Points

Pack
5 64
You can use a maximum of five HPC Parametric Pack licenses per design study.
HPC Parametric Packs also work in conjunction with ANSYS HPC and ANSYS HPC Pack Licenses. Use the
HPC licenses to enable multiple parallel processes to be used for each design point.
For more details on working with HPC Parametric Pack licenses in ANSYS Workbench, see Using HPC
Parametric Pack Licenses in the Workbench User's Guide.
For a complete list of products to which HPC Parametric Pack licenses apply, see your ANSYS, Inc. sales
representative.
Chapter 5: Post-Installation Instructions
After you have installed the ANSYS License Manager, you may want to complete some post-installation
steps in order to optimize the performance of the ANSYS License Manager at your site.
We recommend that you set your license manager to start at system startup. Other optional post-install-
ation tasks are included here.
5.1. Start the ANSYS License Manager at System Boot Time

On Windows systems, the license manager is set to start up automatically at system reboot. On Linux
machines, you can set the license manager to start automatically at system boot time. This task is op-
tional but is recommended and should be done regardless of which type of license server configuration
you use.
Table 5.1: License Manager Automatic Startup Instructions (p. 31) details the steps that must be performed
on each license server to start the license manager automatically when the Linux system is rebooted.
Note
The procedure described in this section starts the license manager at boot time as root. It is
not essential that the license manager be started by the root user; it may be run by a non-
privileged user, depending on your preference. If you do not want the license manager to
be started by root, modify LMUSER in the init_ansysli boot script to include the user
name you want to use at boot time.
Table 5.1: License Manager Automatic Startup Instructions
Platform Instructions
Linux: Red Remove existing license manager startup information. Edit the file
Hat and /etc/rc.d/rc.local.
CentOS
Issue the new license manager startup instructions:
cp /ansys_inc/shared_files/licensing/init_ansysli /etc/init.d
chmod 555 /etc/init.d/init_ansysli
chkconfig --add init_ansysli
chkconfig init_ansysli on
Linux: SuSE Remove existing license manager startup information. Edit the file
/etc/rc.d/boot.local.
Issue the new license manager startup instructions:

cp /ansys_inc/shared_files/licensing/init_ansysli /etc/init.d
chmod 555 /etc/init.d/init_ansysli
chkconfig --add init_ansysli
chkconfig init_ansysli on
Post-Installation Instructions
Once the procedure is in place for starting the license manager automatically at boot time, reboot the
system to verify that the automatic boot procedure is working correctly.
When the system comes back up, check to see that the license manager is running by typing the appro-
priate ps command and looking for ansyslmd and ansysli_server in the resulting display under
the column labeled COMMAND. For example:
ps -ef|grep ansysli; ps -ef|grep ansyslmd
Next, check the license.log and the ansysli_server.log files in the licensing directory for
error messages. These files contains a history of ANSYS product activity across the network when this
computer is chosen as the master license server by the licensing software. They also contain start-up
messages and possibly error messages.
Removing the Automatic Startup Information

If you remove the license manager server installation from a machine and need to remove this capability,
follow the instructions below.
Table 5.2: Removing License Manager Automatic Startup Instructions
Linux Issue the following commands:
/etc/init.d/init_ansysli stop
chkconfig --del init_ansysli
rm /etc/init.d/init_ansysli
5.2. Starting the ANSYS Licensing Tomcat Server at System Boot Time
You can set Tomcat to start automatically at system boot time on Linux machines. This task is optional
but is recommended and should be done regardless of which type of license server configuration you
use. The License Management Center runs using the Tomcat web server. This task is required to be able
to run the License Management Center.
Table 5.3: Tomcat Automatic Startup Instructions (p. 33) details the steps that must be performed on
each Linux license server to start Tomcat automatically when the system is rebooted.
Note
The procedure described in this section starts Tomcat at boot time as root. It is not essential
that Tomcat be started by the root user; it may be run by a non-privileged user, depending
on your preference. If you do not want Tomcat to be started by root, modify the LMUSER
value in the init_ansyslm_tomcat boot script to include the user login name you want
to use at boot time. This user must have read/write access to all files contained in the following
directories:
<Install Directory>/shared_files/licensing/tools/tomcat/conf
<Install Directory>/shared_files/licensing/tools/tomcat/logs
Starting the ANSYS Licensing Tomcat Server at System Boot Time
<Install Directory>/shared_files/licensing/tools/tomcat/bin
Table 5.3: Tomcat Automatic Startup Instructions
Linux: Red Issue the Tomcat startup instructions:
Hat, SuSE cp /ansys_inc/shared_files/licensing/init_ansyslm_tomcat /etc/init.d
and CentOS chmod 555 /etc/init.d/init_ansyslm_tomcat
chkconfig --add init_ansyslm_tomcat
chkconfig init_ansyslm_tomcat on
Once the procedure is in place for starting Tomcat automatically at boot time, reboot the system to
verify that the automatic boot procedure is working correctly.
When the system comes back up, check to see that Tomcat is running by typing the appropriate ps
command and looking for init_ansyslm_tomcat in the resulting display under the column labeled
COMMAND. For example:
ps -ef|grep tomcat
Removing the Tomcat Automatic Startup Information

If you remove the license manager server installation from a machine and need to remove Tomcat
Automatic Startup capability, follow the instructions below.
Table 5.4: Removing Tomcat Automatic Startup Instructions
Linux: Red Issue the following commands:
Hat, SuSE /etc/init.d/init_ansyslm_tomcat stop
and CentOS chkconfig --del init_ansyslm_tomcat
rm /etc/init.d/init_ansyslm_tomcat
Chapter 6: Installation Options
6.1. Silent License Manager Installation Instructions
You can deploy an ANSYS License Manager installation in silent mode on both Windows and Linux
systems.
To silently install the ANSYS License Manager on Windows systems that will act as license servers, you
must run the setup.exe with the -silent and -LM options:
setup.exe -silent -LM
To install the ANSYS License Manager on Linux systems that will act as license servers, you must run
the INSTALL with the -silent and -LM options:
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 FlexNet.
If you are installing the license manager to a non-default installation directory, you can use the silent
installation method, but only for the initial installation.
Note
You are unable to change the installation directory for a computer that currently contains
an instance of the ANSYS License Manager. To change the installation directory location, you
must first uninstall any previous versions of the ANSYS License Manager.
You can use the following arguments when running a silent license manager installation:
-silent Initiates a silent installation.

-in- Specifies the directory to which the license manager is to be installed. If you want to install
stall_dir to the default location, you can omit the -install_dir argument. The default location
path on Linux is /ansys_inc if the symbolic link is set; otherwise, it will default to /usr/an-
sys_inc.
-lic- Specifies the location of the license file to install. If the path is not specified or if the path
file- is the same as the existing license file, the license file will not be installed. For the license
path file path on Windows, you must enclose the path in quotes if you have spaces in the
path pathname.
Installation Options
During a silent installation, any licensing configuration messages will be written to the licensing install-
ation configuration log file, install_licconfig.log, located in the installation directory.
Caution
A silent license manager installation could shut down the ANSYS License Manager, affecting
other users who are using that license server machine.
If you are running a silent client installation, you can specify license server information as well.
-licserver- Specifies information to be used by the client for the license server. Valid only
info in conjunction with a silent product installation (setup.exe or INSTALL). See
the ANSYS Installation Guide for your platform for details on running a silent
product installation, including client licensing.
6.2. Uninstalling the ANSYS License Manager

These instructions shut down and remove the entire ANSYS License Manager installation from your
system. You should not uninstall the license manager if you still have products installed that use the
license manager.
The procedures described in this section assume that you have installed the ANSYS License Manager
in the default locations. The default locations are:
Windows:
C:\Program Files\ANSYS Inc\
Linux:
/ansys_inc/
If you have installed the ANSYS License Manager to a non-default location, modify the steps accordingly.
Uninstalling on Linux License Servers

Follow these steps on the license server machine. You must be logged in as root or superuser.
1. Stop the ANSYS License Manager from the ANSYS License Management Center by following the steps
contained in Stopping the ANSYS License Manager (p. 50).
2. Stop any ANSYS Tomcat server processes running from this installation directory by running the
stop_lmcenter script located in:
/ansys_inc/shared_files/licensing/
3. Delete the shared_files subdirectory (/ansys_inc/shared_files/ by default).
Note
Do not delete this directory if ANSYS products are also installed in the installation directory.
Uninstalling the ANSYS License Manager
4. Remove the ANSYS License Manager automatic startup information by issuing the commands in
Table 5.2: Removing License Manager Automatic Startup Instructions (p. 32).
5. Remove the Tomcat automatic startup information by issuing the commands in Table 5.4: Removing
Tomcat Automatic Startup Instructions (p. 33).
Uninstalling on Windows License Servers

Follow these steps on the license server machine. All commands must be run in an administrator com-
mand prompt window.
1. Stop the ANSYS License Manager from the ANSYS License Management Center by following the steps
contained in Stopping the ANSYS License Manager (p. 50).
2. Uninstall the ANSYS License Manager service. You must use the following command to do so:
"C:\Program Files\ANSYS Inc\Shared Files\Licensing\winx64\ansysli_server"
-k uninstall
3. Uninstall the ANSYS Licensing Tomcat service. You must use the following commands to do so:
sc stop "ANSYSLicensingTomcat"
sc delete "ANSYSLicensingTomcat"
4. Delete the Shared Files subdirectory (C:\Program Files\ANSYS Inc\Shared Files by default).
Note
Do not delete this directory if ANSYS products are also installed in the installation dir-
ectory.
5. Remove the ANSYS License Manager folder from the Start menu.
6. Remove the ANSYSLIC_DIR and the ANSYSLIC_SYSDIR environment variables, if set.
Chapter 7: Configuration Options
This section includes a range of ANSYS License Manager configuration options that my be required for
your specific network architecture.
7.1. Configuring TCP/IP

TCP/IP must be be configured and started for any ANSYS, Inc. product and the license manager to be
able to run. You should consult your network administrator for assistance with this configuration. The
TCP/IP protocol must be installed on any machine on which you want to run an ANSYS product.
TCP/IP is supplied as part of the Linux operating system. Table 7.1: Configuring TCP/IP (p. 39) specifies
the system utility used to configure TCP/IP on the various hardware platforms. You should consult your
network administrator for assistance with this configuration.
Note
Linux systems require an Ethernet card.
Table 7.1: Configuring TCP/IP
Hardware Platform TCP/IP Configuration Utility

Linux (Red Hat Enterprise 6) (64-bit) system-config-network
Linux (Red Hat Enterprise 6 and nmtui
CentOS-7) (64-bit)
Linux (SuSE Enterprise) (64-bit) yast
For Windows systems, the TCP/IP protocol is included as part of the operating system and is typically
installed by default. If you do need to install TCP/IP, remember that it must be bound to a network
adapter (such as an ethernet adapter).
On machines that connect to the Internet or corporate intranet through a modem, TCP/IP can be bound
to a dial-up connection.
Determining Whether TCP/IP Is Installed on a Microsoft Windows System

To determine if TCP/IP is installed on your system, open the Control Panel, select Network and Internet>
Network and Sharing Center. Click Local Area Connection and click Properties. Internet Protocol
(TCP/IP) should be listed.
Configuration Options
If TCP/IP is installed, you must determine whether it is bound to a network adapter card or a dial-up
connection. A network card or a Dial-Up Adapter will be shown under Connect Using:.
Caution
If your computer is connected to a network, it is highly recommended that you contact your
Information Technology Department before installing or modifying TCP/IP on your machine.
7.1.1. Changing the Default ANSYS Licensing Interconnect and FlexNet Port
Numbers
A port number specifies the communications channel by which two or more processes can communicate.
ANSYS uses 2325 as the default port number for the ANSYS Licensing Interconnect and 1055 as the
default port number for the FlexNet component of the license manager. ansyslmd also uses a port
designated by the operating system, unless one is manually specified in the license file on the VENDOR
line. If you encounter a conflict in port numbers, you can change the default by modifying all of the
following files:
ANSYS Licensing Interconnect Port Number The ANSYS Licensing Interconnect port number is
defined in the ansyslmd.ini file. You can change this file by selecting Specify the License Server
Machine on the ANSLIC_ADMIN utility. Enter the new port number in the ANSYS Licensing Intercon-
nect Port Number field. The Licensing Interconnect port number may also be specified via the AN-
SYSLI_SERVERS environment variable, if set.
FlexNet Port Number To change the default FlexNet port number, you need to change the following
files:
• On the license server machine(s): the port number listed on the SERVER line in the license file (ansyslmd.lic
and/or ansoft.lic).
• On the client machine(s): the port number listed in the ansyslmd.ini file. Use the Specify the License
Server Machine option of the ANSLIC_ADMIN utility to change the ansyslmd.ini file. The FlexNet port
number may also be specified via the ANSYSLMD_LICENSE_FILE environment variable, if set.
ansyslmd Port Number The ansyslmd daemon uses a port designated by the operating system,
unless one is manually specified in the license file on the VENDOR line. See VENDOR Lines (p. 4) for
information on specifying this port number on the VENDOR line. You should need to specify this port
number manually only if using a firewall.
For information on firewall settings, see Specifying Firewall Settings (p. 13).
7.2. Advanced Licensing Configuration Options

In addition to the default configuration, ANSYS, Inc. offers two run mode options that can be selected
through the Specify the License Manager Run Mode option in the ANSYS License Management
Center:
• Run the ANSYS Licensing Interconnect without FlexNet -- Use this option if you want to run a local
copy of the ANSYS Licensing Interconnect for better performance, such as if your server machine is in
a remote location, or to manage the server load better if your license server machine serves many users.
With this option, FlexNet licenses will be taken from another server machine. Use this option to run the
Modify License Manager Startup Options
Licensing Interconnect on additional systems other than your license server; your site must still have
the Licensing Interconnect running on the license server machine.
• Run the ANSYS Licensing Interconnect and FlexNet independently -- Use this option if you want
to manage your FlexNet licenses independently of the ANSYS, Inc. tools (for example, using Flexera
Software's FLEXnet Manager to manage multiple companies' FlexNet product licenses). This option
should be used only by experienced users with well-established licensing procedures.
These options are available through the Specifying the License Manager Run Mode option in the
ANSYS License Management Center after a license manager installation has been run on this machine.
For more information, see Specifying the License Manager Run Mode (p. 60)
If you have already configured your licensing and are changing to a different configuration option, you
must stop and restart the ANSYS License Manager for these changes to take effect. Rereading the license
manager settings will not be sufficient.
Run the ANSYS Licensing Interconnect without FlexNet
Important
When using this advanced option, the license server holding the FlexNet licenses must also
have the Licensing Interconnect installed and running.
To use the ANSYS License Management Center to set up a license server that will run the Licensing
Interconnect without FlexNet, see Specifying the License Manager Run Mode (p. 60).
Run the ANSYS Licensing Interconnect and FlexNet independently

Use this option if you want to manage your FlexNet licenses on a server machine independently of the
ANSYS, Inc. tools (for example, using Flexera Software's FLEXnet Manager to manage multiple companies'
product licenses). This option should be used only by experienced users with well-established licensing
procedures. Running these processes separately requires caching the license file, meaning that you
specify the location of an existing license file that contains FlexNet licenses for ANSYS, Inc. products.
Because ANSYS License Management Center will no longer be managing FlexNet, you will need to
use your license management tools (such as FLEXNet Manager) to start/restart FlexNet or to reread the
license file if you make changes to the license file.
Important
If you make changes to the license file, in addition to rereading the license file in FlexNet
(using your license management tools), you must also recache the license file in the Licensing
Interconnect by restarting the Licensing Interconnect or by using the Reread the License
Manager Settings option in the ANSYS License Management Center.
To use the ANSYS License Management Center to set up a license server that will run the Licensing
Interconnect and FlexNet independently, see Specifying the License Manager Run Mode (p. 60).
7.3. Modify License Manager Startup Options

This ANSLIC_ADMIN utility option (Set Site Preferences>Modify Startup Options) writes an ansyslmd.ini
file in the licensing directory. This file contains any changes to the default values as well as your license
server specifications and other settings (such as log file locations). Use this ANSLIC_ADMIN utility option
to change the default values.
For a detailed description of the settings that you can change with this option, see Modify Startup
Options (p. 72).
7.4. Create a Group (Linux Only)

You may want to create a group of users with specific usage capabilities, such as users with licensing
administrative privileges, or users who are authorized to shut down the license manager. An lmadmin
group is the most common type of group.
To specify a list of users with access to licensing administrative options, you need to create an lmadmin
group on computers from which license administration will be performed. If you create an lmadmin
group, you must include root in order for root to continue to have access to these functions. For more
details on using an lmadmin group, see the FlexNet License Administration Guide (accessible from the
ANSYS License Management Center). This option is available for Linux platforms only.
Follow the instructions below for your hardware platform to create an lmadmin group.
Linux Add a line to the file /etc/group as follows:

lmadmin:*:nn:root,user1,user2,user3...usern
where nn represents any unique group number and user1, user2, user3, ..., usern represent a list
of n users in the group.
7.4.1. Defining Group Restrictions for the Licensing Interconnect

On Linux machines only, you can specify who can shut down the ANSYS License Manager by using the
ANSLIC_ADMIN utility's Modify Startup Options. By default, anyone can stop the license manager.
You can restrict shutdown capabilities to only the user who started it, or to a group, such as lmadmin.
If you choose group, you will need to specify the name of the group. Note that the user who started
the license manager will still be able to shut it down, even if he is not part of a group with shutdown
capabilities.
If you specify a group restriction, any users in that group who want to perform that operation must
have the specified group as their primary group. For example, adding the following restriction:
RESTRICT_SHUTDOWN=GROUP:lmadmin
restricts the ability to shut down the license manager to only members of the lmadmin group. Any user
who is a member of the lmadmin group and wants to shut down the license manager must have
lmadmin as his primary group:
machineabc{user1}: groups
other testing dev1 lmadmin
In the above example, user1 is a member of the groups other, testing, dev1, and lmadmin, where other
is the primary group and testing, dev1, and lmadmin are secondary groups.
To change a group from a secondary to a primary group, issue the newgrp (or equivalent) command:
machineabc{user1}: newgrp lmadmin
Specifying the License Server and License Files
In this example, user1 now has lmadmin as the primary group and will be able to shut down the license
manager:
machineabc{user1}: groups
lmadmin other testing dev1
7.5. Specify User Privileges

Establish user privileges by editing the FlexNet Options file. The options file allows you, the license ad-
ministrator, to control various operating parameters of FlexNet:
• Allow or deny the use of features based on user, hostname, display name, group, etc.
• Reserve licenses based on user, hostname, display name, group, etc.
• Control the amount of information logged about license usage.
By using the options file, you can be as secure or as open with licenses as you like.
The default location of the options file, ansyslmd.opt, is in the license_files directory. If you have a
three-server system, the options file must match exactly on all three servers.
If you are using an options file, you must specify the pathname to the file on the VENDOR line in the
license file, unless it uses the default name, ansyslmd.opt, and resides in the same directory as the
license file. On Linux systems, the VENDOR line would look like this for an options file named my.opt:
VENDOR ansyslmd options=/ansys_inc/shared_files/licensing/license_files/my.opt
On Windows systems, if the path has spaces in it, you must enclose it in quotes:
VENDOR ansyslmd options="c:\Program Files\ANSYS Inc\Shared Files\Licensing\license_files\my.opt"
For more information, see the FlexNet Publisher License Administration Guide which available
through the ANSYS License Management Center. For instructions on accessing this guide, see Accessing
the Help Options (p. 61).
7.6. Specifying the License Server and License Files

ANSYS products need to be able to locate and communicate with the license server for your ANSYS,
Inc. products to run correctly. The license server and license files should be specified correctly during
the product and license manager installations. Use the Specify the License Server Machine option of
the Client ANSLIC_ADMIN utility only if you need to change the settings already specified.
The Specify the License Server Machine option of the ANSLIC_ADMIN utility creates a file named
ansyslmd.ini in the licensing directory. The ansyslmd.ini file contains your license server spe-
cification. For more information on specifying the license server, see Specify the License Server Ma-
chine (p. 15).
On Windows server machines, use the Server ANSLIC_ADMIN utility (accessed via Start > ANSYS 2019
R1> ANSYS, Inc. License Manager> Server ANSLIC_ADMIN Utility) to modify the ansyslmd.ini
file. On client machines, use the Client ANSLIC_ADMIN utility (accessed via Start > ANSYS 2019
R1>ANSYS Client Licensing > Client ANSLIC_ADMIN Utility 2019 R1). If you have both the server
and the client ANSLIC_ADMIN utilities on the same system, use the Client ANSLIC_ADMIN to specify
machine-specific (local) settings.
If you want to set your license paths to have a particular license server machine for your use only (not
used by others who are running ANSYS products on this machine), you can do so by setting the AN-
SYSLI_SERVERS and/or ANSYSLMD_LICENSE_FILE environment variables. Use the ANSYSLI_SERVERS
environment variable to specify the Licensing Interconnect port number. Use the ANSYSLMD_LI-
CENSE_FILE to specify the FlexNet port number.
If the ANSYSLMD_LICENSE_FILE environment variable is set but the ANSYSLI_SERVERS environment

variable is not set, the same server machines will be used to specify the Licensing Interconnect but the
port number will be replaced by the Licensing Interconnect default port of 2325. When both variables
are set, ANSYSLMD_LICENSE_FILE explicitly defines the FlexNet servers while ANSYSLI_SERVERS ex-
plicitly defines the Licensing Interconnect servers.
7.7. Setting Up Redundant (Triad) Servers

Throughout this document, we use the term “three-server network” when referring to redundant triad
servers. Redundant server setup is a network configuration where multiple machines are designated as
license servers. Redundancy can be achieved in two ways:
• Any number of license server machines can be running independently. The total number of licenses is
split between each license server. For example, if you are licensed for 20 tasks of a certain product, and
you have two license server machines, each license server machine will serve ten licenses. In this example,
if one of these machines fails, only ten licenses will be available.
• Three different machines can be selected to work together in tandem (typically referred to as a redundant
triad), where two of the three must be running at all times. These three license server machines work
from a single set of licenses. This option is not recommended.
Caution
If you are running redundant servers, you should have the license file (as well as the entire
licensing directory) installed locally on each license server. If you do not, you lose all the
advantages of having redundant servers, since the file server holding these files becomes a
single point of failure.
We recommend using multiple independent license server machines to achieve redundancy; however,
if your site requires the use of three license server machines working in tandem, follow the guidelines
in this section to configure the servers.
1. Install the License Manager on each of the three servers as described in Installing the License Man-
ager (p. 8). Be sure that each machine meets all of the prerequisites.
2. Start each of the license servers using the same license file on each machine. The license file for the three-
server setup will begin with three SERVER lines:
SERVER myserver1 00e2463 1055

SERVER myserver2 00132460b724 1055
SERVER myserver3 001a246d4e64 1055
The first SERVER line is the license server you have designated as the primary server followed by
the second and third servers, which act as the backup servers.
3. Always start the primary server first. If not, the second or third server will take over as the master server.
Setting Up Redundant (Triad) Servers
When you start each license server, you will see a message indicating that the server is starting.
The primary server will not be fully started until you start the second or third server, creating a
quorum. Until you have a quorum of servers started, the ANSYS License Management Center
will show the Licensing Interconnect and monitor running while FlexNet will show as not running.
You could see a delay of up to five minutes in the startup of a server's FlexNet component while
the communication between all three servers is being established. If a connection cannot be estab-
lished within the five minutes, the Licensing Interconnect and Licensing Interconnect Monitor will
stop. Check the ANSYS License Management Center to verify that all components have stopped
before you attempt to restart the ANSYS License Manager on any server.
To stop redundant servers, use the Stop the ANSYS, Inc. License Manager option of the ANSYS License
Management Center to manually stop the License Manager on each server. The Stop the ANSYS, Inc.
License Manager option stops only the "local" instance of the License Manager, therefore it is necessary
for you to stop each instance individually.
Chapter 8: License Server Administration Using ANSYS License
Management Center
This chapter explains how to use the ANSYS License Management Center (LM Center) to perform
many of the procedures necessary to administer ANSYS licenses. The ANSYS License Management
Center is a browser-based user interface that centralizes many of the ANSYS licensing administrative
functions. Basic license administration functionality has been incorporated into the ANSYS License
Management Center; some advanced options remain in the ANSLIC_ADMIN utility. See License Admin-
istration Using the ANSLIC_ADMIN Utility (p. 67) for more information on the ANSLIC_ADMIN utility.
Note
For Windows systems, ANSYS, Inc. requires that you have system administrator privileges to
start the ANSYS License Management Center. To use the ANSYS License Management
Center, you must access it from the local license server machine.
8.1. ANSYS License Management Center Browser Requirements

Supported Windows Browsers
• Internet Explorer 11.1324.15063.0 or greater
• Microsoft Edge 41.16299.248.0
• Firefox 56.0.1 or greater
• Chrome 70.0.3538.77 or greater
Note
ANSYS License Management Center uses your default browser when opening. If
you have not defined a default browser, ANSYS License Management Center attempts
to open using Windows Internet Explorer from the default installation location. If
Windows Internet Explorer is not installed in the default location, an error is reported.
Supported Linux Browsers
• Firefox 38.5.0 or greater
8.2. Accessing the ANSYS License Management Center

To open the ANSYS License Management Center:
Windows 7:
License Server Administration Using ANSYS License Management Center
Click Start>All Programs>ANSYS, Inc. License Manager>ANSYS License Management Center
Windows 10:
Click Start>ANSYS, Inc. License Manager>ANSYS License Management Center
Linux
Run the start_lmcenter script located in the following directory:

ansys_inc/shared_files/licensing/
8.3. Using the ANSYS License Management Center

The left side of the ANSYS License Management Center (LM Center) includes links accessing a variety
of licensing administration functions. Additionally, an icon informing you of the status of the ANSYS
License Management Center is also located in the title bar. (Running is displayed as a green check
mark while Stopped is displayed as a red stop sign.)
The following sections provide instructions on how to perform the licensing administration functions
available through the ANSYS License Management Center:
8.3.1. Adding a License
8.3.4. Rereading the License Manager Settings
8.3.5. Displaying the License Server Machine Hostid Information
8.3.7. Viewing the Licensing Interconnect Log
8.3.8. Viewing the FlexNet Debug Log
8.3.9. Viewing the ANSYS License Management Center Log
8.3.10. Viewing the Current License Usage
8.3.11. Viewing the License Usage History
8.3.12. Viewing the Peak License Usage
8.3.13. Viewing License Denials
8.3.15. Gathering Diagnostic Information
8.3.16. Displaying Queued Licenses
8.3.17. Specifying the License Manager Run Mode
8.3.18. Accessing the Help Options
8.3.1. Adding a License
Important
When adding a license file, the Add a License File option in the ANSYS License Man-
agement Center validates the new license file for the system, attempts to correct issues
that it recognizes, and ensures port number consistency. For this reason, you must use
the ANSYS License Management Center to add license files, rather that manually placing
them in the license_files directory.
This option validates a user-specified license file and, if the license file is found to be valid, installs it
into the license_files directory. After installing the license file, this option communicates the new license
Using the ANSYS License Management Center
file's information to the ANSYS License Manager either by starting /restarting the license manager or
by rereading the license manager's settings.
If a vendor license file is already installed for the vendor contained in the license file you are installing,
the previously-installed license file will be renamed to have the form license_<vendor>_<timestamp>.lic
and moved to the backup subdirectory in the license_files directory.
You must perform this process, using the same license file, on each license server machine.
To add a license file:
1. Save the license file that you received from your ANSYS sales representative to a temporary file.
Caution
Do not save license files in Microsoft Word format.
2. Open the ANSYS License Management Center.
3. Click the Add a License File option.
The Add a License File page is displayed.
4. Click the Browse button.
5. Browse to locate the saved license file from step #1.
6. Select the license file and click Open.
7. If the selected license file is not valid, the process ends with the Status pane displaying an error message
containing details.
8. If the license file is valid, the Add a License File dialog box is displayed:
• If the ANSYS License Manager is not running, you are informed that it will be started when the li-
cense file is added.
• If the ANSYS License Manager is running, you are given the option of either restarting it or rereading
the license manager settings. Click the appropriate options. For more information, see Rereading
the License Manager Settings (p. 51).
9. The Status pane displays a message informing you of the steps taken successfully along with any errors
that were encountered.
Special Considerations for Three Server (Redundant Triad) Environments
You must perform this process, using the same license file, on each license server machine.

In order for client machines to run licensed ANSYS products, the ANSYS License Manager must be running
on the license server.
To use the ANSYS License Management Center to start the license manager, ANSYS License Manage-
ment Center (including the ANSYS Licensing Tomcat Server and the license manager) must be installed
on the same computer. Additionally, a valid license file must be installed prior to starting the license
manager.
To start the ANSYS License Manager:
2. Click the Start button located on the right side of the page.
The Status pane displays a message informing you whether the ANSYS License Manager started
successfully or if any errors have been encountered. Additionally, a “green check mark” status icon
is displayed indicating that the license manager is running.
Note
Every seven seconds, the ANSYS License Management Center verifies that the li-
cense manager is running and updates the status icon.
The ansyslmd.lic and/or ansoft.lic file is provided by an ANSYS sales representative and contains
licensing for all the ANSYS, Inc. products that you are entitled to use.
The ANSYS License Manager must be running on at least two of the three servers before an ANSYS
product can be run.
In a three-server environment, you may see a delay in starting the ANSYS License Manager until two
of the three servers are running.

The following procedure should be used to shut down the ANSYS License Manager on all machines
listed in the license file.
To stop the ANSYS License Manager:
Before shutting down the ANSYS License Manager, check that no products that use it are currently
running.
2. Click the Stop button located on the right side of the page.
You are asked to confirm that the license manager should be shut down. Remember that the license
manager must be running in order to run products that use it for their licensing.
The Status pane displays a message informing you whether the license manager stopped successfully
or if any errors have been encountered. Additionally, a “red stop sign” icon is displayed indicating
that the license manager is no longer running.
Caution
(Linux systems) Do not use kill -9 to shut down the ANSYS License Manager. Use the ANSYS
License Management Center, the ansysli_stop script or ansysli_server -k stop
[port@host] to perform the shutdown.
In a three-server environment, you may see a delay in stopping the license manager until two of the
three servers are stopped.
8.3.4. Rereading the License Manager Settings

Use this option to reread the license manager settings. This option should be used when you have
made changes that will affect the license manager and want to incorporate these changes without
stopping and restarting the license manager.
This option:
• Rereads the ansyslmd.ini file to get any new settings, such as log file size or change of name
• Appends or opens a new Licensing Interconnect log file
• Rereads the site license preferences
• Recaches the installed license files
• Issues a FlexNet reread
• Recaches the servers
• Informs other servers about changes
Be aware that if you change the Licensing Interconnect port number, you will need to restart the license
manager; a reread will not update the port number.
Note
If you chose to configure your license manager to run the Licensing Interconnect without
FlexNet or run the Licensing Interconnect and FlexNet independently, then selecting this
option will affect only the Licensing Interconnect components including recaching the license
file when running the Licensing Interconnect and FlexNet independently.
To reread the License Manager:
2. Click the Reread License Manager Settings option.
3. Click the Reread button.
The Status pane displays a message informing you whether the ANSYS License Manager's settings
were successfully reread.
8.3.5. Displaying the License Server Machine Hostid Information

Use this option to obtain and display the FlexNet hostid of the machine you wish to create licenses for
and set up as a license server.
If you wish to use a FLEXID9 dongle as the hostid, make sure the device is inserted and the correct
device driver is installed. For more information, see Using Dongles with the ANSYS License Man-
ager (p. 77). Dongles are only available for those sites that require the ability to run ANSYS products
on an isolated network.
Accessing the Hostid
2. Click the Get System Hostid Information option.
The hostid information is displayed on the right-hand side of the page. The HOSTNAME,
Hostid, IDTYPE and PLATFORM information is included. Windows systems use the physical
machine disk serial number and Linux systems use the MAC address by default.
3. To save this information out to a file, click the SAVE TO FILE button. By default, the file is named an-
sysid.machinename.txt.

Use this option to view the FlexNet license files. You can view license files that are in use (or will be in
use) in the ANSYS License Manager.
2. Click the View FlexNet Licenses option.
A field containing the name of one of your FlexNet license files is displayed.
3. Select the FlexNet license file you want to view by clicking the arrow located on the right side of the field
and choosing the appropriate file from the drop-down menu. Note the drop-down menu is populated with
any FlexNet license files (.lic) contained in the following directory:
Windows:
\Program Files\ANSYS Inc\Shared Files\Licensing\license_files
Linux:
/ansys_inc/shared_files/licensing/license_files
4. The contents of the FlexNet license is displayed on the right side of the page.
8.3.7. Viewing the Licensing Interconnect Log

Use this option to view the Licensing Interconnect log file (named ansysli_server.log by default).
The Licensing Interconnect log file contains all of the actions that the ANSYS license server has taken
since startup.
Accessing the Licensing Interconnect Log
2. Click the View Licensing Interconnect Log option.
The Licensing Interconnect log file is displayed on the right side of the page.
3. To download a text version of the interconnect debug log file, click the SAVE TO FILE button.
4. To manually refresh the Licensing Interconnect log file, click the REFRESH button.
Note
The Licensing Interconnect log file does not automatically refresh.
The Licensing Interconnect log file (ansysli_server.log) can be found in the “licensing” directory. To
manually access this file, go to the following locations (by default):
Windows:
\Program Files\ANSYS Inc\Shared Files\Licensing\ansysli_server.log
Linux:
/ansys_inc/shared_files/licensing/ansysli_server.log
8.3.8. Viewing the FlexNet Debug Log

Use this option to view the FlexNet license log file (named license.log by default). The FlexNet
debug log includes the following message types:
• General informational messages describing the current status of FlexNet features
• Messages describing configuration issues
• License manager error messages associated with the FlexNet component of the license manager.
Accessing the FlexNet Debug Log
2. Click the View FlexNet Debug Log option.
The FlexNet debug log is displayed on the right side of the page.
3. To download a text version of the FlexNet debug log, click the SAVE TO FILE button.
4. To manually refresh the FlexNet debug log, click the REFRESH button.
Note
The FlexNet debug log does not automatically refresh.
The FlexNet debug log (license.log) can be found within the “licensing” directory structure by default.
To manually access this file, go to the following location:
Windows:
\Program Files\ANSYS Inc\Shared Files\Licensing\license.log
Linux:
/ansys_inc/shared_files/licensing/license.log
8.3.9. Viewing the ANSYS License Management Center Log

Use this option to view the ANSYS License Management Center log (named ansyslmcenter.log
by default).
Accessing the ANSYS License Management Center Log
2. Click the View License Management Center Log option.
The ANSYS License Management Center log is displayed on the right side of the page.
3. To download a text version of the ANSYS License Management Center log, click the SAVE TO FILE button.
4. To manually refresh the ANSYS License Management Center log, click the REFRESH button.
Note
The log does not automatically refresh.
The ANSYS License Management Center log (ansyslmcenter.log) can be found within the “licensing”
directory structure. To manually access this file, go to the following location:
Windows:
\Program Files\ANSYS Inc\Shared Files\Licensing\tools\lmcenter\logs\ansyslmcenter.log
Linux:
/ansys_inc/shared_files/licensing/tools/lmcenter/logs/ansyslmcenter.log
8.3.10. Viewing the Current License Usage

This option extracts data from your license manager to produce a live current license usage report. This
report displays the number of feature licenses used by each user in a bar chart format. Additionally, a
tabular chart displays maximum licenses available, user count, user names, host IDs and usage start
date for each feature license.
Viewing the Current License Usage
2. Click the View Current License Usage option.
The current license usage is displayed on the right side of the page.
3. To view the data in a tabular format, click the Show tabular data button.
8.3.11. Viewing the License Usage History

Use this option to extract data directly from your FlexNet debug log file and backup log files to produce
a line chart displaying historical license usage for a specific product.
Viewing the License Usage History
2. Click the View License Usage History option.
3. Select the appropriate date range (or a custom range) from the available drop-down menu and click
Generate.
Note
Based upon the date range selected, data may be extracted from your FlexNet debug
log file (located in the licensing directory) and your backup log files (located in the
logs_backup directory) to produce the chart.
The history for the default settings is displayed.
4. Select the appropriate product from the drop-down menu to display usage history for that feature license.
5. Set any combination of the following options to customize the data displayed:
• Select username - To view the usage history of a specific user, select the appropriate name from the
drop-down menu.
• Select hostname - To view the usage history for a specific host computer, select the appropriate computer
from the drop-down menu.
• Select working hours/days - The working hour/days options are:
– All (24/7) - Displays all data available for the duration you select.
– Monday to Friday (24/5) - Displays all data available for Monday through Friday for the duration you
select.
– Monday to Friday from 8am to 5pm - Displays data for Monday through Friday, from 9:00 AM to
5:00 PM for the duration you select.
• Select duration to display - Click the From and to fields to specify the date range that you wish to
display. Clicking the Reset to all button resets the From and to date duration values to the minimum
and maximum dates found in the log files the for user, host and product you have selected.
A graph is dynamically displayed showing license usage history for the options selected.
8.3.12. Viewing the Peak License Usage

This option extracts raw data from the FlexNet debug log file and backup log files to produce a
graphical display of peak usage for a selected license feature for the duration you select.
Viewing the Peak License Usage
2. Click the View Peak License Usage option.
Generate.
Note
The peak license usage for the default settings is displayed.
4. Select the appropriate product from the drop-down menu to display peak usage for that feature license.
drop-down menu.
select.
A graph is dynamically displayed showing peak license usage for the options selected.
6. You can export the data that is currently displayed to a CSV (comma separated value) file by clicking the
Export to csv file button.
7. To view the data in a tabular format, click the Show tabular data button. The tabular view shows the peak
license usage for each day as well as the average for each week and the selected period.
8.3.13. Viewing License Denials

This option extracts raw data from the FlexNet debug log file and backup log files to produce a license
denial report. This report displays the number of license denials that occurred for a feature on a specified
day in a graphical format.
Viewing License Denials
2. Click the View License Denials option.
Generate.
Note
The license denials for the default settings are displayed.
4. Select the appropriate product from the drop-down menu to display denials for that feature license.
drop-down menu.
select.
A graph is dynamically displayed showing the license denial history for the options selected.
6. To view the data in a tabular format, click the Show tabular data button. The tabular view shows the license
denials for each day as well as the average for each week and the selected period.
7. You can export the data that is currently displayed to a CSV (comma separated value) file by clicking the
Export to csv file button.

Use this option to display the FlexNet licensing activity (lmstat). The license server information, vendor
daemon status and license usage information are displayed in the status window, along with the users
of those features.
Viewing the FlexNet License Status
2. Click the Display FlexNet License Status option.
The FlexNet license status is displayed on the right-hand side of the page.

This option gathers various licensing-related files, logs and information about your license server system
and places them in a single compressed file. This information is useful when requesting support for the
ANSYS License Manager.
Note
On Windows, this process may take a few minutes when msinfo32.exe is running.
Using the Gather Diagnostic Information option:
2. Click the Gather Diagnostic Information option.
3. Click the SAVE TO FILE button.
The ANSYS License Management Center begins to collect the files and information. After the col-
lection process is complete, all files that are found and included in the compressed file are listed.
4. Based upon how your default browser is configured, you will either be prompted for a location to save the
compressed file or the compressed file will be automatically saved to your pre-defined location.
8.3.15.1. Gathering Diagnostic Information outside of ANSYS License Management

Center
If you are unable to access the ANSYS License Management Center but still wish to gather diagnostic
information about your server system, you can run the gatherdiagnostics script located in the
following directory:
Windows:
\Program Files\ANSYS Inc\Shared Files\Licensing\
Linux:
On Windows you must run this script from an administrator command line (do not double-click the
batch file). Running this script from a command line produces a single compressed file. This file contains
the same licensing related files, logs and information produced by running the Gather Diagnostic In-
formation option within the ANSYS License Management Center.
8.3.16. Displaying Queued Licenses

Use this option to see a list of license features that are queued and awaiting availability, and the applic-
able licenses that are being used. The report will have the following format:
FEATURE TIMESTAMP TYPE NAME COUNT HOST STATUS
Feature1 YYYY/MM/DD HH:MM:SS USER User1 1 HostMachine1 IN USE
YYYY/MM/DD HH:MM:SS USER User2 1 HostMachine2 QUEUED
YYYY/MM/DD HH:MM:SS USER User2 1 HostMachine2 QUEUED
N/A HOST_GROUP HPC_CLUSTER 1 RESERVED
Where the first line shows information for the requesting user, and subsequent lines under that license
feature show information for the users who are currently using the licenses for each of the licensed
products that satisfy the requested license feature.
Column Content Descriptions:
FEATURE: The license feature that is being used to satisfy the requested capability.
TIMESTAMP: The date and time that the current license was requested.
TYPE: The type of user. Typically USER but can also be the reserve type from the FlexNet Publisher
options file RESERVE lines for the FEATURE.
NAME: The network username that requested the license. This column could also contain the name of
the RESERVE option from the FlexNet Publisher options file.
COUNT: The number of license(s) requested by the user.
HOST: The host computer requesting the license(s).
STATUS: The current status of the license request. The status can be:
• In Use: The requested license(s) are in use and currently unavailable to other users.
• Queued: The requested license(s) are currently unavailable and the request has been placed in a queue
until the license(s) become available.
• Reserved: One or more licenses have been reserved. For more information on reserved license types,
see the FlexNet Publisher License Administration Guide.
Displaying Queued Licenses
2. Click the Display Queued Licenses option.
The queued license status is displayed on the right-hand side of the page.
8.3.17. Specifying the License Manager Run Mode

This option specifies how the ANSYS Licensing Interconnect is administered in conjunction with FlexNet.
In addition to the default configuration (Run the ANSYS Licensing Interconnect with FlexNet) which
should satisfy most users, ANSYS, Inc. offers two advanced licensing configuration “modes”:
Run the ANSYS Licensing Interconnect without FlexNet –Use this option if you want to run a local
copy of the ANSYS Licensing Interconnect on another machine in addition to the Licensing Interconnect
being run on the license server machine. Your site must still have the Licensing Interconnect and FlexNet
running on the license server machine. With this option, FlexNet licenses will be taken from another
server machine. Note that this is not the default way to set up an ANSYS license server machine and
should be done only if it has been determined that you need this special type of setup. Examples of
when this special type of setup might be used include increasing performance if your server machine
is in a remote location or managing the server load better if your license server machine serves many
users.
Run the ANSYS Licensing Interconnect and FlexNet independently –Use this option if you want to
manage FlexNet Licensing independently of the ANSYS Licensing Interconnect. In this option, you would
continue to manage the ANSYS Licensing Interconnect via the ANSYS License Management Center and
FlexNet Licensing would be managed via another tool, such as Flexera Software's FlexNet Manager.
Note that this is not the default way to set up an ANSYS license server machine and should be done
only by experienced users with well-established licensing procedures.
These options are available for license server machines via the ANSYS License Management Center’s
Specify License Manager Run Mode option only after an ANSYS License Manager installation has been
run on this machine.
Specifying the ANSYS License Manager run mode:
Caution
Changing the run mode will cause the ANSYS License Manager to be shut down and restarted.
2. Click the Specify License Manager Run Mode option.
The License Manager Run Mode Specification page, containing each of the run modes, is displayed.
Note
The default run mode is Run the ANSYS Licensing Interconnect with FlexNet.
3. Select the run mode you want to use.
Enabling Secure Connections to the Web Server (Optional)
4. Click the SUBMIT button to change the run mode.
Note
Clicking any option that is not relevant to your current run mode will cause ANSYS
License Management Center to display a page informing you that this option is
not supported by the current run mode.
8.3.18. Accessing the Help Options

The ANSYS License Management Center “Help” options give you access to documentation and related
product information.
The Help options are:
• View ANSYS Licensing Guide: This option accesses the current PDF version of this guide.
• View FlexNet Licensing Guide: This option accesses the current PDF version of the FlexNet Publisher License
Administration Guide.
• View Licensing Configuration Details: This option displays a table that lists the location, executable name
and current version of programs/tools used for license management functions (FlexNet, Java, Tomcat, etc.).
• About License Management Center: The option includes the ANSYS License Management Center
product information (version number, copyright, etc.).
8.4. Enabling Secure Connections to the Web Server (Optional)

This section presents instructions for enabling secure connections to ANSYS License Management
Center (LM Center), using a Tomcat web server.
When communications between the client browser and the front-end web server need to travel over
an untrusted network such as the Internet, it is highly advisable to use secure connections between
the client browser and the front-end web server. SSL, or Secure Socket Layer, is a technology which allows
web browsers and web servers to communicate over a secured connection. Data is encrypted by each
communicator, transmitted and then decrypted by the other communicator. Additionally, the SSL protocol
authenticates credentials during your initial attempt to communicate over the secure connection.
8.4.1. Understanding Certificates

When implementing SSL, a web server must have an associated Certificate for each external interface
(IP address) that accepts secure connections. This provides a level of identity assurance during commu-
nication. The certificate is cryptographically signed by its owner, and is therefore extremely difficult for
anyone else to forge.
SSL/TLS certificates are typically purchased from well-known Certificate Authorities (CA) such as VeriSign
and Thawte. Using a certificate from a well-established and widely recognized CA confers several benefits
to the web server operator. These include increased credibility and convenience because the root cer-
tificates for popular CAs are prepackaged into major browsers, eliminating the need to distribute anything
to client browsers that will connect to the web site.
If a web server is to be used solely internally within an organization, then the benefits of using a certi-
ficate from a well-recognized Certificate Authority may not be important. Any valid SSL/TLS certificate
can be used to encrypt traffic between client browser and web server as long as the client browser
accepts the certificate. For internal production use, and certainly for test use, it is often sufficient to
create and use an in-house Certificate Authority that can sign SSL/TLS certificates for these use cases.
A certificate that is signed by the same party that created it is known as a self-signed certificate. When
an internally-generated certificate is signed using an in-house Certificate Authority, then a self-signed
certificate is created. Self-signed certificates are perfectly usable for enabling HTTPS connections to a
web server. However, when a browser encounters a certificate that has been signed by an unknown
certificate authority, it will present the user with a warning, such as the following:
Once a user accepts the certificate, the HTTPS connection can proceed.
8.4.2. Configuring Tomcat Using Keytool

In cases where authenticity may be less of a concern but privacy is necessary, Java provides a relatively
simple command line tool called “keytool”. Keytool can create a simple, user-generated “self-signed”
certificate. The following instructions describe how to configure keytool and Tomcat for SSL. We recom-
mend that you read the Preparing the Certificate Keystore and Editing the Tomcat Configuration File
before beginning the configuration.
8.4.2.1. Preparing the Certificate Keystore

Tomcat currently operates only on JKS, PKCS11 or PKCS12 format keystores. The JKS format is Java's
standard "Java KeyStore" format, and is the format created by the keytool command-line utility. This
tool is included in the JDK and is what can be set-up using ANSYS supplied tools. The PKCS12 format
is an internet standard, and can be manipulated via (among other things) OpenSSL and Microsoft's Key-
Manager.
Using the keytool command line, create the keystore file as follows:
Enabling Secure Connections to the Web Server (Optional)
Go to the tools directory in your installation and execute the following platform specific commands:
Windows
cd "C:\Program Files\ANSYS Inc\Shared Files\licensing\tools"
Run the following command to create the file tomcat\conf\keystore:
java\winx64\bin\keytool.exe -genkey -alias tomcat -keyalg RSA -keystore

tomcat\conf\keystore
Linux
cd /ansys_inc/shared_files/licensing/tools
Run the following command to create the file /licensing/tools/tomcat/conf/keystore:
java/linx64/bin/keytool -genkey -alias tomcat -keyalg RSA -keystore tom-

cat/conf/keystore
8.4.2.2. Editing the Tomcat Configuration File

Tomcat can use two different implementations of SSL:
• JSSE implementation provided as part of the Java runtime (since 1.4)
• APR implementation, which uses the OpenSSL engine by default
The JSSE implementation can be set-up using ANSYS supplied tools.
To configure the server.xml file using JSSE do the following:
Go to the licensing/tools/tomcat/conf directory in your installation and edit the server.xml file by adding:
<Connector protocol="org.apache.coyote.http11.Http11NioProtocol"
port="8443" maxThreads="150"
scheme="https" secure="true" SSLEnabled="true"
keystoreFile="conf/keystore"
keystorePass="changeit"
keyPass="changeit"
clientAuth="false" sslProtocol="TLS" />
where "changeit" is the password you specified when you created the keystore file above.
You can now use ANSYS License Management Center with HTTPS by restarting your ANSYS Licensing
Tomcat service and pointing to https://localhost:8443/ANSYSLMCenter.html.
To use the HTTPS secure connection exclusively:
1. Open the server.xml file in the licensing/tools/tomcat/conf directory
2. Remove or comment out the following 1084 connector entry:

<Connector port="1084" protocol="HTTP/1.1"
connectionTimeout="20000"
compression="on"
address="127.0.0.1"
compressionMinSize="2048"
noCompressionUserAgents="gozilla, traviata"
compressableMimeType="text/html,text/xml"
redirectPort="8443" />
8.5. Modifying the Tomcat Port Number
Note
The following procedure can only be used with a default Tomcat installation. This pro-
cedure cannot be used when Tomcat is installed as part of the secure connection option.
For more information, see, Enabling Secure Connections to the Web Server (Option-
al) (p. 61).
By default, the ANSYS License Manager installation sets the Tomcat port number to 1084. To manually
change this value, you must modify the server.xml file located in the following directory:
Windows:
<install_dir>\Shared Files\Licensing\tools\tomcat\conf
Linux:
/ansys_inc/shared_files/licensing/tools/tomcat/conf
To change the Tomcat port number:
1. Open the server.xml file.
2. Locate the line that starts with

<Connector port="1084" protocol="HTTP/1.1"
3. Change the port number from 1084 to your desired number.
4. If Tomcat is already running, the new port value will not be used until Tomcat is restarted. This can
be done in the following manner:
Windows:
Open the Windows Services applet and stop and restart the ANSYS Licensing Tomcat service
(ANSYSLicensingTomcat). The Windows Services applet can be started by issuing the command
services.msc from an administrator command prompt window.
Linux:
a. Stop the Tomcat server process by executing the stop_lmcenter script.
b. Start the Tomcat server process with the new port number by executing the start_lmcenter
script.
These scripts can be found in the following directory:
Changing the Version of Java Used by ANSYS License Management Center
/ansys_inc/shared_files/licensing
Note
Starting the Tomcat server process will also open ANSYS License Man-
agement Center.
8.6. Changing the Version of Java Used by ANSYS License Management

Center
In some scenarios, it may be desirable to use a version of Java other than the version that was shipped
and installed with ANSYS License Manager. This section contains instructions for changing the Java
version used by ANSYS License Management Center.
Note
Changing the version of Java is only possible when the Java version is newer than the
version supplied as part of the ANSYS installation. To view the version of Java installed
by ANSYS, open the ANSYS License Management Center and run the View Licensing
Configuration Details option.
8.6.1. Changing the Java Version During a New Installation of ANSYS License
Manager
Windows or Linux:
1. Prior to performing the ANSYS License Manager installation, set the following environment variable to
point to the location of the Java version you want to use.
ANSYSLM_USER_JAVA_HOME
2. Run the ANSYS License Manager installation.
8.6.2. Changing the Java Version on an Existing Installation of ANSYS License

Manager
Windows:
1. Set the following environment variable to point to the location of the Java version you want to use.
2. As an administrator, re-run the ANSYS License Manager installation or run ansyslm_config.exe -

usemyjava .
By default, ansyslm_config.exe is located in:

C:\Program Files\ANSYS Inc\Shared Files\Licensing\tools\bin\winx64\
Linux:
1. Set the following environment variable to point to the location of the Java version you want to use.
2. Stop any active version of Tomcat by running the stop_lmcenter script.
3. Run the start_lmcenter script to configure Tomcat to use your version of Java and start Tomcat.
Both the start_lmcenter script and the stop_lmcenter script are located in:
Chapter 9: License Administration Using the ANSLIC_ADMIN Utility
For basic license administration, use the ANSYS License Management Center (LM Center). (See License
Server Administration Using ANSYS License Management Center (p. 47) for more information). Some
of the more advanced options have not yet been migrated. This chapter explains how to use the AN-
SLIC_ADMIN utility to perform many of the advanced procedures necessary to administer licenses.
On Windows license server machines, you will have access to a server (full) version of the ANSLIC_ADMIN
utility and an additional client version. The option descriptions below note which options are available
on the Client ANSLIC_ADMIN utility as well as the Server ANSLIC_ADMIN utility. For more information
on the Client ANSLIC_ADMIN utility, see Client Licensing (p. 15).
The Server ANSLIC_ADMIN utility is accessed via Start> All Programs> ANSYS, Inc. License Manager>
Server ANSLIC_ADMIN Utility. Changes made using the Server ANSLIC_ADMIN utility will affect all
users who use that machine as a license server machine, where appropriate. Note that settings such as
Specifying the License Server Machine are always local settings and do not affect other machines,
even on a license server.
From a client machine, you will have access to a limited client version of the ANSLIC_ADMIN utility.
The Client ANSLIC_ADMIN utility is accessed via Start > ANSYS 2019 R1 > ANSYS Client Licensing
> Client ANSLIC_ADMIN Utility 2019 R1 and updates the ansyslmd.ini file in the licensing directory
that resides with the product installation. The Client ANSLIC_ADMIN utility should be used only to
make changes to that local machine's configuration. Changes made using the Client ANSLIC_ADMIN
utility will affect only this machine and will not affect other users.
On Linux machines, you can access only the full version of ANSLIC_ADMIN; no client version is available.
Some options may apply to Linux or Windows systems only and are so noted.
See Configuration Options (p. 39) for details on configuring your license server to use LMTOOLS or
FLEXNet Manager to manage FlexNet. For more information on advanced FlexNet operations, open the
ANSYS License Management Center and select View FlexNet Licensing Guide.
9.1. Using the ANSLIC_ADMIN Utility

To run ANSLIC_ADMIN on Windows, choose Start> All Programs> ANSYS License Manager> Server
ANSLIC_ADMIN Utility (for the server version). To run the utility on Linux, type the following:
/ansys_inc/shared_files/licensing/lic_admin/anslic_admin
To change the language to a localized version of the utility, first issue the following command with the
-setliclang option. On Windows, run:
"<os drive>\Program Files\ANSYS Inc\Shared Files\Licensing\licadmin\anslic_admin.bat"
-setliclang language
On Linux, run:
/ansys_inc/shared_files/licensing/lic_admin/anslic_admin -setliclang language
License Administration Using the ANSLIC_ADMIN Utility
This command changes the language used for both the server ANSLIC_ADMIN utility and the ANSYS
Licensing Interconnect log file. Use the language directory name in the language subdirectory of the
licensing directory (en-us, fr, de, etc.) as the language value. This option is valid only with the
server ANSLIC_ADMIN. Then launch the ANSLIC_ADMIN utility using the above methods.
Important
Changing the language will affect all users of the server ANSLIC_ADMIN utility and the ANSYS
Licensing Interconnect. Verify with your licensing system administrator before making this
change.
To change the language setting locally for only the current session of the server ANSLIC_ADMIN utility,
you can launch the utility using the -lang option:
<os drive>:\Program Files\ANSYS Inc\Shared Files\Licensing\licadmin\anslic_admin
-lang language
or
/ansys_inc/shared_files/licensing/lic_admin/anslic_admin -lang language
Windows 7 Administrator Privileges On Windows 7 machines, you need to always run these AN-
SLIC_ADMIN options as an administrator, preferably with UAC turned off. If UAC is on, even as admin-
istrator, you must right-mouse click the ANSLIC_ADMIN selection from the Start menu and choose Run
as administrator.
Windows 10 Administrator Privileges On Windows 10 machines, you need to always run these
ANSLIC_ADMIN options as an administrator. Additionally, you should right-mouse click the ANSLIC_AD-
MIN selection from the Start menu and choose Run as administrator.
See the User Account Control (UAC) section of the ANSYS, Inc. Windows Installation Guide for more
details on working with Windows and UAC.
We do not recommend running the ANSLIC_ADMIN on Windows machines by double-clicking the ex-
ecutable directly. Doing so could launch the utility with unexpected permission levels.
To use the utility, select an action from the list of buttons on the left.
The ANSLIC_ADMIN utility consists of the following options:
• Launch the ANSYS License Management Center (p. 69) (Server Option)
• Set License Preferences for User (p. 69)
• Run the ANSYS Borrow Utility (p. 70) (Windows only)
• Set Site Preferences (p. 71) -- includes the following options:
– Specify Product Order (p. 71)
– Modify Startup Options (p. 72)
– Specify License Servers to Cache (p. 73)
• View Status/Diagnostic Options (p. 74) -- includes the following options:
Using the ANSLIC_ADMIN Utility
– Display the License Status (p. 74)
– Display Queued Licenses (p. 74)
– Display the Customer Number (p. 75)
From the Tools menu, you can select Set Language Options (server only) and then choose a different
language in which to view the server ANSLIC_ADMIN utility and the ANSYS Licensing Interconnect log
file. You must close and reopen the ANSLIC_ADMIN utility for this setting to take effect. This option is
valid only with the server ANSLIC_ADMIN.
From the Help menu, you can select:
• View the ANSLIC_ADMIN Help
• About ANSYS, Inc. Licensing
• About ANSLIC_ADMIN
To exit the ANSLIC_ADMIN utility, choose File>Exit.
9.1.1. Launch the ANSYS License Management Center

Use this option to launch the ANSYS License Management Center (LM Center). The ANSYS License
Management Center is a browser-based user interface that centralizes many of the ANSYS licensing
administrative functions. For more information, see License Server Administration Using ANSYS License
Management Center.
9.1.2. Set License Preferences for User

Use this option to review the licenses available and prioritize the licenses. Settings specified here apply
only to the username shown in the button title. When you select this option, you will first choose the
release for which you want to set preferences. Select the release and click OK. All licenses available to
you on your license server machine(s) are shown under the appropriate tab on the next dialog:
• Solver
• PrepPost
• Geometry
• HPC
You control the order in which the system attempts to check-out a license by moving the licenses up
and down in the list using the Move Up or Move Down buttons. When you open an application, the
license manager attempts to check-out the license listed first in the list. If unable to check-out that license,
then the license manager attempts to check out the next license in the list that can be used by the
application. The license manager will continue through the list until an available license is found. If
none are found, a message displays.
By default, all licenses available from your license server are shown and marked as available for use. If
you do not want a particular license to be available for your use, select the license in the list, and set
the Use/Don't Use field to 0.
If you received a new license, you may need to reset your preferences. If you had previously set your
license preferences using this option, add the new license to your list in the desired order.
If you have made changes to your license preferences, you can return the settings to the default state
by selecting the Reset to Default button.
When you have completed your changes, click OK to make the changes and close the dialog box. Click
Apply to make the changes without closing the dialog box. Selections you make here will take effect
with any new sessions/license checkouts but will not affect the current session or change the license(s)
currently in use.
ANSYS Workbench users can also specify whether to use the shared or separate licensing method.
For details on setting user license preferences, including shared vs. separate licensing for ANSYS Work-
bench and specifying HPC licensing settings, see Establishing User Licensing Preferences (p. 18).
9.1.3. Run the ANSYS Borrow Utility

License borrowing (available only on Windows machines) allows a user to take a license for use outside
of the company facility, such as for an engineer to take a license home on his laptop. Before users can
take advantage of license borrowing, you need to set up the borrowing environment.
License borrowing is available only if you have borrowable licenses and only on Windows machines;
however, the license server machine that is managing the licenses can be any system that ANSYS, Inc.
supports as a license server. You cannot run both borrowed and non-borrowed licenses simultaneously.
For example, if you borrow licenses but remain connected to a network from which you can use licenses,
you will be able to use only the borrowed licenses. Likewise, if the machine on which you borrowed li-
censes is also a license server from which you could normally use licenses, you would be able to use
only the borrowed licenses.
This option is available only for the client version of ANSLIC_ADMIN.
9.1.3.1. Setting up License Borrowing

To use license borrowing, you must have license keys that specify borrowable licenses. License features
that can be borrowed will contain the keyword BORROW.
You can use the optional FlexNet options file settings to further control borrowing at your site. To use
these settings, you must first specify which users are allowed to borrow licenses by adding an IN-
CLUDE_BORROW group to the options file. Any user not in the INCLUDE_BORROW group will not be
allowed to borrow licenses. You may also want to set up an EXCLUDE_BORROW group to prevent spe-
cific users from borrowing licenses.
You can also limit the number of licenses that can be borrowed from your total pool of borrowable li-
censes. Set the BORROW_LOWWATER option in the options file to the number of licenses that cannot
be borrowed. For example, if you have 15 licenses total and want to limit the number that can be bor-
rowed to 5, set BORROW_LOWWATER=10.
The maximum number of hours a license can be borrowed at any one time is defined by your license
file. You can set that limit lower for your users by setting the MAX_BORROW_HOURS option in the options
file. MAX_BORROW_HOURS cannot exceed the limit specified in your license file. The total maximum
number of borrowable hours is defined by your license agreement.
For more information on license borrowing, see Borrowing Application Licenses on Windows (p. 20).
9.1.4. Set Site Preferences

This option is used for license server machines only.
The following site preference settings are available:
• Specify Product Order (p. 71)
• Modify Startup Options (p. 72)
• Specify License Servers to Cache (p. 73)
9.1.4.1. Specify Product Order

This option launches a utility that allows you to designate the order that the licensed products are listed
in the Mechanical APDL launcher and the order in which licenses are tried in all applications. You first
will need to select the product release. You can choose one of the following:
• Release 11.0: Selecting this option affects the product ordering for Release 11.0 for this machine (including
all users who run a Release 11.0 product on this machine or mount to this machine). If you select this option,
the product ordering you specify will NOT affect any releases after 11.0.
• Release 12.0 and higher: Selecting this option affects the product ordering for Releases 12.0 or later and is
applicable ONLY if this machine is a license server machine. The product ordering you select with this option
will affect all users who use this machine as a license server machine.
After you choose a release level, click OK. You will then need to select the installation directory (Release
11.0 only), product category (Solver, PrepPost, Geometry, or HPC). To re-order the products, select a
product and click the Move up or Move down button. When you have finished reordering all products
that you want to reorder, click Save and then Close.
All products available in a given category are shown, regardless of whether you have licenses for them.
If you have made changes to your product ordering, you can return the settings to the default state by
selecting the Reset to Default button.
For Release 12.0 and higher, after making changes to the product order (including resetting to the de-
fault), you will need reread the license file or restart the license manager for the changes to take effect.
Only those logged in as root or superuser (Linux) or with administrative privileges (Windows) can use
this utility. You should set the product order before any of the users at your site run; once a user sets
his preferences, the user preferences will take precedence.
Note
When installing the License Manager, if you have modified the product order in a previous
release, the installation process will automatically update the product order to reflect any
changes you made as well as any changes (such as naming conventions) that may have oc-
curred between releases.
9.1.4.2. Modify Startup Options
Note
Only those users who are logged in as root or superuser (Linux) or with administrative priv-
ileges (Windows) can use this utility.
Use this option to modify your license manager startup options. License manager startup options that
you can modify include:
ANSYS Licensing Interconnect Debug Log File

You can specify the path to the ANSYS Licensing Interconnect debug log file (ansysli_server.log,
by default), the detail level of the file (standard, connections, or verbose), the size limit of the file (default
is 10MB; minimum is 1MB), and the number of log files to save (default is 10; minimum is 1).
ANSYS Licensing Interconnect Debug Log File Detail Descriptions
• STANDARD level logs ansysli_server STARTUP options, license cache information (such as fea-
tures/counts and FlexNet options file content), CHECKOUT, CHECKIN, RESERVE, and RETURN_RESERVE.
It also logs CLIENT_SHUTDOWN for all but ansysli_monitor.
• CONNECTIONS level logs everything that STANDARD logs, and CLIENT_ACCEPT and CLIENT_SHUTDOWN
for the monitor.
• VERBOSE level logs STANDARD plus CONNECTIONS, and ADD (product definitions and shared capabilities)
and REMOVE (shared capabilities).
FlexNet Options
You can specify the path to the FlexNet debug log file (license.log, by default). By default, a new li-
cense.log file is created each time you start the license manager; you can choose to have new inform-
ation appended to the existing file instead.
You can also set the -local setting (Linux only).
The -local option restricts the ability to shut down the FlexNet components of the license manager
to only an administrator running on the same machine where the FlexNet components of the license
manager was started. This option is off by default. See the FlexNet License Administration Guide for
more information on using this option.
The -local option is not recommended if you will be using license borrowing.
Miscellaneous Options
You can specify the ANSYS Licensing Interconnect port number here. The default port number is 2325.
All machines that have this server machine in their Licensing Interconnect paths must use the same
port number. If you change the Licensing Interconnect port number here, and other machines use
this machine's Licensing Interconnect, then on each of those machines, you must change the Licens-
ing Interconnect port number by one or both of the following options, as appropriate for your
configuration:
• Specify the License Server Machine option of the ANSLIC_ADMIN utility
• Specify License Servers to Cache option of the ANSLIC_ADMIN utility
You can also disable the ability to reserve licenses for a design point study in ANSYS Workbench
and/or the users' ability to track licenses used by ANSYS Workbench. For more information on re-
serving licenses for design point studies in ANSYS Workbench, see Reserving Licenses for Design Point
Studies in the ANSYS Workbench documentation.
On Linux machines only, you can also specify who can shut down the ANSYS License Manager. By
default, anyone can stop the license manager. You can restrict shutdown capabilities to only the
user who started it, or to a group, such as lmadmin. If you choose group, you will need to specify
the name of the group. If you specify a group restriction, any users in that group who want to stop
the license manager must have the specified group as their primary group. Note that the user who
started the license manager will still be able to shut it down, even if he is not part of a group with
shutdown capabilities.
Warning
The license.log file and the ansysli_server.log file for each server should be
located on a local disk. Writing to an NFS-mounted disk or remote file server creates a situ-
ation where the license server(s) may fail. If the remote system containing these files crashes,
the license manager would be unable to log license transaction data. This would create a
fatal error condition.
9.1.4.3. Specify License Servers to Cache

When the Licensing Interconnect starts, it caches the licenses for any ANSYSLI_SERVERS lines that are
in the ansyslmd.ini file in addition to its own licenses. As you run ANSYS applications and they
connect with the Licensing Interconnect, it caches the licenses for any servers in your ANSYSLI_SERVERS
path that have not yet been cached. Sometimes, especially due to network traffic, this caching process
can impact the time it takes to check out a license. Use this option to cache your servers when you
start the ANSYS License Manager, rather than at the point that you request individual licenses.
Note
Only those users who are logged in as root or superuser (Linux) or with administrative priv-
ileges (Windows) can use this utility.
When you select this option:
1. On the Specify License Servers to Cache dialog, click Add Server Machine Specification.
2. On the Specify License Servers to Cache - Edit Selected Server Machine dialog box, enter the Licensing
Interconnect port number. The default Licensing Interconnect port number is 2325.
3. Enter the hostname of the server.
4. Click OK.
5. Repeat steps 1 - 4 for any additional servers that you want to cache.
6. When you have finished specifying servers, click Close on the Specify License Servers to Cache dialog.
To delete a cached server, highlight the server in the list and click Delete Selected Server Machine.
To edit a cached server, click one of the listed servers and click Edit Selected Server Machine. You can
then change the ANSYS Licensing Interconnect port number or the hostname(s).
9.1.5. View Status/Diagnostic Options

The following reporting options are available:
• Display the License Status (p. 74)
• Display Queued Licenses (p. 74)
• Display the Customer Number (p. 75)
• Gather Client Diagnostic Information (p. 21) (Client Option)
When you select one of these options, the data will appear in the log area on the right side of the
utility. Display the Customer Number appends the customer number to the session log itself; the
other options create their own display in the log area. Each option is explained in the following sections.
9.1.5.1. Display the License Status

Use this option to see the status of licensing activity. All features are displayed in the status window,
along with the users of those features. You can append this information to the session log or write it
directly to a file using the buttons at the bottom of the window. This option displays information based
on the same license path rules as ANSYS, Inc. products, taking into account the settings in the AN-
SYSLMD_LICENSE_FILE environment variable and the ansyslmd.ini and license files. Setting the
ANS_FLEXLM_DISABLE_DEFLICPATH environment variable will affect the information displayed by
this option.
9.1.5.2. Display Queued Licenses

Use this option to see a list of capabilities that are queued and awaiting availability, and the applicable
licenses that are being used. The report will have the following format:
Capability Timestamp User Count Host PID Platform
Product1 Count
Timestamp User1 Count Host PID Platform
Timestamp Usern Count Host PID Platform
Product2 Count
Timestamp Usern Count Host PID Platform
Where the first line shows information for the requesting user, and subsequent lines under that capab-
ility show information for the users who are currently using the licenses for each of the licensed products
that satisfy the requested capability.
An example report is shown below. Each line is numbered for reference in the discussion following the
example. Note that the actual report does not contain line numbers.
Capability Product Timestamp User Count Host PID Platform
1 ANS_SOLVER 2010/04/27 09:39:27 JQD 1 mach1.win.acme.com 1234 winx64
2 ane3fl 3
3 2010/04/27 08:01:10 JXS 1 mach2.win.acme.com 5678 winx64
4 2010/04/27 07:29:13 MQD 2 mach3.win.acme.com 8765 winx64
Line 1: User JQD is running a process, 1234, on the machine mach1.win.acme.com, which has requested
one license with the ANS_SOLVER capability.
Line 2: Based on the site/user preferences, the ane3fl product can satisfy the requested capability, and
this site/user is permitted to use up to 3 licenses of this product.
Line 3: User JXS has been using 1 of the available licenses since 8:01:10, from machine
mach2.win.acme.com, running process number 5678.
Line 4: User MQD has been using 2 of the available licenses since 7:29:13, from machine
mach3.win.acme.com, running process number 8675.
Since users JXS and MQD are already using all of the available licenses, user JQD must either wait for
one of those licenses to be freed, or contact one of those users and request that a license be freed.
Select the Auto-Refresh button to have the information automatically refresh every five (5) seconds.
You can also display the queuing report via command line, without launching the ANSLIC_ADMIN
utility. To do so, run the following command on Windows systems:
"C:\Program Files\ANSYS Inc\Shared Files\Licensing\licadmin\anslic_admin" -queueinfo
If you need to view the queuing report frequently, you may find it convenient to set a desktop shortcut
using the above command.
Run the following command on Linux systems:

/ansys_inc/shared_files/licensing/lic_admin/anslic_admin -queueinfo
9.1.5.3. Display the Customer Number

Use this option to display your customer number (necessary when requesting customer support). The
license manager must be running for you to obtain your customer number.
Chapter 10: Using Dongles with the ANSYS License Manager
Important
• CRITICAL SECURITY ISSUE: For machines that already have the FLEXID9 (Sentinel/Aladdin USB)
dongle driver installed, Flexera strongly recommends updating older versions of the dongle
driver to version 7.60 to address vulnerabilities related to possible exploits of port 1947.
• When using dongles, after installing a new release of the ANSYS License Manager, the dongles
may not be recognized again by the license manager until the licensing configuration process
has been completed by handling the manual steps detailed in this section. To avoid affecting
currently running ANSYS jobs, you will need to use caution when upgrading the license manager.
• Only the dongle driver that is included as part of our installation files is fully supported by ANSYS,
Inc. The driver version required for Release 2019 R1 is detailed in the File Information and Supported
Dongle Driver Versions (p. 78) section below. We strongly recommend that you use this version
of the driver. If you use any other version, including older versions that we provided, ANSYS, Inc.
can provide only limited support if you encounter problems. Flexera has stated that they will not
provide any support for drivers other than the version that we include with our installation.
Due to requirements of non-ANSYS products that are installed on the machine or because
of operating system levels that ANSYS, Inc. supports but the driver included in the ANSYS
installation does not, you may need to use a version of the driver other than the one that
we provide. You will need to choose which driver to use based on your individual business
needs. Unfortunately, we cannot ensure that our license manager will work with that driver.
This section explains dongle and dongle driver support and usage with ANSYS, Inc. products at Release
2019 R1. The information applies to the ANSYS License Manager only and does not apply to any other
license managers that you may be using. The following procedures assume that you have some famili-
arity with dongles, their usage, and their advantages and disadvantages.
10.1. Assumptions, Restrictions, and Notes

The ANSYS License Manager supports limited dongle usage:
• Flexera does not recommend using dongles with license servers running on virtual machines.
• ANSYS, Inc. supports only FLEXID9 (Sentinel/Aladdin USB) dongles and their Flexera-provided drivers.
• ANSYS does not support license borrowing for any license features tied to a dongle.
When we refer to dongles, we are specifically referring to FLEXID9 (Sentinel/Aladdin USB) dongles.
Every machine from which you are serving licenses tied to a dongle requires the following:
• ANSYS License Manager is installed on the machine.
Using Dongles with the ANSYS License Manager
• Dongle is inserted in an appropriate USB slot.
• Required version of the dongle driver is installed on the machine. This manual step is described in detail
below.
• Flexera-provided FLEXID9 library is in the correct location on the machine. The ANSYS License Manager in-
stallation's licensing configuration process handles this step for Windows machines. On Linux, copying this
file to the correct location is a manual step included in the Linux Procedures (p. 81) section below.
The dongle driver version required for Release 2019 R1 is detailed in the File Information and Supported
Dongle Driver Versions (p. 78) section below. If the specified version of the dongle driver is already installed
on your machine, no additional action should be required to use dongles with this release of the ANSYS
License Manager. However, if you encounter problems, we recommend that you refer to Dongle
Troubleshooting (p. 83) at the end of this section and that you go through the steps below for your
machine’s platform.
All ANSYS paths shown in this document show the default installation directory. If your installation
directory is not the default location, replace all ANSYS paths with your installation directory. The default
installation directories are as follows:
Windows: C:\Program Files\ANSYS Inc

Linux: /ansys_inc
You must have administrator/root privileges to install or remove a dongle driver.
10.2. File Information and Supported Dongle Driver Versions

The tables below provide platform-specific information about the supported dongle driver version and
the files that will be used as part of the driver installation process.
Note
The compressed files' names and their uncompressed directory names may not match
the FlexNet version information shown in these tables.
Table 10.1: 64-bit Windows File Information and Supported Dongle Driver Version
Compressed Driver Version and FlexNet FLEXID9 Shared FlexNet Version

File Installation File Library
11_15_1_0.zip haspdinst.exe, version haspsrm_win64.dll, version 7.6 11.13.1.2/11.13.1.3
7.60
Table 10.2: 64-bit Linux File Information and Supported Dongle Driver Version
Compressed Driver Version and FlexNet FLEXID9 Shared FlexNet Version

File Installation File Library
11_15_1_0.tar aksusbd-7.60-1.i386.rpm, libhasp_linux_x86_64.so, version 11.13.1.2/11.13.1.3
version 7.6 7.6
Windows Procedures
10.3. Supported Platforms

The following operating system (OS) levels are supported by the dongle drivers supplied with ANSYS
2019 R1. However, ANSYS 2019 R1 may not support all of the listed OS levels. For detailed and current
ANSYS platform support information, see the Platform Support section of the ANSYS, Inc. website
(Support>Platform Support).
Table 10.3: 64-bit Windows Support
Driver OS Level Support

Windows Server 2012 R2 and 2016; Windows 7 SP1; and Windows 10, up through version 1703 (Insider
Preview builds are not supported)
Table 10.4: 64-bit Linux Support
Linux Operating System Driver OS Level Support

RHEL 6.x and 7.x
SLES 11 SP3, 11 SP4, and 12
10.4. Windows Procedures
Caution
Do not allow Windows Update to install later versions of the dongle driver as this is not
the Flexera-provided version. Automatic updates can cause unpredictable behavior with
dongles, such as:
• Features that require the dongle cannot be checked out.
• The dongle FLEXID (hostid) is not returned correctly.
• The dongle driver cannot be removed using the methods described in this document.
10.4.1. Installing/Updating the Dongle Driver on Windows
Caution
Removing a dongle or its driver may seriously disrupt your ability to run any product
that uses it. Therefore, do not remove a dongle or its driver until you determine that all
products that might be using it have been closed. Always stop all license managers that
use the dongle and remove the dongle from the system before removing any existing
driver. (These steps are detailed below for the ANSYS License Manager.)
To install the ANSYS-supplied driver on Windows systems, follow the steps below. You must have system
administrator privileges to install this driver.
1. Install the Release 2019 R1 ANSYS License Manager.
2. Confirm that the license manager is stopped by verifying that the 'ANSYS License Manager' service is not
running.
3. Remove all FLEXID9 dongles attached to your machine. Do not attach any dongles to the system again
until told to do so in this document; if a dongle is plugged in before you have completed the driver install-
ation, the Windows operating system could automatically install a non-Flexera driver.
4. In Windows Explorer, navigate to the following directory:
C:\Program Files\ANSYS Inc\Shared Files\bin\winx64\drivers\flexnet
5. Extract the contents of the 11_15_1_0.zip file into C:\Program Files\ANSYS Inc\Shared
Files\bin\winx64\drivers\flexnet. You will need to remove 11_15_1_0 from the end of the
default directory shown, if it is included.
6. Open an administrator command prompt window and perform the following steps:
a. Remove any existing driver on your system. See the Removing an Existing Dongle Driver on Win-
dows (p. 80) section below for more information.
b. Navigate to the following directory:
C:\Program Files\ANSYS Inc\Shared

Files\bin\winx64\drivers\flexnet\11_15_1_0
c. Issue the following command:
haspdinst.exe -install
7. When the installation completes, restart the machine.
Note
You may not see the new driver until the dongle has been inserted into the machine.
However, do not insert the dongle until the next step.
8. After the machine has restarted, insert the dongle. Wait until the dongle's LED light is red and is not flashing.
If you have multiple dongles, wait until the light is red (and not flashing) before inserting the next one.
9. To see if the dongle is being recognized, open the ANSYS License Management Center and click the Get
System Hostid Information link. If the dongle is recognized, you will see a FLEXID9 Dongle ID (F) entry
under the IDTYPE column. (You can open the ANSYS License Management Center by clicking the ANSYS,
Inc. License Manager > ANSYS License Management Center item on the Windows Start menu/Apps
page.)
10.4.2. Removing an Existing Dongle Driver on Windows
Caution
Removing a dongle or dongle driver may seriously disrupt your ability to run any product
that uses the dongle. Therefore, do not remove a dongle or dongle driver until you de-
termine that it is safe to do so for all products using the dongle. Always stop all license
managers that use the dongle and remove the dongle from the system before removing
any existing driver.
Linux Procedures
Before installing the ANSYS-supplied driver, you must remove any existing dongle driver from your
system. You will need to use the installer or removal utilities provided with that driver to remove it.
See the documentation provided with that driver for specific commands or procedures, or if you en-
counter problems.
Copies of the FLEXID_Dongle_Driver_installer.exe and FLEXIDCleanUtility.exe files discussed in this

section are included in the following file's contents, which must be extracted to use either of these files:
C:\Program Files\ANSYS Inc\Shared

Files\bin\winx64\drivers\flexnet\11.9.1.0.zip
1. Uninstall the appropriate driver as described below.
• To remove a dongle driver supplied at ANSYS Release 16.0 or higher, run the following command while
in the 11_15_1_0 subdirectory:
haspdinst.exe -fremove -killprocess -purge
• If the dongle driver has been updated through a Windows Update, it must be removed using the tools
provided by SafeNet, Inc. Refer to SafeNet's documentation for details.
• The FLEXID_Dongle_Driver_Installer.exe file was the driver installation file that ANSYS, Inc. provided
prior to Release 16.0. If you used it to install an earlier version of the ANSYS-supplied dongle driver,
perform the following steps to remove it.
– Run the following command while in the 11.9.1.0 subdirectory:
FLEXID_Dongle_Driver_Installer.exe /remove
– Select the driver to uninstall and click Next.
• If you used the FLEXIDInstaller.exe file to install an earlier version of the dongle driver, you can use either
the cleanup utility provided for use with the FLEXIDInstaller utility or use the Programs and Features
option from the Windows Control Panel. To use the cleanup utility, run the following command while
in the 11.9.1.0 subdirectory:
FLEXIDCleanUtility.exe
2. Restart the machine.
10.5. Linux Procedures

10.5.1. Installing/Updating the Dongle Driver on Linux
Caution
Removing a dongle or a dongle driver may seriously disrupt your ability to run any
product that uses the dongle. Therefore, do not remove a dongle or dongle driver until
you determine that it is safe to do so for all products using the dongle. Always stop all
license managers that use the dongle and remove the dongle from the system before
removing any existing driver. (These steps are detailed below for the ANSYS License
Manager.)
To install the ANSYS-supplied driver on Linux systems, follow the steps below. You must have root
permissions to install this driver.
1. Install the Release 2019 R1 ANSYS License Manager.
2. Confirm that the license manager is not running.
3. Remove all FLEXID9 dongles attached to your machine. Do not attach any dongles to the system again
until told to do so in this document.
4. Remove any existing driver on your system, if necessary. See the Removing an Existing Dongle Driver on
Linux (p. 83) section below to determine if you must remove an existing driver.
5. Navigate to the directory:
/ansys_inc/shared_files/bin/linx64/drivers/flexnet
6. Extract the 11_15_1_0.tar file.
7. Go to the subdirectory containing the 11_15_1_0.tar file's contents, and do the following:
a. Copy the libhasp_linux_x86_64.so file to the /usr/lib directory.
Note
If this file already exists in the /usr/lib directory, rename it before copying
the file. If the files are identical, no action is required.
b. SUSE 12 SP2 only: Installation of version 7.6 of the dongle driver requires the following additional
commands to be issued at this point:
systemctl enable aksusbd
systemctl start aksusbd
c. Run the following command to install the driver:
rpm -i ./aksusbd-7.60-1.i386.rpm
8. Reboot the machine.
Note
You may not see the new driver until the dongle has been inserted into the machine.
However, do not insert the dongle until the next step.
9. After the machine has restarted, insert the dongle. Wait until the dongle's LED light is red and is not flashing.
If you have multiple dongles, wait until the light is red (and not flashing) before inserting the next one.
10. To see if the dongle is recognized, open the ANSYS License Management Center and click the Get System
Hostid Information link. If the dongle is recognized, you will see a FLEXID9 Dongle ID (F) entry under
Dongle Troubleshooting
the IDTYPE column. You can bring up the ANSYS License Management Center by running the following
script:
/ansys_inc/shared_files/licensing/start_lmcenter
10.5.2. Removing an Existing Dongle Driver on Linux
Caution
Removing a dongle or dongle driver may seriously disrupt your ability to run any product
that uses the dongle. Therefore, do not remove a dongle or dongle driver until you de-
termine that it is safe to do so for all products using the dongle. Always stop all license
managers that use the dongle and remove the dongle from the system before removing
any existing driver.
1. Before installing the new driver, you must determine whether an existing driver must first be uninstalled.
• If the existing driver was installed via the script method (i.e., using the dinst script provided with the
older version of the driver) rather than by using the rpm method, you may not need to remove the cur-
rently installed driver before installing the new driver. The rpm installation method that will be used to
install the new driver should replace the existing driver with the new driver. If you decide to uninstall
this driver, you must use the dinst script that you used to install it.
• If the existing driver was installed via the rpm method, you must uninstall this driver before installing
the ANSYS-supplied driver. (As of ANSYS Release 16.0, the only FlexNet-provided driver installation
method has been the rpm method.)
2. If you uninstalled a driver, reboot the machine.
10.6. Dongle Troubleshooting

• On Linux systems, if you encounter “transaction lock” error messages, you may not have root privileges. Log
in as root and retry the operation.
• If you have installed the new driver, rebooted the machine, and attached the dongle to the system, but the
dongle is not recognized, confirm that the following file exists in the location below:
Windows: <OS drive>\Windows\System32\haspsrm_win64.dll
Linux: /usr/lib/libhasp_linux_x86_64.so
If the file is missing, copy the installation's file with that name from the ANSYS FlexNet driver directory
to the required location for your machine's platform. Additional details are available in the appropriate
platform section above.
• SUSE 12 SP2 only: Version 7.6 of the dongle driver fails if the following commands were not issued before
installing the driver:
systemctl enable aksusbd
systemctl start aksusbd
Chapter 11: Troubleshooting
This chapter lists problems and error messages that you may encounter while setting up licensing. After
each situation description or error message is the user action required to correct the problem.
For more troubleshooting information, see the FlexNet License Administration Guide (accessible from the
ANSYS License Management Center).
The following troubleshooting topics are available:

11.1. Getting Additional License Debug Information
11.2. Gathering Diagnostic Information
11.3. Problem Situations
11.4. Licensing Error Messages
11.5. License Manager Installation Directory Errors
11.6. ANSYS License Borrowing Errors
11.7. FlexNet License Log File Errors
11.8. Contacting Technical Support
11.1. Getting Additional License Debug Information

Use the following suggestions to display or generate additional error messages and debugging inform-
ation.
• View the licdebug file. The licdebug file is generated when you run an ANSYS, Inc. application and
resides in the .ansys subdirectory under the directory specified by the TEMP environment variable (Win-
dows) or in the $HOME directory (Linux). The licdebug filename will vary depending on the product but
will follow the format licdebug.<product>.193.out. For example:
If a licdebug file already exists and is dated today, the information is appended. If it is dated before
today, the existing file will be renamed with a .old extension and a new file will be started.
– Mechanical APDL (ANSYS): licdebug.ANS_SOLVER.193.out
– ANSYS Workbench: licdebug.ANS_WB.193.out
– Mechanical: licdebug.MECH.193.out
– ANSYS Fluent: licdebug.FLUENT_SOLVER.193.out
– ANSYS Polyflow: licdebug.POLYFLOW.193.out
– ANSYS CFX-Pre: licdebug.CFX_PRE.193.out
– ANSYS CFX Solver: licdebug.CFX_SOLVER.193.out
– ANSYS CFD-Post: licdebug.CFD_POST.193.out.
– ANSYS ICEM CFD (includes AI*Environment): licdebug.ICEM_AM.193.out
Troubleshooting
– ANSYS Icepak: licdebug.ICE_PAK.193.out
– ANSYS LS-DYNA: licdebug.DYNA_SOLVER.193.out
– Connection functionality: licdebug.ANS_PM.193.out
Note
The license debug file names include the current release of the application. Because not
all applications are updated with each release, it is possible to have lic\debug file names
that are appended with older release numbers. For example, it is possible to be running
ANSYS Release 16.1 but still have a product license debug log file name include 160 as in
licedbug.POLYFLOW.160.out.
The directory specified by the TEMP environment variable may be hidden on your system. To view
the directory and file, click My Computer. Choose Tools from the menu, and then click Folder options.
Click the View tab and select Show hidden files and folders. Click OK.
If after following these suggestions, the resulting debug information does not make sense, try these
suggestions:
• Confirm that the license manager was restarted or the license file was reread after any changes were
made to the license file. If you did not make any changes to the license file for the server, check the
date/time that it was last changed. Get the relevant path information from the debug output. Also,
confirm that the same path is being used.
• Try restarting the license manager and then attempt to run again. See if the same situation occurs.
• If you installed a new license file but are not seeing it even after restarting the license manager, confirm
that the correct license file is being used to start the license manager. In this case, neither the client
application nor the license manager is using the changed file. Also confirm that if site or user license
preferences were set, the preferences were updated with the new license information.
• If the ansyslmd.lic file is at the end of the path and it is a license file that uses the license manager
daemon/service, then confirm that the license manager is started with the same path as the an-
syslmd.lic file's path. The license manager could be looking at one file in the client application but
the license manager daemon/service was started with another file.
11.2. 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.
Problem Situations
11.3. Problem Situations

This section describes problems you may encounter when setting up licensing or running an ANSYS
product, as well as actions you can take to correct the problems.
11.3.1. License Manager Will Not Start

If the license manager will not start, perform the tests below in the order they are listed:
1. Check the license.log file in the licensing directory on the license server for errors. See the re-
mainder of this chapter for a list of possible errors and their resolutions.
2. Check the ansysli_server.log file in the licensing directory on the license server for errors.
3. Verify that TCP/IP is installed and configured correctly. Verify that the IP address is static. See Config-
uring TCP/IP (p. 39) for information about configuring TCP/IP.
4. Verify that the hostid has not changed. If the hostid has changed, you must obtain a new license.
Linux x64 Systems:
Linux x64 systems running the ANSYS License Manager require the Linux Standard Base (LSB) package.
If this package is missing, you will see one of the following errors when the license manager attempts
to run:
/lmgrd -h
./lmgrd: No such file or directory
In this case, try installing the LSB package from the Linux installation media.
Three-Server Environment
In a three-server environment, you could see the following message when you start the first server:
***Attempting to start the license manager...
Start the License Manager status:
The license manager failed to start.
This message results when a quorum of servers (2 of the 3) are not yet started. Start the other
servers, or verify that they are already started. When at least two of the three servers are started,
you will see the ANSYS License Management Center of this server change to reflect that it is now
running. Do NOT attempt to stop the license manager by clicking the Stop button in the ANSYS
License Management Center.
Troubleshooting
If you verify that at least two servers are started and the ANSYS License Management Center does
not update to running in a reasonable time, follow the three steps noted in License Manager Will
Not Start (p. 87).
Caution
When you see this message, do NOT click the Start button again.
11.3.1.1. License Manager Will Not Start After Adding a License File
In cases where License Management Center is used to add a UTF-8 formatted license file on a Linux
or SuSE system, license manager will not start if the LANG settings are not configured for UTF-8. In this
case, you will need modify the LANG settings to accept UTF-8, delete and re-add the license file by
following the steps below.
1. Verify that the license file is UTF-8 formatted by opening the file in a text editor. If the file starts with three
question marks (???) then the file is UTF-8 formatted.
2. If the license file is UTF-8 formatted, modify the LANG settings to accept UTF-8.
Red Hat
/etc/sysconfig/i18n
LANG="en_US.UTF-8"
LC_COLLATE="C"
SuSE
/etc/sysconfig/language
RC_LANG="en_US.UTF-8"
RC_LC_COLLATE="C"
3. Exit out of your current terminal.
4. Restart Tomcat by performing the following steps:
a. Stop the Tomcat server process by executing the stop_lmcenter script.
b. Start the Tomcat server process with the new port number by executing the start_lmcenter script.
These scripts can be found in the following directory:

/ansys_inc/shared_files/licensing
Note
Starting the Tomcat server process with the start_lmcenter script will also open
ANSYS License Management Center.
Problem Situations
5. From the license_files directory, delete the UTF-8 formatted license file that was just added.
6. Open License Management Center and re-add the UTF-8 formatted license file.
11.3.2. License Manager Will Not Stop

When you attempt to stop the license manager, it may not stop immediately. You should use the Stop
the ANSYS, Inc. License Manager option of the ANSYS License Management Center to stop the license
manager. For more information, see Stopping the ANSYS License Manager (p. 50). We do not recommend
stopping the license manager manually; however, if you choose to do so, you must stop the components
in the following order:
1. ansysli_monitor
2. Licensing Interconnect (ansysli_server)
3. FlexNet components (lmgrd first, followed by ansyslmd)
11.3.3. License Manager Will Not Stop in a Three-Server Environment

When you attempt to stop the license manager in a three-server environment, the license manager
does not stop immediately. You will see a message stating that the currently-installed license file is a
three-server license file. With three-server license files, the license manager could take 60 seconds or
longer to successfully stop. Wait at least 60 seconds. When the license manager has successfully stopped,
the ANSYS License Management Center will show that it is stopped. For more information, see Setting
Up Redundant (Triad) Servers (p. 44).
11.3.4. License Manager Installation's Licensing Configuration Step to Update

Site Preferences (Product Order) Fails
Note
This step is only required if the license server's site preferences have been customized
via the ANSLIC_ADMIN Utility's Set Site Preferences > Specify Product Order option. However,
it is safe to follow the procedure below even if the site preferences have not been cus-
tomized. Therefore, if you don't know if the server has customized site preferences, you
should follow this procedure.
If the ANSYS License Manager's licensing configuration log file (install_licconfig.log) indicates that the
step to automatically update any existing site preferences (product order) failed, the following procedure
can be used to manually update your modified product order file to include any product changes that
have occurred in the most recently installed release of the ANSYS License Manager.
1. Examine the section of the licensing configuration log that contains the error message to see if any details
were provided describing why the automatic processing failed. If so, this issue will need to be resolved
before continuing.
2. Follow the section below for your operating system. <install_dir> is the directory in which the ANSYS License
Manager is installed.
Windows:
Troubleshooting
Open an administrator command prompt window and issue the following command:
"<install_dir>\Shared Files\Licensing\winx64\ansysli_util.exe" -updatesiteprefs
Linux:
Open a command line window and issue the following command:

"<install_dir>/shared_files/licensing/linx64/ansysli_util" -updatesiteprefs
3. A message should be displayed after the ansysli_util command is run. (If not, there is a problem.) Examine
the message to determine if the command completed successfully. If not, resolve any issues and run the
command again. If you are unable to resolve the issues, contact ANSYS Technical Support.
4. Once the command completes successfully, examine the message to see if site preferences were updated
or removed. If so, either reread the license manager settings or restart the license manager so the changes
are recognized by the ANSYS License Manager.
11.3.5. The Application Does Not Show the Correct License(s)

If you do not see the correct licenses in your application, in Client ANSLIC_ADMIN's Set License Pref-
erences for User option, or in the Mechanical APDL Product Launcher, check the following:
1. If you received a new license but your application does not recognize it, you may need to reset your pref-
erences. If you had previously set your license preferences, select Set License Preferences for User from
the ANSLIC_ADMIN utility and add the new license to your list in the desired order.
2. If you had previously defined your preferences and have since installed the license manager to a different
location, you may need to reset your preferences.
3. If you do not see the correct licenses in the Client ANSLIC_ADMIN's Set License Preferences for User
option or in the Mechanical APDL Product Launcher, and you updated your product order at a previous
release, you may need to update your product order again. Use the Specify Product Order option under
Server ANSLIC_ADMIN's Set Site Preferences.
On the license server machine:
1. Select the Reset to Default button to see the current release's default product order.
2. Reorder the products as you want, including any new products.
For more information, see Specify Product Order (p. 71) and Establishing User Licensing Prefer-
ences (p. 18).
11.3.6. FlexNet Log File Shows Unexpected Messages When the License
Manager Is Stopped
On Windows systems, you may see unexpected error messages in the FlexNet licensing log file when
you shut down the license manager. Messages similar to the following could appear:
13:47:49 (lmgrd) Shutting down ansyslmd pid=1860 because of signal 15
13:47:49 (lmgrd) Can't connect to the license server system. Shutdown ansyslmd failed.
Problem Situations
13:47:49 ((lmgrd)) 13:47:49 Loop info:(lmgrd) Cannot read data from license server system. (-
16,10009:10054 "WinSock: Connection reset by peer")
MT:0 VD_HB:5913:47:49 (lmgrd) reset:0Can't shutdown the license server system. Shutdown an-
syslmd failed. clients:013:47:49 (lmgrd) fd's:0EXITING DUE TO SIGNAL 15
13:47:49 (lmgrd) ansyslmd exited with status 58 ()
13:47:49 (lmgrd) Since this is an unknown status, license server
13:47:49 (lmgrd) manager (lmgrd) will attempt to re-start the vendor daemon.
13:47:49 (lmgrd) EXITING DUE TO SIGNAL 1
13:47:49 (lmgrd) Can't remove statfile C:\Documents and Settings\All Users\Application

Data\Macrovision\FlexNet\lmgrd.620: errno No such file or directory
These or similar messages in the FlexNet log file can be safely ignored in most cases. You can verify
that the service is shown as stopped, and that the ansysli_server, ansysli_monitor, lmgrd,
and ansyslmd processes are stopped via Task Manager.
11.3.7. Unable to Check Out Licenses

If the license manager appears to start but you cannot check out any licenses, perform the tests below
in the order they are listed:
1. Review the Licensing Interconnect debug log file for more information. Use the View Licensing Interconnect
Log option of ANSYS License Management Center to view the file.
2. On the license server machine(s), review the FlexNet license.log file for error messages. Use the View
FlexNet Debug Log option of ANSYS License Management Center to view the file.
3. If neither log file exists or has a zero length, verify that you have write permissions on the files and on the
directory containing the files (the licensing directory by default).
4. If you have borrowed licenses, verify that you are not attempting to check out a non-borrowed license.
Once you have borrowed one or more licenses, you will not be able to use non-borrowed licenses until
you have returned all borrowed licenses. For more information, see Borrowing Application Licenses on
Windows (p. 20)
You could also encounter problems with obtaining a license if the Licensing Interconnect is still attempt-
ing to restart the FlexNet server. Check the FlexNet license.log file. If you see the following lines
multiple times, try rebooting your license server machine:
(lmgrd) ansyslmd exited with status 28 (Communications error)
(lmgrd) Since this is an unknown status, license server
(lmgrd) manager (lmgrd) will attempt to re-start the vendor daemon.
(lmgrd) REStarted ansyslmd (pid 103864)
Troubleshooting
11.3.8. Jobs Abort When a License Manager Goes Down in Three-Server Envir-
onment
If you are running in a three-server environment and ANSYS program jobs abort when one of the license
managers goes down, perform the tests below in the order they are listed:
Note
1. If this problem persists after you perform the steps below, you may want to consider switching
to a single-server environment.
2. When using a three-server environment, we strongly recommend that all three servers be on
the same subnet. If this is not the case, you should consider using three machines which are in
the same physical location and are on the same subnet.
1. Verify that two of the three license managers are still running. Use the ANSYS License Management
Center Displaying the FlexNet License Status option. If the license manager is not already running on
all servers, start it on all of them.
2. Check the ansyslmd.ini file in the licensing directory to make sure the server specification is correct.
3. Check to see whether the ANSYSLI_SERVERS or ANSYSLMD_LICENSE_FILE environment variable is set.

If it is, verify that the settings are correct.
4. Verify that the same license file exists on all three license servers in the licensing directory. The hostnames
of all three servers must appear in these files and in the same order. If the license files are not the same on
all three servers, make corrections as necessary and restart the license manager.
5. Verify that the date and time on all license servers are consistent and correct. Make corrections as necessary
and restart the license manager.
6. Verify that the hostid has not changed on any of the license servers. If any hostid has changed, you need
to obtain and install new licenses on all license servers.
7. Verify that the license manager and utilities are installed locally on each license server. If not, run the in-
stallation and choose to install the license server only. See the installation manual for your product and
platform for more information.
8. Verify that the ansyslmd.opt files match exactly on all three license servers.
9. Check the FlexNet license.log and the licensing interconnect ansysli_server.log files for error
messages. See the remainder of this chapter for a list of possible errors and their resolutions.
11.3.9. Licensing Log File Not Created

On Windows, if the license manager starts and licenses can be taken from the license server, but the
FlexNet licensing log file and the ansysli_server.log file are not written, check the Administrator
account. Verify that the Administrator (as well as the individual user) has write privileges to the directory
where the log files are to be written.
Problem Situations
11.3.10. Queuing Does Not Work

If queuing does not work, refer to the following list of possible causes and corrections:
• Verify that the environment variable ANSWAIT is set to 1.
• The license manager is down. In this case, use ANSYS License Management Center to start the license
manager.
• The hostname is mistyped in the ansyslmd.ini file or the ANSYSLMD_LICENSE_FILE environment

variable. If so, correct the name and retry.
• You are not licensed for the requested product. In this case, request a product for which you are licensed.
• All licenses for the requested feature are reserved in the license options file. If so, have the license ad-
ministrator correct the license options file.
• The user is excluded via the license options file from using the licenses for the feature(s) that are installed
on this machine.
• You are running an application that does not support queuing.
11.3.11. No Licensing Interconnect or FlexNet Path Available from Display

the License Status Option
If you select the Display the License Status option from the ANSLIC_ADMIN utility and see a message
stating that the Licensing Interconnect or FlexNet path is empty, try the following:
1. Use the Specify the License Server Machine option of the ANSLIC_ADMIN utility to specify the missing
Licensing Interconnect or FlexNet port number. (On Windows, use the Client ANSLIC_ADMIN utility.) If
the machine is already specified but the error message states that no FlexNet path has been specified, the
FlexNet port number may be missing from the license server specification shown in the Specify the License
Server window. Add the machine's FlexNet port number using the Specify the License Server Machine
option to add this machine to your FlexNet license path.
Note
This particular machine may have been configured to run the ANSYS Licensing Interconnect
without starting FlexNet. Verify that FlexNet is running on this machine before changing
this setting.
See Specify the License Server Machine (p. 15) for more information on specifying license server
machines.
2. Check the ANS_FLEXLM_DISABLE_DEFLICPATH environment variable setting. If this environment variable

is set, the ANSYS License Manager will not use the license server machine specifications in the an-
syslmd.ini file. In this case, only the ANSYSLMD_LICENSE_FILE and ANSYSLI_SERVERS environment
variable settings will be used.
11.3.12. Unable to Retrieve License Preferences in ANSLIC_ADMIN

In cases where you are uncable to retrieve license preferences through the ANSLIC_ADMIN utility, you
may be able to resolve the problem by trying the following:
Troubleshooting
1. Verify that you have correctly specified the license server machine. You can check this by opening the Client
ANSLIC_ADMIN utility and choosing Specify the License Server Machine. Verify that:
a. A license server machine is specified.
b. You have access to the specified machine(s).
c. The license server machine is running and the license server has been started correctly.
2. Verify that license file has been cached if the FlexNet and ANSYS Licensing Interconnect components were
started separately. See Advanced Licensing Configuration Options (p. 40) for more information on running
the licensing components independently.
11.3.13. Cannot Enter Data in Text Fields

On some Linux systems (for example Red Hat 7 systems), if you cannot enter data in text fields 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 ANSLIC_ADMIN utility:
QT_IM_MODULE
XMODIFIERS
GTK_IM_MODULE
You should reset these environment variables when you are finished using ANSLIC_ADMIN. Do not
permanently unset these environment variables as doing so could affect other applications.
Note
Other ANSYS utilities that have interfaces written in the Tcl scripting language could
encounter the same issue. (e.g., the Mechanical APDL Product Launcher.)
11.3.14. Design Point Project Locks Reserved Licenses During a Hang

If you are running a design point study in ANSYS Workbench and are using reserved licenses, you may
need to free licenses if one or more design points hang or do not complete successfully. To do so, you
will need to free the entire reserve. When a user reserves a group of licenses, the group is given a reserve
ID. To free a reserved license without shutting down the license manager, you can use a specific ID,
you can return licenses reserved by a specific user, or you can return all reserved licenses.
If you want to return a license associated with a specific reserve ID, issue the following ansysli_util
command option to find the reserve ID of the reserved licenses:
ansysli_util -reserve_list
The list of reserve IDs will be displayed. For example, issuing the above command might return output
similar to the following (your output will appear on a single line):
USER LABEL/RESERVE-ID
jqd MyProject(###)(###)634710595285628367 licabc.acme.com--7782-6343374
PRODUCT TASK HOST FlexNet_SERVER
ANSYS Dynamics <dynamics> 19 jqd.win.acme.com--7782-6343374 1055@licabc
RESERVED_DATE
2012/05/01 14:51:43 ANSYS Academic Mechanical HPC 3
Using the reserve ID from the previous command output, issue the following command to remove a
specific reserve:
Problem Situations
ansysli_util -return_reserve_by_id id
If you want to return licenses reserved by a specific user, issue the following command:
ansysli_util -return_reserve_by_user username
If you want the ability to return all reserved licenses, use one of the following Licensing Interconnect
startup options:
1. Start the License Interconnect under your user ID.
OR
2. Start the Licensing Interconnect, using the ansyslmd.ini keyword (RETURN_RESERVE=USER) or Licensing
Interconnect command option (-reserveuser) to specify the users who are able to return reserved licenses.
Note that you can also specify by group on Linux, using the Licensing Interconnect command option-re-
servegroup or the ansyslmd.ini keyword RETURN_RESERVE=GROUP. See keyword and command options
in the Reference Section for more information.
Once you are permitted to return reserved licenses, issue the following command to return all reserved
licenses:
ansysli_util -return_reserve_all
This command removes any free or hung licenses in the reserve; if any of the reserved licenses are still
in use, those running jobs will continue to completion. Any licenses checked out by those running jobs
will remain checked out until the jobs complete. The design point study will not start new jobs, since
the reserves have been removed.
11.3.15. See a “File Not Found” Message When Running a Licensing Utility
Linux x64 System: Linux x64 systems running the ANSYS License Manager require the Linux Standard
Base (LSB) package. If this package is missing, you will see a message similar to one of the following
errors when the license manager attempts to run, or when you attempt to run a licensing utility, such
as ANSLIC_ADMIN, getFLEXid, or lmutil.
/lmgrd -h
./lmgrd: No such file or directory
If you have confirmed that the file listed does exist, try installing the LSB package from the Linux install-
ation media.
11.3.16. Cannot See Attached Dongle

There are a number of reasons why you may not be able to see an attached dongle. Review the list
below to troubleshoot the issue.
• Occasionally, dongles may work loose. Verify that the dongle is fully inserted in the appropriate USB
port.
• The required dongle driver must be manually installed on the machine. To determine which version of
the driver is required for this release of the ANSYS License Manager and for information on installing
the driver, see Using Dongles with the ANSYS License Manager (p. 77).
• Additional dongle-specific troubleshooting information can be found in Dongle Troubleshooting at the

end of the Using Dongles with the ANSYS License Manager (p. 77) section of this guide.
Troubleshooting
11.3.17. Unable to Run a Bookmarked Version ANSYS License Management

Center
To run the ANSYS License Management Center, Tomcat must be running. Start Tomcat prior to
starting the ANSYS License Management Center from a bookmark.
11.3.18. Unable to View PDF Files in ANSYS License Management Center

To view PDF files in the ANSYS License Management Center the appropriate PDF plugin for your
browser must be enabled.
For Internet Explorer and Firefox: Enable the Adobe PDF plugin.
For Chrome: Enable the Chrome PDF Viewer plugin.
11.3.19. Unable to Search PDF Files in ANSYS License Management Center

To perform searches of PDF files displayed in the ANSYS License Management Center the appropriate
PDF plugin for your browser must be enabled.
For Internet Explorer and Firefox: Enable the Adobe PDF plugin.
For Chrome: Enable the Chrome PDF Viewer plugin.
11.3.20. Starting ANSYS License Management Center Causes Error Messages

(Linux Only)
Installing the ANSYS License Manager as root and subsequently attempting to run ANSYS License
Management Center as a non-root user may display one of the following permission issues:
• ANSYS License Management Center hangs up, displaying the message,“Determining license manager
status...”
• ERROR: In attempting to write to /ansys_inc/shared_files/licensing/tools/tomcat/logs/catalina.out,

Tomcat will not be able to start successfully. Please check the file permissions.
/bin/sh: /var/tmp/cmd.out: Permission denied
• ERROR: Attempt to delete file "/ansys_inc/shared_files/licensing/tools/tomcat/bin/setenv.sh.old"

failed.
• ERROR: Attempt to rename file " /ansys_inc/shared_files/licensing/tools/tomcat/bin/setenv.sh" to "

/ansys_inc/shared_files/licensing/tools/tomcat/bin/setenv.sh.old" failed.
• ERROR: The new value of export ANSYSLM_ROOT_DIR=/ansys_inc/shared_files/licensing/../.. was not

updated in the Tomcat/ansys_inc/shared_files/licensing/tools/tomcat/bin/setenv.sh file.
Existing PID file found during start.
Removing/clearing stale PID file.
Unable to remove or clear stale PID file. Start aborted.
These permission issues may be resolved by running the following commands:
Licensing Error Messages
chmod 777 -R /ansys_inc/shared_files/licensing/tools/tomcat/bin

chmod 777 -R /ansys_inc/shared_files/licensing/tools/tomcat/logs
11.3.21. Manually Changing the Tomcat Port Number

During the default ANSYS License Manager installation, the Tomcat port number is set to 1084. To
change this port number, see, Modifying the Tomcat Port Number (p. 64)
11.3.22. Cannot Access a License After Disconnecting from VPN

There is a known issue with some VPN tools in which the tool does not clear the IPs correctly or does
not clear them immediately after the VPN disconnection.
To address this issue, you need to force a DNS clear by performing the following steps:
1. From a comand prompt, issue the following command:
ipconfig /release
2. Then issue the following command:
ipconfig /renew
11.3.23. The ANSYS Licensing Interconnect Shuts Down Unexpectedly

The ANSYS Licensing Interconnect shuts down with the following message:
2017/09/27 05:43:30 ERROR Error determining if process <PROCESS NAME BEING

CHECKED FOR> is running:
Couldn't get hold of a new file descriptor. Too many open files
This is caused by exceeding the Linux "Open Files Limit". To correct this issue, increase the open files
limit for the license server.
11.4. Licensing Error Messages

*** Licensed number of users already reached.
You may have reached the number of ANSYS product tasks that you have licensed. Wait until a task
has been freed up and try again. If this error occurs on a regular basis, you may want to talk to your
ANSYS sales representative about obtaining additional licenses.
This error may also occur when licenses have been reserved for certain users, or when certain users
have been excluded from licenses via the license options file.
*** All licenses are reserved for others.
This error may occur if you have multiple INCREMENT lines for the same feature in the license file,
and there are differing fields on each INCREMENT line (such as VENDOR_STRING and the version
field), and licenses have been reserved for this feature. In this situation, the number of reserved li-
censes is reserved out of each INCREMENT, rather than the sum total of both.
*** Cannot connect to license server.
Troubleshooting
or
***Unable to connect to FlexNet license server
The license manager is currently not running. Use ANSYS License Management Center to start
the license manager. Your license must exist on the license server prior to starting the license
manager.
If you install the license manager and a license file, and it appears that the server is running, but
you cannot connect to your license server, try rebooting.
If you think the license manager should already be running, check the FlexNet license log file and
the ansysli_server.log file for errors.
Some other possible causes for this error include:
• If Windows Firewall is enabled on the license server, ansyslmd.exe, lmgrd.exe, and an-
sysli_server.exe need to be included in the exceptions.
• The wrong hostname is in the license file (machine ID is correct in the file and when the license
keys were generated). The license manager could not be started.
• The wrong license file is on the system (both hostname and machine ID are incorrect and the license
keys were created with the wrong ID). The license manager could not be started.
• The wrong license file is on the system AND the user changed the server line to have the machine's
hostid but not the hostname. The license manager could not be started.
• An incorrect port number was used on the SERVER line(s) in the ansyslmd.ini file or in the setting
of the licensing path environment variable ANSYSLMD_LICENSE_FILE
• All of the installed license files have expired.
If none of the above causes are applicable, the Licensing Interconnect may not have started because
it was not able to start the FlexNet server or may have exited after failing to restart the FlexNet
server. Check the FlexNet license log file (license.log). If you see the following lines multiple
times, try rebooting your license server machine:
(lmgrd) ansyslmd exited with status 28 (Communications error)
(lmgrd) Since this is an unknown status, license server
(lmgrd) manager (lmgrd) will attempt to re-start the vendor daemon.
(lmgrd) REStarted ansyslmd (pid 103864)
*** Feature removed during lmreread, or wrong SERVER line hostid
Some possible causes of this message include:
• There is a typographical error in the license file's SERVER line. Typically, the machine ID was mistyped
when manually entering the license file on a machine.
• You tried to install another machine's license file on a machine and changed the SERVER line in the
file to have this machine's hostname but not the machine ID.
• A laptop with a docking station (with an Ethernet card in it) is removed from the docking station
and the license file was made using this card's Ethernet address.
• The feature was removed during lmreread but the client is reading an old copy of the license file
that still contains the removed feature.
*** Clock difference too large between client and server.
This message will appear if the date on the client machine has changed. The date should never be
set ahead or behind the actual date.
*** License server does not support this feature.
This message can be generated if the feature has expired (on the server), or has not yet started, or
the version is greater than the highest supported version, or the license file has been edited while
the license server is running and the license file is not reread. Additional causes for this message
include:
• If you are trying to install another machine's license file on a machine AND changes both the host-
name and the machine ID information on the SERVER line to be this machine's information. The
INCREMENT lines contained in the license file are still invalid for this machine.
• If new information for the requested feature was added to the license file but neither an lmreread
was issued nor was the license manager restarted.
• If a laptop with a docking station (with an Ethernet card in it) is removed from the docking station,
and the license was made using this card's Ethernet address, AND the user edited the SERVER line,
replacing the Ethernet address with the disk signature of the machine (in an attempt to fix the
problem). Such an attempt will not succeed because the INCREMENT lines were created using the
docking station's Ethernet address, which in this situation can no longer be seen on this machine.
• If one or more INCREMENT lines that were made for machine A were installed in machine B's license
file and those features were trying to be checked out from machine B.
*** Feature has expired.
Your license has expired; contact your ANSYS sales representative for a renewal.
*** No such feature exists.
• A license does not exist for the requested product. Verify that the ANSYSLMD_LICENSE_FILE environment
variable and the ansyslmd.ini file are pointing to the correct license server.
• Verify that you are running the correct product. Use the Set License Preferences for User option of
the ANSLIC_ADMIN utility to specify the products and the product order you want to use.
• If you are not licensed to run this product, contact your ANSYS sales representative to obtain a license.
• If you are licensed to run this product, install the license from the license supplied by ANSYS, Inc. or your
ANSYS sales representative using ANSYS License Management Center. If you have already created the
license, use ANSYS License Management Center to reread the license file.
• You could also see this message if you are trying to use a license manager daemon from a previous release.
For the current version of FlexNet, see Compatibility with Other FlexNet-Licensed Software (p. 1).
Failover feature <product name> specified in license preferences is not available.
Troubleshooting
You may see this message if no license for that product is currently available in the license path.
Check the following:
• The license may have expired.
• All of your licenses may be in use.
• You do not have the specified license.
• The license is not included in your license preferences as set with the Specify License Preferences for
User in the ANSLIC_ADMIN utility.
• Your Technology Enhancements and Customer Support (TECS) for this version may have expired.
*** License file does not support this version.
The build date in the program is newer than the version in the license file. You may not be authorized
to run a new release or you may not have installed your new license. If this is the case, install the
license using the ANSYS License Management Center. If you have installed the new license, use
the ANSYS License Management Center to reread the license file.
*** Invalid (inconsistent) license key
Verify that you are not using the license manager daemons supplied with a previous release.
This error can also occur if the license key contains incorrect characters or format (sometimes caused
by transferring the file).
Invalid license file: None of the hostnames in the license file match the system hostname.
This message occurs when you install the license file if the hostname of the system you are running
on does not match any of the hostnames in your license file. Some possible reasons why this can
happen include:
• You are attempting to run on a system that has not been included in your license.
• The hostname of the system you are working on has been changed since it was used to generate the
license information.
• A typographical error was introduced when the hostname was entered when creating the license key.
• On some newer Linux machines, the system hostname is not listed consistently in the /etc/hosts
file. When you run the Get System Hostid Information option of the ANSYS License Management
Center, the utility uses the localhost information instead of the correct system hostname. An example
of the problematic /etc/hosts file might look like this:
# Do not remove the following line, or various programs
# that require network functionality will fail.
127.0.0.1 localhost.localdomain localhost abclinux5
10.99.9.99 abclinux5 abclinux5
[root@abclinux5 ~]$ hostname
abclinux5
[root@abclinux5 ~]$ hostname -s
localhost
[root@abclinux5 ~]$
In this example, the Get System Hostid Information option would incorrectly use the localhost
information.
To correct the problem, you need to edit the /etc/hosts file and change the order of the
hostname lines. The example shown above would then look like this:
# Do not remove the following line, or various programs
# that require network functionality will fail.
10.99.9.99 abclinux5 abclinux5
127.0.0.1 localhost.localdomain localhost abclinux5
[root@abclinux5 ~]$ hostname
abclinux5
[root@abclinux5 ~]$ hostname -s
abclinux5
[root@abclinux5 ~]$
In the corrected example, the Get System Hostid Information option would correctly use the
abclinux5 hostname.
*** Local checkout filter rejected request.
View the license debug log files (FlexNet license.log and the Licensing Interconnect an-
sysli_server.log) to find the specific cause of this message.
*** Cannot find server hostname in network database.
This message will appear if one or more of the SERVER computer names do not appear in the client
computer's /etc/hosts file (Linux) or the services file (Windows).
***The ANSYS license manager server is down. Unless a connection is reestablished, ANSYS will
exit in nn minutes.
A message similar to this one occurs in a one-server license environment if your license manager
has quit running. In a three-license server environment, the ANSYS license manager must be running
on at least two of the three license server machines at all times. If two of the license server machines
go down, or two of the machines are not running the license manager, this error message will appear
in the program output or in a message box. The program will continue to run for nn minutes to
allow the license manager to be restarted or to be started on a second machine if using redundant
servers. When this error message appears, start the license manager on the other machines designated
as license servers.
If you get this message and determine that the license manager is still running, and you are running
in a one-server environment, then the IP address of the license server machine was changed while
the ANSYS product was running (this is usually caused by connecting to or disconnecting from an
Internet Service Provider (ISP) that dynamically allocates IP addresses). To correct this situation, you
must return the IP address to the same address that the license server had when the ANSYS product
was started.
If the IP address changes after you start the ANSYS product (either because you connected to or
disconnected from your ISP), you can correct the error by restarting the ANSYS product. You should
not need to restart the license manager.
You can avoid this problem by remaining connected to or disconnected from the ISP the entire
time you are running the application.
*** version of vendor daemon is too old.
Troubleshooting
Verify that you are not using the license manager daemons supplied with a previous release.
Your version of the ANSYS license client software is out of date. Refer to Licensing Error Messages
in the Troubleshooting section of the ANSYS Licensing Guide.
The version of the license client ansysli_client [version] must be greater or equal to the
client ANSYS application [version].
This message indicates that you are attempting to start an ANSYS, Inc. application with an out-of-
date version of the license client.
If you are using different installation directories for the current and prior versions, you need to ensure
that each version is running from the appropriate installation directory.
If you are using the same installation directory for the current version as you used for the prior
version, try the following solutions:
• The license client was running during the installation process and was not replaced. In this case, close
all ANSYS, Inc. applications, making sure that the license client closes, and then run the Complete Un-
finished Licensing Installation Configuration option from the Client ANSLIC_ADMIN’s Tools menu.
• The license client was running during the installation process and was replaced, but the application is
not reading the new client. In this case, close all ANSYS, Inc. applications, making sure that the license
client closes, and restart the ANSYS, Inc. application.
Your version of the ANSYS license manager software is out of date. Download and install the
current ANSYS license manager from the ANSYS customer site.
The version of the license server ansysli_server [version] must be greater or equal to the
client ANSYS application [version].
This message indicates that you are attempting to start an ANSYS, Inc. product with an out-of-date
version of the license manager. You need to update to the latest version of the license manager.
***Cannot read data from license server.
The server and the client are having difficulties communicating. This error is usually caused by the
network setup or by the network data being different from the data in the license file (for example,
the server name, machine ID, port number, or vendor daemon).
• Confirm that the information on the SERVER line of the license file is the correct information for the
server.
• Confirm that the syntax of the SERVER and VENDOR lines of the license file is correct.
• Verify that TCP/IP is enabled correctly.
• Check that the hosts file on the client machine contains the license server.
• Try using <port>@<ipaddress> when specifying the server.
***The license server is taking too long to respond. The application has stopped waiting for a
reply. The license server may be experiencing a high demand or a temporary outage. Try again
later.
License Manager Installation Directory Errors
In rare occasions, your site could be submitting too many requests too quickly (simultaneously or
nearly simultaneously) to the ANSYS License Manager. In this case, you will also see that the license
server machine in question is averaging 85% CPU usage or higher. In this scenario, we recommend
that you either point some of the clients to a different license server or install one or more standalone
licensing interconnects for some of the clients to use. For instructions on installing a standalone li-
censing interconnect, see Run the ANSYS Licensing Interconnect without FlexNet (p. 41).
***Connection to the license server closed unexpectedly.
If you see the above message and the server is not experiencing any demand, a virus scanner may
be blocking connections to your license server. Rebooting your license server may also resolve the
issue.
Could not bind socket on port 2325. Address already in use.
If you see the above message in your licensing log file, your operating system was not able to free
a port before the timeout period expired. This situation could happen if the port is being used by
some other application, or after you shut down a server if you did not wait long enough for the
ports to free before restarting it.
Consult your system administrator before making changes to your default operating system settings
or to determine which command is appropriate for your operating system level.
***Failed to retrieve license preferences. Be sure that you are able to connect to the license
server.
If you attempt to set your license preferences and the client information is at a higher release than
the server information, you may see this message. To verify, see the getuserprefs.log file (on
Linux machines, in .ansys in your home directory; on Windows, in %TEMP%\.ansys). Note the
last lines in the example below:
2012/08/24 17:18:00 INFO Not connected to a local port.
2012/08/24 17:18:00 NEW_CONNECTION
Connected to license server: 2325@linux10.ansys.com.
ANSYSLI_SERVERS: 2325@linux10.ansys.com
Servers: 1055@linux10.ansys.com
2012/08/24 17:18:01 SITE_PREFS 2012.0806
Your version of the ANSYS license manager software is out
of date. Please download and install the current ANSYS license
manager from the ANSYS customer site.
The version of the license server 2325@linux10.ansys.com [1.1.2]
must be greater or equal to the client ALI_UTIL version [1.3.0].
***License File filename has changed. Please do a reread to update the server.
The license file or the FlexNet options file has been changed since the last restart of the license
manager or reread of the license file. The changes will not be available until you restart the license
manager or reread the license file. If you are running the ANSYS Licensing Interconnect and FlexNet
independently and have cached the license file, the cached license file may be out of date. Restart
FlexNet or reread the license file to update the cached license file. If you make changes to the license
file, in addition to rereading the license file in FlexNet, you must also recache the license file in the
Licensing Interconnect by restarting the Licensing Interconnect or by using the Reread License
Manager Settings option in the ANSYS License Management Center.
11.5. License Manager Installation Directory Errors

The directory you specified is not valid for one of the following reasons:
Troubleshooting
• Must not be a UNC path
• Must not contain a symbolic link or junction
• Must not be a filename
• Must be an absolute path
• Must be in long file name format (not 8.3 format)
• Must contain a valid, existing local, fixed-media drive
Please check your path, correct the problem, and retry.
If you see this message or one that is similar, you may need to correct the path to the license
manager. The message will display a particular error code (listed below). The -100 series numbers
indicate errors associated with the path you entered; the -200 series numbers indicate errors asso-
ciated with the path specified in the service.
• -108 / -208: path is a UNC path; UNC paths are not permitted.
• -109 / -209: path contains a remote (network) drive; remote drives are not permitted.
• -110 / -210: path does not contain a valid drive letter from a to z.
• -111 / -211: path points to a file rather than to a directory.
• -113 / -213: path is a relative path, which is not permitted.
• -114 / -214: root path is invalid. (Example: The drive specified in the path doesn’t exist.)
• -115 / -215: path’s root path isn’t a local fixed-media drive path.
• -116 / -216: path contains either a symbolic link or a junction, neither of which is permitted.
• -117 / -217: path is a short (8.3) file name format path, which is not permitted.
• 2147483647: The ALMConfig utility could not be run by the ANSYS License Manager installation, as is
required.
11.6. ANSYS License Borrowing Errors

***Unable to return <Product>, encountered “feature not found” attempting to return license
feature <Product.>
If you see the above message when attempting to return a borrowed license before the expiration
date, the -2 -p license manager startup option might have been set. The -2 -p option is not
supported. If you are running an earlier release, you must manually unset the option. In this case,
you may also see the following in the log file:
UNAUTHORIZED lmremove request from <user> at node <host>.
You may also see the above message if the existing server specification does not contain the machine
from which the license was borrowed. To correct the problem, add the machine to the server spe-
cification. If the ANSYS Borrow Utility is open when the server specification is changed to contain
FlexNet License Log File Errors
this server, you must close and restart the utility after changing the license server specification and
before returning the borrowed license.
11.7. FlexNet License Log File Errors

***Not a valid server hostname, exiting. Valid server hosts are: xxx
The hostname in the SERVER line of the license file does not match the hostname of the system. In
this case, change the hostname in the license file. Other possible causes include:
• The license file was put on a machine other than the one for which it was created; therefore, the
hostname is not correct.
• The hostname of the license server changed. Change the hostname on the SERVER line of the license
file to correct this problem. REMEMBER to send ANSYS the new hostname so that future license
files are made with the correct hostname.
• The license file was put on a machine other than the one for which it was created AND the user
changed the machine's ID on the SERVER line but did not change the hostname. If the machine ID
is also wrong, you will also see a message about the wrong hostid on SERVER line after correcting
the hostname.
• The wrong hostname was used to create the license file. As long as the correct machine ID was
used, you should be able to change the hostname on the SERVER line of the license file to fix this
problem. REMEMBER to send ANSYS the correct hostname so that future license files are made with
the correct hostname.
***Invalid license key (inconsistent authentication code)
The INCREMENT lines in the license file are not valid for this system (Hostid mismatch). This error
will also occur if the license file was typed incorrectly. Additional causes for this message include:
• If a license file created for machine A is being installed on machine B AND the user changed the
hostname and the machine ID to machine B's in the SERVER line.
• If INCREMENT lines created for machine A are appended to an existing ansyslmd.lic file on
machine B.
• If a laptop with a docking station (with an Ethernet card in it) is removed from the docking station,
and the license was made using this card's Ethernet address, AND the user edited the SERVER line,
replacing the Ethernet address with the disk signature of the machine (in an attempt to fix the
problem). Such an attempt will not succeed because the INCREMENT lines were created using the
docking station's Ethernet address, which in this situation can no longer be seen on this machine.
• In a three-server license environment, if the license file was created using an incorrect hostid for
one of the license servers, this message will appear and will prohibit an ANSYS product from running
on any machine. Verify that the hostid in the license file matches the hostid on all three license
servers. If it does not, the license file must be created using the correct hostid for all license server
machines.
***Wrong Hostid on SERVER line for license file: <path to license file>
License file is not valid for this machine. Possible causes include:
Troubleshooting
• There is a typographical error. If the license file was entered manually, the machine ID may have
been incorrectly typed in the SERVER line.
• The user installed a license file created for machine A on machine B and changed the hostname in
the SERVER line but did not change the machine ID.
• The hostid changed on a machine but the hostname stayed the same.
• A laptop with a docking station (with an Ethernet card in it) is removed from the docking station,
and the license file was made using this card's Ethernet address.
• A license file was made using the Windows disk signature but the keyword 'DISK_SERIAL_NUM='
was not put before the ID. Ethernet address would be expected.
*** “XXX” : Not a valid server hostname, exiting. Valid server hosts are: “YYY”.
The hostname listed in the ansyslmd.lic (YYY) file does not match the hostname of the system
(XXX).

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.
Glossary
ANSLIC_ADMIN A utility that centralizes the various ANSYS product licensing administrat-
ive functions. See also, License Server Administration Using ANSYS License
Management Center (p. 47).
ANSWAIT An environment variable that will allow you to queue your ANSYS job in
the event that all ANSYS licenses are in use. Once a license becomes
available and you are next on the queue, your ANSYS job will automatic-
ally start.
ANSYS License Manager The ANSYS License Manager consists of three components. The first two
are FlexNet components; the last one is an ANSYS component. See the
definitions of each for more information.
• lmgrd
• ansyslmd
• ansysli_server
ansysli see Licensing Interconnect
ANSYS License Manage- The ANSYS License Management Center is a browser-based user inter-
ment Center face that centralizes many of the ANSYS licensing administrative functions.
ansysli_client A component of the Licensing Interconnect that is run by ANSYS

applications on client systems. No user configuration or administra-
tion is required or associated with this component.
ansysli_monitor The ansysli_monitor runs on the same machine where the an-
sysli_server is running and ensures that the Licensing Interconnect
is functioning correctly. If the Licensing Interconnect is not running,
ansysli_monitor can restart it. If the Licensing Interconnect is running
but is not responsive, ansysli_monitor can kill and restart it.
ansysli_server A component of the Licensing Interconnect that is run on the license

server systems. Use ANSLIC_ADMIN to manage (start, stop, etc.).
ansysli_server.log The Licensing Interconnect log file, it provides a chronicle of Licens-

ing Interconnect licensing activity, including problems. The Licensing
Interconnect log file is located in the licensing directory by default.
ansysli port number Communication channel by which the ANSYS, Inc. applications commu-
nicate with the Licensing Interconnect. The default ansysli port number
is 2325.
ANSYSLMD_LICENSE_FILE An environment variable that may be used to specify the license server
machine from which you want to check out a license.
ansyslmd This is one of the FlexNet components of the ANSYS license manager
used to process ANSYS product licensing requests, including issuing and
returning licenses. ansyslmd, often referred to as the vendor daemon,
Glossary
is started by lmgrd and must be running to perform the aforementioned

tasks.
ansyslmd.ini File that resides in the licensing directory. It is created by ANSLIC_ADMIN

utility options Specify the license server machine and Modify license
manager startup options.
backup server In a three-server (redundant triad) network, the two servers not chosen
to be the master are the backup servers. If the master server goes down,
the backup server listed next in the license file automatically assumes
the role of master.
borrowable license A borrowable license is a license that you can use temporarily outside
of the company facility (such as at home on a laptop). A special license
key is required before any license can be borrowed.
build date The build date is the year, month, and date the ANSYS application was
built. The version field in the license file specifies the latest build date
that can be run using that license. It may also appear as 9999.9999 if a
maintenance agreement is not applicable.
capability ANSYS, Inc. has assigned identifiers to each of the specific areas of func-
tionality in the software. We refer to these identifiers as capabilities, which
you may see in ANSYS, Inc. licensing displays and logs. Each capability
can be satisfied by at least one license feature; often, multiple license
features can satisfy a particular capability.
client A client is a machine that requests licenses but is not a license server
machine (i.e., does not have licenses installed on it).
feature The word feature, when used in the descriptions of the licensing utilities,
refers to the ANSYS product. See the ANSYS customer site for the list of
ANSYS products and their corresponding license features.
FlexNet A component of the ANSYS license manager used for all ANSYS products.
Also called FlexNet License Manager. The FlexNet component authentic-
ates and processes all license requests.
FlexNet license log file Typically referred to as the FlexNet Debug Log File, it contains information
relevant to licensing activity. This file provides a way of tracking licensing
problems that may occur. The licensing log file, license.log, is located
in the licensing directory by default.
FlexNet port number Communication channel by which the license manager communicates
with the client (Licensing Interconnect). The default FlexNet port number
is 1055.
floating license Anyone on the network can run a licensed ANSYS product, up to the
limit specified in the license file. Floating licenses require the license
manager daemon (lmgrd) and the vendor daemon (ansyslmd) to be
running to count the concurrent usage of the licenses.
license See license task.
license borrowing License borrowing allows a user to take a license for use outside of the
company facility, such as for an engineer to take a license home on his
laptop.
license file A license file grants access to run specified products. Each licensed
product will have an entry in the license file, ansyslmd.lic or an-
soft.lic, which will reside in the license_files directory. Proper install-
ation of a license file grants access to ANSYS products. Install the license
file using the ANSYS License Management Center or during the install-
ation process.
license key The actual full license for the product.
license.log Typically referred to as the FlexNet Debug Log File, it contains information
relevant to licensing activity. This file provides a way of tracking licensing
problems that may occur. The licensing log file is located in the licensing
directory by default.
license manager Software used for licensing ANSYS, Inc. products. The ANSYS License
Manager has two components: the FlexNet software and the Licensing
Interconnect.
license options file A FlexNet file containing license manager-related resource information.
By default, the file is named ansyslmd.opt and resides in the li-
cense_files directory. You may specify the following information in the
options file:
• Licenses that are reserved for individuals, groups, or machines
• Those individuals, groups, or machines that are denied access to licenses
license server machine A license server machine is a computer that you have designated to be
the administrator of ANSYS product licenses; the licenses are installed
on the server machine(s). One or three systems (redundant triad) can be
used to administer any particular set of ANSYS product licenses.
license task Each concurrent use of an ANSYS product is a license task. Each use of
an ANSYS product will take a number of license tasks from the total
number available.
licensing directory The default location for the licensing files. On Linux systems, the licensing
directory is /ansys_inc/shared_files/licensing. On Windows
systems, the default licensing directory is <OS_Drive>\Program
Files\ANSYS Inc\Shared Files\Licensing, located in the
same drive as the operating system.
Licensing Interconnect Communications between the ANSYS applications, lmgrd, and an-
syslmd are handled by an intermediary process called the ANSYS Licens-
ing Interconnect. The ANSYS Licensing Interconnect communicates with
the FlexNet license manager to authenticate and process all license re-
quests.
Glossary
Licensing Interconnect Log Provides a chronicle of Licensing Interconnect licensing activity, including
File problems. The Licensing Interconnect log file, ansysli_server.log,
is located in the licensing directory by default.
lmadmin A group of users that you designate to have the ability to perform license
administrative tasks that are considered disruptive.
lmgrd One of the FlexNet components of the ANSYS License Manager, used to
process ANSYS product licensing requests, including issuing and returning
licenses.
LMTOOLS LMTOOLS is a Windows-only utility that will perform various license ad-
ministrator functions, such as listing the users of licensed products.
LMTOOLS is no longer sufficient to manage the ANSYS License Manager
and the Licensing Interconnect. You should use the ANSYS License
Management Center to start or stop the license manager and use the
ANSLIC_ADMIN utility to check the license status, etc. However, if you
have well-established processes to manage FlexNet, you can continue
to use LMTOOLS (see Advanced Licensing Configuration Options (p. 39)).
lmutil lmutil is a FlexNet-supplied utility that will perform various license

administrator functions including: rereading the license file, shutting
down the license manager, starting the license manager, and listing the
users of licensed products. lmutil is the underlying process in several
of the ANSYS License Management Center and ANSLIC_ADMIN options.
master server In a three-server (redundant triad) network, one of the servers must be
the master server. The server listed first in the license file automatically
assumes the role of master. The other two license servers machines are
backup servers. In a one-server network, that server is automatically the
master.
options file See license options file.
path When used in the context of a license file path, the list of places that are
searched in order to locate a valid license file. The path is built from
values in the ANSYSLMD_LICENSE_FILE environment variable, settings
in the ansyslmd.ini file, or an actual license file.
quorum You may designate either one or three machines to be license servers.
In a three-server (redundant triad) network, license manager daemons
must be running on the majority (2) of the server machines (a quorum)
before requests for licenses will be processed.
redundant (triad) servers Having multiple machines designated as license servers for an ANSYS
product. Redundancy can be achieved either by having three license
server machines working together in tandem, where two of the three
must be running at all times but serving from a single set of licenses, or
by having any number of license server machines running independently,
each serving from different license files.
server See license server.
Tamper Resistant License A sixty character encryption used in the licensing file.
task See license task.
TRL Tamper Resistant License
vendor daemon FlexNet terminology used to refer to the vendor-specific component of

the FlexNet license manager. The ANSYS vendor daemon is ansyslmd.
ansysli, 1
Index definition, 107
port number, 40
Symbols ansysli port number
definition, 107
ansysli_client
A definition, 107
A FlexNet License Status
ansysli_monitor
display, 14, 58
definition, 107
Academic licenses, 18, 69
ansysli_server, 2
Accessing Installation Files, 7
definition, 107
Agreement number, 75
ansysli_server log file
All licenses reserved, 97
definition, 107
ANS_FLEXLM_DISABLE_DEFLICPATH, 25
ANSYSLI_SERVERS, 25
ANSLIC_ADMIN utility, 67
ANSYSLI_TIMEOUT_CONNECT, 25
debug log, 53
ANSYSLI_TIMEOUT_TCP, 25
definition, 107
ansyslmd, 1-2, 4-5
display customer number, 75
definition, 107
display queued licenses, 74
ansyslmd.ini
display the license status, 74
definition, 108
gather diagnostic information, 21, 58
ansyslmd.ini file, 13, 15, 17
modify startup options, 72
ansyslmd.lic file, 1, 3, 13, 17, 48
run the ANSYS borrow utility, 70
ansyslmd.opt file, 43
set license preferences, 69
ANSYSLMD_LICENSE_FILE, 3, 25
set site preferences, 71
ANSYSLMD_LICENSE_FILE environment variable
specify product order, 71
definition, 107
specifying the license server, 15
using its options (Linux), 67
View status/diagnostic options, 74
B
ANSWAIT environment variable Backup server
definition, 107 definition, 108
ANSYS Basic Licensing, 7
licenses, 6 boot_ansflex file, 31
ANSYS License Management Center, 48 Borrowable license
current license usage, 54 definition, 108
display FlexNet license status, 14, 58 Borrowing
display license server hostid, 52 licenses, 20, 70
functionality, 48 Build date
install license, 48 definition, 108
license denials, 57
License Manager run mode, 60 C
license usage history, 55 Caching FlexNet licenses, 39, 72
log, 54 Caching license servers, 73
peak license usage, 56 Capability
requirements, 47, 77 definition, 108
rereading license manager settings, 51 Changing Java Version, 65
shutdown the license manager, 13, 50 Client configuration, 15, 27
start the license manager, 13, 49 Clients
update license, 48 definition, 108
using its options , 48 Commands (Linux)
ANSYS Licensing Guide ps, 31-32
viewing, 61 Commercial licenses, 18, 69
ansys_pid utility, 86 Communications requirements, 39
Index
Complete unfinished client licensing installation config- ansyslmd.lic , 17, 48

uration, 67 ansyslmd.opt, 43
Configuring redundant (triad) servers, 44 boot_ansflex
Configuring TCP/IP, 39 init_ansysli, 31
Configuring the license server machine, 12 .cshrc, 15
.cshrc file, 15 init_ansysli, 31
customer number, 75 init_ansyslm_tomcat, 32
license, 1, 3
D installing, 13
daemon license (ansyslmd.lic), 13
vendor, 4-5 license files format, 3
Daemons license.log, 31-32
starting at system boot time, 31-32 viewing, 53-54
starting manually, 13, 49 sample license files, 5
vendor (ansyslmd), 2 Firewall settings, 13
Debugging, 85 FlexNet
design points compatibility with other software, 1
licensing, 28 definition, 108
Diagnostic information license, 14, 52
gathering, 21 port number, 40
Diagnostic log files, 58 FlexNet debug log (license.log)
Display customer number, 75 viewing, 53
Display FlexNet License Status, 14, 58 FlexNet debug log file (license.log)
Display license server hostid, 52 viewing, 54
Display license status, 74 FlexNet license options file (ansyslmd.opt)
Display queued licenses, 59, 74 editing, 43
Dongles FlexNet Licenses
using, 77 viewing, 14, 52
Downloading FlexNet Licensing Guide
installation files, 7 viewing, 61
Downloading Installation Files, 7 FLEXNet Manager, 39, 67
FlexNet Manager, 47
E FlexNet port number
Enabling Secure Connections, 61 definition, 108
Environment variables floating license
ANS_FLEXLM_DISABLE_DEFLICPATH, 25 definition, 108
ANSYSLI_SERVERS, 25 Floating licenses, 1, 6
ANSYSLI_TIMEOUT_CONNECT, 25 Format of license files, 3
ANSYSLI_TIMEOUT_TCP, 25 Freeing a license, 67
ANSYSLMD_LICENSE_FILE, 3, 25 Functions requiring lmadmin group privileges, 42
Error messages, 85
license borrowing, 104 G
license log file, 105 Gather diagnostic information, 21
licensing, 31, 97 Group
Establishing user licensing preferences, 18 creating, 42
Expired license, 99 Group restrictions
defining, 42
F
Feature H
definition, 108 high performance computing
Files licensing, 27
ansyslmd.ini, 13, 15, 17 hostid, 4, 6
hostname, 4, 6 example, 5
HPC licensing, 27 format, 3
HPC Parametric Pack licensing, 28 INCREMENT lines, 5
HTTPS SERVER lines, 4
configuring, 61 settings precedence, 17
specifying the location, 13
I VENDOR lines, 4
INCREMENT lines, 5 License key
init_ansysli, 31 definition, 109
init_ansyslm_tomcat, 32 License log file (license.log)
Installation definition, 108-109
license, 48 error messages, 105
silent, 35 License log file error messages, 105
uninstalling the license manager, 36 License Management Center, 47, 69
Installation Files display queued licenses, 59
accessing, 7 launching, 69
downloading, 7 License manager
Installing license files, 13 advanced configuration, 39
installing the license manager, 8 compatibility with other software, 1
Complete unfinished client licensing installation Complete unfinished licensing client installation
configuration, 67 configuration, 67
Installing the license manager Complete unfinished licensing installation configur-
Linux, 11 ation, 48
post-installation instructions, 31 components, 1
Windows, 9 daemon, 110
Interconnect defined, 1
debug log , 53 definition, 109
Interconnect debug log (license.log) installation prerequisites, 9
viewing, 53 installing, 8
is down error message, 98 installing on Linux, 11
installing on Windows, 9
J modifying startup command options, 41
Java modifying startup options, 72
version, 65 post-installation instructions, 31
shutting down, 13, 50
L shutting down with ANSLIC_ADMIN, 13, 50
silent installation, 35
License
starting at system boot time, 31
error message: has expired, 99
starting manually, 13, 49
installing, 48
starting with ANSYS License Management Center,
updating, 48
13, 49
License administration, 47, 67
uninstalling, 36
creating lmadmin group, 67
License Manager
License borrowing, 20, 70
rereading settings, 51
definition, 109
License Manager Run Mode, 60
running, 20
License methods
setup, 70
sharing vs. separate, 69
License borrowing error messages, 104
License options file (ansyslmd.opt)
License denials
definition, 109
viewing, 57
License preferences
License file installation, 13
academic vs. commercial, 18, 69
License files, 1, 3
License queuing, 67
definition, 109
Index
License server Licensing error messages, 97

error message: is down, 98 Licensing Interconnect, 1
specifying, 43 defining group restrictions, 42
license server machines, 1 port number, 40
License server machines running independently of FlexNet, 39
definition, 5, 109 running without FlexNet, 39
display FlexNet license status, 14, 58 Licensing Interconnect (ansysli_server), 2
display hostid, 52 Licensing preferences
master, 5 establishing for users, 18
selecting, 6 lmadmin group, 42, 67
three-server network, 5 lmdown, 42
License server manager, 2 lmgrd, 1-2
License servers utility definition, 110
caching, 73 lmhostid, 52
configuring, 12 lmremove, 42
designating for license checkout, 15, 67 lmreread, 42
error messages, 31 LMTOOLS, 39, 67
network licensing , 2 lmutil
shutting down the license manager daemon, 13, 50 utility definition, 110
specifying, 15 Log file, 110
License status (see also license log file)
display, 59, 74
License task M
definition, 109 Master server, 5, 31-32
license usage definition, 110
viewing, 54
license usage history N
viewing, 55 Network File System
license.log licensing failures on, 41
viewing, 53 Network licensing
license.log file, 31-32 network licensing considerations, 6
viewing, 54 shutting down the license manager, 13, 50
Licenses starting license manager at system boot time, 31
customer number, 75 starting license manager manually, 13, 49
floating, 6 No license file found for feature error message, 99
freeing, 67 No licenses are currently available error message, 97
installing/updating, 48
Licensing P
basic, 7
Path
debugging, 85
definition, 110
error messages, 85
peak license usage
problem situations, 87
viewing, 56
selecting server machines, 6
Pool of available tasks, 6
separate method, 69
Port number
sharing method, 69
FlexNet, 4
tasks, 6
Port Number
three-server license network, 5
changing Tomcat port number, 64
Licensing Configuration Details
Port numbers
viewing, 61
changing, 40
Licensing directory, 1
FlexNet, 40
Licensing environment
Licensing Interconnect, 40
setting up, 47, 67
Preferences
setting, 18, 69 testing whether TCP/IP is installed, 39
Product order TCP/IP requirements, 39
specifying , 71 Technical Support, 106
PS command, 31-32 Three-server network, 5
Tomcat
Q changing port number, 64
Queued licenses starting at system boot time, 32
display, 59, 74 Tomcat Server
Queuing, 67 starting, 32
Quorum Tomcat Serverr
definition, 110 starting at boot time, 32
Troubleshooting
R ansys_pid utility, 86
Redundant (triad) servers getting additional debugging information, 85
setting up, 44 license borrowing errors, 104
Redundant servers license log file errors, 105
definition, 110 licensing error messages, 97
Requirements problem situations, 87
ANSYS License Management Center, 47, 77 Troubleshooting ANSYS error messages, 85
Reread License Manager Settings, 51
root login, 36, 67 U
Running the Licensing Interconnect and FlexNet inde- Unavailable licenses, 97
pendently, 39, 41 Uninstalling the license manager, 36
Running the Licensing Interconnect without FlexNet, Updating license, 48
39, 41 User privileges, 67
Using the FlexNet options file, 43
S Using Dongles, 77
Sample license files, 5
SERVER lines, 4 V
Set site preferences, 71 Vendor daemon, 1-2, 5
Shutting down the license manager, 13, 50 vendor daemon
Silent Installation definition, 111
license manager, 35 Vendor daemon (ansyslmd), 4
Site preferences VENDOR lines, 4
setting , 71 View status/diagnostic options, 74
Specify product order, 71 Viewing FlexNet Licenses, 14, 52
Specifying firewall settings, 13 Viewing license denials, 57
Specifying the license server, 15, 43 Viewing peak license usage, 56
Starting the license manager, 13, 49 Viewing the current license usage, 54
Starting the license manager at system boot time, 31 Viewing the FlexNet debug log, 53
Startup options for license manager Viewing the FlexNet debug log file, 54
modifying, 72 Viewing the interconnect debug log, 53
Status Viewing the license usage history, 55
viewing, 74
superuser login, 36, 67 W
Support, 106 WANs, 6
Symbolic links, 1 Wide area networks, 6
T
Tasks, 6
TCP/IP
dial-up connection, 39
Installation Guide for Linux

2600 ANSYS Drive 000408
Canonsburg, PA 15317 ANSYS, Inc. and
ansysinfo@ansys.com ANSYS Europe,
Ltd. are UL
http://www.ansys.com registered ISO
(T) 724-746-3304 9001: 2015
(F) 724-514-9494 companies.
by a newer version of this guide. This guide replaces individual product installation guides from previous releases.
Disclaimer Notice

Table of Contents
1. Installation Prerequisites for Linux ........................................................................................................ 1
1.1. System Prerequisites ......................................................................................................................... 2
1.1.1. CAD Support ............................................................................................................................ 3
1.2. Disk Space and Memory Requirements ............................................................................................. 3
1.3. Requirements for the GPU Accelerator in Mechanical APDL ............................................................... 4
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 ....................................................................................... 15
2.3. Select Your Installation .................................................................................................................... 15
3. Installing ANSYS Products for a Stand-alone Linux System ................................................................. 17
3.1. Pre-Installation Instructions for Download Installations .................................................................... 18
3.2. Product Download Instructions ....................................................................................................... 18
3.3. Installing from a USB Drive .............................................................................................................. 19
3.4. Mounting the DVD Instructions for DVD Installations (Linux x64 Only) .............................................. 20
3.5. Product Installation ......................................................................................................................... 21
3.5.1. Specifying CAD Configurations ............................................................................................... 24
3.5.2. ANSYS License Manager Installation ....................................................................................... 25
3.5.2.1. Registering the License Server ....................................................................................... 26
4. Installing ANSYS Products and the License Server on Different Linux Machines ................................ 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.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.1. Post-Installation Procedures for Mechanical APDL and ANSYS Workbench Products ......................... 42
5.1.1. Post-Installation Procedures for ANSYS CFX ............................................................................. 43
5.1.1.1. Setting up ANSYS TurboGrid Release 2019 R1 ................................................................. 44
5.1.1.2. Using the ANSYS CFX Launcher to Set Up Users .............................................................. 45
5.1.2. Post-Installation Procedures for ANSYS Fluent ......................................................................... 45
5.1.3. Post-Installation Procedures for ANSYS Polyflow ..................................................................... 46
5.1.4. Post-Installation Procedures for ANSYS ICEM CFD .................................................................... 46
5.1.5. Post-Installation Procedures for ANSYS Autodyn ..................................................................... 46
5.1.6. Post-Installation Procedures for ANSYS FENSAP-ICE ................................................................. 46
5.1.7. Post-Installation Procedures for Other Products ...................................................................... 48
5.2. Product Localization ....................................................................................................................... 48
5.2.1. Translated Message File Installation for Mechanical APDL ....................................................... 49
5.3. Launching ANSYS, Inc. Products ....................................................................................................... 50
6. Silent Mode Operations ........................................................................................................................ 51
6.1. Silent Product and License Manager Installation .............................................................................. 52
6.2. Silent Product Configuration/Unconfiguration ................................................................................. 54
6.3. Silent Media Installation .................................................................................................................. 54
Linux Installation Guide
6.3.1. Silent Uninstall ....................................................................................................................... 55

7. Configuring CAD Products .................................................................................................................... 57
7.1. Using the Product & CAD Configuration Manager ............................................................................ 57
7.1.1. Unconfiguring ........................................................................................................................ 58
7.1.2. Running the Product & CAD Configuration Manager in Batch Mode .................................... 58
7.1.3. NX Configuration ................................................................................................................... 59
7.2. Configuring the Geometry Interface for NX for ANSYS Workbench Products ..................................... 60
8. Uninstalling the Software ..................................................................................................................... 61
9. Troubleshooting .................................................................................................................................... 63
9.1. Installation Troubleshooting ............................................................................................................ 63
9.1.1. Gathering Diagnostic Information .......................................................................................... 63
9.1.2. The GUI Installation Process Hangs ......................................................................................... 63
9.1.3.The Target Machine Does Not Have a DVD Drive ...................................................................... 63
9.1.4. Product & CAD Configuration Manager Help Does Not Load .................................................... 64
9.1.5. Cannot Enter Data in Text Fields .............................................................................................. 64
9.1.6. Download and Installation Error Messages .............................................................................. 64
9.1.7. System-related Error Messages ............................................................................................... 65
9.1.8. High Performance Computing Error Messages ........................................................................ 65
9.1.9. INSTALL Command Appears as Lowercase in USB Installation .................................................. 65
9.2. Installation Troubleshooting - Graphics ........................................................................................... 65
9.2.1. DesignModeler and Mechanical APDL Crash When Using the Latest AMD Graphics
Drivers .......................................................................................................................................... 65
9.3. Installation Troubleshooting - Mechanical APDL .............................................................................. 66
9.3.1.Your batch jobs terminate when you log out of a session ......................................................... 66
9.3.2. Mechanical APDL Documentation File for User Interface Error Messages .................................. 66
9.3.3. Launcher Error Messages ........................................................................................................ 66
9.3.4. FORTRAN Runtime Error Messages ......................................................................................... 66
9.3.4.1. Intel Linux 64 Systems ................................................................................................... 67
9.3.4.2. Intel EM64T Linux x64 Systems ....................................................................................... 67
9.3.4.3. AMD Opteron Linux x64 Systems ................................................................................... 67
9.4. Installation Troubleshooting - ANSYS Workbench ............................................................................ 67
9.4.1. Startup or Graphics Problems ................................................................................................. 67
9.5. Installation Troubleshooting - ANSYS CFX ........................................................................................ 67
9.5.1. CFX Distributed Parallel Runs Fail ............................................................................................ 67
9.6. Contacting Technical Support ......................................................................................................... 68
10. Applications Included with Each Product ........................................................................................... 69
List of Tables
1.1. Supported Linux Platforms ..................................................................................................................... 2
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 ........................................................................................ 15
5.1. Startup Commands ............................................................................................................................... 50
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 2019 R1. 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
– NX
– Parasolid
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 2019 R1, ANSYS BladeGen, Vista CCD, Vista CPD, Vista RTD, and Vista AFD are not supported
on Linux platforms.
ANSYS Workbench is installed by default as product components to most ANSYS, Inc. products. ANSYS
Workbench is not installed as part of the products under ANSYS Additional Tools. ANSYS Workbench
includes the following applications:
• DesignModeler
• Design Exploration
• Meshing
• Remote Solve Manager
• Fluent Meshing
• EKM Client
Important Notice
If you wish to run multiple releases of ANSYS, Inc. software, you MUST install them chronologically (i.e.,
Release 19.2 followed by Release 2019 R1). If you install an earlier release after installing Release 2019
R1, you will encounter licensing issues that may prevent you from running any products/releases. If you
need to install an earlier release after you have already installed Release 2019 R1, you MUST uninstall
Release 2019 R1, then re-install the releases in order.
1.1. System Prerequisites

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

architecture
(directory name)
Linux x64 EM64T/Opteron 64 Red Hat Enterprise Linux 6.9, linx64 Download
Red Hat Enterprise Linux 7.3 - / USB
7.5, SUSE Linux Enterprise
Server and Desktop 12 SP2 and
SP3, CentOS 7.3 and 7.4
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.
Disk Space and Memory Requirements
Supported Products By Platform For a complete list of products supported by each platform, see
the Platform Support by Application PDF on the Platform Support section of the ANSYS Website.
1.1.1. CAD Support

The following CAD and auxiliary programs are supported on the indicated products and platforms.
Products are:
A = Mechanical APDL
W = ANSYS Workbench
I = ANSYS ICEM CFD (standalone and ANSYS Workbench Readers)
Table 1.2: CAD Support by Platform
Linux x64
CATIA 4.2.4 A, I
CATIA V5–6R2018 W, I
Parasolid 30.0 A, W, I
ACIS 2018 A, W, I 1
NX 10.0 A, W, I
NX 11.0 A, W, I
NX 12.0 A, W, I
STEP AP203, AP214 A, W, I
IGES A 2, W, I 3
GEMS I
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 17.6 GB
ANSYS LS-DYNA 18.1 GB
ANSYS CFD Post only 18.6 GB
ANSYS CFX 18.9 GB
ANSYS Chemkin 18.6 GB
Product Disk Space

ANSYS Energico 18.6 GB
ANSYS Model Fuel Library (Encrypted) 18.6 GB
ANSYS Reaction Workbench 18.6 GB
ANSYS EnSight 19.7 GB
ANSYS FENSAP-ICE 19.5 GB
ANSYS Fluent 21.3 GB
ANSYS Forte 18.3 GB
ANSYS Polyflow 22.3 GB
ANSYS TurboGrid 18.7 GB
ANSYS ICEM CFD 18.3GB
ANSYS Customization Files for User Programmable Features 17.3 GB
ANSYS Mechanical Products 19.0 GB
ANSYS Icepak 21.7 GB
ANSYS Remote Solve Manager 17.3 GB
ACIS Geometry Interface 17.3 GB
Catia, Version 5 Geometry Interface 17.3 GB
NX Geometry Interface 17.3 GB
Parasolid Geometry Interface 11.8 GB
Disk space required to install all products: 35.5 GB
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 NVIDIA GPU card. The following
cards are recommended:
NVIDIA Tesla Series (any model)

NVIDIA Quadro GV100
NVIDIA Quadro GP100
NVIDIA Quadro P6000
NVIDIA Quadro P5000
NVIDIA Quadro M6000
NVIDIA Quadro K6000
• 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 (FP64) 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 GV100
NVIDIA Quadro GP100
Additional Hardware and Software Requirements
NVIDIA Quadro K6000
• NVIDIA GPU devices with at least 12GB of on-card memory are recommended in order to achieve optimal
performance.
• For NVIDIA GPU cards, the driver version must be 384.81 or newer.
• To utilize a NVIDIA GPU device that is not on the recommended list of cards, set the following environment
variable:
ANSGPU_OVERRIDE=1
This is most beneficial when you wish to run on newer NVIDIA GPUs that were not available at the
time of release of this version of the ANSYS program. If you choose to use this environment variable,
you should ensure that the NVIDIA GPU device that you wish to use is sufficiently powerful, in terms
of both double-precision compute power and on-card memory, to achieve meaningful acceleration
for your simulation. Using this environment variable with an underpowered CPU may actually decel-
erate your simulation.
1.4. Additional Hardware and Software Requirements

• Intel 64 / AMD64 system with a supported operating system version installed
• 8 GB of RAM
• 128 GB free on the hard drive is recommended
• A current default web browser must be installed to view the ANSYS internet-based help documentation.
For a complete list of supported browsers, see the Browser Support PDF on the Platform Support
section of the ANSYS Website.
Note that Google Chrome does not support the Linux platforms that ANSYS supports.
For a local copy of the product documentation on your system, download an installable version from
the ANSYS Download Center. Instructions for installing the Local Help are included with the download
package.
• TCP/IP for the license manager (see the ANSYS Licensing Guide for more information on TCP/IP)
• Approximately twice as much swap space as memory. The amount of memory swap space on the system
may limit the size of the model that can be created and/or solved.
• Discrete graphics card with the latest drivers and compatible with the supported operating systems. For full
functionality, use of a recent NVIDIA Quadro or AMD FirePro card with at least 1 GB of discrete video memory
and supporting OpenGL version 4.5 or above. Intel Iris Pro Integrated graphics has also been used successfully.
For information on the most recently tested graphics cards, see the Graphics Cards TestedPDF on
the Platform Support section of the ANSYS Website.
Note
– Vendor Legacy Support: To be compatible, legacy GL 4.5 compliant cards should

still be within the official legacy support period of their respective graphics vendor,
and must still be receiving regular driver updates. Visit the vendor websites (AMD
and NVIDIA) to review legacy hardware lists.
• A minimum screen resolution of: 1024 x 768 (4:3 aspect ratio), 1366 x 768 (16:9 aspect ratio) or 1280 x 800
(16:10 aspect ratio) with minimum 24 bit color. A higher screen resolution such as 1920x1080 (16:9) or
1920x1200 (16:10) is strongly recommended for most applications.
Note
– A number of cosmetic display issues have been reported when running the installation
program on Linux platforms using AMD graphics cards. These issues do not affect the
installation functionality.
– Ultra High Definition (4K) Graphics Cards: Use of Ultra High Definition (4K) graphics
cards may cause a number of cosmetic display issues (including enlarged or reduced
text and incorrect positioning of option labels). These issues do not affect the function-
ality of the installation program.
• X11, OpenGL graphics libraries
• Mesa-libGL (OpenGL) is required to run data-integrated ANSYS Workbench applications such as Mechanical.
• For most applications, a three-button mouse is required to access all available functionality.
• PDF reader software is required to read the installation guides and other user documentation.
• Running ANSYS Fluent or ANSYS CFX on Cray systems requires a minimum of Cray Linux Environment 6.0
update 03 (based on SUSE Linux Enterprise Server 12).
1.5. Third-Party Software and Other Security Considerations

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

Tcl tclsh
Tk wish
Perl perl
GNU gzip gzip
GNU tar tar
ANSYS, Inc. products may have softlinks that require 777 permissions. In addition, the following third-
party products are known to contain softlinks that require 777 permissions:
• CPython
• GCC
• IMPI
Third-Party Software and Other Security Considerations
• INTELMPI
• MainWin
• Mono
• MPICH
• OPENMPI
• IBMMPI
• Perl
• Python
• Qt
• Qwt
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 12 SP 2 SLES 12 SP2: motif
motif-2.3.4-4.15.x86_64
SUSE Linux Enterprise 12 SP 3 SLES 12 SP3: 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.9 and 7.3 through 7.5 You need to install the following libraries:
• libpng12
• 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
• gcc-c++.x86_64
Platform Details
• 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 and 7.4 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
• 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
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-
Platform Details
mand into a file called mod_sem and then setting up the following links to execute the file each time
you restart your system:
cp mod_sem /etc/init.d
ln -s /etc/init.d/mod_sem /etc/rc3.d/S61mod_sem
ln -s /etc/init.d/mod_sem /etc/rc5.d/S61mod_sem
ANSYS Icepak If you are running ANSYS Icepak on Redhat 7.4 and CentOS 7.3 and receive the following
error while launching the application, you must install libXScrnSaver as root user.
error while loading shared libraries: libXss.so.1: cannot open shared

object file: No such file or directory
Enter the following command to install libXScrnSaver as root user:
yum install libXScrnSaver
Mechanical, Meshing, and DesignModeler Applications If you are using a localized operating system
(such as French or German), you must set the mwcontrol VisualMainWin control on any machines
running these applications in order for these applications to recognize the correct numerical format.
ANSYS Workbench must already be installed before setting this control.
First, you need to ensure that the /v193/aisol/WBMWRegistry/ directory has write permissions.
From the /v193/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>/v193/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 MPI On some operating systems, the default amount of physical memory that
can be pinned/locked by a user application is set to a low value and must be explicitly increased. A
value recommended by Intel is 90% of the physical memory. Therefore, the following should be added
to the /etc/security/limits.conf file:
* hard memlock unlimited
* soft memlock unlimited
The need for increasing the limits may be indicated by the following error message with Platform MPI:
fluent_mpi.16.0.0: Rank 0:1: MPI_Init: ibv_create_cq() failed
fluent_mpi.16.0.0: Rank 0:1: MPI_Init: Can't initialize RDMA device
fluent_mpi.16.0.0: Rank 0:1: MPI_Init: MPI BUG: Cannot initialize RDMA protocol
libibverbs: Warning: RLIMIT_MEMLOCK is 32768 bytes.
This will severely limit memory registrations
When Fluent is launched by a scheduler (like PBSPro, SGE, etc.), these limits may be reset by the
scheduler. You may check running the “limit” command within and without the scheduler to compare.
Any differences indicate the issue above.
If you use PBSPro, add ulimit -l unlimited directly in the pbs_mom startup script, and let PBS
reload the pbs_mom.
If you use SGE, you must change the startup script /etc/init.d/sgeexecd to include the ulimit
-l unlimited command as shown in the following example:
-- BEGIN --
if [ "$startup" = true ]; then
# execution daemon is started on this host!
echo " starting SGE_execd"
exec 1>/dev/null 2>&1
ulimit -l unlimited
$bin_dir/SGE_execd
else
-- END --
Once this modification is in place, restart SGE to set the correct memory limits on the SGE daemon and
any invoked processes.
Using Mechanical APDL with MPI On some operating systems, the default amount of physical
memory that can be pinned/locked by a user application is set to a low value and must be explicitly
increased. A value recommended by Intel is 90% of the physical memory. Therefore, the following
should be added to the /etc/security/limits.conf file:
* hard memlock unlimited
* soft memlock unlimited
This behavior has been observed on Intel MPI 4.1.3, but might also occur on Platform MPI 9.1.4.2.
Using the Fluent Launcher On Linux systems, you must have the following package (as appropriate
for your platform) installed in order to use the Fluent launcher:
SUSE 11 pr 12: libstdc++33
Using ANSCUSTOM If you use ANSCUSTOM to link your own version of ANSYS Release 2019 R1 on
a SUSE SLES 12.x computer, you may see two unsatisfied externals that are system, not ANSYS files, due
to the linker looking for some system files in a Red Hat directory on a SUSE computer.
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 2019 R1 executable is looking
for system libraries that do not have revision numbers appended to the end of their file names. On
some SUSE systems, the graphics libraries all have revision numbers appended to the end of the library
filenames. In these cases, ANSYS quits because the loader cannot find all of the libraries that it is looking
for. When running ANSYS Release 2019 R1, the loader will inform you that it is unable to locate a spe-
Platform Details
cific library (for example, libXm.so). Using the Linux locate command, find the library (libXm.so
in this example) on your system and add the appropriate symbolic link as seen below.
To overcome this possible problem, run the following as root:

ln -sf /usr/lib64/libGLU.so.1.3.060402 /usr/lib64/libGLU.so
ln -sf /usr/X11R6/lib64/libXm.so.3.0.3 /usr/X11R6/lib64/libXm.so
ln -sf /usr/X11R6/lib64/libXp.so.6.2 /usr/X11R6/lib64/libXp.so
ln -sf /usr/X11R6/lib64/libXt.so.6.0 /usr/X11R6/lib64/libXt.so
ln -sf /usr/X11R6/lib64/libXext.so.6.4 /usr/X11R6/lib64/libXext.so
ln -sf /usr/X11R6/lib64/libXi.so.6.0 /usr/X11R6/lib64/libXi.so
ln -sf /usr/X11R6/lib64/libX11.so.6.2 /usr/X11R6/lib64/libX11.so
ln -sf /usr/X11R6/lib64/libSM.so.6.0 /usr/X11R6/lib64/libSM.so
ln -sf /usr/X11R6/lib64/libICE.so.6.4 /usr/X11R6/lib64/libICE.so
ln -sf /lib64/libgcc_s.so.1 /lib64/libgcc.so
For Linux, you may need the following:

ln -sf /usr/lib64/libXm.so.4.0.0 /usr/lib64/libXm.so.3
The revision numbers appended to the filenames on the left may be different on your system.
Intel Linux
ANSYS was built and tested on Red Hat using the compilers as noted in Table 2.3: Compiler Requirements
for All Linux Versions (p. 15). 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.
Select Your Installation
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 17.0.4 (FORTRAN, Intel 17.0.4 GCC 6.3.0 (typically Intel 17.0.4
C, C++) and GCC 6.3.0 FORTRAN (for installed as part of the (FORTRAN, C,
(for user custom solver operating system) C++) and GCC
programmable modeling using 6.3.0 (for user
features) User Fortran) programmable
and GCC 6.3.0 features)
(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.
When installing the GCC 6.3.0 compiler for use with ANSYS Mechanical APDL and Autodyn, see Compiler
Requirements for Linux Systems for detailed installation instructions.
Note
The software compiler versions listed above may not correspond to the latest releases
available from Intel but can be downloaded separately from the respective vendors' customer
sites. If you need to purchase/obtain Intel Fortran, note that you must register on Intel's
customer website with your Intel Fortran license information. Once logged into Intel's cus-
tomer site, you have the option of downloading previous releases.
2.3. Select Your Installation

The next step is to select your installation type. Select the option below that matches your installation.
• Installing ANSYS Products for a Stand-alone Linux System (p. 17)
• Installing ANSYS Products and the License Server on Different Linux Machines (p. 27)
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/v193
or <install_dir> with the actual installation path you used.
Before You Begin

• 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
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.9 and 7.3 through 7.5), SUSE Linux Enterprise 12 (SP2 through
SP3) and CentOS-7.3 and 7.4. 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. 3).
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.
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.
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.
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.
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>/ANSYS193 or /media/ANSYS193 and then run INSTALL as this may
cause unmounting and ejecting issues.
Red Hat Enterprise 6.9 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.3 through 7.5 and SUSE Linux Enterprise 12 SP2 through SP3
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>/ANSYS193
3. Edit the fstab to mount the USB with read/execute permissions.
vi /etc/fstab
Inserting the following line:
/dev/xxxx /run/media/<username>/ANSYS193 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).
3.4. Mounting the DVD Instructions for DVD Installations (Linux x64 Only)
Note
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/ANSYS193 or
/media/<user>/ANSYS193/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
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
Product Installation
where Host is the hostname of the machine where the DVD device is located.
Run man exports for more information.
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>/ANSYS193/INSTALL
/media/ANSYS193/INSTALL
Note
In order to eject the DVD on RedHat, you may need to use the eject command.
eject /media/ANSYS193
2. The ANSYS, Inc. Installation Launcher appears.
From the options along the left side of the launcher you can install ANSYS products and the ANSYS
License Manager.
The ANSYS Quick Start Installation Guide, ANSYS Quick Start Licensing Guide, System Requirements
Guide and complete Installation Help Guide can be accessed through the options located along
the bottom of the launcher.
Select the language you want to use from the drop-down menu in the upper right corner. English
is the default.
3. Click the Install ANSYS Products option.
4. The license agreement appears. Read the agreement, and if you agree to the terms and conditions, select
I Agree. Click Next, located on the right side of the screen.
Note
The question mark icon located in the upper right side of each installation screen displays
an explanation of the functionality available on that screen. The letter "I" icon displays
information about the release version of the installation software.
5. The directory where you wish to install the ANSYS, Inc. products is shown in the Install Directory field.
You can install the products into any directory you wish, but you must have write permissions to the dir-
ectory you choose. The default is /ansys_inc. We recommend using the default directory.
The Symbolic Link option is available only if you are installing as root and is enabled (checked)
by default. If you choose to disable (uncheck) the symbolic link or are installing as a non-root user,
substitute the directory path where you installed the product for all subsequent occurrences of
/ansys_inc in this guide.
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. 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-
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. 57) 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 an updated location for the
NX Custom Directory File Path. To do this, select the NX Geometry Interface option from the Product
& CAD Configuration Manager and click Next. From the configuration screen, select the Workbench
Associative Interface option and enter the NX Custom Directory File Path.
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.
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
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/v193/ACP.sh
CFD Post /ansys_inc/v193/cfdpost
CFX /ansys_inc/v193/CFX/bin/<productname>
Where <productname> can be cfx5, cfx5launch, cfx5pre, cfx-

solve, or cfx5post.
FLUENT /ansys_inc/v193/fluent/bin/fluent
ICEM CFD /ansys_inc/v193/icemcfd/icemcfd
ICEPAK /ansys_inc/v193/icepak/icepak
PolyFlow /ansys_inc/v193/polyflow/bin/polyflow
Turbogrid /ansys_inc/v193TurboGrid/bin/cfxtg
Workbench /ansys_inc/v193/Framework/bin/Linux64/runwb2
3.5.2.1. Registering the License Server

If you are a new user who has not received a license file for your server or if you add or change a license
server machine, follow this procedure to register your license server information. See the ANSYS Licensing
Guide for more information on selecting license servers (Selecting License Server Machines) and on
using the ANSYS License Management Center (License Server Administration Using ANSYS License
Management Center).
1. Open the ANSYS License Management Center. To run the ANSYS License Management Center on Linux
run the following script:
/shared_files/licensing/start_lmcenter
2. Click the Get System Hostid Information option to display your system ID code(s).
3. Select the system ID you wish to use and click SAVE TO FILE.
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. 41).
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/v193
or <install_dir> with the actual installation path you used.
Before You Begin

• 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
• Your local machine's name, to specify as the license server.
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.9 and 7.3 through 7.5), SUSE Linux Enterprise 12 (SP2 through
SP3) and CentOS-7.3 and 7.4. For current platform information, see the Platform Support section of the
ANSYS Website.
be installing. Approximate disk space requirements for each product are shown in Disk Space and
Memory Requirements (p. 3).
This section is divided into four sets of instructions:
• Product Download Instructions: This set of instructions describes the download and extraction process.
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

agreement.
files.
Installing from a USB Drive
directories.
• Continue with the steps described in Product Installation (p. 31).
4.3. Installing from a USB Drive
Note
Red Hat Enterprise 6.9 and CentOS-7.3 and SP4
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.3 through 7.5 and SUSE Linux Enterprise 12 SP2 through SP3
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>/ANSYS193
3. Edit the fstab to mount the USB with read/execute permissions.
vi /etc/fstab
Inserting the following line:
/dev/xxxx /run/media/<username>/ANSYS193 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
4.4. Mounting the DVD Instructions for DVD Installations (Linux x64 Only)
Note
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/ANSYS193.
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
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
where Host is the hostname of the machine where the DVD device is located.
Run man exports for more information.
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>/ANSYS193/INSTALL
/media/ANSYS193/INSTALL
Note
In order to eject the DVD on RedHat, you may need to use the eject command.
eject /media/ANSYS193
2. The ANSYS, Inc. Installation Launcher appears.
From the options along the left side of the launcher you can install ANSYS products and the ANSYS
License Manager.
Select the language you want to use from the drop-down menu in the upper right corner. English
is the default.
Note
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.
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.
next step.
Click Next.
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
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.
Note
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. 57) 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
may need to specify the NX installation path for an existing NX installation.Alternatively, you can run the

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.
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
The ANSYS, Inc. License Manager is now being installed and configured on your system. After the
License Manager installation has been completed, the Launch License Management Center upon
exiting option is included on the screen. The ANSYS License Management Center is a browser-
based user interface that centralizes many of the ANSYS product licensing administrative functions.
If you do not want to launch the License Management Center, clear the Launch License Manage-
ment Center upon exiting option.
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/v193/ACP.sh
CFD Post /ansys_inc/v193/cfdpost
CFX /ansys_inc/v193/CFX/bin/<productname>
Where <productname> can be cfx5, cfx5launch, cfx5pre, cfx-

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

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
cense.
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.
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/v193/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. 41).
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:]\v193\commonfiles\globalset-

tings
2. Open the file ANSYSProductImprovementProgram.txt.
3. Change the value from "on" to "off" and save the file.
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/v193/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. 57) 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.
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 ANSYS193_DIR environment variable sets the location of the ANSYS directory hierarchy.
The default value is /ansys_inc/v193/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.
ANSYS193_PRODUCT - set this to the correct product variable to run Mechanical APDL to
start with the correct product without specifying the -p command modifier each time. See the
ANSYS Product to License Feature Mapping table located on Installation and Licensing
Help and Tutorials page of the ANSYS Customer Portal for a list of valid product variables.
ANSYS_LOCK - set to ON (default) to create file locks to prevent users from opening a new
job with the same name and in the same directory as the current job.
ANSYS193_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.
ANSYS193_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).
ANSYS193_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. 57) 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
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/v193/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
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 2019 R1

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

PATH=cfxroot/bin:$PATH \
export PATH
With the path altered in this way, you can start ANSYS TurboGrid in the current working directory by
typing cfxtg.
Modification of system setup files The system administrator modifies the setup files ( normally
etc/profile), which are run by all users during login, to include the directory cfxroot/bin in the
command search path. While this method has the advantage that only one file must be modified to
allow all users to use the software, it:
• Affects users regardless of whether they use ANSYS TurboGrid
• Can only be done by the root user
• Is system dependent
Refer to your system documentation for information about which files to change for your 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/v193/fluent/bin $path)
or in the Bourne/Korn shell or bash, by entering:

PATH=(/ansys_inc/v193/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/v193/fluent/bin
3. Run the following command:

<install_dir>/ansys_inc/v193/fluent/bin/fluent
4. Click Default.
5. Click Yes when asked if you want to discard the LAUNCHER history.
6. Click Cancel if you do not want to start Fluent at this time. The new defaults will have been saved.
Refer to the ANSYS Fluent Quick Start Guide for more information.
5.1.3. Post-Installation Procedures for ANSYS Polyflow

Polyflow no longer requires the FLUENT_INC environmental variable. It should be deleted as is 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/v193/icemcfd/linux64_amd/bin
2. Add the following environment variable to all users' login startup files.
ICEM_ACN - set to /ansys_inc/v193/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/v193/autodyn/bin
5.1.6. Post-Installation Procedures for ANSYS FENSAP-ICE

Software Launch
To launch FENSAP-ICE, execute:
<install_dir>/ansys_inc/v193/fensapice/bin/fensapiceGUI
Command Line Tools

To use ANSYS FENSAP-ICE command line tools without using full pathnames, you will want to run
FENSAP-ICE with your path altered to include the fensapice/bin directory. You can do this in the C shell
and its derivatives by entering:
setenv PATH <install_dir>/ansys_inc/v193/fensapice/bin/:$PATH
or in the Bourne/Korn shell or bash, by entering:
export PATH=<install_dir>/ansys_inc/v193/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/v193/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/v193/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.3.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 R2019 R1 package is installed.
ANSYS License Server Information will be recognized from the environment variables set on the system.
See the Client Environment Variable Settings section of the ANSYS Licesing Guide for more information.
If the NTI_LICENSE_FILE environment variable has been set, FENSAP-ICE will instead use legacy NTI
FLEXLm licensing. To force the use of ANSYS Licensing and ignore the NTI_LICENSE_FILE option, set an
environment variable as ANSYS_LICENSE_FILE_ONLY=1
NTI Licensing
Legacy license keys from prior to ANSYS R2019 R1 use the NTI FLEXLm license system. The option for
NTI licensing must then be enabled in the licensing.txt file <install_dir>/ansys_inc/v193/fensapice/con-
fig/licensing.txt or by setting up the NTI_LICENSE_FILE environment variable.
Modify the licensing.txt file to contain the license server information NTI_LICENSE_FILE=port@server.
The default port is 27000.
For instructions on how to set-up the NTI license server or on how to force a specific licensing system,
refer to the FENSAP-ICE Installation and Licensing Guide.
5.1.7. Post-Installation Procedures for Other Products

BladeEditor In order to use BladeEditor, you must set the Geometry license preference to ANSYS
BladeModeler as follows:
1. In the ANSYS Workbench menu, select Tools> License Preferences.
2. In the License Preferences dialog box, click the Geometry tab.
3. If ANSYS BladeModeler is not the first license listed, then select it and click Move up as required to move
it to the top of the list. If ANSYS BladeModeler is not in the list, then you need to obtain an ANSYS
BladeModeler license.
4. Select ANSYS DesignModeler in the list and set its value to 0 (which means “Don't Use”). This step prevents
DesignModeler from using an ANSYS DesignModeler license when an ANSYS BladeModeler license is not
available.
5. Click OK to close the dialog box.
You can inadvertently destroy your BladeEditor models by updating a project or otherwise processing
a Geometry cell, depending on your license preference settings. This problem can affect you if you have
any ANSYS DesignModeler licenses. To avoid this problem, configure the license preferences as described
above. For more details, see Configuring the BladeModeler License in the ANSYS 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

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-
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/v193
2. <install_dir>/ansys_inc/v193/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/v193/ansys/docu/fr
2. Copy the message files msgcat.193, msgidx.193, and msgfnm.193 into that subdirectory.
3. Access these files from the Language Selection option of the launcher or via the -l command line option:
ansys193 -l fr

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/v193/ansys/bin/an- For a complete list of command line
APDL sys193 options, see Starting an ANSYS
Session from the Command Level in
the Operations Guide.
ANSYS /ansys_inc/v193/Frame-
Workbench work/bin/<platform>/runwb2
ANSYS CFX /ansys_inc/v193/CFX/bin/cfx5
ANSYS Fluent /ansys_inc/v193/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/v193/icemcfd/<plat-
form>/bin/icemcfd
ANSYS Polyflow /ansys_inc/v193/polyflow/bin/poly-Starts the POLYFLOW MANager. For
man any other tool, use /an-
sys_inc/v193/poly-
flow/bin/<tool>
ANSYS CFD-Post /ansys_inc/v193/CFD-Post/bin/cfd-
post
ANSYS Icepak /ansys_inc/v193/Icepak/bin/icepak
ANSYS /ansys_inc/v193/TurboGrid/bin/cfx-
TurboGrid tg
ANSYS Autodyn /ansys_inc/v193/autodyn/bin/auto- solver only
dyn193
ANSYS ACP /ansys_inc/v193/ACP/ACP.sh
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
Silent Mode Operations
For more information on which products are included with each installation, see Applications Included
with Each Product (p. 69).
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.

-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. 53) 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
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
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/v193/ProductConfig.sh -silent
Note
On an HPC cluster environment, prerequisites must be installed on each cluster execution

node.
Use the -product_flag argument to specify which products should be configured. If you do not
specify one or more products, all products that have been installed will be configured. The valid
product_flags are:
ANSYS CFX -cfx
Errors will be written to the ${HOME}/.ansys/v193/ directory on the client machine.
6.3. Silent Media Installation

To run a silent installation from the media, you can either:
Silent Media Installation
• Copy the contents of each DVD to a folder on the machine's hard disk such that the 193-<number>.dvd
files of each DVD are located in the same directory. You can then proceed with the silent installation as de-
scribed earlier.
• Place all of the media in separate drives (any combination of virtual ISO mounts or hardware drives) so that
they can be accessed simultaneously during the installation. Then run the silent installation as described
earlier, but include the additional -media_dir2 <path> and -media_dir3 <path> options as needed
for each drive:
INSTALL -silent -install_dir <path> -product_flag -media_dir2 <path> -media_dir3 <path>
The installer uses the mount directory from which it was launched as the first media path; you need
to specify only the location of the subsequent DVD(s) using the -media_dir2 and -media_dir3
options shown in the example above.
6.3.1. Silent Uninstall

You can also run the uninstall silently by issuing the following command:
/ansys_inc/v193/ans_uninstall193 –silent
The silent uninstall will automatically uninstall all products for this release and delete the v193 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:

ANSYS CFX -cfx
For example, to uninstall only TurboGrid and Icepak, issue the following command:
/ansys_inc/v193/ans_uninstall193 –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.
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/v193/aisol/.workbench -cmd -NoMW mono /ansys_inc/v193/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:
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.
Administrative users can review the log file produced by the most recent Product & CAD Configuration
in ansys_inc/v193/CADConfigLogs/Latest/CADConfigurationMgr.log, while the non-admin user
configuration record is stored in /tmp/ANSYS/v191/CADConfigLogs/Latest. Historical configurations are
maintained in the corresponding <Ansys Version>/<Date>/CADConfigurationMgr_<Time>.log.
Any errors are recorded in CADConfigurationMgr.err located immediately in CADConfigLogs
directory.
You can review the Product & CAD Configuration Manager log file, CADConfigurationMgr.log,
in /ansys_inc. If you do not have write permissions to the /ansys_inc directory, the log file will
be written to $TEMP. If you have not defined $TEMP, the log file is written to /tmp. When /tmp is not
accessible, this file will be written to the current working directory.
7.1.1. Unconfiguring
If you need to unconfigure any of your CAD products, follow the steps above, but choose Unconfigure
Products & CAD from the Product & CAD Configuration Manager.
7.1.2. Running the Product & CAD Configuration Manager in Batch Mode
You can configure ANSYS Geometry Interfaces by supplying the Product & CAD Configuration Manager
with arguments specific to the CAD sources you want to make available. The following table contains
a list of supported arguments.
The command to run the Product & CAD Configuration Manager in batch mode on Linux is:
/ansys_inc/v193/aisol/.workbench -cmd -NoMW mono /ansys_inc/v193/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.
Using the Product & CAD Configuration Manager

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).
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:
Ans.CadInt.CADConfigurationUtility.exe -UG_CONFIG_WB -UGII_BASE_DIR "<pathtonx>"
where /ansys_inc/v193 is the installation directory you specified.
To unconfigure the same CAD Interface, the command would be:

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/v193/aisol/CADIntegration/UG to either /ansys_inc/v193/com-
monfiles/registry/linx64/append when the configuration manager is in administrative mode or
to $HOME/.config/ANSYS/193/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).
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.
Chapter 8: Uninstalling the Software
To uninstall a product, issue the following command:
/ansys_inc/v193/ans_uninstall193
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/v193/ansys/bin/ans_admin193
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.
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.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. For more information on downloading files from the ANSYS customer
Troubleshooting
site, see Product Download Instructions (p. 18). Use a USB Flash drive or follow the instructions in
Mounting the DVD Instructions for DVD Installations (Linux x64 Only) (p. 20) to mount to a machine
that does have a DVD drive.
9.1.4. Product & CAD Configuration Manager Help Does Not Load
If the help for the Product & CAD Configuration Manager does not load into your default browser,
set the BROWSER environment variable to the path of your HTML viewer (such as Mozilla or Firefox)
and restart the Product & CAD Configuration Manager.
9.1.5. Cannot Enter Data in Text Fields

SUSE On some SUSE Linux systems, if you cannot enter data in text fields during the installation or
when using the ANSLIC_ADMIN utility, you may be encountering a Tcl incompatibility. To correct the
problem, unset the following environment variables before running the installation or the 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-
Installation Troubleshooting - Graphics
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, ANSYS193_DIR environment variable is not set. This is a fatal error – exiting.
This message indicates that the ANSYS193_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 2019 R1 with a different
version of MPI than is supported. See the Parallel Processing Guide for a complete list of supported
MPI versions.
9.1.9. INSTALL Command Appears as Lowercase in USB Installation

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

The items listed below apply to issue relating to graphics cards and drivers.
9.2.1.DesignModeler and Mechanical APDL Crash When Using the Latest AMD
Graphics Drivers
With the AMD 18.Q1 graphics driver two issues have been discovered:
• Launching DesignModeler causes a libgl error to output in the terminal. Immediately after this error the
ANSYS application crashes and forces you back to the login screen.
• Importing a geometry file into a static structural system shows a green check mark, but upon launching
Mechanical APDL the ANSYS application crashes and forces you back to the login screen.
AMD is aware of this issue and plans to address the problem.
If you experience either issue, perform the following work-around suggested by AMD.
Troubleshooting
Issue the following commands:
ln -sf /opt/amdgpu-pro/lib64/libGL.so.1.2 /usr/lib64/libGL.so.1
ln -sf /opt/amdgpu-pro/lib64/libGL.so.1.2 /usr/lib64/libGL.so
9.3. Installation Troubleshooting - Mechanical APDL

The items listed below apply only to the Mechanical APDL product.
9.3.1. Your batch jobs terminate when you log out of a session
On some systems, you may need to use the ‘nohup’ option to allow batch jobs to continue running
after you log out of a session. If you are running via the Launcher, select Options> Use ‘nohup’ To
Start Batch Runs With Output Sent to ‘File Only.’ We do not recommend using this setting on systems
that automatically set ‘nohup.’
9.3.2. Mechanical APDL Documentation File for User Interface Error Messages
Missing or erroneous documentation files for user interface. Command ignored.
Verify that the documentation list file for the user interface exists in the /ansys_inc/v193/an-
sys/gui/en-us/UIDL subdirectory.
ls -l /ansys_inc/v193/ansys/gui/en-us/UIDL/menulist.ans
The system should respond with:

-rw-r--r-- 1 root 23 Jan 8 11:50 /ansys_inc/v193/ansys/gui
/en-us/UIDL/menulist.ans
Make sure that the pathnames in the menulist.ans file are correct.
9.3.3. Launcher Error Messages

Some of the more common error messages follow. See the ANSYS Licensing Guide for licensing-related
launcher messages.
***Cannot create required <profile> file. Therefore, cannot write to profile information during
this launcher session.
If you see this error, you cannot add or modify profile information during this launcher session.
Verify that you have write access to the directory and restart the launcher session. Typically, this
directory is C:\Documents and Settings\<user name>\Application Data\AN-
SYS\v193\launcher on Windows or ~/.ansys/v193/launcher on Linux.
9.3.4. FORTRAN Runtime Error Messages

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

Input/Output Error 177: Create Failure
In Procedure: fappnd
At Line: 72
Statement: Formatted WRITE
Unit: 19
9.3.4.2. Intel EM64T Linux x64 Systems

forrtl: Permission denied
forrtl: severe (9): permission to access file denied, unit 19, file /build/v193/ansys/objs
9.3.4.3. AMD Opteron Linux x64 Systems

***ERROR
Unable to open file /build/v193/ansys/objs/file.err for WRITE. Check directory and file permissions.
9.4. Installation Troubleshooting - ANSYS Workbench

9.4.1. Startup or Graphics Problems
To minimize graphics problems, always verify that you are running the latest graphics drivers provided
by your computer's hardware manufacturer.
If you are running ANSYS Workbench on Linux and experience problems at startup or with the GUI or
graphics displaying correctly, and you are running in accelerated graphics mode, you may need to 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.5. Installation Troubleshooting - ANSYS CFX

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


locations.
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
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.
Installation Guide for Windows

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

Table of Contents
1. Installation Prerequisites for Windows ................................................................................................... 1
1.1. System Prerequisites ......................................................................................................................... 3
1.1.1. CAD Support ............................................................................................................................ 4
1.2. Disk Space and Memory Requirements ............................................................................................. 5
1.3. Software Prerequisites ...................................................................................................................... 6
1.4. Requirements for the GPU Accelerator in Mechanical APDL ............................................................... 7
1.5. Additional Hardware and Software Requirements ............................................................................. 8
1.5.1. ANSYS Discovery AIM Requirements ....................................................................................... 10
1.5.2. 3Dconnexion Product Support ............................................................................................... 10
1.6. Third-Party Software and other Security Considerations ................................................................... 10
2. Platform Details .................................................................................................................................... 11
2.1. Utilizing CPU Hyperthreading Technology with ANSYS CFD Solvers .................................................. 13
2.2. Compiler Requirements for Windows Systems ................................................................................. 13
2.3. Select Your Installation .................................................................................................................... 14
3. Installing ANSYS Products for a Stand-alone Windows System ........................................................... 15
3.1. Downloading the Installation Files ................................................................................................... 16
3.1.1. Installing from a USB Drive ..................................................................................................... 16
3.1.2. Installing from a DVD ............................................................................................................. 16
3.2. Installing ANSYS, Inc. Products ......................................................................................................... 17
3.2.1. Product Installation with Client Licensing ............................................................................... 17
3.2.1.1. Specifying CAD Configurations ...................................................................................... 20
4. Installing ANSYS Products and the License Manager on Different Windows Machines ....................... 25
4.1. Downloading the Installation Files ................................................................................................... 26
4.1.1. Installing from a USB Drive ..................................................................................................... 27
4.1.2. Installing from a DVD ............................................................................................................. 27
4.2. Installing ANSYS, Inc. Products ......................................................................................................... 27
4.2.1. Product Installation with Client Licensing ............................................................................... 27
4.2.1.1. Network Server and Product Configuration .................................................................... 31
4.2.1.2. Specifying CAD Configurations ...................................................................................... 33
5.1. Post-Installation Procedures for Mechanical APDL and ANSYS Workbench Products ......................... 38
5.1.1. Post-Installation Procedures for ANSYS Fluent ......................................................................... 39
5.1.1.1. Installing Intel-MPI 2018.3.210 ....................................................................................... 40
5.1.2. Post-Installation Procedures for ANSYS Polyflow ..................................................................... 41
5.1.3. Post-Installation Procedures for ICEM CFD ............................................................................... 41
5.1.4. Post-Installation Procedures for ANSYS FENSAP-ICE ................................................................. 41
5.1.5. Post-Installation Procedures for Other Products ...................................................................... 42
5.2. Launching ANSYS, Inc. Products ....................................................................................................... 42
5.3. Running the ANS_ADMIN Utility for Mechanical APDL /ANSYS Workbench Products ........................ 43
5.4. Product Localization ....................................................................................................................... 43
5.4.1. Translated Message File Installation for Mechanical APDL /ANSYS Workbench Products ........... 44
6. Installing MPI for ANSYS Parallel Processing ........................................................................................ 45
6.1. Intel-MPI 2017.3.210 Installation Instructions ................................................................................... 45
6.2. IBM MPI 9.1.4.3 Installation Instructions ........................................................................................... 46
7. Silent Mode Operations ........................................................................................................................ 47
7.1. Silent Product and License Manager Installation .............................................................................. 49
Windows Installation Guide
7.1.1. Silent Product Configuration/Unconfiguration ........................................................................ 52

7.1.2. Silent Media Installation ......................................................................................................... 53
7.1.3. Silent Uninstall ....................................................................................................................... 53
8. Configuring CAD Products .................................................................................................................... 55
8.1. Using the Product & CAD Configuration Manager ............................................................................ 55
8.1.1. Unconfiguring ........................................................................................................................ 57
8.1.2. Running the Product & CAD Configuration Manager in Batch Mode .................................... 57
8.1.3. Network Considerations ......................................................................................................... 59
8.1.4. Uninstalling ........................................................................................................................... 59
8.1.5. Creo Parametric Configuration ............................................................................................... 60
8.1.5.1. Configuring the Connection for Creo Parametric ............................................................ 61
8.1.5.1.1. The WBPlugInPE.dat File and config.pro File ........................................................... 61
8.1.5.1.2.The config.pro File ................................................................................................. 62
8.1.5.1.3.The config.anscon.193 File ..................................................................................... 62
8.1.5.2. Creo Parametric Environment Variables .......................................................................... 62
8.1.6. NX Configuration ................................................................................................................... 62
8.1.6.1. Configuring the Connection for NX ................................................................................ 63
8.2. Configuring CADNexus/CAPRI CAE Gateway for CATIA V5 ................................................................ 63
8.3. Configuring AutoCAD ..................................................................................................................... 64
9. Uninstalling the Software ..................................................................................................................... 67
9.1. Uninstalling Licensing Components ................................................................................................ 68
10. Troubleshooting .................................................................................................................................. 69
10.1. Installation Troubleshooting .......................................................................................................... 69
10.1.1. Using ANSLIC_ADMIN to Gather Diagnostic Information ....................................................... 69
10.1.2. Uninstall Gives Access Denied Error Message ........................................................................ 69
10.1.3. Uninstall on a Windows 7 or Windows 10 System Gives Compatibility Error Message .............. 69
10.1.4. A .chm File Does Not Display Properly Across a Network ........................................................ 70
10.1.5. Products Crash with an Application Error .............................................................................. 70
10.1.6. Product Installation Does Not Create Start Menu Item for ANSYS and CAD Plugins Do Not
Work .............................................................................................................................................. 70
10.1.7. Product Installation Displays Security Warning Dialogs or Silent Product Installation Hangs
on a Network Install ........................................................................................................................ 70
10.1.8. System-related Error Messages ............................................................................................. 71
10.1.9. CasPol Error Messages .......................................................................................................... 71
10.1.10. Installing Prerequisites May Require a System Restart .......................................................... 71
10.1.11. Confirmation Messages Open Behind the Installer Display in Windows ................................ 71
10.1.12. Start menu shortcuts are successfully created but are not displayed in the Start Menu ......... 72
10.2. Installation Troubleshooting - Graphics .......................................................................................... 72
10.2.1. ANSYS AIM Graphics Are Note Being Displayed Correctly With the Latest AMD Graphics
Drivers .......................................................................................................................................... 72
10.3. Installation Troubleshooting - Mechanical APDL and ANSYS Workbench Products .......................... 72
10.3.1. The Mechanical APDL Launcher is Excessively Slow to Start ................................................... 72
10.3.2. Display Problems on Windows .............................................................................................. 72
10.3.3. ANS_ADMIN Error Messages ................................................................................................. 72
10.3.4. Mechanical APDL Product Launcher Error Messages .............................................................. 73
10.3.5. Distributed Mechanical APDL IBM Platform MPI Error Messages ............................................. 73
10.3.6. ANSYS Workbench Products Troubleshooting ....................................................................... 73
10.4. Installation Troubleshooting - ANSYS CFX ...................................................................................... 74
10.4.1. TurboGrid Mouse Behavior Problems .................................................................................... 74
10.5. Contacting Technical Support ....................................................................................................... 74
11. Applications Included with Each Product ........................................................................................... 75
List of Tables
1.1. Supported Windows Platforms ................................................................................................................ 3
1.2. CAD Support by Platform ........................................................................................................................ 4
2.1. Compiler Requirements for All Windows Versions .................................................................................. 13
Chapter 1: Installation Prerequisites for Windows
This document describes the steps necessary to correctly install and configure all ANSYS, Inc. products
on Windows platforms for Release 2019 R1. These products include:
• ANSYS Structural Mechanics
– ANSYS Mechanical Products (includes ANSYS Mechanical and Mechanical APDL)
– 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 Offshore
– ANSYS Aqwa
• ANSYS Additional Tools
– ANSYS Icepak (includes ANSYS CFD-Post)
– Remote Solve Manager Standalone Services
• ANSYS Geometry Interfaces
– AutoCAD
– ACIS
Installation Prerequisites for Windows
– Creo Elements/Direct Modeling
– Autodesk Inventor
– JTOpen
– NX
– Parasolid
– Creo Parametric
– Solid Edge
– SOLIDWORKS
Note
ANSYS Workbench is installed by default as product components to most ANSYS, Inc. products.
ANSYS Workbench is not installed as part of the products under ANSYS Additional Tools, nor
with the CFD-Post only option. ANSYS Workbench includes the following applications:
• The Mechanical Application
• DesignModeler
• Design Exploration
• Meshing
• Remote Solve Manager
• Fluent Meshing
• EKM Client
• SpaceClaim Direct Modeler
Caution
While SpaceClaim Direct Modeler and ANSYS SpaceClaim can be installed

on the same computer, only one of the applications can be configured
with ANSYS Workbench at any given time. Users can choose which version
to configure via the CAD Configuration Manager utility.
Because some of these applications can be run as standalone applications without ANSYS
Workbench, you will see some but not all of these listed separately as options when you
uninstall. In such cases, you will need to select those options in order to uninstall those
components.
Where supported, IGES and STEP Geometry Interfaces will be installed.
System Prerequisites
Some procedures apply only to specific products and are so noted.
Important Notice
If you want to run multiple releases of ANSYS, Inc. software, you MUST install them chronologically (for
example., Release 19.2 followed by Release 2019 R1). If you install an earlier release after installing Release
2019 R1, you will encounter licensing issues that may prevent you from running any products/releases.
If you need to install an earlier release after you have already installed Release 2019 R1, you MUST un-
install Release 2019 R1, then re-install the releases in order.
Summary of New and Changed Features

The following features are new or changed at Release 2019 R1. Review these items carefully.
• The ANSYS EKM Server installation options have been permanently removed from the ANSYS installation
program.
• The ANSYS PDM Interfaces heading and related Teamcenter installation option have been removed from
the ANSYS installation program.
• When right-clicking to open an ANSYS product related file, the "Open with" menu option lists release spe-
cific names for the ANSYS application that is associated with the product file.
• The ANSYS Discovery product suite has been added to the ANSYS installation program. This addition includes:
ANSYS Discovery AIM, ANSYS Discovery Live and ANSYS Discovery SpaceClaim.
• If you select the ANSYS Discovery AIM product during installation, the OpenCL runtimes are now installed
silently if needed.
1.1. System Prerequisites

ANSYS 2019 R1 is supported on the following Windows platforms and operating system levels. For up-
to-date information on hardware platforms or operating systems that have been certified, see the
Platform Support section of the ANSYS Website.
Table 1.1: Supported Windows Platforms
Processor Operating System Platform architecture Availability

(directory name)
x64 (64-bit) Windows 7 (Professional & Enterprise), winx64 Download, USB
Windows 10 (Professional, Enterprise
& Education), Windows Server 2016
Note
Home editions of Windows operating systems are not supported.
For detailed and current support information, see the Platform Support section of the ANSYS Website.
Supported Products By Platform For a complete list of products supported by each platform, see
the Platform Support by Application PDF on the Platform Support section of the ANSYS Website.
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
(where the CAD product is supported on the noted 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
Product Windows 7 Windows 10 5

CATIA 4.2.4 A, W, I A, W, I
CATIA V5–6R2018 A, W, I A, W, I
CATIA V5 (CADNexus CAPRI CAE Gateway V3.40.0) W, I W, I2
V5–6R2016, V5–6R2017, V5–6R2018
CATIA V6 R2018x W, I W, I
Parasolid 30.0 A, W, I A, W, I
Creo Parametric 3.0 A, W, I A, W, I3
Creo Parametric 4.0 A, W, I A , W, I8
Creo Parametric 5.0 A, W, I A, W, I
ACIS 2018 A, W, I 1 A, W, I 1
NX 10.0 A, W, I
NX 11.0 A, W, I A, W, I
NX 12.0 6 A, W, I A, W, I
SOLIDWORKS 2018 W, I W, I
SOLIDWORKS 2019 W, I W, I
Solid Edge ST10 W, I W, I
Solid Edge 2019 W, I W, I
Inventor 2018 W, I W, I
Inventor 2019 W, I7 W, I9
AutoCAD 2018 W, I W, I
AutoCAD 2019 W, I7 W, I9
IGES 4 A, W, I A, W, I
JT 10.0 W, I W, I
STEP AP203, AP214 W, I W, I
Creo Elements/Direct Modeling 20.0 W, I W, I
Creo Elements/Direct Modeling 20.1 W, I10 (p. 5) W, I
GEMS I I
IDI MS8/9 I I
Disk Space and Memory Requirements
Product Windows 7 Windows 10 5

Rhinoceros W, I W, I
SketchUp W, I W, I
1. For ICEM CFD standalone, ACIS 18.0.1 is the supported version for all platforms.
2. Requires V5-6R2016 or later.
3. Requires Creo Parametric 2.0 M190.
4. IGES Versions 4.0, 5.2, and 5.3 are supported.
5. Professional, Education and Enterprise
6. Not supported with ANSYS Fluent
7. Requires operating system's SP1 Update KB4019990
8. Requires Creo Parametric 3.0 M060 or later.
9. Requires operating system's Anniversary Update version 1607 or higher
10. Requires operating system SP1.
Note
View the latest supported CAD packages at ansys.com> Solutions> Solutions by Role>
IT Professionals> Platform Support> CAD Support.
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 for each ANSYS, Inc. product.
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

Discovery AIM 19.5 GB
Discovery Live 10.9 GB
Discovery SpaceClaim 10.9 GB
ANSYS Autodyn 11.3 GB
ANSYS LS-DYNA 11.9 GB
ANSYS CFD-Post only 11.7 GB
ANSYS CFX 12.0 GB
ANSYS Chemkin 11.7 GB
ANSYS Energico 11.7 GB
ANSYS Model Fuel Library (Encrypted) 11.7 GB
ANSYS Reaction Workbench 11.7 GB
Product Disk Space

ANSYS EnSight 13.6 GB
ANSYS FENSAP-ICE 12.0 GB
ANSYS Fluent 14.8 GB
ANSYS Forte 11.6 GB
ANSYS Polyflow 15.8 GB
ANSYS TurboGrid 11.8 GB
ANSYS ICEM CFD 11.7 GB
ANSYS Aqwa 11.3 GB
ANSYS Customization Files for User Programmable 14.9 GB
Features
ANSYS Mechanical Products 12.3 GB
ANSYS Icepak 15.2 GB
ANSYS Remote Solve Manager Standalone Services 10.9 GB
ANSYS Viewer 11.0 GB
ACIS Geometry Interface 3.7 GB
AutoCAD Geometry Interface 3.5 GB
Creo Elements/Direct Modeling Geometry Interface 3.5 GB
Creo Parametric Geometry Interface 5.4 GB
Inventor Geometry Interface 5.4 GB
JTOpen Geometry Interface 3.7 GB
NX Geometry Interface 5.4 GB
Parasolid Geometry Interface 3.7 GB
Solid Edge Geometry Interface 3.5 GB
SOLIDWORKS Geometry Interface 5.4 GB
Disk space required to install all products 35.2 GB
Product installations also require an additional 500 MB of free disk space during an installation.
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. Software Prerequisites

You must have the following software installed on your system. Administrator privileges are required
to install these files. These software prerequisites are installed automatically when you launch the
product installation. If, after installing the ANSYS products, you need to check your system for these
software prerequisites or re-install any of them at a later date, open the Product & CAD Configuration
Manager and select Check for Required Prerequisites or Install Required Prerequisites.
Requirements for the GPU Accelerator in Mechanical APDL
• A minimum version of Microsoft .NET Framework 4.6.2 is required.
Note
If your computer does not have Microsoft .NET Framework 4.6.2 installed, the install-
ation program installs .NET 4.6.2 as a prerequisite and may require a system restart
after exiting the installation and before running any ANSYS products.
• Intel OpenCL runtimes when using the ANSYS Discovery AIM product
Note
If you selected the ANSYS Discovery AIM product during installation, the OpenCL
runtimes are included as part of the prerequisite installation.
• Microsoft Visual C++ 2010 Redistributable (32 and 64 bit versions)
Prior to installing, you can find the executables for the software prerequisites in the root \prereq
directory of the media/download package.
1.4. 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 NVIDIA GPU card. The following
cards are recommended:
NVIDIA Tesla Series (any model)

NVIDIA Quadro GV100
NVIDIA Quadro GP100
NVIDIA Quadro P6000
NVIDIA Quadro P5000
NVIDIA Quadro M6000
NVIDIA Quadro K6000
• 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 (FP64) 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 GV100
NVIDIA Quadro GP100
NVIDIA Quadro K6000
• NVIDIA GPU devices with at least 12GB of on-card memory are recommended in order to achieve optimal
performance.
• For NVIDIA GPU cards, the driver version must be 385.54 or newer. For optimal performance on Windows,
the TCC (Tesla Compute Cluster) driver mode is recommended when using Tesla series GPU cards. Some
limitations exist when using this driver mode. Check your GPU card documentation for more details on how
to set this driver mode and the existing limitations.
• To utilize a NVIDIA GPU device that is not on the recommended list of cards, set the following environment
variable:
ANSGPU_OVERRIDE=1
This is most beneficial when you wish to run on newer NVIDIA GPUs that were not available at the
time of release of this version of the ANSYS program. If you choose to use this environment variable,
you should ensure that the NVIDIA GPU device that you wish to use is sufficiently powerful, in terms
of both double-precision compute power and on-card memory, to achieve meaningful acceleration
for your simulation. Using this environment variable with an underpowered CPU may actually decel-
erate your simulation.
Note
On Windows, the use of Remote Desktop may disable the use of a GPU device. Launching
Mechanical APDL through the ANSYS Remote Solve Manager (RSM) when RSM is installed
as a service may also disable the use of a GPU. In these two scenarios, the GPU accelerator
capability cannot be used. Using the TCC (Tesla Compute Cluster) driver mode, if applicable,
can circumvent this restriction.
1.5. Additional Hardware and Software Requirements

• Intel 64 / AMD64 system with the correct operating system version installed
• 8 GB of RAM (Minimum)
• 128 GB free on the hard drive is recommended
• A current default web browser must be installed to view the ANSYS internet-based help documentation.
For a complete list of supported browsers, see the Browser Support PDF on the Platform Support
For a local copy of the product documentation on your system, download an installable version from
the ANSYS Download Center. Instructions for installing the Local Help are included with the download
package.
• Discrete graphics card with the latest drivers and compatible with the supported operating systems. For full
functionality, use of a recent NVIDIA Quadro or AMD FirePro card with at least 1 GB of discrete video memory
and supporting OpenGL version 4.5 or above. Intel Iris Pro Integrated graphics has also been used successfully.
For information on the most recently tested graphics cards, see the Graphics Cards TestedPDF on
the Platform Support section of the ANSYS Website.
Additional Hardware and Software Requirements
For the ANSYS DiscoveryAIM product, see also ANSYS Discovery AIM Requirements (p. 10).
Note
– Vendor Legacy Support: To be compatible, legacy GL 4.5 compliant cards should

still be within the official legacy support period of their respective graphics vendor,
and must still be receiving regular driver updates. Visit the vendor websites (AMD
and NVIDIA) to review legacy hardware lists.
• A minimum screen resolution of: 1024 x 768 (4:3 aspect ratio), 1366 x 768 (16:9 aspect ratio) or 1280 x 800
(16:10 aspect ratio) with minimum 24 bit color. A higher screen resolution such as 1920x1080 (16:9) or
1920x1200 (16:10) is strongly recommended for most applications.
Note
– Some combinations of graphics card type, operating system, and MPEG resolution fail
to play MPEGs properly. You may be able to get normal playback results simply by
changing the MPEG settings. Alternatively, you can upgrade your graphics card.
– 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.
• Microsoft Mouse or a mouse. Most applications require a three-button mouse.
• If you use a 3Dconnexion product, ensure that you have the latest version of the drivers installed.
• Approximately twice as much swap space as memory. The amount of memory swap space on the system
may limit the size of the ANSYS model that can be created and/or solved.
• TCP/IP for the license manager (see the ANSYS Licensing Guide for more information on TCP/IP).
Although TCP/IP is included as part of the operating system, it may not be installed by default. When
TCP/IP is installed, it must be bound to a network adapter. On machines that are connected to an
internal network, TCP/IP must be bound to a network card such as an Ethernet adapter. The vast
majority of systems using TCP/IP will fall into this category. On machines that connect to the internet
or corporate intranet through a modem, TCP/IP can be bound to the Remote Access Service. Also,
the Autodial option of the Internet Options must be disabled so that the machine does not attempt
to connect to the Internet every time ANSYS is run. See the ANSYS Licensing Guide for more inform-
ation.
• Microsoft Internet Explorer (IE) 11 or greater is recommended for proper operation of ANSYS Workbench.
Once the correct version of IE is installed, it does not have to be your default Internet browser. After install-
ation, simply run your preferred browser and reestablish it as the default.
• PDF reader software is required to read the installation guides and other user documentation.
To access our help system videos, ANSYS recommends that you set Windows Media Player as your
default.
1.5.1. ANSYS Discovery AIM Requirements

Minimum of OpenCL 1.2 drivers are required to make use of Exploratory Results Processing in AIM.
• Graphics driver installation for AMD, NVIDIA and Intel will either provide OpenCL by default or as an option.
• We recommend you additionally have installed INTEL or AMD CPU drivers, these can allow us to offload
more work to unused cores.
1.5.2. 3Dconnexion Product Support

Only specific ANSYS applications have been tested for manipulating the model (turning, zooming,
panning, etc.) with the 3Dconnexion products. While these 3Dconnexion products do provide significantly
enhanced 3D control over viewing the model, they do not function as a mouse replacement and selection
operations still require a mouse. For a complete list of 3Dconnexion products certified with the current
release of ANSYS applications, see the 3Dconnexion Devices Certification PDF on the Platform Support
To use a 3Dconnexion product with the listed products, you must download and install the appropriate
Microsoft Windows driver for your version of Windows. Refer to http://www.3dconnexion.com for more
information on using Space products and to download the appropriate drivers.
Spaceball/Connexion3D functionality in ANSYS Discovery AIM

• Only the "FIT" built in function is supported.
• Most of the other operations can be simulated by mapping Connexion functions to keyboard shortcuts
supported in ANSYS Discovery AIM. See Manipulating a Geometric Entity for more information on AIM key-
board shortcuts.
1.6. 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.exe
Tk want.exe
Perl perl.exe
7zip 7z.exe
Microsoft .NET .net
Framework
Chapter 2: Platform Details
Windows 7 and Windows 10 User Account Control (UAC)
Windows 7 and Windows 10 use a feature called User Account Control (UAC) to control privileges and
automatically reduce the potential of security breaches in the operation system. However, UAC limits
your accessibility to system areas and can cause unpredictable behavior in ANSYS, Inc. products.
ANSYS, Inc. requires that you have full administrative privileges when installing any software on Microsoft
Windows 7 and 10. Non-administrative accounts do not usually have the permissions required to access
system areas that installation programs often need to modify. “Full administrative privileges” means
that you are running as administrator with UAC turned off, or you are running as administrator with
UAC turned on and Run as Administrator selected. Because of changes to the UAC functionality, it is
necessary that you right-click and select Run as Administrator from the context menu when installing
to Windows 10.
Recommended Installation Options for Windows 7:
• UAC turned off and install as full administrator (preferred method)
• UAC turned on and install with full administrative privileges (using Run as Administrator from the context
menu)
Note
If you are running with UAC on, even if you have administrative privileges, you will have
limited account control unless you specifically choose Run as Administrator.
Recommended Installation Options for Windows 10:
• UAC turned off and install with full administrative privileges (using Run as Administrator from the context
menu)
When installing ANSYS, Inc. products, we strongly recommend that you use the recommended options
above. If UAC is enabled, we recommend that you turn UAC off before installing ANSYS, Inc. products,
and then turn it back on when finished installing. You must be an administrative user in order to disable
UAC.
Follow the instructions for your operating system for disabling UAC.
Once you have installed your applications, you can enable UAC again.
Installing with UAC On

If you cannot disable UAC and need to install with UAC on, you must run all applications, including the
installation setup, as an administrator. Otherwise, the files may be written to AppData\Local\Vir-
Platform Details
tualStore\<path> (or similar) rather than directly to <path>, if <path> is a protected directory
(such as C:\Program Files). As a result, some applications and utilities may behave unpredictably.
If you cannot disable UAC, you should perform the following functions:
For Windows 7:
• Always run ANSLIC_ADMIN, the File Association utility, and the Product & CAD Configuration Manager
by selecting the utility or application from the Start menu and right-mouse clicking and selecting Run as
Administrator.
• Set your Start menu shortcuts to always run as administrator with the following procedure (or similar):
1. Right-click the shortcut you wish to modify and select Properties.
2. From the Properties dialog box, click Advanced on the Shortcut tab.
3. Select Run as administrator and click OK.
4. Click OK.
Refer to your operating system documentation or visit www.microsoft.com for more instructions on
setting Run as Administrator at various levels within the operating system.
For Windows 10:
• Always run ANSLIC_ADMIN, the File Association utility, and the Product & CAD Configuration
Manager by selecting the utility or application from the Start menu and right-mouse clicking and se-
lecting Run as Administrator.
• Set your Start menu shortcuts to always run as administrator with the following procedure (or similar):
1. Right-click the shortcut you wish to modify and select Open File Location from the options located
at the bottom of your screen.
2. Right-click the shortcut file that is displayed and click Properties from the menu.
3. From the Properties dialog box, click Advanced on the Shortcut tab.
4. Select Run as administrator and click OK.
5. Click OK.
Notes about UAC

When installing ANSYS, Inc. products, including the license manager, on Windows 7 or Windows 10
machines, you need to be aware of several factors involving User Access Control (UAC):
You should install the ANSYS, Inc. License Manager using the same permissions as you used to install
the product.
If you install both the product and the license manager with full administrative privileges, the product
and licensing installation and configuration will proceed as normal.
Compiler Requirements for Windows Systems
If you install as an administrative user with UAC turned on, you may encounter unpredictable behavior
with both the product and license manager installations and subsequent behavior. As an administrator,
you should choose to install and run applications with full administrative privileges to avoid any unpre-
dictable situations. We strongly recommend against running with UAC on and not selecting Run as
Administrator. These situations are described below.
1. If you have UAC turned on and you do not install (and run) with full administrative privileges, be aware
that files may be written to and read from the %localappdata%\VirtualStore\ location (in the case
of licensing, to %localappdata%\VirtualStore\Program Files\ANSYS Inc\Shared
Files\Licensing) instead of to the <os drive>.
In this situation, ANSLIC_ADMIN settings, such as Specify the License Server Machine, will indicate
that files are being written to and read from <os drive>\Program Files\ANSYS Inc\Shared
Files\Licensing. Log files may behave in the same way. However, when you view the an-
syslmd.ini file located in <os drive>\Program Files\ANSYS Inc\Shared
Files\Licensing, you will not see the ANSLIC_ADMIN settings you specified.
2. To ensure that files are correctly written to and read from <os drive>\Program Files\ANSYS
Inc\Shared Files\Licensing, you should always run with full administrative privileges by selecting
Run as Administrator.
3. If you are not running with full administrative privileges, you will not be able to use those ANSLIC_ADMIN
options that require administrative privileges, such as starting and stopping the license manager.
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 Windows Systems

Table 2.1: Compiler Requirements for All Windows Versions
Mechanical APDL, CFX Compilers* Fluent Compilers* AUTODYN

ANSYS Workbench Compilers*
Compilers*
Microsoft Visual Microsoft Visual Visual Studio 2013, Microsoft Visual
Studio Professional Studio 2015 and 2017 Studio
2015 update 3 Professional 2015 compilers (including Professional 2015
(including the MS C++ update 3 the MS C++ update 3
compiler), Intel C++ (including the MS compiler) (including the MS
17.0.4 and Intel Visual C++ compiler) and C++ compiler)
FORTRAN 17.0.4 Intel Visual and Intel Visual
compilers FORTRAN 17.0.4 FORTRAN 17.0.4
compilers compilers
Platform Details
* 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 and Microsoft 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.
For Microsoft Visual Studio, an MSDN subscription is required, which allows you to
download previous releases. Note that purchasing the latest Microsoft Visual Studio
software without an MSDN subscription may not entitle you to download previous re-
leases.
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 Windows System (p. 15)
• Installing ANSYS Products and the License Manager on Different Windows Machines (p. 25)
Chapter 3: Installing ANSYS Products for a Stand-alone Windows
System
This section includes the steps required for installing ANSYS, Inc. products and licensing configuration
on one Windows machine.
You can follow these instructions while actually installing the products and setting up the license
server. To do so, simply use the selections that are pertinent to you and insert your specific information
where noted.
Before You Begin

• Open port numbers for FlexNet 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 -p tcp
• Your local machine's hostname, to specify as the license server.
You should also verify that you are running on a supported platform. ANSYS, Inc. supports 64-bit systems
running Windows 7 and 10.
be installing.
These instructions are divided into four sections:
• Product Download/DVD Instructions: This set of instructions describes the download and extraction process.
Installing ANSYS Products for a Stand-alone Windows System
For this installation, 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. Downloading the Installation Files

agreement.
files.
directories.
9. Begin the product installation as described in Installing ANSYS, Inc. Products (p. 17).
3.1.1. Installing from a USB Drive

To install ANSYS, Inc. products from a USB drive, insert the USB drive into a USB slot on your computer.
Locate and right-click the setup.exe file stored at the root level of the USB and select Run as adminis-
trator. Continue with the steps described in Installing ANSYS, Inc. Products (p. 17).
3.1.2. Installing from a DVD

To install ANSYS, Inc. products from a DVD, place the DVD in your DVD drive. If autorun is enabled, the
installation will begin automatically. If autorun is disabled, locate and right-click the setup.exe file
contained on the DVD and select Run as administrator. Continue with the steps described in Installing
ANSYS, Inc. Products (p. 17).
Installing ANSYS, Inc. Products
The application prompts you to change DVDs during the installation. Make sure you have all installation
DVDs before beginning the installation.
3.2. Installing ANSYS, Inc. Products

This section explains how to install ANSYS, Inc. products.
Note
ANSYS requires users to install all products by using the right-click option Run as ad-
ministrator.
3.2.1. Product Installation with Client Licensing

To install ANSYS, Inc. products with client licensing, follow the steps below.
Note
You must also install the ANSYS, Inc. License Manager on at least one server machine in order
to run ANSYS, Inc. products. See ANSYS License Manager Installation (p. 22) for license
manager installation instructions.
1. Save all data and close all Windows applications before continuing.
2. If you downloaded the installation files or if you are installing from a DVD or USB with autorun disabled,
browse to the location of the setup.exe file. Right-click the setup.exe file and select Run as admin-
istrator.
The ANSYS, Inc. Installation Launcher appears.
From the options on the left side of the launcher you can install ANSYS products, MPI for ANSYS
Parallel Processing, and the ANSYS License Manager. The MPI for ANSYS Parallel Processing install-
ation steps are displayed when you click the Install MPI for ANSYS Parallel Processing link.
3. Select the language you want to use from the drop-down menu in the upper right corner. English is the
default.
The license agreement appears.
Note
5. 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.
directory you choose. The default is C:\Program Files\ANSYS Inc. We recommend using the default
directory.
Note
You must install all ANSYS, Inc. products into the same location. Installing products
into different locations can cause product components to fail. If you choose an install
directory via the Browse feature, the installation will automatically append \ANSYS
Inc\ to the chosen directory. The installation path can have a maximum of 100
characters, except on AUTODYN, which has a maximum of 40 characters.
• Leave the Associate file extensions with ANSYS products check box enabled. This allows you to
double-click files from Windows Explorer to launch the various products.
Click Next.
next step.
Click Next.
If the installation program was unable to query your license server, this message is not displayed
and the default installation options are selected.
If you select AutoCAD, CATIA V5, Inventor, NX, Creo Parametric, Solid Edge, or SOLIDWORKS, you
will have additional installation steps. These steps are completed on the CAD Configuration screen
which is displayed when you click Next. For additional information on completing these steps, see
Specifying CAD Configurations (p. 20).
Note
As of Release 17.0 the MechASAS package is no longer installed with the ANSYS
Mechanical Products. This package is required when using BEAMCHECK and FAT-
JACK assessment types with Design Assessment. If you need the MechASAS
package, download it from the ANSYS customer site.
An estimate of the disk space required to install all of the selected components, and the disk space
you have available is displayed. 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 cor-
rectly. Installation log files are written to the installation directory.
Note
Select/deselect the products you want to install and click Next.
9. A summary of the selected installation data appears. Review the information carefully, and if correct, click
Next to continue the installation.
Note
The installation program will first check your system to determine if you have the necessary pre-
requisites. If the prerequisites are not already on your system, the prerequisites will be installed
automatically.
Note
If prerequisite components necessary for the installation of the ANSYS products were
installed, depending on your existing machine configuration, the following message
may be displayed:
Software prerequisites have been installed.
A system restart may be required after exiting the installation and before using
any ANSYS Products.
If a system restart is required, a restart error message will be written to the install.err
error file. The install.err error file is located in the installation directory.
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.2.1.1. Specifying CAD Configurations

Selecting AutoCAD, CATIA V5, Inventor, NX, Creo Parametric, Solid Edge, or SOLIDWORKS 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. After configuring
your CAD products or deciding to perform the configuration at a later time, click Next.
If you have not yet installed the related CAD programs, or do not know the requested information, you
can choose to skip these configuration steps by selecting the Skip all and configure later using
Product & CAD Configuration Manager option located on the lower left-hand portion of the screen.
If you skip these steps, you will need to manually configure these CAD interfaces using the Product &
CAD Configuration Manager before you can successfully import models into Mechanical APDL, ANSYS
Workbench, or ICEM CFD. You can access the Product & CAD Configuration Manager in Windows 7
(Start > All Programs > ANSYS 2019 R1 > Utilities > Product & CAD Configuration 2019 R1) and
in Windows 10 (Start > ANSYS 2019 R1> Product & CAD Configuration 2019 R1). See Configuring
CAD Products (p. 55) for more information on using the Product & CAD Configuration Manager.
AutoCAD
• If you selected AutoCAD as one of your CAD products, you will have to choose which AutoCAD product
to configure. You can choose the Reader (non-associative), Workbench Associative Interface (requires
that the CAD product be installed), or skip and configure later (using the Product & CAD Configuration
Manager).
CATIA V5
• If you selected CATIA V5 and any product that includes ANSYS Workbench, you will be required to select
the appropriate CAD reader/plugin for ANSYS Workbench. You can choose to configure the Reader,
CADNexus CAPRI CAE Gateway, or skip and configure later (using the Product & CAD Configuration
Manager).
Autodesk Inventor
• If you selected Inventor as one of your CAD products, you will have to choose which Inventor product to
configure. You can choose the Reader (non-associative), Workbench Associative Interface (requires that
the CAD product be installed), or skip and configure later (using the Product & CAD Configuration
Manager).
NX
1. If you selected NX, you will have to choose which NX product to configure. You can choose the Reader
(non-associative), Workbench Associative Interface (requires that the CAD product be installed), or skip
and configure later (using the Product & CAD Configuration Manager).
may need to specify the NX installation path for an existing NX installation. If you are an administrative
user, a file required to load the NX plug-in is placed in the administrative user's Application Data folder
by default, which may not be accessible by other, non-administrative users. To allow non-administrative
users to run, you will need to define the environment variable UGII_CUSTOM_DIRECTORY_FILE prior
to installation and specify a location where other users have read access. Alternatively, you can run the
Creo Parametric
1. If you selected Creo Parametric, you will have to choose which Creo Parametric product to configure. You
can choose the Reader (non-associative), Workbench Associative Interface (requires that the CAD product
2. If you choose the Workbench Associative Interface, you may need to specify the Creo Parametric language,
the Creo Parametric command, and the full Creo Parametric installation path (C:\Program
Files\PTC\Creo 1.0\Parametric by default) for an existing Creo Parametric installation.
SOLIDWORKS
• If you selected SOLIDWORKS as one of your CAD products, you will have to choose which SOLIDWORKS
product to configure. You can choose the Reader (non-associative), Workbench Associative Interface (re-
quires that the CAD product be installed), or skip and configure later (using the Product & CAD Config-
uration Manager).
Solid Edge
• If you selected Solid Edge as one of your CAD products, you will have to choose which Solid Edge product
Manager).

Follow the instructions below to install and configure the ANSYS License Manager on your local Windows
machine. You must be an administrative user to install the ANSYS License Manager on Windows. The
License Manager controls access to the ANSYS, Inc. products you have purchased. You must complete
the License Manager installation to run ANSYS, Inc. products.
1. If the Installation Launcher is not open, right-click the setup.exe file and select Run as administrator.
2. Select Install ANSYS License Manager.
3. The installation launcher appears.
4. You will be notified that the license manager, if running, will be shut down. Click OK.
accept the terms and click Next, located on the right side of the screen. You must select I Agree to con-
tinue with the installation.
6. Specify the installation directory and click Next to continue. You can accept the default or specify an al-
ternate path and the directory name where the license manager is to be installed. The installation directory
is set to <OS_Drive>\Program Files\ANSYS Inc by default. You must have administrative priv-
ileges for the directory you specify. In addition, the directory:
• must be a local directory
• must be a local, fixed-media drive
• cannot be a UNC or relative path
• cannot be a short (8.3) file name format path
• cannot be a symbolic link or junction
• cannot use wide character names/paths
Note
The ANSYS, Inc. License Manager is the only component available and is selected to be installed.
The amount of disk space required and the disk space available appear at the bottom of the window.
Be sure that you have sufficient space before continuing.
7. Click Next to continue.
The ANSYS License Manager is now being installed and configured on your system. After the License
Manager installation has been completed, the Launch License Management Center upon exiting
option is included on the screen. The ANSYS License Management Center is a browser-based
user interface that centralizes many of the ANSYS product licensing administrative functions. If you
do not want to launch the License Management Center, clear the Launch License Management
Center upon exiting option.
10. When the license manager installation is complete, click Exit. A new Start Menu item named ANSYS, Inc.
License Manager will be created automatically. It will include selections for the License Management
Center, the ANSYS, Inc. Licensing Guide, the FlexNet License Administration Guide and the ANSLIC_ADMIN
utility.

Management Center).
cense.
After completing the installation process, refer to Post-Installation Instructions (p. 37)
Chapter 4: Installing ANSYS Products and the License Manager on
Different Windows Machines
This section describes installing ANSYS, Inc. products on one Windows machine and installing the ANSYS,
Inc. License Manager on a different Windows machine that will act as a license server.
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 Installing ANSYS, Inc. Products (p. 27) for more in-
formation.
You can follow these instructions while actually installing the products and setting up the license
server. To do so, simply use the selections that are pertinent to you and insert your specific information
where noted.
Before You Begin

• Open port numbers for FlexNet and ANSYS Licensing Interconnect on your license server machine. Defaults
are 1055 and 2325, respectively. To verify that these port numbers are available, open a command line on
the server machine and enter the following command:
netstat -a -p tcp
dicated later in this tutorial.
• The hostname of the machine that will act as a license server.
You should also verify that you are running on a supported platform. ANSYS, Inc. supports 64-bit systems
running Windows 7 and Windows 10.
be installing.
Installing ANSYS Products and the License Manager on Different Windows Machines
For network installations, the same UNC paths or mapped drive letters must be used on the server and
all client computers. Failure to use matching UNC paths or mapped letter drives can cause server
communication issues or loss of product functionality.
This installation is divided into four sets of instructions:
• Product Download/DVD Instructions: This set of instructions describes the download and extraction process.
For this procedure, the product and the license manager will be installed on separate Windows machines.
You must complete both the client licensing portion and the license manager installation in order to run
ANSYS, Inc. products.
4.1. Downloading the Installation Files

agreement.
files.
directories.
9. Begin the product installation as described in Installing ANSYS, Inc. Products (p. 27)
4.1.1. Installing from a USB Drive

To install ANSYS, Inc. products from a USB drive, insert the USB drive into a USB slot on your computer.
Locate and right-click the setup.exe file stored at the root level of the USB and select Run as adminis-
trator. Continue with the steps described in Installing ANSYS, Inc. Products (p. 27).
4.1.2. Installing from a DVD

To install ANSYS, Inc. products from a DVD, place the DVD in your DVD drive. If autorun is enabled, the
installation will begin automatically. If autorun is disabled, locate and right-click the setup.exe file
contained on the DVD and select Run as administrator. Continue with the steps in Installing ANSYS,
Inc. Products (p. 27).
If you are installing from media, the application prompts you to change DVDs during the installation.
Make sure you have all installation DVDs before beginning the installation.
4.2. Installing ANSYS, Inc. Products

This section explains how to install ANSYS, Inc. products.
Note
ANSYS requires users to install all products by using the right-click option Run as ad-
ministrator.
4.2.1. Product Installation with Client Licensing

To install ANSYS, Inc. products, including client licensing, follow the steps below.
Note
You must also install the ANSYS, Inc. License Manager on at least one server machine in order
to run ANSYS, Inc. products. See ANSYS License Manager Installation (p. 35) for license
manager installation instructions.
1. Save all data and close all Windows applications before continuing.
2. If you downloaded the installation files or if you are installing from a DVD or USB with autorun disabled,
navigate to the location of the setup.exe file. Right-click the setup.exe file and select Run as admin-
istrator.
The ANSYS, Inc. Installation Launcher appears.
From the options on the left side of the launcher you can install ANSYS products, MPI for ANSYS
Parallel Processing, and the ANSYS License Manager. The MPI for ANSYS Parallel Processing install-
ation steps are displayed when you click the Install MPI for ANSYS Parallel Processing link.
3. Select the language you want to use from the drop-down menu in the upper right corner. English is the
default.
The license agreement appears.
Note
5. Read the agreement, and if you agree to the terms and conditions, click I Agree. Click Next, located on
the right side of the screen.
directory you choose. The default is C:\Program Files\ANSYS Inc. We recommend using the default
directory.
Note
You must install all ANSYS, Inc. products into the same location. Installing products into
different locations can cause product components to fail. If you choose an install directory
via the Browse feature, the installation will automatically append \ANSYS Inc\ to the
chosen directory. The installation path can have a maximum of 100 characters, except
on AUTODYN, which has a maximum of 40 characters. For a network installation, the
same UNC paths or mapped drive letters must be used on the server and all client
computers.
• Leave the Associate file extensions with ANSYS products check box enabled. This allows you to
double-click files from Windows Explorer to launch the various products.
• If you specify a network location as the installation directory, you should select the Add .NET security
exceptions on the above install directory option. This option allows the .NET binaries that are located
under the \ANSYS Inc directory on the shared machine to be run from the network.
To understand the implications of this security exception for .NET, contact your system adminis-
trator or see Configuring Security Policy on Microsoft’s website.
• Used with network installations, this option allows the .NET binaries that are located under the \ANSYS
Inc directory on the shared machine to be run from the network.
Click Next.
next step.
Click Next.
If the installation program was unable to query your license server, this message is not displayed
and the default installation options are selected.
If you select AutoCAD, CATIA V5, Inventor, NX, Creo Parametric, Solid Edge, or SOLIDWORKS, you
will have additional installation steps. These steps are completed on the CAD Configuration screen
which is displayed when you click Next. For additional information on completing these steps, see
Specifying CAD Configurations (p. 33).
Note
Mechanical Products. This package is required when using BEAMCHECK and FAT-
JACK assessment types with Design Assessment. If you need the MechASAS
package, download it from the ANSYS customer site.
An estimate of the disk space required to install all of the selected components, and the disk space
you have available is displayed. 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 cor-
rectly. Installation log files are written to the installation directory.
Note
Select/deselect the products you want to install and click Next.
Note
The installation program will first check your system to determine if you have the necessary pre-
requisites. If the prerequisites are not already on your system, the prerequisites will be installed
automatically.
Note
If prerequisite components necessary for the installation of the ANSYS products were
installed, depending on your existing machine configuration, the following message
may be displayed:
Software prerequisites have been installed.
A system restart is may be required after exiting the installation and before using
any ANSYS Products.
If a system restart is required, a restart error message will be written to the install.err
error file. The install.err error file is located in the installation directory.
4.2.1.1. Network Server and Product Configuration

To complete a network installation (where the product is installed on one machine and multiple clients
access that installation to run the product) to a file server machine, follow the steps below. A network
installation must be homogeneous, although you can install on different operating systems.
1. Install the product(s) to be shared in a location that all clients can access. Install all platforms that this
machine will host as described in Product Installation with Client Licensing (p. 27).
You must share the entire \ANSYS Inc directory, not just the \v193 directory. If mapping a
drive to the shared location, it must be mapped to the \ANSYS Inc folder.
2. Open the Product & CAD Configuration Manager (\\fileservermachine\ANSYS

Inc\v193\ProductConfig.exe). Select Install Required Prerequisites. You must be logged in as
an administrative user to install the prerequisites. This step must be completed on all client Windows
systems.
3. A configuration status screen appears. This screen displays the required prerequisite installation process.
Once the process is complete, click Exit. The Product & CAD Configuration Manager remains open.
4. On each Windows client, update the .NET security settings. By default, the .NET Framework prevents ap-
plications from being run over a network. In order to install over a network, each Windows client that
accesses the shared directory requires a modification to its security settings. This modification allows the
.NET binaries that are located under the \ANSYS Inc directory on the shared machine to be run from
the network. To make this modification from the Product & CAD Configuration Manager, select Add .NET
security exception for ANSYS, Inc. products. You must have administrative privileges to modify the
security policy.
To understand the implications of this security exception for .NET, contact your system administrator
or see Configuring Security Policy on Microsoft’s website.
Alternatively, you can allow network execution manually rather than using the Add .NET security
exception for ANSYS, Inc. products option of the Product & CAD Configuration Manager. The
Add .NET security exception for ANSYS, Inc. products option runs the Caspol utility, which is
located under the .NET Framework installation, in C:\Windows\Microsoft.NET\Frame-
work64\v2.0.50727 for a 64-bit machine. You can run this utility manually in a command
prompt window to open full trust to files on the shared drive.
On a 64-bit machine, run the following command:

<os drive>\Windows\Microsoft.NET\Framework64\v2.0.50727\Caspol.exe -m -ag
<CodeGroup> -url file://x:/* FullTrust
where x is the mapped drive or UNC path where the product is installed, and CodeGroup is the
appropriate Caspol permissions level. We recommend a CodeGroup setting of 1.2. If that setting
does not work or is not appropriate for your environment, see the Caspol documentation available
from Microsoft or contact your system administrator.
You must install Caspol as an administrative user. If running this from the command line on Windows
7 or Windows 10, you must start the command prompt as Administrator, or the command will fail.
5. If you are sharing the Mechanical APDL product, edit the tlbrlist193.ans file, located in
\v193\ansys\gui\en-us\toolbars on the Windows file server. The file should read as follows:
\\fileservermachine\ANSYS Inc\v193\ansys\gui\en-us\toolbars\ANSYSSTANDARD.TLB
\\fileservermachine\ANSYS Inc\v193\ansys\gui\en-us\toolbars\ANSYSABBR.TLB
\\fileservermachine\ANSYS Inc\v193\ansys\gui\en-us\toolbars\ANSYSGRAPHICAL.TLB
6. For all types of network installations, from each client Windows machine, you will need to run Product-
Config.exe. If the Product & CAD Configuration Manager has been closed, reopen it as described above.
7. Select Configure Products & CAD.
8. Select the products and CAD options you want to configure. Click Configure.
Note
CFD-Post is automatically configured when CFX, Fluent, Polyflow, or Icepak is configured,

or if CFD-Post is selected.
9. An informational message box appears as each product is configured.
All operations and error messages that are encountered while using the product and CAD config-
uration (or unconfiguration) option are written to the productConfig.txt file in the %TEMP%
directory of the client machine. No log files are written to the machine that is hosting Product-
Config.exe.
Note
ProductConfig.exe can also be run in batch mode using the ‘-silent' flag, which may
be useful for automating configuration for multiple systems or across a Microsoft
Windows HPC cluster. For more information see Silent Mode Operations (p. 47).
10. If you selected any CAD options, your will need to complete additional configuration steps. These steps
are completed on the CAD Configuration screen which is displayed when you click Next. For additional
information on completing these steps, see Specifying CAD Configurations (p. 33).
11. When the configuration is completed, you will see shortcuts to each product in Windows 7 under Start
> All Programs > ANSYS 2019 R1 and in Windows 10 under Start > ANSYS 2019 R1.
Unconfigure To unconfigure products or CAD options that have previously been shared, use the
following procedure:
1. From each client machine, in Windows 7, select Start > All Programs > ANSYS 2019 R1 > Utilities>
Product & CAD Configuration 2019 R1 and in Windows 10 (Start > ANSYS 2019 R1> Product & CAD
Configuration 2019 R1).
2. Select Unconfigure Products & CAD.
3. Select the products and CAD options you want to unconfigure and click Next. When unconfiguring
products, be aware that WB/Common should be unconfigured last, after all other products are uncon-
figured. If you are unconfiguring some but not all products, do NOT unconfigure WB/Common, or your
remaining products will not run correctly.
CFD-Post CFD-Post can be configured as a standalone product; however, as a standalone product,

it is also automatically configured with Fluent, Polyflow, and Icepak. To unconfigure CFD-Post, you
must select all of these products to unconfigure, regardless if they are configured locally.
• If you choose to unconfigure standalone CFD-Post without unconfiguring the other products, you will
not be able to proceed with the unconfigure. You will need to revise your selections before continuing.
• If you choose to unconfigure all of the other products that include CFD-Post but you do not select CFD-
Post, then CFD-Post will not be unconfigured.
4. The user interface billboard displays the status of each product as it is unconfigured. The shortcuts to
each product are now removed.
4.2.1.2. Specifying CAD Configurations

Selecting AutoCAD, CATIA V5, Inventor, NX, Creo Parametric, Solid Edge, or SOLIDWORKS 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. After configuring
your CAD products or deciding to perform the configuration at a later time, click Next.
If you have not yet installed the related CAD programs, or do not know the requested information, you
can choose to skip these configuration steps by selecting the Skip all and configure later using
Product & CAD Configuration Manager option located on the lower left-had portion of the screen. If
you skip these steps, you will need to manually configure these CAD interfaces using the Product &
CAD Configuration Manager before you can successfully import models into Mechanical APDL, ANSYS
Workbench, or ICEM CFD. You can access the Product & CAD Configuration Manager in Windows 7
(Start > All Programs > ANSYS 2019 R1 > Utilities > Product & CAD Configuration 2019 R1) and
in Windows 10 (Start > ANSYS 2019 R1> Product & CAD Configuration 2019 R1). See Configuring
CAD Products (p. 55) for more information on using the Product & CAD Configuration Manager.
AutoCAD
• If you selected AutoCAD as one of your CAD products, you will have to choose which AutoCAD product
Manager).
CATIA V5
• If you selected CATIA V5 and any product that includes ANSYS Workbench, you will be required to select
the appropriate CAD reader/plugin for ANSYS Workbench. You can choose to configure the Reader,
CADNexus CAPRI CAE Gateway, or skip and configure later (using the Product & CAD Configuration
Manager).
Autodesk Inventor
• If you selected Inventor as one of your CAD products, you will have to choose which Inventor product to
configure. You can choose the Reader (non-associative), Workbench Associative Interface (requires that
the CAD product be installed), or skip and configure later (using the Product & CAD Configuration
Manager).
NX
1. If you selected NX, you will have to choose which NX product to configure. You can choose the Reader
(non-associative), Workbench Associative Interface (requires that the CAD product be installed), or skip
and configure later (using the Product & CAD Configuration Manager).
may need to specify the NX installation path for an existing NX installation. If you are an administrative
user, a file required to load the NX plug-in is placed in the administrative user's Application Data folder
by default, which may not be accessible by other, non-administrative users. To allow non-administrative
users to run, you will need to define the environment variable UGII_CUSTOM_DIRECTORY_FILE prior
to installation and specify a location where other users have read access. Alternatively, you can run the
Creo Parametric
1. If you selected Creo Parametric, you will have to choose which Creo Parametric product to configure. You
can choose the Reader (non-associative), Workbench Associative Interface (requires that the CAD product
2. If you choose the Workbench Associative Interface, you may need to specify the Creo Parametric language,
the Creo Parametric command, and the full Creo Parametric installation path (C:\Program
SOLIDWORKS
product to configure. You can choose the Reader (non-associative), Workbench Associative Interface (re-
quires that the CAD product be installed), or skip and configure later (using the Product & CAD Config-
uration Manager).
Solid Edge
• If you selected Solid Edge as one of your CAD products, you will have to choose which Solid Edge product
Manager).

Because you will be using a network server, you must install and configure the ANSYS, Inc. License
Manager on the 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. On the server machine, navigate to the directory where the installation packages reside. Right-click the
setup.exe file and select Run as administrator. The ANSYS, Inc. Installation Launcher appears. Click
Install ANSYS License Manager.
2. You will see a warning stating that if the license manager is currently running, it will be shut down. You
may safely ignore this message and click OK.
3. The license agreement appears. Read the agreement, and if you agree to the terms and conditions, click
4. The directory where the license manager will be installed is shown in the Install Directory field. Accept
the default directory and click Next.
Note
After the License Manager installation has been completed, the Launch License Management
Center upon exiting option is included on the screen. The ANSYS License Management Center
is a browser-based user interface that centralizes many of the ANSYS product licensing administrative
functions. If you do not want to launch the License Management Center, clear the Launch License
8. Click Exit to close the ANSYS, Inc. Installation Launcher.
9. From the machine on which the products were installed, choose Start> Programs> ANSYS 2019 R1>
<product> to launch the ANSYS, Inc. products that you have installed.

Management Center).
cense.
After completing the installation process, refer to Post-Installation Instructions (p. 37)
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.3. Running the ANS_ADMIN Utility for Mechanical APDL /ANSYS Workbench 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.
It may also be necessary to establish some system settings, including path names and environment
variables. See your operating system documentation for specific instructions on setting paths and en-
vironment variables.
1. Set the following environment variables based on the behavior you want.
• The ANSYSLIC_DIR environment variable sets the location of the ANSYS licensing directory hierarchy.
The default value is c:\Program Files\ANSYS Inc\Shared Files\Licensing. You probably
will not need to reset this variable, unless you change the location of the licensing files.
To set environment variables:
Windows 7: Right-click Computer and choose Properties. Click Advanced System Settings, and
click Environment Variables. Click New. Type the name in the Variable Name field and the desired
setting in the Variable Value field. Click OK on all dialog boxes.
Windows 10: Right-click Start and choose Control Panel. Click Advanced System Settings>Sys-
tem>Advanced System Settings>Environment Variables. Click New. Type the name in the
Variable Name field and the desired setting in the Variable Value field. Click OK on all dialog boxes.
If you have any command prompts or console windows open when you set or reset environment
variables, those windows need to be closed and restarted in order to pick up the new settings.
2. Set the home directory. To set a home directory in Windows, you need to set a HOMEDRIVE environment
variable to the desired drive letter (including the colon) and a HOMEPATH environment variable to the
desired path. For example:
HOMEDRIVE=C:
HOMEPATH=\Users\Mine
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.
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.
6. Verify the product installation by selecting each product from the Start menu to verify that they each
start and run correctly. You must be pointing to a valid license server machine before you can verify the
installation.
7. If you chose not to set file associations during the installation, you may want to run the File Association
utility now to configure the ANSYS file types. Administrative privileges are required to run this utility
For Windows 7, select Start> All Programs> ANSYS 2019 R1> Utilities> File Association 2019
R1 and for Windows 10, right-click the Start Screen> All apps> ANSYS 2019 R1> File Association
2019 R1.
For network installations, run the File Association utility on each client computer.
You can also run the File Association utility in silent mode:
<install_dir>\v193\commonfiles\tools\<platform>\fileassoc.exe -silent
You can see help on the fileassoc.exe by issuing -help. File associations are as follows:
ANSYS, Inc. Product File Extension

Mechanical APDL .db, .dbb, .grph
ANSYS CFD-Post .mres, .res
ANSYS CFX .cfx, .cvf, .def, .mdef
ANSYS Composite PrepPost .acph5
ANSYS Fluent .cas
ANSYS ICEM CFD .prj, .tin, .uns
ANSYS Space Claim Direct .scdoc, .scjournal
Modeler
ANSYS Workbench .ad, .agdb, .aqdb, .bgd, .cmdb, .dsdb, .engd, .fedb,
.mechdat, .meshdat, .pmdb, .wbdb, .wbpj, .wbpz
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 noted above for all products.
• Set the following environment variables based on the behavior you want. Set the environment variables
following the conventions of your operating system. 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 ANSYS193_DIR environment variable sets the location of the ANSYS directory hierarchy. The default
value is c:\Program Files\ANSYS Inc\V193\ANSYS. You probably will not need to reset this
variable, unless you change the location of the installed files.
• ANSYS193_PRODUCT - set this to the correct product variable to run Mechanical APDL to start with
the correct Mechanical APDL product without specifying the -p command modifier each time.
• ANS_CONSEC - set this to YES to disable Mechanical APDL dialog boxes and allow multiple jobs to run
consecutively without waiting for user input. Settings for ANS_CONSEC are:
Value of Batch Dialog GPF Dialog Box on

ANS_CONSEC Box Error
Not defined/default No Yes
YES No No
NO Yes Yes
• 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.
• ANSYS193_MAT161 - set this environment variable to 1 to enable use of the LS-DYNA *MAT_COMPOS-
ITE_MSC material (requires an LS-DYNA MAT_161 license).
• ANSYS193_MAT162 - set this environment variable to 1 to enable use of the LS-DYNA *MAT_COMPOS-
ITE_DMG_MSG material (requires an LS-DYNA MAT_162 license).
• LSTC_LICENSE - This is an LS-DYNA environment variable that controls which license manager is used
by the LS-DYNA executable. It is set to ANSYS during installation; changing this environment variable
will prevent ANSYS LS-DYNA from using your ANSYS licenses when running the executable.
Note
Mechanical Products. This package is required when using BEAMCHECK and FATJACK
assessment types with Design Assessment. If you need the MechASAS package, please
download it from the ANSYS customer site.
5.1.1. Post-Installation Procedures for ANSYS Fluent

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. From the Control Panel, select System and
click the Advanced tab. Click Environment Variables. Find and delete the FLUENT_INC variable.
2. In Windows 7, select Start> All Programs> ANSYS 2019 R1> Fluid Dynamics> Fluent 2019 R1. In
Windows 10, Start > All apps> ANSYS 2019 R1> FLUENT 2019 R1.
3. Click Default.
4. Click Yes when asked if you want to discard the LAUNCHER history.
5. Click Cancel if you do not want to start Fluent at this time. The new defaults will have been saved.
Please refer to the ANSYS Fluent Quick Start Guide for more information.
5.1.1.1. Installing Intel-MPI 2018.3.210

When run on a single computer, FLUENT can use the Intel-MPI software from within the ANSYS product
installation directories. However, if you need to use multiple computers to run FLUENT simulations,
then you will need to perform a separate, official install of the Intel-MPI 2018.3.210 software on each
of the computers.
Note
The version of Intel-MPI included as part of the ANSYS product installation is 2017.3.210.
This installation procedure should be used to install the more recent Intel-MPI 2018.3.210
for use specifically with ANSYS Fluent in a multiple computer configuration. Be aware
that ANSYS Workbench, Mechanical APDL and Autodyn require the older Intel-MPI
2017.3.210 version.
To install the Intel-MPI for use with ANSYS Parallel Processing:

1. Browse to the following directory:
<Installation Directory>\ANSYS Inc\v193\prereq
2. Right click the w_mpi_p_2018.3.210.exe file and click Run as administrator.
A dialog box displaying the default extraction location for the Intel MPI Library Runtime Environ-
ment installation software is displayed.
3. Verify that the extraction location is correct and then click Extract.
The Intel MPI Library Runtime Environment Update for Windows OS Installer installation program
is displayed.
4. Click Next.
5. Read the Software License Agreement carefully. If you agree with the license agreement, click I accept
the terms of the license and then click Next.
6. Verify the software installation destination and the components to be installed and click Next.
7. When the installation is complete, click Finish.
Switching between two versions of Intel-MPI:

Intel MPI 2018.3.210 is not compatible with earlier releases of ANSYS products. If you wish to run an
older ANSYS product in parallel using the previously installed Intel-MPI 2017.3.210 version on the same
machines, use the following solution to "toggle" between Intel-MPI versions:
To switch from Intel-MPI 2017.3.210 to Intel-MPI 2018.3.210, run following command on all nodes, using
command prompt with admin privileges:
“C:\Program Files (x86)\IntelSWTools\compilers_and_libraries_2018.3.210\win-

dows\mpi\intel64\bin\hydra_service.exe” -install
To switch from Intel-MPI 2018.3.210 to Intel-MPI 2017.3.210, run following command on all nodes, using
command prompt with admin privileges:
“C:\Program Files (x86)\IntelSWTools\compilers_and_libraries_2017.4.210\win-

dows\mpi\intel64\bin\hydra_service.exe” -install
Note
After installing both versions of Intel MPI, the I_MPI_ROOT environment variable should be
deleted from all nodes.
5.1.2. 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:
• From the Control Panel, select System and click the Advanced tab. Click Environment Variables. Find and
delete the FLUENT_INC variable.
5.1.3. Post-Installation Procedures for ICEM CFD

If you are running ICEM CFD over the network, you may not be able to access ICEM CFD Help using
the Help menu. To access ICEM CFD Help, navigate to commonfiles\help\en-us in the installation
directory on the server machine and copy the file icemcfd_help.chm to your local machine. Double-
click the local copy to view the help.
5.1.4. Post-Installation Procedures for ANSYS FENSAP-ICE

Software Launch
After installing ANSYS FENSAP-ICE, the software will be accessible through Start > All Programs >
ANSYS 2019 R1 > Fluid Dynamics > FENSAP-ICE 2019 R1.
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/v193/fensapice/workbench/FENSAPICE-WB R19.3.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.
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 R2019 R1 package is installed.
NTI Licensing
Legacy license keys from prior to ANSYS R2019 R1 use the NTI FLEXLm license system. The option for
NTI licensing must then be enabled in the licensing.txt file <install_dir>/ansys_inc/v193/fensapice/con-
fig/licensing.txt or by setting up the NTI_LICENSE_FILE environment variable.
Modify the licensing.txt file to contain the license server information NTI_LICENSE_FILE=port@server.
The default port is 27000.
For instructions on how to set-up the NTI license server or on how to force a specific licensing system,
refer to the FENSAP-ICE Installation and Licensing Guide.
5.1.5. Post-Installation Procedures for Other Products

BladeGen If you are running BladeGen on Windows 7, in order to access the BladeGen online help,
you need to install WinHlp32.exe, which is available from Microsoft.
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.
FEMGV For ANSYS Aqwa customers, FEMGV is also available as a separate, standalone installation,
available via media or the ANSYS customer site Download Center.

To launch ANSYS, Inc. products on Windows 7 platforms, choose the product from the ANSYS 2019 R1
program group under the Start menu (Start> All Programs> ANSYS 2019 R1) and on Windows 10,
under All apps.
For Mechanical APDL, you can also use the launcher:
Windows 7: Start> All Programs> ANSYS 2019 R1> Mechanical APDL Product Launcher 2019 R1.
Windows 10: Start> All apps> ANSYS 2019 R1> Mechanical APDL Product Launcher 2019 R1.
Product Localization
5.3. Running the ANS_ADMIN Utility for Mechanical APDL /ANSYS

Workbench Products
You may need to run the ANS_ADMIN utility to relink Mechanical APDL if you use the customization
tools. For more information on individual options available with this utility, see the online help accessible
from Help buttons on the utility dialog boxes. You can launch ANS_ADMIN without administrative
privileges, but some of the options require administrative privileges. If certain options are grayed out,
you do not have the necessary system administrator privileges necessary for that option, or the corres-
ponding product may not be installed.
To run the ANS_ADMIN utility from Windows 7, choose Start> All Programs> ANSYS 2019 R1> Util-
ities> ANS_ADMIN 2019 R1. To run the ANS_ADMIN utility from Windows 10, right-click the All apps>
ANSYS 2019 R1> ANS_ADMIN 2019 R1.

Many ANSYS, Inc. products are available in multiple languages, including English, German, French, and
Japanese. For those products that are localized, you are able to view the GUI and messages in the
specified language. 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)
ja (Japanese)
ANSYS, Inc. applications will look for the languagesettings.txt file in the following locations, in
order:
1. %appdata%\ANSYS\v193
2. <install_dir>\ANSYS Inc\v193\commonfiles\Language
ANSYS, Inc. licensing also looks for the languagesettings.txt in the licensing languages subdir-
ectories in order to display the server 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.4.1. Translated Message File Installation for Mechanical APDL /ANSYS

Workbench Products
If your ANSYS, Inc. sales representative has supplied you with message files translated into your local
language, use the following procedure to install and access these files from within Mechanical APDL:
1. Create an appropriately named subdirectory to hold the message files. For example, if your local language
is French, create a directory in the following location:
<os drive>\Program Files\ANSYS Inc\V193\ANSYS\docu\fr
2. Copy the message files (msgcat.193, msgidx.193, and msgfnm.193) into the newly created subdir-
ectory.
3. Access these message files by using the -l command line option. For example:
ansys193 -l fr
Or, when you are running Mechanical APDL from the Mechanical APDL launcher, choose the Lan-
guage Selection option and then pick the desired language.
You must create a newly translated message file for each release of Mechanical APDL because error
messages may occur in a different order for each release.
Chapter 6: Installing MPI for ANSYS Parallel Processing
The following installation procedures describe the process for installing Intel and IBM Platform MPI for
use with ANSYS Parallel Processing.
6.1. Intel-MPI 2017.3.210 Installation Instructions

The MAPDL product comes with three (3) types of MPI (message-passing interface) software. When run
on a single computer, MAPDL can use the software from within the MAPDL installation folders. However,
if you need to use multiple computers to run an MAPDL simulation, then you will need to perform a
separate, official install of the selected MPI software on each of the computers.
To install the Intel-MPI for use with ANSYS Parallel Processing:
1. From the ANSYS Installation Launcher, click Install MPI for ANSYS Parallel Processing.
2. Click Install Intel MPI.
A dialog box displaying the default extraction location for the Intel MPI Library Runtime En-
vironment installation software is displayed.
3. Verify that the extraction location is correct and then click Extract.
The Intel MPI Library Runtime Environment Update for Windows OS Installer installation
program is displayed.
4. Click Next.
the terms of the license and then click Next.
6. Verify the software installation destination and the components to be installed and click Next.
7. When the installation is complete, click Finish.
To cache your Windows password, open a Command Prompt window and run:
"%AWP_ROOT193%\commonfiles\MPI\Intel\2017.3.210\Windows\setimpipass-
word.bat"
Note
To run earlier versions of ANSYS Products, set the Intel-MPI environment variable
"I_MPI_SMPD_VERSION_CHECK=disable".
Installing MPI for ANSYS Parallel Processing
6.2. IBM MPI 9.1.4.3 Installation Instructions

The MAPDL product comes with three (3) types of MPI (message-passing interface) software. When run
on a single computer, MAPDL can use the software from within the MAPDL installation folders. However,
if you need to use multiple computers to run an MAPDL simulation, then you will need to perform a
separate, official install of the selected MPI software on each of the computers.
To install the IBM Platform MPI for use with ANSYS Parallel Processing:
1. From the ANSYS Installation Launcher, click Install MPI for ANSYS Parallel Processing.
2. Click Install Platform MPI.
You are informed that the installation files are being extracted to a default location.
The IBM MPI installation program is displayed.
3. Click Next.
the terms of the license agreement. and then click Next.
5. Select the installation type you wish to perform and then click Next.
6. Specify the port that the Platform-MPI Service will use and then click Next.
7. Select the default installation directory for the installation and then click Next.
8. Specify where you would like the product icons to be installed and then click Next.
9. Verify the software installation selections and then click Install.
10. When the installation is complete, click Done.
To cache your Windows password, open a Command Prompt window and run:
"%AWP_ROOT193%\commonfiles\MPI\IBM\9.1.4.3\Windows\setpcmpipassword.bat"
Chapter 7: Silent Mode Operations
ANSYS, Inc. supports silent mode operations, including installation, configuring/unconfiguring, and
uninstalling.
Note
ANSYS, Inc. requires that you have full administrative privileges when installing any software
on Microsoft Windows 7 or Windows 10. Non-administrative accounts do not usually have
the permissions required to access system areas that installation programs often need to
modify. “Full administrative privileges” means that you are running as administrator with
UAC turned off, or you are running as administrator with UAC turned on and Run as Admin-
istrator selected.
Windows 7 and Windows 10 use a feature called User Account Control (UAC) to control
privileges and automatically reduce the potential of security breaches in the operation system.
However, UAC limits your accessibility to system areas and can cause unpredictable behavior
in ANSYS, Inc. products, as noted below.
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. Not all products are available on all platforms.
For silent mode operations, if you do not specify any product arguments, all available products will be
installed, configured, or uninstalled.
Product Flags
ANSYS Customization Files -ansyscust
ANSYS Autodyn -autodyn
ANSYS LS-DYNA -lsdyna
ANSYS CFX -cfx
ANSYS EnSight -ensight
ANSYS Aqwa -aqwa
ANSYS Discovery AIM -aim
ANSYS Discovery Live -live
ANSYS Discovery SpaceClaim -spaceclaim
ANSYS Forte -forte
ANSYS Chemkin -chemkinpro
ANSYS Energico -energico
ANSYS Reaction Workbench -reactionwb
ANSYS Model Fuel Library (Encrypted) -mfl
Note: Installing any of the above products will install ANSYS Workbench.

ANSYS Viewer -aview
Remote Solve Manager Standalone Services -rsm
CATIA 4.x -catia4
CATIA V6 -catia6
Parasolid -parasolid
ACIS -acis
Creo Elements/Direct Modeling -cocreate
JTOpen -jtopen
SOLIDWORKS Reader -solidworks_reader
SOLIDWORKS Plugin -solidworks_plugin
CATIA 5 Reader -catia5_reader
CATIA 5 Plugin -catia5_plugin
Autodesk Inventor Reader -adinventor_reader
Autodesk Inventor Plugin -adinventor_plugin
Creo Parametric Reader -proe_reader
Creo Parametric Plugin -proe_plugin
NX Reader -ug_reader
NX Plugin -ug_plugin
AutoCAD Reader -acad_reader
AutoCAD Plugin -acad_plugin
Solid Edge Reader -solidedge_reader
Solid Edge Plugin -solidedge_plugin
SpaceClaim Direct Modeler Configuration* -scdm_config
ANSYS SpaceClaim Configuration* -sc_config
* The SpaceClaim Direct Modeler Configuration and ANSYS SpaceClaim Configuration product flags
perform product configuration only and and DO NOT perform any product installation functions.
SpaceClaim Direct Modeler is installed as part of WorkBench while ANSYS SpaceClaim is a stand-alone
application. While SpaceClaim Direct Modeler and ANSYS SpaceClaim can be installed on the same
computer, only one of the applications can be configured with ANSYS Workbench at any given time.
For more information on which products are included with each installation, see Applications Included
with Each Product (p. 75).
7.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, from the Start>Run menu is:
setup.exe -silent -product_flag
Note
In Windows 10 it is necessary to run silent commands from an administrator prompt.

To access a Run as Administrator command prompt, click Start Screen> All apps> right-
click the Command Prompt Icon> select Run as Administrator.
The above form will install the products specified (see the list of product_flags above). Additional
command line arguments are available; see the list below.
For example, to install TurboGrid and Icepak to the default installation directory, issue the following
command:
setup.exe -silent -install_dir “C:\Program Files\ANSYS Inc” -turbogrid -icepak
Note
If you do not specify a product flag, all products will be installed.
To install the ANSYS License Manager on Windows systems that will act as license servers, you must
run setup.exe with the -LM option:
setup.exe -silent -LM
The silent license manager installation is valid only for the default Licensing Configuration option "Run
the ANSYS Licensing Interconnect with FLEXlm." See Silent License Manager Installation Instructions of
the ANSYS Licensing Guide for more information.
If you are installing the license manager to a non-default installation directory, you can use the silent
installation method, but only for the initial installation. To change the license manager installation dir-
ectory for future installations, you will need to uninstall the license manager before reinstalling to a
different directory.
You can use the following arguments when running a silent installation:

-install_dir Specifies the directory to which the product is to be installed. For the installation
"path" directory, you must enclose the path in quotes if you have spaces in the pathname.
If you want the product to install to the default location, you can omit the -in-
stall_dir argument. The default location is <os drive>:\Program
Files\ANSYS Inc\.
-product_flag Specifies one or more products to install. If you omit the -product_flag
argument, all products will be installed. See the list of valid product_flags
above.
-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) for more details.
-caspol Allows the .NET binaries that are located under the \ANSYS Inc directory on
the shared machine to be run from the network. You must have administrative
privileges to modify the security policy. Use this option when you specify a network
location as the installation directory. To understand the implications of this security
exception for .NET, contact your system administrator or see Configuring Security
Policy on Microsoft’s website.
-help Displays a list of valid arguments for a silent installation.
-licfilepath Specifies the location of the license file to install. If the path is not specified or if
"path" the path is the same as the existing license file, the license file will not be installed.
Valid only when doing a silent license manager installation (setup.exe -LM).
-setliclang Specifies a language to use for the server ANSLIC_ADMIN utility and the ANSYS,
language Inc. Licensing Interconnect log file. Use the language directory name in the
language subdirectory of the licensing directory (en-us, fr, de, etc.) as the
language value. This flag can be used during a GUI installation as well. Valid
only when doing a license manager installation (setup.exe -LM).
-licserverinfo Specifies information to be used by the client for the license server. Valid only in
conjunction with a silent installation (setup.exe). 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. In a three-server environment, you also
need to enclose the values in quotes (Windows only).
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.
Caution
To avoid the possibility of installation failure, we strongly recommend that you place
quotation marks around all paths contained in command line arguments.
Example:
-install_dir “C:\Program Files\ANSYS Inc”
-productfile “C:\temp\optionsfile”
The silent installation process will automatically close certain applications, possibly resulting in lost data.
You should always close all programs before starting a silent install. A silent install will first install any
necessary prerequisites that are not already on your system and then continue with the installation.
You must have administrative privileges to install prerequisites; if not, the silent install will exit and
write a message to the log file.
Microsoft .NET Framework 4.6.2 is now required for running ANSYS products. If your installation com-
puter(s) does not have .NET 4.6.2 installed, the installation program will install .NET 4.6.2 as a prerequisite
and may require a system restart after exiting the installation and before running any ANSYS products.
If this is the case, a restart message can be found in the install.err error file.
Installation log files are located in the installation directory: install.log contains installation messages,
and install_licconfig.log contains licensing installation messages. In rare circumstances with
a silent licensing installation, the licensing installation messages may not be written to the install_lic-
config.log (for example, if the silent licensing installation aborts); in these cases, you may find error
messages in the .ansys_install_temp_licconfig_<user>_<index>.log file, located in
%TEMP%.
For more information on the silent license manager installation, see Silent License Manager Installation
Instructions of 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 specify which products you want to install. The options file can contain all possible
products, with the products you do not want to install commented out, or it can contain only the
products you want to install. An example options file is shown below. In the example, Creo Parametric
and NX are commented out using the acceptable comment indicators. When using the options file, do
not include the dash (-) before the product name.
mechapdl
ansyscust
autodyn
cfdpost
cfx
turbogrid
fluent
polyflow
icepak
::proe
REM ug
To run with NX and Creo Parametric:
• NX: Verify that your UGII environment variables are set, and the configuration will pick them up automatically.
• Creo Parametric: Verify that the following environment variables are set:
PROE_START_CMD193=C:\Program Files\PTC\Creo 1.0\Parametric\bin\para-

metric1.bat (or your Creo Parametric start command)
PROELOADPOINT= C:\Program Files\<Creo_dir>
Silent Prerequisites Installation

The ANSYS, Inc. product installation requires several prerequisites. These prerequisites often require
administrative permissions to install. If you want to install as a non-administrative user but require
prerequisites, you can install the prerequisites separately by running ProductConfig.exe from the
top level directory as an administrator. You can also install the prerequisites silently using the following
command:
ProductConfig.exe -silent
Note
On an HPC cluster environment, prerequisites must be installed on each cluster execution

node.
7.1.1. Silent Product Configuration/Unconfiguration

You can also run the ProductConfig.exe via command line (i.e., silent mode) to configure or un-
configure products.
From each client machine, run the ProductConfig.exe -silent with the following options spe-
cified on separate lines (see the example below): -config, -unconfig, -prereqs, -caspol, and
-product_flag. These options are described below.
• -config/-unconfig -- Use with the -silent option to indicate that products should be configured/un-
configured.
• -prereqs -- Required to install the necessary prerequisites on your system. Prerequisites must be installed
once on each machine.
• -caspol -- Required to modify the necessary .NET security settings to allow the product to run across the
network. This option must be run once on each machine.
• -product_flag -- Use to specify which products should be configured; see the above list of
product_flags (p. 49). If you do not specify one or more products, all products that have been in-
stalled will be configured.
• Use the -help option for a list of commands available for use with ProductConfig.exe.
An example command for silent configuration is:

"\\machineabc\Program Files\ANSYS Inc\v193\ProductConfig.exe" -silent -prereqs
"\\machineabc\Program Files\ANSYS Inc\v193\ProductConfig.exe" -silent -caspol
"\\machineabc\Program Files\ANSYS Inc\v193\ProductConfig.exe" -silent -config -<product_flag>
Note
When performing -config on one or more products, the -prereqs and -caspol options must
be run prior to running the -config option as shown in the example above.
All operations and error messages that are encountered while using the silent product configuration/un-
configuration option are written to the productConfig.txt file in the %TEMP% directory of the client
machine. No log files are written to the machine that is hosting ProductConfig.exe.
7.1.2. 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 193-<number>.dvd
files of each DVD are located in the same directory. You can then proceed with the silent installation as de-
scribed earlier.
• Place all of the media in separate drives (any combination of virtual ISO mounts or hardware drives) so that
they can be accessed simultaneously during the installation. Then run the silent installation as described
earlier, but include the additional -media_dir2 <path> option for each drive:
setup.exe -silent -product_flag -media_dir2 <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 option shown in the
example above.
7.1.3. Silent Uninstall

To run a silent uninstall, run the following from some location other than the \v193 directory:
C:\> <installation path>\v193\Uninstall.exe -silent
The silent uninstall will unconfigure and remove all products and remove the entire \v193 directory,
including any user files or subdirectories that you have added to the \v193 directory.
Because of the way ANSYS, Inc. products are packaged, not all of the product_flags shown above
are valid. To uninstall individual products, use the following product options in conjunction with the
-silent argument:

ANSYS Aqwa -aqwa
ANSYS CFX -cfx

Remote Solve Manager Standalone -rsm
Services
For example, to uninstall only TurboGrid and Icepak, issue the following command:
C:\> <installation path>\v193\Uninstall.exe -silent -turbogrid -icepak
You can also issue the -help option to see a list of valid arguments for a silent uninstall.
Uninstalling CFD-Post CFD-Post can be installed as a standalone product. As a standalone product,

it is also automatically installed with Fluent, Polyflow, and Icepak. To uninstall the standalone version
of CFD-Post, you must specify -cfdpost as well as all of the above products that you have installed.
Note that CFD-Post is also installed with CFX; however, you do not need to uninstall CFX to uninstall
the standalone version of CFD-Post, and uninstalling the standalone version of CFD-Post will not remove
the CFD-Post capability from CFX.
Chapter 8: Configuring CAD Products
The connection, geometry interface, and other CAD functionality for all supported CAD products is in-
cluded with the ANSYS release media. Select the CAD systems you want to install during the installation
process. If you choose not to install CAD systems during the installation, you can install them at a later
date.
To run the connection or geometry interface functionality, you need to:
1. Ensure that the CAD product is correctly installed and licensed.
2. Ensure that you have the correct ANSYS, Inc. license(s).
3. Run the installation setup.
For complete information about the files you can import and the platforms supported by the connection
capability, see the ANSYS Connection User's Guide. For more information about geometry interface in-
formation in ANSYS Workbench, see the topics Attach to Active CAD Geometry and Import External
Geometry File in the ANSYS DesignModeler help.
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.
The connection for Creo Parametric requires you to run Mechanical APDL, Creo Parametric and the
connection for Creo Parametric on the same machine. The connection for NX requires you to run
Mechanical APDL, NX, and the connection for NX on the same machine. The connections for CATIA,
SAT, and Parasolid do not require any additional CAD installation.
8.1. Using the Product & CAD Configuration Manager

The Product & CAD Configuration Manager allows you to configure geometry interfaces for Mechan-
ical APDL and ANSYS Workbench. CAD configuration is typically handled during the product installation;
however, if you chose to skip those steps, or if you make changes to your local CAD configuration
between releases (for example, you install, move, or update your CAD package, or remove it entirely),
you can use this utility.
This document describes how to use the Product & CAD Configuration Manager to progress through
the configuration process.
1. From Windows 7, click Start > All Programs > ANSYS 2019 R1 > Utilities > Product & CAD Configuration
2019 R1. From Windows 10, right-click the Start > ANSYS 2019 R1> Product & CAD Configuration
2019 R1.
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:
AutoCAD
• If you selected AutoCAD as one of your CAD products, you will have to choose which AutoCAD
product to configure. You can choose the Reader (non-associative) or the Workbench Associative
Interface (requires that the CAD product be installed).
CATIA V5
• If you selected CATIA V5 and any product that includes ANSYS Workbench, you will be required to
select the appropriate CAD reader/plugin for ANSYS Workbench. You can choose to configure the
Reader or the CADNexus CAPRI CAE Gateway.
Autodesk Inventor
• If you selected Inventor as one of your CAD products, you will have to choose which Inventor product
to configure. You can choose the Reader (non-associative) or the Workbench Associative Interface
(requires that the CAD product be installed).
NX
1. If you selected NX, you will have to choose which NX product to configure. You can choose the
Reader (non-associative) or the Workbench Associative Interface (requires that the CAD product be
installed).
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. If you are an admin-
istrative user, a file required to load the NX plug-in is placed in the administrative user's Application
Data folder by default, which may not be accessible by other, non-administrative users. To allow non-
administrative users to run, you will need to define the environment variable UGII_CUSTOM_DIR-
ECTORY_FILE prior to installation and specify a location where other users have read access.
3. If you selected the ANSYS ICEM CFD NX Interface product but not the NX Geometry Interface product
on the product selection screen, you will need to specify the NX installation path.
Creo Parametric
1. If you selected Creo Parametric, you will have to choose which Creo Parametric product to configure.
You can choose the Reader (non-associative) or the Workbench Associative Interface (requires that
the CAD product be installed).
2. If you choose the Workbench Associative Interface, you may need to specify the Creo Parametric
language, the Creo Parametric command, and the full Creo Parametric installation path (C:\Program
SOLIDWORKS
Solid Edge
• If you selected Solid Edge as one of your CAD products, you will have to choose which Solid Edge
5. When all of your CAD products have been successfully configured, click Exit.
Administrative users can review the log file produced by the most recent Product & CAD Configuration
Manager in ANSYS Inc\v193\CADConfigLogs\Latest\CADConfigurationMgr.log, while the non-
admin user configuration record is stored in %TEMP%\Ansys\v193\CADConfigLogs\Latest. Historical
configurations are maintained in the corresponding 193\<Date>\CADConfigurationM-
gr_<Time>.log. Any errors are recorded in CADConfigurationMgr.err located immediately in
CADConfigLogs folder. For administrators a log capturing product uninstall is stored in %TEMP%\An-
sys\v193\CADConfigLogs\UninstallFinalLog.
Important
If you change your source from reader to associative plug-in or vice-versa (Creo Parametric,
NX, SOLIDWORKS, Autodesk Inventor, SolidEdge, AutoCAD or CATIA V5), you must first un-
configure the existing source and then configure using the new source.
8.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.
8.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 Windows is:
"<installpath>\commonfiles\CAD\bin\winx64\Ans.CadInt.CADConfigurationUtility.exe"
-arguments

UNCONFIGURE_SPECIFIED None Results in any specified CAD sources being
unconfigured. When this flag is absent, the Product
& CAD Configuration Manager will attempt to
configure all designated CAD sources.
UNCONFIGURE None Results in all CAD sources being disabled along
with prerequisite libraries.
Either: PE_CONFIG_WB or None Specify Creo Parametric source as either the
PE_CONFIG_WBSPATIAL associative plug-in or the reader (Spatial, no Creo
Parametric install required). When the plug-in is
specified, additional arguments PROELOADPOINT
and PROE_START_CMD are required.

PROELOADPOINT Full path to Creo Not required with unconfigure operation.
Parametric
installation (quotes
required on
Windows).
PROE_START_CMD Full path to Not required with unconfigure operation.
command used to
launch Creo
Parametric (quotes
required on
Windows)
Either: UG_CONFIG_WB or None Specify NX source as either the associative plug-in
UG_CONFIG_WBSPATIAL or the reader (Spatial, no NX install required). When
the plug-in is specified, the argument
UGII_BASE_DIR must also be specified.
UGII_BASE_DIR Full path to NX This should agree with environment variable
installation UGII_BASE_DIR. Not required with unconfigure
operation.
Either: CATIA_SPATIAL or None Specify CATIA V5 source as either the Reader
CATIA_CAPRI (Spatial, no CATIA install required) or CAPRI
(CADNexus install required).
OSDM_CONFIG None Configure/unconfigure Creo Elements/Direct
Modeling.
Either: INVENTOR_CONFIG or None Specify Inventor source as either the associative
INVENTOR_CONFIG_WBSPATIAL plug-in or the reader (Spatial, no Inventor install
required).
Either: SOLIDWORKS_CONFIG None Specify SOLIDWORKS source as either the
or SW_CONFIG_WBSPATIAL associative plug-in or the reader (Spatial, no
SOLIDWORKS install required).
Either: SOLIDEDGE_CONFIG or None Specify Solid Edge source as either the associative
SOLIDEDGE_CONFIG_SPATIAL plug-in or the reader (Spatial, no Solid Edge install
required).
Either: ACAD_CONFIG or None Specify AutoCAD source as either the plug-in or
ACAD_CONFIG_SPATIAL the reader (Spatial, no AutoCAD install required).
JTOPEN_CONFIG None Configure/unconfigure JT.
CATIA4_CONFIG None Configure/unconfigure CATIA v4.
CATIA6_CONFIG None Configure/unconfigure CATIA v6.
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 Creo Parametric and SOLIDWORKS Geometry Interfaces to ANSYS
Workbench from the command line by using the following:
-SW_CONFIG -PE_CONFIG_WB -PROELOADPOINT "C:\Program Files\PTC\Creo 2.0\Parametric"
-PROE_START_CMD "C:\Program Files\PTC\Creo 2.0\Parametric\bin\parametric.bat"
where installpath is the same as the value of environment variable %AWP_ROOT193%, platform
is the value of environment variable %ANSYS_SYSDIR%, and Creo Parametric is installed to C:\Program
Files\PTC\Creo 2.0\Parametric.
To unconfigure the same CAD Interfaces, the command would be:

-unconfigure_specified -SW_CONFIG -PE_CONFIG_WB
Although the argument order does not matter, an argument value must immediately follow its argument.
8.1.3. Network Considerations

When Workbench is installed to a network location (made available from a mapped network drive), any
configuration actions will make the selected geometry interfaces available/unavailable only to the user
who is currently logged in. To make changes that apply to all users, the configure/unconfigure action
must be run as an administrator logged into the system hosting the Workbench installation. Configur-
ation actions performed as an administrator on this server machine will impact all users on all machines
referencing that install, except for users who have overridden the server configuration by configuring
for themselves.
For loading associative geometry interfaces into their respective CAD environments, when the Workbench
installation is referenced from a network location:
• A local administrator’s configuration changes will set up associative CAD interfaces to load into the CAD
environment of all local users, when that scope is selected (applicable to AutoCAD, Inventor, SOLIDWORKS,
Solid Edge, Creo Elements/Direct and NX).
• The associative geometry interface for Creo Parametric will load into the CAD environment of all users when
the CAD installation is writable for that administrative user. Otherwise, it will load only into the CAD envir-
onment of the administrator who is currently logged in, and each additional user must be configured indi-
vidually.
CAD Readers for JT, Creo Parametric, Inventor, NX, CATIAV5, CATIAV6, AutoCAD, Solid Edge and
SOLIDWORKS may not fully unconfigure on a client of a network installation, even when this action is
attempted by a client's administrator. An administrative user on the server must execute an unconfigure
action, using Product & CAD Configuration Manager, in order for these interfaces to be fully deactivated
on the client.
There is a limitation in the Product and CAD Configuration Manager which prevents you from config-
uring a different geometry interface type (other than the server specified type) on a network install's
client system. To address this issue, run the CAD Configuration Manager on the client system and change
the geometry interface to the desired type (Reader vs. Assocative).
8.1.4. Uninstalling
Warning
Do not proceed with an uninstall for CAD-specific unconfigure actions or you will leave some
ANSYS Workbench products unusable.
8.1.5. Creo Parametric Configuration

Running the Product & CAD Configuration Manager for Creo Parametric performs the following steps
to activate the Creo Parametric plug-in:
• Sets the environment variable PROE_START_CMD193 to the file used to launch Creo Parametric (for example
C:\Program Files\PTC\Creo 3.0\F000\Parametric\bin\parametric.bat).
• For administrative installations, adds the ANSYS 2019 R1 entry to the config.pro file located in
<creo_path>\text. An example for Creo Parametric would be:
PROTKDAT C:\Program Files\PTC\Creo 3.0\F000\Common Files\text
• Updates the WBPlugInPE.dat file referenced in the config.pro file, so that it contains information for
loading the WorkBench Plug-In and the ANSYS Connection product.
• Registers the Plug-In file WBPlugInCreo3COM.dll (Creo Parametric 3.0) or WBPlugInPECOM.dll (Creo
Parametric 2.0) referenced in the WBPlugInPE.dat file.
• When Workbench is installed on a network location and the local administrator has write permissions to
<creo_path>\text, a version-specific WBPlugInPE193.dat file will be created and placed in that
folder. However, when <creo_path>\text is unwriteable, both the config.pro and the WBPlugIn-
PE193.dat will be placed in either %HOME% or %HOMEDRIVE%%HOMEPATH%.
If you do not have write access to your ANSYS Workbench installation, you may encounter the following
error when attempting to import Creo Parametric models without an active CAD session:
No write access, please choose another startup directory for trail file
creation.
To prevent this issue, add the following line to your config.pro file:
trail_dir $TEMP
WBPlugInPE.dat File Contents The WBPlugInPE.dat file should look like this example:
NAME WB193PluginProWF
EXEC_FILE E:\Program Files\ANSYS Inc\V193\AISOL\CADIntegration\ProE\
winx64\WBPlugInPECOM.dll
TEXT_DIR E:\Program Files\ANSYS Inc\V193\AISOL\CADIntegration\ProE\
ProEPages\Language\<locale>
STARTUP dll
delay_start FALSE
allow_stop TRUE
unicode_encoding FALSE
END
NAME ac4pro193dll
exec_path E:\Program Files\ANSYS Inc\V193\ANSYS\ac4\bin\pro\winx64\ac4pro.exe
text_path E:\Program Files\ANSYS Inc\V193\ANSYS\ac4\data\pro\text
STARTUP dll
delay_start FALSE
allow_stop TRUE
revision 24.0
end
Do not delete any of these lines. If you modify this file, do NOT enter a carriage return after the END
line. The file may be customized with other information. If these lines are deleted, or if the WBPlugIn-
PE.dat file is not present in any of the directories in the search path, Creo Parametric will not load
ANSYS-related CAD interfaces. You should typically never have to edit these files for path information
contained within them. Paths are determined by environment variable settings, which are set automat-
ically during installation. If you encounter problems when attempting to run Creo Parametric, use the
Product & CAD Configuration Manager to reconfigure rather than attempting to edit files directly.
Following an update of an existing Creo Parametric 2.0 or 3.0 installation to a different maintenance
release (for example upgrading from datecode F000 to M010), the ANSYS Workbench Associative Plug-
In will no longer be configured. To reactivate your plug-in, follow the steps described in Using the
Product & CAD Configuration Manager (p. 55). This situation does not apply to Creo Elements/Pro 5.0.
In order for Product & CAD Configuration Manager to successfully perform configuration of the Creo
Parametric Associative Geometry Interface it is required that the Windows Operating System's decimal
separator be the same symbol when running configuration as it was when the original Creo Parametric
installation was performed.
8.1.5.1. Configuring the Connection for Creo Parametric

All Creo Parametric users must have copies of the WBPlugInPE.dat file and the config.anscon.193
(connection for Creo Parametric) files. The config.anscon.193 file is placed in the Program
Files\ANSYS Inc\V193\ansys\ac4\data\winx64 directory. config.anscon.193 must be
copied into the user's working directory at the time Creo Parametric is started. The WBPlugInPE.dat
file is placed in the Program Files\ANSYS Inc\V193\AISOL\CADIntegration\%AN-
SYS_PROEWF_VER%\ProEPages\config directory. This file defines the name of the executable,
the path to the executable, the path to the message file, and the current revision of Creo Parametric.
Note
If the ANSGeom menu in Creo Parametric does not appear correctly, copy the con-
fig.anscon.193 file into your working directory and restart Creo Parametric.
8.1.5.1.1. The WBPlugInPE.dat File and config.pro File

Creo Parametric uses the WBPlugInPE.dat file to locate related executables such as the connection
for Creo Parametric.
Mechanical APDL/ANSYS Workbench also requires a config.pro file.
• The config.pro file resides <path-to-creo-parametric>\..\Common Files\<Creo Ship

Code>\text for Creo Parametric. The Creo Ship Code is a three digit number preceded by a single
letter. The ship code is specified in the Creo Parametric installation log, which can be found in <path-to-
creo-parametric>\bin\pim\xml\creobase.xml. In the cases that the crebase.xml file is missing,
the ship code can be determined by looking in the Windows Registry using regedit. For Creo 2.0, that value
is located in SOFTWARE\Wow6432Node\PTC\Creo Parametric\2.0\<DateCode>\Shipcode. For Creo 3.0 the
value is located in HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\PTC\PTC Creo Parametric\3.0\<Date-
Code>. <Datecode> is a integer reflecting the date of the Creo build.
The config.pro file contains a PROTKDAT line that points to the WBPlugInPE.dat file. This file is
generated either during the product install or by running the Product & CAD Configuration Manager
to configure the Mechanical APDL /ANSYS Workbench products for Creo Parametric.
The <proe_platform> variable is the name that Creo Parametric gives to its platform directories:
WBPlugInPECOM
Hardware ANSYS Platform Creo Parametric

Platform <platform> Platform
<proe_plat-
form>
Win 7 x64 winx64 x86e_win64
8.1.5.1.2. The config.pro File

A typical config.pro file might look like the following example. This example has an entry for ANSYS
Workbench. You may have other Creo Parametric specific customizations.
PROTKDAT E:\Program Files\ANSYS Inc\V193\AISOL\CADIntegration\$ANSYS_PROEWF_VER\
ProEPages\config\WBPlugInPE.dat
8.1.5.1.3. The config.anscon.193 File

Users who launch Mechanical APDL from Creo Parametric will need the information from the con-
fig.anscon.193 file. This file is installed for all users in the \ac4\data\winx64 subdirectory. You
typically do not need to edit this file. Here is a sample config.anscon.193 file:
ANSYS_CMD %AWP_ROOT193%\ANSYS\bin\%ANSYS_SYSDIR%\ansys193.exe
ANSYS_GRAPHIC_DEVICE WIN32
ANSYS_SOLVER Sparse**
ANSYS_SELECTED_LAYERS 1-256**
ANSYS_GEOMETRY_TYPE Solids Only**
ANSYS_NEUTRAL_FORMAT Yes**
ANSYS_PRODUCT_NAME ANE3FL
**These variables are not supported by Creo Parametric and are ignored by Creo Parametric.
See Setting ANSYS Configuration Parameters in the Connection User's Guide for more information about
the config.anscon.193 file.
8.1.5.2. Creo Parametric Environment Variables

Most environment variables are set during product installation. In general, you will not need to reset
these variables. Check the manuals for the individual CAD products for information about environment
variables and their settings.
PROE_START_CMD193
Specifies the name of the .bat file which launches Creo Parametric on the system. The path to the execut-
able should be already set if the Creo Parametric installation path has been defined for the PATH environ-
ment setting.
PROE_START_CMD193 Default = C:\Program Files\PTC\Creo 2.0\Paramet-

ric\bin\parametric.bat
8.1.6. NX Configuration
Running the Product & CAD Configuration Manager for NX performs the following steps to activate
the NX plug-in:
• If not already existing, sets the environment variable UGII_CUSTOM_DIRECTORY_FILE to %APPDATA%\AN-

SYS\v193\Unigraphics\custom_dirs.dat.
Configuring CADNexus/CAPRI CAE Gateway for CATIA V5
• If not already present, adds an entry to the custom_dirs.dat file specifying the location of the Plug-In,
e.g., C:\Program Files\ANSYS Inc\V193\AISOL\CADIntegration\UnigraphicsNX\winx64.
• Registers the Plug-In file (DSPlugInUGCOM.dll). For the previous example, these files would be located
in C:\Program Files\ANSYS Inc\V193\AISOL\CADIntegration\Unigraphic-
sNX\winx64\startup.
8.1.6.1. Configuring the Connection for NX

User-Defined Environment Variables You will need to have the following environment variable set
if you will be running the connection for NX product from inside NX.
UGII_BASE_DIR and UGII_ROOT_DIR

The environment variables UGII_BASE_DIR and UGII_ROOT_DIR must be defined for proper operation
of NX and the ANSYS Workbench Plug-In to NX. These environment variables are typically created by the
NX installer; however, in rare cases, you may have to create/update these two variables. In these situations,
the NX Installation Location field will be left blank within the Product & CAD Configuration Manager's
NX tab.
When multiple NX versions are installed on a system, the UGII_BASE_DIR environment variable
must be set to the install path of the NX version to be launched, prior to starting that version of
the CAD. Otherwise errors will be encountered during CAD startup and the plug-in will not load.
For example, if switching from NX 8.5 to run NX 9.0, you must update UGII_BASE_DIR to the NX
9.0 path before starting NX 9.0. Similarly, the UGII_ROOT_DIR environment variable must be set to
the ugii subdirectory in the install path of the NX version to be launched.
8.2. Configuring CADNexus/CAPRI CAE Gateway for CATIA V5

The CADNexus/CAPRI CAE Gateway for CATIA V5 product is available for ANSYS Workbench. The ANSYS
Workbench-specific portions are included in the installation. However, to run this product, you must
complete the configuration as follows:
1. Install ANSYS Workbench according to the instructions in this guide.
2. Install CATIA V5 and DSLS licensing (requires a CATIAV5 license key MD2, HD2 or ME2).
3. From the ANSYS customer site, download the CADNexus/CAPRI CAE Gateway for CATIA V5 for your platform
to a temporary folder. (Do not download to a folder containing blank spaces in the folder name, e.g.,
Program Files). Follow the download procedures described in Downloading the Installation Files (p. 16).
4. Extract the contents of the zip file using your standard zip utility.
5. Install CADNexus/CAPRI CAE Gateway for CATIA V5 using the appropriate exe for your platform.
6. Follow the instructions on the CAPRI installation screens to complete the installation. When specifying
the component to install, you will need to select the desired CatiaV5 release under CAPRI CAD Applications.
When asked if CAPRI should set the environment variables, click Yes.
7. Run the Product & CAD Configuration Manager and select the Catia V5: CADNexus/CAPRI CAE
Gateway option to complete the configuration as described in Using the Product & CAD Configuration
Manager (p. 55).
Note
Using the Product & CAD Configuration Manager to set up the CADNexus/CAPRI CAE
Gateway does not require administrative rights, although installing that product (step
5) requires these rights. However, if you want to reconfigure to use the ANSYS Workbench
Reader for Catia V5, administrative rights are required.
If you want to revert to the standard CATIA V5 interface, run the Product & CAD Configuration Manager
and select the Catia V5: Standard Interface option to complete the configuration as described in Using
the Product & CAD Configuration Manager (p. 55).
You cannot run the standard CATIA V5 interface simultaneously with the CADNexus/CAPRI CAE Gateway
for CATIA V5 interface.
8.3. Configuring AutoCAD

Running the Product & CAD Configuration Manager for AutoCAD performs the following steps to active
the plug-in:
1. Creates the folders %PROGRAMDATA%\AnsysWB.bundle and %PROGRAMDATA%\Autodesk\Application-

Plugins\AnsysWB.bundle\Contents\v193\Winx64\AutoCAD
2. Copies the following folders from the Workbench installation into the bundle's AutoCAD sub-folders:
• All files within <ANSYS 16.0 Install Path>\aisol\CADIntegration\DWG\winx64 are copied to %PROGRAM-
DATA%\ApplicationPlugins\AnsysWB.bundle\Contents\v193\winx64\AutoCAD\2013
• All files within <ANSYS 16.0 Install Path>\aisol\CADIntegration\DWG\images are copied to %PROGRAM-
DATA%\Autodesk\ApplicationPlugins\AnsysWB.bundle\Contents\v193\winx64\AutoCAD\Resources
• All folders within <ANSYS 16.0 Install Path>aisol\CADIntegration\DWG\Language are copied to %PRO-
GRAMDATA%\Autodesk\ApplicationPlugins\AnsysWB.bundle\Contents\v193\winx64\AutoCAD\Re-
sources\Language
3. Finally a %PROGRAMDATA%\Autodesk\ApplicationPlugins\AnsysWB.bundle\PackageContents.XML file is

created with the following contents:
<?xml version="1.0" encoding="utf-8"?>
<ApplicationPackage ProductCode="{6C6B872A-2ECF-4272-B7B7-1CA69B1EAD08}" HelpFile="./Contents/v193/
Winx64/AutoCAD/Resources/cadAutoCAD.html" Icon="./Contents/v193/Winx64/AutoCAD/Resources/ansys70.bmp"
Description="ANSYS Workbench Geometry Interface 2019 R1" AppVersion="19.3" Name="AnsysWB193
" ProductType="Application" SchemaVersion="1.0" AutodeskProduct="AutoCAD" FriendlyVersion="15.0
" SupportedLocales="Enu" OnlineDocumentation="www.ansys.com
" Author="ANSYS, Inc." UpgradeCode="{12D6EF98-CEE6-431E-B699-DE9DE4F32B7E}">
<CompanyDetails Name="ANSYS, Inc." Email=" " Url="www.ansys.com" Phone=" " />
<RuntimeRequirements SeriesMax="R19.1" SeriesMin="R19.0" Platform="AutoCAD" OS="Win64" />
Configuring AutoCAD
<Components Description="64bit Component">
<RuntimeRequirements SeriesMax="R19.1" SeriesMin="R19.0" Platform="AutoCAD" OS="Win64" />
<ComponentEntry AppName="WB150PlugInDWG" ModuleNameWin64="./Contents/v193/Winx64/AutoCAD/2013/
WB150PlugInDWG.arx" AppDescription="Windows 64bit support" LoadOnCommandInvocation="True"
LoadOnRequest="True">
<Commands GroupName="ANSYS_Workbench_Geometry_Interface">
<Command Local="WB150STARTWB" Global="WB150STARTWB" />
<Command Local="WB150STARTASIM" Global="WB150STARTASIM" />
<Command Local="WB150HELP" Global="WB150HELP" />
<Command Local="WB150ABOUT" Global="WB150ABOUT" />
</Commands>
</ComponentEntry>
<ComponentEntry AppName="AnsysWB150" ModuleName="./Contents/v193/Winx64/
AutoCAD/Resources/Language/
en-us/Workbench150.cuix" />
</Components>
</ApplicationPackage>
Chapter 9: Uninstalling the Software
Use this process to uninstall any ANSYS, Inc. product that was installed using the Unified Installation
process.
Note to CFX Users The provided uninstall tool cannot uninstall MPI services. If you have CFX products
installed that you are uninstalling, you must stop the MPI services before continuing with the uninstall:
1. As an administrator, go to the Run window and type Services.msc.
2. Search for "IBM Platform MPI Remote Launch" and if found, click Stop.
3. Search for "Intel(R) MPI Library Process Manager" and if found, click Stop.
4. Continue with the uninstallation procedure, below.
Uninstall Procedure for All Users All users should use the following procedure to uninstall ANSYS,
Inc. products.
1. Close all applications that are currently running.
2. From Windows 7, select Start > All Programs > ANSYS 2019 R1 > Uninstall ANSYS 2019 R1. From
Windows 10, right-click the Start > ANSYS 2019 R1> Uninstall ANSYS 2019 R1. You must uninstall with
the same or higher privileges than were used to install the product, and we strongly recommend unin-
stalling as the same user who installed the product originally.
3. Select the product(s) to be uninstalled and unconfigured and click Uninstall Selected Item(s). Not all
products and product components may be listed individually.
4. You will be asked to save all data and close all Windows applications before continuing. Click OK.
5. You will be asked if you are sure you want to uninstall the selected products. Click Yes.
6. A message appears indicating that the uninstallation is complete. Click OK.
Note
After all the desired products are uninstalled, you are presented with a message
stating that any files or directories that were not recognized by our uninstall program
remain. These remaining files typically include such things as .udf files, user custom-
ized documentation, and various routines. If these files are no longer required, re-
move them manually.
CFD-Post CFD-Post can be installed as a standalone product; however, as a standalone product, it is

also automatically installed with Fluent, Polyflow, and Icepak. To uninstall CFD-Post, you must uninstall
all of the above products that you have installed.
Uninstalling the Software
• If you choose to uninstall standalone CFD-Post without uninstalling the other products, the uninstall program
will not uninstall CFD-Post.
• If you choose to uninstall all of the other products that include standalone CFD-Post but you do not select
CFD-Post, then CFD-Post will not be removed.
Individual product directories may not be removed if they contain components that are shared with
other products that have not been uninstalled. However, the uninstalled product will no longer run.
In the case of a platform (file server) installation, the uninstall will remove the selected product(s) from
all of the Windows platforms.
This procedure removes the specified ANSYS, Inc. program from your system but will not remove the
ANSYS licensing components. Follow the steps in Uninstalling Licensing Components (p. 68) to uninstall
the licensing components.
Uninstalling ANSYS Discovery Components

When performing an uninstall of any ANSYS product on a computer that contains both ANSYS Products
and ANSYS Discovery, you must uninstall ALL ANSYS Products as well as all ANSYS Discovery components.
Depending on your original installation order, you may be presented with a product selection menu
during the uninstall process. If you are presented with this menu, you must select all ANSYS products.
Failure to uninstall all ANSYS products could cause the remaining installed ANSYS products to stop
working.
9.1. Uninstalling Licensing Components

Before proceeding with the following steps to remove the ANSYS licensing components from your
system, make certain that there are no ANSYS, Inc. products on this machine or any other machines on
the network that rely on these ANSYS licensing components.
License Servers Follow these steps on a license server machine:
1. Stop the ANSYS, Inc. License Manager via the ANSYS License Management Center.
2. Uninstall the ANSYS, Inc. License Manager service. You must use the following command to do so:
"C:\Program Files\ANSYS Inc\Shared Files\Licensing\<platform>\ansysli_server"
-k uninstall
3. Delete the Licensing subdirectory.
4. Remove the ANSYS, Inc. License Manager folder from the Start menu.
5. Remove the ANSYSLIC_DIR and the ANSYSLIC_SYSDIR environment variables, if set.
Clients Follow these steps on client machines:
1. Delete the Licensing subdirectory.
2. Remove the ANSYS 2019 R1> ANSYS Client Licensing folder from the Start menu or from the Apps
screen.
10.1. Installation Troubleshooting
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.
10.1.1. Using ANSLIC_ADMIN to Gather Diagnostic Information

You can also use the AnsysInstallationDiagnostics.exe, in the \v193\instutil directory,

for additional installation diagnostics. This tool is helpful to diagnose installation and runtime issues.
One or more log files will be generated either at the same location as the tool or in your temporary
directory, depending on directory permissions. The log files are intended to help ANSYS, Inc. technical
support personnel expedite any technical issues. It would be useful to have the files ready to provide
before contacting Technical Support.
10.1.2. Uninstall Gives Access Denied Error Message

If you run the uninstall utility as a non-administrative user, you may get access denied error messages
when removing product components. Run the uninstall as an administrative user, and close all applica-
tions before running the uninstall.
10.1.3. Uninstall on a Windows 7 or Windows 10 System Gives Compatibility

Error Message
If you uninstall an ANSYS, Inc. product on a Windows 7 or Windows 10 system using the ANSYS, Inc.
Uninstall utility, you may see the following error message:
Troubleshooting
This program might not have installed correctly.
If this program didn't install correctly, try reinstalling using settings that are compatible with this
version of Windows.
This message is caused by the Windows Program Compatibility Assistant and can safely be ignored.
Click Cancel and continue with the uninstall.
10.1.4. A .chm File Does Not Display Properly Across a Network

Help system .chm files may not display topics correctly when you try to use a Universal Naming Con-
vention (UNC) path to open the file on a network shared folder, typical with a Network Configuration
install. This is a known issue with security update 896358, security update 840315, or Microsoft Windows
Server 2003 Service Pack 1 (SP1). See those lionks for more information on this problem and Microsoft's
recommended fix.
If you are running ICEM CFD over the network and you have applied this security update, you may not
be able to access ICEM CFD Help using the Help menu. To access ICEM CFD Help, navigate to common-
files\help\en-us in the installation directory on the server machine and copy the file icem-
cfd_help.chm to your local machine. Double-click the local copy to view the help.
10.1.5. Products Crash with an Application Error

On Windows Server 2008 systems, ANSYS applications may crash with an application error if the DEP
(Data Execution Prevention) flag is set. To check your DEP setting, right mouse click My Computer, and
select Properties. Select the Advanced tab, and under Performance, click Settings. Then select the
Data Execution Prevention tab.
If DEP is set, you will need to add ANSYS to the list of exceptions. For more information on DEP and
how to change the settings, see security update 875351.
10.1.6. Product Installation Does Not Create Start Menu Item for ANSYS and
CAD Plugins Do Not Work
On a Windows 7 or Windows 10 system, if you install ANSYS, Inc. products but do not see a Start
Menu/Apps item and your CAD plugins do not work, the TEMP environment variable may be pointing
to an inaccessible location. For example, it may point to a location such as %USERPROFILE%\Local
Settings\Temp. As a result, the product installation could end without configuring the product
correctly. You should ensure that the TEMP variable points to a valid location, such as %USERPRO-
FILE%\AppData\Local\Temp.
10.1.7. Product Installation Displays Security Warning Dialogs or Silent Product

Installation Hangs on a Network Install
If you see a security warning dialog box during a GUI installation/product configuration, or if your in-
stallation hangs during a silent installation, you may need to modify your security settings. Set the
machine you are installing from as a trusted site and allow launching of unsafe applications so that the
prerequisite installation can complete. Then re-run the installation. Contact your system administrator
or refer to your operating system documentation for details on modifying security settings.
Alternatively, you can run the prerequisite check to verify that you have all the necessary prerequisites.
If necessary, install any prerequisites and rerun the installation:
Installation Troubleshooting
1. Run PreReqCheck.exe from the top level directory.
2. Install any missing prerequisites by running InstallPreReqs.exe from the top level directory as an
administrator.
3. When the prerequisites have finished installing, run the installation as you normally would (GUI or silently).
10.1.8. System-related Error Messages

***Error, ANSYS193_DIR environment variable is not set. This is a fatal error – exiting.
This message indicates that the ANSYS193_DIR environment variable was not set where necessary
for licensing. This environment variable should be set to the installation directory.
Unexpected error: Request for the permission of type ... failed.
If you encounter this type of message on a server configuration, you may need to set the machine
as a trusted site. On a Windows 7 or Windows 10 machine, in the Control Panel, select Network
and Internet, select Internet Options, and select Security. Click Trusted Sites and click Sites. Add
the machine as file://servername.
10.1.9. CasPol Error Messages

ERROR: Not enough arguments, no permission set specified
If you are configuring to a server with spaces in the path and get this error, then you must put
quotes around your server specification as shown in the following example:
C:\Users\>C:\Windows\Microsoft.NET\Framework\v2.0.50727\CasPol.exe -m -a
g 1.2 -url file://"\\machineabc\ANSYS Inc\*" FullTrust
10.1.10. Installing Prerequisites May Require a System Restart

The installation program checks your system to determine if you have the necessary prerequisites. If
the prerequisites are not already on your system, the prerequisites will be installed automatically. In
some cases, a system restart may be required after exiting the installation and before using any ANSYS
Products.
If a system restart is required, a restart error message will be written to the install.err error file. The in-
stall.err error file is located in the installation directory.
Note
Microsoft .NET Framework 4.6.2 is now required for running ANSYS products. If your installation
computer does not have .NET 4.6.2 installed, the ANSYS installation program will install .NET
4.6.2 as a prerequisite and may require a system restart after exiting the installation and before
running any ANSYS products.
10.1.11. Confirmation Messages Open Behind the Installer Display in Windows

Because of a known issue in Windows, confirmation messages displayed by the ANSYS Installer occa-
sionally open behind the installer display. In such a case, a pulsing task bar icon is the only visible noti-
fication that a confirmation message is open. Manually bring the confirmation message to the foreground.
Accept the message and continue the installation process.
Troubleshooting
10.1.12. Start menu shortcuts are successfully created but are not displayed
in the Start Menu
This issue is a result of a Windows limitation on the number of Start Menu shortcuts that can be displayed.
A work around for this issue is to remove folders containing unneeded start menu shortcuts from the
Start Menu/Programs folder. This will cause the Start Menu to be populated with the shortcuts that
were not previously visible. To remove the unneeded shortcuts:
1. Navigate to %ProgramData%\Microsoft\Windows\Start Menu\Programs.
2. Move the program folders containing the unneeded shortcuts to a location outside of the Start Menu
path above.
3. Verify that the shortcuts that were not previously visible are displayed. If not, reboot your Windows
system.
10.2. Installation Troubleshooting - Graphics

The items listed below apply to issue relating to graphics cards and drivers.
10.2.1. ANSYS AIM Graphics Are Note Being Displayed Correctly With the
Latest AMD Graphics Drivers
When using AIM with the AMD 18.Q1 graphics drivers, the screen goes blank after a file is imported. If
you experience this issue, install a newer version (18.Q1.1 or 18.Q2) of the AMD graphics driver; or reinstall
an older version (17.Q4.1 or earlier).
10.3. Installation Troubleshooting - Mechanical APDL and ANSYS Work-

bench Products
The items listed below apply only to the Mechanical APDL and/or ANSYS Workbench products.
10.3.1. The Mechanical APDL Launcher is Excessively Slow to Start

If the Mechanical APDL launcher takes an excessively long time to startup (Windows only), make sure
the hostnames in the ansyslmd.ini file and in the ANSYSLMD_LICENSE_FILE and the ANSYSLI_SERV-
ERS environment variables are typed correctly and that the hosts specified by the hostnames exist.
Replacing hostnames with IP addresses may improve the speed as well. Also verify that the port number
is correct.
10.3.2. Display Problems on Windows

This situation applies only to Windows systems running Mechanical APDL.
Windows includes a function called Aero that may cause Mechanical APDL graphing or plotting problems
in 3-D mode on some systems. If this problem occurs, disable the Windows Aero theme in Windows 7
when running Mechanical APDL.
10.3.3. ANS_ADMIN Error Messages

Grayed out options
Installation Troubleshooting - Mechanical APDL and ANSYS Workbench Products
If certain options are grayed out, your account may not have the necessary system administrator
privileges necessary to run those options.
10.3.4. Mechanical APDL Product 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\v193\launcher on Windows or ~/.ansys/v193/launcher/ on UNIX.
***No ANSYS product installations found.
Verify your Mechanical APDL product installation. If the desired product was not installed, install it.
10.3.5. Distributed Mechanical APDL IBM Platform MPI Error Messages

You may encounter the following message when setting up IBM Platform MPI or running Distributed
ANSYS using IBM Platform MPI.
Error executing Mechanical APDL. Refer to System-related Error Messages in the Mechanical APDL
online help. If this was a Distributed Mechanical APDL job, verify that your MPI software is installed
correctly, check your environment settings, or check for an invalid command line option.
You may see this error if you did not correctly run the set password bat file. Verify that you completed
this item according to the IBM MPI installation readme instructions.
You may also see this error if ANSYS Inc\v193\ansys\bin\<winx64> is not in your PATH.
If you need more detailed debugging information, use the following:
1. Open a Command Prompt window and set the following:
SET ANS_SEE_RUN=TRUE
SET ANS_CMD_NODIAG=TRUE
2. Run the following command line: ansys193 -b -dis -i myinput.inp -o myoutput.out.
10.3.6. ANSYS Workbench Products Troubleshooting

ANSYS Workbench. After each situation description or error message is a user action required to correct
the problem. Always try the suggested user action before contacting your technical support represent-
ative.
Problem Situations
CAD System Plug-In Menus Do Not Appear for NX or Creo Parametric ANSYS Workbench on
Windows platforms will append its information to an existing customization file for NX and/or Creo
Troubleshooting
Parametric. If no customization file exists, ANSYS Workbench will create a file. For NX, ANSYS Workbench
looks for the custom_dirs.dat file in the directory specified via the UGII_CUSTOM_DIRECTORY_FILE
environment variable. For Creo Parametric, ANSYS Workbench looks for the config.pro file in the
%HOMEDRIVE%%HOMEPATH% directory. In addition, during setup of the Creo Parametric Geometry In-
terface, ANSYS Workbench will also append its information to the config.pro file located in the Creo
Parametric installation path, under the \text directory.
If ANSYS Workbench encounters a read-only file, it will not be able to write the necessary information
to the file. In this case, you will need to revise the permissions on the file and manually add the appro-
priate ANSYS Workbench-specific information in order for the ANSYS menu to appear in NX or Creo
Parametric.
Script Errors When Running ANSYS Workbench If you encounter script errors such as "Error: Unable
to create object microsoft.XMLDOM," you may need to install the latest version of Microsoft's MSXML.
Visit Microsoft's MSXML site for more information on downloading and installing MSXML.
ANSYS Workbench Error Messages

***Unable to connect to Solver Manager.
Another application might be using the Solver Manager port (10002 by default). Try changing the
port number by editing the Ansys.SolverManager.exe.config file located in the installation
directory at \AISOL\Bin\<platform>.
If you are getting the "Unable to connect to Solver Manager" error message or are having difficulty
launching other applications/editors, it is also possible that the Windows hosts file has been corrupted.
Make sure that localhost is specified in the Windows <os drive>:\Windows\sys-
tem32\drivers\etc\hosts file.
10.4. Installation Troubleshooting - ANSYS CFX

The items listed below apply only to the ANSYS CFX products.
10.4.1. TurboGrid Mouse Behavior Problems

Depending on the graphics card and driver version, you may experience problems with the accuracy
of mouse clicks in the 3D Viewer. For example, you may try to insert a control point at a given location
by using the mouse, but the control point appears at a location far from where you clicked the mouse.
If you experience such problems, try lowering the hardware acceleration setting of your graphics card.


locations.
Chapter 11: 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 What is Included?

Install
Option
ANSYS, Inc. Products
Discovery
AIM -aim Workbench [1], ANSYS AIM, ANSYS Polyflow
(without ANSYS CFD-Post)
Live -live Workbench [1], ANSYS Discovery Live, ANSYS
SpaceClaim
SpaceClaim -spaceclaim Workbench [1], ANSYS SpaceClaim
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 -fluent Workbench [1], Fluent, CFD-Post
CFD-Post)
Forte -forte Workbench [1], Forte
Polyflow (includes ANSYS -polyflow Workbench [1], CFD-Post, Polyflow, Fluent
CFD-Post)
TurboGrid -turbogrid Workbench [1], TurboGrid
ICEM CFD -icemcfd Workbench [1], ICEM CFD
Offshore
Aqwa -aqwa Workbench [1], Aqwa
Structural Mechanics
Applications Included with Each Product
Product Install Option Silent What is Included?

Install
Option
Customization Files -ansyscust Workbench [1], Mechanical APDL
User-Programmable Feature
Mechanical Products -mechapdl Workbench [1], Mechanical APDL2, ANSYS
Composite PrepPost
ANSYS Additional Tools
Icepak (includes ANSYS -icepak CFD-Post, Icepak
CFD-Post)
Remote Solve Manager Stand -rsm Remote Solve Manager
Alone Services
Viewer -aview ANSYS Viewer
ANSYS Geometry Interfaces
ACIS Geometry Interface -acis Geometry Interface for ACIS
AutoCAD Geometry Interface -acad Geometry Interface for AutoCAD
CATIA, Version 4 Geometry -catia4 Geometry Interface for CATIA, Version 4
Interface
Interface
Interface
Creo Elements/Direct Modeling -cocreate Geometry Interface for Creo Elements/Direct
Geometry Interface Modeling
Creo Parametric Geometry -proe_reader, Geometry Interface for Creo Parametric (formerly
Interface (formerly -proe_plugin Pro/ENGINEER)
Pro/ENGINEER)
Inventor Geometry Interface -adinventor Geometry Interface for Inventor
JTOpen Geometry Interface -jtopen Geometry Interface for JTOpen
NX Geometry Interface -ug_reader, Geometry Interface for NX
-ug_plugin
Parasolid Geometry Interface -parasolid Geometry Interface for Parasolid
Solid Edge Geometry Interface -solidedge Geometry Interface for Solid Edge
SOLIDWORKS Geometry -solidworks Geometry Interface for SOLIDWORKS
Interface
1. Workbench includes the Workbench Framework, DesignModeler, DesignXplorer, SpaceClaim Direct

Modeler, SpaceClaim CATIA V5 Interface, ECAD and Remote Solve Manager.
2. As of Release 17.0 the MechASAS package is no longer installed with the ANSYS Mechanical Products.
This package is required when using BEAMCHECK and FATJACK assessment types with Design Assessment.
If you need the MechASAS package, download it from the ANSYS customer site.
Configuring High Performance Computing

2600 ANSYS Drive ANSYS, Inc. and
Canonsburg, PA 15317 ANSYS Europe,
Ltd. are UL
ansysinfo@ansys.com registered ISO
http://www.ansys.com 9001: 2015
(T) 724-746-3304 companies.
(F) 724-514-9494
The information in this guide applies to all ANSYS, Inc. products released on or after this date, until superceded
Disclaimer Notice

Table of Contents
Configuring Distributed ANSYS ..................................................................................................................... 1
1. Setting up Distributed ANSYS .............................................................................................................. 1
1.1. Prerequisites for Running Distributed ANSYS ............................................................................... 1
1.1.1. MPI Software ..................................................................................................................... 2
1.1.2. Installing the Software ....................................................................................................... 2
1.2. Setting Up the Cluster Environment for Distributed ANSYS .......................................................... 3
1.2.1. Optional Setup Tasks .......................................................................................................... 5
1.2.2. Using the mpitest Program ............................................................................................. 5
1.2.3. Interconnect Configuration ................................................................................................ 6
2. Running a Distributed Job ................................................................................................................... 6
Configuring ANSYS CFX Parallel .................................................................................................................... 7
1. ANSYS CFX Linux Parallel Setup ........................................................................................................... 7
1.1. Setting Up Remote Access on Linux ............................................................................................ 7
1.1.1. Testing Remote Access ....................................................................................................... 7
1.1.2. Set Up of ssh ...................................................................................................................... 8
1.1.3. Global Set Up of rsh ........................................................................................................... 8
1.1.4. Individual User Set Up for rsh ............................................................................................. 8
1.2. hostinfo.ccl File ........................................................................................................................... 8
1.2.1. Adding Hosts for Parallel Processing with the cfx5parhosts Utility ...................................... 10
1.3. Using Intel MPI (Message Passing Interface Library) ................................................................... 11
1.3.1. Environment Variables ...................................................................................................... 12
1.3.2. Network Fabrics Selection ................................................................................................ 12
1.4. Using IBM MPI (Message Passing Interface Library) .................................................................... 13
1.4.1. Environment Variables ...................................................................................................... 13
1.4.2. Interconnect Selection ..................................................................................................... 14
1.5. Using Cray MPI (Message Passing Interface Library) ................................................................... 15
1.5.1. Cray MPI Options ............................................................................................................. 15
2. ANSYS CFX Windows Parallel Setup .................................................................................................... 15
2.1. Parallel Setup for Windows ........................................................................................................ 15
2.1.1. hostinfo.ccl file ................................................................................................................. 16
2.1.1.1. Adding Hosts for Parallel Processing with the cfx5parhosts Utility ............................. 18
2.2. Setting Up Intel MPI for Windows .............................................................................................. 19
2.2.1. Enabling Intel MPI Parallel Through a Windows Firewall ..................................................... 19
2.3. Setting Up IBM MPI for Windows ............................................................................................... 20
2.3.1. Enabling IBM MPI Parallel Through a Windows Firewall ...................................................... 20
2.4. Setting up and Running Microsoft Windows HPC 2016 .............................................................. 21
IBM Platform MPI with High (>4096) Process Count ..................................................................................... 23
List of Tables
1. Products with Limited HPC Functionality ................................................................................................... 1
2. Platforms and MPI Software ....................................................................................................................... 2
Configuring Distributed ANSYS
This section explains how to configure your network/cluster to run Distributed ANSYS. It is important
that you follow these steps in order to run successfully in a distributed environment.
You will need an ANSYS HPC license for each processor after the first four. For example, if you want to
run six processors, you will need two HPC licenses. Some products cannot use all HPC functionality, as
noted in the following table.
Table 1: Products with Limited HPC Functionality
Product Distributed SMP Capability VT Accelerator

ANSYS Capability
Capability
ANSYS Academic Yes 4 processors Yes
Teaching Products default limit
ANSYS LS-DYNA No No No
ANSYS DesignSpace No 2 processors No
max
1. Setting up Distributed ANSYS

This section describes the prerequisites, including software requirements, for running Distributed ANSYS
and the steps necessary to set up the environment for Distributed ANSYS.
The following topics are available:

1.1. Prerequisites for Running Distributed ANSYS
1.2. Setting Up the Cluster Environment for Distributed ANSYS
1.1. Prerequisites for Running Distributed ANSYS

Whether you are running on a single machine or multiple machines, the following condition is true:
• By default, Distributed ANSYS uses two cores and does not require any HPC licenses. Additional licenses will
be needed to run a distributed solution with more than four cores. Several HPC license options are available.
For more information, see HPC Licensing in the Parallel Processing Guide.
If you are running on a single machine, there are no additional requirements for running a distributed
solution.
If you are running across multiple machines (for example, a cluster), your system must meet these ad-
ditional requirements to run a distributed solution.
• Homogeneous network: All machines in the cluster must be the same type, OS level, chip set, and intercon-
nects.
• You must be able to remotely log in to all machines, and all machines in the cluster must have identical
directory structures (including the ANSYS 2019 R1 installation, MPI installation, and working directories). Do
not change or rename directories after you've launched ANSYS. For more information, see Directory Structure
Across Machines in the Parallel Processing Guide.
• All machines in the cluster must have ANSYS 2019 R1 installed, or must have an NFS mount to the ANSYS
2019 R1 installation. If not installed on a shared file system, ANSYS 2019 R1 must be installed in the same
directory path on all systems.
• All machines must have the same version of MPI software installed and running. The table below shows the
MPI software and version level supported for each platform.
1.1.1. MPI Software

The MPI software supported by Distributed ANSYS depends on the platform (see the table below).
The files needed to run Distributed ANSYS using Intel MPI or IBM Platform MPI are included on the in-
stallation media and are installed automatically when you install ANSYS 2019 R1. Therefore, when running
on a single machine (for example, a laptop, a workstation, or a single compute node of a cluster) on
Windows or Linux, or when running on a Linux cluster, no additional software is needed. However,
when running on multiple Windows machines (a cluster), you must install the MPI software separately
(see Installing the Software later in this section).
Table 2: Platforms and MPI Software
Platform MPI Software

Linux x86_64 Intel MPI 2017.3.196
IBM MPI 9.1.4.3
Windows 64-bit Windows 7 x64 Intel MPI 2017.3.210
/ Windows 10 x64 IBM MPI 9.1.4.3
Windows HPC Server 2016 x64 Microsoft HPC Pack (MS MPI v7.1)
1.1.2. Installing the Software

Install ANSYS 2019 R1 following the instructions in the ANSYS, Inc. Installation Guide for your platform.
Be sure to complete the installation, including all required post-installation procedures.
To run Distributed ANSYS on a cluster, you must:
• Install ANSYS 2019 R1 on all machines in the cluster, in the exact same location on each machine.
• For Windows, you can use shared drives and symbolic links. Install ANSYS 2019 R1 on one Windows
machine (for example, C:\Program Files\ANSYS Inc\V193) and then share that installation
folder. On the other machines in the cluster, create a symbolic link (at C:\Program Files\ANSYS
Inc\V193) that points to the UNC path for the shared folder. On Windows systems, you must use the
Universal Naming Convention (UNC) for all file and path names for Distributed ANSYS to work correctly.
• For Linux, you can use the exported NFS file systems. Install ANSYS 2019 R1 on one Linux machine (for
example, at /ansys_inc/v193), and then export this directory. On the other machines in the cluster,
create an NFS mount from the first machine to the same local directory (/ansys_inc/v193).
Setting up Distributed ANSYS
Installing MPI software on Windows

You can install Intel MPI or IBM MPI from the installation launcher by choosing Install MPI for ANSYS,
Inc. Parallel Processing. For installation instructions, see the following sections in the ANSYS, Inc.
Windows Installation Guide:
Intel-MPI 2017.3.210 Installation Instructions

IBM MPI 9.1.4.3 Installation Instructions
Microsoft HPC Pack (Windows HPC Server 2016)

You must complete certain post-installation steps before running Distributed ANSYS on a Microsoft
HPC Server 2016 system. The post-installation instructions provided below assume that Microsoft HPC
Server 2016 and Microsoft HPC Pack (which includes MS MPI) are already installed on your system. The
post-installation instructions can be found in the following README files:
Program Files\ANSYS Inc\V193\commonfiles\MPI\WindowsHPC\README.mht
or
Program Files\ANSYS Inc\V193\commonfiles\MPI\WindowsHPC\README.docx
Microsoft HPC Pack examples are also located in Program Files\ANSYS Inc\V193\common-
files\MPI\WindowsHPC. Jobs are submitted to the Microsoft HPC Job Manager either from the
command line or the Job Manager GUI.
To submit a job via the GUI, go to Start> All Programs> Microsoft HPC Pack> HPC Job Manager.
Then click on Create New Job from Description File.
1.2. Setting Up the Cluster Environment for Distributed ANSYS

After you've ensured that your cluster meets the prerequisites and you have ANSYS 2019 R1 and the
correct version of MPI installed, you need to configure your distributed environment using the following
procedure.
1. Obtain the machine name for each machine on the cluster.
Windows 7:
From the Start menu, click Computer, then click on System properties. The full computer name is
listed. Note the name of each machine (not including the domain).
Windows 10 and Windows Server 2016:

From the Start menu, pick Settings >System >About. The full computer name is listed under PC
Name. Note the name of each machine (not including the domain).
Linux:
Type hostname on each machine in the cluster. Note the name of each machine.
2. Linux only: First determine if the cluster uses the secure shell (ssh) or remote shell (rsh) protocol.
• For ssh: Use the ssh-keygen command to generate a pair of authentication keys. Do not enter a pass-
phrase. Then append the new public key to the list of authorized keys on each compute node in the
cluster that you wish to use.
• For rsh: Create a .rhosts file in the home directory. Add the name of each compute node you wish
to use on a separate line in the .rhosts file. Change the permissions of the .rhost file by issuing:
chmod 600 .rhosts. Copy this .rhosts file to the home directory on each compute node in the
cluster you wish to use.
Verify communication between compute nodes on the cluster via ssh or rsh. You should not be prompted
for a password. If you are, correct this before continuing. For more information on using ssh/rsh without
passwords, search online for "Passwordless SSH" or "Passwordless RSH", or see the man pages for ssh or
rsh.
3. If you want the list of machines to be populated in the Mechanical APDL Product Launcher, you need to
configure the hosts193.ans file. You can use the ANS_ADMIN utility to configure this file. You can
manually modify the file later, but we strongly recommend that you use ANS_ADMIN to create this file
initially to ensure that you establish the correct format.
Windows 7:
Start >All Programs >ANSYS 2019 R1 >Utilities >ANS_ADMIN 2019 R1
Windows 10 and Windows Server 2016:

Start >All apps >ANSYS 2019 R1 >ANS_ADMIN 2019 R1
Linux:
/ansys_inc/v193/ansys/bin/ans_admin193
The ANS_ADMIN interface is similar for Windows and Linux:
• Choose ANSYS/Workbench Configure Cluster to configure the hosts193.ans file.
• Under Select file to configure, choose the hosts193.ans file to be configured and choose
Configure for Distributed ANSYS. Click OK.
• Enter the system name (from Step 1) in the Machine hostname field and click Add. On the next
dialog box, enter the system type in the Machine type drop-down, and the number of cores in
the Max number of jobs/processors field. Click Add. Repeat this step for each machine in the
cluster.
• When you are finished adding machines, click Close then File > Exit.
The hosts193.ans file should be located in your current working directory, your home directory,
or the apdl directory. All three locations are equally valid; the location should be chosen based
on user preference.
4. Windows only: Verify that all required environment variables are properly set. If you followed the post-
installation instructions described above for Microsoft HPC Pack (Windows HPC Server), these variables
should be set automatically.
On the head node, where ANSYS 2019 R1 is installed, check these variables:
ANSYS193_DIR=C:\Program Files\ANSYS Inc\v193\ansys
ANSYSLIC_DIR=C:\Program Files\ANSYS Inc\Shared Files\Licensing
where C:\Program Files\ANSYS Inc is the location of the product install and C:\Program
Files\ANSYS Inc\Shared Files\Licensing is the location of the licensing install. If your
installation locations are different than these, specify those paths instead.
Setting up Distributed ANSYS
On Windows systems, you must use the Universal Naming Convention (UNC) for all ANSYS, Inc.
environment variables on the compute nodes for Distributed ANSYS to work correctly.
On the compute nodes, check these variables:
ANSYS193_DIR=\\head_node_machine_name\ANSYS Inc\v193\ansys
ANSYSLIC_DIR=\\head_node_machine_name\ANSYS Inc\Shared Files\Licensing
5. Windows only: Share out the ANSYS Inc directory on the head node with full permissions so that the
compute nodes can access it.
1.2.1. Optional Setup Tasks

The tasks explained in this section are optional. They are not required to get Distributed ANSYS to run
correctly, but they may be useful for achieving the most usability and efficiency, depending on your
system configuration.
On Linux systems, you can also set the following environment variables:
• ANSYS_NETWORK_START - This is the time, in seconds, to wait before timing out on the start-up of
the client (default is 15 seconds).
• ANSYS_NETWORK_COMM - This is the time to wait, in seconds, before timing out while communicating
with the client machine (default is 5 seconds).
• ANS_SEE_RUN_COMMAND - Set this environment variable to 1 to display the actual command issued
by ANSYS.
On Windows systems, you can set the following environment variables to display the actual command
issued by ANSYS:
• ANS_SEE_RUN = TRUE
• ANS_CMD_NODIAG = TRUE
1.2.2. Using the mpitest Program

The mpitest program performs a simple communication test to verify that the MPI software is set up
correctly. The mpitest program should start without errors. If it does not, check your paths and per-
missions; correct any errors and rerun.
When running the mpitest program, you must use an even number of processes. We recommend you
start with the simplest test between two processes running on a single node. This can be done via the
procedures outlined here for each platform and MPI type.
The command line arguments -np, -machines, and -mpifile work with the mpitest program in
the same manner as they do with Distributed ANSYS (see Starting Distributed ANSYS via Command
Line).
On Linux:
For Intel MPI (default), issue the following command:

mpitest193 -np 2
which is equivalent to:

mpitest193 -machines machine1:2
For IBM MPI, issue the following command:

mpitest193 -mpi ibmmpi -np 2

mpitest193 -mpi ibmmpi -machines machine1:2
On Windows:
For Intel MPI (default), issue the following command:

ansys193 -np 2 -mpitest

ansys193 -machines machine1:2 -mpitest
For IBM MPI, issue the following command:

ansys193 -mpi ibmmpi -np 2 -mpitest

ansys193 -mpi ibmmpi -machines machine1:2 -mpitest
1.2.3. Interconnect Configuration

Using a slow interconnect reduces the performance you experience in a distributed parallel simulation.
For optimal performance, we recommend an interconnect with a high communication bandwidth (2000
megabytes/second or higher) and a low communication latency (5 microseconds or lower). This is due
to the significant amount of data that must be transferred between processes during a distributed
parallel simulation.
Distributed ANSYS supports the following interconnects. Not all interconnects are available on all plat-
forms; see the Platform Support section of the ANSYS Website for a current list of supported intercon-
nects. Other interconnects may work but have not been tested.
• InfiniBand (recommended)
• Omni-Path (recommended)
• GigE
On Windows x64 systems, use the Network Wizard in the Compute Cluster Administrator to configure
your interconnects. See the Compute Cluster Pack documentation for specific details on setting up the
interconnects. You may need to ensure that Windows Firewall is disabled for Distributed ANSYS to work
correctly.
2. Running a Distributed Job

For information on running Distributed ANSYS after you have your environment configured, see the
Parallel Processing Guide.
For more information on using Distributed ANSYS, see the Parallel Processing Guide.
Configuring ANSYS CFX Parallel
If you have purchased the ANSYS CFX-Solver parallel option, you will need to follow the procedures in
this chapter to ensure that users can execute ANSYS CFX jobs in parallel. Parallel communication
methods are available that use MPI (Message Passing Interface). Platform-specific versions of MPI are
available in some instances.
The ANSYS CFX-Solver parallel option is supported on all platforms that support the CFX-Solver.
1. ANSYS CFX Linux Parallel Setup

The following are required in order for you to execute ANSYS CFX parallel:
• The ANSYS CFX-Solver must be installed on both master and slave nodes.
• To run distributed parallel (where slave processes run on a different host to the master process), remote or
secure shell access must be available from the master nodes (systems on which parallel runs will be started)
to slave nodes (systems on which the ANSYS CFX-Solver will actually run). See Setting Up Remote Access
on Linux (p. 7), below.
• You must have the same user name on all systems.
• The hostinfo.ccl file should be set up, as described in hostinfo.ccl File (p. 8).
1.1. Setting Up Remote Access on Linux

Each system that will be used as a slave node must be configured to allow access via remote shell
commands from the master node. This can be done globally for all users or on a per-user basis.
Often, networks where ssh, rsh or rlogin are used frequently will already be configured to allow remote
access to all users. If this is the case, nothing more must be done.
The CFX5RSH environment variable is used to select the remote shell protocol. By default, CFX5RSH=ssh
is set. If you want to use rsh, then set CFX5RSH=rsh either in the environment or in the cfx5rc file
(see Resources Set in cfx5rc Files in the CFX Introduction).
In either case, ssh or rsh, the remote machine must not prompt for a password when you run remote
commands.
1.1.1. Testing Remote Access

You can test remote access using ssh using the command:
ssh unixhost echo working
You can test remote access using rsh for a Linux slave node using the command:
rsh unixhost echo working
1.1.2. Set Up of ssh

If you use ssh for remote access, consult your system documentation on how to set up ssh between
machines so that it does not require the user to enter a password.
1.1.3. Global Set Up of rsh

This method, which is used to allow remote access for all users, depends on whether NIS is used to
maintain netgroups, as well as common password and group databases. If this is not the case, then you
should log in to each slave node as root and create a file called /etc/hosts.equiv containing a
line:
<master>
where <master> is the hostname of the master node. See your system documentation for more in-
formation about the use of rsh and the syntax of the hosts.equiv file.
If NIS is used to control remote access, then a netgroup must be created for users of ANSYS CFX by the
root user on the NIS master server, and a line such as the one below added to /etc/hosts.equiv
on each slave node by the root user:
+@<netgroup>
where <netgroup> is the name of a netgroup to which users of ANSYS CFX belong. A detailed descrip-
tion of how to configure NIS is beyond the scope of this manual. See your system documentation for
more information about NIS.
1.1.4. Individual User Set Up for rsh

Individual users can create a file called .rhosts in their home directory on each slave containing a
line:
<master> <user>
where <master> is the hostname of the master and <user> is their username on the master. This
file should be made readable only by the user, for example, by running:
chmod 600 ~/.rhosts
1.2. hostinfo.ccl File

In order to use the Distributed Parallel mode of ANSYS CFX, the file hostinfo.ccl must exist in the
<CFXROOT>/config/ directory of the ANSYS CFX installation on the master node and be made
readable by all users of the software. This file is a database containing information about the available
hosts and where ANSYS CFX has been installed on each of them. The file is used by the ANSYS CFX-
Solver when constructing a parallel run.
This file is written using the CFX Command Language. It defines a set of HOST DEFINITION objects, one
for each available node. For example:
SIMULATION CONTROL:
EXECUTION CONTROL:
PARALLEL HOST LIBRARY:
HOST DEFINITION: kangaroo
Installation Root = /ansys_inc/v%v/CFX
END
HOST DEFINITION:wallaby
Installation Root = /usr/local/cfx
Host Architecture String = linux-amd64
ANSYS CFX Linux Parallel Setup
Number of Processors = 16
Relative Speed = 1.7
END
HOST DEFINITION: mypc
Remote Host Name = my_pc
END
END
END
END
Note
If you manually create your hostinfo.ccl file, you must ensure that the SIMULATION
CONTROL...END wrapper is present.
None of the values for each host are mandatory, and the following empty host definition is perfectly
valid:
HOST DEFINITION: parakeet
END
Host names are limited to the set of valid CCL object names. In particular, they must not contain full
stops (.) or underscores (_) and must start with a letter.
If a hostinfo.ccl file does not already exist when ANSYS CFX is installed, one will be created con-
taining the installation host. You can add hosts to the hostinfo.ccl file using the cfx5parhosts
utility, or by modifying the file using a text editor. Individual users may also create their own versions
of this file in:
~/.hostinfo.ccl
which will be used in preference if it exists.
For most installations, it will be necessary to supply only the Installation Root parameter, which should
point to the <CFXROOT> directory in which ANSYS CFX is installed. On mixed architectures, you may
find it useful to supply the Number of Processors and/or Relative Speed parameters. A little time may
be saved at startup by giving the Host Architecture String parameter explicitly, for example, using the
cfx5parhosts utility.
Tip
If an individual user wants to use a host that is not present in either the hostinfo.ccl
in the installation config directory or the user's own version of this file, then the user can
add this host to the list for a particular run by using the CFX-Solver Manager. However, this
would have to be done each time a run is started.
The available parameters for the hostinfo.ccl file are as follows:
Installation Root
This is set to the <CFXROOT> installation directory on this host. If it is set to the special string none, this
indicates that there is no ANSYS CFX installation on the remote host, which can sometimes be useful if
only the solver binary is available.
Host Architecture String

ANSYS CFX will use this value to select the most appropriate solver executable for this node. These strings
can be obtained by giving the command <CFXROOT>/bin/cfx5info -os on the node in question.
When these short os values (for example, linux-amd64) are given in this position, the generic solver ex-
ecutable will always be used for this host. The string can also be set to the actual architecture of the remote
host (for example, intel_xeon64.sse2_linux2.3.4), which is determined by giving the command <CFX-
ROOT>/bin/cfx5info -arch. If these longer strings are used then CFX could use this information to
select between solvers optimized for specific architectures. However, since there are currently no solvers
optimized for specific architectures, this extra information is currently unused.
Number of Processors
As implied, this is the number of processors on the machine. It is used for display purposes only and can
be safely omitted.
Relative Speed
The Relative Speed is a real number that is used by the ANSYS CFX-Solver when partition sizes are calculated.
The ratio of relative speeds of each host is used to determine the size of each partition. As an example,
consider a parallel run involving two machines, one with a relative speed of 2.0 and the other with a relative
speed of 1.0. The faster machine would work on a partition size twice as large as the slower machine in
this case.
The numbers themselves are arbitrary; as a guide you may want to set 1.0 for a 1 GHz processor,
0.75 for a 750 MHz processor, and so on. If a relative speed entry is not entered, a default of 1.0 is
assumed for that host.
You can obtain relative speed values using the cfx5parhosts utility.
Remote Host Name

To include hosts in the parallel run with names that contain, for example, underscore characters, you can
add the “Remote Host Name” parameter to the HOST DEFINITION with the correct network name for the
host and use a readable alias as the name of the object.
Solver Executable
A solver executable may be explicitly supplied, if necessary. This is usually only required when using Install-
ation Root = none, and is recommended for advanced users only. The following substitutions are made
on the string:
%r root directory of the installation

%p parallel suffix for the executable
%v version of ANSYS CFX being run
%o operating system string
%a architecture subdirectory specification; for example,
linux/double
If it is not supplied, this parameter has the default value %r/bin/%a/solver%p.exe
1.2.1. Adding Hosts for Parallel Processing with the cfx5parhosts Utility
You can add new hosts to ANSYS CFX's database for parallel runs using the cfx5parhosts utility:
CFXROOT\bin\cfx5parhosts argument list
where argument list corresponds to one or more of the arguments listed below:
Argument Description
-add host[,host,...] Add information about the named hosts to the file. This assumes that
ANSYS CFX is installed in the same directory on each listed host as on the
host on which you are running.
host may be specified as [user@]hostname[:cfx-5 root] if the user name

or the ANSYS CFX installation root directory differs from the local host.
-benchmark Runs a standard benchmark case, and fills in the Relative Speed for the
local host. The benchmark case will usually take less than 5 minutes to
run.
-file file Use the specified file as the hostinfo.ccl file.
-merge file Merge host information from the named file.
-no-update After modifying the file, write back the information available without attempting
to fill in any missing pieces.
-strict Used with -update. Normally, hosts which exist on the network but cannot
be connected to with rsh or ssh are included in the resulting file with a
comment. This switch will exclude these hosts.
-system Use the system host file. This is the default.
-update Updates the specified host information file. If any hosts do not have an
architecture specified in the existing hostinfo.ccl file (for example, because
it was added via the -add switch), it will connect to the host and query it to
fill in the Host Architecture String parameter. This is the default behavior. Note
that if the Installation Root parameter is incorrect for the host, it will use the
standard system commands to guess a generic architecture string. This can
happen if you use -add to include a host with a different installation directory
than the local one.
-user Use the per-user host file.
1.3. Using Intel MPI (Message Passing Interface Library)

Most Linux systems support two parallel run modes: Intel MPI and IBM MPI. Intel MPI is the preferred
parallel run mode on most of the supported ANSYS CFX platforms.
Intel MPI supports several network fabrics including:
• Shared memory, typically used for intra-host communication.
• DAPL-capable network fabrics, such as Infiniband, iWarp, Dolphin and XPMEM (through DAPL).
• TCP/IP-capable network fabrics, such as Ethernet and InfiniBand (through IPoIB).
• TMI-capable network fabrics including Qlogic and Myrianet (through Tag Matching Interface).
• OFA-capable network fabrics including InfiniBand (through OFED verbs).
Intel MPI is automatically installed with ANSYS CFX in the<CFXROOT>/../commonfiles/ directory.

You do not need a license from Intel to run the ANSYS CFX-Solver using Intel MPI.
Intel MPI run modes are selected in the ANSYS CFX-Solver Manager or on the command line (using the
-start-method command line option) using the “Intel MPI Local Parallel” or “Intel MPI Distributed Parallel”
start method options.
1.3.1. Environment Variables

In most cases, the default settings are sufficient and it may not be necessary to set any environment
variables.
ANSYS CFX uses the environment variable CFX5_IMPI_DIR to select which Intel MPI installation is used.
The default setting points to the version that is automatically installed by ANSYS CFX in the<CFX-
ROOT>/../commonfiles/MPI/Intel directory. You can use cfx5info -v to find the current settings
for CFX5_IMPI_DIR and other environment variables. If you want to use a different Intel MPI version,
you can install that version in an alternative location and set CFX5_IMPI_DIR to that location.
There are several environment variables that can be used to control Intel MPI that may provide addi-
tional flexibility that is not directly accessible through the ANSYS CFX start-up scripts. For example,
environment variables are available for network fabric selection (discussed briefly below), process pinning
control, and collective operation control.
Any of these environment variables can be set by modifying the start command in the etc/start-
methods.ccl file and using the Intel MPI options -env and/or -genv (an example of this usage is
given in the section on network fabric selection). More detail on all options and environment variables
is available in the Intel MPI documentation.
Some useful environment variables include those described below. If these environment variables are
set the start-up scripts automatically set them for your ANSYS CFX runs.
I_MPI_MPD_REMSH
Specifies which method is used by Intel MPI to spawn jobs on remote machines. The Intel MPI default is
ssh. However, by default the ANSYS CFX software sets this to be the same as the setting used for CFX5RSH,
and rsh if CFX5RSH is not set. This variable is applicable only to Linux.
I_MPI_FABRICS and I_MPI_FABRICS_LIST

Specifies the networks fabrics to be used and the order in which Intel MPI searches for them.
1.3.2. Network Fabrics Selection

Intel MPI start methods use the default network fabrics selection built into Intel MPI. The default order
in which Intel MPI checks for fabrics is DAPL, OFA, TCP, TMI. The environment variable I_MPI_FABRICS_LIST
controls the search order used by Intel MPI.
If you want to force selection of a specific network fabric, then you can either set the I_MPI_FABRICS
environment variable or modify the start command in the etc/start-methods.ccl file and add
the necessary command line flags (for example: -env IMPI_FABRICS shm:dapl to select the combination
of shared memory and DAPL fabrics) .
The following table shows how Intel MPI searches for drivers for the various network fabrics:
Interconnect 1st attempt 2nd attempt

shm N/A N/A
Interconnect 1st attempt 2nd attempt

DAPL Environment variable libdat.so or libdat.so.1 for DAPL 1.2 providers
I_MPI_DAT_LIBRARY and libdat2.so or libdat2.so.1 for DAPL 1.2
providers
TCP N/A N/A
TMI Environment variable I_MPI_TMI_LIBRARY libtmi.so
OFA Environment variable libibverbs.so
I_MPI_OFA_LIBRARY
For example, Intel MPI expects that the DAT shared library for the DAPL network fabric is located either
in the default library search path or in a specific location if a full path is specified. If the shared library
cannot be found, Intel MPI will not take advantage of the DAPL network fabric. To fix this, you will have
to install the shared libraries into the correct location or set the environment variable I_MPI_DAT_LIBRARY
to point to the correct DAT shared library.
There are other environment variables not documented here which provide further control over network
fabrics selection. These are described in the Intel MPI documentation.
1.4. Using IBM MPI (Message Passing Interface Library)

IBM MPI is available as an alternative parallel run mode on all the supported ANSYS CFX platforms.
IBM MPI supports several communication modes including shared memory and networked TCP/IP
(Ethernet), luDAPL, VAPI, OpenFabrics (IB), GM-2, MX (Myrinet), Elan4 (Quadrics), QLogic InfiniPath, and
EtherFabric (Level 5 Networks).
IBM MPI is automatically installed with ANSYS CFX in the <CFXROOT>/tools directory. You do not
need a license from IBM to run the ANSYS CFX-Solver using IBM MPI.
IBM MPI run modes are selected in the ANSYS CFX-Solver Manager or on the command line (using the
-start-method command line option) using the “IBM MPI Local Parallel” or “IBM MPI Distributed
Parallel” start method options.
For IBM MPI, the –cpu_bind option is used by default and binds processes to cores using a cyclic order.
This leads to better performance but, on multi-user clusters having scheduling systems that do not
enforce exclusive use of cluster nodes, may cause problems because multiple jobs may be bound to
the same CPU on the same node. In this case, the –cpu_bind argument to mpirun should be removed
from the IBM MPI start methods in the <CFXROOT>/etc/start_methods.ccl file.
1.4.1. Environment Variables

In most cases, the default settings are sufficient and it may not be necessary to set any environment
variables.
ANSYS CFX uses the environment variable CFX5_IBMMPI_DIR to select which IBM MPI installation is
used. The default setting points to the version that is automatically installed with ANSYS CFX in the
<CFXROOT>/../commonfiles/MPI/IBM directory. You can use cfx5info -v to find the current settings
for CFX5_IBMMPI_DIR and other environment variables. If you want to use a different IBM MPI version,
you can install that version in an alternative location and set CFX5_IBMMPI_DIR to that location. For
distributed parallel runs, IBM MPI must be present at the same location (same absolute path) on all
hosts. Typically, this is achieved by using a central ANSYS CFX installation, accessible by all hosts. In
order to run a CFX job in distributed parallel using IBM MPI on hosts with different CFX installation
locations, you must first install IBM MPI under the same location (same absolute path) on each host,
then set the environment variable CFX5_IBMMPI_DIR to the location under which IBM MPI was installed.
There are several environment variables that can be used to control IBM MPI (documented in the IBM
MPI documentation) that may provide additional flexibility not directly accessible through the ANSYS
CFX startup scripts. If these environment variables are set the startup scripts automatically set them for
your ANSYS CFX runs. Some useful environment variables include:
MPI_REMSH
Enables you to change which method is used by IBM MPI to spawn jobs on remote machines. The IBM MPI
default is ssh. However, by default the ANSYS CFX software sets this to be the same as the setting used
for CFX5RSH, and rsh if CFX5RSH is not set. This variable is applicable only to Linux and HP-UX.
MPI_IC_ORDER
Enables you to change the default order in which IBM MPI searches for interconnects.
1.4.2. Interconnect Selection

IBM MPI start methods use the default communication mode selection built into IBM MPI. The default
order in which IBM MPI checks for interconnects is OpenFabric, VAPI, UDAPL, ITAPI, PSM, Myrinet MX,
Myrinet GM, Elan, TCP/IP.
If you want to force selection of a specific device, then you can either modify the start command in the
etc/start-methods.ccl file and add the necessary command line flags (for example: -GM to force
selection of the Myrinet interconnect) or use the appropriate IBM MPI environment variables.
Some useful command line options include forcing other interconnect types (-TCP, -HMP, -ELAN, -ITAPI,
-VAPI, -UDAPL, and so on), using prun on systems with quadrics support (-prun), XC support (-srun) and
setting the subnet you want to use (-subnet, sometimes useful for selecting particular interconnects as
well if your system is configured that way).
For some Linux-based cluster environments not supported by IBM MPI, it is possible that the Myrinet,
Infiniband or Quadrics hardware drivers are not located where IBM MPI expects. If IBM MPI cannot detect
the drivers for fast interconnects, it will generally default back to the lowest speed connection that it
can detect (usually TCP/IP socket communication).
The following table gives information on the default search path IBM MPI uses to find drivers for the
various communication interfaces:
Interconnect 1st attempt 2nd attempt 3rd attempt

Infiniband Environment variable libitapi.so /usr/voltaire/lib/libitapi.so
(IB) MPI_ICLIB_ITAPI
Myrinet Environment variable libgm.so OR libgm32.so /opt/gm/lib/libgm.so OR
(GM) MPI_ICLIB_GM /opt/gm/lib/libgm32.so
ELAN Environment variable libelan.so none
MPI_ICLIB_ELAN
UDAPL Environment variable libdat.so none
MPI_ICLIB_UDAPL
VAPI Environment variable Environment variable libmtl_common.so,
MPI_ICLIB_VAPI MPI_ICLIB_VAPIDIR libmpga.so, libmosal.so,
libvapi.so
ANSYS CFX Windows Parallel Setup
Interconnect 1st attempt 2nd attempt 3rd attempt

Infinipath Environment variable libpsm_infinipath.so.1 /usr/lib64/
MPI_ICLIB_PSM libpsm_infinipath.so.1
For example, IBM MPI expects that GM stack shared libraries for Myrinet interconnects are located either
in the default library search path or in the /opt/gm/lib64 (64 bit x86) directories. If the shared libraries
are not in either location, IBM MPI will not take advantage of the high-speed interconnects. To fix this,
you will have to copy the shared libraries into the correct location or set the environment variable
MPI_ICLIB_GM to point to the correct GM stack shared library.
1.5. Using Cray MPI (Message Passing Interface Library)

The ANSYS CFX-Solver supports Cray’s native implementation of MPI on the Cray Linux Environment
(CLE) using the start method ‘Cray MPI Distributed Parallel’.
Cray MPI is closely integrated with the batch queuing system and interconnects used on Cray systems.
Cray MPI is the recommended method of running on Cray systems, as opposed to using Cluster Com-
patibility Mode (CCM) with a different MPI.
When starting a solver run, the Cray MPI start method may be specified on the command line using
the option: -start-method “Cray MPI Distributed Parallel”, having reserved the required
processing elements via the built-in batch queuing system.
1.5.1. Cray MPI Options

The aprun command, which can be modified, is used by the start method to launch the job. Other
options available from Cray are described in the documentation for aprun.
Note that numa node memory containment is enforced, using the -ss option. The default method
used by Cray MPI to allocate processes to CPU cores is appropriate when all cores are used. However,
if it is intended that each host is only partly utilized (for example, because of the memory requirements
of the run), this can result in asymmetric utilization. In such cases, the -S option can be used to limit
the number of processes per numa node. For example, -S 4 would limit the number of processes per
numa node to 4.
2. ANSYS CFX Windows Parallel Setup

ANSYS CFX-Solver must be installed on all hosts that are to be used for a parallel run.
Local parallel runs use Intel MPI (default) or IBM MPI for communication.
To run distributed parallel (where slave processes run on hosts other than the host with the master
process), the desired MPI service must be installed, configured, and started on all involved hosts. In
addition, you must make host information available to the master host. These tasks are discussed in
Setting Up IBM MPI for Windows (p. 20) or Setting Up Intel MPI for Windows (p. 19).
2.1. Parallel Setup for Windows

When the ANSYS CFX distributed parallel starts, it needs to know where to find the CFX-Solver executable
on every host. You must make host information available to the master host by one of these mechanisms:
• (Preferred mechanism) The hostinfo.ccl file on the master host is configured with any required inform-
ation about slave hosts.
The hostinfo.ccl file registers information such as the Installation Root and Host Ar-
chitecture String parameters for hosts used for distributed parallel runs. The hostinfo.ccl
file is created automatically when installing ANSYS CFX. By default, it contains details of the host on
which it is installed.
For hosts that have the same architecture as the machine that runs the master process, registration
in the hostinfo.ccl file is optional; if a particular host is not specified then all of its properties
are assumed to be the same as those of the machine that runs the master process.
For machines that have a machine architecture different from the machine that runs the master
process, the hostinfo.ccl file must include information about the properties that differ from
those of the machine that runs the master process.
See hostinfo.ccl file (p. 16) for more information.
If your machine previously had ANSYS CFX installed, then ensure that remote host interrogation is
disabled either by deleting the environment variable CFX_SOLVE_DISABLE_REMOTE_CHECKS or
(equivalently) by setting that environment variable to a value of 1. This environment variable can be
specified in your Windows environment or your user cfx5rc.txt file or site cfx5rc.txt file. See
Resources Set in cfx5rc Files in the CFX Introduction for details.
• Have ANSYS CFX determine the required information for itself.
If ANSYS CFX is to determine the required information for itself, then remote- or secure-shell access
must be available from the master host (the system on which parallel runs will be started) to slave
hosts (systems on which the ANSYS CFX-Solver will actually run). You must be able to execute an rsh
or ssh command on the remote host without typing in your password. Unless you already have your
Windows systems set up to allow this type of access, this method of setting up distributed parallel
is not recommended.
You will also have to set the environment variable CFX_SOLVE_DISABLE_REMOTE_CHECKS to a

value of 0; this enables remote host interrogation. This environment variable can be specified in your
Windows environment or your user cfx5rc.txt file or site cfx5rc.txt file. See Resources Set
in cfx5rc Files in the CFX Introduction for details.
2.1.1. hostinfo.ccl file

In order to use the Distributed Parallel modes effectively, the file hostinfo.ccl must exist in the
<CFXROOT>/config/ directory of the ANSYS CFX installation on the master host and be made
readable by all users of the software. This file is a database containing information about the available
hosts and where ANSYS CFX has been installed on each of them. The file is used by the ANSYS CFX-
Solver when constructing a parallel run.
The hostinfo.ccl file is written using the CFX Command Language. It defines a set of HOST
DEFINITION objects, one for each available host. For example:
SIMULATION CONTROL:
EXECUTION CONTROL:
PARALLEL HOST LIBRARY:
HOST DEFINITION: hostname1
Installation Root = C:\Program Files\ANSYS Inc\v%v\CFX
Host Architecture String = winnt-amd64
END # HOST DEFINITION hostname1
END # PARALLEL HOST LIBRARY

END # EXECUTION CONTROL
END # SIMULATION CONTROL
Note
If you manually create your hostinfo.ccl file, you must ensure that the SIMULATION
CONTROL...END wrapper is present.
None of the values for each host are mandatory. For example, the following empty host definition is
perfectly valid:
HOST DEFINITION: hostname1
END
Host names are limited to the set of valid CCL object names. In particular, they must not contain full
stops (.) or underscores (_) and must start with a letter.
If a hostinfo.ccl file does not already exist when ANSYS CFX is installed, one will be created con-
taining the installation host. You can add hosts to the hostinfo.ccl file using the cfx5parhosts
utility, or by modifying the file using a text editor.
For most installations, it will be necessary only to supply the Installation Root parameter, which should
point to the <CFXROOT> directory in which ANSYS CFX is installed. On mixed networks, you may find
it useful to supply the Number of Processors and/or Relative Speed parameters. A little time may be
saved at startup by giving the Host Architecture String parameter explicitly, for example, using the
cfx5parhosts utility.
The available parameters are as follows:
Installation Root
This is set to the <CFXROOT> installation directory on this host. If it is set to the special string none, this
indicates that there is no ANSYS CFX installation on the remote host, which can sometimes be useful if
only the solver binary is available.
Host Architecture String

This should be set to the actual architecture <arch> of the remote host. ANSYS CFX will use this value to
select the most appropriate solver executable for this host. These strings can be obtained by giving the
command <CFXROOT>/bin/cfx5info -os on the host in question. If the shorter <os> values are
given in this position, the generic solver executable will always be used for this host.
Number of Processors
As implied, this is the number of processors on the machine. It is used for display purposes only and can
be safely omitted.
Relative Speed
The Relative Speed is a real number that is used by the ANSYS CFX-Solver when partition sizes are calculated.
The ratio of relative speeds of each host is used to determine the size of each partition. As an example,
consider a parallel run involving two machines, one with a relative speed of 2.0 and the other with a relative
speed of 1.0. The faster machine would work on a partition size twice as large as the slower machine in
this case.
The numbers themselves are arbitrary; as a guide you may want to set 1.0 for a 1 GHz processor,
0.75 for a 750 MHz processor, and so on. If a relative speed entry is not entered, a default of 1.0 is
assumed for that host.
You can obtain relative speed values using the cfx5parhosts utility.
Remote Host Name

To include hosts in the parallel run with names that contain, for example, underscore characters, you can
add the “Remote Host Name” parameter to the HOST DEFINITION with the correct network name for the
host and use a readable alias as the name of the object.
Solver Executable
A solver executable may be explicitly supplied, if necessary. This is usually only required when using Install-
ation Root = none, and is recommended for advanced users only. The following substitutions are made
on the string:
%r root directory of the installation

%p parallel suffix for the executable
%v version of ANSYS CFX being run
%o operating system string
%a architecture subdirectory specification, for example,
linux/double
If it is not supplied, this parameter has the default value %r/bin/%a/solver%p.exe
2.1.1.1. Adding Hosts for Parallel Processing with the cfx5parhosts Utility
You can add new hosts to ANSYS CFX's database for parallel runs using the cfx5parhosts utility; this is
done by running:
CFXROOT\bin\cfx5parhosts argument list
where argument list corresponds to one or more of the arguments listed below.
-add host[,host,...] Add information about the named host(s) to the file. This assumes that
ANSYS CFX is installed in the same directory on each listed host as on the
host on which you are running.
host may be specified as [user@]hostname[:cfx-5 root] if the user name

or the ANSYS CFX installation root directory differs from the local host.
To add a set of separately-installed Windows hosts to the hostinfo.ccl

file, where the installation may be in a different place on each host, the
recommended method is to gather the hostinfo.ccl files created on
each host by the installation process, and merge them together using the
-merge switch.
-benchmark Runs a standard benchmark case, and fills in the Relative Speed for the local
host. The benchmark case will usually take less than 5 minutes to run.
-file file Use the specified file as the hostinfo.ccl file.
-merge file Merge host information from the named file.
-no-update After modifying the file, write back the information available without attempting
to fill in any missing pieces.
-strict Used with -update. Normally, hosts that exist on the network but cannot be
connected to with rsh or ssh are included in the resulting file with a comment.
This switch will exclude these hosts.
-system Use the system host file. This is the default.
-update Updates the specified host information file. If any hosts do not have an
architecture specified in the existing hostinfo.ccl file (for example, because
it was added via the -add switch), it will connect to the host and query it to
fill in the Host Architecture String parameter. This is the default behavior. Note
that if the Installation Root parameter is incorrect for the host, it will use the
standard system commands to guess a generic architecture string. This can
happen if you use -add to include a host with a different installation directory
than the local one.
-user Use the per-user host file.
2.2. Setting Up Intel MPI for Windows

To install, configure, and start the Intel MPI service on a given host, install Intel MPI using the installation
launcher. After installing Intel MPI in this way, the software is configured and started. For more inform-
ation, see Product Installation with Client Licensing.
2.2.1. Enabling Intel MPI Parallel Through a Windows Firewall

To enable Intel MPI parallel processing through a Windows firewall:
1. Click Start and select Control Panel.
2. On the Control Panel dialog box, double-click Security Center.
3. Click Windows Firewall.
4. On the Windows Firewall dialog box, click the Exceptions tab and then click Add Program.
5. Browse to the following programs:
• For Intel MPI:
– <CFXROOT>\bin\<CFX5OS>\solver-mpi.exe
– <CFXROOT>\bin\<CFX5OS>\double\solver-mpi.exe
– <CFXROOT>\..\commonfiles\MPI\Intel\<version number>\winx64\bin\smpd.exe
– <CFXROOT>\..\commonfiles\MPI\Intel\<version number>\winx64\bin\mpiexec.exe
After each selection, click OK to add that program to the list of programs that are permitted to
pass through the Windows firewall.
6. When you are finished, click OK to close the Windows Firewall dialog box, then close the Windows Se-
curity Center and the Control Panel.
2.3. Setting Up IBM MPI for Windows

To install, configure, and start the IBM MPI service on a given host, install IBM MPI using the installation
launcher. After installing IBM MPI in this way, the software is configured and started. For more inform-
ation, see Product Installation with Client Licensing.
Note
• IBM MPI service requires that all hosts are on the same domain and that the user has an account
for that domain.
• IBM MPI service requires that all machines in the cluster have identical MPI installation directory
paths.
• IBM MPI uses the –cpu_bind option by default and binds processes to cores using a cyclic order.
This leads to better performance but, on multi-user clusters having scheduling systems that do
not enforce exclusive use of cluster nodes, this may cause problems because multiple jobs may
be bound to the same CPU on the same node. In this case, the –cpu_bind argument to mpirun
should be removed from the IBM MPI start methods in the start_methods.ccl file in the
<CFXROOT>/etc directory.
2.3.1. Enabling IBM MPI Parallel Through a Windows Firewall

To enable IBM MPI parallel processing through a Windows firewall:
1. Click Start and select Control Panel.
2. On the Control Panel dialog box, double-click Security Center.
3. Click Windows Firewall.
4. On the Windows Firewall dialog box, click the Exceptions tab and then click Add Program.
5. Browse to the following programs:
• For IBM MPI:
– <ANSYS Inc installation path>\v193\CFX\bin\<CFX5OS>\solver-mpi.exe
– <ANSYS Inc installation path>\v193\CFX\bin\<CFX5OS>\double\solver-mpi.exe
– <ANSYS Inc installation path>\v193\commonfiles\MPI\IBM\<version number>\winx64\sbin\ibmmpi-

win32service.exe
– <ANSYS Inc installation path>\v193\commonfiles\MPI\IBM\<version number>\winx64\bin\mpirun.exe
– <ANSYS Inc installation path>\v193\commonfiles\MPI\IBM\<version number>\winx64\bin\mpid.exe
The IBM MPI service listens to port 8636 by default. This can be changed during installation of IBM
MPI from the product installer or using the following command:
cfx5parallel -setportkey-ibmmpi-service
In all cases, you must ensure the chosen port is accessible.
After each selection, click OK to add that program to the list of programs that are permitted to
pass through the Windows firewall.
6. When you are finished, click OK to close the Windows Firewall dialog box, then close the Windows Se-
curity Center and the Control Panel.
2.4. Setting up and Running Microsoft Windows HPC 2016

To set up running Microsoft Windows HPC 2016, steps must be taken so that:
• The installed software is on a shared location that can be accessed by all hosts
• The working directory is a shared location
• A mechanism is provided so that all local paths can be properly resolved.
To prepare for running ANSYS CFX with Microsoft Windows HPC 2016, you can follow the steps below
(terms in angle brackets < > should be replaced with the required entry):
1. Install ANSYS Licensing, ANSYS Workbench and ANSYS CFX on the head node.
2. Share the installation directory. For example, on a typical installation share C:\Program Files\ANSYS
Inc as \\<HeadNodeName>\ANSYS Inc where <HeadNodeName> is the name of the head node.
3. Install the ANSYS prerequisites on all of the cluster nodes. You can do this either by:
• Executing the following commands directly on each node:

\\<HeadNodeName>\ANSYS Inc\v193\prereq\2008MFCvcredist_x64.exe /q
\\<HeadNodeName>\ANSYS Inc\v193\prereq\2008vcredist_x64.exe /q
\\<HeadNodeName>\ANSYS Inc\v193\prereq\2012vcredist_x64.exe /quiet
\\<HeadNodeName>\ANSYS Inc\v193\prereq\2012vcredist_x86.exe /quiet
\\<HeadNodeName>\ANSYS Inc\v193\prereq\dotNetFx40.exe /q
\\<HeadNodeName>\ANSYS Inc\v193\prereq\vcredist_x64_SP1.exe /Q
\\<HeadNodeName>\ANSYS Inc\v193\prereq\vcredist_x86_SP1.exe /Q
• or by using the clusrun command on the headnode to execute these commands on all the nodes
(refer to your Microsoft Windows HPC documentation for details).
4. Share the working directory on the head node. For example, share C:\Users\<UserName> as
\\<HeadNodeName>\<UserName> where <UserName> is the user name.
Alternatively, share the working directory of the submitting machine. For example share
C:\Users\<UserName> on the submitting machine as \\<SubmitHostName>\<UserName>
where <SubmitHostName> is the name of the submitting machine.
5. If the submitting machine is different from the server head node, it is necessary to install the client utilities
of ‘HPC Pack 2016’ on the submitting machine. This is available for download from Microsoft. This sets
the CCP_HOME environment variable, enabling the ‘Submit to Windows HPC Queue’ start method in the
CFX-Solver Manager.
6. On the submitting machine, create %USERPROFILE%\.cfx\cfxccs_options.txt with the following

content to define the required job submission options:
PATHMAP=C:\Program Files\ANSYS Inc;\\<HeadNodeName>\ANSYS Inc

PATHMAP= C:\Users\<UserName>;\\<HeadNodeName>\<UserName> or
PATHMAP=C:\Users\<UserName>;\\<SubmitHostName>\<UserName> if the working
directory has been shared from the submitting machine.
CLUSTERHOST=<HeadNodeName> to be used when submitting jobs from machines other
than the headnode.
ACCOUNT=<OtherUserDomain>\<OtherUserName> to be used when submitting jobs
using different credentials, where <OtherUserDomain> and <OtherUserName> are the
domain and user names of another user, respectively.
PROCESSORSPERSOLVER=2 an optional setting (default setting is 1) that allocates the number
of cores per partition. This is typically used on hosts that are limited by memory bandwidth
such as Xeon-based machines.
7. Set up ANSYS Workbench for a network as described in Network Installation and Product Configuration.
To submit a job:
1. Start the CFX-Solver Manager (either using CFX standalone or from ANSYS Workbench) on the submitting
machine using the software installed on the headnode.
2. Ensure that the Run Mode on the Run Definition tab of the CFX-Solver Manager is set to Submit to
Windows HPC Queue. Otherwise, set up the CFX-Solver Manager as normal.
3. Click Start Run on the CFX-Solver Manager to start the simulation. The first time a simulation is run,
supply the required credentials that are prompted (this prompt may appear behind the CFX-Solver Manager
window). You may elect to have these credentials saved to avoid repeated prompting of these credentials.
Note
1. %USERPROFILE% is typically:
C:\Users\<UserName>
2. To use on ANSYS Workbench with Parameters and Design Points, start the CFX-Solver Manager,
ensure that the Run Mode on the Run Definition tab of the CFX-Solver Manager is set to
Submit to Windows HPC Queue, set the number of processes, then click Save Settings.
When the user clicks Update all Design Points, each parameter or design point will be solved
on the cluster.
IBM Platform MPI with High (>4096) Process Count
The Platform MPI software included with ANSYS products allows for a maximum of 4096 processes to
be included in a single parallel calculation. You will need to obtain an additional license from Interna-
tional Business Machines Corp. (IBM) for higher process counts. Alternatively, you can use the "Intel
MPI" option in the settings for your parallel calculation.

Install Help

Uploaded by

Copyright:

Available Formats

Install Help

Uploaded by

Document Information

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Install Help

Uploaded by

Copyright:

Available Formats

Installation and Licensing Documentation

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

U.S. Government Rights

Published in the U.S.A.

ANSYS, Inc. Release 2019 R1

Copyright and Trademark Information

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

U.S. Government Rights

Published in the U.S.A.

7.2. Advanced Licensing Configuration Options ..................................................................................... 40

9.1.5.3. Display the Customer Number ....................................................................................... 75

Supported Hardware Platforms

• Linux x64 (linx64)

• Windows x64 (winx64)

Summary of New and Changed Features

The ANSYS License Manager uses the following versions of FlexNet:

Table 1.1: FlexNet Versions

Platform FlexNet LMGRD Version

Compatibility with Other FlexNet-Licensed Software

1.1. Explanation of Licensing Terms

• The ANSYS License Manager, including:

– FlexNet license manager daemon (lmgrd)

– Vendor daemon (ansyslmd)

– Licensing Interconnect (ansysli_server) -- Also includes ansysli_monitor, which ensures

• License server machines

These components are explained in more detail in the following sections.

1.1.1. The FlexNet License Manager Daemon (lmgrd)

1.1.2. The Vendor Daemon (ansyslmd)

1.1.3. ANSYS Licensing Interconnect (ansysli_server)

1.1.4. The License File

1.1.4.1. Product to License Feature Mapping

To access this table:

1. Log onto the ANSYS Customer Portal.

2. Click Downloads>Installation and Licensing Help and Tutorials.

1.1.4.2. License File Format

• System host names on the SERVER line(s)

• Port numbers on the SERVER line(s)

• Vendor daemon file paths on the VENDOR line(s)

• Options file paths on the VENDOR line(s)

1.1.4.2.1. SERVER Lines

The following is an example of a server line:

1.1.4.2.2. VENDOR Lines

ansyslmd is the name of the ANSYS vendor daemon.

VENDOR ansyslmd options="C:\Program Files\ANSYS Inc\Shared Files\

1.1.4.2.3. INCREMENT Lines

• gagh is the hostname of the license server

• 690daec6 is the hostid

• 1055 is the FlexNet port number

• ansyslmd is the vendor daemon

• ansys is the license feature representing ANSYS Mechanical Enterprise

• 30-sep-2018 is the expiration date

• 15 is the number of tasks for ANSYS Mechanical Enterprise

• 8C59A481BA50 is the encryption key for ANSYS Mechanical Enterprise

• customer:00012345 is the customer number

• ISSUED=10-sep-2017 is the date the license was created

• START=10-sep-2017 is the start date

• SIGN2=<” fifteen 4 character segments” > is the TRL encryption

1.1.5. The License Server Machines

1.1.5.1. Selecting License Server Machines

• Computers must have a high-speed, reliable Ethernet connection.