The QALA License Server

QA Cafe License Application 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.0.3-105.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. 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.0.3-105.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

Firewall

Additional firewall rules will need to be added to allow access to the QALA web interface and license server. CloudShark systems need to access port 5053 in order to check out licenses and run. You will need to open the following ports:

  • 5050/tcp for the web interface
  • 5053/tcp for the license server

If you would like to run the web interface on an alternate port, please use the -listen 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:

QALA login 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:

 

QALA Home 

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.

QALA hostid registration window

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:

QALA home with license

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.