Installing a License
Click here to see this page in full context

Landslide Performance Test System – Release 24.3 September 2024

Installing a License

Landslide applications, features, session capacities, activation rates as well as test server types and quantities are controlled by a locally installed license file on the TAS.  

Use the TAS Manager Console or the TAS Manager Web UI when you need to install a system license in order to change the system's capacity or to access new software features. A test system installed for evaluation may contain a license with an expiration date and time. In that case, a warning message displays to notify you of the number of days and hours (with an accuracy of +/- 2 hours) remaining until the expiration when you log in to the system during the last 7 days of the evaluation period. The expiration of the license occurs at midnight of the expiration date. Alternatively, installing a license can be performed by Command Line Interface Commands or the RESTful API - Landslide Home Page  TAS Manager API. 

To install a license using the TAS Manager Console or the TAS Manager Web UI :

  1. Stop the TAS...

  2. Select System > Install License from the TAS Manager Console menu or select TAS Manager Web UI | Actions | Install Licenses, and the License TAS Settings window opens and displays the license files (.sql) available on the TAS. The file name of the system's current license is displayed in the Last License Installed field.

    TIPS:

    • To view a summary of the current license, click the View button. You can view a summary of any Release 2.0 or later license by right-clicking the file and selecting View Details.

    • You can remove old license files by right-clicking the file and selecting Delete.

  3. To upload a new license to the TAS using the TAS Manager Console menu, click Browse and the Load Local TAS License File window opens. Browse to the license file, select it, and click Load to upload the license to the TAS.

  4. To upload a new license to the TAS using the TAS Manager Web UI, click Files | License . Browse the license files that are available for selection, select it and Download Selected license, or click Upload New License to upload a new license file for selection to the TAS. When you select a license file from the list, you can Download Selected license or Delete Selected license from the list. 

  5. Select the license from the available license list and click Install to install the license.

  6. When the installation is complete, you'll see a confirmation message in the console.

  7. Start the TAS...

    TROUBLESHOOT: If the license is not compatible with the TAS software, the TAS will not start and you will see "Failed to start TAS: Not licensed for TAS version <version> TAS startup failed" in the console.

    When you install a license from TAS Manager Console, where the # of test servers (max_ts) is less than the number of test servers provisioned (select count(*) from ts_tbl), you will get a warning.  And you can cancel the install or choose to continue. This will only work with New license Tool Licenses.  

    When you run the TAS and the license has fewer TSs than the TS is provisioned for, the TAS will no longer delete the test servers, instead it will just prevent ALL test servers from reaching the READY state UNTIL you delete enough TSs to meet the license requirements.

    Also note:   The TS Admin will show "NEEDS_LICENSE" for TSs that attempt to register with the TAS.

     

    When you start the TAS you may see this:

    Initializing Test Servers

    ################################################

    There are too many Test Servers, 9 must be removed

    ------------------------------------------------

    ################################################

    Warning:  There are too many Test Servers, 9 must be removed

    Default TS version not specified

    Initializing other TAS services

    Messages in Real-Time Logs and TS Admin, you get this when a TS tries to register:

    Over licensed limit for test server count, delete test servers until within license limit, setting state=NEEDS_LICENSE.

Additional details about licensing can be found in the topic - About Licensing. For TAS to License Server Networking Requirements Click here - Deployment Guidelines.

 

To view license information:

 

License Server Licenses:

On the System Status window, you can view the License Server Status, Last Checkout as well as some additional statuses. 

Auto-Download License - is a mechanism where the TAS can automatically query / retrieve the license from a single location thus removing license file dependency. This option prevents the need to have to manually install a new license on each of the TASs anytime there is an update. Available with License Server licensing on Cloud License Server only.

The following steps must be taken when using an Auto-Download License: 

Initial Install 

To initially setup your TASs, you must install a one time license that basically provides the TAS with the information required to query the License Server for the real license :

1. Customer requests License Server Loaded License from support.

2. Support generates the specific license.

3. Support installs the “real” license on the license server and sends License file to Customer.

4. Customer installs the license on all the TASs.

5. TAS is started, it requests the “real” license from License server, receives response and applies the license.

 

Change / Update a license 

If at a later time, you need to update the license, and deploy it to all the TASs:

1. Customer requests to change their license.

2. Support generates the specific license

3. Support installs the “real” license on the license server and lets’ customer know when complete

4. Customer restarts their TASs (NO LICENSE FILE INSTALLED). TASs will still be using old license until they restart.  

5. TASs are started, it requests the “real” license from License server, receives response and applies the license

 

Install a special license on just one or a few TASs:

1. Customer requests a specific license for one of their TASs, different from the whole system.

2. Support generates the specific license, not License Loaded type.

3. Support returns the file to the customer.

4. Customer installs the special license on one TAS.

5. TAS is started, uses it’s local license and just does a normal checkout from license server.

TAS

The TAS, once it identifies that the installed license indicates an auto-downloaded license from the License Server via the "dkey" license key, will send a license request over HTTPS. The License Server will reply with a encrypted code. 

On TAS startup, you will see messages like this in the tasoutput.txt:

CHECKING LINUX CONFIGURATION
Downloading License: L11811
License successfully downloaded from License Server
Sending License Checkout Requests to 10.71.30.248
TAS will go to Locked state after being disconnected from License Server for 30 minutes
Setting Results ThreadPool to 2
Results Storage Max Size=2.93GiB
Space allocated for other files=46308MiB

And it might be several seconds between them as downloading the license takes some amount of time.

Related Real-Time Log Message:

 

In the TAS manager console, when you do Show License Info, if the TAS downloaded a license you will see the name of the license file that was installed on the TAS to indicate download from license server in the title bar and the contents will be the downloaded license with an indication if the Auto Download was enabled : # Auto Download: Enabled

 

Related Topics

  1. Starting the TAS Manager
  2. System Maintenance Tasks
  3. About the System Status Window

 

© 2024 Spirent Communications Inc. All Rights Reserved.