Professional Documents
Culture Documents
August 2009
Ansoft LLC Information
Address: 225 West Station Square Drive
Suite 200
Pittsburgh, PA 15219
USA
Phone: (+1) 412-261-3200
FAX: (+1) 412-471-9427
E-mail: insup@ansoft.com
Web site: http://www.ansoft.com
Appendices
1. Getting Started . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-1
Installation Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1
Additional Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4
2. Installing Ansoft Software . . . . . . . . . . . . . . . . . . . .2-1
Obtaining a License File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2
Installing the Hardware Key (uncounted evaluation licenses) . . . . . . 2-2
Installing the Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2
3. Remote Simulation . . . . . . . . . . . . . . . . . . . . . . . . . .3-1
When do you need RSM? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1
Installing RSM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2
Configuring RSM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-4
Registering Ansoft Product Engines for use with RSM . . . . . . . . . . . 3-4
High Performance Computing (HPC) Integration . . . . . . . . . . . . . . . . 3-5
4. Installing the License Server . . . . . . . . . . . . . . . . . .4-1
Obtaining a License File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2
FLEXlm for Ansoft Installation Overview . . . . . . . . . . . . . . . . . . . . . 4-2
Installing FLEXlm for Ansoft . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-5
Managing License Files After Installation . . . . . . . . . . . . . . . . . . . . . . 4-9
Contents-1
Ansoft Windows Installation Guide
Contents-2
Ansoft Windows Installation Guide
Appendices
A. Silent Installation
Running the Silent Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .A-2
Silent Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .A-4
B. License hostid
Network Interface Card . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-2
Hardware Key . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-3
Machine hostid . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-4
Contents-3
Ansoft Windows Installation Guide
Contents-4
1
Getting Started
Installation Prerequisites
Before installing Ansoft software, you need the following:
• The Ansoft product CD or product download (see “Additional Resources”
on page 1-4 for download information).
• An Ansoft 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-4)
• A computer with TCP/IP installed, for counted evaluation and purchased
licenses.
• A computer that meets the minimum or recommended system requirements,
which depends on the specific Ansoft products you plan to run (see product
release notes for specifications).
Ansoft Software
The Ansoft product CD or equivalent download contains:
• The Ansoft 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. (You can choose to install them when you install FLEXlm
for Ansoft or any Ansoft software product.)
The FLEXlm for Ansoft CD or equivalent download contains:
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.
Note You can install the FLEXlm for Ansoft license server before or after you
install the Ansoft software.
See Chapter 4, “Installing the License Server,” for FLEXlm for Ansoft installation
instructions and additional licensing information.
TCP/IP
(Not Required for Uncounted Evaluation Licenses)
Additional Resources
General: The Ansoft Web site: http://www.ansoft.com.
Downloads: Software downloads (including FLEXlm for Ansoft) and installation-
related documentation are available at the ANSYS customer portal,
http://www.ansys.com/customerportal.
Online Technical Available through the ANSYS customer portal:
Support: http://www.ansys.com/customerportal.
Under Online Support, choose Ansoft Customer Support.
Ansoft’s technical support site provides access to frequently asked
questions, application notes, presentations, and example scripts.
Product Release During installation, read the release notes. In the initial setup
Notes: window, click View Release Notes to see any important, late-
breaking information that was not included in the Ansoft 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 may be
Documentation: 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 applica-
tion 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.
9. Click Next.
Depending on the software and version being installed, you may see one or both
of the following screens before the Select Program Folder screen: the Choose
Temporary Folder Location screen and/or the Choose Library Option screen.
10. If the Temporary Folder Location screen appears, select a default location for
all simulations (including local) to use as a temporary work space.
• If desired, change the temporary folder assignment. You can edit the field
directly or use the Browse button to display file browser to let you navigate
the folders on your machine and network.
• If desired, check the option to add read/write permissions for Everyone. If
the installation will be used for remote simulation by multiple users, all users
must have permissions on the temporary folder.
11. If the Choose Library Option screen appears, do one of the following to specify
the location of Ansoft libraries:
Note Ansoft libraries are large databases of electronic components, developed by
Ansoft and various manufacturers.
• Click This local installation to copy and install the default Ansoft compo-
nent 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.
Note The program folder, which appears on the Windows Start menu, is a
grouping of related software that includes executable files and other
components. The default programs folder is Ansoft
(Start>Programs>Ansoft).
For additional information about the three license options, click Help me decide
which of the following options to choose. This displays a browser page with
additional explanations.
Note You can review the current license configuration by clicking View current
license configuration.
Select this if you recently Select this if you are using a Select this if you already have
received a license file from counted license and already a license file for previous
Ansoft (either evaluation or know on which machine Ansoft software and want to
purchased). FLEXlm is/will be installed. keep the same configuration.
16. Select the checkbox for the appropriate USB or parallel port device.
17. Click Next.
The Review settings before copying files screen appears.
18. In the Review settings before copying files 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
change your selections. Verify each screen before clicking Next to go to the
next screen. When all information is correct, return to the Review settings
before copying files screen, and click Next.
The Setup Status screen appears, displaying a progress bar, and installation
begins. You can click Cancel at any time to exit the installation.
Note If you receive a message about read-only files, you typically want to
overwrite them with the newer versions.
19. Once the files have all been copied, one of the following messages appears:
• If you identified as the license server the same machine where you installed
the Ansoft software, then a message appears that informs you that you must
install FLEXlm for Ansoft license server on this machine (refer to “Install-
ing the License Server” on page 4-1 for details). Click OK.
• If you identified as the license server a machine other than where you
installed the Ansoft software, then a message appears that identifies that
machine as the license server and informs you that you must install FLEXlm
for Ansoft license server on that machine. Click OK.
• If you supplied an uncounted evaluation license, no message appears. You
do not need to install FLEXlm for Ansoft. Please make sure to install the
hardware key on the machine where the software is installed.
20. When the installation is complete, a Setup Complete window appears.
If Ansoft's Remote Simulation Manager (RSM) is available for this product, you
will see one of two checkbox options:
• If RSM is not installed, you will see a checkbox to launch the RSM installa-
tion and, once the installation is complete, register this Ansoft product with
RSM. If you select this option and press Finish, the product installation ends
and the RSM installation is automatically started.
• If RSM is installed, you will see a checkbox to register this Ansoft product
with RSM.
See chapter 3 for more details on RSM.
If Ansoft's Remote Simulation Manager (RSM) is not available for this product,
you will see a checkbox to view the release notes for this product.
21. Click Finish.
The initial setup Installation Shell reappears.
Remote Simulations
Most Ansoft products offer remote simulation capabilities, where you can run a simu-
lation on a different machine from the one on which the Ansoft 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 analysis, if supported, is concurrently solved
on multiple processors and/or multiple nodes.
Ansoft 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 Integration below).
Installing RSM
To install Ansoft RSM software:
1. If you checked to install the Remote Simulation Manager during the software
installation, the Ansoft Remote Simulation Manager installer appears. You can
also install the Remote Simulation Manager as an installation option on the
installation CD.
A Welcome screen appears.
Note The user selected will run remote and distributed analyses when no user is
specified in the product interface.
9. On the Select Program Folder screen, do one of the following to specify a name
for the program folder:
• Accept the default name displayed in the Program Folders box.
• Select an item from the Existing Folders list.
• Type a new name for the folder in the Program Folders box.
Note The program folder, which appears on the Windows Start menu, is a
grouping of related software that includes executable files and other
components. The default programs folder is Ansoft
(Start>Programs>Ansoft).
Note If you receive a message about read-only files, you typically want to
overwrite them with the newer versions.
machine.
The InstallShield Wizard complete window appears. If you want to view the
README file (recommended before using the software), check the box.
12. Click Finish to close the install window.
If you use RSM, it must be installed on all remote machines. In addition, the
product engines must be registered on RSM.
• If this installation was automatically launched from a product installation,
then the registration will occur automatically.
• To register the engines at any time on Windows, choose Start>Pro-
grams>Ansoft>product>Register with RSM. You can also run Regis-
terEnginesWithRSM.exe, located in the product subdirectory (for example,
C:\Program Files\Ansoft\hfss12\RegisterEnginesWithRSM.exe). In each
case, you see a dialog confirming the registration. OK the dialog.
Configuring RSM
To modify any of the settings configured during the RSM installation, modify the
RSM installation.
1. Click Start>Programs>Ansoft>Remote Simulation Manager>Remote Simu-
lation Manager maintenance.
A Setup window appears.
2. Choose Modify.
3. Click Next and follow the instructions that appear.
Single Machine
Single machine containing the following:
• Ansoft software
• Hardware key (if required)
• FLEXlm for Ansoft license server (daemon) installed
(node-locked license)
Using a single machine setup, the Ansoft software works only on the computer to
which it is locked.
Do the following to install Ansoft software in a single machine set up:
1. If required, attach the hardware key to the computer where you will install and
use Ansoft software.
2. Install the Ansoft 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)
License server machine containing the following:
• Ansoft software may or may not be installed
• Hardware key (if required)
• FLEXlm for Ansoft license server (daemon) installed
(floating license)
Using a single-server network setup, you can run the Ansoft software from any com-
puter where it is installed.
Do the following to install Ansoft software in a single-server network set up:
1. If required, attach the hardware key to the server computer.
2. Install the Ansoft 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.
Using a triple-redundant server network setup, you can run the software from any
computer where it is installed.
Do the following to install Ansoft software in a triple-redundant server network set
up:
1. If required, attach a hardware key to each server computer.
2. Install the Ansoft 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.
9. Click Next.
The Review Setup screen appears.
10. Make sure that all other programs are closed (press ALT+TAB to find open appli-
cations). Then check the information displayed under Current Settings, and 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 edit
the information. When correct, return to the Start Copying Files screen, and
click Next.
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 appears.
11. Click Finish.
A confirmation message appears, announcing that the Ansoft License Utility is
about to start.
13. In the Ansoft License Utility, do one of the following to select a directory that
contains Ansoft license files:
• Accept the default in the License File Storage Directory field. The
4-6 Installing the License Server
Ansoft Windows Installation Guide
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.
14. If necessary, add a new license file obtained from Ansoft.
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
appends a .lic extension to the filename you enter.
15. Make sure the Start License Service on Power Up check box is selected.
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 Ansoft License Utility for
ongoing management of Ansoft license files, as described in “Managing
License Files After Installation” on page 4-9.
16. 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 can use Ansoft software. See
Managing License Files After Installation for more information.
17. Click OK.
A second message appears, stating that the FLEXlm for Ansoft license service
has started.
18. Click OK to close the message and complete the installation.
After the FLEXlm for Ansoft license server software is installed, the installation
may ask if you want to restart your computer. You can restart your computer now
and activate the changes, or you can wait until later (for instance, if you need to
close any open applications).
Note If you are prompted to restart your computer, then the FLEXlm for Ansoft
service cannot be started until you do so.
2. Click Yes.
The Browse for Directory window appears.
3. Select the directory, and click OK.
4. 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 Files
You can view 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 (for example, Notepad).
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.
age directory.
• The contents of your log file.
Accessing Ansoft License Utility Online Help
To 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 Utility
To close the Ansoft License Utility window, click OK.
The Ansoft License Utility saves any changes and exits.
Registry Data for FLEXlm for Ansoft
When launched, the Ansoft License Utility checks the registry for an existing
FLEXlm for Ansoft service. These registry entries are in the following location:
HKEY_LOCAL_MACHINE\SOFTWARE\FLEXlm License Manager\FLEXlm
for Ansoft.
There are three value data pairs:
• License: Contains the path to a license file or directory.
• Lmgrd: Contains the path to lmgrd.exe.
• LMGRD_LOG_FILE: Contains the path to the log file.
After installation, you may need to reinstall the software, update a license, or add a
software component, such as a library. If you have already installed the software, the
next time you run the Setup program, the installation starts in Maintenance mode.
Note Select I have a new license file to change the license file (if you received a
new one from Ansoft, 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-5, in Chapter 2, “Installing Ansoft Software,” for more details
on available license options.
When you use Ansoft’s silent installation feature, the software is installed on your
computer with no windows appearing during the installation process. InstallShield
suppresses all dialog boxes, including error messages and informational message
boxes.
To install Ansoft software using a silent installation:
• Obtain a license file for the software you are installing.
• Obtain and install a hardware key if necessary.
• On a representative machine, install the Ansoft software once from the com-
mand prompt, as described in this chapter.
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.
4. To verify that the silent setup succeeded, open the setup.log file, and look at the
ResultCode value in the [ResponseResult] section. If the value is zero, the instal-
lation was successful.
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.
Note 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 Codes
Result Description
Code
0 Success.
-1 General error.
-2 Invalid mode.
-3 Required data not found in the Setup.iss file.
-4 Not enough memory available.
-5 File does not exist.
-6 Cannot write to the response file.
-7 Unable to write to the log file.
-8 Invalid path to the InstallShield Silent response file.
-9 Not a valid list type (string or number).
-10 Data type is invalid.
-11 Unknown error during setup.
-12 Dialog boxes are out of order.
-51 Cannot create the specified folder.
-52 Cannot access the specified file or folder.
-53 Invalid option selected.
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 unique 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:
Linux
To 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.
Hardware Key
A Macrovision 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 Port
Multiple devices can be installed on a single parallel port.
Macrovision 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.
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:
Symbols C
.lic file 2-2 changing license servers 5-4
closing the Ansoft License Utility 4-16
contents of product package 1-1
A
adding license files 4-12
Ansoft License Utility
D
adding license files 4-12 debugging license problems 4-15
closing 4-16 deleting service configuration 4-15
exporting license information 4-15 dongle
FLEXlm log file 4-14 installing 2-2
installing 4-2
online help 4-16
removing license files 4-12 E
renaming license files 4-12 exporting license information 4-15
service manager settings 4-15
troubleshooting/debugging license prob-
lems 4-15 F
Ansoft software files
installing 2-1 .lic 2-2
silent installation A-1 FLEXlm daemon 1-2
uninstalling 5-2 FLEXlm for Ansoft license server 1-2
upgrading 5-2 installing 4-2
Maintenance mode 5-6
removing 5-6
updating 5-6
Index-1
Ansoft Windows Installation Guide
Index-2
Ansoft Windows Installation Guide
upgrading 5-2
starting license manager service on power up 4-
15
stopping license manager service 4-15
T
TCP/IP 1-2
troubleshooting license problems 4-15
U
uninstalling Ansoft software 5-2
updating a software license 5-4
updating license file 5-2
updating the FLEXlm for Ansoft license server
5-6
upgrading software 5-2
Index-3
Ansoft Windows Installation Guide
Index-4