Quickstart | QF-Test License Server

This chapter provides short explanations and examples for quickly setting up a typical QF-Test license server. The next two explain the usage of the command line interface in more detail and can be used as a reference.

The last chapter shows you how to administer the license server via the graphical user interface.

Inform Quality First Software GmbH about server data for license generation

Define a dedicated host for the license server and a dedicated port on that machine for this service. Provide this information to Quality First Software GmbH for setting up the license files and make sure that firewalls are configured so that client machines can reach the host under the given name or IP address at the given port (section 2.2).

Install QF-Test

Unpack the QF-Test archive (.tar.gz for Linux or -sfx.exe for Windows) in a convenient location. The directory named qftest is called QF-Test's root directory. It contains a version-specific directory named qftest-x.y.z. QF-Test needs write access to its root directory to store version-independent files there. When upgrading to a newer version, install to the same place in order to reuse those files (section 2.1).

License files

Save the server and client license files named license.server and license, provided by Quality First Software GmbH, to QF-Test's root directory (section 2.2).

Set the license server's password

The default password for the QF-Test license server is secret. It is a good idea to change it before starting the license server for the first time by defining a password for the license server administrator named admin and setting the administrator password by executing

qftest -batch -licenseserver -licenseserver-setpwd <user>=<password>

for <user> admin.

You can always run QF-Test directly from its bin directory by specifying the full path instead of just qftest.

Start the license server

Then you can then run the license server via

qftest -batch -licenseserver

Distribute the client license

Provide the client license file called license to QF-Test users that should get their license from the license server. The file should be saved in QF-Test's root directory on the client.

Measure license usage

Current license usage can be monitored on the server machine or any client machine with a QF-Test installation and the client license. Either start the license server admin GUI described in chapter 4 with

qftest -licenseserver-admin

and login as user admin with the password you defined or dump the current license use to stdout with one of the following commands:

qftest -batch [-licenseserver-password <password>] -licenseserver-dump

qftest -batch [-licenseserver-password <password>] -licenseserver-dumptotal

Save the license server's password

You can omit specifying -licenseserver-password <password> in the above commands by logging in once via the admin GUI and checking "Remember password" or by saving the administrator password for client side use via

qftest -batch -licenseserver-setpwd <user>=<password>

Stop the license server

To stop the license server, either kill its process or run

qftest -batch -licenseserver-shutdown

1 Quickstart