Manage licenses with the command line

Consume and verify the statuses of seat or concurrent licenses directly from the command line. Installing licenses requires administrator permissions.

Run the License Installer from the command line

Run the License Installer, LicenseInstall.exe, as follows:

"<UFT One or UFT Developer installation directory>\bin\HP.UFT.LicenseInstall.exe"

Append the relevant command and set of parameters described below:

Back to top

Define seat licenses with the command line

Define seat licenses in the command line by running the License Installer and appending the following:

seat "<license key string>"

For example:

"C:\Program Files (x86)\Micro Focus\UFT One\bin\HP.UFT.LicenseInstall.exe" seat "<key> \" Micro Focus UFT One"

Note:

  • If the license key contains a quotation mark character (") in the license key string, add a backslash character (\) before the quotation mark.

  • If the license key file is saved locally, run the License Installer, appending the following code and wrapping the path to the license key file in quotes:

    seat "<path to the license key file>"

    For example:

    "C:\Program Files (x86)\Micro Focus\UFT One\bin\HP.UFT.LicenseInstall.exe" seat "Downloads\UFT-licfile.dat"

For more details, see Seat licenses.

Back to top

Consume concurrent licenses with the command line

These steps configure UFT One to consume concurrent licenses installed on the AutoPass License Server.

Verify available licenses on the AutoPass License Server

Run the License Installer, appending the following command:

licenses <server name/address>:<port> [/tenantid:"xx" /tenanttoken:"xx"]

For example:

"C:\Program Files (x86)\Micro Focus\UFT One\bin\HP.UFT.LicenseInstall.exe" licenses 11.11.111.111:5814 /tenantid:"tenant1" /tenanttoken:"6wxTn89A6BSr04c+nPYstA=="

Note: tenantid and tenanttoken are supported in UFT One version 2022 and later. They are required only when you verify available licenses on a multi-tenant License Server.

The available licenses are displayed by unique ID and version.

Consume a concurrent license

  1. Run the License Installer to verify which licenses are available on the AutoPass License Server, as described above.

    The available licenses are displayed by unique ID and version.

  2. Run the License Installer again, this time appending the following command and parameters:

    concurrent <license ID> <license version> <server address>:<port> [/tenantid:"xx" /tenanttoken:"xx"] [/force]

    For example:

    "C:\Program Files (x86)\Micro Focus\UFT One\bin\HP.UFT.LicenseInstall.exe" concurrent 10594 1 11.11.111.111:5814 /tenantid:"tenant1" /tenanttoken:"6wxTn89A6BSr04c+nPYstA=="

    address

    The address format must be identical to the one used in the Main tab of the AutoPass License Server Configuration pane.

    For details, see the AutoPass License Server online documentation.
    port

    Optional.

    The Default port for the primary and secondary servers is 5814.

    tenantid

    (UFT One version 2022 and later)

    The ID of an AutoPass License Server tenant.

    This is required only when your License Server has enabled multi-tenancy.

    tenanttoken

    (UFT One version 2022 and later)

    The token assigned to the tenant.

    This is required only when your License Server has enabled multi-tenancy.

    /force

    Optional.

    /force saves the license installation information even if the current installation fails. In subsequent sessions, UFT One or UFT Developer will check the listed license server for the listed license.

Modify server connection protocol

Run the License Installer, appending:

config protocol.primary <protocol>

where <protocol> is http or https as needed.

Back to top

See also: