pazpar2 — Metasearch daemon.
pazpar2
[-d
] [-D
] [-f
] [config
-h
] [ip:port
-l
] [logfile
-p
] [pidfile
-t
] [path
-u
] [uid
-X
]
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
.
-d
Enables dump of XML records to the current log file. It is useful if stylesheets are being debugged.
-D
Puts the Pazpar2 server in the background.
-f config
Specifies 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 logfile
Specifies log file. The log file must be specified when Pazpar2 is running in the background (-D).
-p pidfile
Specifies 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.
-X
Makes the Pazpar2 server operate in debugging mode. This prevents Pazpar2 from making separate threads and processes. This option should not be used in production.
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