Applying Floating License

Important Notice for TestEngine Customers

Starting from ReadyAPI 3.62.0, VirtServer 3.29.0, and TestEngine 1.34.0, SmartBear Product Family has fully deprecated file-based licenses and transitioned to the ID-based SmartBear License Management (SLM) system. Any customers still using file-based licenses must complete their migration to SLM by September 30, 2025.

From October 1, 2025, existing and activated file-based licenses will continue to work for some time. However, SmartBear will no longer generate new file-based licenses or support activation and deactivation of file-based licenses in ReadyAPI, VirtServer, or TestEngine. All new and updated licenses are now issued in SLM only.

All technical support for file-based licenses has now ceased, and SmartBear no longer maintains the file-based licensing system. Any access or service issues will result in service disruptions that we will not be able to restore.

If you have not completed the process of migrating, contact your Account Manager or SmartBear representative today. Our teams are ready to assist you with smooth transition strategies. For additional support, log a request with our SmartBear Support.

For further information and timelines, refer to the File-Based License End-of-Support Policy page.

Important

This topic describes how to consume a floating license from Protection! Licensing Server 5 compatible with TestEngine 1.14.0 and later. If you use an earlier version, see Applying Floating Licenses (Legacy).

A floating license allows running TestEngine on different computers, but each license can be used only on one computer at a time. To use a floating license, you must first install and set up a license server from which TestEngine can check out a license.

Requirements

Important

Before checking out a floating license on your machine, you need to install and configure the server on your computer or a local network machine. See Configure License Server 5.x for details.

Your computer must have access to the license server. Make sure the firewalls and proxies in your network do not block access.
If you access the floating license server through a firewall (for example, from a remote server or from home), you will need to open port 443. If needed, ask your system administrator for assistance.

Apply license using Web UI

Install TestEngine and start it.
Open the TestEngine WebUI and log in as an administrator:
```
http://<testengine-host>:<port>/
```
For example, if TestEngine is installed on your local machine, and you run it on the default port, use the following link:
```
http://localhost:8080
```
On the Manage License page, click Add License.
In the Install License dialog, select Floating License from License Server. Enter the hostname or IP of the license server and the port at which the license server is available.
Click Install.
The License tab displays the license information.

Apply license using API

Use the following operation:

POST  http://<testengine-host>:8080/api/v1/license

Example

Use the following command line:

curl -u "admin:password" -d {\"host\":\"10.0.81.16\",\"port\":443} -H "Content-Type: application/json" -X POST "http://localhost:8080/api/v1/license"

In this example:

Create a project by using the TestEngine API definition. See Creating Project From OpenAPI/Swagger Definition to learn how to do that.
Tip
You can also create the needed request from scratch.
Select the POST request to the /api/v1/testjobs/license resource:
Set the Media type to application/json:
Enter the JSON string with the host and port of the license server:
Open the Auth panel.
Select the Basic (Built-in) authorization type.
Tip
If you use the same credentials in several requests, use authorization profiles.
Specify the admin credentials and select the Authenticate pre-emptively option:
Send the request: