3 Revert the behavior of returning errors when unable to block
4 on termlist, bytarget and search, when unable to block due to
5 other block. The client will now receive a regular response,
6 but it will be logged in the server. A parameter (report) is
7 added to change behavior to return error response or WARNING
8 status message. Consider this "API" as private, as it is mostly
9 untested and could be changed in future releases.
11 Fix spell error in pz2.js fix in 1.6.10.
13 New Marc2TurboMarc.xsl (contribution from Sven Porst).
14 Can solve the missing marc21.xsl updates in some cases.
16 tmarc.xsl: Simplify the 6xx to subject-long and fix 1-based
17 substring (contribtion from Sven Porst)
19 marc21.xsl: fix 1-based substring call
21 tmarc.xsl and marc21.xsl: use 856$a as last option for electronic-text.
23 Add test_termlist_block to test suite
27 Fix SEGV for invalid PQFs and SRU/SOLR targets
28 Also refactor a bit the code that converts from PQF to SRU/SOLR queries.
30 Fix pz2.js: "null object" due to change in in bytarget result XML.
32 Fixes in tmarc.xsl: Subject-long shorten for extra commas only.
33 Added this normalization to the other subject-long fields (d6xx),
36 Fixes in marc21.xsl: Updated with most of the new tmarc.xsl.
37 Still differences around medium and holdings. marc21.xsl is not
38 longer active used by Index Data, and should be considered unsupported.
39 Use tmarc.xsl instead.
43 Fix SEGV that could occur for failed connections.
47 Fix bug for command sort that could return no results for active clients
48 (from previous search). This bug was present in 1.6.6-1.6.7.
50 Fix bug in results that could include results that should have been
51 filtered out. This bug was present in 1.6.6-1.6.7.
55 Fix bug introduced in 1.6.6 where a connection re-use could stall
58 Local filtering may now specify a local metadata field, eg.
59 pz:limitmap:somefield[t]=local:otherfield
63 For search, when limit and or filtering is in place and search
64 is identical to previous search, the result set is re-used and the
65 target is not searched.
67 Limits may work perform local filtering as well, by using "local:"
72 Updated bytarget command to contain a suggestions element with misspelled
73 words and suggestions to these. pz2.js has been updated to deliver this
74 onwards as well. Only target that currently delivers this is the solr
79 New service definition element, xslt, that allows an embedded stylesheet
80 to be defined. This can be referred to from pz:xslt as an alternative to
83 New pz:sortmap:field setting for specifying hints on how to make
84 a target natively sort on a field. This is used for command=show in
85 conjunction with sort.
87 New pz:url setting for specifying the actual URL for a target. When
88 this is used the target ID is not used as URL anymore and the target ID
89 may be almost any string (not including []).
91 command=termlist without name parameter returns all termlists/facets.
92 Previously if name parameter was omitted, only "subject" was returned.
96 Make termlist sorting stable. Terms with same frequency are now sorted by
97 their display name. This makes a pretty display and improves our
98 regression test because qsort is not a stable sort.
100 New sort parameter value 'position'. The 'position' sorts merged records
101 by their original position from the remote target. This is primarily useful
102 for debugging and may be used for targets that already perform some kind
103 of relevance ranking. Note that sort by default is decreasing; so to get
104 records in their original order sort=position:1 must be used.
108 tmarc.xsl: yet another 773$g fix. Was broken in 1.6.1 as well.
110 Facility to change working directory for pazpar2 daemon. Option -wdir
111 sets working directory to dir. This facility is useful if core dumps
112 must be saved. In this case, the current working directory must be
113 writable by the running user, such as "nobody".
117 New configuration element <icu_chain> for <server>/<service> which
118 allows a named ICU rule (chain) to be defined. The names relevance,
119 sort, mergekey and facet are used for those operations. The definition
120 <icu_chain id="sort" locale="en"> .. </icu_chain>
122 <sort> <icu_chain locale="en> ... </icu_chain> </sort>
123 And so on.. for relevance, mergekey and facet as well. The latter
124 style is deprecated. The facet terms are normalized by the facet
125 rule by default. This may be changed on a metadata field basis by
126 defining the new attribute 'facetrule' for the metadata element.
128 <icu_chain id="myrule" locale="en"> ... </icu_chain>
129 <metadata name="author" termlist="yes" facetrule="myrule"/>
131 Preserve rorder for merged metadata. Fixes issue as reported by Sven
132 Porst: http://lists.indexdata.dk/pipermail/yazlist/2011-July/003230.html
134 tmarc.xsl: set journal-subpart to 773$ only.
138 Modify the behavior for the limit parameter (first defined in 1.5.7).
139 Mapping of limit searches are now defined by the new configuration item
140 pz:limitmap. Fix a dead-lock problem with the limit parameter.
142 Extend tmarc.xsl to extract 773$g data (OpenURL).
146 ICU default maps remove backquote (`).
148 Command 'search' takes limit parameter (optional). The limit parameter
149 allows a search to be limited one or more facets and the corresponding
150 values. This is for server side filtering.
152 Configure tweak: Use -lm for log(3) if needed
156 Fix a problem with skiparticle sortkey that could be completely
157 ignored (and reduced to "").
159 Fix dependency problem in pazpar2 RPM package (did not require
160 libyaz4 as it should).
164 Fix memory leak that occurred for command=termlist&name=xtargets .
166 Pazpar2 may save HTTP requests. Enabled by option -R.
170 Experimental support for DTIC DADS target. New dads-pz2.xsl.
172 Support for query_syntax (overrides the default for SRU | Z39.50)
174 Support for extraArgs (ZOOM "extraArgs" option) for targets
176 New commands: status-server and status-session
180 Fix for threaded runs: Client now have a copy of the database URL,
181 which can used after the database has been release from the client.
182 This makes the logging in the connection idle timeout of the client nicer (no NOURL) and should be thread-safe.
184 tmarc.xsl: Add journal-title-abbrev and full text.
186 cf.xsl: new fields: isbn, issn, journaltitle, volume, issue
188 Fix for cmd=record before search.
190 Session Logging clean up.
192 Fix wrong termlist factor when maxrecs is different from 100.
196 Fix missing pz:termlist_term_factor in settings.c messed up pz:preferred.
197 Term factor is default enabled but can be diseabled by
198 pz:termlist_term_factor=0
202 Add scaling of facet count. Currently always enabled, needs fixing.
203 Allow user-defined info for target suffix. This has no meaning in
204 Pazpar2 except to distinguish targets from each other. The suffix
205 data begins with #. For example z3950.indexdata.com/gils#Mydata
207 Added exact-match recordfilter; format name=value
211 SOLR support. Pazpar2 may operate as web service client for SOLR.
215 Fix for show command and block=1 (dead lock). Bug was introduced in
220 New RPM packages: pazpar2, pazpar2-js, pazpar2-doc. These have been
221 tested on CentOS 5.5 only.
225 Fix problem with result sets being removed from a client session
226 if the connection for it was resused by another session. Bug #3489.
228 New iphone UI for Pazpar2 (www/iphone).
232 Fixes for threaded operation.
234 New stylesheets for TurboMARC: tmarc.xsl and opac_turbomarc.xsl.
236 New example services in etc/services in source. In the Debian packages
237 these are located in /etc/pazpar2/services-available
239 Threaded mode operational on Windows. Requires Windows 7 or Windows
242 Default value of setting pz:max_connections is 0 which means that there
243 is no limit on number of connections.
247 Pazpar2 may operate in threaded mode. Enabled by element threads in
248 the configuration. See pazpar2_conf for details.
250 New setting setting: pz:max_connections. Setting pz:max_connections is
251 a limit of number of sockets to a host. When this limit is reached,
252 Pazpar2 will wait up to 5 seconds for a connection to becomes available.
253 The client will be marked Client_Error when it can not be searched
254 (other clients in a session may work). If pz:max_connections is not set
255 for a target, a value of 30 will be used. Note: the pz:max_connections
256 will only work in threaded mode.
258 pz2.js: JSON support for show.
260 Debian package: Enable default service, default.xml, before starting
261 Pazpar2 only if there is no service already in /etc/pazpar2/services-enabled.
265 Debian version depends on on libyaz4. Note that Pazpar2 will still
266 compile from source with YAZ 3.
268 Split services into separate files. The example configuration file
269 pazpar2.cfg.dist now includes a default service default.xml (part of
270 etc). And default.xml includes settings/edu.xml. The default.xml file,
271 not to be confused with settings/defaults.xml, is a template for jsdemo
272 and other services. The Debian package installs /etc/pazpar2/server.xml
273 which is now the main pazpar2 configuration (used to be called pazpar2.cfg).
274 server.xml includes services from /etc/pazpar2/services-enabled/*.xml .
275 The default.xml (from etc) is installed in /etc/pazpar2/services-available
276 and a symlink to it is created from services-enabled. The default.xml
277 service is unnamed and, thus, will be used by jsdemo and test1.
279 New setting pz:negotiation_charset. Patch from Andrei V. Toutoukine. The
280 new setting pz:negotiation_charset specifies character set for Z39.50 Init.
284 Support for additional fields in cf.xsl and pazpar2.conf.dist:
285 publisher, available, due, location (=locallocation), callno
286 (=callnumber), thumburl and score.
288 Describe pz:xslt and the auto setting.
290 Move mergekey definition away from the normalization stylesheets and
291 define a mergekey common for all target types in pazpar2.cfg.
293 Code update: Use the Odr_int type for hit counts. This is part of
294 YAZ 3.0.47 and later and so configure checks for that.
298 Metadata attribute 'skiparticle' also works for ICU based
299 normalization. (was only working for the non-ICU/ASCII before).
301 Command bytarget with argument settings=1 will show settings per
302 target.. This is to be able to verify correct settings and be able to
303 test that they are correct. The database settings array size is now
304 also stored.. Problems with database settings array is that if not
305 careful it will be too small (smaller than dictionary per-service
308 Make record list sorting stable by comparing mergekey for records if
309 relevance/title or other sorting criteria all match. This is merely to
310 ensure that our regressions tests works (reproducible output).
312 Relevance calculation changes: use a different denominator (length) for
313 per-field relevance scoring.. Instead of length of all ranked fields we
314 now use length of individual fields (as if they were individual "free"
315 text fields). This will ensure that documents with a long field with no
316 match (say description) will not "hurt" a title match.
318 Diagnostic member was not set on connection error. Fixed
322 Command search takes two optional parameters, startecs and maxrecs,
323 that specifies the start offset (0, 1, ...) and maximum number of records
324 to fetch for each target.
326 XSLTs + MARC maps are cached within a session so we don't re-parse
327 them over and over again. Even for a session with a single search
328 there's much to be gained because many targets use the same
331 The metadata attribute 'mergekey' now takes one of three values 'no',
332 'required', 'optional' . And the resulting mergekey from metadata
333 is now ordered in the same way as metadata in the service definition.
334 Older Pazpar2 version use the order in which metadata appeared in a
337 The search argument 'filter' now offers a new operator ~ which does a
338 substring match. The = operator works as before: string match for
339 anything but pz:id, or target match for pz:id.
341 New setting pz:recordfilter. The value of this setting takes the
342 form name[~value]. This setting makes Pazpar2 ignore all retrieved
343 records that do not have the metadata element name with value substring
346 Pazpar2 allows YAZ log level to be set (option -v).
350 For WS responses Pazpar2 creates XML header. Exception: raw record.
352 Setting XML files are now stored in etc/settings instead of etc. This
353 reflects the layout with the Debian package layout.
355 Settings may be posted for command=settings. The POSTed settings must
356 have root element 'settings' like regular setting files. In order to be
357 recognized, the POST request must use Content-Type=text/xml.
359 A service may be posted for command=init. This service will be used
360 during the session. The service may have its own target settings,
361 ICU config, timeout, etc. In order to be recognized, the POST request
362 must use Content-Type=text/xml.
364 Timeout values may be given per-service. That's element 'timeout'
365 which takes three attribute values (a subset may be given): 'session',
366 'z3950_operation', 'z3950_session'. Option -T is no longer supported
367 - used to specify session timeout.
369 Option -t tests the Pazpar2 configuration and returns exit code
370 (0=success, non-zero=failure). In previous version of Pazpar2, -t
371 specified local settings.
373 In version 1.2.0 the configuration file - after include processing -
374 was dumped to stdout. Now, the configuration is only dumped to the
375 yaz log file if option -d is given.
379 Configuration may now have multiple server areas. This means that a
380 Pazpar2 instance may listen on multiple ports. Virtual hosting is not
381 yet supported - on a server basis. Configuration may also have multiple
382 services .. That is repeating service elements inside a server. Each
383 has an attribute 'id' which serves as service ID. This ID in turn may
384 be used in a Pazpar2 session, by specifying parameter service=ID for
385 command init. There can be at most one unnamed service inside a server
386 which can be referred to by not specifying an service ID for command
387 init (backwards compatible). In order to partition multiple servers and
388 services a new include directive has been added. This takes an attribute
389 'src' which specifies one or more sub-files. For example to include
390 service files, one might use:
391 <server >.. <include src=/"etc/pazpar2/conf.d/*.xml"/> .. </server>.
392 It is the intention that that completely makes the settings directive
395 Fix problem where the record command would wait forever if there were
396 no targets to wait for (activeclients == 0).
400 One result set is created per session (last search) rather than for
401 each connection which happen to be shared (bug #3009).
403 marc21 stylesheets changed for efficiency.
407 Session timeout may be specified on the command-line as option -T.
409 Pazpar2 may now be operated in a no-merged mode for records.. All records
410 will be considered unique. This mode is enabled if no mergekey is
411 generated by the normalization stylesheet (pz:xslt).
413 Pazpar2 caches original records from each target and the 'record' command
414 with offset returns the original record if 'syntax' and 'esn' are NOT
415 specified. This speeds up retrieval of original records but also means
416 that Pazpar2 uses more memory. The cached records will be freed when the
417 session terminates or a new search is executed.
419 Pazpar2 no longer uses its own ICU wrapper. Instead the ICU wrapper
420 library part of YAZ is used.
422 Added SRU client support.
424 Automatically computes pz:nativesyntax if not provided. Works for XML and
427 --- 1.0.13 2008/11/24
429 Command bytarget returns name of target (if defined).
431 --- 1.0.12 2008/11/04
433 Fixed bug #2021.. location now holds all brief elements.
435 --- 1.0.11 2008/10/15
437 Fixed check for application/x-www-form-urlencoded parameters.
439 --- 1.0.10 2008/10/14
441 Fixes for IE in pz2.js.
443 Fixed bug #2021: non-merged, brief meta data NOT included for command=show.
447 Changed the JS library pz2.js to use POST for long URL (+ params).
449 Added installation instructions for Windows. Note: NT services is
450 NOT available until we make a new release of YAZ.
452 Preserve order of repeated metadata fields (they were reversed before).
454 More MARC21 information extracted for metadata.
458 Fixed bug #1162: HTML entities are not escaped properly.
460 Native Windows port of Pazpar2. Makefile for Visual Studio provided.
464 Marc21 stylesheet updated to reflect multiple full text fields
468 Fixed bug in pz2.js WRT DOMElement attributes on IE.
470 Fixed bug 2100: Database wildcards not working
474 Added support for retrieval of records in binary.
476 Fixed bug 1794: Pazpar2 does not return valid XML.
478 Deal with ICU not returning sortkey (resulted in SEGV before).
482 JavaScript library pzw2.js throws error if WS response (from Pazpar2 or
483 other) is malformed (non-wellformed XML or missing Pazpar2 OK status).
485 Improved diagnostics when Pazpar2 HTTP decoding fails.
487 Pazpar2 requests may be POSTed as using Content-Type
488 application/x-www-form-urlencoded.
490 Pazpar2 honors LF in HTTP headers.
492 Handle targets that handle negative hit counts (should not happen, but it
497 ICU is used for tokenization and normalization of the following: mergekey,
498 sorting, relevance terms.
500 Debian package now enables ICU tokenization and normalization by default.
504 Exposed user setting values (i.e. non-pz: names) to the record systems in two
505 ways: Either as parameters to the normalization stylesheets (which would allow the
506 programmer to postprocess or use the values in any way) or after the normalization
507 step, in which case values are made part of the normalized record (and available for
508 sorting, termlists, display, or other interface-related use.
510 Implemented sorting by year.
512 Option -d dumps records to the current log file instead of stderr.
514 Fixes for compilation on cygwin.
516 Z39.50 client code uses pz:elements. pz:elements was recognized in
517 earlier Pazpar2 versions but it was not used for anything.
519 icu_chain_test is using fgets instead of getline - fixes compilation
522 Loosen the CCL query parsing so that Pazpar2 only returns error if _all_
523 query conversions fail (rather than _any_). This means targets that do
524 not support some fields are ignored in a search.
528 Improved handling of socket timeout for Z39.50 connections.
530 Misc documentation updates and spell fixes.
532 Debian package pazpar2 creates log rotate entry.
534 Debian package pazpar2-apache2 reloads Apache2.
536 jsdemo included in distribution. It illustrates the use of the js/pz2.js
541 First public release.