This page explains how to set the license server information without using the Ansys Optics Launcher or the Ansys licensing client settings. This may be required for machines without a graphical interface or when setting system-wide license server configuration.
You can set the license server configuration in two ways outside the GUI. Either the 'License.ini' file or the ANSYSLMD_LICENSE_FILE environment variable.
Notes
- If both the "License.ini" file and the environment variable are set, the setting in the "License.ini" file takes precedence.
- If both the user and system-wide "License.ini" files are set, the user's "License.ini" file will take precedence.
Using ANSYSLMD_LICENSE_FILE
- This method using the ANSYSLMD_LICENSE_FILE environment variable is supported starting with Ansys Lumerical 2021 R2.
- For prior releases that are still accessing the legacy Lumerical FlexNet license manager, configure the "License.ini" file as shown below.
Add the environment variable, ANSYSLMD_LICENSE_FILE with the corresponding port and license server hostname or IP address on the machine running Ansys Lumerical. See adding/modifying environment variables in Windows and Linux for more information.
Configuring the License.ini file
- 'License.ini' specifies the port and server running the Ansys license manager. This file is located in the user's home directory (local), or in the installation folder of Ansys Lumerical on the machine (system-wide).
- The 'License.ini' file is automatically created when configuring Lumerical with the Ansys Optics Launcher > Licenses configuration utility.
- This can also be manually created and edited from the command line to specify different licensing information e.g. license server, port and license type to checkout, either Enteprise or Standard license.
Preference files location
Windows local user:
%AppData%\Lumerical\License.ini
Linux local user:
~/.config/Lumerical/License.ini
See this KB for more information of the Lumerical preference (.ini) files. See notes and examples below.
Notes
Setting the 'License.ini' file to checkout the Standard or Enterprise license.
- The option for the Legacy Lumerical FlexNet license has been removed starting with the 2024 R1 release. To manually select the type of license to checkout, set "domain" to the appropriate number that corresponds to the license type and Lumerical version.
-
- "domain=0" for Enterprise license (all versions)
- "domain=1" for Standard license (2024 R1 and newer release)
- "domain=2" for Standard license (older versions)
-
Example
- User specific settings to checkout 'Standard' licenses on 2024 R1 and newer releases.
[license]
default=user
domain=1
ansysserver\host=1055@myserver
- 'System wide' settings to checkout 'Enterprise' licenses on 2024 R1 and newer releases.
[license]
default=system
domain=0
ansysserver\host=1055@myserver
Where:
- 1055, SERVER port (default). Replaced with the port used in your license file.
- myserver, hostname or IP address of the machine running the Ansys License Manager.
Triad license server configuration
Triad redundance license server can also be configured using either the environment variable or 'License.ini' file.
Windows: Separate the Ansys license server information
#separate servers with semi-colon(;)
ANSYSLMD_LICENSE_FILE=1055@server1;1055@server2;1055@server3
#License.ini file - separate servers with comma(,) and inside quotes("")
ansysserver\host="1055@server1,1055@server2,1055@server3"
Linux: Separate the Ansys license server information with a colon ":".
ANSYSLMD_LICENSE_FILE=1055@server1:1055@server2:1055@server3
#License.ini file
ansysserver\host=1055@server1:1055@server2:1055@server3
Note: The example above uses default port 1055, with server1, server2, and server3 as the hostnames of the triad license servers. Change the port and the hostname to the port number and hostname of the servers you are using.
See also
Lumerical license configuration with the Ansys Optics Launcher