ANSYS, Inc. Licensing Guide


Table of Contents

Preface
Introduction
Communications Requirements
Configuring TCP/IP
Changing the Default Port Number
Explanation of Licensing Terms
The License Manager Daemon (lmgrd)
The Vendor Daemon (ansyslmd)
The License File
The Application Programs
License Servers
Selecting License Servers
Redundant Server Options
Registering License Server Information
License Files
Installing License Files
Specifying the License Server and License Files
Setting the Path with an Environment Variable
License Files Settings Precedence
License Files Format
SERVER Lines
VENDOR Lines
INCREMENT Lines
Sample License Files
Recognizing an ANSYS License File
Product Variable Table
The ANSYS License Manager
License Manager Daemon
Modifying License Manager Startup Options
Starting the License Manager Manually
Starting the License Manager at System Boot Time
Shutting Down the License Manager
The Licensing Environment
Designating Server(s) for License Check-out
Sample Scenario
Establishing User Privileges
Editing the Licensing Options File
Sample Options File
Other Environment Variable Settings
Creating the lmadmin Group
HP AlphaServer (Compaq), HP, SGI, Sun, Linux
IBM RS/6000
Setting Up License Queuing
Using License Borrowing
Setting up License Borrowing
Running the License Borrowing Utility
License Administration
Using the ANSLIC_ADMIN Utility
Register License Server Information
Display the License Server Hostid
Run the License Wizard
Install the License File
Start the License Manager
Stop the License Manager
Reread the License File
Specify the License Server
Remove a Client License
Run the ANSYS Borrow Utility
Set Site Preferences
View Status/Diagnostic Options
Uninstall the License Manager
Using the LMTOOLS Utility
Troubleshooting
Getting Additional License Debug Information
Using the ansys_pid Utility
Problem Situations
License Manager Will Not Start
License Manager Will Not Stop in a Three-Server Environment
Log File Shows Unexpected Messages When the License Manager Is Stopped
Unable to Check Out Licenses
Jobs Abort When License Manager Goes Down in Three-Server Environment
Ethernet Address Shows All Zeroes
Licensing Log File Not Created
Queuing Does Not Work
The FLEXlm Utility lmcksum May Give Misleading Information
The Launcher is Excessively Slow to Start
Launcher is Not Using ANSYS110_PRODUCT Environment Variable Correctly
Remove a Client Option Does Not Work
Licensing Installation Process Error Messages
Licensing-Related Launcher Error Messages
Licensing Error Messages
ANSYS License Borrowing Errors
ANSYS License Log File Errors
Glossary

Preface

Table of Contents

This document contains information for running the FLEXlm License Manager with all ANSYS, Inc. products, including ANSYS, ANSYS Workbench, ANSYS ICEM CFD, ANSYS CFX, ANSYS AUTODYN, ANSYS TASPCB, ANSYS TAS, and ANSYS PTD products. However, some information may pertain only to specific products/licensing levels, such as ANSYS or DesignSpace.

Supported Hardware Platforms

This document details information about licensing ANSYS, Inc. products on the hardware platforms listed below. Not all products support all platforms listed below. Please refer to the installation documentation for the platforms on which your specific product runs. The name in parenthesis indicates the directory name for each platform (referred to as <platform> throughout this document).

  • HP AlphaServer (alpha)

  • HP PA8000 64-bit (hp64)

  • HP Itanium2 64-bit (hpia64)

  • IBM RS/6000 AIX 5L (aix64)

  • SGI IRIX 64-bit (sgi64)

  • Sun UltraSPARC 64-bit (sun64)

  • Sun UltraSPARC III+ 64-bit (usIII)

  • Fujitsu SPARC64 IV 64-bit (fjpp)

  • Linux Intel IA-32, RH 3.0 (linia32)

  • Linux Intel IA-64, RH 3.0 (linia64)

  • Linux Intel Xeon EM64T, RH 3.0 (linem64t)

  • Linux AMD Opteron 64-bit, SuSE ES 9 (linop64)

  • Windows XP x64 (winx64)

  • Windows XP (intel)

  • Windows 2000 (intel)

For specific operating system requirements, refer to the installation guide for the product and platform you are running.

Intended Audience

The ANSYS Licensing Guide is intended for the person responsible for licensing administration of all ANSYS, Inc. products at a site. This person is typically the system administrator.

Product Definitions

This guide applies to all licensed ANSYS, Inc. products, including ANSYS, ANSYS Workbench, ANSYS ICEM CFD, ANSYS CFX, ANSYS AUTODYN, ANSYS TASPCB, ANSYS TAS, and ANSYS PTD products, unless otherwise noted.

Summary of New and Changed Features

Listed below is a summary of those licensing items that are either new or have been changed since the last release. For a list of all major new and changed features of any product, see the Release Notes document for that product.

  • The license manager daemons (lmgrd and ansyslmd) have been upgraded this release to FLEXlm 10.8.0.7. You must use this version of the license manager with ANSYS 11.0.

  • You may see references to both FLEXlm and FLEXnet Licensing. Both names refer to the ANSYS license manager product.

  • We are not supporting the Windows IA-64 platform (including the Windows IA-64 license manager) at ANSYS 11.0.

  • ANSYS, Inc. now supports the TIMEOUT and TIMEOUTALL options on the options file, except on HP platforms. The default for ANSYS, Inc. products is 55 minutes.

  • You can now specify the order in which the products appear in the launcher by using the new ANSLIC_ADMIN option Specify Product Order.

Conventions Used in This Document

Computer prompts and responses and user input are printed using this font:

/ansys_inc/shared_files/licensing/lic_admin/anslic_admin

Lengthy user input lines that exceed the width of the page are listed in multiple lines, with the second and subsequent lines indented:

exec_path  <drive>:\Program Files\Ansys Inc\ansys110\ac4
     \bin\pro\<platform>\ac4pro110.exe

Wild card arguments and variables are italicized.

Commands appear in bold face.

Note

Note paragraphs are introduced by the text Note. A note contains information that supplements the main topic being discussed.

Caution

Paragraphs that begin with the word “Caution” in bold, with the rest of the text in normal type, warn you about actions or situations that potentially may cause problems or unexpected behavior or results in ANSYS, Inc. products.

Warning

Paragraphs that begin with the word “Warning” in bold warn you about actions or situations that can shut down ANSYS, Inc. products, damage files, etc.

Introduction

ANSYS, Inc. uses the FLEXlm license manager (also called the FLEXnet License Manager) for all of its licensed products. FLEXlm, the most popular license manager used in the software industry, is best known for its ability to allow software licenses to be available (or float) anywhere on a network. Floating licensing benefits both users and license administrators. Users can make more efficient use of fewer licenses by sharing them on the network. License administrators can control who uses the licensed application and the machine(s) where the licenses will be available. The format of the traffic between the ANSYS product(s) and the license manager is machine independent, allowing for heterogeneous networks. This means the license server and the computer running an application can be either different hardware platforms or even different operating systems (Windows and UNIX, for example).

The license manager, daemons or services, and license utility files are installed during the installation process.

A typical installation on a UNIX machine allows you to install the product anywhere on the system. The installation then creates a symbolic link from the installation directory to /ansys_inc. All licensing files and utilities are provided in the /ansys_inc/shared_files/licensing subdirectory.

If you installed the product elsewhere on your system, replace all references to /ansys_inc in this guide with the name of the installation directory you used. Any reference throughout this manual to the licensing directory on Unix platforms means /ansys_inc/shared_files/licensing.

A typical installation on a Windows machine (choosing the default installation directory) installs the products in the product subdirectory in \Program Files\Ansys Inc, located on the same drive as the operating system. The \Shared Files\Licensing subdirectory is also created in this installation directory. If you installed the product in a different directory, replace all references to \Program Files\ANSYS Inc\<product> in this guide with the name of the installation directory you used. However, the licensing directory will still remain in the default location; you cannot change this location. The licensing components are shared across all ANSYS, Inc. products and need to reside in a fixed location.

Any reference throughout this manual to the licensing directory on Windows platforms means \Program Files\Ansys Inc\Shared Files\Licensing, located on the same drive as the operating system.

The Licensing Process

The licensing process for ANSYS, Inc. products is as follows:

  1. Select the license server(s). See Selecting License Servers.

  2. Install and configure TCP/IP. See Communications Requirements for information on configuring TCP/IP.

  3. Install the software. See the appropriate installation manual for your product and platforms.

  4. Register the license server(s). See Registering License Server Information.

  5. Run the License Wizard. See Run the License Wizard

  6. Set up the licensing environment. See "The Licensing Environment".

Compatibility with Other FLEXlm-Licensed Software

Because of FLEXlm's popularity, you may have FLEXlm licenses from more than one vendor.

The ANSYS License Manager uses FLEXlm 10.8.0.7. If you do have other FLEXlm-licensed products running FLEXlm 10.8.0.7 or higher, you can run them in conjunction with ANSYS products with no intervention or special configuration requirements.

However, if you want to combine ANSYS, Inc. license files with other license files and use one lmgrd license manager, please refer to the FLEXnet Licensing End User Guide (accessible from the ANSLIC_ADMIN utility) for information on how to administer multiple products using the FLEXlm license manager. If you need technical assistance when running multiple products under the same license manager, please contact Macrovision Corporation for technical support.

Links to FLEXlm

For more information on using FLEXlm, please visit the FLEXlm web site at http://www.macrovision.com/products/flexnet_publisher/licensing_module.shtml. You can refer to the FLEXnet Licensing End User Guide for the most current information on all FLEXlm features. You can access this document from the ANSLIC_ADMIN Help menu option View the FLEXnet Licensing End User Guide.

The following introductory licensing topics are available:

Communications Requirements

Configuring TCP/IP

TCP/IP needs to be configured and started for any ANSYS, Inc. product and the license manager to be able to run. You should consult your network administrator for assistance with this configuration. The TCP/IP protocol must be installed on any machine on which you want to run an ANSYS product.

TCP/IP is supplied as part of the UNIX operating system. Table 1: "Configuring TCP/IP" specifies the system utility used to configure TCP/IP on the various hardware platforms. You should consult your network administrator for assistance with this configuration.

Note

HP AlphaServer and Intel Linux systems require an Ethernet card.

Table 1  Configuring TCP/IP

Hardware PlatformTCP/IP Configuration Utility
HP AlphaServer (Compaq)sysman net_wizard
HPsam
IBMsmit tcpip
SGIFrom the desktop icon, choose this path: System>System Manager>Network Setup
Sun, Fujitsu/etc/rc2.d/S69inet
Intel Linuxlinuxconf
Opteron Linuxyast

For Windows systems, the TCP/IP protocol is included as part of the operating system and is typically installed by default. If you do need to install TCP/IP, remember that it must be bound to a network adapter.

On machines that are connected to an internal network, TCP/IP must be bound to a network card such as an Ethernet adapter. The vast majority of systems using TCP/IP will fall into this category.

On machines that connect to the Internet or corporate intranet through a modem, TCP/IP can be bound to a dial-up connection.

Determining Whether TCP/IP Is Installed on a Microsoft Windows System

To determine if TCP/IP is installed on your system, open the Control Panel. Continue as follows based upon the machine's operating system:

  • Windows XP -- Open Network Connections, highlight Local Area Connection and right-mouse click. Select Properties. Internet Protocol (TCP/IP) should be listed.

  • Windows 2000--Open Network and Dial-Up Connections, open Local Area Network, and then click on the Properties button. Internet Protocol (TCP/IP) should be listed.

If TCP/IP is installed, you must determine whether it is bound to a network adapter card or a dial-up connection. A network card or a Dial-Up Adapter will be shown under “Connect Using:”.

Caution

If your computer is connected to a network, it is highly recommended that you contact your Information Technology Department before installing or modifying TCP/IP on your machine.

Changing the Default Port Number

A port number specifies the communications channel by which two or more processes can communicate. ANSYS uses 1055 as the default port number for the ANSYS FLEXlm license manager. If you encounter a conflict in port numbers, you can change the default by modifying all of the following files:

  • On the server machine(s): the port number listed on the SERVER line in the license file (license.dat) on the license server(s).

  • On the client machine(s): the port number listed in the ansyslmd.ini file or the port number specified in the LM_LICENSE_FILE or the ANSYSLMD_LICENSE_FILE environment variables, if set.

Explanation of Licensing Terms

The four main components of FLEXlm are:

  • License manager daemon (lmgrd)

  • Vendor daemon (ansyslmd)

  • License files

  • Application program (e.g., ANSYS)

These components are explained in more detail in the following sections. Note that the term daemon is used throughout this document. A daemon on Unix systems is the same as a service on Windows systems.

The License Manager Daemon (lmgrd)

The license manager daemon (lmgrd) handles the initial contact with the client application programs (ANSYS, etc.), passing the connection on to the appropriate vendor daemon (ansyslmd for ANSYS products). It also starts and restarts ansyslmd. Although not recommended, FLEXlm permits redundant license manager daemons on three server machines, allowing you to make your license available if any two of the three server machines is running. Redundancy can be achieved with three-server redundant servers or by using multiple single-license servers. See Redundant Server Options for more information.

The Vendor Daemon (ansyslmd)

In FLEXlm, licenses are granted by running processes. There is one process for each vendor who has a FLEXlm-licensed product on the network. This process is called the vendor daemon. The vendor daemon keeps track of how many licenses are checked out, and who has them. If the vendor daemon terminates for any reason, all users lose their licenses. The ANSYS vendor daemon is ansyslmd.

Client programs communicate with ansyslmd, usually through TCP/IP network communications. The vendor daemon (ansyslmd) is started by the license manager daemon (lmgrd).

The License File

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

The default location for the ANSYS license file (license.dat) is in the licensing directory. End users can override this location by setting the environment variable ANSYSLMD_LICENSE_FILE to point elsewhere. License files need to reside only on license servers.

The Application Programs

Application programs are software programs such as ANSYS, CFX, etc. ANSYS application programs containing FLEXlm need to be able to communicate with the ANSYS license manager. All ANSYS, Inc. products use the same license manager.

License Servers

License administration is controlled by specific computers on the network called license servers. License servers monitor what products are being run, who is running them, and from what computer system. They grant or deny permission to run products. When an ANSYS product begins, it requests permission to execute from a server. The server checks the pool of available license tasks and grants the request only if the required tasks are available. For each request that is granted, the required license tasks are removed from the pool. As each ANSYS product execution ends, these license tasks are returned to the pool of available tasks.

The server machine or machines are designated by you--the end user. You have the option of designating one server or three servers. In a one-server network, if the server machine goes down, the licenses are no longer available for use until the server machine is back in service. In a three-server network, as long as two of the three machines are still running, the licenses are still available for use.

The master server actually controls the license administration. If a network has only one server, then that server is automatically the master server. In a three server environment, the order of the SERVER lines in the license file determines which server is the master. The order of the servers must match on all machines in a three server environment. The first is the master, the second is the first backup, etc. If the order of the SERVER lines does not match on the three servers, then the servers will attempt to determine the master server; however, this attempt may not be successful. In a three-server network, if the master server is unavailable, then the first backup acts as the master.

You must make sure the order of the SERVER lines is consistent between redundant servers; otherwise, reconnections may fail.

The following license server topics are available:

Selecting License Servers

Before running any FLEXlm-licensed program using floating licenses, you must select which machine(s) will be license servers, and provide the hostid and hostname of those machines to ANSYS, Inc. Use the Register License Server Information option of the ANSLIC_ADMIN utility to generate the licserver.info file, which then needs to be forwarded to your ANSYS sales representative. If ANSYS is not available for installation on a license server, you can download a utility to capture license server information from http://www.ansys.com/services/license_hostid.

You need to select the computer systems that will act as servers before we can supply you with the licenses that are required to activate your licensed product(s). Information about the servers is used to generate the necessary license key(s).

Consider the following points when deciding which computer(s) will be used as server(s):

  • All files used in conjunction with the license software must be located on a disk that is physically local to the server computer(s).

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

  • Computers that experience extremely high levels of network traffic or processing lags due to high CPU and/or I/O usage are poor candidates for servers.

  • Do not use computers that are frequently rebooted as servers.

  • The license server must have a static IP address.

  • We do not allow the use of wide area networks (WANs) for license servers (with the standard ANSYS contract).

  • You cannot use DHCP for license servers.

  • If using a three-server network, we recommend that you choose three machines that are of the same platform type (that is, three HPs, three Windows machines, etc.).

  • If using a three-server network, we highly recommend that all three servers be on the same subnet in the same physical location.

If these guidelines are not followed, the ability of the license software to perform consistently will be compromised.

Caution

Do not change the date on the license server machine. Doing so will prohibit the ANSYS product from running. Restoring the system to its original state prior to the date change may require significant effort.

Redundant Server Options

Throughout this document, we use the term “three-server network” when referring to redundant servers. Redundant server setup is a network configuration where multiple systems are designated as license servers. Redundancy can be achieved in two ways:

  • Three different systems can be selected to work together in tandem, whereby two of the three must be running at all times. These three license servers work from a single set of licenses.

  • Any number of license servers can be running independently. The total number of licenses is split between each license server. For example, if you are licensed for 20 tasks of a certain product, and you have two license servers, each license server will serve ten licenses. In this example, if one of these systems fails, only ten licenses will be available.

We recommend the second option if your site requires redundancy. Be sure to review Selecting License Servers for guidelines and special considerations when choosing license servers. Single license server networks are usually sufficient for most sites.

Registering License Server Information

The Register License Server Information option of the ANSLIC_ADMIN utility creates a file named licserver.info in the home and licensing directory. The content of this file is generated by prompting you for information about your company and you (the person running the utility). This is important so that we know to which of our customers this information belongs and to whom we may speak if we have questions about the data. The option also pulls necessary information from your license server (such as computer type, operating system level, and hostid) and places it in the file. Create this file on each system that will be a license server. Return the licserver.info file(s) to your ANSYS sales representative so that licenses can be supplied to you.

License Files

All ANSYS, Inc. programs use a single, common license file. The license file contains all site-specific information required by FLEXlm. This information includes:

  • Server names and hostids

  • Vendor daemon name

  • Feature information

In general, the license file must exist on every machine designated as a license server. If the license file contains counted (also called "floating") licenses, you have to start the license manager daemon (lmgrd) before you can use the application on Unix systems. On Windows systems, the license manager daemon is installed as a service named ANSYS FLEXlm License Manager.

You can use the License Wizard available from the ANSLIC_ADMIN utility to install or update a license file, specify the license server, and start or reread the license file. The wizard will prompt you for the necessary information at each step.

The following license file topics are available:

Installing License Files

Use the Run the License Wizard option of the ANSLIC_ADMIN utility to install the license file. The wizard walks you through the process of installing or updating a license file, specifying the license servers (which updates the ansyslmd.ini file), and starting the license manager or rereading the license file. The license file will be named license.dat and will be created in the licensing directory.

If you are running in a three-server environment, the license file must reside on all three servers and must match on all three servers. Therefore, run the license wizard on all three servers.

Specifying the License Server and License Files

ANSYS products expect the license file to be named license.dat and reside in the licensing directory.The license file must reside on the license servers but does not have to be on the machines where the ANSYS product is run. If you are running ANSYS products on multiple machines, you have these options for making your license available on all the client machines:

  • Choose the Specify the License Server option of the ANSLIC_ADMIN utility to create a file named ansyslmd.ini in the licensing directory. Each server's specification entry in this file must begin with SERVER=. This option is highly recommended. The format of the ansyslmd.ini file created by ANSLIC_ADMIN follow.

    On a single server:

    SERVER=<port>@<host>

    On redundant or multiple single servers on UNIX platforms:

    SERVER=<port>@<host1>:<port>@<host2>:<port>@<host3>

    Windows platforms use semicolons (;) instead of colons:

    SERVER=<port>@<host1>;<port>@<host2>;<port>@<host3>

    The ANSYS default port number is 1055 and the host is the license server hostname. For example, if the license server name is alpha1:

    SERVER=1055@alpha1

    This specification can also be set to the path and filename of a valid license file:

    SERVER=<full path to the license file>

    The order of the SERVER lines in the ansyslmd.ini file specifies the order in which the requested license will be granted.

  • Set the ANSYSLMD_LICENSE_FILE environment variable to port@host, where host and port come from the SERVER line in the license file. The ANSYS default port number is 1055. This environment variable can also be set to the path and filename of a valid license file. This option is NOT recommended.

  • Set the LM_LICENSE_FILE environment variable to port@host. This environment variable can also be set to the path and filename of a valid license file. Be aware that setting this environment variable can be disruptive to other software companies' products that use FLEXlm as their license manager. This option is NOT recommended.

The license file path specified in the ANSYSLMD_LICENSE_FILE or the LM_LICENSE_FILE environment variables can be port@host, a directory name, a file, or a list of files separated by colons on UNIX or semi-colons on Windows. If there is a directory name in this list, all files named *.lic in that directory are used.

You can only start the license manager on the server machine specified in the license file.

Note

If you are running redundant servers, you should have the license file (as well as the entire licensing directory) installed locally on each license server. If you do not, you lose all the advantages of having redundant servers, since the file server holding these files becomes a single point of failure.

Setting the Path with an Environment Variable

ANSYS products expect the license file to reside in the licensing directory and be named license.dat. You should rarely, if ever, want to specify where the license file is located with an environment variable. However, you can change the license file location with the ANSYSLMD_LICENSE_FILE or the LM_LICENSE_FILE environment variables.

Use the environment variable ANSYSLMD_LICENSE_FILE to set the location of the license file. For example, in the UNIX C shell:

% setenv ANSYSLMD_LICENSE_FILE license_file_path

Using the earlier example of a license server named alpha1, the line would look like this:

setenv ANSYSLMD_LICENSE_FILE 1055@alpha1
or
setenv ANSYSLMD_LICENSE_FILE /ansys_inc/shared_files/licensing/license.dat
The second example above would look only in the specified directory on the local machine.

In the UNIX Korn and Bourne shells:

# ANSYSLMD_LICENSE_FILE=license_file_path
# export ANSYSLMD_LICENSE_FILE

On Windows, use the Control Panel to change the system environment, setting ANSYSLMD_LICENSE_FILE to license_file_path, where license_file_path is the full path to the license file. This can also be a port@host setting, where port and host are the port number and host name from the SERVER line in the license file. The ANSYS default port number is 1055.

With lmgrd and lmutil (lmstat, lmdown, etc.), the -c option overrides the setting of the ANSYSLMD_LICENSE_FILE environment variable (UNIX only).

License Files Settings Precedence

License file settings have precedence in the following order:

  1. ANSYSLMD_LICENSE_FILE environment variable

  2. The FLEXlm resource file: ~/.flexlmrc (UNIX) or the Windows registry

  3. LM_LICENSE_FILE environment variable

  4. Settings in the ansyslmd.ini file in the licensing directory

  5. The license file license.dat. Be aware that the license.dat file is not always used. If you have an ansyslmd.ini file with at least one SERVER line in it, the license.dat file will not be used.

License Files Format

License files usually begin with a SERVER line (or three SERVER lines for redundant servers) followed by a VENDOR line, followed by one or more INCREMENT lines.

You can modify only these data items in the license file:

  • system host names on the SERVER line(s)

  • Port numbers on the SERVER line(s)

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

  • Options file paths on the VENDOR line(s)

  • Optional port numbers on the VENDOR line(s) (for firewall support only)

Long lines normally use the "\" line-continuation character to break up long lines. A space character must precede the line-continuation character.

Note

Everything else is used to compute the license key and should be entered exactly as supplied. All data in the license file is case sensitive, unless otherwise indicated.

SERVER Lines

The SERVER line specifies the hostname and hostid of the license server and the port number of the license manager daemon (lmgrd). Normally a license file has one SERVER line. Three SERVER lines mean that you are using redundant servers. License administrators do not have the option of deleting SERVER lines from a license file because the hostids from all of the SERVER lines are computed into the license keys on every INCREMENT line.

The format of the SERVER line is:

SERVER host hostid 1055

where:

host is the license server host name or IP address; a string returned by the UNIX hostname or uname -n command. On Windows systems, ipconfig /all returns the host name. This can also be an IP address (nnn.nnn.nnn.nnn format).

hostid is usually the string returned by the Display the License Server Hostid option of the ANSLIC_ADMIN utility.

1055 is the TCP port number to use. ANSYS' port number is 1055. This can be changed if port 1055 is already in use on your system.

Example:

SERVER enterprise 0122345 1055

Note

If you change the port number, then you must also change the port number that is specified in the ansyslmd.ini file, or in the ANSYSLMD_LICENSE_FILE or the LM_LICENSE_FILE environment variables to match the port number specified in the SERVER line.

VENDOR Lines

The VENDOR line specifies the vendor daemon's name and path. lmgrd uses this line to start the vendor daemon, and the vendor daemon reads it to find its options file. The format of the VENDOR line is shown below.

VENDOR ansyslmd [vendor_daemon_path]
     [[options=]options_file_path] [[port=]port]

where:

ansyslmd is the name of the ANSYS vendor daemon.

vendor_daemon_path is the path to the executable for this daemon. This path is optional. ANSYS, Inc. does not supply this field because lmgrd will look for the vendor daemon ansyslmd executable in the directory where lmgrd is located and all ANSYS products install both of these daemons into the same directory.

Note

If you do supply this path and the path includes spaces, enclose the entire directory path in double quotes, as in the following example:

VENDOR ansyslmd "c:\program files\ansys inc\Shared Files\Licensing
    \Intel"

options_file_ path is the full path to the end-user options file for this daemon. FLEXlm does not require an options file. The options file need not be specified on this line. As long as the options file ansyslmd.opt is located in the same directory as the license file (the licensing directory), the vendor daemon will automatically find and use it. The Edit the FLEXlm Options File option of the ANSLIC_ADMIN utility will put the options file in the correct directory location.

If the directory path includes spaces, enclose the entire directory path in double quotes, as in the following example:

VENDOR ansyslmd options="c:\program files\ansys inc\Shared Files\
     Licensing\ansyslmd.opt"

port is the vendor daemon port number. Note: This is for firewall support only and is otherwise not recommended. In the following example, #### would be replaced with the port number you choose:

VENDOR ansyslmd options=/ansys_inc/shared_files/licensing
     /ansyslmd.opt port=####

INCREMENT Lines

An INCREMENT line describes the license to use a product. The syntax of the INCREMENT line is:

INCREMENT feature ansyslmd feat_version
      exp_date #lic key  [HOSTID=feat_hostid]
      [VENDOR_STRING="vendor_str"] [BORROW=n] [PLATFORMS="..."] 
      [SUPERCEDE="..."] [ISSUED="..."] [START="..."]
      [ISSUER="..."] [NOTICE="..."] [OVERDRAFT=nnn]
      [DUP_GROUP=NONE|SITE|[UHDV]]  [TS_OK]

where:

feature is the name representing the product/capability being licensed.

ansyslmd is the name of the ANSYS vendor daemon; also found in the VENDOR line. The specified daemon serves this feature.

feat_version is the latest build date of this feature that is supported by this license. For paid-up customers, this is usually set to the expiration date of the maintenance agreement. The value of 9999.9999 is used when this field is not applicable.

exp_date is the expiration date of license, e.g., 7-may-2007.

#lic is the number of concurrent licenses for this feature.

key is the encryption key for this INCREMENT line.

Many optional fields may follow. For example, the BORROW field indicates that borrowing is enabled for that license feature. n is the maximum number of hours that a license can be borrowed. The maximum is 720 hours (30 days).

See the FLEXnet Licensing End User Guide (accessible from the ANSLIC_ADMIN utility) for more information.

Sample License Files

A sample license file is shown here. This file is for 15 ANSYS Mechanical tasks and 12 ANSYS DesignSpace tasks.

SERVER gagh 690daec6 1055
VENDOR ansyslmd
INCREMENT ansys ansyslmd 9999.9999 30-sep-2007 15 8C59A481BA50 \
     VENDOR_STRING=customer:00012345 ISSUED=10-sep-2006 \
     START=10-sep-2006
INCREMENT dspi ansyslmd 9999.9999 30-sep-2007 12 424290D68B3D \
     VENDOR_STRING=customer:00012345 ISSUED=10-sep-2006 \
     START=10-sep-2006
INCREMENT caewbpl3 ansyslmd 9999.9999 30-sep-2007 12 535301E79C4E \
      VENDOR_STRING=customer:00012345 ISSUED=10-sep-2006 \
      START=10-sep-2006
where:
  • gagh is the hostname of the license server

  • 690daec6 is the hostid

  • 1055 is the port number

  • ansyslmd is the vendor daemon

  • ansys, dspi, and caewbpl3 are the features representing ANSYS Mechanical and ANSYS DesignSpace.

  • 9999.9999 indicates that the maintenance agreement is not applicable. Otherwise, this the highest supported build date for the product. For ANSYS only, you can view the build date by running ANSYS with the -v command option.

  • 30-sep-2007 is the expiration date

  • 15 and 12 are the number of tasks for ANSYS Mechanical and ANSYS DesignSpace, respectively

  • 8C59A481BA50, 424290D68B3D, and 535301E79C4E are encryption keys for ANSYS Mechanical and ANSYS DesignSpace, respectively

  • customer:00012345 is the customer number

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

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

Recognizing an ANSYS License File

If you receive a license file and are not sure if it is an ANSYS license file, you can determine if it is by looking at the contents of the license file. If it is an ANSYS license file, then:

  • In the line beginning with the word VENDOR, the next field/item is ansyslmd.

  • In the line(s) beginning with the word INCREMENT, the third field/item is ansyslmd.

ANSYS, Inc. supplies some licenses for other products that use different license managers. These license files are not compatible with the ANSYS license manager. The products and how to recognize their license files are explained below:

ANSYS CFX

Some CFX license files are not compatible with the ANSYS license manager. You can recognize CFX license files in two ways:

  • In the line beginning with the word DAEMON, the second field/item is CFDS.

  • In the line(s) beginning with the word INCREMENT, the third field/item is CFDS.

Please use the CFX license manager utility to administer CFX licenses.

ANSYS ICEM CFD

Some ANSYS ICEM CFD license files are not compatible with the ANSYS license manager. You can recognize these license files in two ways:

  • In the line beginning with the word VENDOR, the second field/item is ICEM_CFD.

  • In the line(s) beginning with the word FEATURE, the third field/item is ICEM_CFD.

Please use the ICEM license manager tools to administer ICEM licenses.

Century Dynamics, Inc.

Some Century Dynamics, Inc. license files are not compatible with the ANSYS license manager. You can recognize these license files in the following ways:

  • For ANSYS AUTODYN, in the line beginning with the word VENDOR, the second field/item is AUTODYN.

  • In the line(s) beginning with the word FEATURE, the third field/item is AUTODYN.

  • For ASAS and AQWA, in the line beginning with the word VENDOR, the second field/item is ASASLM.

  • In the line(s) beginning with the word FEATURE, the third field/item is ASASLM.

Miscellaneous

Other products whose license files are not compatible with the ANSYS license manager include TAS, TASPCB, and PTD. You can recognize these license files in two ways:

  • In the line beginning with the word VENDOR, the second field/item is thermal.

  • In the line(s) beginning with the word FEATURE, the third field/item is thermal.

Product Variable Table

The following table shows all ANSYS, Inc. products and their associated feature name as used in the INCREMENT lines.

This table is provided as a reference for both current and legacy products. Not all products listed are generally available. Please contact your ANSYS sales representative or technical support representative for details regarding product availability.

Table 1  Product/Feature Names for Licensed Products

ProductFeature Names
ANSYS Multiphysicsane3fl*
ANSYS Multiphysics/LS-DYNAane3flds*
ANSYS Multiphysics 1ane3fl1*
ANSYS Multiphysics 2ane3fl2*
ANSYS Multiphysics 3ane3fl3*
ANSYS Multiphysics/LS-DYNA PrepPostane3fldp*
ANSYS Mechanicalansys*
ANSYS Mechanical/Emagane3*
ANSYS Mechanical/FLOTRAN anfl*
ANSYS Mechanical/LS-DYNAansysds*
ANSYS Mechanical/Emag/LS-DYNAane3ds*
ANSYS Mechanical/FLOTRAN/LS-DYNAanflds*
ANSYS Mechanical/LS-DYNA PrepPostansysdp*
ANSYS Mechanical/Emag/LS-DYNA PrepPostane3dp*
ANSYS Mechanical/FLOTRAN/LS-DYNA PrepPostanfldp*
ANSYS Mechanical/CFX-Floancfx*
ANSYS Structuralstruct*
ANSYS Structural/Emagste3*
ANSYS Structural/FLOTRANstfl*
ANSYS Structural/Emag/FLOTRAN ste3fl*
ANSYS Structural/LS-DYNAstructds*
ANSYS Structural/Emag/LS-DYNAste3ds*
ANSYS Structural/FLOTRAN/LS-DYNAstflds*
ANSYS Structural/Emag/FLOTRAN/LS-DYNAste3flds*
ANSYS Structural/LS-DYNA PrepPoststructdp*
ANSYS Structural/Emag/LS-DYNA PrepPostste3dp*
ANSYS Structural/FLOTRAN/LS-DYNA PrepPoststfldp*
ANSYS Structural/Emag/FLOTRAN/LS-DYNA PrepPostste3fldp*
ANSYS Structural/CFX-Flostcfx*
ANSYS Professional NLTprf*
ANSYS Professional NLSprfnls
ANSYS Professional/Emagprfe3*
ANSYS Professional/FLOTRANprffl*
ANSYS Professional/Emag/FLOTRANprfe3fl*
ANSYS Emagemag*
ANSYS Emag HFemaghf*
ANSYS Emag/FLOTRANemagfl*
ANSYS FLOTRANflotran*
ANSYS PrepPostpreppost*
ANSYS PrepPost/LS-DYNA PrepPostprpostdy*
ANSYS LS-DYNAdyna*
ANSYS LS-DYNA PrepPost dynapp*
ANSYS LS-DYNA PCdynapc*
ANSYS Multiphysics Batchmpba*
ANSYS Mechanical Batchmeba*
ANSYS Professional Batchprba*
ANSYS Structural Batchstba*
ANSYS FLOTRAN Batchflba*
ANSYS Emag Batche3ba*
ANSYS DesignSpace Batch Childdebach
ANSYS Emag Batch Childe3bach
ANSYS FLOTRAN Batch Childflbach
ANSYS Mechanical Batch Childmebach
ANSYS Multiphysics Batch Childmpbach
ANSYS Professional Batch Childprbach
ANSYS Structural Batch Childstbach
ANSYS DesignSpace Entracaewbpl1
ANSYS DesignSpace Structuraldsstruct
ANSYS DesignSpacecaewbpl3
ANSYS Workbench SDKcaewbplh, caetmpl, piautoin, pimedesk, pisolwor, pisoledg, piproe, dsdxm
ANSYS Workbench Runtimecaewbplh, caetmpl
ANSYS CFX-CAD2Mesh with DesignModelercad2mesh, aimed, aioutput, aiprism, aitetra, agppi, aiiges, aiacis, aipips, aidxf, acfx_pre
ANSYS CFX-Meshcad2mesh
ANSYS CFX FLOTRAN Upgradeacfx_flotran_upgrade
ANSYS CFX Floacfx_anymodule
ANSYS CFX PrepPostacfx_anymodule
ANSYS CFX Basic Capability Solveracfx_pre, acfx_solver, acfx_nolimit, acfx_parallel
ANSYS CFX Multiple Frames of Referenceacfx_mfr
ANSYS CFX Multi-Phase Flowsacfx_multiphase
ANSYS CFX Reacting and Combusting Speciesacfx_combustion
ANSYS CFX Radiation Modelsacfx_radiation
ANSYS CFX Advanced Turbulence Modelsacfx_advanced_turbulence, acfx_turbulence_transition
ANSYS CFX Parallel Computingacfx_par_proc
ANSYS CFX Full Capability Solveracfx_pre, acfx_solver acfx_nolimit, acfx_mfr, acfx_multiphase, acfx_combustion, acfx_radiation, acfx_parallel, acfx_advanced_turbulence, acfx_turbulence_transition
ANSYS CFX-Postacfx_post
ANSYS BladeModeleracfx_bldmdlr
ANSYS TurboGridacfx_turbogrid
ANSYS CFDacfd
ANSYS CFD Batchacfd_server, acfx_pre
ANSYS CFD PrepPostacfd_client
ANSYS CFD HPCacfd_par_proc
ANSYS ICEM CFD Hexa Add-onaihexa
ANSYS ICEM CFD Basic with Advanced Geometry Supportaioutput, aiiges, aiacis, aiedgeom, aioutcfd, aidxf
ANSYS ICEM CFD Basic with Geometry Interface for NXaioutput, aiiges, aiacis, aipiug, aioutcfd, aidxf
ANSYS ICEM CFD Basic with Geometry Interface for CATIA V4aioutput, aiiges, aiacis, aipicat, aioutcfd, aidxf
ANSYS ICEM CFD Basic with Geometry Interface for Pro/ENGINEER aioutput, aiiges, aiacis, aipipro, aioutcfd, aidxf
ANSYS ICEM CFD Basic with Geometry Interface for SDRC-IDEAS aioutput, aiiges, aiacis, aipiidea, aioutcfd, aidxf
ANSYS ICEM CFD Basic with Geometry Interface for SolidWorks aioutput, aiiges, aiacis, aipisw, aioutcfd, aidxf
ANSYS ICEM CFD Basic with Geometry Interface for SolidEdge aioutput, aiiges, aiacis, aipise, aioutcfd, aidxf
ANSYS ICEM CFD Hexaaimed, aihexa
ANSYS ICEM CFD Tetra/Prismaimed, aitetra, aiprism
ANSYS ICEM CFD Quadaimed, aiquad
ANSYS ICEM CFD Globalaimed, aiglobal
ANSYS ICEM CFD Autohexaaimed, aiautmdl, aiautmsh
ANSYS ICEM CFD Hexa CAA V5 Based (for CATIA V5)aihexct5, aihexct5e
ANSYS ICEM CFD Mesh Prototyperaiiges, aiacis, aimed, aitetra, aimshprt
ANSYS ICEM CFD Environment for CART3Daivis3, aiiges, aiacis
ANSYS ICEM CFD Cart3D Productaimed, aimshcrt, aiflowcrt, aiflowcrtp
ANSYS ICEM CFD BF-Cartaibfcart, aimed
ANSYS ICEM CFD Cabin Modeler Stand-aloneaimed, aitetra, aiprism, aicabin
ANSYS ICEM CFD IC3M Stand-alone aimed, aitetra, aihexa, aiic3m, aiic3msb
ANSYS ICEM CFD Comakaimed, aicomak
ANSYS ICEM CFD Visual3 / PV3aivis3
ANSYS ICEM CFD OptiMesh aioptmsh
ANSYS AUTODYN-2Dacdi_ad2dfull
ANSYS AUTODYN-3Dacdi_ad3dfull
ANSYS AUTODYNacdi_ad2dfull, acdi_ad3dfull, acdi_adhpc, acdi_adprepost
ANSYS AUTODYN HPCacdi_adhpc
ANSYS AUTODYN PrepPostacdi_adprepost
ANSYS AI*Environmentaienv, aienvsub
Direct CAD Interface - CATIA V4aipicat
Direct CAD Interface - SDRC-IDEASaipiidea
ANSYS ICEM CFD Parasolid Readeraipips
Direct CAD Interface - Pro/ENGINEERaipipro
Direct CAD Interface -Solid Edgeaipise
Direct CAD Interface -SolidWorksaipisw
Direct CAD Interface - NXaipiug
Batch Meshing Module Add-on to AI*Environmentbatmesh, bmeshsub
CFD Utilities Add-on for AI*Environmentaiprism, aioutput, aioutcfd
ANSYS Connection for CATIA V4concatia
ANSYS Connection for CATIA V5concatv5
ANSYS Connection for Parasolidconpara
ANSYS Connection for Pro/ENGINEERconproe
ANSYS Connection for SATconsat
ANSYS Connection for NXconug
Geometry Interface for Inventor MDTpiautoin, pimedesk
Geometry Interface for CATIA V4picatia
Geometry Interface for CATIA V5picatv5
Geometry Interface for Parasolidrdpara
Geometry Interface for Pro/ENGINEERpiproe
Geometry Interface for SATrdacis
Geometry Interface for SolidEdgepisoledg
Geometry Interface for SolidWorkspisolwor
Geometry Interface for NXpiug
Geometry Interface for OneSpace Designer1spacdes
TASahti_tas
TASTECahti_tastec
TAS Pultrusionahti_tas_pultrusion
TAS Sinda/3Dahti_tas_sinda3d
TASStressahti_tas_stress
FET Module for TASahti_tas_fet
TASPCBanti_taspcb
CADNexus/CAPRI CAE Gateway for CATIA V5capricatv5
Geometry Interface for Accel EDAahti_accel_eda
Geometry Interface for Cadence Allegroahti_cadence_allegro
Geometry Interface for DDEahti_dde
Geometry Interface for EDF SCHahti_edf_sch
Geometry Interface for Gencadahti_gencad
Geometry Interface for Gencamahti_gencam
Geometry Interface for Mentor Graphics Boardstationahti_mentor_boardstation
Geometry Interface for Mentor Graphics Neutralahti_mentor_neutral
Geometry Interface for OrCadahti_orcad_layout
Geometry Interface for PADSahti_pads
Geometry Interface for PCADahti_pcad_pdif_layout
Geometry Interface for Protelahti_protel_pcb
Geometry Interface for Thedaahti_theda
Geometry Interface for Mentor Graphics Expeditionahti_veribest_vb_ascii
Geometry Interface for Zuken CR3000ahti_zuken_cr3000
Geometry Interface for Zuken CR5000ahti_zuken_cr5000
Geometry Interface for Zuken CADStar/Visulaahti_zuken_cadstar_vis
PTDahti_ptd
ANSYS DesignModeleragppi
ANSYS DesignXplorerdsdxm
ANSYS CAE Templatescaetmpl
ANSYS Fatigue Moduledfatigue
ANSYS Workbench Interface for UNIXwbunix
ANSYS LS-DYNA Paralleldysmp
ANSYS LS-DYNA Drop Test Module (-DTM)dydtm
LS-DYNA MAT_161lsmat161
LS-DYNA MAT_162lsmat162
ANSYS Mechanical HPC mechhpc
ANSYS Interface for Team Center Engineeringpdmiman
ANSYS Mesh Morpherparamesh
ANSYS Mesh Morpher Target Geometry Modulepmeshgeo
ANSYS Academic Associateaa_a*, aa_mcad
ANSYS Academic Associate AUTODYNaa_a_ad, aa_mcad
ANSYS Academic Researchaa_r*, aa_mcad
ANSYS Academic Research CFDaa_r_cfd, aa_mcad
ANSYS Academic Research LS-DYNAaa_r_dy*, aa_mcad
ANSYS Academic Research Electronics Thermalaa_r_ht, aa_ecad
ANSYS Academic Research AUTODYNaa_r_ad, aa_mcad
ANSYS Academic Teaching Introductoryaa_t_i*, aa_mcad, aa_ds
ANSYS Academic Teaching Advancedaa_t_a*, aa_mcad, aa_ds
ANSYS Academic Teaching Mechanicalaa_t_me*, aa_mcad, aa_ds
ANSYS Academic Teaching CFDaa_t_cfd, aa_mcad
ANSYS Academic Teaching AUTODYNaa_t_ad,aa_mcad
ANSYS Academic Meshing Toolsaa_mesh, aa_mcad, aioutcfd
ANSYS Academic CFD Turbo Toolsaa_turbo
ANSYS Academic LS-DYNA Parallelaa_dy_p
ANSYS Academic Mechanical HPCaa_p_me
ANSYS Academic AUTODYNHPCaa_p_ad
ANSYS Academic CFD HPCaa_p_c
ANSYS Rigid Dynamicskinemat, dynamics
Pressure Equipment Modulepreqmo

An * after a feature name indicates that an item is a product variable and can be used on a stand-alone basis to start a product run.

Products listed here use the ANSYS license manager. ANSYS, Inc. does supply licenses for ICEM CFD, CFX, Century Dynamics, Inc., and Harvard Thermal products not listed above; however, those licenses will use their respective license manager. To determine the license manager to which the license applies, see Recognizing an ANSYS License File.

The ANSYS License Manager

In order to run ANSYS products and then perform standard administration/operation tasks, you must make sure that the license manager is running.

The following license manager topics are available:

License Manager Daemon

Most ANSYS products use a small program that runs in the background on the server machine(s) to perform standard licensing operations. This program is called a daemon. The license manager daemon lmgrd and the vendor daemon ansyslmd perform license manager functions such as processing requests for clients. Both of these daemons must be running on the license server. On Windows systems, the license manager daemon is installed as a service named ANSYS FLEXlm License Manager.

Modifying License Manager Startup Options

Although we do recommend using the default settings when starting the license manager, you may find the need to change one of the options.

On UNIX systems, use the Modify Startup Options option of the ANSLIC_ADMIN utility to modify the directory path to the license file and the directory path to the license.log file.

You can also set FLEXlm's -2 -p or -local options. The -2 -p restricts the ability to shut down the license manager, reread the license file, or remove a client to a FLEXlm administrator (who is by default root) or a member of the lmadmin group, if one exists. If the root administrator is not a member of this group, then he does not have permission to use any of the above utilities. The -local option further restricts the ability to shut down the license manager to only an administrator running on the same machine where the license manager was started. Both options are off by default. See the FLEXnet Licensing End Users Guide (accessible from the ANSLIC_ADMIN utility) for more information on using these options.

This ANSLIC_ADMIN utility option writes an ansyslmd.ini file in the licensing directory. This file contains modified settings. If the file does not exist, the defaults are used. This option will also update boot_ansflex with any changes. Follow the procedure in Table 1: "License Manager Automatic Startup Instructions" to make sure these new options are used at system boot.

Warning

The license.log file for each server should be located on a local disk. Writing to an NFS-mounted disk or remote file server creates a situation where the license server(s) may fail. If the remote system containing the license.log file crashes, the license manager would be unable to log license transaction data. This would create a fatal error condition.

On Windows systems, run the FLEXlm LMTOOLS utility in the ANSYS FLEXlm License Manager folder to configure the service. See the documentation provided with LMTOOLS for more information.

Starting the License Manager Manually

The lmgrd program must be running on a quorum of systems designated to be servers. In a one-license server system, lmgrd must be started on that server and in a three server system, lmgrd must be started on at least two of the three servers before an ANSYS product can be run.

You can start the license manager manually via the Start the License Manager option of the ANSLIC_ADMIN utility. This option starts the lmgrd license manager daemon, which in turn will automatically start the ansyslmd vendor daemon.

Starting the License Manager at System Boot Time

Table 1: "License Manager Automatic Startup Instructions" details the steps for each UNIX hardware platform that must be performed on each license server to start the license manager automatically when the system is rebooted. You should substitute your platform name (see Supported Hardware Platforms) wherever you see <platform>. On Windows systems, the license manager is set to start up automatically at system reboot.

Note

The procedure described in this section starts the license manager at boot time as root. It is not essential that the license manager be started by the root user; it may be run by a non-privileged user, depending on your preference. If you do not want the license manager to be started by root, see the FLEXnet Licensing End User Guide for an example of starting the license manager as a non-root user at boot time.

Table 1  License Manager Automatic Startup Instructions

PlatformInstructions
HP Alpha
cd /ansys_inc/shared_files/licensing/<platform>
cp boot_ansflex  /sbin/init.d
chmod 750 /sbin/init.d/boot_ansflex
ln -s /sbin/init.d/boot_ansflex 
    /sbin/rc3.d/S90ansysflex
HP
cd /ansys_inc/shared_files/licensing/<platform>
cp boot_ansflex  /sbin/init.d
chmod 750 /sbin/init.d/boot_ansflex
ln -s /sbin/init.d/boot_ansflex 
    /sbin/rc2.d/S900FLEX
IBM RS/6000
cd /ansys_inc/shared_files/licensing/<platform>
cat boot_ansflex >> /etc/inittab
SGI
cd /ansys_inc/shared_files/licensing/<platform>
cat boot_ansflex >> /etc/rc2.d/S40FLEX
chmod 750 /etc/rc2.d/S40FLEX
Sun, Fujitsu
cd /ansys_inc/shared_files/licensing/<platform>
cat boot_ansflex >> /etc/rc3.d/S40FLEX
chmod 750 /etc/rc3.d/S40FLEX
Linux: Red Hat
cd /ansys_inc/shared_files/licensing/<platform>
cat boot_ansflex >>/etc/rc.d/rc.local
Linux: SuSE
cd /ansys_inc/shared_files/licensing/<platform>
cat boot_ansflex >>/etc/rc.d/boot.local

Once the procedure is in place for starting the license manager automatically at boot time, reboot the system.

When the system comes back up, check to see that the license manager is running by typing the appropriate ps command and looking for ansyslmd in the resulting display under the column labeled COMMAND.

For SYS V UNIX systems:

ps -ef

Next, check the license.log file in the licensing directory for error messages. This file contains a history of ANSYS product activity across the network when this computer is chosen as the master license server by the licensing software. It will also contain start-up messages and possibly error messages.

Shutting Down the License Manager

You can shut down the license manager via the Shutdown the License Manager option of the ANSLIC_ADMIN utility (see "License Administration"). This option will shut down all three servers of a redundant setup, unless the license manager was stored with the -local option.

The license manager must be running to be able to run ANSYS products.

Caution

Do not use kill -9 (on UNIX systems) to shut down the license manager. Use the ANSLIC_ADMIN utility option or lmdown.

The Licensing Environment

We recommend that you set up your licensing environment after installing an ANSYS product. The tasks that we recommend performing include:

  • Designating Server(s) for License Check-out

  • Establishing User Privileges

  • Creating the lmadmin Group

  • Setting Up License Queuing

Licensing environment tasks are described in the following sections.

Designating Server(s) for License Check-out

You are not limited to designating one set of license server machines for your network. You can have multiple single-server or three-server licensing systems on your network. In this situation, you would have certain licenses connected to a set of server machines (one or three) on the network, and other licenses connected to a different set of server machines (one or three) on the network.

To designate license servers, run the Specify the License Server option of the ANSLIC_ADMIN utility on every machine where you installed an ANSYS product. With this option, you can specify single servers, multiple single servers, or redundant servers. Using this option creates or updates the ansyslmd.ini file in the licensing directory. We recommend using this method for specifying your license server preference.

If you want to override the settings in the ansyslmd.ini file, you can do so by setting the ANSYSLMD_LICENSE_FILE environment variable. This environment variable is useful if you want to temporarily point to a different license server without disrupting the machine's configuration.

If you set the ANSYSLMD_LICENSE_FILE environment variable on a three-server (redundant) system, specify all three systems, in the same order as the SERVER lines are listed in the license file. If you specify only the master and it is down, you could see a “License Server Down” or “No License Found” message and the search for a license could fail. Join redundant or multiple single server systems by separating the system names with colons on Unix and semicolons on Windows systems.

To have your license server preference known each time you log in, set the environment variable ANSYSLMD_LICENSE_FILE (both Windows and Unix systems). On Unix systems, place this environment variable in your login startup file (i.e., .cshrc file).

Sample Scenario

Suppose that you have a company with two departments, Design and Engineering. The Design Department has one license of ANSYS Mechanical and one license of DesignSpace with the server DES1, and all users in the Design Department run on DES1. The second department, Engineering, has two licenses of ANSYS Multiphysics with the server ENG1, and all users in the Engineering Department run on ENG1. The ansyslmd.ini file states SERVER=1055@DES1 for the Design Department and SERVER=1055@ENG1 for the Engineering Department, limiting users in each department to work only on their own server. If individual users in the Design Department need to run on the engineering server, ENG1, they could set the following environment variable:

setenv ANSYSLMD_LICENSE_FILE 1055@ENG1

For more information on using the license options file, please see Establishing User Privileges.

Establishing User Privileges

To set specific user privileges with FLEXlm, you need to use the options file. The options file allows you, the license administrator, to control various operating parameters of FLEXlm:

  • Allow or deny the use of features based on user, hostname, display name, group, etc.

  • Reserve licenses based on user, hostname, display name, group, etc.

  • Control the amount of information logged about license usage.

By using the options file, you can be as secure or as open with licenses as you like.

The default location of the options file, ansyslmd.opt, is in the licensing directory. If you have a three-server system, the options file must match exactly on all three servers.

If you are using an options file, you must specify the pathname to the file on the VENDOR line in the license file, unless it resides in the same directory as the license file, which is the default when using the ANSLIC_ADMIN utility. On UNIX systems, the VENDOR line would look like this for an options file named my.opt:

VENDOR ansyslmd options=/ansys_inc/shared_files/licensing/my.opt

On Windows systems, if the path has spaces in it, you must enclose it in quotes:

VENDOR ansyslmd options="c:\Program Files\Ansys Inc\Shared Files\Licensing\my.opt"

Editing the Licensing Options File

Use the Edit the FLEXlm Options File option of the ANSLIC_ADMIN utility to edit the license options file.

The maximum line length is 2048 characters. FLEXlm allows the "\" character as a continuation character in options file lines. You can include comments in your options file by starting each comment line with a pound sign "#." Everything in an options file is case sensitive. Be sure that user names and feature names, for example, are entered correctly.

Some commonly used lines in the options file are shown below. See the FLEXnet Licensing End User Guide (accessible from the ANSLIC_ADMIN utility) for information on additional options.

EXCLUDEDeny a user access to a feature.
EXCLUDEALLDeny a user access to all features served by this vendor daemon.
GROUPDefine a group of users for use with any options.
HOST_GROUPDefine a group of hosts for use with any options.
INCLUDEAllow a user to use a feature.
INCLUDEALL Allow a user to use all features served by this vendor daemon.
RESERVEReserve licenses for a user.
BORROW_LOWWATERSets the number of licenses for a BORROW feature that cannot be borrowed.
EXCLUDE_BORROWExcludes a user or predefined group of users from the list of who is allowed to borrow licenses for a BORROW feature.
INCLUDE_BORROWIncludes a user or predefined group of users in the list of who is allowed to borrow a BORROW feature.
MAX_BORROW_HOURSChanges the maximum period for which a license can be borrowed. The new period must be less than that specified in the license file. If multiple MAX_BORROW_HOURS keywords appear in the options file, only the last one is applied to the license feature.

When creating an options file, you must understand the options file precedence. INCLUDE and EXCLUDE statements can be combined in the same options file and control access to the same features. When doing so, keep in mind the following:

  • If there is only an EXCLUDE list, everyone who is not on the list will be allowed to use the feature.

  • If there is only an INCLUDE list, only those users on the list will be allowed to use the feature.

  • If neither list exists, everyone is allowed to use the feature.

  • The EXCLUDE list is checked before the INCLUDE list; someone who is on both lists will not be allowed to use the feature.

  • EXCLUDE_BORROW supersedes INCLUDE_BORROW.

  • Anyone not in an INCLUDE_BORROW statement is not allowed to borrow licenses.

Once you create an INCLUDE or EXCLUDE list, everyone else is implicitly "outside" the group. This feature allows you, as an administrator, the ability to control licenses without having to explicitly list each user that you wish to allow or deny access to. In other words, there are two approaches; you can either give most users access and list only the exceptions, or you can severely limit access and list only the those users that have access privileges.

The format for these keywords follow:

RESERVE number feature {USER | HOST | DISPLAY | PROJECT |
     GROUP | HOST_GROUP | INTERNET} name
INCLUDE feature {USER | HOST | DISPLAY | PROJECT | GROUP
      | HOST_GROUP | INTERNET} name
EXCLUDE feature {USER | HOST | DISPLAY | PROJECT | GROUP
      | HOST_GROUP | INTERNET} name
GROUP name list_of_users
INCLUDEALL {USER | HOST | DISPLAY | PROJECT | GROUP
     | HOST_GROUP | INTERNET} name
EXCLUDEALL {USER | HOST | DISPLAY | PROJECT | GROUP
     | HOST_GROUP | INTERNET} name
HOST_GROUP name host_list
BORROW_LOWWATER feature number 
EXCLUDE_BORROW feature {USER | HOST | DISPLAY | PROJECT |
     GROUP | HOST_GROUP | INTERNET} name
INCLUDE_BORROW feature {USER | HOST | DISPLAY | PROJECT |
     GROUP | HOST_GROUP | INTERNET} name
MAX_BORROW_HOURS feature num_hours

Above, number is the number of tasks; feature is the license feature name (see Product Variable Table for a list of license feature names for all ANSYS products); name is the user's login name or group; list_of_users is a blank-separated list of group member's login names; host_list is a blank-separated list of host names; and num_hours is the number of hours for which a license can be borrowed, up to the limit specified in the license file. On UNIX systems, DISPLAY requires the tty device name, and not the DISPLAY environment variable name. Also, PROJECT refers to the LM_PROJECT environment variable.

Note

You can make groups arbitrarily large by listing the GROUP more than once; FLEXlm concatenates such entries.

You can also specify feature as follows:

feature:name=value

You can specify a feature by any of the following fields, found in the license file INCREMENT lines:

VERSION HOSTID EXPDATE KEY VENDOR_STRING ISSUER NOTICE 
     dist_info user_info asset_info

If your license file has multiple INCREMENT lines of the same feature and any of these fields (such as VENDOR_STRING and VERSION) differ between the INCREMENT lines, and you are reserving licenses for this feature, FLEXlm will reserve the same number of licenses from each INCREMENT line. This can result in more licenses being reserved than expected. Specify the differing field to reserve licenses from a single INCREMENT line.

For example, the following license contains two INCREMENT lines that differ only by the version date:

INCREMENT struct ansyslmd 2007.0331 permanent 1 AA1DE4A0E7BB \
        VENDOR_STRING=customer:12345678  \
        ISSUED=01-Jan-2007 START=01-Jan-2007

INCREMENT struct ansyslmd 2007.0430 permanent 1 3D967A3ECF4E \
        VENDOR_STRING=customer:12345678 \
        ISSUED=01-Jan-2007 START=01-Jan-2007

If you create the following entry in the options file:

RESERVE 1 struct USER smith
then you will reserve two licenses, one from each INCREMENT line, for user smith.

To reserve only one license, create an entry that contains the differing information:

RESERVE 1 struct:VERSION=2001.0430 USER smith

For a complete list of license features, see Product Variable Table.

For more information on the options file, see the FLEXnet Licensing End User Guide (accessible from the ANSLIC_ADMIN utility) .

Note

The TIMEOUT and TIMEOUTALL options are not available on HP platforms for ANSYS products. ANSYS products use a TIMEOUT and TIMEOUTALL default of 55 minutes (3300 seconds). You cannot set the minimum value below 15 minutes (900 seconds). Application idle TIMEOUTs are not supported, i.e., the TIMEOUT options will not work for applications that are not actively in use.

Sample Options File

In the following example options file, one license to execute ANSYS Mechanical is reserved for user pat, three licenses for user lee, and one license for anyone on the computer with the hostname of client3. In addition, user joe is not allowed to use the ANSYS Mechanical program.

RESERVE 1 ansys USER pat
RESERVE 3 ansys USER lee
RESERVE 1 ansys HOST client3
EXCLUDE ansys USER joe

Note

In a three license server environment, the same options file must be placed on all three systems. The options specified will not take effect until the license manager has been shut down and restarted or the license file has been reread.

Other Environment Variable Settings

You can also use the following environment variables.

ANSYSLMD_LICENSE_FILE

Can be used to identify a license server or license file. If set, this specification is used before any other license path information. See License Files Settings Precedence for precedence information. The default port number assigned to ANSYS, Inc. is 1055. Therefore, if your server has the hostname alpha1 and the IP address of 10.3.1.69, you can identify the server to use as 1055@alpha1 or 1055@10.3.1.69.

LM_LICENSE_FILE

Also identifies the license server or license file. If set, this specification is used after ANSYSLMD_LICENSE_FILE setting. See License Files Settings Precedence for precedence information. Unlike ANSYSLMD_LICENSE_FILE, this environment variable is used for all FLEXlm licensed products and can be disruptive to other non-ANSYS software.

ANS_FLEXLM_DISABLE_ENV

Use this environment variable to exclude both the LM_LICENSE_FILE and ANSYSLMD_LICENSE_FILE environment variable settings from the licensing path. Set to 1 to use this environment variable. Note that use of the ANS_FLEXLM_DISABLE_DEFLICPATH environment variable overrides ANS_FLEXLM_DISABLE_ENV.

ANS_FLEXLM_DEBUG

If set, provides licensing debugging information. Possible settings are:

  • 0 or not set: Indicates that no licensing debug information should be displayed.

  • 1: Indicates that basic licensing debug information should be displayed.

  • 2: Indicates that all licensing debug information should be displayed.

You will not want to keep this environment variable set all of the time because it will generate a large quantity of information. See Getting Additional License Debug Information for more information on where the information generated by this environment variable is found.

ANS_FLEXLM_ENABLE_FLEX_DIAG

Enables the use of FLEXLM_DIAGNOSTICS for ANSYS, Inc. products. See "Troubleshooting" for more information on using this and the FLEXLM_DIAGNOSTICS environment variable.

FLEXLM_DIAGNOSTICS

Provides additional levels of debugging information. You should set this environment variable only under the direction of Macrovision or ANSYS technical support. For more information on this environment variable, see the FLEXnet Licensing End User Guide (accessible from the ANSLIC_ADMIN utility) .

ANS_FLEXLM_DISABLE_DEFLICPATH

Indicates that the default license path should not be searched when determining the licensing path in the ANSYS product:

  • Only ANSYSLMD_LICENSE_FILE environment variable setting is used.

  • Settings in the ansyslmd.ini file and the license file in the licensing directory will NOT be used.

ANS_FLEXLM_HBEAT

Identifies the number of seconds between the FLEXlm heartbeats sent to the FLEXlm server from an ANSYS product (Windows systems and UNIX systems except HP).

  • Minimum Value: 30 seconds (values between 0 and 30 are set to 30)

  • Maximum Value: 120 seconds (values above 120 are set to 120)

  • Default Value: 60 seconds

ANS_FLEXLM_LMSGS

If set to a value other than 0 (zero), this environment variable indicates that all FLEXlm messages should be returned in FLEXlm's long format rather than ANSYS, Inc.'s default short. In some cases, this may provide more information to support staff. Long messages are automatically displayed if the ANS_FLEXLM_DEBUG environment variable is set to 1 or 2 (even if the ANS_FLEXLM_LMSGS environment variable is not set).

ANS_FLEXLM_EXPWARN_DAYS

By default, you will be notified of the upcoming expiration of your lease license beginning 30 days prior to the expiration date. Use this environment variable to change the number of days to any number between 7 and 90. This environment variable has no effect on TECS expiration warning messages.

License-expiration messages do not appear when you perform operations in batch mode.

Creating the lmadmin Group

By default, root (on Unix) or administrator (Windows) has access to the options below. To allow other users to access these options, you need to create an lmadmin group on computers from which license administration will be performed. If you create an lmadmin group, you must include root in order for root to continue to have access to these functions. For more details on using an lmadmin group, see the FLEXnet Licensing End User Guide (accessible from the ANSLIC_ADMIN utility).

Those functions requiring root or lmadmin group privilege include the following. Use the utility shown in parentheses.

  • Remove a Client (lmremove or ANSLIC_ADMIN)

  • Stop the License Manager (lmdown or ANSLIC_ADMIN)

  • Reread the License File (lmreread or ANSLIC_ADMIN)

Follow the instructions below for your hardware platform to create an lmadmin group.

HP AlphaServer (Compaq), HP, SGI, Sun, Linux

Add a line to the file /etc/group as follows:

lmadmin:*:nn:root,user1,user2,user3...usern

where nn represents any unique group number and user1, user2, user3, ..., usern represent a list of n users in the group.

IBM RS/6000

Use smit to create an lmadmin group and add users to this group.

Setting Up License Queuing

The License Queuing option allows an ANSYS process to wait (queue) for an available license in the event all licenses are checked out. Activate this option by setting the environment variable ANSWAIT to one of the following values:
1 - queue everything
2 - queue only primary configured tasks (interactive or batch)
3 - queue only interactive runs (including connection functionality)
4 - queue only primary configured tasks in interactive runs

A primary configured task is required to run a product and is the very first license checked out, such as ANSYS Multiphysics, ANSYS Structural, etc. Advanced or transient tasks, such as ANSYS Mechanical HPC or the Geometry Interface products are not considered primary configured tasks.

The example here will queue licenses for all products in both interactive and batch mode:

UNIX csh (C) Shell

setenv ANSWAIT 1

UNIX ksh (Korn) or sh (Bourne) Shells

ANSWAIT=1;export ANSWAIT

On Windows systems, use the Control Panel to set the ANSWAIT environment variable.

The following message will appear in the output if your process is waiting (queued) for an available ANSYS license:

Maximum number of licenses already checked out for feature name.
Server host1: Queuing for 1 license(s) of feature name

If the ANSWAIT environment variable is not set, then the ANSYS process will terminate with the following message in the event all ANSYS licenses are checked out. This is the default condition.

Licensed number of users already reached (-4,132)

The License Queuing option may not be available on all products.

Using License Borrowing

License borrowing allows a user to take a license for use outside of the company facility, such as for an engineer to take a license home on his laptop. Before users can take advantage of license borrowing, you need to set up the borrowing environment.

License borrowing is available only on Windows machines; however, the license server machine that is managing the licenses can be any system that ANSYS, Inc. supports as a license server.

Setting up License Borrowing

To use license borrowing, you must have license keys that specify borrowable licenses.

You can use the optional BORROW options file settings to further control borrowing at your site. To use these settings, you must first specify which users are allowed to borrow licenses by adding an INCLUDE_BORROW group to the options file. Any user not in the INCLUDE_BORROW group will not be allowed to borrow licenses. You may also wish to set up an EXCLUDE_BORROW group to prevent specific users from borrowing licenses.

You can also limit the number of licenses that can be borrowed from your total pool of borrowable licenses. Set the BORROW_LOWWATER option in the options file to the number of licenses that cannot be borrowed. For example, if you have 15 licenses total and want to limit the number that can be borrowed to 5, set BORROW_LOWWATER=10.

The maximum number of hours a license can be borrowed at any one time is defined by your license file. You can set that limit lower for your users by setting the MAX_BORROW_HOURS option in the options file. MAX_BORROW_HOURS cannot exceed the limit specified in your license file. The total maximum number of borrowable hours is defined by your license agreement.

In addition, we recommend that you not use the -2 -p option, available via the Modify Startup Options selection of the ANSLIC_ADMIN utility. Doing so will prevent users from returning borrowed licenses early.

Running the License Borrowing Utility

To run the license borrowing utility, you must be running on a Windows system connected to a network, and you must have borrowable licenses. For more information about borrowable licenses, please contact your ANSYS sales representative.

Procedure 1.

  1. Launch the license borrowing utility: Start>Programs>ANSYS FLEXlm License Manager>ANSLIC_ADMIN. Select Run the ANSYS Borrow Utility.

  2. Specify the version number and return date. The return date and time defaults to the end of the third day from the current date.

    If you change any of the borrowing criteria, the product list will automatically update in five seconds. To update the list immediately, click the Update Delay (sec) button.

  3. Select the product(s) you want to borrow, including any add-on features or geometry interfaces. If you do not see a product listed that you think should be available, verify that you have selected the correct version.

  4. Click Borrow.

  5. Disconnect from the network. Note that even when you've disconnected from the network, you must still run the products from the same account you used to borrow the licenses. For example, if you use a network account to borrow the licenses, you cannot then run from a local account.

    Be sure to verify that you can run the correct product with the borrowed licenses from your machine AFTER you've disconnected from the network. If you encounter any difficulties, reconnect to the network, return the license, and then re-borrow the correct license.

If you keep a license for the full amount of time, there is no need to check the license back in. Your borrowed license will simply expire at the end of the borrow period, and the license will be released into the pool of available licenses.

To return a license early:

Procedure 2.

  1. Reconnect to the same license server from which you borrowed the license(s).

  2. Launch the license borrowing utility: Start>Programs>ANSYS FLEXlm License Manager>ANSLIC_ADMIN. Select Run the ANSYS Borrow Utility.

  3. Select the Return tab. Indicate which license(s) you are returning and click Return.

  4. Disconnect from the network.

The license(s) you borrowed will be returned to the pool of available licenses.

Note

You must return borrowed licenses from the same account you used to borrow the licenses originally.

Some multi-feature products include other products and/or add-on features. The utility will automatically check out any such included products or add-on features. If you borrow one of these multi-feature products and then click on the Return tab, you will see the product you selected, as well as any other products and add-ons that it includes. If you return a multi-feature product early, these products and add-on features will also be returned.

License Administration

This chapter explains how to use the ANSLIC_ADMIN utility to perform many of the procedures necessary to administer licenses. It also briefly discusses the LMTOOLS utility on Windows. You can use the ANSLIC_ADMIN utility to perform most licensing procedures. Some options may apply to only UNIX or only Windows systems and are so noted. For information on advanced operations, select Help > View FLEXnet Licensing End User Guide.

The following license administration topics are available:

Using the ANSLIC_ADMIN Utility

To run ANSLIC_ADMIN on Windows, choose Start>Programs>ANSYS FLEXlm License Manager>ANSLIC_ADMIN utility. To run the utility on UNIX, type the following:

/ansys_inc/shared_files/licensing/lic_admin/anslic_admin

You do not need system administrator privileges to run the ANSLIC_ADMIN utility; however, you must have system administrator privileges to run the Remove a Client License and the Uninstall the License Manager options. To use the utility, select an action from the list of buttons on the left.

The status of your machine appears on the bottom left-hand side of the screen, in the Machine Name status area. The machine can be a client (any machine with no valid license file installed is considered a client) or a license server. If a license server, the status can be running or not running. The status will update automatically when the machine's status changes. On Windows systems, if the machine is a client and you want to convert it to a server, you will need to use the installation media and install the license manager following the instructions in the ANSYS, Inc. Windows Installation Guide for your product.

The right side of the utility usually displays a log of your session activities (the session log). The reporting options will also display information in this area. Use the buttons at the bottom to clear the session log or to write the log out to a file. If you contact customer support, you will need to send them this log file.

For some items, such as Display the License Status, the right-hand window converts to a status window showing the requested information. Use the buttons underneath this status area to return to the session log, to write the status information to the session log, or to write the status information directly to a file.

The ANSLIC_ADMIN utility consists of the following options:

From the Uninstall menu (UNIX only), you can select Uninstall the License Manager.

From the Help menu, you can select:

  • View the ANSLIC_ADMIN Help

  • View the ANSYS, Inc. Licensing Guide

  • View the FLEXnet Licensing End User Guide

  • About FLEXlm

  • About ANSLIC_ADMIN

To exit the ANSLIC_ADMIN utility, choose File>Exit.

Register License Server Information

Use this option to register your license server information with ANSYS, Inc. You will be prompted to supply your customer (agreement) number (optional), company name, your name, email address, etc. This utility also obtains information about your system, such as hostname, hostid, hardware platform, operating system level, and current date. In addition, this utility requires you to identify the type of license server machine. In the case of a three-server system, you must supply the server information on each server.

The utility places the information it gathers into a file named licserver.info. By default, this file is written to the home directory; it will also create it in the licensing directory. You can browse to a directory other than the home directory. You must forward the file, created on each license server, to your ANSYS sales representative.

If you are running this utility on a Windows laptop system, you should disconnect from the docking station before running this option so that the laptop's hostid information is used and not the docking station's.

Display the License Server Hostid

Use this option to obtain and display the hostid of the system on which you are currently running. Selecting this option runs the FLEXlm utility lmhostid. To write this information out to a file, click the Create File button. By default, the file is named ansysid.machinename.txt, although you can change the filename.

Run the License Wizard

This option is used for license server machines only.

This wizard walks you through the process of installing or updating a license file, specifying the license server(s) (which updates the ansyslmd.ini file), and starting the license manager or rereading the license file. The wizard will prompt you for the necessary information at each step. You should use this option when you receive a new license file as it will walk you through the necessary steps to activate the new license.

You can perform each of these steps individually using the separate options on the ANSLIC_ADMIN utility.

Install the License File

Use this option if you received a new license. This utility creates the license file, called license.dat by default, in the licensing directory. The license file contains your licensing information and allows you to run ANSYS, Inc. products.

Procedure 1.

  1. Save the license file that you received from your ANSYS sales representative to a temporary file.

  2. Select this option from the ANSLIC_ADMIN utility.

  3. Browse to the file. If you do not already have a license file, the information from this temporary file will be used to create the license file. If you do have an existing license file, the existing file will be renamed to license.dat.old.

In a three-server setup, you must use this option on each license server.

Caution

Do not save license files in Microsoft Word format.

If the license manager is running when you add or update a license, you must restart the license manager or reread the license file for the new file to take effect.

You can use this option to install ANSYS license files only. To determine if you have an ANSYS license file, see Recognizing an ANSYS License File.

Start the License Manager

Use this option to start the license manager. The license file must exist prior to starting the license manager. The license manager must be running to run an ANSYS, Inc. product.

The file license.log in the licensing directory contains a history of licensing activity across your network since the last time the license manager was started. It also contains startup messages and possibly error messages. This option will save any existing license.log file to license.log.old prior to starting the license manager.

Note

In a three-server environment, you may see a delay in starting the license manager until two of the three servers are running. Do not press the Start the License Manager button more than once for the same server.

Stop the License Manager

Use this option to shut down the license manager. This option will shut down the license manager on all machines listed in the license file. You will be asked to confirm that the machine(s) should be shut down. Remember that the license manager must be running in order to run an ANSYS, Inc. product. Before shutting down the license manager, check that no ANSYS, Inc. product processes are currently running. Any processes that are running will be terminated when you shut down the license manager.

Caution

Do not use kill -9 (on UNIX systems) to shut down the license manager. Use the ANSLIC_ADMIN utility option or lmdown.

Note

In a three-server environment, you may see a delay in stopping the license manager. Do not press the Stop the License Manager button more than once for the same server.

Reread the License File

Use this option when the license manager is already running and you have updated the license file or the license options file. If you update the license file or the license options file, you must run this option for the changes to take effect. Otherwise, the license manager will not be aware of the changes until it is stopped and restarted.

Specify the License Server

Use this option to set the license server(s). This option lists, adds, modifies, deletes, or reorders entries in the ansyslmd.ini file with the server specification.

To add a server:

Procedure 2.

  1. Click Add Server Specification.

  2. Enter the host name(s) of your license server(s) and the TCP/IP port number. The ANSYS, Inc. default port number is 1055.

  3. Click OK.

To delete a server, highlight the server in the list and click Delete Selected Server.

To edit a server, click on one of the listed servers and click Edit Selected Server. You can then change the port number, the number of license servers, or the hostname(s).

Entries in this file tell ANSYS, Inc. products which license server(s) to query to find a valid license. Using this option allows all users at your site to use this setting without having to individually set environment variables (ANSYSLMD_LICENSE_FILE and/or LM_LICENSE_FILE) to find the license file. It also eliminates the need to have a copy of the license file on every system at your site.

Set the license server on all systems running an ANSYS, Inc. product.

The order that the SERVER lines are listed in the ansyslmd.ini file dictates the order in which the license request is granted. To reorder the entries in the list, highlight a server and use the Move up or Move down buttons.

Remove a Client License

You may need to free a license when a licensed user was running an ANSYS, Inc. product on a node that subsequently crashed. This situation will sometimes cause the license to become unusable. Free the license to allow the license to return to the pool of available licenses. Only those with FLEXlm administrative privileges (UNIX) or administrative privileges (Windows) can use this procedure because removing a user's license can be disruptive.

You will be prompted for the following information:

  • feature name

  • user name

  • host name

  • display

If you are not sure of any of the above items, run the Display the License Status option to obtain the correct information.

This option allows you to remove a client only from the license server machine on which the license is checked out.

A client must be running at least two minutes before you can remove it. If you attempt to remove a client in less than two minutes, you will get an error.

The license removal is not immediate.

Run the ANSYS Borrow Utility

This Windows-only option launches the ANSYS License Borrowing utility. From there, you can select licenses for use outside of the company facility. This feature is useful for situations such as allowing an engineer to take a license home on his laptop. This option is available only on Windows, and only if you have borrowable licenses. For more information on license borrowing, see Using License Borrowing. For more information on borrowable licenses, contact your ANSYS sales representative.

Set Site Preferences

The following site preference settings are available:

Edit the FLEXlm Options File

Use this option to edit the license options file ansyslmd.opt, which resides in the licensing directory. The license options files must match on all three systems if you are using redundant systems. The options file allows you, the license administrator, to control various operating parameters of FLEXlm. For more information on using the license options file, see Establishing User Privileges. Restart the license manager or reread the license file for changes to take effect.

Specify Product Order

This option lauches a utility that allows you to designate the order that the licensed products are listed in the launcher and in ANSYS Workbench. You will need to specify the product release, the installation directory, and the product category. You can then re-order the products by clicking the Move up or Move down buttons. When you are finished, click Save and then Close.

All products available in a given category are shown, regardless of whether you have licenses for them.

Only those logged in as root or superuser (UNIX) or administrative privileges (Windows) can use this utility.

Modify Startup Options

Use this UNIX-only option to modify your license manager startup options. License manager startup options that you can modify include the license file path and the license log file path. You can also specify the -2 -p or -local options (not recommended if you will be using license borrowing). See Modifying License Manager Startup Options for more information on modifying these license manager startup options, or see the FLEXlm End Users Guide (accessible from the ANSLIC_ADMIN utility) .

View Status/Diagnostic Options

The following reporting options are available:

When you select one of these options, the data will appear in the log area on the right side of the utility. Display the Customer Number appends the customer number to the session log itself; the other options create their own display in the log area. Each option is explained in the following sections.

Display the License Status

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

Display the Customer Number

Use this option to display your customer number (necessary when requesting customer support). The license manager must be running for you to obtain your customer number.

View the License File

This option displays the contents of your current license file in the reporting area. You can append this information to the session log or write it out to a separate file. Do not use this option to create a new license file. The Write to File option here will create a text file that includes extraneous information that is not valid in a license file, and should be used only to create a file for reference purposes.

View the License Log File

This option is available only on the license server machine(s). Use this option to view the license log file (named license.log by default).

Gather Diagnostic Information

Use this option to run the ansys_pid utility, which queries the system for information that may be useful for troubleshooting certain problems. This operation may take a few minutes. You can append this information to the session log, or you can write it out directly to a file using the buttons at the bottom of the window.

Uninstall the License Manager

Use this UNIX-only menu option to remove the entire ANSYS, Inc. license manager installation from your system. To use this option, you must be logged in as root or superuser.

You will be asked to verify that the license manager should be uninstalled from this system.

The contents of the licensing directory will be deleted. Also, if the license manager is running, it will be shut down.

On Windows systems, you can uninstall the license manager using the LMTOOLS utility. Before proceeding with the following steps, make certain that there are no ANSYS, Inc. products on this machine or any other machines on the network that rely on these ANSYS licensing components.

Skip these steps if the machine does not have the ANSYS FLEXlm License Manager installed. Perform these steps ONLY if this is a Windows system and is an ANSYS FLEXlm License Manager server machine:

  1. Use the ANSLIC_ADMIN to stop the license manager.

  2. In the ANSYS FLEXlm License Manager program folder, click on the LMTOOLS utility.

  3. Select the Configure Services tab and highlight ANSYS FLEXlm License Manager. Click on the Remove Service button.

  4. Exit the LMTOOLS utility.

On all Windows systems, follow these steps. For more information on performing any of the following tasks, please refer to your Windows system documentation.

  1. Delete the \Licensing subdirectory located under \Program Files\ANSYS Inc\Shared Files.

  2. Remove the ANSYS FLEXlm License Manager program folder from the Start menu.

  3. Remove the ANSYSLIC_DIR environment variable.

Using the LMTOOLS Utility

The LMTOOLS utility is a Windows-only license administration tool. With the LMTOOLS utility, you can start, stop, and reconfigure the license manager, get information such as hostids, get server status, and more. To run this utility, click on LMTOOLS Utility in the ANSYS FLEXlm License Manager program folder. For more information on the options available, please refer to the online help provided with the LMTOOLS utility.

Note

Do not change the license file or the license log file path via the LMTOOLS utility on 64-bit Windows system. Doing so will result in unexpected licensing behavior.

The LMTOOLS license administration utility is not available for Windows XP x64 Edition. For most LMTOOLS functionality, use the ANSLIC_ADMIN utility. However, you cannot remove the license manager via the ANSLIC_ADMIN utility. To uninstall the license manager on a Windows XP x64 Edition system, run the uninstall_lic_man.bat utility (found in the licensing directory after a license manager installation has been completed).

Troubleshooting

This chapter lists problems and error messages that you may encounter while setting up licensing. After each situation description or error message is the user action required to correct the problem.

For more troubleshooting information, see the FLEXnet Licensing End User Guide (accessible from the ANSLIC_ADMIN utility) .

The following troubleshooting topics are available:

Getting Additional License Debug Information

Use the following suggestions to display or generate additional error messages and debugging information.

  • Set the ANS_FLEXLM_DEBUG environment variable to display debugging information. You can choose from two levels of detail: 1: basic licensing debugging information is displayed and 2: All licensing debugging information is displayed. The default is to show no licensing debugging information. You will not want to keep this environment variable set all the time because it will generate a large quantity of information.

    If a licdebug file already exists and is dated today, the information is appended. If it is dated before today, the existing file will be renamed with a .old extension and a new file will be started.

    The licdebug file resides in the directory specified by the TEMP environment variable (Windows) or in the $HOME directory (UNIX). The licdebug filename will vary depending on the product:

    • ANSYS: licdebug.ans.110.out

    • ANSYS Workbench: licdebug.wb.110.out

    • ANSYS LS-DYNA: licdebug.dyna.110.out

    • Connection functionality: licdebug.anscon.110.out

    • ANSYS CFX: licdebug.cfx.110.out

    • ANSYS ICEM (includes AI*Environment): licdebug.icem.110.out

    • ANSYS Thermal applications: licdebug.hti.110.out

    • ANSYS CADOE applications: licdebug.cadoe.110.out

    • ANSYS DesignModeler: licdebug.dm.110.out

    • ANSYS Part Manager (used for ANSYS Workbench Geometry Interfaces): licdebug.pm.110.out

    • ANSYS borrow utility: licdebug.ab.110.out

    The directory specified by the TEMP environment variable may be hidden on your system. To view the directory and file, click on My Computer. Choose Tools from the menu, and then click on Folder options. Click on the View tab and select Show hidden files and folders. Click OK.

  • Set the ANS_FLEXLM_LMSGS environment variable to control whether error messages appear in long or short format. By default, when the ANS_FLEXLM_DEBUG environment variable is NOT set, ANSYS, Inc. displays error messages in short format. Set this environment variable to a value other than 0 (zero) to display the long format. Long messages are automatically displayed when the ANS_FLEXLM_DEBUG environment variable is set, even if ANS_FLEXLM_LMSGS is not set.

  • Set the ANS_FLEXLM_ENABLE_FLEX_DIAG environment variable to 1 to enable the use of FLEXLM_DIAGNOSTICS for ANSYS, Inc. products.

  • Set the FLEXLM_DIAGNOSTICS environment variable to a value of 1, 2, or 3, where 3 provides the most debugging information. You should set this environment variable only under the direction of Macrovision's technical support. For more information on this environment variable, see the FLEXnet Licensing End User Guide (accessible from the ANSLIC_ADMIN utility) .

If after following these suggestions, the resulting debug information does not make sense, try these suggestions:

  • Confirm that the license manager was restarted or the license file was reread after any changes were made to the license file. If the user did not make any changes to the license file for the server, check the date/time that it was last changed. Get the relevant path information from the debug output. Also, confirm that the same path is being used.

  • Try restarting the license manager and then attempt to run again. See if the same situation occurs.

  • If the user put a license key in a license file but is not seeing it even after restarting the license manager, confirm that the correct license file is being used to start the daemon/service. In this case, neither the client application nor the daemon/service is using the changed file.

  • If the license.dat file is at the end of the path and it is a license file that uses the license manager daemon/service, then confirm that the license manager is started with the same path as the license.dat file's path. The license manager could be looking at one file in the client application but the license manager daemon/service was started with another file.

Using the ansys_pid Utility

You can use the Gather Diagnostic Information option of the ANSLIC_ADMIN utility to query the system for various pieces of information that may be needed for troubleshooting certain problems. The underlying utility, ansys_pid, collects information about the system as well as about ANSYS licenses.

ansys_pid sends all of the information that it collects to the log area. At times it may be necessary to provide the information for technical support. Use the Write to File button at the bottom of the ANSLIC_ADMIN to write a file. Then forward the file to the appropriate person.

Problem Situations

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

License Manager Will Not Start

If the license manager will not start, perform the tests that are listed below. Perform the tests in the order that they are listed.

  1. Check the license.log file in the licensing directory on the license server for errors. See the remainder of this chapter for a list of possible errors and their resolutions.

  2. Verify that TCP/IP is installed and configured correctly. Verify that the IP address is static. See Communications Requirements for information about configuring TCP/IP.

  3. Verify that the hostid has not changed. If the hostid has changed, you must obtain a new license.

Windows Pentium III Systems. The version of FLEXlm used at ANSYS Release 11.0 no longer supports using a CPU ID as the hostid. As a result, if you are using a Windows Pentium III system as a license server, you will need to obtain a new license file to be able to run this release. To obtain your new license, run the Register License Server Information option on the ANSLIC_ADMIN utility on the system you have designated as your license server. Send the resulting file LICSERVER.INFO to your ANSYS sales representative. We will then supply you with a new license file.

Three-Server Environment. In a three-server environment, you could also see the following message when you start the first of the three servers:

***Attempting to start the license manager...

Start the License Manager status:

The license manager failed to start.

You may examine the license log file for more information or possible errors (by clicking the 'View Status/Diagnostic Options' button). Additionally, you can reference the Troubleshooting section in the ANSYS Licensing Guide for more details.

NOTE: The currently-installed license file is a three-server license file. With three-server license files, the license manager will not fully start until at least two of the three license servers are running.

This message results when a quorum of servers (2 of the 3) are not yet started. Start the other servers, or verify that they are already started. When at least two of the three servers are started, you will see the status window of this server change to reflect that it is now running. Do NOT attempt to stop the license manager by pressing the Stop the License Manager button.

If you verify that at least two servers are started and you still see this message, and the status window does not update to running in a reasonable time, follow the three steps noted above in License Manager Will Not Start.

Caution

When you see this message, do NOT press the Start the License Manager button again. Doing so will cause another copy of the lmgrd license manager daemon/service to start without the corresponding ansyslmd vendor daemon/service and will require you to carefully remove the extra ANSYS lmgrd manually.

License Manager Will Not Stop in a Three-Server Environment

When you attempt to stop the license manager in a three-server environment, the license manager does not stop immediately. You will see a message stating that the currently-installed license file is a three-server license file. With three-server license files, the license manager could take 60 seconds or longer to successfully stop. Wait at least 60 seconds. When the license manager has successfully stopped, the status window will show that it is stopped.

Log File Shows Unexpected Messages When the License Manager Is Stopped

On Windows systems, you may see unexpected error messages in the licensing log file when you shut down the license manager via Services or via the ANSLIC_ADMIN utility. Messages similar to the following could appear:

13:47:49 (lmgrd) Shutting down ansyslmd pid=1860 because of signal 15

13:47:49 (lmgrd) Can't connect to the license server system. Shutdown ansyslmd failed.

13:47:49 ((lmgrd)) 13:47:49 Loop info:(lmgrd) Cannot read data from license server system. (-16,10009:10054 "WinSock: Connection reset by peer")

MT:0 VD_HB:5913:47:49 (lmgrd) reset:0Can't shutdown the license server system. Shutdown ansyslmd failed. clients:013:47:49 (lmgrd) fd's:0EXITING DUE TO SIGNAL 15

13:47:49 (lmgrd) ansyslmd exited with status 58 ()

13:47:49 (lmgrd) Since this is an unknown status, license server

13:47:49 (lmgrd) manager (lmgrd) will attempt to re-start the vendor daemon.

13:47:49 (lmgrd) EXITING DUE TO SIGNAL 1

13:47:49 (lmgrd) Can't remove statfile C:\Documents and Settings\All Users\Application Data\Macrovision\FLEXlm\lmgrd.620: errno No such file or directory

These or similar messages in the log file can be safely ignored in most cases. You can verify that the service is shown as stopped, and that the two lmgrd processes and the ansyslmd process are stopped via Task Manager.

Unable to Check Out Licenses

If the license manager appears to start but you cannot check out any licenses, perform the tests that are listed below. Perform the tests in the order that they are listed.

  1. Verify that the license.log file exists in the licensing directory on the license server machine(s). Note that license.log in the licensing directory is the default location of this file. To see whether the file's location has been changed, choose Modify Startup Options on the ANSLIC_ADMIN utility on UNIX. On Windows, run the LMTOOLS utility in the ANSYS FLEXlm License Manager folder and choose the Configure Services tab. Check the name in the "License log file" field. If the license.log file does not exist or has zero length, verify the write permissions on the directory and file.

  2. On the license server machine(s), review the license.log file for error messages. See the remainder of this chapter for a list of possible errors and their resolutions.

Jobs Abort When License Manager Goes Down in Three-Server Environment

If you are running in a three-server environment and ANSYS program jobs abort when one of the license managers goes down, perform the tests that are listed below. Perform the tests in the order that they are listed.

Note

If this problem persists after you perform the steps below, you may want to consider switching to a single-server environment.

Note

When using a three-server environment, we strongly recommend that all three servers be on the same subnet. If this is not the case, you should consider using three machines which are in the same physical location and are on the same subnet.

  1. Verify that two of the three license managers are still running. Use the ANSLIC_ADMIN utility (Display the License Status). If the license manager is not already running on all servers, start it on all of them.

  2. Check the ansyslmd.ini file in the licensing directory to make sure the server specification is correct.

  3. Check to see whether the ANSYSLMD_LICENSE_FILE or LM_LICENSE_FILE environment variable is set. If it is, verify that the settings are correct.

  4. Verify that the same license file exists on all three license servers in the licensing directory. The hostnames of all three servers must appear in these files and in the same order. If the license files are not the same on all three servers, make corrections as necessary and restart the license manager.

  5. Verify that the date and time on all license servers are consistent and correct. Make corrections as necessary and restart the license manager.

  6. Verify that the hostid has not changed on any of the license servers. If any hostid has changed, you need to obtain and install new licenses on all license servers.

  7. Verify that the license manager and utilities are installed locally on each license server. If not, run the installation from the product CD and choose to install the license server only. See the installation manual for your product and platform for more information.

  8. Verify that the ansyslmd.opt files match exactly on all three license servers.

  9. Check the license.log file for error messages. See the remainder of this chapter for a list of possible errors and their resolutions.

Ethernet Address Shows All Zeroes

On Windows 2000 systems only, if the ethernet address shows 12 zeroes when you view it (using the LMTOOLS utility in the ANSYS FLEXlm License Manager folder on Windows), the network cable has been removed. To correct, re-connect the network cable.

Licensing Log File Not Created

On Windows, if the license manager starts and licenses can be taken from the license server, but the licensing log file is not written, check the Administrator account. Verify that the Administrator (as well as the individual user) has write privileges to the directory where the log file is to be written.

Queuing Does Not Work

If queuing does not work, refer to the following list of possible causes and corrections:

  • The license manager is down. In this case, use ANSLIC_ADMIN to start the license manager.

  • The hostname is mistyped in the ansyslmd.ini file or the ANSYSLMD_LICENSE_FILE or LM_LICENSE_FILE environment variables. If so, correct the name and retry.

  • You are not licensed for the requested feature. In this case, request a product for which you are licensed.

  • All licenses for the requested feature are reserved in the license options file. If so, have the license administrator correct the license options file.

  • The user is excluded via the license options file from using the licenses for the feature(s) that are installed on this machine.

  • The License Queuing option may not be available on all products.

The FLEXlm Utility lmcksum May Give Misleading Information

The FLEXlm utility lmcksum may give misleading information. Do not rely on its results to verify the accuracy of your license file.

The Launcher is Excessively Slow to Start

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

Launcher is Not Using ANSYS110_PRODUCT Environment Variable Correctly

If the ANSYS Product Launcher does not use the product specified by the ANSYS110_PRODUCT environment variable the first time that the launcher is run, you may need to clear your profiles and settings. In the launcher, choose Options >Delete All Settings/Profiles. This option will remove any profiles you have saved for this release, and revert back to using the ANSYS110_PRODUCT setting. Please see the discussion on Launcher Menu Options in the Operations Guide for more details on using the Delete All Settings/Profiles option before choosing this option.

Remove a Client Option Does Not Work

Due to FLEXlm limitations, the Remove a Client option may not work correctly for products running in the Workbench environment. If it does not, you will need to shut down and restart the license server in order to remove a client.

Licensing Installation Process Error Messages

Attempting to shutdown the ANSYS FLEXlm license manager ... Cannot find license utilities in <dir>. Please enter the directory where the ANSYS files currently reside.

If you see the above message, the installation procedure cannot find the valid utilities to stop the license manager. You should exit the installation, stop the license manager (via the ANSLIC_ADMIN utility), and then rerun the install. This is most likely a problem if the system has changed ANSYS platform names or if the shared_files directory was removed without shutting down the license manager.

If the ANSLIC_ADMIN utility is not available to shutdown the license manager, you may have uninstalled ANSYS, inadvertently leaving an ansyslmd and an lmgrd process running on the system. These processes will be stopped when you reboot your system. You can also stop these processes manually, but use extreme caution, because other products that use the FLEXlm license manager will also have lmgrd processes running. If you do want to stop an lmgrd process, use the ps command to find the ANSYS lmgrd process. Do not use kill -9 (on UNIX systems) to shut down the license manager. If you must use kill, omit the -9 option.

***Licensing files currently installed for <platform> are more recent than those on the installation media. The <platform> files will not be installed and will be deselected.

You will get this message if you install an earlier version of the product after a later version. The latest version of the license manager should always be run. If you feel the date was calculated incorrectly and want to install anyway, rerun the license manager installation using the -nodatecheck command argument. Use caution when using this option, however, because installing an older version of the files can prevent your product licensing from working correctly.

Licensing-Related Launcher Error Messages

Some messages that you see from the launcher are related to product licensing. These messages follow. For additional launcher error messages, see the Troubleshooting section of the ANSYS, Inc. Installation Guide for your platform.

***Unable to retrieve any valid licenses for <simulation environment.> Please see the ANSYS, Inc. Licensing Guide's Troubleshooting section for more information.

***Required <Product> license was not found. Therefore, simulation environment simulation environment will not be available.

***Could not initialize FLEXlm licensing.

***Error: No license path found.

***No licensed products found.

***No products available for this simulation environment.

***Unable to load profile <name> because license <product> is not available. However, simulation environment <simulation environment> was selected.

***License list unavailable. [ANSYS Workbench Products Only]

If you see any of the above messages (or any similar licensing error messages), the launcher has encountered an error while trying to find or retrieve a license. Possible causes are the license manager is not running, no licenses were found, or the existing licenses have expired. Also check the license manager log file in the licensing directory. If any of these messages appear, perform the tests that are listed below in the order presented:

  1. Use the ANSLIC_ADMIN utility to verify that the license manager is running. Choose Display the License Status. If you are running in a three-server environment, verify that two of the three servers are running.

  2. Verify that the license manager is running. If the license manager is not running, start it on the license server machine(s). Check the license.log file on each license server for errors.

  3. Run ANSYS from a command prompt to check for additional error messages. (Use the -p command modifier to specify the correct product name. See Product Variable Table for details.)

    Example (Windows):

    "C:\Program Files\Ansys Inc\V110\ANSYS\bin\intel\ansys110" -p ane3

    Check the ANSYS Output window for error messages and additional information about the failure.

  4. Use the ping command to test communication between the client machine and the license server.

    If the ping command does not work, modify the hosts file or the DNS server to contain the correct host names and IP addresses. Verify that the license server and the client machines have unique IP addresses.

  5. Verify that the ansyslmd.ini file exists in the licensing directory and that it contains the correct hostname of the license server. If this file does not exist, see Designating Server(s) for License Check-out of the ANSYS, Inc. Licensing Guide to specify the license server. If the ANSYSLMD_LICENSE_FILE or LM_LICENSE_FILE variable is used to specify the license server, verify that the hostname of the license server is correct.

  6. Verify that the port number used on the license server and the client machine match.

  7. Verify that the correct version of the license manager daemons (lmgrd and ansyslmd) is being used. The current version is FLEXlm 10.8.0.7.

***Unable to load profile <name> because simulation environment <simulation environment> is not available.

If you see this message, the simulation environment specified in the named profile was uninstalled since the profile was created. You will need to specify a new simulation environment and re-specify any launcher settings to continue. To avoid seeing this message in subsequent launcher sessions, update and resave the profile, or re-install the desired simulation environment.

Licensing Error Messages

*** Licensed number of users already reached.

You may have reached the number of ANSYS product tasks that you have licensed. Wait until a task has been freed up and try again. If this error occurs on a regular basis, you may want to talk to your ANSYS sales representative about obtaining additional licenses.

This error may also occur when licenses have been reserved for certain users, or when certain users have been excluded from licenses via the license options file.

*** All licenses are reserved for others.

This error may occur if you have multiple INCREMENT lines for the same feature in the license file, and there are differing fields on each INCREMENT line (such as VENDOR_STRING and the version field), and licenses have been reserved for this feature. In this situation, the number of reserved licenses is reserved out of each INCREMENT, rather than the sum total of both.

*** Cannot connect to license server.

or

***Unable to connect to FLEXlm license server

The license manager is currently not running. Use the ANSLIC_ADMIN utility to start the license manager. Your license must exist on the license server prior to starting the license manager.

If you install the license manager and a license file, and it appears that the server is running, but you cannot connect to your license server, try rebooting.

If you think the license manager should already be running, check the license log file for errors.

Some other possible causes for this error include:

  • The wrong hostname is in the license file (machine ID is correct in the file and when the license keys were generated). The license manager could not be started.

  • The wrong license file is on the system (both hostname and machine ID are incorrect and the license keys were created with the wrong ID). The license manager could not be started.

  • The wrong license file is on the system AND the user changed the server line to have the machine's hostid but not the hostname. The license manager could not be started.

  • An incorrect port number was used on the SERVER line(s) in the ansyslmd.ini file or in the setting of the licensing path environment variables (ANSYSLMD_LICENSE_FILE or LM_LICENSE_FILE)

  • All of the installed license files have expired.

*** Feature removed during lmreread, or wrong SERVER line hostid

Some possible causes of this message include:

  • There is a typographical error in the license file's SERVER line. Typically, the machine ID was mistyped when manually entering the license file on a machine.

  • The user tried to install another machine's license file on a machine and changed the SERVER line in the file to have this machine's hostname but not the machine ID.

  • A laptop with a docking station (with an Ethernet card in it) is removed from the docking station and the license file was made using this card's Ethernet address.

  • The feature was removed during lmreread but the client is reading an old copy of the license file that still contains the removed feature.

*** Clock difference too large between client and server.

This message will appear if the date on the client machine has changed. The date should never be set ahead or behind the actual date.

*** License server does not support this feature.

This message can be generated if the feature has expired (on the server), or has not yet started, or the version is greater than the highest supported version, or the license file has been edited while the license server is running and the license file is not reread. Additional causes for this message include:

  • If the user is trying to install another machine's license file on a machine AND changes both the hostname and the machine ID information on the SERVER line to be this machine's information. The INCREMENT lines contained in the license file are still invalid for this machine.

  • If new information for the requested feature was added to the license file but neither an lmreread was issued nor was the license manager restarted.

  • If a laptop with a docking station (with an Ethernet card in it) is removed from the docking station, and the license was made using this card's Ethernet address, AND the user edited the SERVER line, replacing the Ethernet address with the disk signature of the machine (in an attempt to fix the problem). Such an attempt will not succeed because the INCREMENT lines were created using the docking station's Ethernet address, which in this situation can no longer be seen on this machine.

  • If one or more INCREMENT lines that were made for machine A were installed in machine B's license file and those features were trying to be checked out from machine B.

*** Feature has expired.

Your license has expired; please contact your ANSYS sales representative for a renewal.

*** No such feature exists.

A license does not exist for the requested product. Verify that the ANSYSLMD_LICENSE_FILE and the LM_LICENSE_FILE environment variables and the ansyslmd.ini file are pointing to the correct license server.

Verify that you are running the correct product. Use the ANSYS110_PRODUCT environment variable (for ANSYS), the -p command line option, or the Product selection box from the launcher to select the product that you are licensed to run. If you are not licensed to run this product, contact your ANSYS sales representative to obtain a license. If you are licensed to run this product, install the license from the license supplied by ANSYS, Inc. or your ANSYS sales representative using the ANSLIC_ADMIN utility. If you have already created the license, use ANSLIC_ADMIN to reread the license file.

You could also see this message if you are trying to use a license manager daemon from a previous release. The license manager daemons (lmgrd and ansyslmd) at this release are FLEXlm 10.8.0.7.

*** License file does not support this version.

The build date in the program is newer than the version in the license file. You may not be authorized to run a new release or you may not have installed your new license. If this is the case, install the license using the ANSLIC_ADMIN utility. If you have installed the new license, use ANSLIC_ADMIN to reread the license file. To view the build date in ANSYS, use the -v command line option.

*** Invalid (inconsistent) license key

The license manager daemons for this release are FLEXlm 10.8.0.7 (lmgrd and ansyslmd). Verify that you are not using the license manager daemons supplied with a previous release.

*** Local checkout filter rejected request.

Set the ANS_FLEXLM_DEBUG environment variable to 2 to find the specific cause of this message.

*** Cannot find server hostname in network database.

This message will appear if one or more of the SERVER computer names do not appear in the client computer's /etc/hosts file (UNIX) or the services file (Windows).

On SGI systems, if running under NIS, see the resolver man page for more information.

*** The License Manager is currently running and failed to shutdown. There may be some remaining processes that need to be killed manually.

If you attempt to uninstall the license manager without first successfully shutting it down, you may inadvertently leave an ansyslmd and an lmgrd process running on your system. These processes will be stopped when you reboot your system. You can stop these processes manually, but use extreme caution, because other products that use the FLEXlm license manager will also have lmgrd processes running. If you do want to stop an lmgrd process, use the ps command to find the ANSYS lmgrd process.

***The ANSYS license manager server is down. Unless a connection is reestablished, ANSYS will exit in nn minutes.

This message occurs in a one-server license environment if your license manager has quit running. In a three-license server environment, the ANSYS license manager must be running on at least two of the three license server machines at all times. If two of the license server machines go down, or two of the machines are not running the license manager, this error message will appear in the program output or in a message box. The program will continue to run for nn minutes to allow the license manager to be restarted or to be started on a second machine if using redundant servers. When this error message appears, start the license manager on the other machines designated as license servers.

If you get this message and determine that the license manager is still running, and you are running in a one-server environment, then the IP address of the license server machine was changed while the ANSYS product was running (this is usually caused by connecting to or disconnecting from an Internet Service Provider (ISP) that dynamically allocates IP addresses). To correct this situation, you must return the IP address to the same address that the license server had when the ANSYS product was started.

If the IP address changes after you start the ANSYS product (either because you connected to or disconnected from your ISP), you can correct the error by restarting the ANSYS product. You should not need to restart the license manager.

You can avoid this problem by remaining connected to or disconnected from the ISP the entire time you are running the application.

***FLEXlm version of vendor daemon is too old.

The license manager daemons at this release are FLEXlm 10.8.0.7 (lmgrd and ansyslmd). Verify that you are not using the license manager daemons supplied with a previous release.

***Cannot read data from license server.

The server and the client are having difficulties communicating. This error is usually caused by the network setup or by the network data being different from the data in the license file (for example, the server name, machine ID, port number, or vendor daemon).

  • Confirm that the information on the SERVER line of the license file is the correct information for the server.

  • Confirm that the syntax of the SERVER and VENDOR lines of the license file is correct.

  • Verify that TCP/IP is enabled correctly.

  • Check that the hosts file on the client machine contains the license server.

  • Try using <port>@<host> when specifying the server.

ANSYS License Borrowing Errors

***Unable to return <Product>, encountered “feature not found” attempting to return license feature <Product.>

or the following will appear in the log file:

UNAUTHORIZED lmremove request from <user> at node <host>.

If you see the above message when attempting to return a borrowed license before the expiration date, the -2 -p license manager startup option was set. Unset the option. See Modifying License Manager Startup Options for more information on using the license manager startup options.

ANSYS License Log File Errors

***Not a valid server hostname, exiting. Valid server hosts are: xxx

The hostname in the SERVER line of the license file does not match the hostname of the system. In this case, change the hostname in the license file. Other possible causes include:

  • The license file was put on a machine other than the one for which it was created; therefore, the hostname is not correct.

  • The hostname of the license server changed. Change the hostname on the SERVER line of the license file to correct this problem. REMEMBER to send ANSYS the new hostname so that future license files are made with the correct hostname.

  • The license file was put on a machine other than the one for which it was created AND the user changed the machine's ID on the SERVER line but did not change the hostname. If the machine ID is also wrong, you will also see a message about the wrong hostid on SERVER line after correcting the hostname.

  • The wrong hostname was used to create the license file. As long as the correct machine ID was used, you should be able to change the hostname on the SERVER line of the license file to fix this problem. REMEMBER to send ANSYS the correct hostname so that future license files are made with the correct hostname.

***Invalid license key (inconsistent authentication code)

The INCREMENT lines in the license file are not valid for this system (HostID mismatch). This error will also occur if the license file was typed incorrectly. Additional causes for this message include:

  • If a license file created for machine A is being installed on machine B AND the user changed the hostname and the machine ID to machine B's in the SERVER line.

  • If INCREMENT lines created for machine A are appended to an existing license.dat file on machine B.

  • If a laptop with a docking station (with an Ethernet card in it) is removed from the docking station, and the license was made using this card's Ethernet address, AND the user edited the SERVER line, replacing the Ethernet address with the disk signature of the machine (in an attempt to fix the problem). Such an attempt will not succeed because the INCREMENT lines were created using the docking station's Ethernet address, which in this situation can no longer be seen on this machine.

  • In a three-server license environment, if the license file was created using an incorrect hostid for one of the license servers, this message will appear and will prohibit an ANSYS product from running on any machine. Verify that the hostid in the license file matches the hostid on all three license servers. If it does not, the license file must be created using the correct hostid for all license server machines.

***Wrong HostID on SERVER line for license file: <path to license file>

License file is not valid for this machine. Possible causes include:

  • There is a typographical error. If the license file was entered manually, the machine ID may have been incorrectly typed in the SERVER line.

  • The user installed a license file created for machine A on machine B and changed the hostname in the SERVER line but did not change the machine ID.

  • The hostid changed on a machine but the hostname stayed the same.

  • A laptop with a docking station (with an Ethernet card in it) is removed from the docking station, and the license file was made using this card's Ethernet address.

  • A license file was made for a Pentium III CPU ID and the hyphen was not put after the first four characters of the ID (e.g., ABCDEF01 was entered as the ID rather than ABCD-EF01). Ethernet address would be expected.

  • A license file was made using the Windows disk signature but the keyword 'DISK_SERIAL_NUM=' was not put before the ID. Ethernet address would be expected.

*** “XXX” : Not a valid server hostname, exiting. Valid server hosts are: “YYY”.

The hostname listed in the license.dat (YYY) file does not match the hostname of the system (XXX).

Glossary

ANSLIC_ADMIN

A utility that centralizes the various ANSYS product licensing administrative functions. Tasks include, but are not limited to:

  • starting and stopping the license manager

  • installing licenses

  • displaying license status

ANSWAIT

An environment variable that will allow you to queue your ANSYS job in the event that all ANSYS licenses are in use. Once a license becomes available and you are next on the queue, your ANSYS job will automatically start.

This option is not available for some products.

ANSYSLMD_LICENSE_FILE

An environment variable that may be used to specify the license server from which you want to check out a license.

ansyslmd

This is the ANSYS, Inc. vendor daemon used to process ANSYS product licensing requests, including issuing and returning licenses. The vendor daemon is started by the license manager daemon (lmgrd) and must be running to perform the aforementioned tasks.

ansyslmd.ini

File that resides in the licensing directory. It is created by ANSLIC_ADMIN utility options Specify the license server (UNIX and Windows) and Modify license manager startup options (UNIX only).

ASD

ANSYS Support Distributor.

build date

The build date is the year, month, and date the ANSYS product was built. The version field in the license file specifies the latest build date that can be run using that license. It may also appear as 9999.9999 if a maintenance agreement is not applicable.

backup server

In a three-server network, the two servers not chosen to be the master are the backup servers. If the master server goes down, the backup server listed next in the license file automatically assumes the role of master. (A backup server is also known as a shadow server.)

borrowable license

A borrowable license is a license that you can use temporarily outside of the company facility (such as at home on a laptop). A special license key is required before any license can be borrowed.

client

A client is a machine that requests licenses but is not a license server (i.e., does not have licenses installed on it).

daemon

A process that typically runs in the background. In the case of ANSYS licensing, the license manager daemon (lmgrd) and the vendor daemon (ansyslmd) are used to process client requests, including issuing and returning licenses. Windows systems refer to this process as a service.

feature

The word feature, when used in the descriptions of the licensing utilities, refers to the ANSYS product. See Product Variable Table for the list of ANSYS products and their corresponding license features.

FLEXlm

License manager used for all ANSYS products. Also called FLEXnet License Manager.

floating license

Anyone on the network can run a licensed ANSYS product, up to the limit specified in the license file. Floating licenses require the license manager daemon (lmgrd) and the vendor daemon (ansyslmd) to be running to count the concurrent usage of the licenses.

getcn

Getcn is a utility that will display your customer number, which is contained in your license. Getcn may be run from the ANSLIC_ADMIN utility by choosing Display customer number.

IA-32

IA-32 refers to the Intel architecture, 32-bit processor.

IA-64

IA-64 refers to the Intel architecture, 64-bit processor.

license

See license task.

license borrowing

License borrowing allows a user to take a license for use outside of the company facility, such as for an engineer to take a license home on his laptop.

license file

A file generated by the Run License Wizard or the Install/update the license options of the ANSLIC_ADMIN utility or during the installation process. Each licensed product will have an entry in the license file, license.dat, which will reside in the licensing directory. Proper installation of a license file grants access to ANSYS products.

license key

The actual full license for the product.

license log file

A file containing information relevant to licensing activity. This file provides a way of tracking licensing problems that may occur. The licensing log file, license.log, is located in the licensing directory by default.

license manager

Software used for licensing ANSYS, Inc. products. ANSYS uses the FLEXlm software.

license manager daemon

A program generally run in the background that is used to process client requests, including issuing and returning licenses. The license manager daemon (lmgrd) starts the vendor daemon (ansyslmd) and is typically started when the system is booted and must be running to perform the aforementioned tasks. Windows systems refer to this process as a service.

license options file

A file containing license manager-related resource information. This file is created on license server systems, by the ANSLIC_ADMIN utility. By default, the file is named ansyslmd.opt and resides in the licensing directory. You may specify the following information in the resource file:

  • Licenses that are reserved for individuals, groups, or machines

  • Those individuals, groups, or machines that are denied access to licenses

license server

A license server is a system that you have designated to be the administrator of ANSYS product licenses; the licenses are installed on the server machine(s). One or three systems can be used to administer any particular set of ANSYS product licenses.

license task

Each concurrent use of an ANSYS product is a license task. Each use of an ANSYS product will take a number of license tasks from the total number available.

licensing directory

The default location for the licensing files. On Unix systems, the licensing directory is /ansys_inc/shared_files/licensing. On Windows systems, the licensing directory is \Program Files\Ansys Inc\Shared Files\Licensing, located in the same drive as the operating system. The licensing directory cannot be changed from the default directory on Windows systems.

lmadmin

A group of users that you designate to have the ability to perform license administrative tasks that are considered disruptive.

lmgrd

A program generally run in the background that is used to process ANSYS product licensing requests, including issuing and returning licenses. The license manager daemon starts the vendor daemon (ansyslmd) and is typically started when the system is booted and must be running to perform the aforementioned tasks. The license manager daemon is lmgrd.

lmtools

LMTOOLS is a Windows-only utility that will perform various license administrator functions, such as listing the users of licensed products. See the LMTOOLS help for more information on using this utility.

lmutil

Lmutil is a utility that will perform various license administrator functions including: rereading the license file, shutting down the license manager, starting the license manager, and listing the users of licensed products. lmutil is the underlying process in several of the ANSLIC_ADMIN options.

log file

See license log file.

master server

In a three-server network, one of the servers must be the master server. The server listed first in the license file automatically assumes the role of master. The other two license servers are shadow servers (or backup servers). In a one-server network, that server is automatically the master.

options file

See license options file.

path

When used in the context of a license file path, the list of places that are searched in order to locate a valid license file. The path is built from values in the ANSYSLMD_LICENSE_FILE and LM_LICENSE_FILE environment variables, settings in the ansyslmd.ini file, or an actual license file.

port number

Communication channel by which the license manager communicates with the client. The ANSYS default port number is 1055.

product variable

Each ANSYS product has been assigned a specific product variable value. Use this product variable value when starting a job to specify which ANSYS product is to be run. The product variable may be set by using the -p command line option, the ANSYS110_PRODUCT environment variable (for ANSYS), or the launcher. See Product Variable Table for a list of ANSYS products and their associated product variables/feature names.

quorum

You may designate either one or three systems to be license servers. In a three server network, license manager daemons must be running on the majority (2) of the servers before requests for licenses will be processed.

redundant servers

Having multiple systems designated as license servers for an ANSYS product. Redundancy can be achieved either by having three license servers working together in tandem, whereby two of the three must be running at all times, serving from a single set of licenses, or by having any number of license servers running independently, each serving from different license files.

server

See license server.

session log

In the ANSLIC_ADMIN utility, all licensing activity is written to an area on the right-hand side of the utility, called the session log area. The session log maintains a running tabulation of all activity (starting or stopping the license manager, rereading the license file, errors, etc.). The session log can also be written to a file that can be used for troubleshooting.

service

A process on a Windows machine that typically runs in the background. UNIX systems refer to this process as a daemon. In the case of ANSYS licensing, the license manager daemon (lmgrd) and the vendor daemon (ansyslmd) are services used to process client requests, including issuing and returning licenses.

shadow server

In a three-server network, the two servers not chosen to be the master are the shadow servers. If the master server goes down, the shadow server listed next in the license file automatically assumes the role of master. (A shadow server is also known as a backup server.)

task

See license task.

vendor daemon

The ANSYS vendor daemon is ansyslmd. It is used to process ANSYS licensing requests, including issuing and returning licenses. The vendor daemon is started by the license manager daemon (lmgrd).