^

AR# 32301 Licensing - Troubleshooting Xilinx Software License Issues

This answer record is intended to help users troubleshoot some common issues that might be encountered during obtaining, setting up, and using Xilinx software licenses.

Other Useful Links
Current licensing instructions in the Installation, Licensing, and Release Notes Guide (UG631):
ISE Design Suite 14: Installation, Licensing, and Release Notes

For general questions about Xilinx Licensing:
http://www.xilinx.com/tools/faq.htm

or:

http://www.xilinx.com/support/answers/41259.html

Xilinx Software Licensing Known Issues:
(Xilinx Answer 32295)

Software Licensing page:
http://www.xilinx.com/getlicense

Obtaining a License (purchasing, generating, downloading, etc.)

The desired product is not shown (no entitlement) in the user's Xilinx license account.

  • See (Xilinx Answer 30592).
  • Make sure that the email address used to log into your account is consistent with the address used when the product was purchased; your account and your entitlements are based on the email address. Many companies alias two email addresses, for example,joe.smith@cool_works.com and jsmith@cool_works.com. Even though both addresses go to the same location, they are treated as separate accounts when logging-in to the Xilinx Download and Licensing site.
  • Entitlements are activated as they are processed. Depending on where the license was purchased, payment clearing and workload, activating a license could take as long as two to three days from purchase.
  • For entitlement issues and questions please visit the Customer Service Online Support Form.
I do not have the option to generate a floating license.
  • Floating licenses can only be generated by a Xilinx licensing account administrator.
  • When generating a license, you can generate either a node-locked or floating license in the same license file (not both). If any product feature is selected that only allows a node-locked license, then the ability to generate a floating license is disabled.
  • If you are a Xilinx license account administrator for your company and do not see the option of a specific product, this is an entitlement issue and you should contact Xilinx Customer Service.

Modifying a License (rehosting, changing number of seats, etc.)

License Not Delivered
  • There have been several cases where licenses and entitlement notifications sent to customers are being filtered to the customer's "junk mail" email folder. If you do not receive an expected email from the Xilinx Download and Licensing site, please check your "junk mail" folder.
  • The license can also be directly downloaded from the Download and Licensing site at any time. Go to the Manage Licenses tab, select the generated license, and select the Download arrow in the bottom left corner.

Installing and Setting Up License for Use

Setting Up Windows Server in Service Mode
  • Use lmtools.exe (available at %XILINX%\bin\nt) to configure a license server system as a service; see (Xilinx Answer 32780) for detailed instructions.

Cannot Find the License Server Utilities

Setting Up a Floating License to Run through a Firewall
  • For a firewall configuration, two ports need to be opened on the firewall; the server port number specified on the server line of the license, and a return port. The return port should be specified on the vendor daemon line in order to fix it to a specific port number that can be opened on the firewall; see (Xilinx Answer 33115).

License File Was Lost or Accidentally Deleted
  • The generated license file can be downloaded or emailed again at any time. Go to the Download and Licensing site, click on the desired license file in the master view of the Manage Licenses tab, and click on the download or email icon in the lower left panel.

Issues Related to Finding the Correct License (License not found, wrong License Found, etc.)

The Ethernet MAC ID I used to node-lock my license does not appear in XLCM
  • Some laptops have a feature that disables the LAN port when not in use. This might result in the Ethernet MAC ID "disappearing."

My Node-locked License Is Not Found
  • Open Xilinx License Configuration Manager (XLCM) from the start menu, or by typing "xlcm" in a command shell. This shows all of the Xilinx licenses that are found in the search locations.
  • Check to make sure the license file is in one of the locations where Xilinx software looks for the license. Typically, this is the ".xilinx" directory under the home drive, for example,c:\.Xilinx or ~/.Xilinx) for node-locked licenses, however, there are several possible locations where the Xilinx software might find a license. For all searched locations, go to: http://www.xilinx.com/tools/faq.htm
    and select "What are the search order and locations that Xilinx software tools (other than CORE Generator) look for a license?"
  • Make sure that theXILINXD_LICENSE_FILE is set to the expected value, if the license is not in a default location.
  • Open the license file and visually check to make sure the desired feature is found in the license file. It should follow a FEATURE or INCREMENT keyword or be a component of a package (the package name must also follow a FEATURE or INCREMENT keyword).
  • Run lmutil diagnostics on the file where the product license key is expected to be to obtain the available license keys and check-out status.
    Example: 'lmutil lmdiag -c c:\.Xilinx\xilinx.lic'
  • For LogiCORE IP license you can also run xlicmgr from the command line to see the license status.
    Example: 'xlicmgr status -c pci_express_v1 -v'
  • If you are running the software on a remote desktop, check to see that the license contains the "TS_OK" (Terminal Server OK) key. XLCM will show that the license is valid but hte software will indicate that a valid license was not found.

My Floating License Is Not Found
  • Open Xilinx License Configuration Manager (XLCM) from the start menu, or by typing "xlcm" in a command shell; this shows all of the Xilinx licenses that are found in the search locations.
  • Check to make sure the license file is in one of the locations where Xilinx software looks for the license. Typically, this is a PORT@Server location pointed to by XILINXD_LICENSE_FILE for floating licenses. However, there are several possible locations that Xilinx software might find a license. For all searched locations, go to: http://www.xilinx.com/tools/faq.htm
    and select "What are the search order and locations that Xilinx software tools (other than CORE Generator) look for a license?"
  • Make sure XILINXD_LICENSE_FILE is correctly set to the right port number and server name provided in the license file.
  • Open the license file and visually check to make sure the desired feature is found in the file. It should follow a FEATURE or INCREMENT keyword or be a component of a package (the package name must also follow a FEATURE or INCREMENT keyword).
  • Run lmutil diagnostics on the PORT@SERVER location where the product license key is expected to be to obtain the available license keys and check-out status.
    Example: 'lmutil lmdiag -c 2100@server1'
  • Check for a specific feature on all PORT@SERVER locations and caches for LM_LICENSE_FILE and XILINXD_LICENSE_FILE.
    Example: 'lmutil lmdiag ISE'
  • For the LogiCORE IP license, you can also run xlicmgr from the command line to see the license status.
    Example: 'xlicmgr status -c pci_express_v1 -v'
  • Make sure the license is up and running on the server.
  • If the PORT@SERVER location is not found, 'lmutil lmdiag' returns without any message.
  • Can the client and server communicate?
  • Attempt to ping the server from the client: C:\>ping server12.
  • Attempt to telnet to the server from the client. C:\>telnet server12.


If a license component is found in multiple locations or in multiple packages in a single license file, which instance of the component is used (takes precedence)?

If a license component, for example, ISE is available in multiple license packages, for example, a Logic Edition and a System Edition license, the license that is used is selected in the following order:

  1. The license that gives the highest level of operation for an application will be used first. Note: For most licensed Xilinx applications, which are simply enabled (when licensed) or disabled (when not licensed), the level of operation will be equal.
  2. Next, the license with the oldest version limit will be used before one with a later (newest) version limit.
  3. If the version limits are the same then the license with the later start date will be used.
  4. If the version limits and the start dates are the same, then the license valid license found in the search order will be used.
    • Licenses found in the same directory are searched in alphabetical order.
    • License features within a single file are searched in the order in which they appear in a license file.
  • Note: The precedence specified in items 2, 3, and 4 above can be overridden with the use of the "sort" directive. To use the sort directive, edit the applicable Increment lines of the license file and add "sort=1","sort=2", etc... . A lower sort value takes precedence over a higher value.
  • If a WebPack license is found and can be used, that is, the license is valid and the target device is supported by WebPACK, then the WebPACK component will be used in place of and before a found ISE component, regardless of search order.


An incorrect License Level is Found/Used

  • For the LogiCORE IP core license keys, make sure the core has been regenerated after the latest license is available; see (Xilinx Answer 30517). To see what license level a core was generated with, run 'xlicmgr report <core_name>.ngc'
  • Clear the FLEX license cache; from the command line run "xlicmgr reset".
  • Set XILINXD_LICENSE_FILE to specifically point to the desired license first.
    • Example1: 'XILINXD_LICENSE_FILE=c:\.xilinx\xilinx.com' Even though c:\.xilinx\xilinx.com is already being searched for licenses, specifying it with the XILINXD_LICENSE_FILE variable puts it first in the search order.
    • Example2: 'XILINXD_LICENSE_FILE=/user/eda/lic/Xlinx.lic:1700@myserver:2100@bigserver' Xilinx.lic is searched before the license keys on either server.


License Found but MAC Address Not Allowed


Issues with Incorrect License (license found, but does not work)

Node-locked license is found but does not work.

  • Check for the host name and host id; it should match with the host values in the machine that is installing the node-locked license. XLCM lists the values available on a system to lock a license to. Typing "lmutil lmhostid" at a command prompt returns MAC addresses that can be used for your system.\
  • Check the expiration date of the license.
  • Check to make sure the feature name in the license matches.
  • Check with the package and components line in your license file to see whether you are entitled to that software. For example, a license file issued for just EDK cannot run ISE since the Components line in the file only lists XPS and SDK. However, the Component line for a System_Edition package would include and enable ISE.
  • Check with the OS supportability: http://www.xilinx.com/publications/matrix/Software_matrix.pdfKeepThis=true&TB_iframe=true
  • Check the license file format (DOS vs. UNIX). In most cases, this does not matter, but cases have been seen with opensUSE (unsupported OS) where the license needed to be converted with a dos2unix command to be read correctly.
  • If you are running the software on a remote desktop, check to see that the license contains the "TS_OK" (Terminal Server OK) key. XLCM will show that the license is valid but hte software will indicate that a valid license was not found.


License error "No ISE feature is found" occurs even though you have a WebPACK software license and a floating license for EDK.

  • Resolution: Ignore the warning and continue working with EDK/ISE software integration. A change request has been filed and should be fixed in coming versions.


License error "WebPACK does not support this part" occurs.


When to Contact Xilinx Customer Service

Customer wants to add users, but does not have administrator privileges.

  • Any license account administrator can add new users to the account or allow any user to be an account administrator.
  • Contact Customer Service to find out which user is the administrator for the account.


Customer is in transitional warranty, but cannot see the transitional licenses for 11.1 in the Create Licenses tab.

Customer has to generate IP license for specific versions, but cannot find them listed in "Add Evaluation and No charge IP core" tab.

Customer cannot find a product on the Create New Licenses tab for which they should have access (entitlement).

Miscellaneous

SmartExplorer or ExploreAhead Runs:

Node-locked License:

  • Unlimited parallel runs of exploration-based MAP/PAR on single license check-out on single machine.


Floating License:

  • Unlimited parallel runs MAP/PAR on single license check-out on multiple machines by a single user.


How to find what is in the FLEXlm cache and how to clear the cache

  • The registry key for XILINXD is: "HKLM\Software\FLEXlm License manager".
    For example, the command 'reg query "HKLM\Software\FLEXlm License Manager"' might return: XILINXD_LICENSE_FILE REG_SZ 2100@myserver.mydomain.com - (the double quotes in the query command are required since the key name contains blanks).
  • To clear the cache, delete the registry or run "xlicmgr reset" from the command line.

Associated Answer Records

Answer Number Answer Title Version Found Version Resolved
36551 Licensing - The license file is in the correct location but Xilinx software does not find the licensed feature N/A N/A
34746 Licensing - Is there a way to select an ISE software license before a WebPACK license? N/A N/A
AR# 32301
Date Created 12/17/2013
Last Updated 12/17/2013
Status Active
Type General Article
Tools
  • ISE Design Suite - 11.1
  • ISE Design Suite - 12.1
  • ISE Design Suite - 13
  • ISE Design Suite - 14
Feed Back