z2folio - Z39.50 server for FOLIO bibliographic data
z2folio [ -c configBase ] [ -- YAZ-options ] [ listener-address ... ]
z2folio
-c
--
z2folio provides a Z39.50 server for bibliographic data in the FOLIO ILS. Because it relies on the Net::Z3950::SimpleServer modules for the server functionality, because this module is based on the YAZ toolkit, and because YAZ transparently handles all three standard IR protocols (ANSI/NISO Z39.50, SRU and SRW), it can function as a server for all three of these protocols.
Net::Z3950::SimpleServer
The following command-line options govern how it functions:
-c configBase
Specifies that the named configBase.json should be used as the base configuration for the functionality of the server: if this option is not specified, then the file config.json in the working directory is used. The format of the configuration file is described separately in Net::Z3950::FOLIO::Config, and a sample configuration file, config.json, is supplied in the etc directory of the distribution.
configBase.json
config.json
Net::Z3950::FOLIO::Config
etc
Indicates the end of z2folio-specific options. This is required if YAZ options are to be specified, so that z2folio doesn't try to interpret them itself.
Command-line arguments subsequent to the -- option are interpreted by the YAZ backend server as described at https://software.indexdata.com/yaz/doc/server.invocation.html
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.
select()
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.
@:9998
unix:/tmp/somesocket
ssl:myhost.com:210
Net::Z3950::FOLIO
Mike Taylor, <mike@indexdata.com>
Copyright (C) 2018 The Open Library Foundation
This software is distributed under the terms of the Apache License, Version 2.0. See the file "LICENSE" for more information.
To install Net::Z3950::FOLIO, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Net::Z3950::FOLIO
CPAN shell
perl -MCPAN -e shell install Net::Z3950::FOLIO
For more information on module installation, please visit the detailed CPAN module installation guide.