Installation Guide For Linux
Installation Guide For Linux
Installation Guide For Linux
The information in this guide applies to all ANSYS, Inc. products released on or after this date, until superseded
by a newer version of this guide. This guide replaces individual product installation guides from previous releases.
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. FLEMlm and FLEXnet are trademarks of Flexera Software LLC.
Disclaimer Notice
THIS ANSYS SOFTWARE PRODUCT AND PROGRAM DOCUMENTATION INCLUDE TRADE SECRETS AND ARE CONFID-
ENTIAL AND PROPRIETARY PRODUCTS OF ANSYS, INC., ITS SUBSIDIARIES, OR LICENSORS. The software products
and documentation are furnished by ANSYS, Inc., its subsidiaries, or affiliates under a software license agreement
that contains provisions concerning non-disclosure, copying, length and nature of use, compliance with exporting
laws, warranties, disclaimers, limitations of liability, and remedies, and other provisions. The software products
and documentation may be used, disclosed, transferred, or copied only in accordance with the terms and conditions
of that software license agreement.
ANSYS, Inc. and ANSYS Europe, Ltd. are UL registered ISO 9001: 2008 companies.
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.
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. iii
Linux Installation Guide
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
iv of ANSYS, Inc. and its subsidiaries and affiliates.
List of Tables
1.1. Supported Linux Platforms ..................................................................................................................... 3
1.2. CAD Support by Platform ........................................................................................................................ 3
2.1. OpenMotif Versions for SUSE Linux Enterprise ......................................................................................... 9
2.2. Compiler Requirements for All Linux Versions ........................................................................................ 14
5.1. Startup Commands ............................................................................................................................... 46
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. v
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
vi of ANSYS, Inc. and its subsidiaries and affiliates.
Chapter 1: Installation Prerequisites for Linux
This document describes the steps necessary to correctly install and configure all ANSYS, Inc. products
on Linux platforms for Release 18.1. These products include:
– ANSYS Mechanical Products (includes Mechanical APDL, Mechanical and ANSYS Composite PrepPost,
where supported)
– ANSYS Autodyn
– ANSYS LS-DYNA
– ANSYS TurboGrid
– ACIS
– CATIA, Version 4
– CATIA, Version 5
– NX
– Parasolid
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 1
Installation Prerequisites for Linux
Notes Not all products may be available on all Linux platforms. See the remainder of this document
for detailed information on which products are available on which platforms.
At Release 18.1, ANSYS BladeGen, Vista CCD, Vista CPD, Vista RTD, and Vista AFD are not supported on
Linux platforms.
ANSYS Workbench and ANSYS EKM Desktop are installed by default as product components to most
ANSYS, Inc. products. ANSYS Workbench is not installed as part of the products under ANSYS Additional
Tools. ANSYS Workbench includes the following applications:
• DesignModeler
• Design Exploration
• Meshing
• Fluent Meshing
• FE Modeler
• EKM Client
Important Notice
If you wish to run multiple releases of ANSYS, Inc. software, you MUST install them chronologically (i.e.,
Release 17.0 followed by Release 18.1). If you install an earlier release after installing Release 18.1, 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 18.1, you MUST uninstall Release
18.1, then re-install the releases in order.
• The ANSYS product installation program automatically verifies the existence of NVidia drivers on the install-
ation computer and creates an ANSYS Workbench driver profile if necessary.
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
2 of ANSYS, Inc. and its subsidiaries and affiliates.
System Prerequisites
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.
A = Mechanical APDL
W = ANSYS Workbench
I = ANSYS ICEM CFD (standalone and ANSYS Workbench Readers)
Linux x64
CATIA 4.2.4 A, I
CATIA V5–6R2016 W, I
GAMBIT 2.4 W, I
Parasolid 29.0 A, W, I
ACIS 2017 A, W, I 1
NX 9.0 A, W, I
NX 10.0 A, W, I
NX 11.0 A, W, I
STEP AP203, AP214 A, W, I
IGES A 2, W, I 3
GEMS I
Rhinoceros I4
1. For ANSYS ICEM CFD standalone, ACIS 18.0.1 is the supported version for all platforms.
2. MAPDL supports 5.1 by default, but 5.2 is also supported if the IOPTN command is used.
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 3
Installation Prerequisites for Linux
Memory Requirements You must have a minimum of 8 GB of memory to run product installations;
16 or 32 GB of memory is recommended.
• The machine(s) being used for the simulation must contain at least one supported NVIDIA GPU card or one
Intel Xeon Phi coprocessor. The following cards are supported:
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
4 of ANSYS, Inc. and its subsidiaries and affiliates.
Additional Hardware and Software Requirements
• When using the sparse solver or eigensolvers based on the sparse solver (for example, Block Lanczos or
subspace), only nVIDIA GPU devices with significant double precision performance are recommended in
order to achieve optimal performance. These include the following models:
• For NVIDIA GPU cards, the driver version must be 375.20 or newer.
• For Intel Xeon Phi coprocessors, the driver version must be “MPSS 3.8” or newer.
Note
Mechanical APDL assumes that the Intel Xeon Phi coprocessor driver is installed in /opt/in-
tel/mic/coi. If the installation is located in a different folder, set the ANS_MIC_LIB_PATH
environment variable to the path where the Xeon Phi driver is installed (for example,
/mypath/mic/coi).
• 8 GB of RAM
• 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. When
working with large 3D models, use of a recent NVIDIA Quadro, AMD FirePro or similar card is recommended.
For information on the most recently tested NVIDIA and AMD graphics cards, see ANSYS.com>
Support> Platform Support and view the Graphics Cards Tested PDF for your release.
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.
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 5
Installation Prerequisites for Linux
– 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 installation functionality.
• 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.
• CFX-RIF requires 32-bit libraries (even when running on a 64-bit machine). For details, see Setting up CFX-
RIF (p. 40).
ANSYS, Inc. products may have softlinks that require 777 permissions. In addition, the following third-
party products are known to contain softlinks that require 777 permissions:
• CPython
• GCC
• IMPI
• INTELMPI
• MainWin
• Mono
• MPICH
• OPENMPI
• IBMMPI
• Perl
• Python
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
6 of ANSYS, Inc. and its subsidiaries and affiliates.
Third-Party Software and Other Security Considerations
• Qt
• Qwt
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 7
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
8 of ANSYS, Inc. and its subsidiaries and affiliates.
Chapter 2: Platform Details
Linux
For ALL 64-bit Linux platforms, OpenMotif, and Mesa libraries should be installed. These libraries are
typically installed during a normal Linux installation. You will also need the xpdf package to view the
online help.
ANSYS products require OpenMotif. After installing SuSe Linux Enterprise, review the table below and
install the appropriate version of OpenMotif. (You may need to use "rpm -iv -force" to install these.)
For More information on OpenMotif libraries for your platform, see http://www.motifzone.net.
Red Hat Enterprise Linux 6.7 through 6.8 and 7.1 through 7.3 You need to install the following
libraries:
• libXp.x86_64
• xorg-x11-fonts-cyrillic.noarch
• xterm.x86_64
• openmotif.x86_64
• compat-libstdc++-33.x86_64
• libstdc++.x86_64
• libstdc++.i686
• gcc-c++.x86_64
• compat-libstdc++-33.i686
• libstdc++-devel.x86_64
• libstdc++-devel.i686
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 9
Platform Details
• compat-gcc-34.x86_64
• gtk2.i686
• libXxf86vm.i686
• libSM.i686
• libXt.i686
• xorg-x11-fonts-ISO8859-1-75dpi.noarch
Red Hat no longer includes the 32-bit libraries in the base configuration so you must install those sep-
arately.
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:
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":
4. Click Apply.
Semaphore Limit On some Linux systems, ANSYS Workbench reaches a system limit on the number
of semaphores in the Linux configuration. In this case, you will see a message similar to the following:
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
10 of ANSYS, Inc. and its subsidiaries and affiliates.
sem_unlock->semctl: Invalid argument
To increase the number of semaphores, run the following command as owner or root:
% echo 256 40000 32 32000 > /proc/sys/kernel/sem
This modification takes effect immediately, but is reset at the next reboot. To avoid resetting the limit
when rebooting, add the above command to one of your system’s startup scripts by copying the com-
mand into a file called mod_sem and then setting up the following links to execute the file each time
you restart your system:
cp mod_sem /etc/init.d
ln -s /etc/init.d/mod_sem /etc/rc3.d/S61mod_sem
ln -s /etc/init.d/mod_sem /etc/rc5.d/S61mod_sem
Mechanical, Meshing, DesignModeler, and FE Modeler Applications If you are using a localized
operating system (such as French or German), you must set the mwcontrol VisualMainWin control on
any machines running these applications in order for these applications to recognize the correct numer-
ical format. ANSYS Workbench must already be installed before setting this control.
First, you need to ensure that the /v181/aisol/WBMWRegistry/ directory has write permissions.
From the /v181/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>/v181/aisol
5. Change the language in the dropdown to match the language you want to use.
7. Click Apply to accept the changes, and then click OK to dismiss the Change Regional Settings notification.
Using Fluent with Infiniband On some operating systems, the default amount of physical memory
that can be pinned/locked by a user application is set to a low value and must be explicitly increased.
A value recommended by Intel is 90% of the physical memory. Therefore, the following should be added
to the /etc/security/limits.conf file:
* hard memlock unlimited
* soft memlock unlimited
The need for increasing the limits may be indicated by the following error message with Platform MPI:
fluent_mpi.16.0.0: Rank 0:1: MPI_Init: ibv_create_cq() failed
fluent_mpi.16.0.0: Rank 0:1: MPI_Init: Can't initialize RDMA device
fluent_mpi.16.0.0: Rank 0:1: MPI_Init: MPI BUG: Cannot initialize RDMA protocol
libibverbs: Warning: RLIMIT_MEMLOCK is 32768 bytes.
This will severely limit memory registrations
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 11
Platform Details
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 Infiniband On some operating systems, the default amount of physical
memory that can be pinned/locked by a user application is set to a low value and must be explicitly
increased. A value recommended by Intel is 90% of the physical memory. Therefore, the following
should be added to the /etc/security/limits.conf file:
* hard memlock unlimited
* soft memlock unlimited
This behavior has been observed on Intel MPI 4.1.3, but might also occur on Platform MPI 9.1.4.2.
Using the Fluent Launcher On Linux systems, you must have the following package (as appropriate
for your platform) installed in order to use the Fluent launcher:
Using ANSCUSTOM If you use ANSCUSTOM to link your own version of ANSYS Release 18.1 on a
SUSE SLES 11.x or 12.x computer, you may see two unsatisfied externals that are system, not ANSYS
files, due to the linker looking for some system files in a Red Hat directory on a SUSE computer.
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 18.1 executable is looking for
system libraries that do not have revision numbers appended to the end of their file names. On some
SUSE systems, the graphics libraries all have revision numbers appended to the end of the library file-
names. In these cases, ANSYS quits because the loader cannot find all of the libraries that it is looking
for. When running ANSYS Release 18.1, the loader will inform you that it is unable to locate a specific
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
12 of ANSYS, Inc. and its subsidiaries and affiliates.
Utilizing CPU Hyperthreading Technology with ANSYS CFD Solvers
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.
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.2: Compiler Requirements
for All Linux Versions (p. 14). The ANSYS solver is built on Red Hat Enterprise Linux AS release 4 (Update
5).
For ANSYS Workbench and ANSYS Autodyn, you may need to increase the stack size; we recommend
setting it to 1 GB. Add the following to your configuration file:
Other shells may have different settings; refer to your shell documentation for specific details.
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.
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 13
Platform Details
* Compilers are required only if you will be using User Programmable Features (UPF), User Defined
Functions (UDF), or other customization options.
• Installing the ANSYS Software for a Stand-alone Linux System (p. 15)
• Installing the ANSYS Products and the License Server on Different Linux Machines (p. 25)
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
14 of ANSYS, Inc. and its subsidiaries and affiliates.
Chapter 3: Installing the ANSYS Software 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/v181
or <install_dir> with the actual installation path you used.
• An account on the ANSYS Customer Portal. If you do not have an account, you may register at https://sup-
port.ansys.com/portal/site/AnsysCustomerPortal 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. 23).
• Open port numbers for both the FLEXlm and ANSYS Licensing Interconnect. Defaults are 1055 and 2325,
respectively. To verify that these port numbers are available, open a command line and enter the following
command:
netstat -a -t
You will see a list of active ports. If 1055 and 2325 are listed, they are already in use and cannot be
used for ANSYS, Inc. licensing. In this case, you will need to specify different port numbers where in-
dicated later in this installation.
You should also verify that you are running on a supported platform. ANSYS, Inc. products support 64-
bit Linux systems running Red Hat (6.7 through 6.8 and 7.1 through 7.3), SUSE Linux Enterprise 11 (SP3
or SP4), SUSE Linux Enterprise 12 (SP0 or SP1) and CentOS-7.3.
Verify that you have sufficient disk space to download, uncompress, and install the products you will
be installing. Approximate disk space requirements for each product are shown in Disk Space and
Memory Requirements (p. 4).
If you have any problems with--or questions about--the installation process, log a Service Request on
the ANSYS Customer Portal to have a Systems Support Specialist assist you.
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 15
Installing the ANSYS Software for a Stand-alone Linux System
• 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.
Depending on the product/platform combination(s) you choose, you may need to download multiple
files.
• Primary Packages: Individual full packages for the primary ANSYS products.
7. To download Add-On Packages, Tools or Academic Packages, click the + to the right of the appropriate
product group title to display the download options and download as required.
8. After all downloads have been completed, uncompress each package using standard uncompression
utilities for your specific platform. We strongly recommend that you extract the files into new, temporary
directories.
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
16 of ANSYS, Inc. and its subsidiaries and affiliates.
Installing from a USB Drive
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. 18).
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.1 through 7.3 and SUSE Linux Enterprise 12 SP0 and SP1
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. Open the auto-mount location, right-click the ANSYS181 USB and click Eject.
2. In a root shell, run the following command to determine the usb drive location:
fdisk -l
From the results of the fdisk -l command, locate the Device Boot data. The device boot data
should be in a format similar to /dev/sbd1, where sbd1 is the USB location. You will use the
device boot data when editing the fstab below.
mkdir /run/media/<username>/ANSYS181
vi /etc/fstab
Note the use of the device boot data used in the line.
mount -a
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 17
Installing the ANSYS Software for a Stand-alone Linux System
3.4. Mounting the DVD Instructions for DVD Installations (Linux x64 Only)
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/ANSYS181.
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:
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)
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.
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
18 of ANSYS, Inc. and its subsidiaries and affiliates.
Product Installation
From the options along the left side of the launcher you can install ANSYS products, Documentation
Only, ANSYS EKM Server, and the ANSYS License Manager. You can access the installation guide
for the ANSYS EKM Server from the Downloads page on the Customer Portal.
The ANSYS, Inc. Quick Start Installation Guide, ANSYS, Inc. Quick Start Licensing Guide, System Re-
quirements 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.
4. The license agreement appears. Read the agreement, and if you agree to the terms and conditions, select
I Agree. Click the Next arrow, located on the right side of the screen.
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.
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 19
Installing the ANSYS Software for a Stand-alone Linux System
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.
7. All products available in the installation package(s) you downloaded are listed.
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 the Next arrow. For additional
information on completing these steps, see Specifying CAD Configurations (p. 21).
By default, the Install Documentation option is enabled (checked). When enabled, help document-
ation is included as part of the installation process for all products selected. No help documentation
is included with the installation if this box is disabled (unchecked).
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 the Next arrow.
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 the Next arrow 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
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
20 of ANSYS, Inc. and its subsidiaries and affiliates.
Product Installation
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.
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.
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 the NX installation path under
the NX tab.
3. If you selected the ANSYS ICEM CFD NX Interface product but not the NX Geometry Interface product on
the product selection screen, you may need to specify the NX installation path or choose to skip config-
uring NX and use the Product & CAD Configuration Manager to configure later.
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 21
Installing the ANSYS Software for a Stand-alone Linux System
1. Navigate to the directory where you extracted the files. Run ./INSTALL.LM. If you downloaded the license
manager installation package, this file will reside in the directory where you untarred the downloaded
files. If you are running from a DVD, this file will reside in the top level of the DVD.
2. You may see a warning stating that if the license manager is currently running, it will be shut down. This
installation assumes that you have not previously installed the products or the licensing on this machine,
and you are not pointing to a network license server machine. You may safely ignore this message and
click OK.
4. The license agreement appears. Read the agreement, and if you agree to the terms and conditions, select
I Agree. Click the Next arrow, located on the right side of the screen.
5. The directory where you wish to install the ANSYS, Inc. License Manager is shown in the Install Directory
field. You can install the License Manager into any directory you wish, but you must have write permissions
to the directory you choose. The default is /ansys_inc. We recommend using the default directory.
You must use the same directory where the products were installed.
Note
You are unable to change the installation directory for a computer that currently contains
an instance of the ANSYS, Inc. License Manager or ANSYS Electromagnetics License
Manager. To change the installation directory location, you must first uninstall any pre-
vious versions of both products.
6. The ANSYS, Inc. License Manager is selected as the only product available to install. As with the product
installation, the required and available disk space numbers are shown. Click the Next arrow.
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.
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, uncheck the Launch License Man-
agement Center upon exiting option.
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/v181/ACP.sh
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
22 of ANSYS, Inc. and its subsidiaries and affiliates.
Product Installation
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. 37).
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 23
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
24 of ANSYS, Inc. and its subsidiaries and affiliates.
Chapter 4: Installing the 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.
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. 32)
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. 29) 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/v181
or <install_dir> with the actual installation path you used.
• An account on the ANSYS Customer Portal. If you do not have an account, you may register at https://sup-
port.ansys.com/portal/site/AnsysCustomerPortal 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. 33).
• Open port numbers for both the FLEXlm and ANSYS Licensing Interconnect. Defaults are 1055 and 2325,
respectively. To verify that these port numbers are available, open a command line and enter the following
command:
netstat -a -t
You will see a list of active ports. If 1055 and 2325 are listed, they are already in use and cannot be
used for ANSYS, Inc. licensing. In this case, you will need to specify different port numbers where in-
dicated later in this installation.
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 25
Installing the 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.7 through 6.8 and 7.1 through 7.3), SUSE Linux Enterprise 11 (SP3
or SP4), SUSE Linux Enterprise 12 (SP0 or SP1) and CentOS-7.3.
Verify that you have sufficient disk space to download, uncompress, and install the products you will
be installing. Approximate disk space requirements for each product are shown in Disk Space and
Memory Requirements (p. 4).
If you have any problems with--or questions about--the installation process, log a Service Request on
the ANSYS Customer Portal to have a Systems Support Specialist assist you.
• Product Download Instructions: This set of instructions describes the download and extraction process.
• Product Installation with Client Licensing: This set of instructions describes the product installation, including
the client licensing portion.
• License Manager Installation: This set of instructions describes the license manager installation.
• Post-Installation Procedures for All Products: This is a set of instructions that describes any configuration
steps that may be required for the various products.
For this procedure, the product and the license manager will be installed on separate machines. You
must complete both the client licensing portion and the license manager installation in order to run ANSYS,
Inc. products.
Depending on the product/platform combination(s) you choose, you may need to download multiple
files.
• Primary Packages: Individual full packages for the primary ANSYS products.
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
26 of ANSYS, Inc. and its subsidiaries and affiliates.
Installing from a USB Drive
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.
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. 29).
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.1 through 7.3 and SUSE Linux Enterprise 12 SP0 and SP1
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. Open the auto-mount location, right-click the ANSYS181 USB and click Eject.
2. In a root shell, run the following command to determine the usb drive location:
fdisk -l
From the results of the fdisk -l command, locate the Device Boot data. The device boot data
should be in a format similar to /dev/sbd1, where sbd1 is the USB location. You will use the
device boot data when editing the fstab below.
mkdir /run/media/<username>/ANSYS181
vi /etc/fstab
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 27
Installing the ANSYS Products and the License Server on Different Linux Machines
Note the use of the device boot data used in the line.
mount -a
4.4. Mounting the DVD Instructions for DVD Installations (Linux x64 Only)
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/ANSYS181.
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:
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)
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 want 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.
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
28 of ANSYS, Inc. and its subsidiaries and affiliates.
Product Installation
From the options along the left side of the launcher you can install ANSYS products, Documentation
Only, ANSYS EKM Server, and the ANSYS License Manager. You can access the installation guide
for the ANSYS EKM Server from the Downloads page on the Customer Portal.
The ANSYS, Inc. Quick Start Installation Guide, ANSYS, Inc. Quick Start Licensing Guide, System Re-
quirements 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.
4. The license agreement appears. Read the agreement, and if you agree to the terms and conditions, select
I Agree. Click the Next arrow, located on the right side of the screen.
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. 34)) for each platform
other than your current machine type. See Network Installation and Product and CAD Configura-
tion (p. 34) for specific instructions on how to configure a shared installation directory across
multiple machines using a common network file system.
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 29
Installing the ANSYS Products and the License Server on Different Linux Machines
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.
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.
7. All products available in the installation package(s) you downloaded are listed.
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 the Next arrow. For additional
information on completing these steps, see Specifying CAD Configurations (p. 31).
By default, the Install Documentation option is enabled (checked). When enabled, help document-
ation is included as part of the installation process for all products selected. No help documentation
is included with the installation if this box is disabled (unchecked).
You will also see an estimate of the disk space required to install all of the selected components,
and the disk space you have available. The actual amount of disk space required may be less, but
if you choose to run the installation with insufficient disk space available, we strongly recommend
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
30 of ANSYS, Inc. and its subsidiaries and affiliates.
Product Installation
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 the Next arrow. 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 the Next arrow 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.
10. The product installation window reappears with a message noting that the installation is complete. A
Launch Survey Upon Exiting option is included here. Clicking Exit while the Launch Survey Upon Ex-
iting is enabled causes your default browser to open, displaying the product survey. Disabling (un-
checking) the Launch Survey Upon Exiting option and then clicking Exit skips the survey.
11. If you have installed ANSYS, Inc. products on a file server, follow the instructions under Network Installation
and Product and CAD Configuration (p. 34).
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.
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 31
Installing the ANSYS Products and the License Server on Different Linux Machines
NX
1. If you selected NX, you can choose the Workbench Associative Interface (requires that the CAD product
be installed), or skip and configure later (using the Product & CAD Configuration Manager).
2. If you choose the Workbench Associative Interface and the UGII environment variables were not set, you
may need to specify the NX installation path for an existing NX installation. Alternatively, you can run the
Product & CAD Configuration Manager after the installation and provide the NX installation path under
the NX tab.
3. If you selected the ANSYS ICEM CFD NX Interface product but not the NX Geometry Interface product on
the product selection screen, you may need to specify the NX installation path or choose to skip config-
uring NX and use the Product & CAD Configuration Manager to configure later.
Note
It is not necessary to install the ANSYS License Manager on the client computers.
1. Navigate to the directory where you extracted the files. Run ./INSTALL.LM. If you downloaded the license
manager installation package, this file will reside in the directory where you untarred the downloaded
files. If you are running from a DVD, this file will reside in the top level of the DVD.
2. You may see a warning stating that if the license manager is currently running, it will be shut down. If
you have not previously installed the products or the licensing on this machine, and you are not pointing
to a network license server machine, you may safely ignore this message and click OK.
4. The license agreement appears. Read the agreement, and if you agree to the terms and conditions, select
I Agree. Click the Next arrow, located on the right side of the screen.
5. The directory where you want to install the ANSYS, Inc. License Manager is shown in the Install Directory
field. You can install the License Manager into any directory you want, but you must have write permissions
to the directory you choose. The default is /ansys_inc. We recommend using the default directory.
You must use the same directory where the products were installed.
Note
You are unable to change the installation directory for a computer that currently contains
an instance of the ANSYS, Inc. License Manager or ANSYS Electromagnetics License
Manager. To change the installation directory location, you must first uninstall any pre-
vious versions of both products.
6. The ANSYS, Inc. License Manager is selected as the only product available to install. As with the product
installation, the required and available disk space numbers are shown. Click the Next arrow.
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
32 of ANSYS, Inc. and its subsidiaries and affiliates.
Product Installation
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.
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.
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/v181/ACP.sh
CFD Post /ansys_inc/v181/cfdpost
CFX /ansys_inc/v181/CFX/bin/<productname>
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.
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 33
Installing the ANSYS Products and the License Server on Different Linux Machines
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.
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.
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)
3. Run
exportfs -a
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
34 of ANSYS, Inc. and its subsidiaries and affiliates.
Product Installation
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/v181/ProductConfig.sh
3. Select the products you want to configure and click the Next arrow.
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.
After completing the installation process, refer to Post-Installation Instructions (p. 37).
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:
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 35
Installing the ANSYS Products and the License Server on Different Linux Machines
3. Change the value to from "on" to "off" and save the file.
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
36 of ANSYS, Inc. and its subsidiaries and affiliates.
Chapter 5: Post-Installation Instructions
The following post-installation procedures apply to all ANSYS, Inc. products. Individual products may
have additional post-installation procedures; please 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).
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.
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 37
Post-Installation Instructions
4. Designate server(s) for license checkout and establish necessary user privileges (recommended but not
required). For information on these tasks, see Post-Installation Instructions for the License Manager 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
http://www.ansys.com/Support/Quality+Assurance/Quality+Services or call the ANSYS, Inc. Corporate
Quality Group at (724) 746-3304.
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 ANSYS181_DIR environment variable sets the location of the ANSYS directory hierarchy.
The default value is /ansys_inc/v181/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.
ANSYS181_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
Product Variable Table in the ANSYS Licensing Guide 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.
ANSYS181_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.
ANSYS181_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).
ANSYS181_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
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
38 of ANSYS, Inc. and its subsidiaries and affiliates.
Post-Installation Procedures for Mechanical APDL and ANSYS Workbench Products
batch jobs. The files consist of one username per line and can be modified only by the superuser. If neither
file exists, only root will be able to run batch jobs.
The at. files are located in the /etc directory on Linux machines.
3. Run the ANS_ADMIN utility to properly configure ANSYS (depending on the products you are running)
or relink ANSYS.
4. Specify the product order as it will appear in the Mechanical APDL launcher (optional). If you want to
specify product order, use the ANSLIC_ADMIN utility. See the ANSYS Licensing Guide for more information.
Explicit Dynamics, Rigid Dynamics, My Computer Background, and Remote Solve Manager (RSM)
Users: If you are running ANSYS Workbench on a multi-user RSM machine, the ‘My Computer, Back-
ground’ Solve Process Settings will likely not function as expected due to write permissions for RSM
working directories. In this situation, we strongly recommend that you set up RSM as a daemon. For
more information see Starting the RSM Launcher Service Automatically at Boot Time for Linux in the
RSM User's Guide.
This issue also affects Rigid Dynamics and Explicit Dynamics using both ‘My Computer’ and ‘My Computer,
Background’ Solve Process Settings.
The Linux installation of ANSYS CFX or ANSYS TurboGrid automatically installs the Sun Java 2 Runtime
Environment in the /ansys_inc/v181/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.
If you choose to modify your setup files, you will see a message indicating that your setup files have
been changed. You will then need to log out and log in again or source your setup files before you can
use the software.
Manual execution of a setup script each time the software is used You can also use the Tools
menu of the launcher to launch an editor to create new setup scripts which need to be run each time
you want to use the ANSYS CFX software. This method has the advantage of not requiring changes to
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 39
Post-Installation Instructions
existing setup files and allows you to use different versions of ANSYS CFX software by running different
setup files. The disadvantages are that all users must create their own setup files and run them manually
in every session in which they want to run ANSYS CFX software.
Having created the setup files, users of the C shell then need to do the following to run ANSYS CFX:
source ~/cfx5.login
cfx5
Having created the setup files, users of the Bourne or Korn shell then need to do the following before
running ANSYS CFX:
.$HOME/cfx5.profile
cfx5
Modification of system setup files The system administrator modifies the setup files (normally
/etc/profile), which are run by all users during login, to include the directory cfxroot/bin in
the command search path. While this has the advantage of only one file needing to be modified in order
to allow all users to use the software, it also:
• Is system dependent
Refer to your system documentation for information about which files to change for your workstations.
In order to run CFX-RIF on Red Hat 7, you need to ensure that the following 32-bit libraries are installed:
libX11.so.6
libpthread.so.0
libdl.so.2
libm.so.6
libstdc++.so.6
libgcc_s.so.1
libc.so.6
libxcb.so.1
libXau.so.6
As root:
enabled = 1
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
40 of ANSYS, Inc. and its subsidiaries and affiliates.
Post-Installation Procedures for Mechanical APDL and ANSYS Workbench Products
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
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:
• Is system dependent
Refer to your system documentation for information about which files to change for your workstations.
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
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 41
Post-Installation Instructions
After installing the ANSYS Fluent software, you will need to reset the default values in the ANSYS Fluent
launcher as follows:
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
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.
• Remove the FLUENT_INC setting from your .cshrc, .profile, or .bashrc file if you have added it
for previous versions. Verify that the environment variable is unset by typing:
printenv FLUENT_INC
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
42 of ANSYS, Inc. and its subsidiaries and affiliates.
Post-Installation Procedures for Mechanical APDL and ANSYS Workbench Products
1. Add the following paths to all users' login startup files (i.e., .cshrc or .login files).
/ansys_inc/v181/icemcfd/linux64_amd/bin
2. Add the following environment variable to all users' login startup files.
Add the following paths to all users' login startup files (i.e., .cshrc or .login files).
/ansys_inc/v181/autodyn/bin
<install_dir>/ansys_inc/v180/fensapice/bin/fensapiceGUI
export PATH=<install_dir>/ansys_inc/v180/fensapice/bin/:$PATH
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/v180/fensapice/bin/ directory.
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 43
Post-Installation Instructions
#!/bin/bash
export ANSYS_LIC_DIR=<install_dir>/ansys_inc/shared_files/licensing/
<install_dir>/ansys_inc/v180/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 R18.0.wbex
While in ANSYS Workbench, install the plug-in using the Extensions > Install Extension menu. You
can then set it to load automatically at startup in the Extensions > Manage Extensions menu.
See Getting Started with FENSAP-ICE in Workbench for further details on running FENSAP-ICE in
Workbench.
ANSYS Licensing
The ANSYS Licensing System is used by default. No special configuration is required if the ANSYS License
contains a feature enabling FENSAP-ICE and the ANSYS R18.0 package is installed.
ANSYS License Server Information will be recognized from the environment variables set on the system.
See the Client Environment Variable Settings section of the ANSYS Licesing Guide for more information.
If the NTI_LICENSE_FILE environment variable has been set, FENSAP-ICE will instead use legacy NTI
FLEXLm licensing. To force the use of ANSYS Licensing and ignore the NTI_LICENSE_FILE option, set an
environment variable as ANSYS_LICENSE_FILE_ONLY=1
NTI Licensing
Legacy license keys from prior to ANSYS R18.0 use the NTI FLEXLm license system. The option for NTI
licensing must then be enabled in the licensing.txt file <install_dir>/ansys_inc/v180/fensapice/config/li-
censing.txt or by setting up the NTI_LICENSE_FILE environment variable.
Modify the licensing.txt file to contain the license server information NTI_LICENSE_FILE=port@server.
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 PDF, located in the <install_dir>/an-
sys_inc/v180/fensapice/doc/ folder.
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
44 of ANSYS, Inc. and its subsidiaries and affiliates.
Product Localization
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.
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:
Note
To view Localization Support Requirements for the current release of ANSYS products, see
ANSYS Customer Portal> 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:
ANSYS, Inc. applications will look for the languagesettings.txt file in the following locations, in
order:
1. $Home/.ansys/v181
2. <install_dir>/ansys_inc/v181/commonfiles/language
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 45
Post-Installation Instructions
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.
1. Create a language-named subdirectory (for example, fr for French) under the /docu directory:
mkdir /ansys_inc/v181/ansys/docu/fr
2. Copy the message files msgcat.181, msgidx.181, and msgfnm.181 into that subdirectory.
3. Access these files from the Language Selection option of the launcher or via the -l command line option:
ansys181 -l fr
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
46 of ANSYS, Inc. and its subsidiaries and affiliates.
Launching ANSYS, Inc. Products
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 47
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
48 of ANSYS, Inc. and its subsidiaries and affiliates.
Chapter 6: Installing the ANSYS, Inc. Product Help Documentation
Only
Performing the ANSYS product help documentation installation places the entire help library onto a
computer. The Documentation Only installation is intended to be used for installing documentation on
a central server without any products.
• If you downloaded the installation package, this file will reside in the directory where you untarred the
downloaded files.
• If you are running from a DVD or USB, this file will reside in the top level of the DVD or USB.
2. From the options along the left side of the launcher click Install ANSYS Documentation Only.
3. Read the agreement, and if you agree to the terms and conditions, click I Agree. Click Next.
4. The directory where you want to install the ANSYS, Inc. help documentation is shown in the Install Direct-
ory field. You can install the help documentation 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 dir-
ectory.
We strongly recommend that you also set the symbolic link /ansys_inc to the directory where the
ANSYS, Inc. product is installed. The symbolic link option is available only if you are installing as
root and is set by default. If you choose not to specify 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.
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.
Click Next.
5. A summary screen appears listing your help documentation installation. 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.
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 49
Installing the ANSYS, Inc. Product Help Documentation Only
6. When the help documentation installation has completed, click Exit. The product installation window re-
appears. You can close this window at this time.
Note
Alternatively, you can run the document installation by running the INSTALL.DOCONLY
installation file. This file is located in the linux directory on USB drives.
The ANSYS help documentation can be installed silently by running the INSTALL.DOCONLY installation
file with the –silent flag. For more information, see Silent Mode Operations (p. 51).
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
50 of ANSYS, Inc. and its subsidiaries and affiliates.
Chapter 7: 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 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.
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 51
Silent Mode Operations
For more information on which products are included with each installation, see Applications Included
with Each Product (p. 71).
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.LM command:
INSTALL.LM -silent -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.
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
52 of ANSYS, Inc. and its subsidiaries and affiliates.
Silent Product and License Manager Installation
subdirectory of the licensing directory (en-us, fr, de, etc.) as the language
value. This flag can be used during a GUI installation as well. Valid only when
doing a license manager installation (INSTALL.LM).
-licserverinfo Specifies information to be used by the client for the license server. Valid only in
conjunction with a silent installation (INSTALL). The format is:
LI_port_number:FLEXlm_port_number:hostname
Example:
2325:1055:abc
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
Any messages will be written to the appropriate installation log files. Installation log files are located
in the installation directory: install.log contains installation messages, and install_liccon-
fig.log contains licensing installation messages. In rare circumstances with a silent licensing installation,
the licensing installation messages may not be written to the install_licconfig.log (for example,
if the silent licensing installation aborts); in these cases, you may find error messages in the .ansys_in-
stall_temp_licconfig_<user>_<index>.log file, located in $HOME/.ansys.
For more information on the silent license manager installation, see the ANSYS Licensing Guide.
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 53
Silent Mode Operations
To run in silent mode, from each client machine, run the ProductConfig with the -silent option:
/ansys_inc/v181/ProductConfig.sh -silent
Use the -product_flag argument to specify which products should be configured. If you do not
specify one or more products, all products that have been installed will be configured. The valid
product_flags are:
Product product_flag
Mechanical APDL -mechapdl
ANSYS CFD-Post -cfdpost
ANSYS CFX -cfx
ANSYS TurboGrid -turbogrid
ANSYS Fluent -fluent
ANSYS Polyflow -polyflow
ANSYS Icepak -icepak
ANSYS ICEM CFD -icemcfd
ANSYS FENSAP-ICE -fensapice
ANSYS Remote Solve Manager Standalone Services -rsm
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
54 of ANSYS, Inc. and its subsidiaries and affiliates.
Silent Media Installation
• Copy the contents of each DVD to a folder on the machine's hard disk such that the 181-<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.
The silent uninstall will automatically uninstall all products for this release and delete the v181 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:
For example, to uninstall only TurboGrid and Icepak, issue the following command:
/ansys_inc/v181/ans_uninstall181 –silent -turbogrid -icepak
You can also issue the -help option to see a list of valid arguments for a silent uninstall.
A record of the uninstall process will be written to ansys_inc/install.log. Any error messages
will be written to ansys_inc/install.err.
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 55
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
56 of ANSYS, Inc. and its subsidiaries and affiliates.
Chapter 8: 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.
This document describes how to use the Product & CAD Configuration Manager to progress through
the configuration process.
You can choose Help to view instructions on using the Product & CAD Configuration Manager at any
time. If the help 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.
1. Run the following command to start the Product & CAD Configuration Manager, substituting the full
installation path if different than /ansys_inc:
/ansys_inc/v181/aisol/.workbench -cmd -NoMW mono /ansys_inc/v181/commonfiles/CAD/
bin/linx64/Ans.CadInt.CADConfigUtilityGUI.exe.
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 57
Configuring CAD Products
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 the Next arrow.
NX
1. If you selected NX, you can choose the Workbench Associative Interface (requires that the CAD
product be installed), or skip and configure later (using the Product & CAD Configuration Manager).
2. If you choose the Workbench Associative Interface and the UGII environment variables were not set,
you may need to specify the NX installation path for an existing NX installation. Alternatively, you
can run the Product & CAD Configuration Manager after the installation and provide the NX install-
ation path under the NX tab.
3. If you selected the ANSYS ICEM CFD NX Interface product but not the NX Geometry Interface product
on the product selection screen, you may need to specify the NX installation path or choose to skip
configuring NX and use the Product & CAD Configuration Manager to configure later.
5. When all of your CAD products have been successfully configured, click Exit.
You can review the Product & CAD Configuration Manager log file, CADConfigurationMgr.log,
in /ansys_inc. If you do not have write permissions to the /ansys_inc directory, the log file will
be written to $TEMP. If you have not defined $TEMP, the log file is written to /tmp. When /tmp is not
accessible, this file will be written to the current working directory.
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 Linux is:
/ansys_inc/v181/aisol/.workbench -cmd -NoMW mono /ansys_inc/v181/commonfiles/CAD/bin/linx64/
Ans.CadInt.CADConfigurationUtility.exe -arguments
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
58 of ANSYS, Inc. and its subsidiaries and affiliates.
Using the Product & CAD Configuration Manager
Note
All arguments require a dash (-) before them in order to be properly recognized by the
Product & CAD Configuration Manager. Arguments' values should not have a dash preceding
them.
For example, you can configure the NX Geometry Interface to ANSYS Workbench from the command
line by using the following:
/ansys_inc/v181/aisol/.workbench -cmd -NoMW mono /ansys_inc/v181/commonfiles/CAD/bin/linx64/
Ans.CadInt.CADConfigurationUtility.exe -UG_CONFIG_WB -UGII_BASE_DIR "<pathtonx>"
Although the argument order does not matter, an argument value must immediately follow its argument.
8.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/v181/aisol/CADIntegration/UG to either /ansys_inc/v181/com-
monfiles/registry/linx64/append when the configuration manager is in administrative mode or
to $HOME/.config/ANSYS/181/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. 34).
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 59
Configuring CAD Products
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
60 of ANSYS, Inc. and its subsidiaries and affiliates.
Chapter 9: Uninstalling the Software
To uninstall a product, issue the following command:
/ansys_inc/v181/ans_uninstall181
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/v181/ansys/bin/ans_admin181
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.
In the case of a platform (file server) installation, the uninstall will remove the selected product(s) from
all of the Linux platforms.
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 61
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
62 of ANSYS, Inc. and its subsidiaries and affiliates.
Chapter 10: Troubleshooting
10.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 customer portal. After you log in to
the customer portal, select Knowledge Resources> Solutions.
For information on licensing-related errors, see the Troubleshooting section of the ANSYS Licensing
Guide.
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.
• If the installation does not progress beyond the extraction of any single file during the file extraction phase,
you may have insufficient disk space in the temporary directory that the file extraction utility uses. Be aware
that some components require a lengthy extraction time; we recommend allowing up to 30 minutes for
these components to extract if you are running on a particularly old or slow system.
To resolve this problem, remove files from your $TEMP directory to free up disk space, or increase
the size of any disk quotas on your $TEMP directory.
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 63
Troubleshooting
Mounting the DVD Instructions for DVD Installations (Linux x64 Only) (p. 18) to mount to a machine
that does have a DVD drive.
10.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.
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.
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).
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. 18) and enter the
correct pathname for your platform.
Licensing files currently installed for <platform> are more recent than those on the installation
media. The <platform> files will not be installed and will be deselected.
This message appears during an ANSYS, Inc. product installation if the installed license manager
files are newer than the ones being installed. You should always use the newest files. However, due
to system format changes or other unlikely scenarios, the date check could produce incorrect results.
To override the date check and force the installation to always install the files from the media, re-
gardless of the file dates, re-run the installation with the -nodatecheck option. We strongly re-
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
64 of ANSYS, Inc. and its subsidiaries and affiliates.
Installation Troubleshooting - Mechanical APDL
commend that you exercise caution when running the installation with the -nodatecheck option;
installing older license files can result in licensing errors and the inability to run ANSYS, Inc. products.
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, ANSYS181_DIR environment variable is not set. This is a fatal error – exiting.
This message indicates that the ANSYS181_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.
You may encounter this or a similar message if you attempt to use ANSYS 18.1 with a different
version of MPI than is supported. See the Parallel Processing Guide for a complete list of supported
MPI versions.
To correct this lowercase issue, un-mount the USB drive and manually re-mount the drive prior to in-
stalling ANSYS products.
10.2.1. Your batch jobs terminate when you log out of a session
On some systems, you may need to use the ‘nohup’ option to allow batch jobs to continue running
after you log out of a session. If you are running via the Launcher, select Options> Use ‘nohup’ To
Start Batch Runs With Output Sent to ‘File Only.’ We do not recommend using this setting on systems
that automatically set ‘nohup.’
10.2.2. Mechanical APDL Documentation File for User Interface Error Messages
Missing or erroneous documentation files for user interface. Command ignored.
Verify that the documentation list file for the user interface exists in the /ansys_inc/v181/an-
sys/gui/en-us/UIDL subdirectory.
ls -l /ansys_inc/v181/ansys/gui/en-us/UIDL/menulist.ans
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 65
Troubleshooting
Make sure that the pathnames in the menulist.ans file are correct.
***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\v181\launcher on Windows or ~/.ansys/v181/launcher on Linux.
In Procedure: fappnd
At Line: 72
Unit: 19
forrtl: severe (9): permission to access file denied, unit 19, file /build/v181/ansys/objs
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
66 of ANSYS, Inc. and its subsidiaries and affiliates.
Contacting Technical Support
Unable to open file /build/v181/ansys/objs/file.err for WRITE. Check directory and file permissions.
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
If your support is provided by ANSYS, Inc. directly, Technical Support can be accessed quickly and effi-
ciently from the ANSYS Customer Portal, which is available from the ANSYS Website (www.ansys.com)
under Support > Customer Portal. The direct URL is: support.ansys.com.
One of the many useful features of the Customer Portal is the Knowledge Resources Search, which can
be found on the Home page of the Customer Portal. To use this feature, enter relevant text (error
message, etc.) in the Knowledge Resources Search box and click the magnifying glass icon. These
Knowledge Resources provide solutions and guidance on how to resolve installation and licensing issues
quickly.
NORTH AMERICA
All ANSYS Products except Esterel, Apache and Reaction Design products
Web: Go to the ANSYS Customer Portal (http://support.ansys.com) and select the appropriate option.
Toll-Free Telephone: 1.800.711.7199 (Please have your Customer or Contact ID ready.)
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 67
Troubleshooting
Support for University customers is provided only through the ANSYS Customer Portal.
GERMANY
ANSYS Mechanical Products
Telephone: +49 (0) 8092 7005-55 (CADFEM)
Email: [email protected]
All ANSYS Products
Web: Go to the ANSYS Customer Portal (http://support.ansys.com) and select the appropriate option.
National Toll-Free Telephone: (Please have your Customer or Contact ID ready.)
German language: 0800 181 8499
English language: 0800 181 1565
Austria: 0800 297 835
Switzerland: 0800 564 318
International Telephone: (Please have your Customer or Contact ID ready.)
German language: +49 6151 152 9981
English language: +49 6151 152 9982
Email: [email protected]
UNITED KINGDOM
All ANSYS Products
Web: Go to the ANSYS Customer Portal (http://support.ansys.com) and select the appropriate option.
Telephone: Please have your Customer or Contact ID ready.
UK: 0800 048 0462
Republic of Ireland: 1800 065 6642
Outside UK: +44 1235 420130
Email: [email protected]
Support for University customers is provided only through the ANSYS Customer Portal.
JAPAN
CFX and Mechanical Products
Telephone: +81-3-5324-7305
Email:
Mechanical: [email protected]
Fluent: [email protected];
CFX: [email protected];
Polyflow: [email protected];
Icepak
Telephone: +81-3-5324-7444
Email: [email protected]
Licensing and Installation
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
68 of ANSYS, Inc. and its subsidiaries and affiliates.
Contacting Technical Support
Email: [email protected]
INDIA
All ANSYS Products
Web: Go to the ANSYS Customer Portal (http://support.ansys.com) and select the appropriate option.
Telephone: +91 1 800 209 3475 (toll free) or +91 20 6654 3000 (toll) (Please have your Customer or
Contact ID ready.)
FRANCE
All ANSYS Products
Web: Go to the ANSYS Customer Portal (http://support.ansys.com) and select the appropriate option.
Toll-Free Telephone: +33 (0) 800 919 225 Toll Number: +33 (0) 170 489 087 (Please have your Customer
or Contact ID ready.)
Email: [email protected]
Support for University customers is provided only through the ANSYS Customer Portal.
BELGIUM
All ANSYS Products
Web: Go to the ANSYS Customer Portal (http://support.ansys.com) and select the appropriate option.
Toll-Free Telephone: (0) 800 777 83 Toll Number: +32 2 620 0152 (Please have your Customer or Contact
ID ready.)
Email: [email protected]
Support for University customers is provided only through the ANSYS Customer Portal.
SWEDEN
All ANSYS Products
Web: Go to the ANSYS Customer Portal (http://support.ansys.com) and select the appropriate option.
Telephone: +46 (0) 10 516 49 00
Email: [email protected]
Support for University customers is provided only through the ANSYS Customer Portal.
ITALY
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 69
Troubleshooting
K0REA
Telephone: 82-2-3441-5000
CHINA
Toll-Free Telephone: 400 819 8999 Toll Number: +86 10 82861715
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
70 of ANSYS, Inc. and its subsidiaries and affiliates.
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.
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 71
Applications Included with Each Product
1. Workbench includes the Workbench Framework, DesignModeler, DesignXplorer, and Remote Solve Manager.
Release 18.1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
72 of ANSYS, Inc. and its subsidiaries and affiliates.