X-Git-Url: http://lists.indexdata.dk/cgi-bin?a=blobdiff_plain;f=doc%2Fpazpar2_conf.xml;h=4e820224690b97d677e9b2dc9cac81ccb4cea552;hb=f3f81f2a91aa590cf5ab931bb23f25048b413b7c;hp=c61a73e1d4a2cd3c55ee8a87c54200aa283b4510;hpb=14074ecf20d86518ccedc0c9617a49949ec19779;p=pazpar2-moved-to-github.git
diff --git a/doc/pazpar2_conf.xml b/doc/pazpar2_conf.xml
index c61a73e..4e82022 100644
--- a/doc/pazpar2_conf.xml
+++ b/doc/pazpar2_conf.xml
@@ -73,6 +73,16 @@
in main thread).
+
+ file
+
+ This configuration takes one attribute path which
+ specifies a path to search for local files, such as XSLTs and settings.
+ The path is a colon separated list of directories. Its default value
+ is "." which is equivalent to the location of the
+ main configuration file (where indeed the file element is given).
+
+ server
@@ -606,7 +616,7 @@
-
+ rank
@@ -774,6 +784,7 @@
+
@@ -1102,180 +1113,103 @@
+
- pz:cclmap:xxx
-
-
- This establishes a CCL field definition or other setting, for
- the purpose of mapping end-user queries. XXX is the field or
- setting name, and the value of the setting provides parameters
- (e.g. parameters to send to the server, etc.). Please consult
- the YAZ manual for a full overview of the many capabilities of
- the powerful and flexible CCL parser.
-
-
- Note that it is easy to establish a set of default parameters,
- and then override them individually for a given target.
-
-
-
-
- pz:requestsyntax
-
-
- This specifies the record syntax to use when requesting
- records from a given server. The value can be a symbolic name like
- marc21 or xml, or it can be a Z39.50-style dot-separated OID.
-
-
-
-
- pz:elements
+ pz:allow
- The element set name to be used when retrieving records from a
- server.
+ Allows or denies access to the resources it is applied to. Possible
+ values are '0' and '1'.
+ The default is '1' (allow access to this resource).
+
- pz:piggyback
+ pz:apdulog
- Piggybacking enables the server to retrieve records from the
- server as part of the search response in Z39.50. Almost all
- servers support this (or fail it gracefully), but a few
- servers will produce undesirable results.
- Set to '1' to enable piggybacking, '0' to disable it. Default
- is 1 (piggybacking enabled).
+ If the 'pz:apdulog' setting is defined and has other value than 0,
+ then Z39.50 APDUs are written to the log.
+
- pz:nativesyntax
+ pz:authentication
- Specifies how Pazpar2 shoule map retrieved records to XML. Currently
- supported values are xml,
- iso2709 and txml.
-
-
- The value iso2709 makes Pazpar2 convert retrieved
- MARC records to MARCXML. In order to convert to XML, the exact
- chacater set of the MARC must be known (if not, the resulting
- XML is probably not well-formed). The character set may be
- specified by adding:
- ;charset=charset to
- iso2709. If omitted, a charset of
- MARC-8 is assumed. This is correct for most MARC21/USMARC records.
-
-
- The value txml is like iso2709
- except that records are converted to TurboMARC instead of MARCXML.
+ Sets an authentication string for a given database. For Z39.50,
+ this is carried as part of the Initialize Request. In order to carry
+ the information in the "open" elements, separate
+ username and password with a slash (In Z39.50 it is a VisibleString).
+ In order to carry the information in the idPass elements, separate
+ username term, password term and, optionally, a group term with a
+ single blank.
+ If three terms are given, the order is
+ user, group, password.
+ If only two terms are given, the order is
+ user, password.
- The value xml is used if Pazpar2 retrieves
- records that are already XML (no conversion takes place).
+ For HTTP based procotols, such as SRU and Solr, the authentication
+ string includes a username term and, optionally, a password term.
+ Each term is separated by a single blank. The
+ authentication information is passed either by HTTP basic
+ authentication or via URL parameters. The mode is operation is
+ determined by pz:authentication_mode setting.
- pz:queryencoding
+ pz:authentication_mode
- The encoding of the search terms that a target accepts. Most
- targets do not honor UTF-8 in which case this needs to be specified.
- Each term in a query will be converted if this setting is given.
+ Determines how authentication is carried in HTTP based protocols.
+ Value may be "basic" or "url".
- pz:negotiation_charset
+ pz:block_timeout
- Sets character set for Z39.50 negotiation. Most targets do not support
- this, and some will even close connection if set (crash on server
- side or similar). If set, you probably want to set it to
- UTF-8.
+ (Not yet implemented).
+ Specifies the time for which a block should be released anyway.
- pz:xslt
-
-
- Is a comma separated list of of stylesheet names that specifies
- how to convert incoming records to the internal representation.
-
-
- For each name, the embedded stylesheets (XSL) that comes with the
- service definition are consulted first and takes precedence over
- external files; see
- of service definition).
- If the name does not match an embedded stylesheet it is
- considered a filename.
-
-
- The suffix of each file specifies the kind of tranformation.
- Suffix ".xsl" makes an XSL transform. Suffix
- ".mmap" will use the MMAP transform (described below).
-
-
- The special value "auto" will use a file
- which is the pz:requestsyntax's
- value followed by
- '.xsl'.
-
-
- When mapping MARC records, XSLT can be bypassed for increased
- performance with the alternate "MARC map" format. Provide the
- path of a file with extension ".mmap" containing on each line:
-
- <field> <subfield> <metadata element>
- For example:
-
- 245 a title
- 500 $ description
- 773 * citation
-
- To map the field value specify a subfield of '$'. To store a
- concatenation of all subfields, specify a subfield of '*'.
-
-
-
-
- pz:authentication
+ pz:cclmap:xxx
- Sets an authentication string for a given server. See the section on
- authorization and authentication for discussion.
+ This establishes a CCL field definition or other setting, for
+ the purpose of mapping end-user queries. XXX is the field or
+ setting name, and the value of the setting provides parameters
+ (e.g. parameters to send to the server, etc.). Please consult
+ the YAZ manual for a full overview of the many capabilities of
+ the powerful and flexible CCL parser.
-
-
-
- pz:allow
-
- Allows or denies access to the resources it is applied to. Possible
- values are '0' and '1'.
- The default is '1' (allow access to this resource).
- See the manual section on authorization and authentication for
- discussion about how to use this setting.
+ Note that it is easy to establish a set of default parameters,
+ and then override them individually for a given target.
+
- pz:maxrecs
+ pz:elements
- Controls the maximum number of records to be retrieved from a
- server. The default is 100.
+ The element set name to be used when retrieving records from a
+ server.
+
pz:extendrecs
@@ -1296,15 +1230,24 @@
+
- pz:presentchunk
+ pz:facetmap:name
- Controls the chunk size in present requests. Pazpar2 will
- make (maxrecs / chunk) request(s). The default is 20.
+ Specifies that for field name, the target
+ supports (native) facets. The value is the name of the
+ field on the target.
+
+
+ At this point only Solr targets have been tested with this
+ facility.
+
+
+
pz:id
@@ -1316,60 +1259,143 @@
+
+
+ pz:limitmap:name
+
+
+ Specifies attributes for limiting a search to a field - using
+ the limit parameter for search. It can be used to filter locally
+ or remotely (search in a target). In some cases the mapping of
+ a field to a value is identical to an existing cclmap field; in
+ other cases the field must be specified in a different way - for
+ example to match a complete field (rather than parts of a subfield).
+
+
+ The value of limitmap may have one of three forms: referral to
+ an existing CCL field, a raw PQF string or a local limit. Leading string
+ determines type; either ccl: for CCL field,
+ rpn: for PQF/RPN, or local:
+ for filtering in Pazpar2. The local filtering may be followed
+ by a field a metadata field (default is to use the name of the
+ limitmap itself).
+
+
+ For Pazpar2 version 1.6.23 and later the limitmap may include multiple
+ specifications, separated by , (comma).
+ For example:
+ ccl:title,local:ltitle,rpn:@attr 1=4.
+
+
+
+ The limitmap facility is supported for Pazpar2 version 1.6.0.
+ Local filtering is supported in Pazpar2 1.6.6.
+
+
+
+
+
- pz:zproxy
+ pz:maxrecs
- The 'pz:zproxy' setting has the value syntax
- 'host.internet.adress:port', it is used to tunnel Z39.50
- requests through the named Z39.50 proxy.
+ Controls the maximum number of records to be retrieved from a
+ server. The default is 100.
- pz:apdulog
+ pz:memcached
- If the 'pz:apdulog' setting is defined and has other value than 0,
- then Z39.50 APDUs are written to the log.
+ If set and non-empty,
+ libMemcached will
+ configured and enabled for the target.
+ The value of this setting is same as the ZOOM option
+ memcached, which in turn is the configuration
+ string passed to the memcached function
+ of libMemcached.
+
+
+ This setting is honored in Pazpar2 1.6.39 or later. Pazpar2 must
+ be using YAZ version 5.0.13 or later.
- pz:sru
+ pz:redis
- This setting enables
- SRU/Solr
- support.
- It has four possible settings.
- 'get', enables SRU access through GET requests. 'post' enables SRU/POST
- support, less commonly supported, but useful if very large requests are
- to be submitted. 'soap' enables the SRW (SRU over SOAP) variation of
- the protocol.
+ If set and non-empty,
+ redis will
+ configured and enabled for the target.
+ The value of this setting is exactly as the redis option for
+ ZOOM C of YAZ.
- A value of 'solr' enables Solr client support. This is supported
- for Pazpar version 1.5.0 and later.
+ This setting is honored in Pazpar2 1.6.43 or later. Pazpar2 must
+ be using YAZ version 5.2.0 or later.
- pz:sru_version
+ pz:nativesyntax
- This allows SRU version to be specified. If unset Pazpar2
- will the default of YAZ (currently 1.2). Should be set
- to 1.1 or 1.2. For Solr, the current supported/tested version
- is 1.4 and 3.x.
+ Specifies how Pazpar2 shoule map retrieved records to XML. Currently
+ supported values are xml,
+ iso2709 and txml.
+
+
+ The value iso2709 makes Pazpar2 convert retrieved
+ MARC records to MARCXML. In order to convert to XML, the exact
+ chacater set of the MARC must be known (if not, the resulting
+ XML is probably not well-formed). The character set may be
+ specified by adding:
+ ;charset to
+ iso2709. If omitted, a charset of
+ MARC-8 is assumed. This is correct for most MARC21/USMARC records.
+
+
+ The value txml is like iso2709
+ except that records are converted to TurboMARC instead of MARCXML.
+
+
+ The value xml is used if Pazpar2 retrieves
+ records that are already XML (no conversion takes place).
+
+
+
+
+
+ pz:negotiation_charset
+
+
+ Sets character set for Z39.50 negotiation. Most targets do not support
+ this, and some will even close connection if set (crash on server
+ side or similar). If set, you probably want to set it to
+ UTF-8.
+ pz:piggyback
+
+
+ Piggybacking enables the server to retrieve records from the
+ server as part of the search response in Z39.50. Almost all
+ servers support this (or fail it gracefully), but a few
+ servers will produce undesirable results.
+ Set to '1' to enable piggybacking, '0' to disable it. Default
+ is 1 (piggybacking enabled).
+
+
+
+ pz:pqf_prefix
@@ -1412,11 +1438,35 @@
- pz:sort
+ pz:preferred
- Specifies sort criteria to be applied to the result set.
- Only works for targets which support the sort service.
+ Specifies that a target is preferred, e.g. possible local, faster
+ target. Using block=pref on show command will wait for all these
+ targets to return records before releasing the block.
+ If no target is preferred, the block=pref will identical to block=1,
+ which release when one target has returned records.
+
+
+
+
+
+ pz:presentchunk
+
+
+ Controls the chunk size in present requests. Pazpar2 will
+ make (maxrecs / chunk) request(s). The default is 20.
+
+
+
+
+
+ pz:queryencoding
+
+
+ The encoding of the search terms that a target accepts. Most
+ targets do not honor UTF-8 in which case this needs to be specified.
+ Each term in a query will be converted if this setting is given.
@@ -1437,27 +1487,80 @@
+
+ pz:requestsyntax
+
+
+ This specifies the record syntax to use when requesting
+ records from a given server. The value can be a symbolic name like
+ marc21 or xml, or it can be a Z39.50-style dot-separated OID.
+
+
+
+
- pz:preferred
+ pz:sort
- Specifies that a target is preferred, e.g. possible local, faster
- target. Using block=pref on show command will wait for all these
- targets to return records before releasing the block.
- If no target is preferred, the block=pref will identical to block=1,
- which release when one target has returned records.
+ Specifies sort criteria to be applied to the result set.
+ Only works for targets which support the sort service.
+
+
+
+
+
+ pz:sortmap:field
+
+
+ Specifies native sorting for a target where
+ field is a sort criterion (see command
+ show). The value has two components separated by a colon: strategy and
+ native-field. Strategy is one of z3950,
+ type7, cql,
+ sru11, or embed.
+ The second component, native-field, is the field that is recognized
+ by the target.
+
+
+ Only supported for Pazpar2 1.6.4 and later.
+
+
+
- pz:block_timeout
+ pz:sru
- (Not yet implemented).
- Specifies the time for which a block should be released anyway.
+ This setting enables
+ SRU/Solr
+ support.
+ It has four possible settings.
+ 'get', enables SRU access through GET requests. 'post' enables SRU/POST
+ support, less commonly supported, but useful if very large requests are
+ to be submitted. 'soap' enables the SRW (SRU over SOAP) variation of
+ the protocol.
+
+
+ A value of 'solr' enables Solr client support. This is supported
+ for Pazpar version 1.5.0 and later.
+
+
+
+
+
+ pz:sru_version
+
+
+ This allows SRU version to be specified. If unset Pazpar2
+ will the default of YAZ (currently 1.2). Should be set
+ to 1.1 or 1.2. For Solr, the current supported/tested version
+ is 1.4 and 3.x.
+
pz:termlist_term_count
@@ -1467,6 +1570,7 @@
+
pz:termlist_term_factor
@@ -1485,96 +1589,77 @@
-
- pz:facetmap:name
+
+ pz:url
- Specifies that for field name, the target
- supports (native) facets. The value is the name of the
- field on the target.
+ Specifies URL for the target and overrides the target ID.
- At this point only Solr targets have been tested with this
- facility.
+ pz:url is only recognized for
+ Pazpar2 1.6.4 and later.
-
- pz:limitmap:name
+
+ pz:xslt
- Specifies attributes for limiting a search to a field - using
- the limit parameter for search. It can be used to filter locally
- or remotely (search in a target). In some cases the mapping of
- a field to a value is identical to an existing cclmap field; in
- other cases the field must be specified in a different way - for
- example to match a complete field (rather than parts of a subfield).
+ Is a comma separated list of of stylesheet names that specifies
+ how to convert incoming records to the internal representation.
- The value of limitmap may have one of three forms: referral to
- an existing CCL field, a raw PQF string or a local limit. Leading string
- determines type; either ccl: for CCL field,
- rpn: for PQF/RPN, or local:
- for filtering in Pazpar2. The local filtering may be followed
- by a field a metadata field (default is to use the name of the
- limitmap itself).
+ For each name, the embedded stylesheets (XSL) that comes with the
+ service definition are consulted first and takes precedence over
+ external files; see
+ of service definition).
+ If the name does not match an embedded stylesheet it is
+ considered a filename.
- For Pazpar2 version 1.6.23 and later the limitmap may include multiple
- specifications, separated by , (comma).
- For example:
- ccl:title,local:ltitle,rpn:@attr 1=4.
+ The suffix of each file specifies the kind of tranformation.
+ Suffix ".xsl" makes an XSL transform. Suffix
+ ".mmap" will use the MMAP transform (described below).
-
-
- The limitmap facility is supported for Pazpar2 version 1.6.0.
- Local filtering is supported in Pazpar2 1.6.6.
-
-
-
-
-
-
- pz:url
-
- Specifies URL for the target and overrides the target ID.
+ The special value "auto" will use a file
+ which is the pz:requestsyntax's
+ value followed by
+ '.xsl'.
+
+
+ When mapping MARC records, XSLT can be bypassed for increased
+ performance with the alternate "MARC map" format. Provide the
+ path of a file with extension ".mmap" containing on each line:
+
+ <field> <subfield> <metadata element>
+ For example:
+
+ 245 a title
+ 500 $ description
+ 773 * citation
+
+ To map the field value specify a subfield of '$'. To store a
+ concatenation of all subfields, specify a subfield of '*'.
-
-
- pz:url is only recognized for
- Pazpar2 1.6.4 and later.
-
-
-
- pz:sortmap:field
+
+ pz:zproxy
- Specifies native sorting for a target where
- field is a sort criteria (see command
- show). The value has to components separated by colon: strategy and
- native-field. Strategy is one of z3950,
- type7, cql,
- sru11, or embed.
- The second component, native-field, is the field that is recognized
- by the target.
+ The 'pz:zproxy' setting has the value syntax
+ 'host.internet.adress:port', it is used to tunnel Z39.50
+ requests through the named Z39.50 proxy.
-
-
- Only supported for Pazpar2 1.6.4 and later.
-
-
-