3 zoom: handle contentAuthentication MP-587
7 Destroy router and filters in parent process MP-584
9 Update NMAKE makefile to use Visual Studio 2013 along with Boost 1.57,
10 ICU 54.1, Libxml2 2.9.2, Libxslt 1.1.28.
14 Use YAZ backtrace facility MP-582
16 Fix libmetaproxy-dev depends on libgnutls-dev - MP-580
17 libgnutls-dev is unavailable on jessie.
19 Update template filter to avoid Pimpl MP-579
21 cgi: POSTed content - part of MP-562
23 Fix filter cgi does not relay session close MP-577
27 Add support for binding outgoing IP for http_client and z3950_client
28 This is enabled by bind_host setting. MP-575
32 z3950_client: allows negotiation charset to be set MP-574
34 cgi: more functional but no support for POSTed content yet (part of MP-564)
38 http_file: add include of sys/stat.h fixes MP-576
40 Fix documentation about SRU client support MP-572
42 Initialize Libxml2 - for threaded operation MP-571
46 On SIGTERM shut down connection+listening sockets MP-568
47 This fixes a problem with 'metaproxy stop' sometimes taking a long time.
51 zoom: make retry on failure configurable MP-565
52 The default and existing behavior is that backend failures (any
53 diagnostic) makes the module re-search once. The behavior may
54 be changed by db parameter 'retry'. If given value '0' disables
55 retry and '1' enables it. If not given, the Torus record may
56 specify with element retryOnFailure (value '0'/'1').
60 Fix race condition in SIGTERM handling. Could terminate whole metaproxy
61 instead of just a child process. Extremely rare in real life, hit me with
62 CF stress testing. MP-559.
66 http_file: passthru option MP-557
67 New facility for http_file to passthru - even if an area is matched. The
68 default behavior (passthru=false) is to return 404: Not found. With
69 passthru=false, next filter is consulted.
73 Fix ref to freed memory in log filter 1line - MP-556
75 echoedSearchRetrieveRequest support MP-555
79 zoom: allow hostname to be given for ipauth MP-552
80 The Torus setting for that is called auth_hostname.
84 zoom: IP auth use field "ipRanges" rather than "ip" MP-551
88 session_shared: close in ~BackendInstance MP-549
89 This fixes a serious issue where some MP would leak sockets.
91 session_shared: mutex lock in BackendClass::release_backend MP-550
92 Fixes a SEGV that could occur (in rare cases).
96 zoom: Do not include ZOOM C's fake surrogate diag recs MP-547
98 zoom: fix invalid present response in some cases MP-546
100 zoom: Relay Torus HTTP error message
104 Check for proper limits before using RecordCache functions MP-544
108 Build packages for Ubuntu Trusty Tahr 14.04 LTS
110 sort: crash / invalid_read in filter sort MP-541
112 sru_z3950: facet should be stored in additionalSearchInfo MP-533
114 doc: fix missing man pages MP-542
116 cql_rpn: fix threading problem with CQL to RPN conversion MP-497
118 cql_rpn: allow conversion from RPN to CQL (reverse) MP-537
122 sru_z3950: fix facet response (memory corruption) MP-532
124 log: fix crash idPass user is omitted MP-530
128 query_rewrite: pass-thru non Type-1 queries MP-527
130 metaproxy stop (SIGTERM) kills all child processes spanwed by
131 filter (if any) before invoking filter destructors. MP-525
135 http_file: only supports HTTP GET MP-523
137 session_shared: shut down expire thread in destructor
138 This ensures that expire thread is not running after destruction
139 and does bad memory references, etc.
141 frontend_net: fix segfault on startup MP-524
142 Would happen if MP was listening on multiple ports and one
143 of the ports was already in use (and MP would exit).
145 frontend_net: fix memory leak MP-521
146 This leak would occur if all sessions were in use and the input
147 queue was cleared when a client would close connection (socket).
149 frontend_net: fix compilation on Windows (SIGUSR1 does not exist)
153 http_rewrite: use local skiplist; fixes memory corruption. MP-520
155 http_client: x-forwarded-for controls X-Forwarded-For presence
156 If x-forwarded-for setting (boolean) is enabled, http_client will
157 generate an X-Forwarded-For header entry which includes existing
158 X-Forwarded-For (if any) and current peer address (immediate client
159 of Metaproxy). By default x-forwarded-for disabled and X-Forwarded-For
160 will not be generated.
162 z3950_client: client_ip controls client-IP presence
163 If client_ip setting (boolean) is enabled, z3950_client will
164 generate a client_ip OID as part of init request which includes
165 previous client_ip (if any) and current peer address (immediate
166 client of Metaproxy). By default client_ip is disabled and client_ip
167 will not be generated.
169 HTTP X-Forwarded-For/Z39.50 Client-IP support
170 virt_db, multi: relays Z39.50 client-IP.
171 sru_z3950: converts X-Forwarded-For header to Z39.50 client-IP.
172 zoom: uses Client-IP or origin address (prefer Client-IP).
173 frontend_net: Strips tcp: from peer address (so that it is no longer
174 printed and stripped in zoom filter).
175 z3950_client: builds client-IP list - combining immediate peer address
176 as returned by COMSTACK and existing client-IP list (if avaiable).
177 The Origin only printes first X-Forwarded address.
181 Log when SIG{TERM,USR1} is received ASAP MP-513
182 Do it in frontend_net event loop rather than in place for metaproxy
183 main, which only exits when all sessions are terminated for SIGUSR1
186 metaproxy-config: quote some RHS values (that might include blanks)
188 Fix leak in sru_z3950 filter - when explain is returned MP-511
190 Allow stylesheet to be given for sru_z3950 filter MP-510
191 This is based on a patch by Sven Porst and the functionality
192 of the YAZ Generic Frontend Server.
194 Allow base attribute in configuration file tags - the attributes are
195 inserted by XInclude usage as mentioned on
196 yazlist: http://lists.indexdata.dk/pipermail/yazlist/2012-Au
197 and noted in a gist: https://gist.github.com/3551094
199 Package metaproxy provides virtual package metaproxy6 MP-508
200 This allows module packages to depend on a metaproxy server
203 Filter destructors called upon daemon termination MP-505
204 When metaproxy daemon receives SIGTERM the stop method of each filter
205 is called. The stop method existed before, but did not take any
206 arguements (void).. The frontend_net filter can now distinguish
207 between SIGUSR1 (stop bind, but keep sessions running) and SIGTERM
208 (stop immediately). Note that this changes the API+ABI of Metaproxy
211 zoom: sync up with Pazpar2 WRT authentication handling MP-492
213 Router: use shared_ptr rather than naked one - to avoid leak if an
214 exception is thrown in configure.
218 zoom: Add nocproxy=1 for contentConnector sessions MP-501
220 Doc: mention proper versions; fix link to Boost win binaries.
222 Windows: update for Boost 1.55
224 Windows: avoid warning when using boost::split. Done by defining
225 _SCL_SECURE_NO_WARNINGS for Visual Studio.
227 Fix LSB conformance for /etc/init.d/metaproxy MP-500
228 Debian: add support for /etc/init.d/metaproxy status
230 sort: Add const to Record less than operator in order to compile on
235 session_shared: fix element-set handling in record caching. MP-499
237 document http_rewrite. MP-468
239 http_write: Honor X-Metaproxy-SkipLink MP-479 . Filter understands and
240 respects the header (which will normally come from the cproxy filter)
244 RPM: fix dependency for libmetaproxy5-devel MP-496. The libmetaproxy5-devel
245 RPM was unsable in version 1.4.0.
247 Remove log message about "backend classes". Appeared in version 1.4.0.
251 Build RPM/Deb packages with YAZ 5 and yazpp 1.5. Metaproxy still compiles
252 with older version from source, but packages now use YAZ 5 that supports
255 sru_z3950: Fix SEGV for decoding invalid SRU requests
256 Incorrect reference to union (was explain response rather than
259 session_shared: match additionalSearchInfo (includes facets). In
260 layman's terms means that means that facets are properly handled
261 by this filter. Eg a change in requested facets will issue new
262 search and facets from exisiting result set are cached.
264 --- 1.3.62 2013/09/11
266 http_rewrite: better handling of <script> content in HTML parser. MP-486
268 http_rewrite: fix threading issue with regex. MP-482
270 bounce: don't use strdup for fixed length content. Error occurred in echo
273 session_shared: expire backend class when no instances left. This
274 means memory clean up, but not really a leak fix.
276 virt_db: fix leak for naked ptr.
278 cql_rpn: use config relative path for cql2rpn file. MP-481
280 Updates for upcoming YAZ 5.
282 --- 1.3.61 2013/08/29
284 New configuration directories ports.d/routes.d for metaproxy
285 configuration. This allows 3rd party packages to install config
286 for ports and new routes. MP-477
288 --- 1.3.60 2013/08/21
290 Fix metaproxy-config --libs to return non-mt over mt libs.
291 The -mt versions do not exist as shared objects and cause
292 linker errors for applications linking with Metaproxy.
293 Problem present in versions 1.3.56 - 1.3.59. MP-475
295 HTML: clean up char checks. Add ptr to HTML parse spec
297 HTML parser stops eating tag when <-char is met MP-473
299 rewrite: do not even compare content types, if we don't have any
300 the regex_match caused a segfault if we had no content-type in the
303 rewrite: within header=... matches only the header value
304 Used to match the whole header line, but we need to use
305 ^$ anchoring for host-relative regexps, and they need to
306 anchor at the ends of the value. MP-470.
308 rewrite: Ruleset functional MP-469
310 --- 1.3.59 2013/07/12
312 session_shared: negotiate init sz parameters.
313 By default, session_shared will honor the paramters given by client.
314 An alternative, but not implemented, algorithm would be to only
315 re-use sessions with same sz parameters. This however, could reduce
316 re-use of sessions a lot. Hence this, simple algorithm instead. The
317 negotiation to a maximum sz values can be enabled by using
318 <init maximum-record-size="sz1" preferred-message-size="sz2"/>
319 in configuration. This will make session_shared send those values
320 to backends and use returned init values in negotaition to
321 client before session_shared.
323 session_shared: resolve result-set references.
324 The reference is substitued with the query for old set if database
325 match and query type is Type-1. If not the reference will issue a
328 sort filter: relays RecordComposition including elementSet in use for
331 http_client: better diagnostics
333 http_client: disables HTTP redirect handling by default.
334 It can be configured with max-redirects in configuration.
336 --- 1.3.58 2013/06/12
338 Fix loading of filters cql_rpn and sru_z3950 . Was broken by 1.3.57.
340 --- 1.3.57 2013/06/12
342 Make RouterChain and RouterXML part of public API (libmetaproxy).
344 http_client: honor X-Metaproxy-Proxy as an alternative to
345 the "proxy" configuration. Allows proxy to be set per HTTP request.
347 sru_z3950: For SRU requests recognize x-client prefixes as a way
348 to ingest "database parameters".. The suffix of x-client- serves
349 as database argument name. Multiple may be given. For example:
350 http://path/db/?operation=searchRetrieve&x-client-user=a&x-client-password=b
351 is turned into Z39.50 database
354 --- 1.3.56 2013/05/27
356 New filter present_chunk. This filter allows splitting of present requests into smaller chunks.
358 New filter sd_remove, which replaces surrogate diagnostics with
359 SUTRS records. This filter tries to deal with clients that breaks
360 when receiving surrogate diagnostics.
362 new filter http_client. Same role as z3950_client, but just for
363 HTTP. Allows Metaproxy to operate as a HTTP proxy.
365 New filter http_rewrite1, which serves as purpose on how to rewrite
366 HTTP content with Metaproxy.
368 Use libboost-system if available, because newer versions of libboost-threads
369 requires libboost-system.
371 Allow frontend_net to serve SSL/HTTPS, because we can specify a server
374 --- 1.3.55 2013/04/10
376 zoom: Torus setting: authenticationMode which may hold values "basic"
379 --- 1.3.54 2013/03/27
381 configure: check for Libxslt support in YAZ and rely on definitions
382 from yaz-config, rather than doing own xslt/xml2 checks.
384 Allow timestamp format for log lines to be given with option -m
385 for metaproxy. Similar to yaz-ztest/GFS option -m.
387 Document log category 'line' for log filter.
389 Solr configuration example in etc/config-solr.xml
391 multi: do not mess with request package. For scan and search,
392 database-names were modified and the request package was left with
393 dangling pointers that caused a log filter to fail (request package
394 inspected after multi was invoked).
396 Documentation: fix id of metaproxy-config ref .
398 Documentation: update for USEMARCON support.
400 --- 1.3.53 2013/01/31
402 record_transform: allow OPACXML to OPAC conversion
404 zoom: document content-proxy
406 zoom: document db parm content-{user,password}, torus_url. Also
407 <torus auth_url="..> which makes zoom operate in authenticated mode
410 --- 1.3.52 2012/11/30
412 zoom: fix http://-check. SRU search broken in 1.3.51.
414 --- 1.3.51 2012/11/15
416 zoom: only append http:// for SRU if not already given . Makes it
417 possible to use https-URLs.
419 Use yazpp 1.4 or later due to new ABI.
421 frontend_net: allow max package size to be specified. Controlled by
422 attribute 'max_recv_bytes' of element 'port'.
424 --- 1.3.50 2012/10/29
426 For most generated diagnostics by filters, typically temporary
427 system error, augment addinfo message with filter name.
429 Add support for CentOS 6 packages.
431 sru_z3950: interpret Z39.50 diagnostics part of Init Response.
433 Add man page for metaproxy-config.
435 --- 1.3.49 2012/10/18
437 zoom: new config element passthru. This defines an element set that is
438 passed verbatim to the backend in pz2 mode.
440 auth_simple: allow both idPass and open auth. Also fix SEGV that could
443 --- 1.3.48 2012/10/08
445 z3950_client: fix string handling for init diagnostics in the case where
448 query_rewrite: no charset conversion for error queries. Avoid performing
449 charset conversion for query conversion errors. The resulting Type-1
450 query is invalid in this case.
452 --- 1.3.47 2012/10/04
454 For graceful stop (SIGUSR1), metaproxy will kill children processes.
456 Log when metaproxy is invoked in test mode (-t).
458 Log PID for each log message.
460 multi: combine both NSDs and multiple NSDs into one (diagnostics).
462 z3950_client: fixup multiple NSD's too. Like surrogate diagnostics,
463 a (backend=target) is appended for each diagnostic so that can be
464 determined the origin of error.
466 multi: hideerrors also in use for present response.
468 Solr example in zoom man page.
470 Fix typo in query_rewrite config example.
472 Log at least first non surrogate diagnostic. Instead of
473 "Z_Records_multipleNSD"
475 multi: Fix check for opt Records in present response. A SEGV could occur
476 if a target did not return records and no diagnostics.
478 --- 1.3.46 2012/09/24
480 Yet another fix for graceful stop.
482 --- 1.3.45 2012/09/12
484 sru_z3950: relay surrogate diagnostics.
486 --- 1.3.44 2012/09/10
488 zoom: Honor extraArgs, strip # in zurl.
490 multi: fix SEGV for scan. Reported by Rustam T. Usmanov.
492 zoom: url_recipe allow %{var[reg]} substitutions.
493 It's like ${var[reg]} but does URI component encoding as well.
495 --- 1.3.43 2012/08/22
497 RPM/Deb: require yazpp 1.3.2, because it fixes a missing close of
498 non-keepalive HTTP sessions.
500 http_file: allow zero size files (bug fix)
502 Fix zoom schema: auth_url is optional
504 --- 1.3.42 2012/08/20
506 zoom: fix un-init memory (could result in SEGV at session close)
508 frontend_net: handle X-Forwarded-For. This is stored in package.origin()
509 and may be used in filters as usual.
511 zoom: authentication via Torus lookup
512 Enabled by new configuration setting: auth_url . If this is defined,
513 the zoom module will contact Torus for auth/IP lookup and that will
514 define realm to be used in session.
516 --- 1.3.41 2012/08/10
518 virt_db: Fix database name - first character we removed by mistake.
519 Bug introduced in 1.3.40.
521 --- 1.3.40 2012/08/06
523 virt_db: Don't use "unix path" as database for Unix sockets.
525 --- 1.3.39 2012/08/02
527 z3950_client: Don't tamper with / in zurl - fixes problems
528 using Unix sockets for backends.
530 session_shared: fix integer overflow problem with hit count.
532 session_shared: avoid long usage of cached queries.
534 zoom: New database argument , torus_url to set URL of Torus
535 record to be fetched.
537 --- 1.3.38 2012/07/04
539 Fixes for 'metaproxy reload' for RPM/Debian packages.
541 zoom: Allow rpn2cql conversion to be augmented with a properties file.
542 Element rpn2cql can be specified per-target for the zoom filter.
544 log: New category "line" which is a single-line log message with
545 most important parts of a HTTP/Z39.50 request/response.
547 --- 1.3.37 2012/06/01
549 frontend_net: add facility to report live statistics about response
550 times and current thread usage. The report is an XML document
551 and is triggered for a specific URL path. This is set by <stat-req>
552 in the configuration of frontend_net. By default this report is
553 disabled (same as empty value for <stat-req>).
555 Fix reload problem in init.d script for RPM/Debian.
556 The '/etc/init.d/metaproxy reload' in some cases would stop but not
557 start metaproxy - effectively stopping the service.
559 Don't display start log message when config testing (-t).
561 zoom: avoid CCL message limit of 1K in ZOOM filter.
563 --- 1.3.36 2012/05/10
565 metaproxy init script reacts to reload which does graceful stop +
566 start and is used by logrorate script.
568 --- 1.3.35 2012/05/09
570 Fixes for Windows compilation.
572 Metaproxy daemon reacts to SIGUSR1 in which case it will leave
573 existing sessions running but terminate the monitor process that is
574 used in keepalive mode.
576 Change start log message to 'metaproxy start'. Was 'Metaproxy start'
577 before. Consistent with 'metaproxy stop' message.
579 zoom: document zoom's proxy_timeout
581 z3950_client: fixup addinfo for init response
583 virt_db: return other diagnostic if init is rejected. Diagnostic 236:
584 "Access to specified database denied" is returned, but only if init
585 response from backend does not carry diagnostics already.
587 multi: relays user info for first rejected target. The other-information
588 field for init response for first rejected target is in common init
589 response. This ensures that some backend init diagnostics are returned to
592 --- 1.3.34 2012/04/25
594 frontend_log: extend logging (when message is given in config).
596 --- 1.3.33 2012/04/25
598 zoom: Fix check for proxy. Use diagnostic 1074 for proxy failures.
600 --- 1.3.32 2012/04/24
602 sru_z3950 filter passes through incoming Z39.50 requests again. Was
603 not handled by mistake in Metaproxy versions 1.3.29, 1.3.30 and 1.3.31.
605 --- 1.3.31 2012/04/24
607 zoom: fixes for retry/proxy failover logic. More logging.
609 --- 1.3.30 2012/04/23
611 zoom: return addinfo="proxy failure" for proxy failures. This also
612 changes the scheme for dealing with proxies a bit. zoom now always
613 do proxy check, even if there's no failover. Fortunately, that's not
616 zoom: Init rejected wo diagnostics maps to Bib-1:1014.
617 Bib-1 1014, "Init/AC: Authentication System error", seems pretty
618 generic. We don't know why the init would fail; IP, user, block IP, etc.
619 sru_z3950 filter maps this to SRU diagnostic 3: "Authentication error".
621 zoom: guess if invalid SRU response was an auth failure
623 session_shared: disable session retry by default . Can be enabled by
624 restart="true" in resultset section.
626 --- 1.3.29 2012/04/18
628 zoom: may read cf-proxy's config settings.
629 This reduces manual configuration of the content proxy server host.
630 The ZOOM module will use the old style session.proxyhost if "server"
631 is given (deprecated) and use the new style proxyhost/session if
632 "config_file" is in use.
634 frontend_net: remove incoming requests that can not be handled
635 Requests in queue for filter frontend_net are removed if client
636 closes connection for the session and request is not yet handled.
638 sru_z3950: serialize requests. This is to ensure that pipelined
639 HTTP requests are handled properly.
641 --- 1.3.28 2012/04/04
643 New class, wrbuf, that wraps YAZ' WRBUF.
645 --- 1.3.27 2012/03/30
647 Metaproxy daemon is now running as user "metaproxy". This user is
648 managed by package maintainer scripts. The user information is stored
649 in /etc/metaproxy/metaproxy.user .
651 --- 1.3.26 2012/03/20
653 New filter, sort, that allows sorting of XML records via Z39.50
656 Filter record_transform: USEMarcon support. For example:
657 <retrieval syntax="usmarc">
658 <backend syntax="unimarc" name="F">
659 <usemarcon stage1="/etc/usemarcon/uni2us/uni2us.ini"/>
663 Filter multi: empty route pattern uses route as default.
665 <target route="z3950.indexdata.com">z3950.indexdata.com</route>
666 may use the shorter notation
667 <target route="z3950.indexdata.com"/>
669 Filter query_rewrite: use config path to locate XSLT.
671 Filter frontend_net: log statistics.
672 If a custom message element in frontend_net configuration it makes
673 the frontend_net filter produce a log entry whenever an operation
674 is completed. The log is always written using yaz_log with the
675 custom message given, the package ID (session ID) , the time
676 the operation has been active (end-to-end) , the threads currently
677 active/total and the size of the request input/output queues.
679 query_rewrite: charset conversion of query terms.
680 This is an optional feature. Enabled by element <charset> in
681 configuration with attribute 'from' and 'to' that specifies
682 from/to encodings. The default 'from' encoding is UTF-8.
684 Filter record_transform: honor piggyback searches.
686 Filter zoom: re-connect when database is reused.
687 Re-connect is necessary if a connection is lost or a timeout occurs.
688 If not, we'll be seeing zero hits, when we shouldn't.
690 --- 1.3.25 2012/02/29
692 zoom: Change scheme for dealing with content proxy URLs. The module
693 now has its own common XSL transform that is enabled by record_xsl
694 attribute in the configuration. This XSL gets parameter cproxyhost
695 that holds the host for the content proxy session . The genearted-url
696 is created only if urlRecipe is enabled. In previous version default
697 value of urlRecipe was ${md-electronic-url}; it is now empty and
698 disabled by default. Also generated-url no longer includes the content
699 proxy host. Content proxying URLs is supposed to the handle in the record_xsl
702 zoom: new setting timeout that specifies timeout for outgoing Z39.50/SRU
703 connections. Default value is 40 (seconds).
705 zoom: tune CCL to Z39.50 diagnostics mapping. Throw Bib-1: 108
706 "Malformed query" for syntax errors and related ones; throw
707 Bib-1: 3 "Unsupported search" for everything else. Details from
708 the CCL parser is provided as additional-info.
710 multi: new setting hideerrors that makes multi only relay diagnostics
711 to a client if all backends fail.
713 --- 1.3.24 2012/02/23
715 zoom: empty ccl_map field-mappings disables CCL map.
717 zoom: fix Explain search that could return error if session was
720 --- 1.3.23 2012/02/10
722 zoom: returns Explain records for database IR-Explain---1. The
723 target profile records are converted to Explain records via XSLT.
725 session_shared: make error recovery configurable. Whether a search
726 is restarted on errors or not, is configurable by attribute "restart"
727 in element "resultset" in configuration.
729 session_shared: only relay init for first request. session_shared, for
730 each backend class, now only relays first init request (rather than all).
731 The module only needs to save init response info once. This avoids the
732 need to check for session max.
734 --- 1.3.22 2012/02/02
736 zoom: fix memory leaks.
738 session_shared: maximum number of sessons is configurable. Default
739 value is 100. Result-sets for backends without named result sets are
740 only re-used if databases is identical for a search. This is under the
741 assumption that performance may suffer for those backends when
742 changing the database for each search.
744 multi: combines diagnostics from all backends. All diagnostics from
745 backends are combined into multiple non-surrogate diagnostics; rather
746 than just one diagnostic from first backend.
748 --- 1.3.21 2011/12/27
750 zoom: relay realm to cproxy parameter file.
752 Configuration: Allow filter collection element inside route. This
753 makes it possible to include multiple filters at once.
755 zoom: nocproxy also disables urlRecipe.
757 --- 1.3.20 2011/12/21
759 zoom: return diagnostic if CQL sortby conv fails. Diagnostic Bib-1 214
760 "Illegal sort relation" is returned. Gets translated to SRU diagnostic
761 90: "Unsupported direction value".
763 zoom: honor database argument nocproxy. This disables creating a content
764 connector session (for non-CF targets, usually) and also relays nocproxy
765 as database argument to a CF target.
767 --- 1.3.19 2011/12/16
769 zoom: Multiple proxy hosts may be given for proxy rich database
770 parameter. List is comma separated.
772 http_file: decodes URI paths properly. Does not return 404: not found
773 if no prefix are matches. Instead packages are passed on.
775 --- 1.3.18 2011/12/08
777 zoom: content-{user,password,proxy} are passed on to content proxy
778 system and takes precedence over user,password,proxy .
780 sru_z3950: SRU extra argument x-log-enable=1 enables a search response
781 with a log element including log material from children filters. At
782 this point, only the zoom filter uses this log facility. It will
783 eventually be used by other filters as well. In particular it might be
784 useful for this feature to track all filters in used during a search.
786 zoom: for x-log-enable=1, APDUs sent by ZOOM C, records as received
787 and queries as they are manipulated are logged.
789 zoom: extend addinfo with native diagnostics. Diagnostics as received
790 by ZOOM C are put into addinfo - including ZOOM, HTTP, SRU and Bib-1
791 diagnostics. This indicates both a backend diagnostic and the original
794 zoom: default urlRecipe value is ${md-electronic-url}
796 zoom: target profile setting sruVersion is recognized.
798 --- 1.3.17 2011/11/17
800 zoom: log target profile record fetched (AKA Torus).
802 --- 1.3.16 2011/11/17
804 Change target profile parameter CfSubDb to CfSubDB.
806 --- 1.3.15 2011/11/12
808 zoom: bug fix: realm was relayed to CF targets by mistake (realm only
809 makes sense to the zoom module itself).
811 --- 1.3.14 2011/11/11
813 zoom: realm may be given as part of database.
815 --- 1.3.13 2011/10/26
817 Fix Origin class assigment method; was removd by mistake in 1.3.12.
819 --- 1.3.12 2011/10/26
821 zoom: database args x-name=value are passed through to backend database.
823 SRU filter: user may specify session ID that is passed to log entries
824 that follows. It is specified by using x-session-id in the SRU arguments.
826 zoom: fix null pointer reference which would occur for bad url parameter
827 inside "torus" or if url was not given.
829 --- 1.3.11 2011/09/09
830 Fix bug in filter session_shared where sessions would not expire
831 properly (session ttl). This in turn could make the target close the
832 connection before expected and session_shared would return diagnostic
833 2: system temporarily available.
835 --- 1.3.10 2011/09/09
837 zoom: new target profile setting: sortmap_field. If sortmap_field is given
838 the field is mapped to the value for the sortmap. Values not matching
839 sortmap_field are passed verbatim.
841 zoom: new target profile setting: sortStrategy. One of: "z3950", "type7",
842 "cql", "sru11" or "embed". The "embed" chooses type-7 or CQL sortby
843 depending on whether RPN or CQL is actually sent to the target.
847 zoom: urlRecipe result is stored in <pz:metadata type="generated-url">.
849 zoom: For content proxy authentication is stored in param name
850 "auth", instead of "authentication".
854 zoom: relay schema in SRU mode. Previously recordSchema was not affected
859 zoom: new target profile element literalTransform that holds XSLT
860 (encoded as string) for target. Only if present and non-zero length it is
861 considered present. This takes precedence over transform.
863 Don't rely on trang anymore for Git checkout builds. Configuration in etc
864 will only be properly validated if trang is available. From now on only
865 relax NC files are bundled with the source dist.
867 Updates to check for Boost unit test (autoconf stuff). On MacOSX this
868 component was not detected when it should be.
872 z3950_client: mark non-surrogate diagnostics from backend.
874 zoom: a proxy may be specified for HTTP fetch of target profiles.
878 Honor piggyback. Makes some SRU targets behave that insist on
879 maximumRecords > 0, but also increases performance.
883 Fix dlpath in installed metaproxy.xml for RPM/Deb package. The
884 file was not update for libdir/metaproxy4 in version 1.3.2.
888 Change location of Metaproxy modules from libdir/metaproxy to
889 libdir/metaproxy4. Directory libdir/metaproxy is also owned by
890 libmetaproxy3 and, thus, should not be used by libmetaproxy4.
892 New facility to dump APDUs from zoom filter. Enabled by
893 <log apdu="true"/> in the zoom filter configuation.
895 zoom filter bug fix: SRU diagnostics received from backend was
896 not properly converted to Bib-1 diagnostics.
898 Package metaproxy depends on libmetaproxy4, same version.
902 zoom: fix a bug WRT passing authentication parameters to backends.
906 Fixes for windows Makefile.
908 --- 1.2.10 2011/07/25
910 Change major version of metaproxy library from 3 to 4. This in turn
911 makes new package names for Debian and RPM.
915 zoom: enable marc-8 encoding by default for usmarc and opac (in pz2
918 zoom: configurable element sets for record transforms.
920 zoom: the target profile based transform is specified by element_transform
921 in element torus of of the ZOOM filter configuration ; default value
922 is "pz2". Target profile based retrieval is specified by element_raw
923 in configuration. It will perform same steps, but omit the XSL transform.
924 Default value is "raw".
926 zoom: element set is omitted if not set in profile. But only if pz2
927 transform is in effect. Previously the default element set was to "F".
929 zoom: For non-CF targets database arguments are parsed. User may supply
930 db,user=myuser&password=mypass for non-CF targets. These values override
931 what's given the authentication from the target profile.
933 session_shared: fix reference to freed memory. Would occur if a search
934 response had non-surrogate diagnostics.
938 Route may be given for each port in frontend_net.
942 Documentation for zoom filter. Local target profiles may be specified.
944 Fixes for zoom filter.
948 First version with zoom filter.
952 Filter z3950_client may be configured to always send a close APDU
953 to backend target when connection/session is closed. This will only
954 happen if close APDU is not already sent. Enabled by configuration
955 for z3950_client (force_close).
957 Filter virt_db and multi: relay close APDU.
959 Filter virt_db and multi: relay init size parameters
960 preferredMessageSize and maximumRecordSize.
962 Filter sru_z3950: increase init sz parameters from 1MB to 10 MB.
966 RPM package for Metaproxy works for both SLES11 and Centos 5.5.
968 metaproxy-config: exec_prefix, libdir, includedir. Use these variables
969 as determined by configure.
971 RPM: Release includes 'indexdata' name. Use indexdata in release name so
972 this package can be distinguished from other vendors.
976 Fix filter multi: relay idAuthentication parameters.
980 Add metaproxy-config for returning compiler flags, libraries.
984 Fix --with-boost=PREFIX .
988 session_shared: fix use of maintenance thread.
990 Introduce 'start' method for filters and routers. It gets called after
991 configure and after fork, but before processing. This changes API -
992 from libmetaproxy2 to libmetaproxy3.
996 session_shared: ensure backend session is closed if init rejected
999 z3950_client: fix NULL ptr reference that could occur if two clients
1000 connected concurrently and if max-sockets was in effect.
1002 --- 1.1.6 2010/06/21
1004 Fix bug 3497 - Metaproxy unstable while stopping.
1006 Fix bug 3495 - SEGV in SRU filter.
1008 --- 1.1.5 2010/06/15
1010 Filter multi throws diagnostic 'Present Out of Range' when
1011 appropriate - rather than returning 0 records.
1013 Filter virt_db: fix bad result reuse. Could happen if a result
1014 was overriden and a backend did not supported named result sets.
1016 --- 1.1.4 2010/05/11
1018 Filter log: category access logs diagnostics even if searchStatus
1019 or presentStatus is 'success'.
1021 --- 1.1.3 2010/04/21
1023 The SRU to Z39.50 filter does repeated Z39.50 present requests
1024 to fetch all records. Needed when a Z39.50 server returns partial
1025 results (due to message size limits).
1027 --- 1.1.2 2010/03/18
1029 Metaproxy now kills all child processes that are spawned by
1030 modules (in case of fork, exec).
1032 --- 1.1.1 2010/01/28
1034 Debian package now installs /etc/metaproxy/metaproxy.xml which
1035 includes all XML files /etc/metaproxy/filters-enabled .
1036 The include facility uses YAZ' yaz_xml_include_simple (YAZ 4.0.1).
1038 --- 1.1.0 2010/01/20
1040 Package based on YAZ version 4 and YAZ++ 1.2.0. It now includes a
1041 development package to facilitate 3rd party Metaproxy modules.
1043 --- 1.0.23 2010/01/04
1045 Filter virt_db: Close backend filter session when Init rejected is received
1046 from it (in which case it's not really closed yet). This will ensure we don't
1047 run out of resources such as FDs in this case.
1049 sru_z3950 filter: Accept any database (including those not listed).
1051 --- 1.0.22 2009/12/03
1053 Prepare for 64-bit YAZ. yazproxy will still work with YAZ++ 1.1.4 or
1054 later which means YAZ 3.0.47 or later.
1056 --- 1.0.20 2009/11/19
1058 For filter virt_db, the database is a glob pattern and the virtual
1059 database sections are consulted in the order given.
1061 --- 1.0.19 2009/07/08
1063 For filter multi, the target (for routing) may be given as a glob-pattern.
1065 More documentation for filters virt_db and multi.
1067 Update schema to allow for no database in sru_z3950 filter.
1069 --- 1.0.18 2009/06/30
1071 Added limit filter to put sleep (penalty) for heavy use.
1073 Filter frontend_net may be configured to limit the number of new connections
1074 from same IP to some value (connect-max).
1076 Fixed the load_balance filter.
1078 --- 1.0.17 2009/06/16
1080 Fix path for metaproxy executable for Debian init.d script.
1082 --- 1.0.16 2009/06/10
1084 SRU to Z39.50 filter honors x-username and x-password. If only
1085 x-username is given that translates to open authentication (Z39.50v2). If
1086 both x-username and x-password is present that translates to idPass
1087 authentication (Z39.50v3).
1089 New facility to change current working directory (-w).
1091 Update to upstream skeleton of init.d script. Should fix bug #2619.
1093 Filter session_shared now caches records (used to only cache connections
1096 Filter session_shared now invalidates a Z39.50 session if a server
1097 returns -1 hits. This facility was also part of yazproxy and gets around
1098 a bug in Voyager-based Z39.50 servers.
1100 --- 1.0.15 2008/11/18
1102 Fixed reference counting bug in Z39.50 client module (could cause SEGV).
1104 --- 1.0.14 2008/06/09
1106 Fixed the value of SRU record schema in searchRetrieve response. It was set
1107 to a fixed value of "dc" before.
1109 Serialize identical SRU requests. This is useful if HTTP client software
1110 fires identical requests against metaproxy.
1112 Allow Z39.50 target to be specified for SRU requests by using SRU extra
1113 parameter x-target. Allows SRU to contact arbitrary Z39.50 targets and
1114 avoid static configuration. This facility is handled by the sru_z3950 module
1115 and the z3950_client module.
1117 Allow maximum number of sockets to be used for a Z39.50 client by the
1118 use of SRU extra parameter x-max-sockets. This facility is handled by the
1119 sru_z3950 module and the z3950_client module.
1121 --- 1.0.13.1 2008/02/29
1123 Simplified check for Boost libraries.
1125 --- 1.0.13 2008/02/29
1127 First Debian package.
1129 The sru_z9350 filter now recognizes SRU parameter z-target as being
1130 a ZURL of the form host/database .
1132 Mergetype may be specified for filter 'multi'.
1134 --- 1.0.12 2007/09/19
1136 Fixed problem in Makefile WRT library specifictions. This could produce
1137 linker errors (when they should not happen).
1139 Fixed bug #1341: MetaProxy returning different results. Problem was that
1140 fix-up of record database did not normalize the database name.
1142 Documentation updates for Windows compilation.
1144 --- 1.0.11 2007/06/14
1146 Fixed problem with logfile being truncated.
1148 --- 1.0.10 2007/05/23
1150 Fixed bug #1136: Access rights not enforced.
1152 Extension for log module. The log category 'access' logs more details.
1153 New category 'user-access' added which is simlar to 'access' but adds
1154 the Z39.50 user as for all entries in a session.
1158 Added support for configurable default/force target/vhost for module Z39.50
1161 --- 1.0.8 2007/01/25
1163 Implemented filter, session_shared, which optimizes usage of Z39.50
1164 sessions and result sets.
1166 New filter, record_transform, which converts MARC/XML records.
1168 New filter, sru_z3950, which converts SRU to Z39.50 packages.
1170 New filter, load_balance, in development.
1172 New filter, zeerex_xplain.
1174 XML framework for config files started.
1176 Master RelaxNG Compact schema's are found in xml/schema/*.rnc,
1177 RelaxNG XML schemas and XML Schema's are generated from RNC syntax.
1178 XML config files are checked against RNG and XML Schema's.
1180 XSLT transformation framework added in xml/xslt/*.xsl, consisting mainly of
1181 LOC Marc21 stylesheets found at http://www.loc.gov/marcxml/xslt.
1182 Added stylesheet explain2cqlpqftxt.xsl which transforms a standard SRU ZeeReX
1183 explain record to YAZ CQL-to-PQF text config file.
1185 --- 1.0.7 2006/11/07
1187 Added 'timeout' setting for filter frontend_net which specifies the number
1188 of seconds a session is idle before it is closed. Default timeout is
1191 --- 1.0.6 2006/07/07
1193 Database name in records returned set for virt_db/multi filters.
1195 Filter session_shared now functional.
1197 Log filter can be configured to write to a given file using 'filename'
1198 element. Also information category can be specified with 'category'. If
1199 filename is omitted, the log filter writes to stdout. See etc/config5.xml
1202 --- 1.0.5 2006/05/16
1204 Fixed compilation on Windows.
1206 --- 1.0.4 2006/05/16
1208 Added documentation for the hidenavailable option for the multi filter.
1210 --- 1.0.3 2006/05/16
1212 Fixed bug #573: Hide errors for individual servers. If the element
1213 'hideunavailable' is given in the configuration, individual servers
1214 being unavailable are hidden (unless all are unavailable).
1216 Fixed bug #574: Database names are recognised case-sensitively.
1218 Fixed bug #567: Fix up database name in Name-Plus-Record.
1220 Fixed bug #568: Update win/makefile for VS 2005.
1222 Fixed bug #569: Some options throws unknown exception.
1224 --- 1.0.2 2006/04/28
1226 More information about virtual hosts. The 'etc' directory is part of the
1229 --- 1.0.1 2006/04/27
1231 Build instructions for Windows. NMake makefile part of distribution tar.
1233 --- 1.0.0 2006/04/24
1237 Filters functional: auth_simple, backend_test, frontend_net, http_file,
1238 log, multi, query_rewrite, template, virt_db, z3950_client.
1240 Filters in development: session_shared.
1242 Pseudo-filters: template, dl