2 The License Server Daemon

2.4 Installation and use

You can run hqn_lsd explicitly just by typing its name at the UNIX prompt, as you would any other executable. Remember to add the appropriate platform suffix (see Section 2.1 on page 7). To run hqn_lsd automatically whenever your machine is rebooted, you need to add an entry to the file /etc/rc.local, (or the equivalent file for your system) such as the following:

# Harlequin License Server Daemon
#
# Version 2.0 for MLWorks
#
if [ -f /usr/local/bin/hqn_lsd ] ; then
  /usr/local/bin/hqn_lsd-<platform> -d -p /usr/local/lib/HQN &
  echo -n ' hqn_lsd-<platform>'
fi

In this example, the appropriate hqn_lsd program for the platform is run with two flags set:

-d: Outputs diagnostic information as permit files are read.
-p: Specifies a directory in which to look for permit files. If this option is not used, hqn_lsd looks in a number of standard places, described below.

For full details of the flags available, please refer to the UNIX manual page for hqn_lsd.

If required, all license transactions can be logged via the standard syslog daemon services. See Section Section 2.3.3 on page 12 for details.

When hqn_lsd starts up, or is reinitialized via hqn_lsa -reinit (see Chapter 3 for details of this option), it looks for permit files that match the regular expression

.*hqn.permit[0-9]*$

That is, any string, followed by the string hqn.permit, and possibly followed by a number. For example, hqn.permit, hqn.permit1, MLWorks-hqn.permit, all match this pattern.

The directories that hqn_lsd searches for permits can be specified by one of the following methods.

The first is to supply the -p option on hqn_lsd's command line, as in the example above. This option takes a colon-separated list of pathnames to search. If you do not use the -p option, or no permit files are found in the directories specified using it, hqn_lsd consults value of the environment variable HQNPERMITPATH, also a colon-separated list of search paths. If the variable has no value, or no permit files are found using it, the following directories are searched in order:

: 1. hqn_lsd's current working directory
: 2. /usr/local/HQN
: 3. /usr/local

The order in which the permit files are read is determined by their order within the directory (that is the order shown by ls -f).

hqn_lsa -sinfo shows what permit files have been read and in what order. If no permits are found, hqn_lsd remains idle until given further instructions, for instance by using hqn_lsa -reinit to re-initialize it.

For any permit file for which hqn_lsd's host is its entire server domain, hqn_lsd will now serve licenses for the products listed in the permit file. For multiple-host server domains (see Section 2.2.1 on page 8), at least n/2 (rounded up) daemons must be started before any licenses will be served, where n is the number of hosts in the server domain.

If any errors are detected in a permit file (such as an incorrect lock string), hqn_lsd discards the rest of the file and issues error messages to the system log and standard error. The cause and position of the error can also be found with hqn_lsa -sinfo.

MLWorks Guide to the License Server - 17 JAN 1997

Generated with Harlequin WebMaker