Install and manage licenses
This page shows you how to install Test Services licenses and manage how they are used. Some Test Services tests run without a license, while others need a license to run. You install licenses in the Control Panel, the same way you install other OpenLab CDS licenses. This page is for the administrator who manages licenses for a site.
You do not need a license to log in, to run the OpenLab Software Installation Verification Test (SVT), System Report, or Connectivity Test, or to view results from earlier test runs. You need a license to run these tests:
- OpenLab Security Test and OpenLab Storage System Test. Both use the
QlaSecuritylicense. OneQlaSecuritylicense covers both tests. - Workflow Test. Uses the
QlaCDSWorkflowlicense.
For the full license reference, see Licensing. For the model behind license acquisition, see About licensing.
Prerequisites
- You must have administrator rights in the Control Panel to install licenses.
- For the newer Licensing 2.0 electronic licensing system, you need the electronic license entitlement for the licensed tests you want to run. For SubscribeNet licensing, you need the Test Services license file.
- Each machine that runs a licensed test must have one license available to it.
All applicable Test Services licenses are included with OpenLab CDS Workstation Plus. For all other OpenLab CDS products, you purchase and install Test Services licenses separately. The OpenLab CDS 60-day startup license does not enable the licensed Test Services tests.
Install or activate a license
Test Services supports licenses from the newer Licensing 2.0 electronic licensing system and SubscribeNet license files. You manage both license types from the Control Panel before you run a licensed test.
-
Open the Control Panel.
-
Navigate to Administration > Licenses.
-
Activate the electronic license for Licensing 2.0, or add the Test Services license file obtained through SubscribeNet.
The new license becomes available to the licensed tests on machines that can reach the license server.
-
If you do not have enough licenses for the machines that run licensed tests, contact Agilent support to obtain more.
Plan how many licenses you need
A machine acquires a license checkout the first time it runs a licensed test and holds it for the lifetime of the Test Services service process. The checkout is released when the Test Services service stops or restarts gracefully. A normal machine restart also stops the service gracefully. Plan for one license per machine that runs licensed tests at the same time. For how acquisition works, see About licensing.
When a license is not available
If no license is available when a licensed test runs, the test stops early so that you know to add a license.
The test fails at the Checking for license step and reports the missing license by name. The individual test result is Not available, and the Summary report result is Failed. Your earlier Test Services results stay viewable. To resolve the failure, install or free a license, then run the test again. See Install or activate a license.
Release checked-out licenses
Test Services holds a license checkout for the lifetime of its service process. To release the checkout, stop or restart the Agilent Test Services service gracefully. A normal machine restart also stops the service gracefully. The released license is then available for another client or AIC.
If Test Services or the machine stops unexpectedly, the license server automatically reclaims the checkout after its timeout period. See the documentation for your OpenLab licensing system for information about license checkout recovery times.
Releasing a checkout does not deactivate or move the electronic license entitlement installed on the OpenLab Shared Services licensing server.
See also
- Licensing: which tests need which license, and the license feature names.
- About licensing: how Test Services acquires and holds licenses.
- Install Test Services: install Test Services before you install licenses.
- Run verification tests: start a licensed test once a license is installed.
- Results not passed: diagnose a test that stops at the license step.
Last updated: