Name

pazpar2 — Metasearch daemon.

Synopsis

pazpar2 [-d] [-D] [-f config] [-h ip:port] [-l logfile] [-p pidfile] [-t path] [-u uid] [-X]

DESCRIPTION

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.

OPTIONS

-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.

EXAMPLES

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
   

FILES

/usr/sbin/pazpar2: pazpar2 daemon

/usr/share/pazpar2: pazpar2 shared files

/etc/pazpar2: pazpar2 config area

SEE ALSO

Pazpar2 configuration: pazpar2_conf(5)

Pazpar2 protocol: pazpar2_protocol(7)