Description:This command allows you to disable previous versions of TLS and enable TLS version 1.2 for communication.

Default value/range: 1.2

Corresponding ansyslmd.ini keyword: ANSYSLI_TLS_VERSION

Use in combination with these command options: N/A

Hardware platform restrictions: N/A

Example: This example enables TLS version 1.2.

-ali_tls_version 1.2

Description:This command allows the user to specify the SSL Cipher Suite used on the licensing server to secure communications between client and server. OpenSSL Cipher names are used and can be combined in a comma separated list without spaces in order of preference. To see what ciphers are supported, use the ansysli_server.exe command "-DisplaySupportedCiphers". Setting the Ciphers to only use a preferred cipher, for example ECDHE-RSA-AES128-GCM-SHA256, may prevent older clients that do not support that cipher from connecting. To ensure older clients can connect, AES128-SHA256 and/or AES256-SHA should be enabled.

Default value/range:Output from -DisplaySupportedCiphers command

Corresponding ansyslmd.ini keyword: ANSYSCL_CIPHERS_TO_USE

Use in combination with these command options: N/A

Hardware platform restrictions: N/A

Example: This example sets the SSL Cipher Suite to use the ECDHE-RSA-AES128-GCM-SHA256 cipher, or the AES256-SHA Cipher if the client doesn’t support the first.

-AnsysclCiphersToUse ECDHE-RSA-AES128-GCM-SHA256,AES256-SHA

Description: Use this command option to pass the file name or path of the FlexNet license file to the Licensing Interconnect, which is needed when administering FlexNet and the Licensing Interconnect separately. If you are administering FlexNet and the Licensing Interconnect together, allowing the Licensing Interconnect to start FlexNet, this command option is used to start FlexNet. The optional <license_file_path> is required only if you are not using the default location. When specifying a directory path (rather than a file), be sure that all license files within that directory have a .lic file extension to be recognized by the license manager.

Default value/range: Valid directory path or filename of the FlexNet license file. The default is the directory path - /ansys_inc/shared_files/licensing/license_files.

Corresponding ansyslmd.ini keyword: LICKEYFIL=<license_file_path>

Use in combination with these command options: -cacheflexlic and -noflex

Hardware platform restrictions: N/A

Example: This example starts the Licensing Interconnect and identifies the location of the license file as /FlexNet/ansys/license/license_files/.

ansysli_server -c "/FlexNet/ansys/license/license_files/"

Description: Indicates to the Licensing Interconnect to cache the FlexNet license file when administering FlexNet and the Licensing Interconnect separately to make the Licensing Interconnect aware of available license features.

Default value/range: N/A

Corresponding ansyslmd.ini keyword: CACHE_FLEXLIC=1

Use in combination with these command options: -c and -noflex

Hardware platform restrictions: N/A

Example: This example starts the Licensing Interconnect; the Licensing Interconnect will not start FlexNet (-noflex). The Licensing Interconnect will read the license feature information (-cacheflexlic) from the license file path specified (-c).

ansysli_server  -cacheflexlic  -noflex  -c "/FlexNet/ansys/license/license_files/"

Description: When you have multiple single license servers (not a triad), use this option to specify license servers other than the localhost for which to cache their FlexNet licenses at startup. This option will make the Licensing Interconnect aware of what license features are available on the other license servers. Use this option to speed up license checkouts, so that the caching is done upon startup of the Licensing Interconnect, rather than on the fly, when a client connects with the other license server in its license path.

Default value/range: The port number is the Licensing Interconnect port; the default is 2325. The host is the hostname of another standalone license server. The port@host can also be a list, delimited by colons (:) on Linux and semicolons (;) on Windows.

Corresponding ansyslmd.ini keyword: CACHE_SERVER=<port@host>

Use in combination with these command options: N/A

Hardware platform restrictions: N/A

Example: This example starts the Licensing Interconnect on your current system. Upon startup, the Licensing Interconnect will cache the license information from a different license server named apple on port 2325 on that machine.

ansysli_server   -cache_srv 2325@apple

Description:This command allows you to disable and enable the ANSYSLI_CHECKOUT_RETRY feature. The ANSYSLI_CHECKOUT_RETRY feature dictates the number of seconds the license check-out retry attempts will continue before failing. This command is set to 1 (allowed) by default.

Default value/range: 1/0; default is 1

Corresponding ansyslmd.ini keyword: ANSYSLI_CHECKOUT_RETRY

Use in combination with these command options: N/A

Hardware platform restrictions: N/A

Example: This example turns the ANSYSLI_CHECKOUT_RETRY feature off.

-checkoutretry 0

Description:This command allows the user to display the default Cipher Suites currently supported in ansysli_server. Cipher Suites can be set via the -AnsysclCiphersToUse command line option. AnsysclCiphersToUse will only accept the ciphers if they are in the output list of -DisplaySupportedCiphers.

Default value/range:N/A

Corresponding ansyslmd.ini keyword: N/A

Use in combination with these command options: AnsysclCiphersToUse

Hardware platform restrictions: N/A

Example: This example prints the currently enabled cipher suites

ansysli_server   -DisplaySupportedCiphers

Description: This command allows you to turn off the license reservation feature for design points in Ansys Workbench.

Default value/range: 1/0; default is 1.

Corresponding ansyslmd.ini keyword: ANSYSLI_DP_RESERVE

Use in combination with these command options: N/A

Hardware platform restrictions: N/A

Example: This example turns license reservation off for design points in Ansys Workbench.

ansysli_server   -dp_reserve 0

Description: Enabling this command option sets the FlexNet environment variable - FNP_IP_ENV. This option allows you to bypass the client-side hostname resolution, thus improving license checkout performance. Use this option when you see such messages as "FLEXlm server is not responding. Resource temporarily not available."

Default value/range: 0/1; default is 0 (off)

Corresponding ansyslmd.ini keyword: ANSYSLI_FNP_IP_ENV

Use in combination with these command options: N/A

Hardware platform restrictions: N/A

Example: This example bypasses the client-side hostname resolution.

-fnp_ip_env 1

Description: This option allows you to specify the number of times that the Licensing Interconnect attempts to restart lmgrd/ansyslmd. After attempting to restart for the specified number of times, the Licensing Interconnect discontinues the restart process until the next CHECKPOINT. At the time of the next CHECKPOINT, the Licensing Interconnect again attempts to restart for the specified number of times. This process continues until the issue is resolved. This situation might occur if licenses in the license file have expired.

Default value/range: 1-10; default is 1

Corresponding ansyslmd.ini keyword: ANSYSLI_FNP_RESTART_ATTEMPTS

Use in combination with these command options: N/A

Hardware platform restrictions: N/A

Example: This example sets the number of restart attempts to 1.

-fnp_restart_attempts 1

Description: Only a member of the group specified can shutdown the Licensing Interconnect. If the group restriction is in place, when shutting down the Licensing Interconnect, the group specified must be your primary group.

Default value/range: Valid system group names.

Corresponding ansyslmd.ini keyword: RESTRICT_SHUTDOWN=GROUP:<group>

Use in combination with these command options: N/A

Hardware platform restrictions: This option is only available on Linux platforms.

Example: This example starts the Licensing Interconnect on your current system and limits the users who can shutdown the Licensing Interconnect to those who are members of the group lmadmin.

ansysli_server -group lmadmin

Description: This command allows you to define which license servers to use from the licensing path. Any servers that you specify will be used, ignoring all other servers listed in the licensing path.

Default value/range: N/A

Corresponding ansyslmd.ini keyword: ANSYSLI_INCLUDE_FLEXSVR=<Server1, server2, etc.>

Use in combination with these command options: N/A

Hardware platform restrictions: N/A

Example: This example ignores all supplied servers in the licensing path except server1 and server2.

ansysli_server -include_flexsvr server1, server2

Description: Any server that you specify will not be included in the FlexNet license path. The reason to remove these servers from your path is that FlexNet can take too long to return when a server in the path does not exist. This can cause the Licensing Interconnect to delay license checkout calls. Candidates are license servers that are off-line but still in the DNS.

Default value/range: N/A

Corresponding ansyslmd.ini keyword: ANSYSLI_IGNORE_FLEXSVR=<Server1, server2, etc.>

Use in combination with these command options: N/A

Hardware platform restrictions: N/A

Example: This example removes server1 from the license path.

ansysli_server  -ignore_flexsvr=server1

Description: Most command arguments to the Licensing Interconnect also have a corresponding ansyslmd.ini keyword. This command option signals the Licensing Interconnect to read the startup options from the specified ansyslmd.ini file.  Use this option if your ansyslmd.ini file is not in the default location.

Default value/range: The default location for the ansyslmd.ini file is determined as follows:

Specify both the path and file name.

Corresponding ansyslmd.ini keyword: N/A

Use in combination with these command options: N/A

Hardware platform restrictions: N/A

Example: This example will start the Licensing Interconnect, identifying the location of the ansyslmd.ini file. The Licensing Interconnect will read and apply any settings contained in the ansyslmd.ini file.

ansysli_server  -ini  "/my_directory/shared_files/licensing/ansyslmd.ini"

Description: This Licensing Interconnect command option allows the Licensing Interconnect to revert back to Release 14.5 and prior behavior with regard to client IP addresses.  For most sites, the 15.0 and later behavior is appropriate.  This option  should only be used if you are using stand-alone Licensing Interconnects in addition to the one on your license server and you want the IP address used to be that of the system on which the stand-alone Licensing Interconnect is running, not the client machine.  To change the default behavior, this command option would need to be set on the systems running the stand-alone Licensing Interconnect.

Default value/range:  N/A

Corresponding ansyslmd.ini keyword: ANSYSLI_IP_OVERRIDE

Use in combination with these command options: N/A

Hardware platform restrictions: N/A

Example: This example turns off the IP address override.

ansysli_server -IpOverride

Description: Returns information on the Licensing Interconnect running at port@host. Information returned includes whether the Licensing Interconnect is running and on which port.

Default value/range:  Port refers to the Licensing Interconnect port number; the default port number is 2325.  Host is the hostname. If port@host is not specified, localhost is tried (using the ANSYSLI_PORT value).

Corresponding ansyslmd.ini keyword: N/A

Use in combination with these command options: N/A

Hardware platform restrictions: N/A

Example: Use this example to determine if the Licensing Interconnect is running on a license server named grape on port 2325.

ansysli_server –k info 2325@grape

Description: This command option will reread information for the Licensing Interconnect.  If you are administering FlexNet and the Licensing Interconnect separately, each time you reread FlexNet, you must also reread the Licensing Interconnect. If you are administering FlexNet and the Licensing Interconnect together, this command option will reread both FlexNet and the Licensing Interconnect. Files that are read include:

Reread cannot be used in the following situations:

Default value/range: Port number refers to the Licensing Interconnect port number; the default is 2325.  Host is the hostname. If port@host is not given, the localhost is tried (using the ANSYSLI_PORT value).

Corresponding ansyslmd.ini keyword: N/A

Use in combination with these command options: N/A

Hardware platform restrictions: N/A

Example: Use this command to have the Licensing Interconnect reread the FlexNet license file(s), the FlexNet options file, and the ansyslmd.ini file on the license server named orange on port 2325. Note that if FlexNet and the Licensing Interconnect are being administered together, this command will also send a reread command to FlexNet.

ansysli_server –k reread 2325@orange

Description: Stops the License Manager running at port@host. If -noflex was used to start the Licensing Interconnect, only the Licensing Interconnect will be stopped. If -noflex was not used to start the Licensing Interconnect, both FlexNet and the Licensing Interconnect will be shutdown.

Default value/range: Port refers to the Licensing Interconnect port number; the default is 2325. If you do not specify port@host, it will attempt to shut down the Licensing Interconnect running on localhost (using the ANSYSLI_PORT value). This command argument will only accept one Licensing Interconnect to shutdown.  If you need to kill the Licensing Interconnect manually, kill the monitor first, ansysli_server second, then FlexNet.

Corresponding ansyslmd.ini keyword: N/A

Use in combination with these command options: N/A

Hardware platform restrictions: N/A

Example: Use this command to stop the Licensing Interconnect on the system named peach, using port 2325. Note that if FlexNet and the Licensing Interconnect are being administered together, both FlexNet and the Licensing Interconnect will be shutdown.

ansysli_server –k stop 2325@peach

Description: This command option specifies the directory path and name of the output log file for the Licensing Interconnect; debugging and usage information is included in the file.

Default value/range: If a log file name and path is not specified the file is put in the default location one directory level up from ansysli_server<.exe> and is named ansysli_server.log. If no directory is specified and the default directory is not found, the file is placed in the directory specified by ANSLIC_DIR.

Corresponding ansyslmd.ini keyword: DEBUG_LOG_FILE =<path_file_name>

Use in combination with these command options: N/A

Hardware platform restrictions: N/A

Example: This command specifies the directory path and file name of the Licensing Interconnect log file as /ansys_inc/shared_files/licensing/ansysli_server.log.

ansysli_server –log "/ansys_inc/shared_files/licensing/my_ansysli_server.log"

Description: When included on the command line to start the Licensing Interconnect, this command option indicates the level of verbosity of the Licensing Interconnect log file information (ansysli_server.log). If this command option is not specified, the verbosity level is set to STANDARD. The verbosity level should be changed only if you are actively working with the Ansys, Inc. Technical Support staff to solve a specific problem.

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).

Default value/range: STANDARD (default), CONNECTIONS, VERBOSE

Corresponding ansyslmd.ini keyword: DEBUG_LOG_TYPE

Use in combination with these command options: N/A

Hardware platform restrictions: N/A

Example: This command indicates that Licensing Interconnect log file (specified by -log) verbosity level should be set to VERBOSE.

ansysli_server –log "/ansys_inc/shared_files/licensing/my_ansysli_server.log" -logtype verbose

Description: The Ansys License Manager supports FlexNet's licensing queuing in many Ansys, Inc. products. By default, queuing is off. This command option indicates the maximum number of license checkout requests that can be queued at any one time.

Default value/range:1 - 10000 (default)

Corresponding ansyslmd.ini keyword: MAX_QUEUED_REQUESTS

Use in combination with these command options: -queuing_interval

Hardware platform restrictions: N/A

Example: This example indicates that a maximum of 20 requests can be queued:

ansysli_server –max_queued_requests 20

Description: This option only applies when queuing for multiple tasks of the same feature, like HPC. When this option is enabled (default/on=1), you are using FNP queuing and you are put in the queue in the order in which the request is made. When this option is disabled (off=0), you are not using FNP queuing and are using Ansys Licensing Interconnect queuing only.

Default value/range: 0/1; default is 1 (on)

Corresponding ansyslmd.ini keyword: ANSYSLI_MULTITASK_QUEUEING_FLEX

Use in combination with these command options: N/A

Hardware platform restrictions: N/A

Example: This example uses FlexNet Publisher to queue multi-task checkout requests when you choose to queue requests.

-multitask_queueing_flex 1

Description:When you have multiple single license servers (not a triad), use this option to specify which license servers, other than the localhost, should not cache their FlexNet licenses at startup.

Default value/range: The port number is the Licensing Interconnect port; the default is 2325. The host is the hostname of another standalone license server. The port@host can also be a list, delimited by colons (:) on Linux and semicolons (;) on Windows.

Corresponding ansyslmd.ini keyword: ANSYSLI_ NOCACHE_SERVER=<port@host>

Use in combination with these command options: N/A

Hardware platform restrictions: N/A

Example: This example indicates that port1@host1 and port2@host2 should not cache their FlexNet licenses at startup (on a Windows system).

ansysli_server -nocache_server=port1@host1;port2@host2

Description: This command option allows you to administer FlexNet and the Licensing Interconnect separately by telling the Licensing Interconnect to not start FlexNet. If this command option is omitted, the Licensing Interconnect will attempt to start FlexNet.

Default value/range: N/A

Corresponding ansyslmd.ini keyword: ANSYSLI_NOFLEX=1

Use in combination with these command options: -c and -cacheflexlic

Hardware platform restrictions: N/A

Example: This example starts the Licensing Interconnect; the Licensing Interconnect will not start FlexNet (-noflex). The Licensing Interconnect will read the license feature information (-cacheflexlic) from the license file path specified (-c).

ansysli_server  -cacheflexlic  -noflex  -c "/FlexNet/ansys/license/license_files/"

Description: This option controls how long the ansysli_server process should wait before abandoning attempts to access the Licensing Interconnect port if the port was in use when the ansysli_server process began. This option may be useful if your system takes a long time to free its ports.

Default value/range: 15 minutes; minimum 10 minutes, maximum 60 minutes

Corresponding ansyslmd.ini keyword: ANSYSLI_PORT_TIMEOUT

Use in combination with these command options: -restart_port_timeout

Hardware platform restrictions: N/A

Example: Use this command to tell the ansysli_server to wait 25 minutes before it stops checking for the port availability and exits:

 ansysli_server -port_timeout 25

Description: This command dictates whether the Ansys Licensing Interconnect should run in private mode where requests for license usage from client systems do not return user or host information. Setting this command to 1 (on) blocks user and hostname information while setting it to 0 (off) allows this information to be included. This command is set to 0 (off) by default.

Note: This command only modifies license or queue status queries from client systems, requests made from the server system are not affected.

Default value/range: 1/0; default is 0 (off)

Corresponding ansyslmd.ini keyword: ANSYSLI_PRIVATE

Use in combination with these command options: N/A

Hardware platform restrictions: N/A

Example: This example sets the Ansys Licensing Interconnect to run in private mode:

-private 1

Description: Use this command option to purge obsolete usage data from the license tracking usage file (usage_track.xml; see the file description in Files created by the Licensing Interconnect). If you do not purge this file periodically, it could become very large. By default, this file is purged every 14 days.

Default value/range: positive integers representing days; default is 14

Corresponding ansyslmd.ini keyword: ANSYSLI_PURGE_WB_USAGE

Use in combination with these command options: -wb_usage, -usage_archive_interval

Hardware platform restrictions: N/A

Example: This example purges the usage_track.xml file every 31 days.

ansysli_server -purge_wb_usage 31

Description: The Ansys License Manager supports FlexNet's licensing queuing in many Ansys, Inc. Products. By default, queuing is off. This command option specifies the frequency by which checkout attempts are performed on queued license checkout requests.

Default value/range: 15 - 600 seconds; default is 120 seconds

Corresponding ansyslmd.ini keyword: QUEUING_INTERVAL

Use in combination with these command options: -max_queued_requests

Hardware platform restrictions: N/A

Example: This example indicates that checkout attempts for queued requests are performed every 5 minutes (300 seconds):

ansysli_server –queuing_interval 300

Description: This command controls how long the ansysli_monitor should wait for the Licensing Interconnect port to free before restarting the ansysli_server. This option may be useful if your system takes a long time to free its ports.

Default value/range: 15 minutes; minimum 10 minutes, maximum 60 minutes

Corresponding ansyslmd.ini keyword: ANSYSLI_RESTART_PORT_TIMEOUT

Use in combination with these command options: -port_timeout

Hardware platform restrictions: N/A

Example: The following example tells the ansysli_monitor to wait 25 minutes for the port to free before restarting the ansysli_server:

 ansysli_server -restart_port_timeout 25

Description: Use this command option to stipulate that a member of the group specified can return reserved licenses for the design point reservation feature. This command option identifies the group or (comma separated) list of groups that are permitted to return reserved licenses for all users. If this option is used, the user who started the Licensing Interconnect will be unable to return reserved licenses, unless that user is a member of the group specified.

Default value/range: The system group name specified must be valid. When returning reserved licenses, the group must be your active group.

Corresponding ansyslmd.ini keyword: RETURN_RESERVE=GROUP

Use in combination with these command options: N/A

Hardware platform restrictions: This option is only available on Linux platforms.

Example: The following example allows only those users who are a member of the group lmadmin to return reserved licenses.

ansysli_server  -reservegroup   lmadmin

Description: Use this command option to stipulate that the users specified can return the reserved licenses of all users for the design point reservation feature. This command option identifies the user or (comma separated) list of users that are allowed to return reserved licenses for all users. If this option is used, the person who started the Licensing Interconnect will be unable to return reserved licenses, unless that person is included in the member list.

Default value/range: Valid usernames. Comma separate list of valid users

Corresponding ansyslmd.ini keyword: RETURN_RESERVE=USER

Use in combination with these command options: N/A

Hardware platform restrictions: N/A

Example: The following example allows only users legolas and gimli to return reserved licenses.

ansysli_server  -reservegroup legolas,gimli

Description: This option is used to specify how frequently usage data is archived for Ansys Workbench license usage reporting only. Once the usage data is archived, the data will be cleared from memory. Data is archived to <osdrive>\Program Files\ANSYS Inc\Shared Files\Licensing\ansysli_data\archive\usage_track.xml (Windows) or ansys_inc/shared_files/licensing/ansysli_data/archive/usage_track.xml (Linux).

Default value/range: 60 minutes; minimum 5 minutes, maximum 720 minutes

Corresponding ansyslmd.ini keyword: ANSYSLI_USAGE_ARCHIVE_INTERVAL

Use in combination with these command options: -purge_wb_usage, -wb_usage

Hardware platform restrictions: N/A

Example: The following example sets the archive interval to every two hours (120 minutes):

ansysli_server -usage_archive_interval 120

Description: This command option will restrict shut down of the Licensing Interconnect to only the user who started it.

Default value/range: N/A

Corresponding ansyslmd.ini keyword: RESTRICT_SHUTDOWN=USER

Use in combination with these command options: N/A

Hardware platform restrictions: This option is only available on Linux platforms.

Example: This example starts the Licensing Interconnect and limits the user who can shutdown the Licensing Interconnect to only the user who started the Licensing Interconnect.

ansysli_server -user

Description: This command option displays the Licensing Interconnect version information.

Default value/range: When no value is given, all version information is given. This option is the equivalent of -version long. Other values for <type> are: short, build, ali, or revn, each of which will display a subset of the long output.

Corresponding ansyslmd.ini keyword: N/A

Use in combination with these command options: N/A

Hardware platform restrictions: N/A

Example: Use this command to obtain version information on the Licensing Interconnect.

ansysli_server -version

Description: This command option turns license tracking on or off for the license reservation feature for Ansys Workbench. License tracking is on by default. License data usage is archived to <osdrive>\Program Files\ANSYS Inc\Shared Files\Licensing\ansysli_data\archive\usage_track.xml (Windows) or ansys_inc/shared_files/licensing/ansysli_data/archive/usage_track.xml (Linux).

Default value/range: 0/1; default is 1 (on)

Corresponding ansyslmd.ini keyword: ANSYSLI_WB_USAGE

Use in combination with these command options: -purge_wb_usage, -usage_archive_interval

Hardware platform restrictions: N/A

Example: This example turns license tracking off for design points in Ansys Workbench.

ansysli_server -wb_usage 0