qdsrv |
The licences are kept in the file <qtree>/data/licences.db.
This file is read by qdsrv on initialization or whenever
it is sent the licread message (usually via qdmgt).
qdsrv supports the following licence management requests
and queries:
Message | Interpretation |
licadd keys ... | add new licences
|
licchk sys | return type and number of licences for system sys (see below)
|
licences | same as liclist
|
licget sys | reserve a licence for 5 minutes for user/host on sys
|
lickey | outputs header key used to get new licences
|
liclist | list the current licences and their statuses (see below)
|
licread | reread the licence database
|
licrefresh sys | refresh a licence for another 5 minutes for user/host on sys
|
The output for most of the above is fairly simple, however,
two merit illustration and explanation:
% qdmgt liclist
Header: ab2000118.6
Systems with unlimited licences:
linux2
Supported systems:
sun5
bb0000001: assigned to dt@matt (expires in 273 seconds)
bb0000002: unassigned
bb0000003: unassigned
Demo(1) 2000/06/27: unassigned
The Header entry in the above is the key used to request
new licences.
The "ab" indicates the number of times the database has been
updated in two alpha-digit theatre numbering.
The "2000118" is the date of the initial creation in yyyyjjj form
and the ".6" is the number of licence nodes in the database.
% qdmgt licchk linux2
ab2000118.6 1 3 1
The first field is the database header key.
The three numbers are
- the type of licencing for the requested
system (1 for unlimited, 2 for limited, and 0 for none)
- the number of regular licences, irrespective of system
- the number of demo licences, irrespective of system.
qdmgt |
As illustrated above, qdmgt is used to interface to
the qdsrv to manage licence management requests.
Requests for licences are usually restricted to qef
|
qlicedmp |
qlicedmp may be used to retrieve information about the
current licence database.
For the most part,
qlicedmp just duplicates functionality provided by qdsrv
but can be used when the latter is not running or the version or its
database is suspect.
Note: | qlicedmp will normally examine the <qtree>/data/licences.db
database which might not be the database being used by qdsrv as
it is being run on a remote host with a different <qtree>/data directory.
|
|
qliceadd |
qliceadd is used to add new licences to the licence database.
This is done directly by modifying the licence database or
by using the qdsrv licadd support.
Note: |
As is the case with qlicedmp, qliceadd may
modify a database that is not the same as that being managed
by qdsrv as the latter has a different <qtree>/data directory.
|
Note: |
If qdsrv is running, it should be used to add new licences.
However, if qliceadd to update the file itself, then:
% qdmgt licread
must be run to update the copy of the database internally stored
in the running qdsrv process. |
|
|