The QALA License Server
The QA License Application (or “QALA”) is a Linux-based local license server that customers deploying to Docker or dev/staging/fail-over environments must run independent from their CloudShark system.
This guide explains how to install, configure, and run the QALA service on CentOS 7 Linux.
Downloading QALA
QALA is available by downloading here:
qacafe-qala-1.1-119.x86_64.rpm
Installing QALA
QA Cafe recommends a VM or bare-metal server be configured specifically to run QALA in your environment. This is not able to run inside a Docker container, or on an ephemeral host. It is possible to run on the Docker host however. Some deployment scenarios may require a bare-metal server. Please work with QA Cafe Support on determining the appropriate location to install. For testing and initial staging purposes, you may install it on multiple hosts, however for access to your permanent licenses, it must be installed and locked to a single machine.
Your CloudShark systems must be able to reach QALA over the network. As every customer’s network architecture is different, this is left up to you to ensure works.
Installing via Yum
Use your package manager to install the RPM from the command-line. There are no dependencies, and QALA does not need to connect to the internet.
yum localinstall ./qacafe-qala-1.1-119.x86_64.rpm
Running QALA
QALA ships with systemd configuration scripts, but they are not enabled or started by default. You can start QALA by running:
systemctl enable --now qacafe-qala.service
If you do not have systemd, you should run the following binary in the background to provide license service.
/usr/qacafe/bin/qala serve
Firewall
If you are running a firewall, additional rules will need to be added to allow access to the QALA web interface and license server. The license server binds to a random ephemeral port when it comes up. We recommend permitting access to all TCP ports from your CloudShark systems.
- 5050/tcp for the management web interface
- 5053/tcp for the main license server
- All TCP ephemeral ports for product license checkouts
If you would like to run the web interface on an alternate port, please use the -port CLI argument. If you are not able to use port 5053 for your license server, please contact QA Cafe Support for assistance.
Using QALA
QALA runs by default on HTTPS port 5050. To access it via your web browser, you need to visit https://your-system-ip-address:5050/.
QALA ships with a self-signed certificate that is not able to be changed at this time. Please configure your browser to allow an exception to this site so you are able to visit the web ui.
Upon successful access, you will be presented with the password screen:
The default QALA password is “qacafe”. After logging in, you may change the default password from the menu.
When you log in, you will see the following screen:
Registering your new QALA Server
In order to issue CloudShark licenses for your environment, you will need to register your QALA server with QA Cafe Support. Click on the “Register a new license” button to view the registration information. This takes the form of a hexadecimal Host ID.
Please copy and paste the host ID into an email to support@qacafe.com and our staff will create your permanent QALA license. Once they have fulfilled your request, your license will appear in the QA Cafe Lounge and be available to download.
Installing your new License
Click the “Add License” button and navigate to the new license provided to you via the QA Cafe Customer Lounge.
After uploading the license, verify that the license pool shows it has been added. It should look something like this:
The new license(s) granted by QA Cafe will allow you to run CloudShark in a variety of flexible deployments. Instead of tying CloudShark to a specific host, it can run anywhere that is able to connect to your QALA server to check out a license.
Using QALA from the CLI
If you do not have HTTPS access to port 5050, you can determine your Host-ID and add licenses from the CLI.
$ /usr/qacafe/bin/qala help
The QACafe License App manages and supports licenses for CloudShark.
Usage:
qala [command]
Available Commands:
add Add a license file to the license server
help Help about any command
hostid Display the Host-ID of the machine
reload Reloads the license directory
serve Run the QALA web interface
Flags:
-h, --help help for qala
Use "qala [command] --help" for more information about a command.