Specify license manager location with the GUI

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 specify the hostname of your license in server two ways, with an environment variable or with a 'License.ini' file.

Notes

• If both the License.ini file and the environment variable are set, 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. 

Setting an Environment Variable

• This method using the environment variable is supported starting with Ansys Optics 2021 R2.
• For prior releases that are still accessing the legacy Lumerical FlexNet license manager, configure the "License.ini" file as shown below. The older versions do not support this method.  

ANSYSLMD_LICENSE_FILE environment variable

Add the environment variable, ANSYSLMD_LICENSE_FILE with the corresponding port and license server hostname or IP address on the machine running Ansys Optics. 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/global'). See this KB for more information of the Lumerical preference (.ini) files.  

• Create the preference file directory if it does not exist. Folder and filenames are case-sensitive.
  • user's specific folder

    mkdir $HOME/.config/Lumerical/

  • default global folder for the current release (root access required)

    sudo mkdir /opt/lumerical/[[verpath]]/Lumerical/

• Create the "License.ini" file in the "Lumerical" folder that was created above.

  sudo vi License.ini

• Specify the machine hosting the license manager and the TCP port number used.
  The file should contain the following lines: (default port shown)  

  [license]
  domain=1
  default=user
  ansysserver\host=1055@[license_server]

Notes:

• Starting with the 2024 R1 release, the option for the Legacy Lumerical FlexNet license has been removed.
• Replace the "domain" number with either;
  • 0 - for the Enterprise license,  
  • 1 - for the Standard license.

Triad license server configuration

Note: The example shown uses default port 1055, and 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.  

Windows: Separate the Ansys license server information with a comma "," and inside quotes "". 

ansysserver\host="1055@server1,1055@server2,1055@server3"

Linux: Separate the Ansys license server information with a colon ":".

ansysserver\host=1055@server1:1055@server2:1055@server3 

See also

Lumerical license configuration with the Ansys Optics Launcher  

Create or modify environment variables in Windows  

Setting environment variable in Linux