pazpar2 — Metasearch daemon.
pazpar2 [-d] [-D] [-f ] [config-h ] [ip:port-l ] [logfile-p ] [pidfile-t ] [path-u ] [uid-V] [-X] [-install] [-remove]
pazpar2 is the Pazpar2 Metasearch daemon
and server.
In normal operation it acts as a simple HTTP server which serves
the Pazpar2 protocol.
The HTTP listener address may be given on the command line using
option -h or in the main configuration
file. The main configuration must be specified using option
-f.
-dEnables dump of XML records to the current log file. It is useful if stylesheets are being debugged.
-DPuts the Pazpar2 server in the background.
-f configSpecifies main configuration. This option must be specified in order for Pazpar2 to operate normally.
-h ip:port
Specifies the HTTP listener binding address.
The ip
may be a hostname or @ for "any" address.
The port is an integer.
-l logfileSpecifies log file. The log file must be specified when Pazpar2 is running in the background (-D).
-p pidfileSpecifies PID file. If Pazpar2 is started and configured properly the file given holds the process ID of the Pazpar2 process.
-t path
Specifies a file or directory with alternative settings. This
overrides the settings element in the main
configuration.
-u uid
Makes the Pazpar2 server change user ID to the
uid given.
This, normally, require root privilege.
-VShows Pazpar2 version and versions of some of the components that it is using (ICU and YAZ). Pazpar2 will not exit immediately after displaying the version information (no daemon started).
-XMakes the Pazpar2 server operate in debugging mode. This prevents Pazpar2 from making separate threads and processes. This option should not be used in production.
-installThis is an option which is only recognized on Windows. It installs Pazpar2 as a Windows Service.
Pazpar2 only supports Windows Service options if Pazpar2 is linked against YAZ 3.0.29 or later.
-removeThis is an option which is only recognized on Windows. It removes a Pazpar2 - Windows Service.
The Debian package of pazpar2 starts the server with:
pazpar2 -D -f /etc/pazpar2/pazpar2.cfg -l /var/log/pazpar2.log -p /var/run/pazpar2.pid -u nobody
(one line).
This will put pazpar2 in the background (-D), read config from from
/etc/pazpar2/pazpar2.cfg, log messages to
/var/log/pazpar2.log, create PID file
/var/run/pazpar2.pid. When the daemon is properly
started, the server will change effective user ID to nobody.
The server can be terminated with:
kill `cat /var/run/pazpar2.pid`
If Pazpar2 is to be debugged using GDB, we use option -X:
cd pazpar2/src
gdb ./pazpar2
(gdb) run -X -f ../etc/pazpar2.cfg