3 For search, when limit and or filtering is in place and search
4 is identical to previous search, the result set is re-used and the
5 target is not searched.
7 Limits may work perform local filtering as well, by using "local:"
12 Updated bytarget command to contain a suggestions element with misspelled
13 words and suggestions to these. pz2.js has been updated to deliver this
14 onwards as well. Only target that currently delivers this is the solr
19 New service definition element, xslt, that allows an embedded stylesheet
20 to be defined. This can be referred to from pz:xslt as an alternative to
23 New pz:sortmap:field setting for specifying hints on how to make
24 a target natively sort on a field. This is used for command=show in
25 conjunction with sort.
27 New pz:url setting for specifying the actual URL for a target. When
28 this is used the target ID is not used as URL anymore and the target ID
29 may be almost any string (not including []).
31 command=termlist without name parameter returns all termlists/facets.
32 Previously if name parameter was omitted, only "subject" was returned.
36 Make termlist sorting stable. Terms with same frequency are now sorted by
37 their display name. This makes a pretty display and improves our
38 regression test because qsort is not a stable sort.
40 New sort parameter value 'position'. The 'position' sorts merged records
41 by their original position from the remote target. This is primarily useful
42 for debugging and may be used for targets that already perform some kind
43 of relevance ranking. Note that sort by default is decreasing; so to get
44 records in their original order sort=position:1 must be used.
48 tmarc.xsl: yet another 773$g fix. Was broken in 1.6.1 as well.
50 Facility to change working directory for pazpar2 daemon. Option -wdir
51 sets working directory to dir. This facility is useful if core dumps
52 must be saved. In this case, the current working directory must be
53 writable by the running user, such as "nobody".
57 New configuration element <icu_chain> for <server>/<service> which
58 allows a named ICU rule (chain) to be defined. The names relevance,
59 sort, mergekey and facet are used for those operations. The definition
60 <icu_chain id="sort" locale="en"> .. </icu_chain>
62 <sort> <icu_chain locale="en> ... </icu_chain> </sort>
63 And so on.. for relevance, mergekey and facet as well. The latter
64 style is deprecated. The facet terms are normalized by the facet
65 rule by default. This may be changed on a metadata field basis by
66 defining the new attribute 'facetrule' for the metadata element.
68 <icu_chain id="myrule" locale="en"> ... </icu_chain>
69 <metadata name="author" termlist="yes" facetrule="myrule"/>
71 Preserve rorder for merged metadata. Fixes issue as reported by Sven
72 Porst: http://lists.indexdata.dk/pipermail/yazlist/2011-July/003230.html
74 tmarc.xsl: set journal-subpart to 773$ only.
78 Modify the behavior for the limit parameter (first defined in 1.5.7).
79 Mapping of limit searches are now defined by the new configuration item
80 pz:limitmap. Fix a dead-lock problem with the limit parameter.
82 Extend tmarc.xsl to extract 773$g data (OpenURL).
86 ICU default maps remove backquote (`).
88 Command 'search' takes limit parameter (optional). The limit parameter
89 allows a search to be limited one or more facets and the corresponding
90 values. This is for server side filtering.
92 Configure tweak: Use -lm for log(3) if needed
96 Fix a problem with skiparticle sortkey that could be completely
97 ignored (and reduced to "").
99 Fix dependency problem in pazpar2 RPM package (did not require
100 libyaz4 as it should).
104 Fix memory leak that occurred for command=termlist&name=xtargets .
106 Pazpar2 may save HTTP requests. Enabled by option -R.
110 Experimental support for DTIC DADS target. New dads-pz2.xsl.
112 Support for query_syntax (overrides the default for SRU | Z39.50)
114 Support for extraArgs (ZOOM "extraArgs" option) for targets
116 New commands: status-server and status-session
120 Fix for threaded runs: Client now have a copy of the database URL,
121 which can used after the database has been release from the client.
122 This makes the logging in the connection idle timeout of the client nicer (no NOURL) and should be thread-safe.
124 tmarc.xsl: Add journal-title-abbrev and full text.
126 cf.xsl: new fields: isbn, issn, journaltitle, volume, issue
128 Fix for cmd=record before search.
130 Session Logging clean up.
132 Fix wrong termlist factor when maxrecs is different from 100.
136 Fix missing pz:termlist_term_factor in settings.c messed up pz:preferred.
137 Term factor is default enabled but can be diseabled by
138 pz:termlist_term_factor=0
142 Add scaling of facet count. Currently always enabled, needs fixing.
143 Allow user-defined info for target suffix. This has no meaning in
144 Pazpar2 except to distinguish targets from each other. The suffix
145 data begins with #. For example z3950.indexdata.com/gils#Mydata
147 Added exact-match recordfilter; format name=value
151 SOLR support. Pazpar2 may operate as web service client for SOLR.
155 Fix for show command and block=1 (dead lock). Bug was introduced in
160 New RPM packages: pazpar2, pazpar2-js, pazpar2-doc. These have been
161 tested on CentOS 5.5 only.
165 Fix problem with result sets being removed from a client session
166 if the connection for it was resused by another session. Bug #3489.
168 New iphone UI for Pazpar2 (www/iphone).
172 Fixes for threaded operation.
174 New stylesheets for TurboMARC: tmarc.xsl and opac_turbomarc.xsl.
176 New example services in etc/services in source. In the Debian packages
177 these are located in /etc/pazpar2/services-available
179 Threaded mode operational on Windows. Requires Windows 7 or Windows
182 Default value of setting pz:max_connections is 0 which means that there
183 is no limit on number of connections.
187 Pazpar2 may operate in threaded mode. Enabled by element threads in
188 the configuration. See pazpar2_conf for details.
190 New setting setting: pz:max_connections. Setting pz:max_connections is
191 a limit of number of sockets to a host. When this limit is reached,
192 Pazpar2 will wait up to 5 seconds for a connection to becomes available.
193 The client will be marked Client_Error when it can not be searched
194 (other clients in a session may work). If pz:max_connections is not set
195 for a target, a value of 30 will be used. Note: the pz:max_connections
196 will only work in threaded mode.
198 pz2.js: JSON support for show.
200 Debian package: Enable default service, default.xml, before starting
201 Pazpar2 only if there is no service already in /etc/pazpar2/services-enabled.
205 Debian version depends on on libyaz4. Note that Pazpar2 will still
206 compile from source with YAZ 3.
208 Split services into separate files. The example configuration file
209 pazpar2.cfg.dist now includes a default service default.xml (part of
210 etc). And default.xml includes settings/edu.xml. The default.xml file,
211 not to be confused with settings/defaults.xml, is a template for jsdemo
212 and other services. The Debian package installs /etc/pazpar2/server.xml
213 which is now the main pazpar2 configuration (used to be called pazpar2.cfg).
214 server.xml includes services from /etc/pazpar2/services-enabled/*.xml .
215 The default.xml (from etc) is installed in /etc/pazpar2/services-available
216 and a symlink to it is created from services-enabled. The default.xml
217 service is unnamed and, thus, will be used by jsdemo and test1.
219 New setting pz:negotiation_charset. Patch from Andrei V. Toutoukine. The
220 new setting pz:negotiation_charset specifies character set for Z39.50 Init.
224 Support for additional fields in cf.xsl and pazpar2.conf.dist:
225 publisher, available, due, location (=locallocation), callno
226 (=callnumber), thumburl and score.
228 Describe pz:xslt and the auto setting.
230 Move mergekey definition away from the normalization stylesheets and
231 define a mergekey common for all target types in pazpar2.cfg.
233 Code update: Use the Odr_int type for hit counts. This is part of
234 YAZ 3.0.47 and later and so configure checks for that.
238 Metadata attribute 'skiparticle' also works for ICU based
239 normalization. (was only working for the non-ICU/ASCII before).
241 Command bytarget with argument settings=1 will show settings per
242 target.. This is to be able to verify correct settings and be able to
243 test that they are correct. The database settings array size is now
244 also stored.. Problems with database settings array is that if not
245 careful it will be too small (smaller than dictionary per-service
248 Make record list sorting stable by comparing mergekey for records if
249 relevance/title or other sorting criteria all match. This is merely to
250 ensure that our regressions tests works (reproducible output).
252 Relevance calculation changes: use a different denominator (length) for
253 per-field relevance scoring.. Instead of length of all ranked fields we
254 now use length of individual fields (as if they were individual "free"
255 text fields). This will ensure that documents with a long field with no
256 match (say description) will not "hurt" a title match.
258 Diagnostic member was not set on connection error. Fixed
262 Command search takes two optional parameters, startecs and maxrecs,
263 that specifies the start offset (0, 1, ...) and maximum number of records
264 to fetch for each target.
266 XSLTs + MARC maps are cached within a session so we don't re-parse
267 them over and over again. Even for a session with a single search
268 there's much to be gained because many targets use the same
271 The metadata attribute 'mergekey' now takes one of three values 'no',
272 'required', 'optional' . And the resulting mergekey from metadata
273 is now ordered in the same way as metadata in the service definition.
274 Older Pazpar2 version use the order in which metadata appeared in a
277 The search argument 'filter' now offers a new operator ~ which does a
278 substring match. The = operator works as before: string match for
279 anything but pz:id, or target match for pz:id.
281 New setting pz:recordfilter. The value of this setting takes the
282 form name[~value]. This setting makes Pazpar2 ignore all retrieved
283 records that do not have the metadata element name with value substring
286 Pazpar2 allows YAZ log level to be set (option -v).
290 For WS responses Pazpar2 creates XML header. Exception: raw record.
292 Setting XML files are now stored in etc/settings instead of etc. This
293 reflects the layout with the Debian package layout.
295 Settings may be posted for command=settings. The POSTed settings must
296 have root element 'settings' like regular setting files. In order to be
297 recognized, the POST request must use Content-Type=text/xml.
299 A service may be posted for command=init. This service will be used
300 during the session. The service may have its own target settings,
301 ICU config, timeout, etc. In order to be recognized, the POST request
302 must use Content-Type=text/xml.
304 Timeout values may be given per-service. That's element 'timeout'
305 which takes three attribute values (a subset may be given): 'session',
306 'z3950_operation', 'z3950_session'. Option -T is no longer supported
307 - used to specify session timeout.
309 Option -t tests the Pazpar2 configuration and returns exit code
310 (0=success, non-zero=failure). In previous version of Pazpar2, -t
311 specified local settings.
313 In version 1.2.0 the configuration file - after include processing -
314 was dumped to stdout. Now, the configuration is only dumped to the
315 yaz log file if option -d is given.
319 Configuration may now have multiple server areas. This means that a
320 Pazpar2 instance may listen on multiple ports. Virtual hosting is not
321 yet supported - on a server basis. Configuration may also have multiple
322 services .. That is repeating service elements inside a server. Each
323 has an attribute 'id' which serves as service ID. This ID in turn may
324 be used in a Pazpar2 session, by specifying parameter service=ID for
325 command init. There can be at most one unnamed service inside a server
326 which can be referred to by not specifying an service ID for command
327 init (backwards compatible). In order to partition multiple servers and
328 services a new include directive has been added. This takes an attribute
329 'src' which specifies one or more sub-files. For example to include
330 service files, one might use:
331 <server >.. <include src=/"etc/pazpar2/conf.d/*.xml"/> .. </server>.
332 It is the intention that that completely makes the settings directive
335 Fix problem where the record command would wait forever if there were
336 no targets to wait for (activeclients == 0).
340 One result set is created per session (last search) rather than for
341 each connection which happen to be shared (bug #3009).
343 marc21 stylesheets changed for efficiency.
347 Session timeout may be specified on the command-line as option -T.
349 Pazpar2 may now be operated in a no-merged mode for records.. All records
350 will be considered unique. This mode is enabled if no mergekey is
351 generated by the normalization stylesheet (pz:xslt).
353 Pazpar2 caches original records from each target and the 'record' command
354 with offset returns the original record if 'syntax' and 'esn' are NOT
355 specified. This speeds up retrieval of original records but also means
356 that Pazpar2 uses more memory. The cached records will be freed when the
357 session terminates or a new search is executed.
359 Pazpar2 no longer uses its own ICU wrapper. Instead the ICU wrapper
360 library part of YAZ is used.
362 Added SRU client support.
364 Automatically computes pz:nativesyntax if not provided. Works for XML and
367 --- 1.0.13 2008/11/24
369 Command bytarget returns name of target (if defined).
371 --- 1.0.12 2008/11/04
373 Fixed bug #2021.. location now holds all brief elements.
375 --- 1.0.11 2008/10/15
377 Fixed check for application/x-www-form-urlencoded parameters.
379 --- 1.0.10 2008/10/14
381 Fixes for IE in pz2.js.
383 Fixed bug #2021: non-merged, brief meta data NOT included for command=show.
387 Changed the JS library pz2.js to use POST for long URL (+ params).
389 Added installation instructions for Windows. Note: NT services is
390 NOT available until we make a new release of YAZ.
392 Preserve order of repeated metadata fields (they were reversed before).
394 More MARC21 information extracted for metadata.
398 Fixed bug #1162: HTML entities are not escaped properly.
400 Native Windows port of Pazpar2. Makefile for Visual Studio provided.
404 Marc21 stylesheet updated to reflect multiple full text fields
408 Fixed bug in pz2.js WRT DOMElement attributes on IE.
410 Fixed bug 2100: Database wildcards not working
414 Added support for retrieval of records in binary.
416 Fixed bug 1794: Pazpar2 does not return valid XML.
418 Deal with ICU not returning sortkey (resulted in SEGV before).
422 JavaScript library pzw2.js throws error if WS response (from Pazpar2 or
423 other) is malformed (non-wellformed XML or missing Pazpar2 OK status).
425 Improved diagnostics when Pazpar2 HTTP decoding fails.
427 Pazpar2 requests may be POSTed as using Content-Type
428 application/x-www-form-urlencoded.
430 Pazpar2 honors LF in HTTP headers.
432 Handle targets that handle negative hit counts (should not happen, but it
437 ICU is used for tokenization and normalization of the following: mergekey,
438 sorting, relevance terms.
440 Debian package now enables ICU tokenization and normalization by default.
444 Exposed user setting values (i.e. non-pz: names) to the record systems in two
445 ways: Either as parameters to the normalization stylesheets (which would allow the
446 programmer to postprocess or use the values in any way) or after the normalization
447 step, in which case values are made part of the normalized record (and available for
448 sorting, termlists, display, or other interface-related use.
450 Implemented sorting by year.
452 Option -d dumps records to the current log file instead of stderr.
454 Fixes for compilation on cygwin.
456 Z39.50 client code uses pz:elements. pz:elements was recognized in
457 earlier Pazpar2 versions but it was not used for anything.
459 icu_chain_test is using fgets instead of getline - fixes compilation
462 Loosen the CCL query parsing so that Pazpar2 only returns error if _all_
463 query conversions fail (rather than _any_). This means targets that do
464 not support some fields are ignored in a search.
468 Improved handling of socket timeout for Z39.50 connections.
470 Misc documentation updates and spell fixes.
472 Debian package pazpar2 creates log rotate entry.
474 Debian package pazpar2-apache2 reloads Apache2.
476 jsdemo included in distribution. It illustrates the use of the js/pz2.js
481 First public release.