NAME¶
simple2zoom - generic Swiss Army Server for proxying between IR standards
SYNOPSIS¶
"simple2zoom" [ "-c"
configFile ] [ "--"
YAZ-options ] [
listener-address ... ]
DESCRIPTION¶
"simple2zoom" provides a generic gateway between the Z39.50 and
SRU/SRW Information Retrieval protocols. Because it relies on the
"Net::Z3950::SimpleServer" and "ZOOM" modules for the
server and client funcationality respectively, because both of these modules
are based on the YAZ toolkit, and because YAZ transparently handles all three
standard IR protocols (ANDI/NISO Z39.50, SRU and SRW), it can function as a
gateway from any and to any of these protocols. However, its principle purpose
is as a Z39.50 server that proxies requests through to a backend by acting as
an SRU client.
The following command-line options govern how the gateway functions:
- -c configFile
- Specifies that the named configFile should be used to configure the
functionality of the gateway: if this option is not specified, then the
file "client.xml" is used. The format of the configuration file
is described separately in "Net::Z3950::Simple2ZOOM::Config",
and a sample configuration file, "test.xml", is supplied in the
"etc" directory of the distribution.
- --
- Indicates the end of "simple2zoom"-specific options. This is
required if YAZ options are to be specified, so that
"simple2zoom" doesn't try to interpret them itself.
- YAZ-options
- Command-line arguments subsequent to the "--" option are
interpreted by the YAZ backend server as described at
http://www.indexdata.dk/yaz/doc/server.invocation.tkl
These options provide the means to control many aspects of the gateway's
functioning: for example, whether the server forks a new process for each
client or runs a single process using "select()"; how (if at
all) to interpret incoming SRU requests; whether and how to log protocol
packets for debugging.
- listener-address
- One or more YAZ-style listener addresses may be specified, and the server
will accept connections on those addresses: for example, @:9998,
"unix:/tmp/somesocket" or "ssl:myhost.com:210". If no
explicit listener addresses are provided, the server listens on port
9999.
SEE ALSO¶
The "Net::Z3950::Simple2ZOOM" module.
The "Net::Z3950::Simple2ZOOM::Config" manual for the
configuration-file format.
The "Net::Z3950::SimpleServer" module.
The "ZOOM" module (in the "Net::Z3950::ZOOM" distribution).
AUTHOR¶
Sebastian Hammer <quinn@miketaylor.org.uk>
Mike Taylor <mike@indexdata.com>
The development of "simple2zoom", and the
"Net::Z3950::Simple2ZOOM" library that provides its functionality,
has been partially sponsored by the National Library of Australia, whose
contribution we gratefully acknowledge.
COPYRIGHT AND LICENCE¶
Copyright (C) 2007 by Index Data.
This library is free software; you can redistribute it and/or modify it under
the same terms as Perl itself, either Perl version 5.8.8 or, at your option,
any later version of Perl 5 you may have available.