To run ANSLIC_ADMIN on Windows, choose (for the server version). To run the utility on Linux, type the following:
/ansys_inc/shared_files/licensing/lic_admin/anslic_admin
To change the language to a localized version of the utility, first issue the
following command with the -setliclang option. On Windows, run:
"<os drive>\Program Files\ANSYS Inc\Shared Files\Licensing\licadmin\anslic_admin.bat"
-setliclang languageOn Linux, run:
/ansys_inc/shared_files/licensing/lic_admin/anslic_admin -setliclang languageThis command changes the language used for both the server ANSLIC_ADMIN utility and the Ansys Licensing Interconnect log file.
Use the language directory name in the language subdirectory of the licensing directory
(en-us, fr, de, etc.)
as the language value. This option is valid only with the
server ANSLIC_ADMIN. Then launch the ANSLIC_ADMIN utility using the above methods.
Important: Changing the language will affect all users of the server ANSLIC_ADMIN utility and the Ansys Licensing Interconnect. Verify with your licensing system administrator before making this change.
To change the language setting locally for only the current session of the server
ANSLIC_ADMIN utility, you can launch the utility
using the -lang option:
<os drive>:\Program Files\ANSYS Inc\Shared Files\Licensing\licadmin\anslic_admin
-lang languageor
/ansys_inc/shared_files/licensing/lic_admin/anslic_admin -lang languageWindows 10 Administrator Privileges — On Windows 10 machines, you need to always run these ANSLIC_ADMIN options as an administrator. Additionally, you should right-mouse click the ANSLIC_ADMIN selection from the Start menu and choose .
See the User Account Control (UAC) section of the Ansys, Inc. Windows Installation Guide for more details on working with Windows and UAC.
We do not recommend running the ANSLIC_ADMIN on Windows machines by double-clicking the executable directly. Doing so could launch the utility with unexpected permission levels.
To use the utility, select an action from the list of buttons on the left.
The ANSLIC_ADMIN utility consists of the following options:
Launch the Ansys License Management Center (Server Option)
Set Site Preferences -- includes the following options:
View Status/Diagnostic Options -- includes the following options:
From the menu, you can select (server only) and then choose a different language in which to view the server ANSLIC_ADMIN utility and the Ansys Licensing Interconnect log file. You must close and reopen the ANSLIC_ADMIN utility for this setting to take effect. This option is valid only with the server ANSLIC_ADMIN.
From the menu, you can select:
To exit the ANSLIC_ADMIN utility, choose .
Use this option to launch the Ansys License Management Center (LM Center). The Ansys License Management Center is a browser-based user interface that centralizes many of the Ansys licensing administrative functions. For more information, see License Server Administration Using Ansys License Management Center.
Use this option to review the licenses available and prioritize the licenses. Settings specified here apply only to the username shown in the button title. When you select this option, you will first choose the release for which you want to set preferences. Select the release and click . All licenses available to you on your license server machine(s) are shown under the appropriate tab on the next dialog:
Solver
PrepPost
Geometry
HPC
You control the order in which the system attempts to check-out a license by moving the licenses up and down in the list using the or buttons. When you open an application, the license manager attempts to check-out the license listed first in the list. If unable to check-out that license, then the license manager attempts to check out the next license in the list that can be used by the application. The license manager will continue through the list until an available license is found. If none are found, a message displays.
By default, all licenses available from your license server are shown and marked as available for use. If you do not want a particular license to be available for your use, select the license in the list, and set the field to 0.
If you received a new license, you may need to reset your preferences. If you had previously set your license preferences using this option, add the new license to your list in the desired order.
If you have made changes to your license preferences, you can return the settings to the default state by selecting the button.
When you have completed your changes, click to make the changes and close the dialog box. Click to make the changes without closing the dialog box. Selections you make here will take effect with any new sessions/license checkouts but will not affect the current session or change the license(s) currently in use.
Ansys Workbench users can also specify whether to use the shared or separate licensing method.
For details on setting user license preferences, including shared vs. separate licensing for Ansys Workbench and specifying HPC licensing settings, see the Ansys Licensing Guide.
This option is used for license server machines only.
The following site preference settings are available:
This option launches a utility that allows you to designate the order that the licensed products are listed in the Mechanical APDL launcher and the order in which licenses are tried in all applications. You first will need to select the product release. You can choose one of the following:
Release 11.0: Selecting this option affects the product ordering for Release 11.0 for this machine (including all users who run a Release 11.0 product on this machine or mount to this machine). If you select this option, the product ordering you specify will NOT affect any releases after 11.0.
Release 12.0 and higher: Selecting this option affects the product ordering for Releases 12.0 or later and is applicable ONLY if this machine is a license server machine. The product ordering you select with this option will affect all users who use this machine as a license server machine.
After you choose a release level, click . You will then need to select the installation directory (Release 11.0 only), product category (Solver, PrepPost, Geometry, or HPC). To re-order the products, select a product and click the or button. When you have finished reordering all products that you want to reorder, click and then .
All products available in a given category are shown, regardless of whether you have licenses for them.
If you have made changes to your product ordering, you can return the settings to the default state by selecting the button.
For Release 12.0 and higher, after making changes to the product order (including resetting to the default), you will need reread the license file or restart the license manager for the changes to take effect.
Only those logged in as root or superuser (Linux) or with administrative privileges (Windows) can use this utility. You should set the product order before any of the users at your site run; once a user sets his preferences, the user preferences will take precedence.
Note: When installing the License Manager, if you have modified the product order in a previous release, the installation process will automatically update the product order to reflect any changes you made as well as any changes (such as naming conventions) that may have occurred between releases.
Note: Only those users who are logged in as root or superuser (Linux) or with administrative privileges (Windows) can use this utility.
Use this option to modify your license manager startup options. License manager startup options that you can modify include:
- Ansys Licensing Interconnect Debug Log File
You can specify the path to the Ansys Licensing Interconnect debug log file (ansysli_server.log, by default), the detail level of the file (standard, connections, or verbose), the size limit of the file (default is 10MB; minimum is 1MB), and the number of log files to save (default is 10; minimum is 1).
Ansys Licensing Interconnect Debug Log File Detail Descriptions
STANDARD level logs ansysli_server STARTUP options, license cache information (such as features/counts and FlexNet options file content), CHECKOUT, CHECKIN, RESERVE, and RETURN_RESERVE. It also logs CLIENT_SHUTDOWN for all but ansysli_monitor.
CONNECTIONS level logs everything that STANDARD logs, and CLIENT_ACCEPT and CLIENT_SHUTDOWN for the monitor.
VERBOSE level logs STANDARD plus CONNECTIONS, and ADD (product definitions and shared capabilities) and REMOVE (shared capabilities).
- FlexNet Options
You can specify the path to the FlexNet debug log file (license.log, by default). By default, a new license.log file is created each time you start the license manager; you can choose to have new information appended to the existing file instead.
You can also set the
-localsetting (Linux only).The
-localoption restricts the ability to shut down the FlexNet components of the license manager to only an administrator running on the same machine where the FlexNet components of the license manager was started. This option is off by default. See the FlexNet License Administration Guide for more information on using this option.The
-localoption is not recommended if you will be using license borrowing.- Miscellaneous Options
You can specify the Ansys Licensing Interconnect port number here. The default port number is 2325.
All machines that have this server machine in their Licensing Interconnect paths must use the same port number. If you change the Licensing Interconnect port number here, and other machines use this machine's Licensing Interconnect, then on each of those machines, you must change the Licensing Interconnect port number by one or both of the following options, as appropriate for your configuration:
option of the ANSLIC_ADMIN utility
option of the ANSLIC_ADMIN utility
You can also disable the ability to reserve licenses for a design point study in Ansys Workbench and/or the users' ability to track licenses used by Ansys Workbench. For more information on reserving licenses for design point studies in Ansys Workbench, see Reserving Licenses for Design Point Studies in the Ansys Workbench documentation.
On Linux machines only, you can also specify who can shut down the Ansys License Manager. By default, anyone can stop the license manager. You can restrict shutdown capabilities to only the user who started it, or to a group, such as lmadmin. If you choose group, you will need to specify the name of the group. If you specify a group restriction, any users in that group who want to stop the license manager must have the specified group as their primary group. Note that the user who started the license manager will still be able to shut it down, even if he is not part of a group with shutdown capabilities.
Warning: The license.log file and the ansysli_server.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 these files crashes, the license manager would be unable to log license transaction data. This would create a fatal error condition.
When the Licensing Interconnect starts, it caches the licenses for any ANSYSLI_SERVERS lines that are in the ansyslmd.ini file in addition to its own licenses. As you run Ansys applications and they connect with the Licensing Interconnect, it caches the licenses for any servers in your ANSYSLI_SERVERS path that have not yet been cached. Sometimes, especially due to network traffic, this caching process can impact the time it takes to check out a license. Use this option to cache your servers when you start the Ansys License Manager, rather than at the point that you request individual licenses.
Note: Only those users who are logged in as root or superuser (Linux) or with administrative privileges (Windows) can use this utility.
When you select this option:
On the Specify License Servers to Cache dialog, click .
On the Specify License Servers to Cache - Edit Selected Server Machine dialog box, enter the Licensing Interconnect port number. The default Licensing Interconnect port number is 2325.
Enter the hostname of the server.
Click .
Repeat steps 1 - 4 for any additional servers that you want to cache.
When you have finished specifying servers, click on the Specify License Servers to Cache dialog.
To delete a cached server, highlight the server in the list and click .
To edit a cached server, click one of the listed servers and click . You can then change the Ansys Licensing Interconnect port number or the hostname(s).
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. 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.
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 environment variable and the ansyslmd.ini and license files. Setting the ANS_FLEXLM_DISABLE_DEFLICPATH environment variable will affect the information displayed by this option.
Use this option to see a list of capabilities that are queued and awaiting availability, and the applicable licenses that are being used. The report will have the following format:
Capability Timestamp User Count Host PID Platform
Product1 Count
Timestamp User1 Count Host PID Platform
Timestamp User2 Count Host PID Platform
Timestamp Usern Count Host PID Platform
Product2 Count
Timestamp User1 Count Host PID Platform
Timestamp User2 Count Host PID Platform
Timestamp Usern Count Host PID Platform
Where the first line shows information for the requesting user, and subsequent lines under that capability show information for the users who are currently using the licenses for each of the licensed products that satisfy the requested capability.
An example report is shown below. Each line is numbered for reference in the discussion following the example. Note that the actual report does not contain line numbers.
Capability Product Timestamp User Count Host PID Platform 1 ANS_SOLVER 2010/04/27 09:39:27 JQD 1 mach1.win.acme.com 1234 winx64 2 ane3fl 3 3 2010/04/27 08:01:10 JXS 1 mach2.win.acme.com 5678 winx64 4 2010/04/27 07:29:13 MQD 2 mach3.win.acme.com 8765 winx64
Line 1: User JQD is running a process, 1234, on the machine mach1.win.acme.com, which has requested one license with the ANS_SOLVER capability.
Line 2: Based on the site/user preferences, the ane3fl product can satisfy the requested capability, and this site/user is permitted to use up to 3 licenses of this product.
Line 3: User JXS has been using 1 of the available licenses since 8:01:10, from machine mach2.win.acme.com, running process number 5678.
Line 4: User MQD has been using 2 of the available licenses since 7:29:13, from machine mach3.win.acme.com, running process number 8675.
Since users JXS and MQD are already using all of the available licenses, user JQD must either wait for one of those licenses to be freed, or contact one of those users and request that a license be freed.
Select the Auto-Refresh button to have the information automatically refresh every five (5) seconds.
You can also display the queuing report via command line, without launching the ANSLIC_ADMIN utility. To do so, run the following command on Windows systems:
"C:\Program Files\ANSYS Inc\Shared Files\Licensing\licadmin\anslic_admin" -queueinfo
If you need to view the queuing report frequently, you may find it convenient to set a desktop shortcut using the above command.
Run the following command on Linux systems:
/ansys_inc/shared_files/licensing/lic_admin/anslic_admin -queueinfo