OpenLink Software Support Page

Debugging Licensing Problems

Identifying License Problems

License problems occur when users attempt to apply them to products or when they hit a ceiling associated with concurrent usage. Most license errors are explicit and include text that states that a license is invalid, expired, or exceeded. Problems associated with performance or stability problems that do not produce license related errors are not likely to be caused by licenses. There is no scenario in which use of an evaluation key would contribute to limited functionality. OpenLink's products are fully functional regardless of the license key applied. The license key simply dictates the length of time for which a product may be used.

Source of Licensing Problems

Licenses problems appear under the following circumstances:

• A 1.x-3.x license file is ftp'd in binary.
• A 4.x-6.x license file is ftp'd in ASCII.
• The license covers a different OpenLink product.
• The license covers a different OpenLink release.
• A machine has more physical CPU cores than allotted for by the license.
• The license can not be found.
• The wrong license is being found.
• You did not perform the appropriate steps to register the license.
• A 6.x+ License Manager process needs to be restarted.
• The license is inadequate for your level of concurrent activity

Troubleshooting Tips

Use the following tips to resolve your licensing tips or supply OpenLink Technical Services with your findings:

• FTP all license files with a .lic extension in binary mode. Use ASCII ftp for .ini files.
• Review the terms of the email that contained the license.
• Compare the product installed on your machine with the product covered by the license key.
• Compare the product version on your machine with the product covered by the license key.
• Identify the number of physical CPU cores on the box that hosts the license and ensure those cores are covered by the license key.
• Use OpenLink's licensing guidelines to ensure that the licens is placed in the appropriate location on the target machine.
• Use the host machine's search utilities to ensure that expired or deprecated license files are removed from the host machine and deleted from the trash.
• Use OpenLink's licensing guidelines to ensure that you have performed the license application procedure using the correct steps in the appropriate order.
• Use the host monitoring utilities to ensure that applicable processes have been restarted as detailed in OpenLink's licensing guidelines.