When running or debugging a test suite from Ranorex Studio, the License Manager may temporarily allocate a second license seat for the same user session.
This can cause NoSuitableLicense errors for other users, especially in environments where all available license seats are already in use.
Cause
This issue can occur when an outdated RanorexLicenseManager.lic file is present in the solution folder or the project output folder.
The RanorexLicenseManager.lic file contains license configuration information for a specific solution. If this file is outdated, the test execution process may connect to the License Manager with different settings than Ranorex Studio.
As a result, the License Manager cannot match the test execution request to the existing Ranorex Studio license lease and temporarily allocates another seat.
Solution
Option 1: Delete the outdated license configuration file
This is the recommended solution.
- Close Ranorex Studio.
- Open the folder that contains your Ranorex solution file, .rxsln.
- Locate the following file:
RanorexLicenseManager.lic - Delete the file.
- Check the project output folders, such as bin, bin\Debug, or bin\Release.
- If the same file exists in any output folder, delete it there as well.
- Reopen Ranorex Studio.
- Run or debug the test suite again.
After removing the outdated file, the test execution process uses the current global license configuration, which allows the existing license seat to be reused.
Option 2: Regenerate the solution license configuration file
If your project requires a solution-level license configuration file, regenerate it with the current license settings.
- Open Ranorex Studio.
- Open the solution.
- Open Settings.
- On the General tab, click Remove license information.
- Click Include license information.
- Click OK.
- Run the test suite again.
Verify the fix
To confirm that the issue is resolved:
- Open the License Manager UI or review the License Manager log.
- Run a test suite from Ranorex Studio.
- Confirm that the license seat count does not increase when test execution starts.
- Confirm that other users no longer receive NoSuitableLicense errors during test execution.
Contact support
If the issue continues after deleting or regenerating the RanorexLicenseManager.lic file, contact Ranorex Support and include the following information:
- The full License Manager log file.
- The Ranorex Studio version. You can find this under Help > About.
- OS information.
- Whether the License Manager is installed on a standalone server or a Terminal Server.
- The number and type of available license seats.
- Whether the issue affects all users or only specific users or sessions.