To use TestEngine, you need to have a license. This topic explains how to activate a fixed license.

Using Web UI

Install TestEngine and start it.
Open the TestEngine web interface 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
TestEngine will open the License tab of the Admin panel. Click Add License:

Click the image to enlarge it.
In the subsequent dialog, select License from File, click Browse, and specify the TestEngine license file (.zip or .key file):

Click the image to enlarge it.
Fill in the form fields and click Install:

Click the image to enlarge it.
The License tab will show information on the license:

Click the image to enlarge it.

Using API

Use the following operation:

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

Authentication

The request must be authenticated by a TestEngine administrator.

Content type

multipart/form-data

Body

The body must include two parts:

file: the license file in the .zip or .key format.

activationInfo: the license activation info in the JSON format. The JSON string can include the following properties:
- firstName (required)
- lastName (required)
- email (required)
- company
- address
- city
- zipCode
- state
- country
- phone

Authentication

The request must be authenticated by a TestEngine administrator.

Use the following command line:

curl -u "admin:password" -F file=@"C:\Work\TestEngine\license.zip" -F activationInfo={\"firstName\":\"Jeanne\",\"lastName\":\"Desthieux\",\"email\":\"[email protected]\"};type=application/json "http://localhost:8080/api/v1/license"

In this example:

-u admin:password

Authenticates the request by using the admin’s credentials.

-F file=@"C:\Work\TestEngine\license.zip"

The license file.

-F activationInfo={\"firstName\":\"Jeanne\",\"lastName\":\"Desthieux\",\"email\":\"[email protected]\"};type=application/json

The activation info in the JSON format.

"http://localhost:8080/api/v1/license"

The endpoint of the request.

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/license resource:

Click the image to enlarge it.
Set the Media type to multipart/form-data:

Click the image to enlarge it.
Open the Attachment panel and click Add Attachment:

Click the image to enlarge it.
Specify the license file.
Set the ContentID of the attachment to file:

Click the image to enlarge it.
Create a .json file with the activation info and add it as an attachment as well:

Click the image to enlarge it.
Change the Content type of the .json attachment to application/json, and its ContentID to activationInfo:

Click the image to enlarge it.
Open the Auth panel.
Select the Basic (Built-in) authorization type.

Tip: If you use the same credentials in several request, use authorization profiles.
Specify the user credentials and select the Authenticate pre-emptively option:

Click the image to enlarge it.
Send the request:

Click the image to enlarge it.
If the operation was successful, you will receive license information in the response:

The address and port of your TestEngine installation.

Activating TestEngine License

Using Web UI

Using API

Example

See Also