Version 1.8.1
[pazpar2-moved-to-github.git] / NEWS
1 --- 1.8.1 2014/09/10
2
3 Turbomarc needs number check for date 903 map PAZ-973
4
5 primo-pz2.xsl creates citation rather than journal-subpart PAZ-972
6
7 pz2.js: on successful search, issue a "show" command only if a show
8 callback function has been installed. Fixes part of PAZ-975
9
10 --- 1.8.0 2014/09/30
11
12 New command=stop which stops further search&retrieval for active
13 databases.
14
15 CF/primo XSL generates {volume,issue,pages}-number that are defined
16 in default Pazpar2 service definition. PAZ-968 PAZ-970
17
18 --- 1.7.5 2014/09/11
19
20 Various fixes for threaded operation PAZ-960 thru PAZ-966
21
22 Dump main configuration file during start of Pazpar2 PAZ-957
23
24 --- 1.7.4 2014/09/02
25
26 Log ingest failures and record failures:
27
28 Clean up logging PAZ-942
29 Use session lead in more places. Log hits/records/filtered for each
30 target when fetching is complete. Log hit count when a search
31 (response) is received. Remove some less useful log messages.
32
33 Fix warning about about missing (internal) stylesheet PAZ-956
34
35 Report number of filtered records in bytarget PAZ-954
36
37 Cache XML documents as they appear after normalization. The key
38 for the cache is database+record offset. Cache is removed if query
39 is modified for search. This speeds up re-establishing a result set
40 for databases where new query is same previous query.
41
42 --- 1.7.3 2014/08/22
43
44 poll: add assert for number of FDs; abort on poll failure
45
46 --- 1.7.2 2014/08/18
47
48 Fix hang for 2nd use of target with unresolved DNS PAZ-949
49
50 --- 1.7.1 2014/08/14
51
52 Use poll rather than select for main event loop to overcome limit of
53 1024 file descriptors PAZ-947
54
55 Override setting with same name (do not append) PAZ-945
56
57 --- 1.7.0 2014/06/27
58
59 Separate package: pazpar2-xsl PAZ-932
60
61 --- 1.6.44 2014/06/27
62
63 Update OPAC stylesheets for availabilityDate PAZ-943
64
65 Fix too funny startrecs description
66
67 Fix broken ~ match if filter contains = PAZ-941
68
69 --- 1.6.43 2014/06/12
70
71 Add pz:redis option for ZOOM caching using redis. This is an alternative
72 to memcached. Requires YAZ 5.2.0 to work.
73
74 --- 1.6.42 2014/05/06
75
76 Re-ingest native facets PAZ-934
77
78 Fix medium override for solr-pz2.xsl.
79
80 --- 1.6.41 2014/04/23
81
82 Fix URL with leading http:// not working PAZ-933
83
84 Build packages for Ubuntu Trusty Tahr 14.04 LTS
85
86 cf.xsl: handle medium override AND md field
87
88 --- 1.6.40 2014/04/10
89
90 sortmap relevance always uses increasing=1. PAZ-930
91
92 solr-pz2.xsl: ensure medium is also applied if Solr record do not
93 have it. PAZ-929 
94
95 Fix leak in getaddrinfo usage for HTTP listener. Not a big deal because
96 this code is only executed once.
97
98 Fix typos is sortmap documentation.
99
100 Doc: fix misplaced variablelist tag.
101
102 --- 1.6.39 2014/02/19
103
104 Doc: update WRT ICU which is configured for YAZ; not Pazpar2.
105 It's been like that since version 1.1.1 from August 2009.
106
107 Add support for result-set caching via memcached. See description of
108 pz:memcached. Require that Pazpar2 is using YAZ 5.0.12 or later.
109
110 Add support for a <metadata> container tag. Patfh from Sven Porst.
111
112 Add support for XInclude in main configuarion file. Patch from Sven Porst.
113
114 Add client_{lock,unlock} before call to non_block_events in
115 connection_continue. Problem is that if non_block_events fire records,
116 then we will not unlock client at all. And as a result, a dead-lock
117 occurs.
118
119 --- 1.6.38 2014/01/07
120
121 Avoid removing slash and other characters for generic metadata that
122 looks like a URL (contains ://). PAZ-915
123
124 pz2.js: Only use XDR when doing CORS. Favor XHR in all other circumstances.
125
126 Cluster merge fixes. PAZ-901
127
128 Set client state to "working" when waiting for DNS resolver. PAZ-907
129
130 Log when session terminates. PAZ-905
131
132 Fix LSB/HS conformance for /etc/init.d/pazpar2 PAZ-904
133 Debian: add support for /etc/init.d/pazpar2 status
134
135 --- 1.6.37 2013/11/18
136
137 Fix 'Record Missing' for command=show PAZ-903
138
139 Preserve order of records within cluster PAZ-902
140
141 testing: use yaz-ztest -V if possible and use YAZ in sibling directory
142 if present.
143
144 Allow clustered records to be ingested during retrieval. PAZ-900
145
146 Fix void function error which cannot return a value.
147
148 --- 1.6.36 2013/11/11
149
150 SRU pz:authentication="a/b" may end up as x-username=a%2Fb PAZ-899
151
152 Upgrade to debhelper version 7 PAZ-898
153
154 Package with libyaz5 PAZ-897
155
156 Better error message for CCL parse errors PAZ-887
157
158 --- 1.6.35 2013/09/23
159
160 New target setting: pz:authentication_mode. PAZ-896
161
162 pazpar2 PRM: pazpar2 runs as user nobody. PAZ-893
163
164 Strip #-suffix for ZOOM URLs. PAZ-892
165
166 --- 1.6.34 2013/08/30
167
168 Fix issue with hanging show/bytarget. Could happen if new search was
169 fired with filter before show from previous show completed.
170
171 Add 'date' handling for solr-pz2.xsl.
172
173 --- 1.6.33 2013/08/13
174
175 pz:authentication may carry user group password. If pz:authentication
176 has at least one blank in it, that forces Pazpar2 to use idPass Z39.50
177 authentication. Two forms are allowed
178     user password
179     user group password
180 If no blanks are present, open authentication is in use (as before).
181
182 Fix {prev,next}recid elements that are returned by record
183 command. These were incorrect in versions 1.6.23 thru 1.6.32.
184
185 --- 1.6.32 2013/06/14
186
187 Experimental support for snippets. If argument snippets=1 is given
188 for command record or show, the text will include <match>-tags for
189 those area that matches.
190
191 Fix memory leak WRT client structures (incorrect inc ref count).
192
193 Log when a HTTP response is serialized and the time elapsed.
194
195 New command, service, which returns current service XML in use for
196 session.
197
198 --- 1.6.31 2013/05/24
199
200 Local limit for fields of type "generic" (ie text fields) are
201 now normalized by mergekey rule before comparison takes place.
202 Before, no normalization took place and comparsion was, thus, exact.
203
204 New facility: dynamic rank , which allows ranking to be changed
205 for an existing result set. The rank can be set for search or
206 show. This overrides the rank for metadata elements (which fields
207 to rank and weight).
208
209 New facility:dynamic mergekey , which allows mergekey to be changed
210 for an existing result set. The mergekey can be set for search or
211 show.
212
213 HTTP server: host=@ listens on IPV6 and IPV4 if possible.
214 Also, allow ports to be given as names (not just integers).
215 Fix @-notation on systems that don't support IPV6 sockets.
216
217 --- 1.6.30 2013/04/26
218
219 Add MasterKey Connect configuration. Refer to section "non-standard
220 databases" for more information.
221
222 Allow timeformat for log to be specified with option -m (as Metaproxy
223 and YAZ GFS).
224
225 New Debian package pazpar2-dbg.
226
227 Fix NULL ptr reference of se->relevance. If a new search is initiated
228 and a CCL query fails to parse, Pazpar2 could crash.
229
230 Fix problem with host/port mangling in Pazpar2 HTTP server. Problem
231 existed in 1.6.29 only.
232
233 --- 1.6.29 2013/04/05
234
235 IPV6 updates. Allow IPv6 addresses for database hosts and IPv6 address
236 for HTTP server. By default the HTTP server uses IPv4 only, but that can be
237 changed by setting "host" attribute for the "listen" element.
238
239 Change semantics of pz:extendrecs. Allow for repeated fetches .
240 pz:extendrecs is now the number of extra records to fetch (was total
241 count before).
242
243 --- 1.6.28 2013/03/21
244
245 Fix hang or memory violation if show occurred before a search. (not that
246 it makes much sense to perform a show before a search).
247
248 --- 1.6.27 2013/03/08
249
250 pz2.js: Element_parseChildNodes concatenates all Text/CDATA nodes, instead
251 of the first child.
252
253 --- 1.6.26 2013/03/08
254
255 New pz:metadata attribute, empty="empty-value" for Pazpar2's
256 internal representation. With this attribute, Pazpar2 treates an empty
257 pz:metadata type as having the value for "empty"  - if empty.
258
259 New setting, pz:extendrecs, which triggers extended fetch of records
260 for a database beyond pz:maxrecs for a show command.
261
262 Fix warning that was falsely issued for "missing limitmap".
263
264 Log message for Pazpart start/stop changed. Now using same style as
265 Metaproxy, ie Pazpar2 start SHA1 / Pazpar2 stop .
266
267 --- 1.6.25 2013/02/07
268
269 Fix hang of 2nd command=show with esn/syntax given.
270
271 --- 1.6.24 2013/01/18
272
273 New merge attribute type: 'first', which takes all metadata fields
274 from first target that returns the particular field.
275
276 --- 1.6.23 2013/01/02
277
278 Extend info command with hostname and YAZ SHA1
279 Indent results for both command stat and info.
280
281 Allow limit on merged content. The new configuration metadata
282 element, limitcluster, configures that a metadata element (name) be used
283 as limit name for search. Applies to the whole service (ie all targets),
284 unlike pz:limitmap which is configured per-target (database).
285
286 New feature: limitmap local:* matches against all metadata fields.
287
288 Allow repeated list in limitmap spec . Separated by comma. For
289 example: value="local:title,rpn:@attr 1=4".
290
291 New element <message> in bytarget response. Holds diagnostic message
292 of code (say 'Unsupported Use Attribute' for Bib-1 114).
293
294 Improved logging for record ingestion failures.
295
296 Avoid using struct icu_chain in non-YAZ_HAVE_ICU mode. In the rare case,
297 when YAZ is compiled without ICU support.
298
299 --- 1.6.22 2012/10/11
300
301 Requires YAZ-4.2.40 to support native solr support.
302
303 Fix and improve logic handling whether or not to re-do search on sort
304 order changes. A sort order with change in ascending/descending only
305 whould not trigger a new search, which is required for targets with
306 native sorting capabilities. Each client is now checked if instructions
307 (sortmap) exist for native sorting and only client that does requires
308 it is researched. Other clients is just re-ingesting the records,
309 they already have. The resultset is now cleared if any researching
310 is done.
311
312 Connection sharing between session has broken since version 1.6.8 with
313 introduction of logic that would minimize searching if pazpar2 could
314 detect this based on same query and limits and partly sort order.
315 This could lead to segementations violations.
316
317 Added a chapter in the manaul about relevance ranking.
318
319 --- 1.6.21 2012/09/24
320
321 Rank tweak: follow=number will increase mult by number if two terms
322 occur next to each other; number-1 if they are one term apart , .. 0
323 if they are number a part (all in order). Default is 0 (following
324 terms has no effect).
325
326 Rank tweak: lead=k will divide mult by 1 + log2(1+k*l) where k is
327 value given by lead and l is length from beginning of field where
328 term occurs (l=0 for first term, l=1 for second term, ..). Default
329 value of k is 0.0.
330
331 Rank tweak: length=strategy. length="linear" if mult is to be divided
332 by length (existing, default behavior), length="log" if mult is to be
333 divided by log2(1+length), length="none" if mult is not to be affected
334 by length.
335
336 --- 1.6.20 2012/09/21
337
338 Rank algorithm details may be printed as part of show response in
339 element <relevance_info>.. This is only printed if <rank debug="yes"/>
340 is used in service.
341
342 Record as returned by show/record command have a minimal indentation
343 which makes things human-readable.
344
345 New configuration of default sorting criteria (sort-default) in
346 service definition. If no criteria is defined it will be as before
347 'relevance'.
348
349 Search command now supports sort parameter just as the show command.
350 If no parameter is give, it will use the service sort-default value.
351
352 --- 1.6.19 2012/09/18
353
354 Rank algorithm skips strings that gets normalized to empty string.
355 For example, & and ! could map to the empty string. The weight for
356 those terms is now 0 (as if they were not part of the query).
357
358 Rank algorithm does not use CCL from limitmap; only from the query
359 parameter (user query).
360
361 Obey -w dir.
362
363 --- 1.6.18 2012/09/17
364
365 Rank algorithm configurable by 'rank' element inside service. So far
366 only, attribute 'cluster' is recognized. If cluster="yes", multiple
367 records inside a cluster boosts higher than single records. This
368 is default behavior and existing behavior. cluster="no" takes the
369 average score of each record in a cluster.
370
371 --- 1.6.17 2012/09/05
372
373 Fix bad re-use of connections (connections with changing proxy should not
374 be reused).
375
376 --- 1.6.16 2012/08/22
377
378 Fix a bug introduce in 1.6.15 around the position sorting. It resetted the
379 resultset and sorting when the sort order is position. However this will be done on
380 every client poll, which will make pazpar2 continuing reset and fetching.
381 It should only be done on FIRST request where the sort order change.
382
383 Fix an issue on suggestion option: Also disable suggestions on empty string.
384
385 Clean up in turbo marc stylesheet.
386
387 Remove the hardcoded size of termlists.
388
389 --- 1.6.15 2012/06/27
390
391 New facility: ccldirective may be given in service definition. Allows
392 CCL parsing to be customized a bit, such as defining names of operators
393 and, or, not.
394
395 New facility: raw record by checksum, rather than offset. The record
396 command optionally takes checksum which identifies certain record from
397 a database.
398
399 New facility: per field ranking. Rank may be given as M [F N] where
400 M is default rank and N is rank for CCL terms from field F.
401
402 --- 1.6.14 2012/06/04
403
404 Fix for IE7/8 in pz.js
405
406 Applied patch from Giannis Kosmas on keepAlive, which also adds keepAlive to init response.
407
408 Lower log level some places.
409
410 Remove some invalid test results.
411
412 --- 1.6.13 2012/05/23
413
414 Introducing a version=2 parameter for show, termlist and bytarget commands.
415 This enables pazpar2 to return approximation on hit and count count when
416 doing record filtering using the limit parameter on search and a
417 limitmap with a value of "local:"
418
419 Setting pz:xslt may embed local XSLT as an alternative to referring
420 to filenames.
421 Value is not CDATA but XML nodes embedded, so escaping is not necessary
422 but a root element *must* be present. For example:
423 <settings target="target="z3950.indexdata.com/marc">
424      <set name="pz:xslt">
425        <xsl:stylesheet
426           version="1.0"
427         ..
428        </xsl:stylesheet>
429      </set>
430     </settings>
431
432 Metadata field rank may given by XML internal document (pz:xslt
433 result). If rank is not given, the rank from service description is
434 used - as before.
435
436 Metadata field can now configured a default limitmap and facetmap.
437 Setting limitmap to "local:" would work for all kind of targets, but would
438 prob. not be the optimal solution. But at least better than the default behavior
439 of pazpar2 where no filtering is done.
440
441 A service definition can now also contains <set/> that defines service-wide
442 settings. These will override server-wide sets and will be overridded by
443 settings.
444
445 New setting, pz:present_chunk, that specifies number of records to fetch
446 at a time. Zero will disable chunkation; will fetch max_records at once.
447
448 --- 1.6.12 2012/03/14
449
450 Revert the format change in termlist response, that could break
451 some clients / UIs since they were expecting an (empty) element
452 if no facet values was found.
453
454 --- 1.6.11 2012/03/07
455
456 Revert the behavior of returning errors when unable to block
457 on termlist, bytarget and search, when unable to block due to
458 other block. The client will now receive a regular response,
459 but it will be logged in the server. A parameter (report) is
460 added to change behavior to return error response or WARNING
461 status message. Consider this "API" as private, as it is mostly
462 untested and could be changed in future releases.
463
464 Fix spell error in pz2.js fix in 1.6.10.
465
466 New Marc2TurboMarc.xsl (contribution from Sven Porst).
467 Can solve the missing marc21.xsl updates in some cases.
468
469 tmarc.xsl: Simplify the 6xx to subject-long and fix 1-based
470 substring (contribtion from Sven Porst)
471
472 marc21.xsl: fix 1-based substring call
473
474 tmarc.xsl and marc21.xsl: use 856$a as last option for electronic-text.
475
476 Add test_termlist_block to test suite
477
478 --- 1.6.10 2012/02/23
479
480 Fix SEGV for invalid PQFs and SRU/SOLR targets
481 Also refactor a bit the code that converts from PQF to SRU/SOLR queries.
482
483 Fix pz2.js: "null object" due to change in in bytarget result XML.
484
485 Fixes in tmarc.xsl: Subject-long shorten for extra commas only.
486 Added this normalization to the other subject-long fields (d6xx),
487 where it was missing.
488
489 Fixes in marc21.xsl: Updated with most of the new tmarc.xsl.
490 Still differences around medium and holdings. marc21.xsl is not
491 longer active used by Index Data, and should be considered unsupported.
492 Use tmarc.xsl instead.
493
494 --- 1.6.9 2012/01/19
495
496 Fix SEGV that could occur for failed connections.
497
498 --- 1.6.8 2012/01/17
499
500 Fix bug for command sort that could return no results for active clients
501 (from previous search). This bug was present in 1.6.6-1.6.7.
502
503 Fix bug in results that could include results that should have been
504 filtered out. This bug was present in 1.6.6-1.6.7.
505
506 --- 1.6.7 2011/12/23
507
508 Fix bug introduced in 1.6.6 where a connection re-use could stall
509 incoming requests.
510
511 Local filtering may now specify a local metadata field, eg.
512  pz:limitmap:somefield[t]=local:otherfield
513
514 --- 1.6.6 2011/11/25
515
516 For search, when limit and or filtering is in place and search
517 is identical to previous search, the result set is re-used and the
518 target is not searched.
519
520 Limits may work perform local filtering as well, by using "local:"
521 for a limitmap.
522
523 --- 1.6.5 2011/11/01
524
525 Updated bytarget command to contain a suggestions element with misspelled
526 words and suggestions to these. pz2.js has been updated to deliver this
527 onwards as well. Only target that currently delivers this is the solr
528 client in YAZ 4.2.18.
529
530 --- 1.6.4 2011/10/28
531
532 New service definition element, xslt, that allows an embedded stylesheet
533 to be defined. This can be referred to from pz:xslt as an alternative to
534 external files.
535
536 New pz:sortmap:field setting for specifying hints on how to make
537 a target natively sort on a field. This is used for command=show in
538 conjunction with sort.
539
540 New pz:url setting for specifying the actual URL for a target. When
541 this is used the target ID is not used as URL anymore and the target ID
542 may be almost any string (not including []).
543
544 command=termlist without name parameter returns all termlists/facets.
545 Previously if name parameter was omitted, only "subject" was returned.
546
547 --- 1.6.3 2011/09/22
548
549 Make termlist sorting stable. Terms with same frequency are now sorted by
550 their display name. This makes a pretty display and improves our
551 regression test because qsort is not a stable sort.
552
553 New sort parameter value 'position'. The 'position' sorts merged records
554 by their original position from the remote target. This is primarily useful
555 for debugging and may be used for targets that already perform some kind
556 of relevance ranking. Note that sort by default is decreasing; so to get
557 records in their original order sort=position:1 must be used.
558
559 --- 1.6.2 2011/09/15
560
561 tmarc.xsl: yet another 773$g fix. Was broken in 1.6.1 as well.
562
563 Facility to change working directory for pazpar2 daemon. Option -wdir
564 sets working directory to dir. This facility is useful if core dumps
565 must be saved. In this case, the current working directory must be
566 writable by the running user, such as "nobody".
567
568 --- 1.6.1 2011/09/14
569
570 New configuration element <icu_chain> for <server>/<service> which
571 allows a named ICU rule (chain) to be defined. The names relevance,
572 sort, mergekey and facet are used for those operations. The definition
573   <icu_chain id="sort" locale="en"> ..  </icu_chain>
574 is identical to
575   <sort> <icu_chain locale="en> ... </icu_chain> </sort>
576 And so on.. for relevance, mergekey and facet as well. The latter
577 style is deprecated. The facet terms are normalized by the facet
578 rule by default. This may be changed on a metadata field basis by
579 defining the new attribute 'facetrule' for the metadata element.
580 For example:
581   <icu_chain id="myrule" locale="en"> ... </icu_chain>
582   <metadata name="author" termlist="yes" facetrule="myrule"/>
583
584 Preserve rorder for merged metadata. Fixes issue as reported by Sven
585 Porst: http://lists.indexdata.dk/pipermail/yazlist/2011-July/003230.html
586
587 tmarc.xsl: set journal-subpart to 773$ only.
588
589 --- 1.6.0 2011/09/12
590
591 Modify the behavior for the limit parameter (first defined in 1.5.7).
592 Mapping of limit searches are now defined by the new configuration item
593 pz:limitmap. Fix a dead-lock problem with the limit parameter.
594
595 Extend tmarc.xsl to extract 773$g data (OpenURL).
596
597 --- 1.5.7 2011/08/19
598
599 ICU default maps remove backquote (`).
600
601 Command 'search' takes limit parameter (optional).  The limit parameter
602 allows a search to be limited one or more facets and the corresponding
603 values. This is for server side filtering.
604
605 Configure tweak: Use -lm for log(3) if needed
606
607 --- 1.5.6 2011/04/15
608
609 Fix a problem with skiparticle sortkey that could be completely
610 ignored (and reduced to "").
611
612 Fix dependency problem in pazpar2 RPM package (did not require
613 libyaz4 as it should).
614
615 --- 1.5.5 2011/03/28
616
617 Fix memory leak that occurred for command=termlist&name=xtargets .
618
619 Pazpar2 may save HTTP requests. Enabled by option -R.
620
621 --- 1.5.4 2011/03/08
622
623 Experimental support for DTIC DADS target. New dads-pz2.xsl.
624
625 Support for query_syntax (overrides the default for SRU | Z39.50)
626
627 Support for extraArgs (ZOOM "extraArgs" option) for targets
628
629 New commands: status-server and status-session
630
631 --- 1.5.3 2011/02/18
632
633 Fix for threaded runs: Client now have a copy of the database URL,
634 which can used after the database has been release from the client.
635 This makes the logging in the connection idle timeout of the client nicer (no NOURL) and should be thread-safe.
636
637 tmarc.xsl: Add journal-title-abbrev and full text.
638
639 cf.xsl: new fields: isbn, issn, journaltitle, volume, issue
640
641 Fix for cmd=record before search.
642
643 Session Logging clean up.
644
645 Fix wrong termlist factor when maxrecs is different from 100.
646
647 --- 1.5.2 2011/01/18
648
649 Fix missing pz:termlist_term_factor in settings.c messed up pz:preferred.
650 Term factor is default enabled but can be diseabled by
651 pz:termlist_term_factor=0
652
653 --- 1.5.1 2011/01/06
654
655 Add scaling of facet count. Currently always enabled, needs fixing.
656 Allow user-defined info for target suffix. This has no meaning in
657 Pazpar2 except to distinguish targets from each other. The suffix
658 data begins with #. For example z3950.indexdata.com/gils#Mydata
659
660 Added exact-match recordfilter; format name=value
661
662 --- 1.5.0 2010/10/05
663
664 SOLR support. Pazpar2 may operate as web service client for SOLR.
665
666 --- 1.4.4 2010/08/17
667
668 Fix for show command and block=1 (dead lock). Bug was introduced in
669 1.4.0.
670
671 --- 1.4.3 2010/07/02
672
673 New RPM packages: pazpar2, pazpar2-js, pazpar2-doc. These have been
674 tested on CentOS 5.5 only.
675
676 --- 1.4.2 2010/06/18
677
678 Fix problem with result sets being removed from a client session
679 if the connection for it was resused by another session. Bug #3489.
680
681 New iphone UI for Pazpar2 (www/iphone).
682
683 --- 1.4.1 2010/05/21
684
685 Fixes for threaded operation.
686
687 New stylesheets for TurboMARC: tmarc.xsl and opac_turbomarc.xsl.
688
689 New example services in etc/services in source. In the Debian packages
690 these are located in /etc/pazpar2/services-available
691
692 Threaded mode operational on Windows. Requires Windows 7 or Windows
693 Server 2008.
694
695 Default value of setting pz:max_connections is 0 which means that there
696 is no limit on number of connections.
697
698 --- 1.4.0 2010/03/29
699
700 Pazpar2 may operate in threaded mode. Enabled by element threads in
701 the configuration. See pazpar2_conf for details.
702
703 New setting setting: pz:max_connections. Setting pz:max_connections is
704 a limit of number of sockets to a host. When this limit is reached,
705 Pazpar2 will wait up to 5 seconds for a connection to becomes available.
706 The client will be marked Client_Error when it can not be searched
707 (other clients in a session may work). If pz:max_connections is not set
708 for a target, a value of 30 will be used. Note: the pz:max_connections
709 will only work in threaded mode.
710
711 pz2.js: JSON support for show.
712
713 Debian package: Enable default service, default.xml, before starting
714 Pazpar2 only if there is no service already in /etc/pazpar2/services-enabled.
715
716 --- 1.3.0 2010/01/25
717
718 Debian version depends on on libyaz4. Note that Pazpar2 will still
719 compile from source with YAZ 3.
720
721 Split services into separate files. The example configuration file
722 pazpar2.cfg.dist now includes a default service default.xml (part of
723 etc). And default.xml includes settings/edu.xml. The default.xml file,
724 not to be confused with settings/defaults.xml, is a template for jsdemo
725 and other services. The Debian package installs /etc/pazpar2/server.xml
726 which is now the main pazpar2 configuration (used to be called pazpar2.cfg).
727 server.xml includes services from /etc/pazpar2/services-enabled/*.xml .
728 The default.xml (from etc) is installed in /etc/pazpar2/services-available
729 and a symlink to it is created from services-enabled. The default.xml
730 service is unnamed and, thus, will be used by jsdemo and test1.
731
732 New setting pz:negotiation_charset. Patch from Andrei V. Toutoukine. The
733 new setting pz:negotiation_charset specifies character set for Z39.50 Init.
734
735 --- 1.2.4 2010/01/15
736
737 Support for additional fields in cf.xsl and pazpar2.conf.dist:
738 publisher, available, due, location (=locallocation), callno
739 (=callnumber), thumburl and score.
740
741 Describe pz:xslt and the auto setting.
742
743 Move mergekey definition away from the normalization stylesheets and
744 define a mergekey common for all target types in pazpar2.cfg.
745
746 Code update: Use the Odr_int type for hit counts. This is part of
747 YAZ 3.0.47 and later and so configure checks for that.
748
749 --- 1.2.3 2009/11/24
750
751 Metadata attribute 'skiparticle' also works for ICU based
752 normalization. (was only working for the non-ICU/ASCII before).
753
754 Command bytarget with argument settings=1 will show settings per
755 target.. This is to be able to verify correct settings and be able to
756 test that they are correct. The database settings array size is now
757 also stored..  Problems with database settings array is that if not
758 careful it will be too small (smaller than dictionary per-service
759 in settings).
760
761 Make record list sorting stable by comparing mergekey for records if
762 relevance/title or other sorting criteria all match. This is merely to
763 ensure that our regressions tests works (reproducible output).
764
765 Relevance calculation changes: use a different denominator (length) for
766 per-field relevance scoring.. Instead of length of all ranked fields we
767 now use length of individual fields (as if they were individual "free"
768 text fields). This will ensure that documents with a long field with no
769 match (say description) will not "hurt" a title match.
770
771 Diagnostic member was not set on connection error. Fixed
772
773 --- 1.2.2 2009/10/13
774
775 Command search takes two optional parameters, startecs and maxrecs,
776 that specifies the start offset (0, 1, ...) and maximum number of records
777 to fetch for each target.
778
779 XSLTs + MARC maps are cached within a session so we don't re-parse
780 them over and over again. Even for a session with a single search
781 there's much to be gained because many targets use the same
782 transformation.
783
784 The metadata attribute 'mergekey' now takes one of three values 'no',
785 'required', 'optional' .  And the resulting mergekey from metadata
786 is now ordered in the same way as metadata in the service definition.
787 Older Pazpar2 version use the order in which metadata appeared in a
788 record instance.
789
790 The search argument 'filter' now offers a new operator ~ which does a
791 substring match. The = operator works as before: string match for
792 anything but pz:id, or target match for pz:id.
793
794 New setting pz:recordfilter. The value of this setting takes the
795 form name[~value]. This setting makes Pazpar2 ignore all retrieved
796 records that do not have the metadata element name with value substring
797 (if given).
798
799 Pazpar2 allows YAZ log level to be set (option -v).
800
801 --- 1.2.1 2009/10/05
802
803 For WS responses Pazpar2 creates XML header. Exception: raw record.
804
805 Setting XML files are now stored in etc/settings instead of etc. This
806 reflects the layout with the Debian package layout.
807
808 Settings may be posted for command=settings. The POSTed settings must
809 have root element 'settings' like regular setting files. In order to be
810 recognized, the POST request must use Content-Type=text/xml.
811
812 A service may be posted for command=init. This service will be used
813 during the session. The service may have its own target settings,
814 ICU config, timeout, etc. In order to be recognized, the POST request
815 must use Content-Type=text/xml.
816
817 Timeout values may be given per-service. That's element 'timeout'
818 which takes three attribute values (a subset may be given): 'session',
819 'z3950_operation', 'z3950_session'. Option -T is no longer supported
820 - used to specify session timeout.
821
822 Option -t tests the Pazpar2 configuration and returns exit code
823 (0=success, non-zero=failure). In previous version of Pazpar2, -t
824 specified local settings.
825
826 In version 1.2.0 the configuration file - after include processing -
827 was dumped to stdout. Now, the configuration is only dumped to the
828 yaz log file if option -d is given.
829
830 --- 1.2.0 2009/09/10
831
832 Configuration may now have multiple server areas. This means that a
833 Pazpar2 instance may listen on multiple ports. Virtual hosting is not
834 yet supported - on a server basis. Configuration may also have multiple
835 services .. That is repeating service elements inside a server. Each
836 has an attribute 'id' which serves as service ID. This ID in turn may
837 be used in a Pazpar2 session, by specifying parameter service=ID for
838 command init. There can be at most one unnamed service inside a server
839 which can be referred to by not specifying an service ID for command
840 init (backwards compatible). In order to partition multiple servers and
841 services a new include directive has been added. This takes an attribute
842 'src' which specifies one or more sub-files. For example to include
843 service files, one might use:
844   <server >.. <include src=/"etc/pazpar2/conf.d/*.xml"/> .. </server>.
845 It is the intention that that completely makes the settings directive
846 redundant.
847
848 Fix problem where the record command would wait forever if there were
849 no targets to wait for (activeclients == 0).
850
851 --- 1.1.1 2009/08/28
852
853 One result set is created per session (last search) rather than for
854 each connection which happen to be shared (bug #3009).
855
856 marc21 stylesheets changed for efficiency.
857
858 --- 1.1.0 2009/08/19
859
860 Session timeout may be specified on the command-line as option -T.
861
862 Pazpar2 may now be operated in a no-merged mode for records.. All records
863 will be considered unique. This mode is enabled if no mergekey is
864 generated by the normalization stylesheet (pz:xslt).
865
866 Pazpar2 caches original records from each target and the 'record' command
867 with offset returns the original record if 'syntax' and 'esn' are NOT
868 specified. This speeds up retrieval of original records but also means
869 that Pazpar2 uses more memory. The cached records will be freed when the
870 session terminates or a new search is executed.
871
872 Pazpar2 no longer uses its own ICU wrapper. Instead the ICU wrapper
873 library part of YAZ is used.
874
875 Added SRU client support.
876
877 Automatically computes pz:nativesyntax if not provided. Works for XML and
878 MARC.
879
880 --- 1.0.13 2008/11/24
881
882 Command bytarget returns name of target (if defined).
883
884 --- 1.0.12 2008/11/04
885
886 Fixed bug #2021.. location now holds all brief elements.
887
888 --- 1.0.11 2008/10/15
889
890 Fixed check for application/x-www-form-urlencoded parameters.
891
892 --- 1.0.10 2008/10/14
893
894 Fixes for IE in pz2.js.
895
896 Fixed bug #2021: non-merged, brief meta data NOT included for command=show.
897
898 --- 1.0.9 2008/05/23
899
900 Changed the JS library pz2.js to use POST for long URL (+ params).
901
902 Added installation instructions for Windows. Note: NT services is
903 NOT available until we make a new release of YAZ.
904
905 Preserve order of repeated metadata fields (they were reversed before).
906
907 More MARC21 information extracted for metadata.
908
909 --- 1.0.8 2008/04/22
910
911 Fixed bug #1162: HTML entities are not escaped properly.
912
913 Native Windows port of Pazpar2. Makefile for Visual Studio provided.
914
915 --- 1.0.7 2008/04/14
916
917 Marc21 stylesheet updated to reflect multiple full text fields
918
919 --- 1.0.6 2008/03/12
920
921 Fixed bug in pz2.js WRT DOMElement attributes on IE.
922
923 Fixed bug 2100: Database wildcards not working
924
925 --- 1.0.5 2007/11/09
926
927 Added support for retrieval of records in binary.
928
929 Fixed bug 1794: Pazpar2 does not return valid XML.
930
931 Deal with ICU not returning sortkey (resulted in SEGV before).
932
933 --- 1.0.4 2007/09/28
934
935 JavaScript library pzw2.js throws error if WS response (from Pazpar2 or
936 other) is malformed (non-wellformed XML or missing Pazpar2 OK status).
937
938 Improved diagnostics when Pazpar2 HTTP decoding fails.
939
940 Pazpar2 requests may be POSTed as using Content-Type
941 application/x-www-form-urlencoded.
942
943 Pazpar2 honors LF in HTTP headers.
944
945 Handle targets that handle negative hit counts (should not happen, but it
946 does).
947
948 --- 1.0.3 2007/09/19
949
950 ICU is used for tokenization and normalization of the following: mergekey,
951 sorting, relevance terms.
952
953 Debian package now enables ICU tokenization and normalization by default.
954
955 --- 1.0.2 2007/08/22
956
957 Exposed user setting values (i.e. non-pz: names) to the record systems in two
958 ways: Either as parameters to the normalization stylesheets (which would allow the
959 programmer to postprocess or use the values in any way) or after the normalization
960 step, in which case values are made part of the normalized record (and available for
961 sorting, termlists, display, or other interface-related use.
962
963 Implemented sorting by year.
964
965 Option -d dumps records to the current log file instead of stderr.
966
967 Fixes for compilation on cygwin.
968
969 Z39.50 client code uses pz:elements. pz:elements was recognized in
970 earlier Pazpar2 versions but it was not used for anything.
971
972 icu_chain_test is using fgets instead of getline - fixes compilation
973 on MacOSX .
974
975 Loosen the CCL query parsing so that Pazpar2 only returns error if _all_
976 query conversions fail (rather than _any_). This means targets that do
977 not support some fields are ignored in a search.
978
979 --- 1.0.1 2007/07/03
980
981 Improved handling of socket timeout for Z39.50 connections.
982
983 Misc documentation updates and spell fixes.
984
985 Debian package pazpar2 creates log rotate entry.
986
987 Debian package pazpar2-apache2 reloads Apache2.
988
989 jsdemo included in distribution. It illustrates the use of the js/pz2.js
990 JavaScript library.
991
992 --- 1.0.0 2007/06/20
993
994 First public release.
995