| |
The Eloquence license server may be used to distribute Eloquence
licenses in a network environment. By default licenses are system
specific and do not require a license server.
To use a license server, the eloqld server process is started
on the system designated as a license server system and is
configured with a list of licenses.
Any system using the license server specify the license server
address in their license file instad ot the actual license.
This allows for "floating" licenses where a license is not
necessarily tied to a specific system and to centrally manage
the available licenses.
usage: eloqld [options]
options:
-help = show usage (this list)
-c name = configuration file, default:
/etc/opt/eloquence/8.4/eloqld.cfg
-d flags = debug flags, default:
configuration file [Server] LogFlags
-l name = log file name (or console/syslog/default), default:
configuration file [Server] LogFile
-f = run in foreground
-F facility = syslog facility (USER/DAEMON/LOCAL0..LOCAL7)
-I ident = syslog identifier
-p pid_file = location of PID file (default is none)
The options are:
- -help
- The -help option displays a brief help text.
- -c cfg
- The -c option specifies the eloqld server configuration file name.
If not specified, the default configuration file name depends on OS
platform and Eloquence version.
- -d flags
- The -d option specifies debug flags and may be used to override the
LogFlags setting in the eloqld.cfg configuration file.
- -l logfile
- The -l option may be used to specify a log file, overriding the
LogFile setting in the eloqld.cfg configuration file. The
log files "console" and "syslog" are special and result in log
output to stderr and syslog, respectively.
- -f
- The -f option causes eloqld to run as foreground process. By default,
eloqld detaches from the terminal and runs as a background process.
- -F facility
- The -F option allows to specify a syslog facility, overriding the
SysFacility setting in the eloqld.cfg configuration file.
- -I ident
- The -I option allows to specify a syslog identifier, overriding the
SysIdent setting in the eloqld.cfg configuration file.
- -p pidfile
- The -p option is used to create a PID file.
This option is primarily intended for use by the start/stop script to
manage the eloqld instance.
Before starting the eloqld server process, a server configuration
file (eloqld.cfg) must be set up. A default file is supplied by
the Eloquence installation.
On HP-UX and Linux, the user and group need to be configured
as the server process wont start otherwise.
It may be relevant to specify a password (pool secret) to limit access
to the license server.
The license server maintains an list of licenses, grouped into
different pools (lists), for example groups of test and production
licenses. A license pool (eloqld.pool by default) needs to be
present to start the eloqld process.
The getlic getlic server request may be used to fetch the
licenses associated with a license server.
Alternatively, this can be setup manually.
Licenses in a pool should be equivalent as a client
system currently reserves the next available license from the
specified pool without a particular priority.
Separate pools should be used for different roles.
The license server saves its current status and leased licenses
in a status file. The current status is automatically restored
if the license server is restarted.
The example below starts an eloqld foreground process for troubleshooting,
using a custom configuration file and directing custom level log messages
to the terminal:
$ eloqld -c /tmp/eloqld.cfg -d "*1" -l console -f
S1: Recovery of status file /var/tmp/eloqld.status completed (1/1)
L1: Reading license pool file /etc/opt/eloquence/8.4/eloqld.pool
L1: License expires in 16 days: [beta] 1 1714487092 near line 59
L1: Number of licenses in this file 3
L1: Total number of licenses 3
S1: Eloquence ELOQLD Server initializing
S1: Eloquence ELOQLD Server active
Please note that the above example is not typical.
Typically the eloqld server proces is started starting (or stopped)
with the platform specific methods (eg. systemd on Linux),
the HP-UX eloq84 init script or as a Windows service.
The LogFile is specified in the eloqld.cfg configuration.
eloqld.cfg configuration file
Eloquence license file
Eloquence License server
(B.08.40 release notes).
Eloquence eqlictool utility
(B.08.40 release notes).
|
|
