ANSYS Electromagnetics Suite 16.

0
Unix/Linux Installation Guide

ANSYS, Inc. December 2014

Southpointe ANSYS Electromagnetics Suite
16.0
2600 ANSYS Drive
Canonsburg, PA 15317
[email protected] ANSYS, Inc. is
http://www.ansys.com certified to ISO
(T) 724-746-3304 9001:2008.
(F) 724-514-9494
Copyright and Trademark Information

© 2014 SAS IP, Inc. All rights reserved. Unauthorized use, distribution or duplication is prohibited.

ANSYS, HFSS, Maxwell, Q3D, Simplorer, SIwave, and Optimetrics 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 in the United States or other countries. All other brand,
product, service and feature names or trademarks are the property of their respective owners.

Disclaimer Notice

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

ANSYS, Inc. is certified to ISO 9001:2008.

U.S. Government Rights

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

Third-Party Software

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

Published in the U.S.A.

 Table of Contents

1. Getting Started . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-1

Installation Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1
Operating System Specific Prerequisites . . . . . . . . . . . . . . . . . . . . . . . 1-3
Additional Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-9
2. Installing ANSYS Electromagnetics Software . . . .2-1
Obtaining a License File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2
Verifying that Enough Disk Space is Available . . . . . . . . . . . . . . . . . 2-2
Installing the Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3
Integrating ANSYS Electromagnetics Products with ANSYS
Workbench . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-8
3. Remote Simulation . . . . . . . . . . . . . . . . . . . . . . . . . .3-1
When do you need RSM? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2
Installation/Configuration Overview . . . . . . . . . . . . . . . . . . . . . . . . . . 3-3
Installing RSM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-4
Configuring RSM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-6
Registering ANSYS Electromagnetics Product Engines for use with
RSM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-8
High Performance Computing (HPC) Integration . . . . . . . . . . . . . . . . 3-9
4. Install Common Libraries . . . . . . . . . . . . . . . . . . . . .4-1
Procedure for Installing Common Libraries . . . . . . . . . . . . . . . . . . . . 4-2

Contents-1
ANSYS Electromagnetics Suite 16.0 - © SAS IP, Inc. All rights reserved. - Contains proprietary
and confidential information of ANSYS, Inc. and its subsidiaries and affiliates.
ANSYS Electromagnetics Unix/Linux Installation Guide

5. Updating Software and Licenses . . . . . . . . . . . . . . .5-1

Updating ANSYS Electromagnetics Software . . . . . . . . . . . . . . . . . . 5-2
Updating a Software License . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-4
6. Message Passing Interface (MPI) Installation . . . . .6-1
A. Silent Installation
Running the Silent Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .A-2
Response File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .A-4
B. License hostid
Network Interface Card . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-3
Hardware Key . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-5
Machine hostid . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-6
C. Setting Up a Printer on Linux

Contents-2
ANSYS Electromagnetics Suite 16.0 - © SAS IP, Inc. All rights reserved. - Contains proprietary
and confidential information of ANSYS, Inc. and its subsidiaries and affiliates.
 1
Getting Started

Installation Prerequisites
Before installing ANSYS Electromagnetics Suite software,
you need the following:
• The ANSYS Electromagnetics product CD or product down-
load (see "Additional Resources" on page 1-9 for down-
load information).
• A license file based on the ansoftd vendor daemon.
• The ANSYS License Manager software download.
• A computer with TCP/IP installed, for counted evalua-
tion and purchased licenses.
• A computer that meets the minimum or recommended sys-
tem requirements, which depends on the specific ANSYS
Electromagnetics products you plan to run (see product
release notes for specifications).
ANSYS Electromagnetics Suite Software
The ANSYS Electromagnetics product or equivalent download
contains:
• The ANSYS Electromagnetics Suite software and project
examples.
• Third-party software, when necessary, for viewing
online documentation (for example, HTML Help or Adobe
Acrobat Reader).
• Documentation files.

Getting Started 1-1

ANSYS Electromagnetics Suite 16.0 - © SAS IP, Inc. All rights reserved. - Contains proprietary
and confidential information of ANSYS, Inc. and its subsidiaries and affiliates.
ANSYS Electromagnetics Unix/Linux Installation Guide

License File
Most ANSYS Electromagnetics products require a license,
which is sent as an e-mail attachment. After you receive a
license file, save it to a temporary location.
The license file requires a license hostid, which is a
hardware device used to validate the license. A list of
supported hostids, and a general explanation of hostids,
is available in Appendix B, "License hostid."
If you do not have a license file for the ANSYS Electro-
magnetics software you are about to install, please con-
tact your ANSYS sales representative.
License Server
Once you have purchased the software, you must designate
a machine on your network to act as a license server. The
ANSYS License Manager must be installed in one of the fol-
lowing two locations:
• On the computer where the software will be installed.
• On another machine accessible over the network.
• You can install the ANSYS License Manager before or
after you install the ANSYS Electromagnetics software

Note You can install the ANSYS License Manager before

or after you install the ANSYS Electromagnetics
software.

See the ANSYS License Manager instructions available as

part of the ANSYS License Manager download.
Hardware and Software Requirements
For supported platforms and system requirements, go to:
http://www.ansys.com/Support/Platform+Support
Additional Product-Specific Prerequisites
The product release notes may show additional product-
specific prerequisites, including system requirements.
You can find the product release notes in the View Release
Notes option of the initial splash screen, or in the
readme file after installing the software.

1-2 Getting Started

ANSYS Electromagnetics Suite 16.0 - © SAS IP, Inc. All rights reserved. - Contains proprietary
and confidential information of ANSYS, Inc. and its subsidiaries and affiliates.
 ANSYS Electromagnetics Unix/Linux Installation Guide

Operating System Specific Prerequisites

Red Hat Enterprise Linux 6
Red Hat Enterprise Linux 6 is by default installed with
only 64 bit binaries. ANSYS Electromagnetics products
require some 32-bit libraries to run properly. When the
application is started, it will identify any missing run-
time libraries.
Applications
Table of 64-bit Dependencies for R16 Release
Distribut Versio Dependency List Notes
ion n
RHEL 5.10 bzip2-libs expat fontconfig
freetype giflib glib2 glibc
libjpeg libpng libtiff libX11
libXau libXdmcp libXext
libXft libXmu libXp
libXrender libXt libXxf86vm
mesa-libGL mesa-libGLU
openmotif zlib
RHEL 6.30 zip2-libs expat fontconfig libjpeg-
freetype giflib glib2 glibc turbo can
libdrm libjpeg libpng be
libselinux libtiff libX11 substituted
libXau libxcb libXdamage for libjpeg
libXext libXfixes libXft
libXmu libXp libXrender libXt
libXxf86vm mesa-dri-drivers
mesa-libGL mesa-libGLU nss-
softokn-freebl openmotif zlib
RHEL 6.40 bzip2-libs expat fontconfig libjpeg-
freetype giflib glib2 glibc turbo can
libdrm libjpeg libpng be
libselinux libtiff libX11 substituted
libXau libxcb libXdamage for libjpeg
libXext libXfixes libXft
libXmu libXp libXrender libXt
libXxf86vm mesa-dri-drivers
mesa-libGL mesa-libGLU nss-
softokn-freebl openmotif zlib

Getting Started 1-3

ANSYS Electromagnetics Suite 16.0 - © SAS IP, Inc. All rights reserved. - Contains proprietary
and confidential informationof ANSYS, Inc. and its subsidiaries and affiliates.
ANSYS Electromagnetics Unix/Linux Installation Guide

Distribut Versio Dependency List Notes

ion n
RHEL 6.50 bzip2-libs expat fontconfig libjpeg-
freetype giflib glib2 glibc turbo can
libdrm libjpeg libpng be
libselinux libtiff libX11 substituted
libXau libxcb libXdamage for libjpeg
libXext libXfixes libXft
libXmu libXp libXrender libXt
libXxf86vm mesa-dri-drivers
mesa-libGL mesa-libGLU nss-
softokn-freebl openmotif zlib
SUSE 11.10 fontconfig freetype2 giflib
glibc libbz2-1 libexpat1
libglib-2_0-0 libgobject-
2_0-0 libgthread-2_0-0
libjpeg libpng12-0 libtiff3
libuuid1 Mesa pcre xorg-x11-
libs xorg-x11-libX11 xorg-
x11-libXau xorg-x11-libxcb
xorg-x11-libXext xorg-x11-
libXmu xorg-x11-libXp xorg-
x11-libXrender xorg-x11-
libXt zlib
SUSE 11.20 ontconfig freetype2 giflib
glibc libbz2-1 libdrm
libexpat1 libglib-2_0-0
libgobject-2_0-0 libgthread-
2_0-0 libjpeg libpng12-0
libtiff3 libuuid1 Mesa
openmotif-libs pcre xorg-x11-
libs xorg-x11-libX11 xorg-
x11-libXau xorg-x11-libxcb
xorg-x11-libXext xorg-x11-
libXfixes xorg-x11-libXmu
xorg-x11-libXp xorg-x11-
libXrender xorg-x11-libXt
zlib

1-4 Getting Started

ANSYS Electromagnetics Suite 16.0 - © SAS IP, Inc. All rights reserved. - Contains proprietary
and confidential information of ANSYS, Inc. and its subsidiaries and affiliates.
 ANSYS Electromagnetics Unix/Linux Installation Guide

Distribut Versio Dependency List Notes

ion n
SUSE 11.30 fontconfig freetype2 giflib
glibc libbz2-1 libdrm
libexpat1 libglib-2_0-0
libgobject-2_0-0 libgthread-
2_0-0 libjpeg libpng12-0
libpng14-14 libtiff3 libuuid1
Mesa openmotif-libs pcre
xorg-x11-libs xorg-x11-
libX11 xorg-x11-libXau xorg-
x11-libxcb xorg-x11-libXext
xorg-x11-libXfixes xorg-x11-
libXmu xorg-x11-libXp xorg-
x11-libXrender xorg-x11-
libXt zlib

Application fails to start with "RPCSS ServiceMain

failed with 14"
This is a host lookup problem related to DNS. It has
been reported that adding an entry to /etc/hosts for
the fully qualified hostname resolves the problem.

Required 32-bit Libraries to Install Applications

The following minimal set of 32-bit libraries and
their dependencies are required to install applica-
tions. Note that these are the minimum versions
required; you may use newer versions.
glibc.i686
Required 32-bit Libraries to Run Applications
The following minimal set of 32-bit libraries and
their dependencies are required to run applications.
Note that these are the minimum versions required; you
may use newer versions.
glibc.i686
glib2.i686
bzip2-libs.i686
compat-expat1.i686
libpng.el6.i686
libtiff.i686: Also includes required dependencies:
Getting Started 1-5
ANSYS Electromagnetics Suite 16.0 - © SAS IP, Inc. All rights reserved. - Contains proprietary
and confidential informationof ANSYS, Inc. and its subsidiaries and affiliates.
ANSYS Electromagnetics Unix/Linux Installation Guide

• libjpeg.i686
• zlib.i686
libXft.i686: Also includes required dependencies:
• fontconfig.i686
• freetype.i686
• libXrender.i686
libXxf86vm.i686
Additional Graphics Libraries
ANSYS Electromagnetics applications make use of OpenGL
libraries. If you experience sluggishness when inter-
acting with the UI, or if you see any of the following
errors, you will need to install OpenGL libraries.
• Unable to resolve function glXQueryExtension
• Failed to initialize an OpenGL view
ANSYS recommends the use of OpenGL libraries provided
by the manufacturer for the graphics card in your
machine. Alternately, you may consider installing the
Mesa OpenGL RPM package mesa-libGL.i686 and its depen-
dencies.
License Server
Required Libraries to Install License Server
The following minimal set of 32-bit libraries and
their dependencies are required to install applica-
tions. Note that these are the minimum versions
required; you may use newer versions.
glibc.i686
compat-libstdc++-33.i686
Required Libraries to Run License Server
The following minimal set of 32-bit libraries and
their dependencies are required to run applications.
Note that these are the minimum versions required; you
may use newer versions.
glibc.i686
glib2.i686
bzip2-libs.i686
compat-expat1.i686
compat-libstdc++-33.i686

1-6 Getting Started

ANSYS Electromagnetics Suite 16.0 - © SAS IP, Inc. All rights reserved. - Contains proprietary
and confidential information of ANSYS, Inc. and its subsidiaries and affiliates.
 ANSYS Electromagnetics Unix/Linux Installation Guide

libpng.el6.i686
libtiff.i686: Also includes required dependencies:
• libjpeg.i686
• zlib.i686
libXft.i686: Also includes required dependencies:
• fontconfig.i686
• freetype.i686
• libXrender.i686
libXxf86vm.i686
Additional Prerequisites
Red Hat Enterprise Linux 6.1 introduces biosdevname,
an optional convention for naming network interfaces.
biosdevname assigns names to network interfaces based
on their physical location. Note, however that bios-
devname is disabled by default, except for a limited
set of Dell systems. The FLEX license manager requires
a network device that is named ethX, where X is the
lowest numbered eth device (e.g.: eth0, or eth1).
Licensing does not work when the device has any other
name. To resolve this, you will need to change the name
of the device to match the Linux standard convention.
There are four options you can use to enable the stan-
dard ethernet names:
1. If you do not need to use the Consistent Network
Device Naming package, you can remove the bios-
devname package from your installation by running
the following command in a terminal as root:
yum remove biosdevname
This removes the package and on reboot will restore
the traditional naming scheme.
2. You can update the name in the /etc/sysconfig/net-
work-scripts/ifcfg-* file:
There should be a file in /etc/sysconfig/network-
scripts that is named "ifcfg-" and the name of your
network device. To restore the name, you can rename
this file to "ifcfg-eth0" and rename the device
name from the current name to eth0 in the contents
of the file. Once updated, restarting networking
services or rebooting should enable the change.
3. You can write rules in /etc/udev/rules.d/70-per-
Getting Started 1-7
ANSYS Electromagnetics Suite 16.0 - © SAS IP, Inc. All rights reserved. - Contains proprietary
and confidential informationof ANSYS, Inc. and its subsidiaries and affiliates.
ANSYS Electromagnetics Unix/Linux Installation Guide

sistent-net.rules to change the device names. This

will take precedence over the physical location
naming scheme. Such rules may look like:
SUBSYSTEM=="net", ACTION=="add", DRIVERS=="?*",
ATTR{address}=="00:11:22:33:44:55", ATTR
{type}=="1",
KERNEL=="eth*", NAME="public"
4. You can disable biosdevname in the kernel command
line by rebooting the computer and bringing up the
kernel command line in the boot menu. From the ker-
nel command line, you can run:
biosdevname=0
You can find more information about this change:
http://docs.redhat.com/docs/en-US/Red_Hat_Enterprise_Li-
nux/6/html/6.1_Release_Notes/ar01s01.html
https://fedoraproject.org/wiki/Features/ConsistentNet-
workDeviceNaming
http://rhn.redhat.com/errata/RHEA-2011-0644.html
http://linux.dell.com/files/whitepapers/consistent_net-
work_device_naming_in_linux-v.93.pdf

1-8 Getting Started

ANSYS Electromagnetics Suite 16.0 - © SAS IP, Inc. All rights reserved. - Contains proprietary
and confidential information of ANSYS, Inc. and its subsidiaries and affiliates.
 ANSYS Electromagnetics Unix/Linux Installation Guide

Additional Resources
General: The ANSYS web site: http://www.ansys.com.
Downloads: Software downloads (including FLEXlm for
Ansoft) and installation-related documentation
are available at the ANSYS customer portal,
http://www.ansys.com/customer/default.asp
Online Available through the ANSYS customer portal:
Technical http://www.ansys.com/customer/default.asp
Support: Under Online Support, choose ANSYS
Electromagnetics Customer Support.
ANSYS Electromagnetics’s technical support
site provides access to frequently asked
questions, application notes, presentations,
and example scripts.
Product Release During installation, read the release notes.
Notes: In the initial setup window, click View Release
Notes to see any important, late-breaking
information that was not included in the ANSYS
Electromagnetics Installation Guide. After
installation, the release notes are available
in the readme file located in the product
directory.
Product Getting Started Guides and other printed
Documentation: documentation may be available at the
following locations:
• In the product package.
• On the product CD in the
Documentation directory, depending on
the product (in Portable Document
Format [PDF]).
Online help files are accessible from the Help
menu of each application installed, and they
are located in the Help subdirectory of each
product directory. The online help system is in
one of two formats: Microsoft HTML Help or pdf.

Getting Started 1-9

ANSYS Electromagnetics Suite 16.0 - © SAS IP, Inc. All rights reserved. - Contains proprietary
and confidential informationof ANSYS, Inc. and its subsidiaries and affiliates.
ANSYS Electromagnetics Unix/Linux Installation Guide

1-10 Getting Started

ANSYS Electromagnetics Suite 16.0 - © SAS IP, Inc. All rights reserved. - Contains proprietary
and confidential information of ANSYS, Inc. and its subsidiaries and affiliates.
 2
Installing ANSYS
Electromagnetics Software

To install ANSYS Electromagnetics software on a Linux-

based machine:
• Obtain the prerequisites as listed in chapter 1.
• Obtain a license file.
• Verify disk space.
• Install the ANSYS Electromagnetics software.
• Set up a license server if prompted to do so.

Installing ANSYS Electromagnetics Software 2-1

ANSYS Electromagnetics Suite 16.0 - © SAS IP, Inc. All rights reserved. - Contains proprietary
and confidential information of ANSYS, Inc. and its subsidiaries and affiliates.
ANSYS Electromagnetics Unix/Linux Installation Guide

Obtaining a License File

ANSYS Electromagnetics requires a license for all soft-
ware. If you do not have a license file for the ANSYS
Electromagnetics software you are about to install, con-
tact your ANSYS sales representative. See "License File"
on page 1-2 for more information.

Verifying that Enough Disk Space is Available

The amount of disk space required by the ANSYS Electro-
magnetics software depends on which packages you are
installing. Refer to the hardware requirements for each
package you have purchased for more details. During the
setup of a particular installation, you are informed of
the disk space requirements for that software.
You need sufficient disk space in the following directo-
ries:
• The directory where the software is installed.
• The directory where the software stores temporary
files while solving a project.

Note: On every machine where you are going to run the

software, you also need enough swap space to
accommodate at least the amount of RAM on the
machine. Contact your system administrator if you
have questions about swap space.

2-2 Installing ANSYS Electromagnetics

ANSYS Electromagnetics Suite 16.0 - © SAS IP, Inc. All rights reserved. - Contains proprietary
and confidential information of ANSYS, Inc. and its subsidiaries and affiliates.
 ANSYS Electromagnetics Unix/Linux Installation Guide

Installing the Software

To install ANSYS Electromagnetics software:
1. If you have received a CD or DVD for the ANSYS Electro-
magnetics product you wish to install, insert it into
the CD-ROM drive and run install from the top-level
directory of the CD-ROM.
If you downloaded the ANSYS Electromagnetics product
from ANSYS Electromagnetics software downloads website
(see "Additional Resources" on page 1-9), unzip the
download, and run the install file in the newly cre-
ated directory.
An initial Installation Shell screen automatically
appears.
2. Click Install <Product> for the product you want to
install.
An Welcome screen appears.

Note If you receive an error that InstallShield did not

find enough temporary space to run, set your
ISHIELD_TMP environment variable to a different
directory.
1. Exit the installation.
2. Go to a prompt window, and type the following:
setenv ISHIELD_TMP <newdir> (csh)
export ISHIELD_TMP=<newdir> (bash)
3. Return to step 1 on page 2-3.
3. Click Next.
The License Agreement screen appears.
4. Read the license agreement carefully. Click I accept
the terms of the license agreement if you agree to the
terms of the license agreement.
5. Click Next.
The Choose Destination Location screen appears.
6. Under Directory Name, do one of the following to spec-
ify a path:
• Accept the default installation directory as it
appears under Directory Name.
• To select a different existing directory, either
type the path directly, or browse to the location
Installing ANSYS Electromagnetics Software 2-3
ANSYS Electromagnetics Suite 16.0 - © SAS IP, Inc. All rights reserved. - Contains proprietary
and confidential information
ANSYS Electromagnetics Unix/Linux Installation Guide

by clicking Browse. When you click Browse, the

Select a Directory window appears. Select a direc-
tory, and click Open. If you have installed other
ANSYS Electromagnetics software, we recommend that
you install new software in the same directory.
• To create a new directory, either type the path
directly, or browse to the location for the new
directory by clicking Browse. When you click
Browse, the Select a Directory window appears.
Enter the new directory name in the Enter file name
field, and click Open.

Note Multiple machines/nodes can run from the same

installation tree. You do not have to install the
application on each unix/linux machine/node. ANSYS
Electromagnetics recommends installing to a
network path.

7. Click Next.
Depending on the software and version being installed,
one or both of the following screens may appear before
the Select License Information screen: the Choose Tem-
porary Directory Location screen and/or the Select
Library Option screen.
8. If the Temporary Directory Location screen appears,
select a default location for all simulations (includ-
ing local) to use as a temporary work space.
• If desired, change the temporary directory assign-
ment. You can edit the field directly or use the
Browse button to display file browser to let you
navigate the directories on your machine and net-
work.
• If desired, check the option to add read/write per-
missions for all users. If the installation will be
used for remote simulation by multiple users, all
users must have permissions on the temporary direc-
tory.
9. If the Choose Library Option screen appears, do one of
the following to specify the location of ANSYS Elec-

2-4 Installing ANSYS Electromagnetics

ANSYS Electromagnetics Suite 16.0 - © SAS IP, Inc. All rights reserved. - Contains proprietary
and confidential information of ANSYS, Inc. and its subsidiaries and affiliates.
 ANSYS Electromagnetics Unix/Linux Installation Guide

tromagnetics libraries:
Note ANSYS Electromagnetics libraries are large
databases of electronic components, developed by
ANSYS and various manufacturers.
• Click This local installation to copy and install
the default ANSYS Electromagnetics component
libraries, and then click Next.
• Click The following common location to use librar-
ies that are already installed (locally or on the
network). Click Browse, select the appropriate
path, and click OK. Click Next.
10.Click Next.
The License Information screen appears.

Installing ANSYS Electromagnetics Software 2-5

ANSYS Electromagnetics Suite 16.0 - © SAS IP, Inc. All rights reserved. - Contains proprietary
and confidential information
ANSYS Electromagnetics Unix/Linux Installation Guide

11.Select one of the following three license options:

I have a new I want to specify a I want to keep the
license file license server current license
Select this if you are configuration
Select this if you
using a counted license configuaconfigurat
recently received a
and already know on ion
license file from ANSYS Select this if you
(either evaluation or which machine the ANSYS already have a
purchased). License Manager is/will license file for
be installed. previous ANSYS
a. Click Next.
a. Click Next. software and want
Another License
Information window Another License to keep the same
appears, asking you to Information window configuration.
specify a directory and appears, asking if you • Click Next.
license file. want to use a single
server or a redundant
b. Click Browse.
server.
The Select License File
b. Select or clear the
window appears.
Specify redundant
c. Find and select the servers check box, and
license file you enter the server
received from ANSYS name(s) in the
Electromagnetics. Click field(s).
Open, and then click
The redundant-server
Next.
setup requires three
d. If prompted, enter license servers, each
the name of the license serving an identical
server. You may also license file. The order
select or clear the in which the servers
Specify server TCP/IP are entered must match
port number (advanced) the license files on
option. Specifying a each server.
TCP/IP port means that
c. Select or clear the
the software only looks
Specify server TCP/IP
at that port for
port number (advanced)
licenses. The default
option. Specifying a
port for the ANSYS
TCP/IP port means that
License Manager is 1055.
the software only looks
e. Click Next.. at that port for
licenses. The default
port for the ANSYS
License Manager is
1055.

2-6 Installing ANSYS Electromagnetics

ANSYS Electromagnetics Suite 16.0 - © SAS IP, Inc. All rights reserved. - Contains proprietary
and confidential information of ANSYS, Inc. and its subsidiaries and affiliates.
 ANSYS Electromagnetics Unix/Linux Installation Guide

For additional information about the three license

options, click Help me decide which of the following
options to choose.
12.In the Summary Information screen, review the informa-
tion displayed under Current Settings, and then do one
of the following:
• If the settings are correct, click Next to start
copying files.
• If the settings are incorrect, click Back as many
times as necessary, and change your selections.
Verify each screen again before clicking Next to
move on to the next screen. When all information is
correct, return to the Summary Information screen,
and click Next.
The Setup Status screen appears, displaying a progress
bar, and installation begins.
Once the files have all been copied, a message appears
telling you to verify that the latest version of ANSYS
License Manager is installed on the machine you speci-
fied as the license server.

Note If you receive a message about read-only files, you

typically want to overwrite them with the newer
versions.

13.Click OK in the message.

When the installation is complete, a Setup Complete
window appears for the product you installed.
14.Click Finish.

Installing ANSYS Electromagnetics Software 2-7

ANSYS Electromagnetics Suite 16.0 - © SAS IP, Inc. All rights reserved. - Contains proprietary
and confidential information
ANSYS Electromagnetics Unix/Linux Installation Guide

Integrating ANSYS Electromagnetics Products

with ANSYS Workbench
After the installation is complete, you can integrate
ANSYS Electromagnetics with ANSYS Workbench by running
the following command:
<install_dir>/AnsysEM16.0/Linux64/scripts/
IntegrateWithANSYS160.pl.
and following the prompts for integration.

2-8 Installing ANSYS Electromagnetics

ANSYS Electromagnetics Suite 16.0 - © SAS IP, Inc. All rights reserved. - Contains proprietary
and confidential information of ANSYS, Inc. and its subsidiaries and affiliates.
 3
Remote Simulation

Remote Simulations
Most ANSYS Electromagnetics products offer remote simula-
tion capabilities, where you can run a simulation on a
different machine from the one on which the ANSYS Elec-
tromagnetics software was started. This is particularly
useful if you want to take advantage of a more powerful
machine but it is not convenient to directly access that
machine. This can also be extended into distributed anal-
ysis, where a specified analysis, if supported, is con-
currently solved on multiple processors and/or multiple
nodes.
ANSYS Electromagnetics supports its own Remote Simulation
Management (RSM) software, as well as a number of High
Performance Computing (HPC) software management programs
(see "High Performance Computing (HPC) Integration" on
page 3-9).

Remote Simulation 3-1

ANSYS Electromagnetics Suite 16.0 - © SAS IP, Inc. All rights reserved. - Contains proprietary
and confidential information
ANSYS Electromagnetics Unix/Linux Installation

When do you need RSM?

RSM is in general required if you want to run remote or
distributed simulations. However, if you have a separate
scheduling system that ANSYS Electromagnetics supports,
and you plan to run batchsolve simulations only, then you
may not need to install RSM (see "High Performance Com-
puting (HPC) Integration" on page 3-9).

3-2 Remote Simulation

ANSYS Electromagnetics Suite 16.0 - © SAS IP, Inc. All rights reserved. - Contains proprietary
and confidential information
 ANSYS Electromagnetics Unix/Linux Installation

Installation/Configuration Overview
Both RSM and ANSYS Electromagnetics applications can be
installed in one central location. You do not have to
install the application on each machine/node. We recom-
mend using the network-based directions below.
Network Installation: Overview
1. Install all ANSYS Electromagnetics products in a net-
work location accessible from all machines. See
"Installing the Software" on page 2-3 for details on
installing an ANSYS Electromagnetics product.
2. Install RSM in a network location accessible from all
machines.
3. On every machine, configure and start RSM.
4. On one machine, register ANSYS Electromagnetics prod-
uct installations with RSM.
Non-Network Installation: Overview
1. Install ANSYS Electromagnetics products on every
machine. See "Installing the Software" on page 2-3 for
details on installing an ANSYS Electromagnetics prod-
uct.
2. Install RSM on every machine.
3. On every machine, configure and start RSM.
4. On every machine, register ANSYS Electromagnetics
product installations with RSM.

Remote Simulation 3-3

ANSYS Electromagnetics Suite 16.0 - © SAS IP, Inc. All rights reserved. - Contains proprietary
and confidential information
ANSYS Electromagnetics Unix/Linux Installation

Installing RSM
To install ANSYS Electromagnetics RSM software:
1. If you have received a CD or DVD for the ANSYS Electro-
magnetics product you wish to install, insert it into
the CD-ROM drive and run install from the top-level
directory of the CD-ROM.
If you downloaded the ANSYS Electromagnetics product
from ANSYS Electromagnetics software downloads website
(see "Additional Resources" on page 1-9), unzip the
download, and run the install file in the newly cre-
ated directory.
An initial Installation Shell screen automatically appears.
2. Click Install RSM for the product you want to install.
A Welcome screen appears.

Note If you receive an error that InstallShield did not

find enough temporary space to run, set your
ISHIELD_TMP environment variable to a different
directory.
1. Exit the installation.
2. Go to a prompt window, and type the
following:
setenv ISHIELD_TMP <newdir> (csh)
export ISHIELD_TMP=<newdir> (bash)
3. Return to step 1.

3. To install the ANSYS Electromagnetics Remote Simula-

tion Manager, click Next.
The License Agreement screen appears.
4. Read the license agreement carefully. Click I accept
the terms of the license agreement if you accept the
terms of the agreement.
5. Click Next.
The Choose Destination Location screen appears.
6. Under Directory Name, do one of the following to accept the default
path or specify a new one:
• Accept the default installation directory listed

3-4 Remote Simulation

ANSYS Electromagnetics Suite 16.0 - © SAS IP, Inc. All rights reserved. - Contains proprietary
and confidential information
 ANSYS Electromagnetics Unix/Linux Installation

under Directory Name.

• To select a different directory, click Browse. The
Select a directory window appears. Select a directory,
and click OK. If you have other ANSYS Electromagnetics software,
we recommend that you install new software in the same directory.
To create a new directory from the Select a direc-
tory window, navigate to the desired location, and
click the Create a New Folder icon. Enter the new
name in the File name field. Click OK to close the
Select a directory window.
7. Click Next from the Remote Simulation Manager Setup.
A summary information window appears, listing the
location where the ANSYS Electromagnetics Remote Simu-
lation Manager will be installed, and the total size.
8. Click Next.
The install executes and installation summary appears.
9. Click Finish to close the install window.

Remote Simulation 3-5

ANSYS Electromagnetics Suite 16.0 - © SAS IP, Inc. All rights reserved. - Contains proprietary
and confidential information
ANSYS Electromagnetics Unix/Linux Installation

Configuring RSM
General RSM syntax
RSM's command-line interface uses an LSB-compliant syn-
tax:
<path to RSM installation>/rsm/ansoftrsmservice command,
where command includes:
• help : Show full details of all RSM command options

• start : Start RSM

• status : Show status of RSM
• stop : Stop RSM

• condrestart : Restart RSM if it is already running

• restart : Restart RSM, or start it if it is not running
• reload : Restart RSM, or start it if it is not running
(same as restart)

• startonboot : Configure RSM to start automatically on

boot as root (command must be run as root)
• startonboot -user <username>: Configure RSM to start
automatically on boot as a specific user (command must
be run as root)
Determining Who Should Run RSM
The user who runs RSM determines who launches solver pro-
cesses.

User running
User who owns/launches solver processes
RSM
Non-root user User running RSM
root User who requests to solve, or if that
user does not exist on this machine, the
user who is running RSM

First-time RSM configuration

RSM should be configured to start automatically on boot
on each node to which remote simulation requests will be
sent. You must also decide which user will run RSM
("Determining Who Should Run RSM" on page 3-6).
3-6 Remote Simulation
ANSYS Electromagnetics Suite 16.0 - © SAS IP, Inc. All rights reserved. - Contains proprietary
and confidential information
 ANSYS Electromagnetics Unix/Linux Installation

To configure RSM to start automatically as a specific

user, run:
<path to RSM installation>/rsm/ansoftrsmservice starton-
boot -user <username>
This option will write the appropriate files in /etc/rc.d
as well as start the RSM service as that user.

Remote Simulation 3-7

ANSYS Electromagnetics Suite 16.0 - © SAS IP, Inc. All rights reserved. - Contains proprietary
and confidential information
ANSYS Electromagnetics Unix/Linux Installation

Registering ANSYS Electromagnetics Product

Engines for use with RSM
You must make each installation of RSM aware of each ANSYS
Electromagnetics product, so that remote simulation
requests are properly routed to the product. For network
installations, you need only to register each ANSYS Elec-
tromagnetics product once, regardless of the number of
machines. Otherwise, you need to register each ANSYS
Electromagnetics product on each machine running RSM.
Registration of ANSYS Electromagnetics products is han-
dled through RegisterEngineswithRSM.pl, located in the
product installation directory (for example, /apps/
ansoft/AnsysEM16.0/RegisterEnginesWithRSM.pl).
RegisterEnginesWithRSM.pl syntax
<product-specific installation directory>/Regis-
terEnginesWithRMS.pl command, where command includes:
• add : Add this product installations’s RSM engines to
RSM
• help : Show full details of all RegisterEnginesWi-
thRSM.pl command options
• remove : Remove this product installation’s engines
from RSM
• status : Show RSM registration status for each RSM
engine

3-8 Remote Simulation

ANSYS Electromagnetics Suite 16.0 - © SAS IP, Inc. All rights reserved. - Contains proprietary
and confidential information
 ANSYS Electromagnetics Unix/Linux Installation

High Performance Computing (HPC) Integration

Many ANSYS Electromagnetics products offer a direct inte-
gration with a number of High Performance Computing (HPC)
software programs for batchsolves. This direct integra-
tion does not require Remote Simulation Management.
HPC Prerequisites
1. You must use a supported High Performance Computing
(HPC) management software program accessible from all
machines. The list of currently-supported HPC software
includes:
• Platform Load Sharing Facility (LSF) 7.0.6, 8.0.1,
or 9.1.1
• Microsoft Windows® HPC Server 2008 R2 SP4 or HPC
Server 2012
• PBS Pro 10.1.0.91350 from Altair Engineering
• Grid Engine - SGE: 6.2u6, OGS: GE 2011.11, or
Univa: 8.1.3
2. ANSYS Electromagnetics products must be accessible
from the same directory on all machines.
HPC Installation and Configuration
Because HPC is offered as a direct integration, you need
only install the ANSYS Electromagnetics software pro-
grams. No additional configuration is required.
Job Submission
ANSYS Electromagnetics’s HPC integration allows you to
submit jobs directly using ANSYS’s command line arguments
for batchsolves. Please refer to your product documenta-
tion for batchsolve command line syntax. Note that you
must pass in a -distributed flag as part of the ANSYS com-
mand line arguments if you want to run a distributed sim-
ulation.

Remote Simulation 3-9

ANSYS Electromagnetics Suite 16.0 - © SAS IP, Inc. All rights reserved. - Contains proprietary
and confidential information
ANSYS Electromagnetics Unix/Linux Installation

3-10 Remote Simulation

ANSYS Electromagnetics Suite 16.0 - © SAS IP, Inc. All rights reserved. - Contains proprietary
and confidential information
 4
Install Common Libraries

The Installation CD includes an Install Common Libraries

option which installs a superset of materials, compo-
nents, and other libraries. This option allows customers
to place ANSYS Electromagnetics Libraries in a common
location, so multiple users and multiple ANSYS Electro-
magnetics products may share the same libraries. You can
also add custom materials and components that will be
automatically accessible to all users and products that
use this common library location.

Install Common Libraries 4-1

ANSYS Electromagnetics Suite 16.0 - © SAS IP, Inc. All rights reserved. - Contains proprietary
and confidential information
ANSYS Electromagnetics Unix/Linux Installation

Procedure for Installing Common Libraries

To install ANSYS Electromagnetics Common Libraries:
1. If you have received a CD or DVD for the ANSYS Electro-
magnetics product you wish to install, insert it into
the CD-ROM drive and run install from the top-level
directory of the CD-ROM.
If you downloaded the ANSYS Electromagnetics product
from ANSYS software downloads website (see "Additional
Resources" on page 1-9), unzip the download, and run
the install file in the newly created directory.
An initial Installation Shell screen automatically
appears.
2. Click Install Common Libraries.
The Welcome screen appears. The initial options differ
depending on whether you have previously installed
libraries or are doing a first or clean install.
3. Click Next.
The License Agreement screen appears.
4. Read the license agreement carefully. Click th e radio
button for “I accept the terms of the agreement.”
5. Click Next.
The Choose Destination Location screen appears.
6. Under Destination Folder, do one of the following to
accept the default path or specify a new one:
• Accept the default installation directory listed
under Destination Folder.
• To select a different directory, click Browse. The
Choose Folder window appears. Select a directory,
and click OK. If you have other ANSYS Electromag-
netics software, we recommend that you install new
software in the same directory.
• To create a new directory, click Browse. The Choose
Folder window appears. Enter the new name in the
Path field, and click OK.
7. Click Next.
The Review Settings Before Copying Files screen
appears. If you want to change anything, click Back.
8. To go ahead, click Next.
9. The Setup Status dialog shows the progress of the

4-2 Install Common Libraries

ANSYS Electromagnetics Suite 16.0 - © SAS IP, Inc. All rights reserved. - Contains proprietary
and confidential information
 ANSYS Electromagnetics Unix/Linux Installation

install. When the install has completed, the Finish

dialog displays.
10.Click Finish to close the dialog.

Install Common Libraries 4-3

ANSYS Electromagnetics Suite 16.0 - © SAS IP, Inc. All rights reserved. - Contains proprietary
and confidential information
ANSYS Electromagnetics Unix/Linux Installation

4-4 Install Common Libraries

ANSYS Electromagnetics Suite 16.0 - © SAS IP, Inc. All rights reserved. - Contains proprietary
and confidential information
 5
Updating Software and
Licenses

After installation, you may need to reinstall the soft-

ware, update a license, or add a software component, such
as a library.

Updating Software and Licenses 5-1

ANSYS Electromagnetics Suite 16.0 - © SAS IP, Inc. All rights reserved. - Contains proprietary
and confidential information of ANSYS, Inc. and its subsidiaries and affiliates.
ANSYS Electromagnetics Unix/Linux Installation Guide

Updating ANSYS Electromagnetics Software

To update ANSYS Electromagnetics software:
1. If you have received a CD for the ANSYS Electromagnet-
ics product you wish to install, insert it into the CD-
ROM drive, and run install from the top-level direc-
tory of the CD-ROM.
If you downloaded the ANSYS Electromagnetics product
from the ANSYS Electromagnetics software downloads
website (see page 1-9), unzip the download, and run
the install file in the newly created directory.
2. Run install, which is located in the top-level direc-
tory where the CD-ROM is mounted (for example, /cdrom/
cdrom0/install).
The initial Installation Shell screen automatically
appears.
3. Click Install <Product> for the product you want to
reinstall.
An Installation Shell window appears.
4. Follow the instructions as you would for a regular
software installation. Make sure to specify the same
directory as the previous installation.
See Chapter 2, "Installing the Software," for more
details.
5. On the License Information screen, select the new
license file.

Note Select I have a new license file to change the

license file (if you received a new one from ANSYS
Electromagnetics, either evaluation or purchased).
Select I want to specify a license server if you
need to change the name of the machine where the
ANSYS License Manager is installed.
See page 2-6 for more details on available license
options.

6. When you reach the Summary Information screen, review

the information displayed under Current Settings, and
then do one of the following:
• If the settings are correct, click Next to start
copying files.

5-2 Updating Software and Licenses

ANSYS Electromagnetics Suite 16.0 - © SAS IP, Inc. All rights reserved. - Contains proprietary
and confidential information of ANSYS, Inc. and its subsidiaries and affiliates.
 ANSYS Electromagnetics Unix/Linux Installation Guide

• If the settings are incorrect, click Back as many

times as necessary, and change your selections.
Verify each screen again before clicking Next to
move on to the next screen. When all information is
correct, return to the Summary Information screen,
and click Next.
The Setup Status screen appears, displaying a progress
bar, and the update begins.
When the software update is complete, a Setup Complete
window appears for the product you installed.
7. Click Finish.

Updating Software and Licenses 5-3

ANSYS Electromagnetics Suite 16.0 - © SAS IP, Inc. All rights reserved. - Contains proprietary
and confidential informationof ANSYS, Inc. and its subsidiaries and affiliates.
ANSYS Electromagnetics Unix/Linux Installation Guide

Updating a Software License

There may be times when you need to update a software
license. This may occur for a number of reasons, such as:
• When you change servers. You need to
1. Install ANSYS License Manager on the new server
machine, and add the new license file.
2. Run each ANSYS Electromagnetics software installa-
tion in Maintenance mode, and specify the names of
the new servers.
• When you receive an updated purchased license file.
You only need to update the license file using the
ANSYS License Manager.
If you are changing the name of the license server used by
the software, you need to modify the client installation:
1. Click Start>All Programs>ANSYS Electromagnetics.
2. Click the desired ANSYS product program folder, and
then click <ANSYS ElectromagneticsProduct> Mainte-
nance.
The Maintenance Mode screen appears for the desired
ANSYS Electromagnetics software.
3. Click Modify.
4. Click Next in each window.
5. On the License Information screen, select the new
license file.

Note Select I have a new license file to change the

license file (if you received a new one from ANSYS
Electromagnetics, either evaluation or
purchased).
Select I want to specify a license server if you
need to change the name of the machine where the
ANSYS License Manager is installed.
See page 2-6 for more details on available license
options.

5-4 Updating Software and Licenses

ANSYS Electromagnetics Suite 16.0 - © SAS IP, Inc. All rights reserved. - Contains proprietary
and confidential information of ANSYS, Inc. and its subsidiaries and affiliates.
 6
Message Passing Interface
(MPI) Installation

The two supported Message Passing Interface (MPI) options

in ANSYS Electromagnetics Suite are Platform Computing
and Intel. MPI is required only when using multiple
nodes. MPI is never required when solving on a single
node.
This chapter provides information about the Linux instal-
lations of MPI:
Linux
Follow these steps for a Linux installation.
1. Install ANSYS Electromagnetics Suite.
• The recommended installation is in a single loca-
tion on a networked drive that is available to all
machines.
• If you choose to install on each machine individu-
ally, make sure to use the same location on each
machine (for example, /share/install/).
2. Install and configure the Remote Simulation Manager
(RSM), if needed.
• The local machine is the machine on which you are
running the desktop. If you set up your simulations
so that the first machine in the distributed
machine list is the local machine, you do not need
to install or run the RSM.
• If you are running through a scheduler, the sched-
uler will launch the simulation, and RSM is not

Message Passing Interface (MPI) Installation 6-1

ANSYS Electromagnetics Suite 16.0 - © SAS IP, Inc. All rights reserved. - Contains proprietary
and confidential information of ANSYS, Inc. and its subsidiaries and affiliates.
ANSYS Electromagnetics Unix/Linux Installation Guide

needed.
• If the first machine in the distributed machine
list is not the local machine and you are not run-
ning through a scheduler, then RSM must be used.
RSM needs to be installed and running on the remote
machine that will host the simulation, and the
ANSYS Electromagnetics Suite installation must be
registered with RSM on that machine (see the Remote
Analysis topic in the online help for details).
3. Configure MPI.

Note It is not necessary to install MPI on any machine:

both Platform Computing and Intel MPI are provided
in the ANSYS Electromagnetics Suite installation.

Set up passwordless ssh to enable communication

between machines that will be used in the simulation.
At a minimum, this must be set up from the simulation
host machine (the first machine in the distributed
machine list) to all of the remaining machines.
It is also possible to use RSH, but this is not recom-
mended.
4. Define the temp directory on all machines, assigning
Full Control to the designated user.
5. If a firewall is installed, it should be off or config-
ured as specified in the Firewall Configuration topic
in the online help.
6. Select which MPI to use in MPI Vendor box on the
Options tab under Tools > Options > HPC and Analysis
Options. Also select whether to use SSH or RSH (SSH is
recommended).
7. If you choose a remote machine to host the simulation,
then RSM needs to be installed and running on that
remote machine. There are two RSM settings that can
affect the simulation. The first is the user who is
running RSM. The second setting is in the Desktop in
Tools > Options > General Options on the Remote Analy-
sis Options tab. Choose to send the analysis request
as a Service User or a Specified User. Here is addi-

6-2 Message Passing Interface (MPI) Installation

ANSYS Electromagnetics Suite 16.0 - © SAS IP, Inc. All rights reserved. - Contains proprietary
and confidential information of ANSYS, Inc. and its subsidiaries and affiliates.
 ANSYS Electromagnetics Unix/Linux Installation Guide

tional information about these settings:

Remote Simulation runs

RSM User Simulation on remote machine Notes
Options as
root Service User The user who is RSM will try to
running the ANSYS run as the user,
Electromagnetics but may fail
desktop based on local
privileges
root Specified user_A Runs as user_A
User =
user_A
User_A Service User user_A Runs as user_A
User_A Specified Will fail due to Not recommended
User = privileges
user_B

General Notes
If using a scheduler (for example, SGE or LSF) with a net-
work installation, the installation, setup and execution
are the same as for previous releases. If there are any
questions, refer to the online help for more information.
If you are interested in controlling which MPI Vendor to
use with Batchoptions, the option for setting this is:
'HFSS/MPIVendor'=Platform Computing
'HFSS-IE/MPIVendor'=Platform Computing
'Q3D Extractor/MPIVendor'=Platform Computing
or
'HFSS/MPIVendor'=Intel
'HFSS-IE/MPIVendor'=Intel
'Q3D Extractor/MPIVendor'=Intel

Setting up passwordless ssh

1. First verify that passwordless ssh is not already con-
figured by running the following command on one node
to access another:
ssh <remote node> echo hi

Message Passing Interface (MPI) Installation 6-3

ANSYS Electromagnetics Suite 16.0 - © SAS IP, Inc. All rights reserved. - Contains proprietary
and confidential informationof ANSYS, Inc. and its subsidiaries and affiliates.
ANSYS Electromagnetics Unix/Linux Installation Guide

If you receive a response of hi, then passwordless ssh

is already configured between this node and the remote
node. Otherwise, you will need to configure password-
less ssh. If you have already configured passwordless
ssh and it is not working, you should run the following
command to obtain information for diagnosing the prob-
lem:
ssh -v -v -v <remote node> echo hi
Configuring passwordless ssh for the first time
1. Generate ssh key by entering the following:
ssh-keygen -t rsa
2. Save the file to the default location ($HOME/.ssh/
id_rsa).
3. Press Enter for no passphrase.
4. Press Enter again to confirm no passphrase.
5. Ensure that permissions for the following directories
are correct:
• chmod go-w ${HOME}
• chmod 700 ${HOME}/.ssh
• chmod 600 ${HOME}/.ssh/id_rsa
6. Append your personal public key file to your personal
authorized_keys list
cat ${HOME}/.ssh/id_rsa.pub >> ${HOME}/.ssh/autho-
rized_keys
(if required) cat ${HOME}/.ssh/id_rsa.pub >> ${HOME}/
.ssh/authorized_keys2
7. Test that local passwordless ssh is working.
ssh <local node> echo hi
If you are prompted for a password, there is probably
an access issue. Run ssh -v -v -v <local node> to
obtain information for diagnosing the problem.
8. The next steps depend on whether you have a user-spe-
cific HOME directory that is shared across machines.
If so, in most cases it is sufficient to test that
remote passwordless ssh is working to one node:
ssh <remote node> echo hi
• If the command returns hi, you probably have a
shared HOME directory, and the configuration is

6-4 Message Passing Interface (MPI) Installation

ANSYS Electromagnetics Suite 16.0 - © SAS IP, Inc. All rights reserved. - Contains proprietary
and confidential information of ANSYS, Inc. and its subsidiaries and affiliates.
 ANSYS Electromagnetics Unix/Linux Installation Guide

complete. If it fails, then you need to diagnose

the failure by running ssh -v -v -v <remote node> to
obtain information for diagnosing the problem.
• If you know that your HOME directory is not shared,
you need to copy the contents of your local
id_rsa.pub file to the authorized_keys file on the
remote machine:
cat ${HOME}/.ssh/id_rsa.pub | ssh <remote node>
'cat >> ${HOME}/.ssh/authorized_keys' | 'chmod 600
${HOME}/.ssh/authorized_keys'
Run ssh <remote node> echo hi to verify that you can
log into the remote node from the local node.
Troubleshooting Section
• I am getting an error message that mentions AnsoftRSM-
Service. Is there a problem with my installation?
[error] Unable to locate or start COM engine on
'your_machine_name_here' : Unable to reach Ansof-
tRSMService. Check if the service is running and if
the firewall allows communication…
Do not immediately assume there is a problem with RSM,
especially if your_machine_name_here is your local
machine. The message is stating that it cannot start
the Com engine. This can be the result of a misspelled
machine name or an issue with the firewall. Check
these first.
If the host machine is a remote machine (your_ma-
chine_name_here is a remote computer), there might be
an issue with the RSM service on the remote computer.
Check the RSM installation and registration on that
machine.
• Is there an easy way to test the computers in my Dis-
tributed Machine Configurations?
1. Select HPC and Analysis Options.
2. Click Edit, and select one or more machine names in
the list on the Machines for Distributed Analysis
dialog.
3. Click the Test Machines button. A set of tests will
be run from the current machine to the selected
machines that includes pinging the computer and
checking the RSM availability.

Message Passing Interface (MPI) Installation 6-5

ANSYS Electromagnetics Suite 16.0 - © SAS IP, Inc. All rights reserved. - Contains proprietary
and confidential informationof ANSYS, Inc. and its subsidiaries and affiliates.
ANSYS Electromagnetics Unix/Linux Installation Guide

• When I attempt to simulate, I get the following error

message:
[error] The attempted launch of solvers via MPI
failed while connecting to communication pipes.
The probable cause is failure to install the vendor
MPI on one or more machines or password authentica-
tion failure for MPI during the launch attempt.
Followed by
Unable to create child process: mpirun.
Possible causes for the messages are:
• MPI is not installed on one or more machines.
• The wrong version of MPI is installed on one or more
machines.
• The password registration is incorrect on one or
more machines.
• ANSYS Electromagnetics Suite is not installed in
the same location on all machines.
• There is an issue with the firewall.
• When I attempt to simulate, I get the following error
message:
[error] Distributing matrix solutions for domains,
process mpirun error: Simulation directory creation
failed for one or more MPI solvers. Check access
privileges and disk space for the following:…
This message means you do not have the correct privi-
lege for the temp directory on one or more of the
remote machines. In many cases the software uses the
installation temp directory that is defined during the
ANSYS Electromagnetics Suite installation on the given
machine. It is recommended that this directory be set
for Everyone to have full Read/Write privileges on all
machines.
• My setup was working last week, but today I am getting
a password authentication failure error.
This error may occur if anything changed in your net-
work configuration. The most common cause is your
login password was changed as part of a periodic
update for network security. If the passwords were
registered for MPI, they need to be updated on all
machines every time the login passwords are changed.

6-6 Message Passing Interface (MPI) Installation

ANSYS Electromagnetics Suite 16.0 - © SAS IP, Inc. All rights reserved. - Contains proprietary
and confidential information of ANSYS, Inc. and its subsidiaries and affiliates.
 ANSYS Electromagnetics Unix/Linux Installation Guide

• When I attempt to simulate with a solver utilizing MPI

on a local Linux network I get an error message:
Unable to create child process: <solver name>
This often happens if there is an issue with the host
key based authentication. When this happens check the
terminal (console) where you launched the software for
a warning:
The authenticity of host '<hostname> (<ip
address>)' can't be established.
Manually initiate an ssh connection from your current
machine to this host using the exact hostname as
listed in the warning and answer yes at the prompt to
save the host key.

Message Passing Interface (MPI) Installation 6-7

ANSYS Electromagnetics Suite 16.0 - © SAS IP, Inc. All rights reserved. - Contains proprietary
and confidential informationof ANSYS, Inc. and its subsidiaries and affiliates.
ANSYS Electromagnetics Unix/Linux Installation Guide

6-8 Message Passing Interface (MPI) Installation

ANSYS Electromagnetics Suite 16.0 - © SAS IP, Inc. All rights reserved. - Contains proprietary
and confidential information of ANSYS, Inc. and its subsidiaries and affiliates.
 A
Silent Installation

When you use the ANSYS Electromagnetics silent installa-

tion feature, the software is installed on your computer
with no graphical interface appearing during the instal-
lation process. InstallShield suppresses all dialog
boxes, including error messages and informational message
boxes.
To install ANSYS Electromagnetics software on a Linux
machine using a silent installation:
• Obtain a license file for the software you are
installing.
• Install the ANSYS Electromagnetics software from a
command prompt, as described in this chapter.

Silent Installation A-1

ANSYS Electromagnetics Suite 16.0 - © SAS IP, Inc. All rights reserved. - Contains proprietary
and confidential information
ANSYS Electromagnetics Unix/Linux Installation

Running the Silent Installation

To install ANSYS Electromagnetics software on a Unix
machine using a silent installation, you need to record a
response file, and then use that file to install the soft-
ware on other similar computers.
To record a response file:
1. Go to the command prompt.
2. At the command line, use the cd command to change to
the product subdirectory (which contains the file
setup.exe).
3. Do the following to run Setup in Initial mode to record
the response file:
setup.exe -options-record "<response file name>"
See "Response File" on page A-4 for an example of a typi-
cal response file.
To install the software on other similar computers (i.e.,
replay the response file):
1. Copy the response file so that you can use it on the
other computers.
2. On other computers where you want to install the soft-
ware, go to the command prompt, and change to the
directory containing setup.exe.
3. Type the following, and press ENTER:
setup.exe -options "<response file name>" -silent

Note Although each value is commented, there is no way

to display feedback if the information is invalid.
Therefore, be careful with the syntax and spacing
of the commands.

In silent mode, no confirmation windows of any kind are

displayed. In this mode, InstallShield suppresses all
dialog boxes, including error messages and informational
message boxes.
Any line in the response file beginning with the "#" sym-
bol is a comment. Blank lines are ignored.

A-2 Silent Installation

ANSYS Electromagnetics Suite 16.0 - © SAS IP, Inc. All rights reserved. - Contains proprietary
and confidential information
 ANSYS Electromagnetics Unix/Linux Installation

You can only change values to the right of the "=" sign.

Note If a failure occurs in silent mode, Setup aborts

just as if you clicked the Abort button in a wizard
dialog box during a normal installation. In this
case, an error is written to the log file.
The installation typically fails for one of the
following two reasons:
• An invalid path was specified on the command
line.
• There were differences in the dialog box
sequences between the recorded response file
and the current silent installation--for
example, an additional message appearing during
the playback due to differences in the two
computer systems. Since most computers would
normally be configured identically by a system
administrator, this problem should not occur
often.

Silent Installation A-3

ANSYS Electromagnetics Suite 16.0 - © SAS IP, Inc. All rights reserved. - Contains proprietary
and confidential information
ANSYS Electromagnetics Unix/Linux Installation

Response File
The response file contains values you specified when
recording it. It can be used to configure the silent
installation with the options you prefer.
Following is an example of a typical response file:
#########################################################
############
# InstallShield Options File
#
# Wizard name: Install
# Wizard source: setup.jar
# Created on: Wed Sep 17 14:32:59 EDT 2003
# Created by: InstallShield Options File Generator
#
# This file contains values that were specified during a
recent execution of
# Install. It can be used to configure Install with the
options specified below
# when the wizard is run with the "-options" command line
option. Read each
# setting's documentation for information on how to
change its value.
#
# A common use of an options file is to run the wizard in
silent mode. This lets
# the options file author specify wizard settings without
having to run the
# wizard in graphical or console mode. To use this options
file for silent mode
# execution, use the following command line arguments
when running the wizard:
#
# -options "settings.txt" -silent
#
#########################################################
###########

A-4 Silent Installation

ANSYS Electromagnetics Suite 16.0 - © SAS IP, Inc. All rights reserved. - Contains proprietary
and confidential information
 ANSYS Electromagnetics Unix/Linux Installation

#########################################################
###########
#
# License Agreement State
#
# The initial state of the License Agreement panel. Legal
values are:
#
# 0 - Nothing will be selected
# 1 - "I &accept the terms of the license agreement."
will be selected
# 2 - "I &do not accept the terms of the license agree-
ment." will be selected
#
# For example, to configure the panel to initially dis-
play "I &do not accept the
# terms of the license agreement.", use
#
# -W Agree.selection=2
#

-W Agree.selection=1

#########################################################
###########
#
# User Input Field - groupID
#
#

-W GroupPanel.groupID=""

#########################################################
###########
#
# Install Location
#
Silent Installation A-5
ANSYS Electromagnetics Suite 16.0 - © SAS IP, Inc. All rights reserved. - Contains proprietary
and confidential information
ANSYS Electromagnetics Unix/Linux Installation

# The install location of the product. Specify a valid

directory into which the
# product should be installed. If the directory contains
spaces, enclose it in
# double-quotes. For example, to install the product to
C:\Program Files\My
# Product, use
#
# -P installLocation="C:\Program Files\My Product"
#

-P installLocation="/usr/ansoft"
...
...
<remainder of file deleted>

A-6 Silent Installation

ANSYS Electromagnetics Suite 16.0 - © SAS IP, Inc. All rights reserved. - Contains proprietary
and confidential information
 B
License hostid

Software licenses for each module of Ansoft products you

purchased are contained in one or more license files pro-
vided by Ansoft. Each license file requires one or more
license hostids, which are physical devices that contain
a specific identification. License hostids are always
required for the license server, and they may also be
required for each machine running Ansoft software.
Each supported operating system supports certain hostids:

Operating System Permitted hostids

Windows • The ethernet address of a network
interface card (MAC address).
• Flexera FLEXid USB port hardware
key.
• Disk serial number.
To obtain the disk serial number,
open a command prompt.
Type vol <drive letter>:, for
example vol C:
Linux • The ethernet address of a network
interface card (MAC address).
• Flexera FLEXid USB port hardware
key.
Solaris Machine hostid

This utility will provide the disk id by default:

License hostid B-1

ANSYS Electromagnetics Suite 16.0 - © SAS IP, Inc. All rights reserved. - Contains proprietary
and confidential information
ANSYS Electromagnetics Unix/Linux Installation

http://www.ansys.com/Support/Licensing/Cap-
ture+License+Server+Information

B-2 License hostid

ANSYS Electromagnetics Suite 16.0 - © SAS IP, Inc. All rights reserved. - Contains proprietary
and confidential information
 ANSYS Electromagnetics Unix/Linux Installation

Network Interface Card

A network interface card is a physical device used to con-
nect to a network (also known as an ethernet card). Each
network interface card includes a unique ID that can be
used as a license hostid.
You can obtain an ethernet address to use as a valid
license hostid. The method for doing so differs depending
on whether you are running Windows or Red Hat Enterprise
Linux.
Windows
To obtain an ethernet address as a valid license hostid
when running Microsoft Windows:
1. If you are using a laptop, disconnect the laptop from
the docking station if docked.
2. Go to the command prompt.
3. Type ipconfig /all, and press Enter.
A listing of network interface cards is shown.
4. For a valid network interface card, look for the Phys-
ical Address line. The ethernet address for that
device is the value of the physical address, without
dashes.

Note Other types of adapters, including Point-to-Point

Protocol (PPTP) adapters and the Microsoft
Loopback Adapter, may be listed here. These are
not valid for license hostids.

Linux
To obtain an ethernet address as a valid license hostid
when running Red Hat Enterprise Linux:
1. If you are using a laptop, disconnect the laptop from
the docking station if docked.
2. Start a terminal session.
3. Type ip addr (normally located in the /sbin directory)
to see a listing of all active network devices.
4. Devices with an ethernet address show a Link encap
value of Ethernet. The ethernet address for each
device is the value in the HWaddr field, without
colons.

License hostid B-3

ANSYS Electromagnetics Suite 16.0 - © SAS IP, Inc. All rights reserved. - Contains proprietary
and confidential information
ANSYS Electromagnetics Unix/Linux Installation

B-4 License hostid

ANSYS Electromagnetics Suite 16.0 - © SAS IP, Inc. All rights reserved. - Contains proprietary
and confidential information
 ANSYS Electromagnetics Unix/Linux Installation

Hardware Key
Installing a Hardware Key on a USB Port
Only a single device can be installed on each USB port.
Flexera FLEXid hardware key for a USB Port
To install the hardware key on a USB
port:
1. Attach the hardware key to
the USB port.
2. If a prompt appears asking
you to install or
specify a driver, choose
Cancel.
See the ANSYS License Manager
documentation for instructions on
using USB dongles.

License hostid B-5

ANSYS Electromagnetics Suite 16.0 - © SAS IP, Inc. All rights reserved. - Contains proprietary
and confidential information
ANSYS Electromagnetics Unix/Linux Installation

Machine hostid
A machine hostid is present on most Unix machines,
including Sun machines. To determine the hostid for a
supported Unix machine, enter the following command:

Sun Solaris hostid

B-6 License hostid

ANSYS Electromagnetics Suite 16.0 - © SAS IP, Inc. All rights reserved. - Contains proprietary
and confidential information
 A
Setting Up a Printer on
Linux

To print from ANSYS Electromagnetics software on Linux,

you must first configure a printer . To do this, launch
the MainWin control panel.
1. Run ./mwcontrol & in the installation subdirectory.
The MainWin Control Panel appears.
2. Double-click on the "Printers" icon to start the Main-
Win Printers panel.
3. Then double-click on the "Add New Printer" icon.
This starts the Add Printer Wizard.
4. Select the Let the wizard search for printers radio
button and click Next.
5. In the Identify your Unix Printer dialog do one of the
following:
• If your printer is listed, select it.
• If your printer is not listed, you will need to can-
cel and get someone with root permission to setup a
printer queue on your machine (and then you will
need to come back and run this wizard later).

Note On Solaris you setup a new print queue by running

"lpadmin" (as root). On Red Hat Linux, you can run
'System Settings/Printing' to launch printconf-gui
(as root).

6. Click Next.
The Print Command dialog appears.

Setting Up a Printer on Linux A-1

ANSYS Electromagnetics Suite 16.0 - © SAS IP, Inc. All rights reserved. - Contains proprietary
and confidential information
ANSYS Electromagnetics Unix/Linux Installation

7. Change the Print Command only if instructed to do so by

your user administrator.
8. Click Next.
The Choose PPD File dialog appears.
9. Select your printer manufacturer and model from the
list or use the Choose File button to browse to a PPD
file provided by your printer manufacturer. Click
Next.
10.The Printer Name dialog appears. Enter a Name to iden-
tify the printer. Click Next.
11.Choose whether this printer should be the default and
click Next.
12.Choose whether you would like to print a test page and
click Next.
13.In the Finish Adding New Printer dialog, verify the
printer setup information. If the information is
incorrect, use the Back button to return to the appro-
priate dialog and correct the entry. If the informa-
tion is correct, click Finish to complete the setup of
your printer.
With a print queue setup, and the printer added, you
should then see the printer when running ANSYS Electro-
magnetics products.

A-2 Setting Up a Printer on Linux

ANSYS Electromagnetics Suite 16.0 - © SAS IP, Inc. All rights reserved. - Contains proprietary
and confidential information
 Index

A I
ANSYS Electromagnetics software installing
installing 2-3 Common Libraries 4-1
updating 5-2 silent installation A-1
ANSYS License Manager 1-2 installing ANSYS Electromagnet-
ANSYS software ics software 2-3
silent installation A-1
ANSYS Web site 1-9
L
libraries
C installation 4-1
changing license servers 5-4 license server 1-2
Common Libraries 4-1 Linux
computer system requirements 1-2 setting up a printer C-1
contents of product package 1-1
M
D Message Passing Interface (MPI)
disk space 6-1
verifying amount 2-2 MPI installation 6-1
documentation
about ANSYS products 1-9
about installation and con- O
figuration 1-9 online help 1-9
on ANSYS Web site 1-9 operating system 1-2

Index-1
ANSYS Electromagnetics Suite 16.0 - © SAS IP, Inc. All rights reserved. - Contains proprietary
and confidential information
ANSYS Electromagnetics Unix/Linux Installation

viewing online help 1-9

P
package contents 1-1 W
prerequisites to installation B-1
Web site, ANSYS 1-9
license server 1-2
operating system 1-2
printers
Linux C-1
Solaris C-1
processor
system requirements 1-2
product package 1-1

R
reinstalling ANSYS Electromag-
netics software 5-2
requirements
operating system 1-2

S
silent installation A-1
software
installing 2-3
silent installation A-1
updating 5-2
Solaris
setting up a printer C-1
system requirements 1-2
disk space 2-2
processor 1-2

U
updating a software license 5-4
updating ANSYS Electromagnetics
software 5-2

V
verifying
disk space available 2-2

Index-2
ANSYS Electromagnetics Suite 16.0 - © SAS IP, Inc. All rights reserved. - Contains proprietary
and confidential information