Install & License

System Requirement

QUICK is developed with python3 under Linux environment, so it’s only running under Linux, no Windows version currently; While some webapp can be accessed through Windows web-browser, e.g. Micsoft Edge, chrome, firefox, etc.

Before install QUICK, make sure your system has installed python3, version 3.6.x or version 3.8.x are preferred.

QUICK is distributed in pre-compiled binary files, no source code available to customers; However mismatched Linux libc library versions may cause problem when user running softwares, so customer need provide his Linux libc version so that Vendor can compile with a correct libc version for the release;

To get the libc version information, run below command on your system:

$> ldd --version

Installation

QUICK is released with a zipped tar-ball, customer just need to untar it to a public place in your system, so that everyone can see it and run it;

If you want to use PDM tool of QUICK, you need to run below step, otherwise you can skip this step:

$> sudo chown root:root bin/vobtool
$> sudo chmod 6555 bin/vobtool

Note

To avoid frequently use root, it’s better that a particular group is assigned to this software, i.e. qkadmin, for afterwards maintenance and configuration.

Upgrade

QUICK is still under development, and the upgraded releases will be delivered to customers from time to time;

QUICK uses some python extension libraries, these libraries will be included in the release, so customers don’t have to install them by themselves; You can find them under directory: $QKHOME/extlib; The extlib is downloaded from official python community pypi.org, and they are quite stable and no need update frequently; Normally when there is a QUICK update, Vendor will not update extlib, customer can link it to the directory of old version QUICK;

QUICK can be configured according to customer’s environment, and config files are under directory: $QKHOME/conf; Normally the configuration is stable and all versions of QUICK shares the same config files, so customer can link this to the old version one;

License

QUICK is under license control, without license it cannot be running up, and give warning message like below when you try to run it:

[WARN] You don't have [quick] license, or the license server is not running up.

To get License from Vendor, a fixed license server need to be chosen and the server’s hardware identification information need to be collected and sent to the Vendor, and the Vendor will generate license serial string based on the hardware information.

Below commands need to run on the license server and redirect the output to a txt file, and then sent to the Vendor:

$> lscpu    > hw.txt
$> lsmem   >> hw.txt
$> lspci   >> hw.txt
$> lshw    >> hw.txt
$> ip addr >> hw.txt
$> ldd --version >> hw.txt

After the Vendor sent back the license file: license.ini, please copy it to: conf/license.ini and override the old one. Then run below command to verify the license is OK or not:

$> sudo bin/licserver -c quick

If the license is OK, you will see:

License is OK for: quick, till end of xx/xx;

Otherwise you will see:

No license for: quick;

Note

You can also use this command to check when the license expires;

To start the license service-program, run below command:

$> sudo bin/licserver -D

When there is a renew of license, you need to overwrite the license file: conf/license.ini with the new one, and stop the old service-program, and restart it:

$> ps -ef |grep licserver
$> sudo kill -9 <pid>
$> sudo bin/licserver -D