unix/linux installation...

Unix/Linux Installation Guide

ANSYS, Inc.275 Technology DriveCanonsburg, PA 15317USATel: (+1) 724-746-3304Fax: (+1) 724-514-9494General Information: [email protected] Support: [email protected]

November 2012Inventory 0000000434

The information contained in this document is subject to change with-out notice. ANSYS makes no warranty of any kind with regard to this material, including, but not limited to, the implied warranties of mer-chantability and fitness for a particular purpose. ANSYS shall not be liable for errors contained herein or for incidental or consequential damages in connection with the furnishing, performance, or use of this material.

ANSYS, Inc, is a UL registered ISO 9001:2008 company.Unauthorized use, distribution, or duplication is prohibited.© 2012 SAS IP, Inc. All rights reserved.

ANSYS, HFSS, and Optimetrics are registered trademarks or trade-marks of SAS IP, Inc. All other trademarks are the property of their respective owners.

New editions of this manual incorporate all material updated since the previous edition. The manual printing date, which indicates the man-ual’s current edition, changes when a new edition is printed. Minor corrections and updates that are incorporated at reprint do not cause the date to change.Update packages may be issued between editions and contain addi-tional and/or replacement pages to be merged into the manual by the user. Pages that are rearranged due to changes on a previous page are not considered to be revised.

Edition Date Software Version

1 May 2003 92 June 2005 103 June 2007 114 Sept 2009 125 October 2010 13.06 August 2011 14.07 November 2012 15.0

Table of ContentsTable of Contents

1. Getting Started . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-1Installation Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1Operating System Specific Prerequisites . . . . . . . . . . . . . . . . . . . . . . . 1-3Additional Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-6

2. Installing ANSYS Electromagnetics Software . . . .2-1Obtaining a License File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2Verifying that Enough Disk Space is Available . . . . . . . . . . . . . . . . . 2-2Installing the Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3

3. Install Libraries Options . . . . . . . . . . . . . . . . . . . . . .3-1Procedure for Installing Libraries . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1Update, Modify, Repair, or Remove Libraries . . . . . . . . . . . . . . . . . . 3-2

4. Remote Simulation . . . . . . . . . . . . . . . . . . . . . . . . . .4-1When do you need RSM? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1Installation/Configuration Overview . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2Installing RSM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2Configuring RSM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-3Registering ANSYS Electromagnetics Product Engines for use with RSM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-4High Performance Computing (HPC) Integration . . . . . . . . . . . . . . . . 4-5

5. Installing the License Server . . . . . . . . . . . . . . . . . .5-1Obtaining a License File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-2

Contents-1

ANSYS Electromagnetics Unix/Linux Installation Guide

FLEXlm for Ansoft Installation Overview . . . . . . . . . . . . . . . . . . . . . 5-2Installing FLEXlm for Ansoft . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-5Managing License Files After Installation . . . . . . . . . . . . . . . . . . . . . . 5-9

6. Updating Software and Licenses . . . . . . . . . . . . . . .6-1Updating ANSYS Electromagnetics Software . . . . . . . . . . . . . . . . . . 6-2Updating a Software License . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-3Uninstalling ANSYS Electromagnetics Software or the License Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-4

AppendicesA. Silent Installation

Running the Silent Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .A-2Response File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .A-4

B. License hostid Network Interface Card . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .B-2Hardware Key . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .B-3Machine hostid . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .B-4

C. Setting Up a Printer on Linux

Contents-2

1Getting Started

Installation PrerequisitesBefore installing ANSYS Electromagnetics software, you need the following: • The ANSYS Electromagnetics product CD or product download (see “Additional

Resources” on page 1-6 for download information.)• An ANSYS Electromagnetics license file.• The FLEXlm for Ansoft CD for counted evaluation and purchased licenses. (You

may also download FLEXlm for Ansoft--see “Additional Resources” on page 1-6.)

• A computer that meets the minimum or recommended system requirements, which depends on the specific ANSYS Electromagnetics products you plan to run (see product release notes for specifications).

ANSYS Electromagnetics SoftwareThe ANSYS Electromagnetics product CD or equivalent download contains:• The ANSYS Electromagnetics software product(s) and project examples.• Third-party software, when necessary, for viewing online documentation (for

example, HTML Help or Adobe Acrobat Reader). • Documentation files.• Hardware key drivers for Linux operating systems. (If you install as root, you

will be prompted to install software automatically.)The FLEXlm for Ansoft CD or equivalent download contains:• The FLEXlm for Ansoft license server software.• The Ansoft License Utility.• Hardware key drivers for Linux operating systems. (If you install as root, you

Getting Started 1-1


will be prompted to install drivers.)

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 avail-able in Appendix B, “License hostid.”ANSYS Electromagnetics licenses are either “counted” or “uncounted.” If you are installing software that was purchased, your license is counted. If you are installing evaluation software, your license may be either counted or uncounted. If the license is counted, the FLEXlm for Ansoft license server must be installed. To determine if a particular license is counted or uncounted:1. Open the license file in any text editor. (The license file is a list of text blocks.)2. If the word “Uncounted” appears in the first line of each text block, then the

license type is uncounted. Otherwise, the license type is counted, and a FLEXlm for Ansoft license server must be installed.

If you do not have a license file for the ANSYS Electromagnetics software you are about to install, please contact your ANSYS sales representative.

License Server Once you have purchased the software, you must designate a machine on your net-work to act as a license server. The FLEXlm for Ansoft license server must be installed in one of the following two locations:• On the computer where the software will be installed.• On another machine accessible over the network.

See Chapter 5, “Installing the License Server,” for FLEXlm for Ansoft installation instructions and additional licensing information.

Hardware and Software RequirementsFor supported platforms and system requirements, go to:http://www.ansys.com/Support/Platform+Support

Additional Product-Specific PrerequisitesThe product release notes may show additional product-specific prerequisites, includ-ing 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 soft-ware.

Note You can install the FLEXlm for Ansoft license server before or after you install the ANSYS Electromagnetics software.

1-2 Getting Started

http://www.ansys.com/Support/Platform+Support


Operating System Specific PrerequisitesRed 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 runtime libraries.

ApplicationsRequired Libraries to Install ApplicationsThe following minimal set of 32-bit libraries and their dependencies are required to install applications. Note that these are the minimum versions required; you may use newer versions.

glibc.i686

Required Libraries to Run ApplicationsThe 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.i686glib2.i686bzip2-libs.i686compat-expat1.i686libpng.el6.i686libtiff.i686: Also includes required dependencies:• libjpeg.i686• zlib.i686libXft.i686: Also includes required dependencies:• fontconfig.i686• freetype.i686• libXrender.i686libXxf86vm.i686

Additional Graphics LibrariesANSYS Electromagnetics applications make use of OpenGL libraries. If you experience sluggishness when interacting 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 viewANSYS recommends the use of OpenGL libraries provided by the manufacturer

Getting Started 1-3


for the graphics card in your machine. Alternately, you may consider installing the Mesa OpenGL RPM package mesa-libGL.i686 and its dependencies.

License ServerRequired Libraries to Install License ServerThe following minimal set of 32-bit libraries and their dependencies are required to install applications. Note that these are the minimum versions required; you may use newer versions.

glibc.i686compat-libstdc++-33.i686

Required Libraries to Run License ServerThe 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.i686glib2.i686bzip2-libs.i686compat-expat1.i686compat-libstdc++-33.i686libpng.el6.i686libtiff.i686: Also includes required dependencies:• libjpeg.i686• zlib.i686libXft.i686: Also includes required dependencies:• fontconfig.i686• freetype.i686• libXrender.i686libXxf86vm.i686

Additional PrerequisitesRed Hat Enterprise Linux 6.1 introduces biosdevname, an optional convention for naming network interfaces. biosdevname assigns names to network inter-faces based on their physical location. Note, however that biosdevname is dis-abled 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 standard ethernet names:

1-4 Getting Started


1. If you do not need to use the Consistent Network Device Naming package, you can remove the biosdevname package from your installation by running the following command in a terminal as root:yum remove biosdevnameThis removes the package and on reboot will restore the traditional naming scheme.

2. You can update the name in the /etc/sysconfig/network-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-persistent-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 kernel 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_Linux/6/html/6.1_Release_Notes/ar01s01.html https://fedoraproject.org/wiki/Features/ConsistentNetworkDeviceNaminghttp://rhn.redhat.com/errata/RHEA-2011-0644.htmlhttp://linux.dell.com/files/whitepapers/consistent_network_device_naming_in_linux-v.93.pdf

Getting Started 1-5

http://docs.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/6/html/6.1_Release_Notes/ar01s01.html

https://fedoraproject.org/wiki/Features/ConsistentNetworkDeviceNaming

http://rhn.redhat.com/errata/RHEA-2011-0644.html

http://linux.dell.com/files/whitepapers/consistent_network_device_naming_in_linux-v.93.pdf

http://linux.dell.com/files/whitepapers/consistent_network_device_naming_in_linux-v.93.pdf


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.ansys1.com/customer/default.asp

Online Technical Support:

Available through the ANSYS customer portal: http://www.ansys1.com/customer/default.aspUnder 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 Notes:

During installation, read the release 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 Documentation:

Getting Started Guides and other printed 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 FrameViewer.

1-6 Getting Started

http://www.ansoft.com

2Installing 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.• Obtain and install a hardware key if necessary.• Set up a license server if prompted to do so.

Installing ANSYS Electromagnetics Software 2-1


Obtaining a License FileANSYS Electromagnetics requires a license for all software. See “License File” on page 1-2 for more information. ANSYS Electromagnetics provides two types of licensing: counted and uncounted. Counted licenses require the FLEXlm for Ansoft license server, while uncounted licenses do not.When you evaluate software, you receive an evaluation license file from ANSYS Electromagnetics that may contain counted or uncounted licenses. When you pur-chase software, you receive a standard counted license. Therefore, some evaluation licenses and all purchased licenses require you to install the FLEXlm for Ansoft license server.If you do not have a license file for the ANSYS Electromagnetics software you are about to install, contact your ANSYS Electromagnetics sales representative. See “Obtaining a License File” on page 5-2 for more information.

Verifying that Enough Disk Space is AvailableThe amount of disk space required by the ANSYS Electromagnetics 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 directories:

• The directory where the software is installed.• The directory where the software stores temporary files while solving a proj-

ect.

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 Software


Installing the SoftwareTo install ANSYS Electromagnetics software:1. If you have received a CD or DVD for the ANSYS Electromagnetics 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 Electro-magnetics software downloads website (see “Additional Resources” on page 1-6), unzip the download, and run the install file in the newly created directory.An initial Installation Shell screen automatically appears.

2. Click Install <Product> for the product you want to install.An Welcome screen appears.

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 specify 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 by clicking Browse. When you click Browse, the Select a Directory window appears. Select a directory, 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

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.



the Enter file name field, and click Open.

7. Click Next.Depending on the software and version being installed, one or both of the follow-ing screens may appear before the Select License Information screen: the Choose Temporary 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 (including local) to use as a temporary work space.• If desired, change the temporary directory assignment. You can edit the field

directly or use the Browse button to display file browser to let you navigate the directorys on your machine and network.

• If desired, check the option to add read/write permissions for all users. If the installation will be used for remote simulation by multiple users, all users must have permissions on the temporary directory.

9. If the Choose Library Option screen appears, do one of the following to specify the location of ANSYS Electromagnetics libraries:

• Click This local installation to copy and install the default ANSYS Electro-magnetics component libraries, and then click Next.

• Click The following common location to use libraries 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.

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.

Note ANSYS Electromagnetics libraries are large databases of electronic components, developed by ANSYS and various manufacturers.



11. Select one of the following three license options:

For additional information about the three license options, click Help me decide which of the following options to choose.

I have a new license file

I want to specify a license server

I want to keep the current license configuration

Select this if you recently received a license file from ANSYS (either evaluation or purchased).

a. Click Next. Another License Information window appears, asking you to specify a directory and license file.

b. Click Browse. The Select License File window appears.

c. Find and select the license file you received from ANSYS Electromagnetics. Click Open, and then click Next.

d. If prompted, enter the name of the license server. You may also select or clear the Specify server TCP/IP port number (advanced) option. Specifying a TCP/IP port means that the software only looks at that port for licenses. If this option is not selected, the software searches the default 27000-27009 port range.

e. Click Next. The Review settings before copying files screen

Select this if you are using a counted license and already know on which machine FLEXlm is/will be installed.

a. Click Next. Another License Information window appears, asking if you want to use a single server or a redundant server.

b. Select or clear the Specify redundant servers check box, and enter the server name(s) in the field(s).The redundant-server setup requires three license servers, each serving an identical license file. The order in which the servers are entered must match the license files on each server.

c. Select or clear the Specify server TCP/IP port number (advanced) option. Specifying a TCP/IP port means that the software only looks at that port for licenses. If this option is not selected, software searches the default 27000-27009 port range.

d. Click Next. The Review settings before copying files screen appears.

Select this if you already have a license file for previous ANSYS software and want to keep the same configuration.

• Click Next.The Review settings before copying files screen appears.

Note You can review the current license configuration by clicking View current license configuration.



12. In 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.• 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 FLEXlm Information message appears telling you to verify that the latest version of FLEXlm for Ansoft is installed on the machine you specified as the license server.

13. Click OK in the FLEXlm Information message. When the installation is complete, a Setup Complete window appears for the product you installed.

14. Click Finish.

Note To successfully run software with counted licenses, you need to install the FLEXlm for Ansoft license server on the machine specified as the server. See “Installing the License Server” on page 5-1 for details.

Note If you supplied an uncounted evaluation license, no message appears.If you receive a message about read-only files, you typically want to overwrite them with the newer versions.

Note Multiple USB FLEXid 9 USB dongles on a machine are not supported in 64-bit Windows or Linux products.


3Install Libraries Options

The Installation CD includes an Install Libraries option which installs a superset of materials, components, and other libraries. This option allows customers to place ANSYS Electromagnetics Libraries in a common location, so multiple users and mul-tiple ANSYS Electromagnetics 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..

Procedure for Installing LibrariesTo install ANSYS Electromagnetics Libraries:1. If you have received a CD or DVD for the ANSYS Electromagnetics 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-6), unzip the down-load, and run the install file in the newly created directory.An initial Installation Shell screen automatically appears.

2. Click Install 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. If you have previously installed libraries, you see a screen that lets you Modify, Update, or Remove Libraries. See the next section.

3. Click Next.The License Agreement screen appears.

4. Read the license agreement carefully. Click Yes if you accept the terms of the agreement.The Customer Information screen appears.

Install Libraries Options 3-1


5. Enter your information in the User Name and Company Name boxes.6. Click Next.

The Choose Destination Location screen appears. 7. 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 Electro-magnetics 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.

8. Click Next. The Review Settings Before Copying Files screen appears. If you want to change anything, click Back.

9. To go ahead, click Next.10. The Setup Status dialog shows the progress of the install. When the install has

completed, the Finish dialog displays.11. Click Finish to close the dialog.

Update, Modify, Repair, or Remove LibrariesIf you have previously installed libraries, or if you have a previous version, running Install Libraries, displays a Welcome dialog with choices to Update or Remove libraries, or a dialog with choices to Modify, Repair, or Remove Libraries..1. Make your selection to Update, Modify, Repair, or Remove, and to go ahead,

click Next.2. The Setup Status dialog shows the progress of the operation to Update, Modify,

Repair, or Remove. When the action has completed, Wizard automatically closes.

3-2 Install Libraries Options

4Remote Simulation

Remote SimulationsMost ANSYS Electromagnetics products offer remote simulation capabilities, where you can run a simulation on a different machine from the one on which the ANSYS Electromagnetics 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 analysis, where a specified analy-sis, if supported, is concurrently 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 man-agement programs (see High Performance Computing Integration below).

When do you need RSM?RSM is in general required if you want to run remote or distributed simulations. How-ever, if you have a separate scheduling system that ANSYS Electromagnetics sup-ports, and you plan to run batchsolve simulations only, then you may not need to install RSM (see High Performance Computing below).

Remote Simulation 4-1


Installation/Configuration OverviewIn RSM as well as ANSYS Electromagnetics product installations multiple machines/nodes can run from the same installation tree. You do not have to install the applica-tion on each unix/linux machine/node. we recommend using the network-based direc-tions below.Network Installation: Overview1. Install all ANSYS Electromagnetics products in a network location accessible

from all machines. See Chapter 2 for details on installing an ANSYS Electro-magnetics 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 product installations with

RSM.Non-Network Installation: Overview1. Install ANSYS Electromagnetics products on every machine. See Chapter 2 for

details on installing an ANSYS Electromagnetics product.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.

Installing RSMTo install ANSYS Electromagnetics RSM software:1. If you have received a CD or DVD for the ANSYS Electromagnetics 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 Electro-magnetics software downloads website (see “Additional Resources” on page 1-6), unzip the download, and run the install file in the newly created directory.An initial Installation Shell screen automatically appears.

2. Click Install RSM for the product you want to install.A Welcome screen appears.

4-2 Remote Simulation


3. To install the ANSYS Electromagnetics Remote Simulation 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 under Directory Name. • To select a different directory, click Browse. The Select a directory win-

dow 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 directory 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 win-dow.

7. Click Next from the Remote Simulation Manager Setup. A summary information window appears, listing the location where the ANSYS Electromagnetics Remote Simulation 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.

Configuring RSMGeneral RSM syntax RSM's command-line interface uses an LSB-compliant syntax:

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.



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

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 (see Determining Who Should Run RSM).To configure RSM to start automatically as a specific user, run:<path to RSM installation>/rsm/ansoftrsmservice startonboot -user <username>This option will write the appropriate files in /etc/rc.d as well as start the RSM service as that user.

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 Electromagnetics prod-

User running RSM User who owns/launches solver processesNon-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



uct 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 handled through RegisterEn-gineswithRSM.pl, located in the product installation directory (for example, /apps/ansoft/hfss12/RegisterEnginesWithRSM.pl).RegisterEnginesWithRSM.pl syntax<product-specific installation directory>/RegisterEnginesWithRMS.pl command, where command includes:• add : Add this product installations’s RSM engines to RSM• help : Show full details of all RegisterEnginesWithRSM.pl command options• remove : Remove this product installation’s engines from RSM• status : Show RSM registration status for each RSM engine

High Performance Computing (HPC) IntegrationMany ANSYS Electromagnetics products offer a direct integration with a number of High Performance Computing (HPC) software programs for batchsolves. This direct integration does not require Remote Simulation Management.

HPC Prerequisites1. 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’s Load Sharing Facility (LSF)• Microsoft Windows® Compute Cluster Server 2003• Microsoft Windows® HPC Server 2008• PBS Professional from Altair Engineering• Sun Grid Engine (SGE)

2. ANSYS Electromagnetics products must be accessible from the same directory on all machines.

HPC Installation and ConfigurationBecause HPC is offered as a direct integration, you need only install the ANSYS Electromagnetics software programs. No additional configuration is required.

Job SubmissionANSYS Electromagnetics’s HPC integration allows you to submit jobs directly using ANSYS’s command line arguments for batchsolves. Please refer to your product doc-umentation for batchsolve command line syntax. Note that you must pass in a -dis-tributed flag as part of the ANSYS command line arguments if you want to run a distributed simulation.


5Installing the License Server

Most ANSYS Electromagnetics products require a license, either “counted” or “uncounted.” If the license is counted, then the FLEXlm for Ansoft license server must be installed. The license server is required for all counted licenses, both pur-chased and evaluation.Before installing FLEXlm for Ansoft, you need the following: • The FLEXlm for Ansoft CD.• An ANSYS Electromagnetics license file.Software licenses for each module of ANSYS Electromagnetics product(s) you pur-chased are contained in one or more license files, provided by ANSYS Electromag-netics.

For more information, see “License File” on page 1-2.

Setting up licensing involves two parts:• Installing the FLEXlm for Ansoft license server if you do not have the most

recent version installed.• Optionally, you also may need to update license files or other server settings,

using the Ansoft License Utility. This utility is installed as a part of the FLEXlm for Ansoft license server.

Installing the License Server 5-1


Obtaining a License FileTo obtain a license file, contact your ANSYS Electromagnetics sales representative.

To determine if a particular license is counted or uncounted:1. Locate the license file.2. Open the license file in any text editor.

The license file contains a list of features and/or increments.3. If the word “uncounted” appears within each text block, then the license type is

uncounted. Otherwise, the license type is counted, and a FLEXlm for Ansoft license server must be installed.

See “License File” on page 1-2 and “Obtaining a License File” on page 2-2 for a fur-ther explanation of the different types of licenses.

FLEXlm for Ansoft Installation OverviewFor counted licenses, the FLEXlm for Ansoft license server must be installed either on the network or on the machine where the ANSYS Electromagnetics software is installed. Even if you are running a stand-alone server on your own machine, the FLEXlm for Ansoft license server must be installed — in this case, select your machine as the license server. The FLEXlm for Ansoft license server must also be accessible from any computers that are running Ansoft software.

The FLEXlm for Ansoft license server installation consists of four components:• Acresso's FLEXnet Publisher executables.• ANSYS Electromagnetics’s vendor-specific daemon, ansoftd.• Ansoft’s License Utility, which is used to update license files and certain

server settings at any time after installation.• All hardware key drivers (if you use a hardware key) if you do not currently

have the latest drivers installed. See “Hardware Key” on page -3 for more information.

Some products, such as student versions of ANSYS Electromagnetics products or third-party products, such as Adobe Acrobat Reader, may not require a license file or a FLEXlm for Ansoft license server. The software installation program does not indi-cate that FLEXlm for Ansoft needs to be installed.

Note Certain products, such as student versions of ANSYS Electromagnetics software and third-party products (for example, Adobe Acrobat Reader) do not require a license file or hardware key.

5-2 Installing the License Server

ANSYS Electromagnetics Unix/Linux Installation

Possible Software SetupsFLEXlm for Ansoft can be used with ANSYS Electromagnetics software in three possible configurations:

• Single Machine• Single-Server Network (same or mixed-platform networked machines)• Triple-Redundant Server Network (same or mixed-platform networked

machines)

Single Machine

Using a single machine setup, the ANSYS Electromagnetics software works only on the computer to which it is locked. Do the following to install ANSYS Electromagnetics software in a single machine set up:1. If required, attach the hardware key to the computer where you will install and

use ANSYS Electromagnetics software.2. Install the ANSYS Electromagnetics software on the same machine.3. Install and start the FLEXlm for Ansoft license server on the same machine.

Single-Server Network(Same or Mixed-platform Networked Machines)

Using a single-server network setup, you can run the ANSYS Electromagnetics soft-ware from any computer where it is installed.

Single machine containing the following:• Ansoft software• Hardware key (if required)• FLEXlm for Ansoft license server installed

(node-locked license)

Client machines containing the following:• ANSYS Electromagnetics software

License server machine containing the following:• ANSYS Electromagnetics software may or may not

be installed• Hardware key (if required)• FLEXlm for Ansoft license server installed (floating

license)



Do the following to install ANSYS Electromagnetics software in a single-server net-work set up:1. If required, attach the hardware key to the server computer.2. Install the ANSYS Electromagnetics software on the server and/or the client

machines.3. Install and start the FLEXlm for Ansoft license server on the license server

machine, if not already done. This machine must be accessible, through the net-work, to each client machine.

Triple-Redundant Server Network(Same or Mixed-platform Networked Machines)

Using a triple-redundant server network setup, you can run the software from any computer where it is installed. Do the following to install ANSYS Electromagnetics software in a triple-redundant server network set up:1. If required, attach a hardware key to each server computer.2. Install the ANSYS Electromagnetics software on the servers and/or the client

machines.3. Install and start the FLEXlm for Ansoft license server on all three license server

machines, if not already done. These machines must be accessible, through a net-work, to each client machine.

Note To check out a license when using a triple-redundant server network set up, at least two servers (a quorum) must be running at any given time.

Client machines containing the following:• ANSYS Electromagnetics software

Three license server machines containing the following:• ANSYS Electromagnetics software may or may not be

installed• Hardware key (if required)• FLEXlm for Ansoft license server (daemon) installed

(same floating license on all three machines)



Installing FLEXlm for AnsoftIf you do not already have the most recent version installed, then you must install the FLEXlm for Ansoft license server on the computer you specified during the ANSYS Electromagnetics software installation (see page 2-5 of “Installing the Software”).To install the FLEXlm for Ansoft license server:1. Shut down any FLEXlm license server that is serving ANSYS Electromagnetics

licenses on this machine.2. If you have received a CD for the ANSYS Electromagnetics product you wish to

install, insert it into the CD-ROM drive, and run install_unix from the top-level directory of the CD-ROM.If you downloaded the ANSYS Electromagnetics product (see page 1-6), unzip the download, and run the install_unix file in the newly-created directory.The Welcome to the InstallShield Wizard for FLEXlm for Ansoft screen appears.

3. Click Next. The License Agreement screen appears.

4. Read the license agreement carefully, and select I accept the terms of the license agreement if you agree to the terms of the license agreement. Click Next.The Choose Destination Location screen appears.

5. Under Directory Name, do one of the following to accept the default path or specify a new one:

• 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 by clicking Browse. When you click Browse, the Select a Directory window appears. Select a directory, and click Open.

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

6. Click Next. A warning appears, reminding you to shut down any FLEXlm server that is serv-ing ANSYS Electromagnetics licenses on this machine.

Note If you receive an error that InstallShield did not find enough temporary space to run, you can point InstallShield to another directory to write its temporary files. 1. Run the following:

install_unix -is:tempdir <new directory>2. Go to step 2 on page 5-1.



7. When any such servers are shut down, click OK.The Summary Information screen appears.

8. In 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.• If the settings are incorrect, click Back as many times as necessary, and


The Setup Status screen appears and displays a progress bar. You can click Can-cel at any time to exit installation. As soon as the installation is complete, the InstallShield Wizard Complete screen reappears, stating the server has been successfully installed.

9. Click Next. A confirmation message appears, announcing that the Ansoft License Utility is about to start.

10. Click OK.



The Ansoft License Utility window appears in Initial Setup Mode.

11. In the Ansoft License Utility, do one of the following to select a directory that contains ANSYS Electromagnetics license files:

• Accept the default in the License File Storage Directory field. The License File Storage Directory field displays the location where all license files will be stored. If you change this location, any license files stored in the previous location will not be automatically moved to the new location; you must use the Add File command to find and add them to the Existing License Files list.

• Change the license file storage directory:a. Click Change to select a new directory.

A message appears asking if you are sure you want to change the directory.

b. Click Yes. The Browse for Directory window appears.

c. Select the directory, and click OK. The Ansoft License Utility window reappears, with the new path in the License File Storage Directory field. The Existing License Files list is updated. This list displays only files with a .lic exten-sion that are in that directory.

12. If necessary, add a new license file obtained from ANSYS Electromagnetics.To select a new license file, do the following:

a. Click Add File. The Open window appears.

b. Find and select the file you want.c. Click OK. d. If another window appears asking you to rename the file, enter a new

filename for the license file, and click OK. The Ansoft License Utility

Note You can use the Ansoft License Utility to:• view, add, remove, and rename license files;• change the license file directory; or• change the FLEXlm for Ansoft server configuration.

See “Managing License Files After Installation” on page 5-9.

At this time in the FLEXlm for Ansoft license server installation, you must select a license file directory. Before you exit, the license file directory must contain at least one license file in order to save and start the service. You can also start the Ansoft License Utility after installation is complete by running licman from the flexlm subdirectory in which FLEXlm for Ansoft was installed.



appends a .lic extension to the filename you enter.

13. Make sure the Start License Service on Power Up check box is selected.

14. Click OK to save changes and close the Ansoft License Utility. A message appears, stating that the FLEXlm for Ansoft license service has been saved. If an error occurs, you must correct it before you use ANSYS Electromagnetics software. See “Managing License Files After Installation” on page 5-9.

15. Click OK to close the message and complete the installation. A message appears telling you that the installation is complete.

Note This option causes FLEXlm for Ansoft to start automatically when you restart your computer. If you do not want it to start automatically, clear the Start License Service on Power Up check box.At any time after installation, you can use the license utility for ongoing management of Ansoft license files, as described in “Managing License Files After Installation” on page 5-9.



Managing License Files After InstallationAfter the ANSYS Electromagnetics software and the FLEXlm for Ansoft license server are installed, use the Ansoft License Utility to view, add, remove, and rename license files and to change the license file storage directory and service configuration. Use the options in the License Files section of the Ansoft License Utility window to change the directory where license files are stored or to view, add, remove, or rename license files. Use the options in the Service Configuration section of the Ansoft License Utility window to configure your FLEXlm for Ansoft server. The Ansoft License Utility allows you to change the FLEXlm for Ansoft log file, start and stop the FLEXlm for Ansoft service, save or delete the current FLEXlm for Ansoft ser-vice, and enable or disable automatic start-up upon machine restart.The Ansoft License Utility has two modes:

• Initial Setup mode: Automatically starts after FLEXlm for Ansoft is installed. The server configuration is automatically saved during the FLEXlm for Ansoft server installation.

• Stand-alone mode: Opens after the installation for ongoing license mainte-nance.

Starting the Ansoft License UtilityThe Ansoft License Utility starts automatically in Initial Setup mode during the FLEXlm for Ansoft license server installation. You also can use the Ansoft License Utility in Stand-alone mode to add or rename license files after you have installed both the software and the FLEXlm for Ansoft server. To start the Ansoft License Utility in Stand-alone mode after installation, type the following:

/path/flexlm/licman(where path is the location where you installed FLEXlm for Ansoft).The Ansoft License Utility window appears.

Note: When launched, the Ansoft License Utility checks for the .licmanrc file in the directory where the License Utility is installed. This file contains the license directory and log file information that is displayed in the License Utility window. If the .licmanrc file is not found, the Ansoft License Utility reverts to default values when it starts.



Changing the License File Storage DirectoryYou can change the directory where the FLEXlm for Ansoft license server stores and accesses license files. The License File Storage Directory box displays the location where all license files are stored. If you change this location, any license files stored in the previous location must be transferred using the Add File command to add them to the Existing License Files list. To change the directory containing your license files:1. Click the Change button next to the License File Storage Directory field.

A warning message appears, asking if you are sure you want to change the direc-tory.

2. Click Yes. The Browse for Directory window appears.

3. Select the directory, and click OK. The Ansoft License Utility window reappears, with the new path in the License File Storage Directory field. The Existing License Files list is updated. This list displays only files with a .lic extension that are in that directory.

Viewing License FilesYou can view and edit license files that appear in the Existing License Files list.To view a license file:1. Select the license file you want to view from the Existing License Files list.2. Click View File.

A new window opens, displaying the text of the license file. 3. After viewing the license file, click OK.

The license file cannot be edited from within the Ansoft License Utility. To edit the license file, open it in a text editor.



Adding, Removing, or Renaming License FilesYou can add, remove, or rename license files in the Existing License Files list. The directory containing the file you are adding need not be in the same location as the license file directory; it typically is not. A copy of the file you select is placed in the directory displayed in the License File Storage Directory field.To add a license file:1. Click Add File.

The Open window appears.2. Find and select the file you want to add, and click OK.

The Ansoft License Utility window reappears, with the new license file dis-played in the Existing License Files list.

To remove a license file:1. Select the file you want to delete from the Existing License Files list.2. Click Remove File.

The Rename/Delete window appears.

3. Select the Delete option, and click OK.The file is removed from the Existing License Files list.

To remove a file, you can change the .lic extension or move the file to a location other than the License File Storage Directory. FLEXlm for Ansoft only recognizes files with a .lic extension as license files.

Note If the file you selected does not have a .lic extension, you are asked to enter a new name for the license file. Enter a name for the license file, without the extension, and click OK. The Ansoft License Utility automatically appends the .lic extension.

Note If the FLEXlm for Ansoft license service is currently running, you are prompted to stop the service before removing any license files.



To rename a license file:1. Select the file you want to rename from the Existing License Files list.2. Click Remove File.

The Rename/Delete window appears.

3. Select the Rename option, and enter the new name.4. Click OK.

The name of the file is changed in the Existing License Files list.

Changing the Server or ansoftd Vendor daemon TCP/IPYou can modify the port numbers used by FLEXlm for Ansoft to start the server and the ansoftd vendor daemons. You may choose a specific TCP/IP port on which each will be started, or you may choose to let each dynamically find an available TCP/IP port.To change the TCP/IP port number specified for the FLEXlm for Ansoft license server and/or the ansoftd vendor daemon:1. Click Port Config in the Ansoft License Utility window.

The TCP/IP Port Configuration window appears. 2. For the server's TCP/IP port number, select one of the following options:

• Dynamic Port: The service automatically chooses an available port when it is started. The server automatically looks at all TCP/IP ports between 27000 and 27009, choosing the first available port.

• Static Port: The service tries to start on the port number specified in this panel. If that port is in use, the service fails to start.

3. For the ansoftd vendor daemon's TCP/IP port number, select one of the following options: • Dynamic Port: The service automatically chooses an available port when it

is started. The ansoftd vendor may choose any port number higher than 1024 on which to start.

• Static Port: The service tries to start on the port number specified in this panel. If that port is in use, the service starts with an error, and FLEXlm for Ansoft tries to use a dynamic port to start ansoftd.

4. Click OK to close the window and update the port numbers in the license files.

Note If the FLEXlm for Ansoft license service is currently running, you will be prompted to stop the service before renaming any license files.



FLEXlm for Ansoft Log FileThe FLEXlm for Ansoft log file displays a log of service settings, available licenses and features, license activities (such as checking in and checking out), and error infor-mation.To specify the location of the FLEXlm for Ansoft log file:1. Click the Browse button next to the FLEXlm log file field in the Ansoft License

Utility window. The Save As window appears.

2. Find and select a log file, and click OK. The path and log file name appear in the FLEXlm log file field.

To view the FLEXlm for Ansoft log file:1. Click View Log.

A new window opens, displaying the text of the log file.

2. After viewing the log file, click OK.



Service Manager SettingsYou can use the Ansoft License Utility to change the start on power up setting; save the current service configuration; shut down, restart, or delete the FLEXlm for Ansoft license service; and refresh the license file directory.• To set the service manager to automatically start when the machine boots up,

select the Start License Service On Power Up check box. This option can only be changed by root.

• To save the current service configuration, click Save Service.This option saves the current service configuration, including service manager settings. If the service is currently running, the service is stopped and restarted.

• To shut down and delete the service, click Delete Service.This option shuts down the service and deletes it from the service settings.

• To restart the service or re-read the license file directory, click Start Service.If the service is not currently running, this option starts the service. If the service is currently running, the service is stopped and restarted.

• To shut down the service, click Stop service.

Troubleshooting License ProblemsLicense information can be exported into a text file for use when troubleshooting license problems (for example, if you have trouble starting the license server or checking out a software license).To export license information:1. Click the Export diagnostics file button at the bottom of the Ansoft License

Utility window.A Save As window appears.

2. Name the file diags.log or a similar name, and click OK.You can send this file to your support representative in your territory or to the general installation support described in the ANSYS Inc. information table.The following information is exported:

• Any FLEXlm-related environment variables.• The name of your machine.• The path to your license file storage directory.• The path to your log file.• The contents of all license files (.lic files) contained in your license file stor-

age directory.• The contents of your log file.

Accessing Ansoft License Utility Online HelpTo view the online help for the Ansoft License Utility, click the Help button in the bottom right of the Ansoft License Utility window.



Closing the Ansoft License UtilityTo close the Ansoft License Utility window, click OK.The Ansoft License Utility saves changes and exits.


6Updating Software and Licenses

After installation, you may need to reinstall the software, update a license, or add a software component, such as a library.

Updating Software and Licenses 6-1


Updating ANSYS Electromagnetics SoftwareTo update ANSYS Electromagnetics software:1. If you have received a CD for the ANSYS Electromagnetics 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 Elec-tromagnetics software downloads website (see page 1-6), unzip the dowload, and run the install file in the newly created directory.

2. Run install, which is located in the top-level directory 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.

6. When you reach the Summary Information screen, review the information dis-played 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


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.

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 FLEXlm for Ansoft is installed.See “Installing the Software” on page 2-3 for more details.

6-2 Updating Software and Licenses


Updating a Software LicenseThere may be times when you need to update a software license. This may occur for a number of reasons, such as:• When you change the license server.• When you convert from an evaluation license to a purchased license.• When you receive an updated purchased license file.When you change servers or switch from an evaluation to a purchased license, you need to:1. Install FLEXlm for Ansoft on the new server machine, and add the new license

file.2. Specify the name of the new server by modifying the product software installa-

tion (see “Updating ANSYS Electromagnetics Software” on page 6-2, for details).

When you receive an updated purchased license file, you only need to update the license file using the Ansoft License Utility.For more information, see Chapter 5, “Installing the License Server.”

Updating an Existing Purchased LicenseTo update an ANSYS Electromagnetics software license on the license server:1. Start the Ansoft License Utility by typing the following:

/path/flexlm/licman(where path is the location where you installed FLEXlm for Ansoft).The Ansoft License Utility window appears.

2. Click Add File. The Open window appears.

3. Find and select the new license file, and click OK. The Ansoft License Utility window reappears, with the new license file in the Existing License Files list.

4. Click Start Service, and then click OK.See “Managing License Files After Installation” on page 5-9 for more informa-tion on the Ansoft License Utility and for details on adding a license file.

Note If the Ansoft License Utility is not installed, then you need to run the FLEXlm for Ansoft installation.



Changing the Server or Updating to a Purchased LicenseIf you are updating an evaluation license or changing the name of the server, you need to modify the client installation:1. If you have received a CD for the ANSYS Electromagnetics 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 Elec-tromagnetics software downloads website (see page 1-6), unzip the dowload, and run the install file in the newly created directory.

2. Run install, which is located in the top-level directory where the CD-ROM is mounted (for example, /cdrom/cdrom0/install).

3. Click Install <Product> for the product you want to update.4. On the License Information screen, select the new license file.

Uninstalling ANSYS Electromagnetics Software or the License Server

To uninstall any ANSYS Electromagnetics software product or the FLEXlm for Ansoft license server:1. Type the following:

/path/uninstall/uninstall<productname>.shwhere path is the directory where you installed the software.For example, type /usr/ansoft/flexlm/uninstall/uninstallflexlm.sh to uninstall FLEXlm for Ansoft located in /usr/ansoft/flexlm.The corresponding Uninstaller appears. The first screen explains that you are about to uninstall FLEXlm for Ansoft from your computer.

2. Click Next in the first screen.A screen appears asking you to select the features you would like to uninstall.

3. Select or clear the appropriate check boxes if available. Typically, the only avail-

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 FLEXlm for Ansoft is installed.See page 2-3, in Chapter 2, “Installing ANSYS Electromagnetics Software,” for more details on available license options.

Note The uninstall subdirectory was added automatically during the installation.



able option will be Product Uninstallation. Leave this selected, and click Next.The Summary Information screen appears.

4. Make sure the information is correct, and then click Next.The installer begins to uninstall the software. When complete, a message appears telling you that the software has been successfully uninstalled.

5. Click Finish.The ANSYS Electromagnetics software is uninstalled from your computer.


ASilent Installation

When you use ANSYS Electromagnetics’s silent installation feature, the software is installed on your computer with no graphical interface appearing during the installa-tion process. InstallShield suppresses all dialog boxes, including error messages and informational message boxes. To install ANSYS Electromagnetics software on a Unix machine using a silent instal-lation:

• Obtain a license file for the software you are installing.• Install the ANSYS Electromagnetics software from a command prompt, as

described in this chapter.• Obtain and install a hardware key if necessary.• Install the hardware key libraries if you are using a hardware key.

Silent Installation A-1


Running the Silent InstallationTo install ANSYS Electromagnetics software on a Unix machine using a silent instal-lation, you need to record a response file, and then use that file to install the software 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 typical 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 software, 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

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 "#" symbol is a comment. Blank lines are ignored.

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.

A-2 Silent 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.



Response FileThe 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#####################################################################

###################################################################### 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 agreement." will be selected



## For example, to configure the panel to initially display "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## 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>


BLicense hostid

Software licenses for each module of Ansoft products you purchased are contained in one or more license files provided 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:

This utility will provide the disk id by default:http://www.ansys.com/Support/Licensing/Capture+License+Server+Information

Operating System Permitted hostids

Windows • The ethernet address of a network interface card (MAC address).

• Acresso® FLEXid parallel port hardware key.• Acresso® FLEXid USB port hardware key.• Disk serial number.

To obtain the disk serial number, open a command prompt.Type in vol <drive letter>:, for example vol C:

Linux • The ethernet address of a network interface card (MAC address).

• Acresso® FLEXid USB port hardware key.Solaris Machine hostid

License hostid B-1


Network Interface CardA network interface card is a physical device used to connect 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 Enter-prise Linux.

WindowsTo obtain an ethernet address as a valid license hostid when running Microsoft Win-dows: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 Physical Address line. The ether-

net address for that device is the value of the physical address, without dashes.

LinuxTo obtain an ethernet address as a valid license hostid when running Red Hat Enter-prise 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 eth-

ernet address for each device is the value in the HWaddr field, without colons.

Note Other types of adapters, including Point-to-Point Protocol (PTPP) adapters and the Microsoft Loopback Adapter, may be listed here. These are not valid for license hostids.

B-2 License hostid


Hardware KeyA Acresso FLEXid hardware key may be provided to you by Ansoft as your physical device. The license hostid of a hardware key is affixed to the hardware key itself. The hostid is a 17- to 21-character value that begins with FLEXID=.

Installing a Hardware Key on a Parallel PortMultiple devices can be installed on a single parallel port.

Installing a Hardware Key on a USB PortOnly a single device can be installed on each USB port.

Acresso FLEXid hardware key for a Parallel Port

To install the hardware key on a parallel port:1. Disconnect any devices attached to your main

printer (parallel) port.2. Attach the hardware key to the printer port.

The holes on the top and/or bottom should remain empty.

3. Reconnect the other devices to the back end of the hardware key. The key should not interfere with them.

Acresso 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. The driver is automatically installed during either the software or FLEXlm for Ansoft license server installation. Once the operating system recognizes the hardware key, a red LED lights up inside the hardware key.

License hostid B-3


Machine hostidA 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-4 License hostid

CSetting 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 MainWin 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 cancel 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).

6. Click Next.The Print Command dialog appears.

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.

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

Setting Up a Printer on Linux C-1


10. The Printer Name dialog appears. Enter a Name to identify 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 appropriate dia-log and correct the entry. If the information 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 Electromagnetics products.

C-2 Setting Up a Printer on Linux

IndexIndex

Symbols.lic file 2-2

Aadding license files 5-12Ansoft License Utility

adding license files 5-12closing 5-16exporting license information 5-15FLEXlm log file 5-14installing 5-2online help 5-15removing license files 5-12renaming license files 5-12service manager settings 5-15Stand Alone mode 5-9starting after installation 5-9troubleshooting/debugging license prob-

lems 5-15viewing license files 5-11

Ansoft softwareinstalling 2-3silent installation A-1uninstalling 6-4updating 6-2

Ansoft Web site 1-6

Cchanging license servers 6-3closing the Ansoft License Utility 5-16computer system requirements 1-2contents of product package 1-1copyright notice 2-iicounted license 2-2

Ddebugging license problems 5-15deleting service configuration 5-15disk space

verifying amount 2-2documentation

about Ansoft products 1-6about installation and configuration 1-6on Ansoft Web site 1-6

Eevaluation license 2-2exporting license information 5-15

Index-1


Ffiles

.lic 2-2FLEXlm daemon 1-2FLEXlm for Ansoft license server 1-2

installing 5-2uninstalling 6-4

FLEXlm log fileselecting 5-14viewing 5-14

IInstalling

Libraries 3-1installing

FLEXlm for Ansoft license server 5-2license options 5-2silent installation A-1

installing Ansoft software 2-3

LLibraries

installation 3-1modify,update,rrrepair, remove 3-1

license daemon 1-2license files

adding 5-12counted 2-2evaluation 2-2exporting license information 5-15purchased 2-2receiving and preparing 2-2removing 5-12renaming 5-12standard 2-2troubleshooting/debugging problems 5-15uncounted 2-2viewing 5-11

license server 1-2installing 5-2

license service managerdeleting 5-15saving 5-15starting 5-15stopping 5-15

licenser serveruninstalling 6-4

LinuxSetting Up a Printer C-1

Oonline help 1-6

for Ansoft License Utility 5-15operating system 1-2

Ppackage contents 1-1preparing the license file 2-2prerequisites to installation 1-1, B-1

license file 1-2license server 1-2operating system 1-2

PrintersLinux C-1Solaris C-1

processorsystem requirements 1-2

product package 1-1purchased versions of Ansoft software 2-2

Rreceiving a license file from Ansoft 2-2reinstalling Ansoft software 6-2removing license files 5-12renaming license files 5-12requirements

operating system 1-2

Index-2


Ssaving license service manager 5-15saving service configuration 5-15service manager settings 5-15silent installation A-1software

installing 2-3silent installation A-1uninstalling 6-4updating 6-2

SolarisSetting Up a Printer C-1

standard license 2-2starting license service manager on power up 5-

15starting the Ansoft License Utility after installa-

tion 5-9stopping license manager service 5-15system requirements 1-2

disk space 2-2processor 1-2

Ttrademark notice 2-iitroubleshooting license problems 5-15

Uuncounted license 2-2uninstalling Ansoft software 6-4uninstalling the FLEXlm for Ansoft license

server 6-4updating a software license 6-3updating Ansoft software 6-2

Vverifying

disk space available 2-2viewing license files 5-11viewing online help 1-6

WWeb site, Ansoft 1-6

Index-3


Index-4

unix/linux installation...

Documents