Licensing

This guide describes how to update or register a new license for a CloudShark system.

The License File

The license file is a cryptographically signed plain-text file containing the following information:

  • The expiration date of the system's Subscription or Maintenance and Support Agreement (MSA)
  • The list of add-ons that have been purchased and that are enabled
  • The unique Host-ID of the machine the license is locked to
  • The number of user accounts permitted on this system

A valid license must be installed in order to use CloudShark.

CloudShark is node-locked to a single system identified by a unique Host-ID or IP address.

Alternate license deployments

If you are using Docker, have multiple dev/staging instances, or are looking at deploying a fail-over configuration, it may make sense for you to run a stand-alone QALA server. Please contact Support to discuss this option.

 

QALA

The QA Cafe License App ("QALA") must be running on the same VM as your CloudShark installation. You can access it by visiting HTTPS port 5050.

QALA login screen

The default password is "qacafe". This can be changed. If you lose your password, contact us.

Logging in allows you to see the licenses that are available on your system. The license files are available to be downloaded from the QA Cafe Customer Lounge.

Updating your license

When the MSA for a system is renewed, or if additional add-ons are purchased, the license file must be updated for the changes to become effective.

Important!

Beginning with CloudShark 3.9, you do not need to re-install or update your software every time you renew your license. This is a major change from previous versions of CloudShark. Additionally, you do not need a new license each time you upgrade CloudShark to a new version.

 

Upgrade Steps

1. Visit the QA Cafe Customer Lounge and login with your email address.

2. Download the updated license for your system.

3. Login to QALA on https port 5050 on your CloudShark system.

4. Press the "Upload License" button and browse to the file you wish to upload

Note: If you are uploading a new license to replace an old one, you will see the green message box report "license count was unchanged". This means your new license has replaced your old one and nothing is needed further.

Verify the license pool information has your new MSA dates and options.

5. Restart CloudShark for the new license to take effect.

    systemctl restart cloudshark-full

6. Verify the new license is picked by visiting the "Appliance Setup" -> "System Info" page within CloudShark.

 

Registering a new license

Click on the “Register a new license” button to view the registration information. This takes the form of a hexadecimal Host ID.

QALA hostid registration window

 

Copy and paste your Host-ID and email it to Support.  We will reply with your updated license file.

 

Managing licenses from the CLI

If you are running CloudShark 3.9.5 or newer, you can manage you licenses easily from the CLI without needing web access to port 5050. The qala-util command has the following capabilities:

[vagrant@localhost ~]$ /usr/qacafe/bin/qala-util help
QALA Utility v1.0.3

 hostid     Display the hostid of the system
 reload     Reload the license server for any changes to take effect

Determining your Host ID

/usr/qacafe/bin/qala-util hostid

Copying licenses to the server

Licenses should be copied into the directory /usr/qacafe/licenses/. After your license files with a ".lic" extension are there, you need to reload the license server for any changes to be picked up:

cp cloudshark.lic /usr/qacafe/licenses
/usr/qacafe/bin/qala-util reload