3 sru_z3950: allow CCL in SRU search MP-606
4 Makes the sru_z3950 filter convert to CCL queries if query type
5 "ccl" is used, eg ?query=water&queryType=ccl&... for SRU 2.0.
9 Fix dead lock in session_shared (init) MP-605
13 Fix session_shared caches set with diagnostic MP-604
15 Fix assertion failed in session_shared filter MP-603
17 Make /usr/share/metaproxy be part of metaproxy RPM MP-601
19 Log YAZ version upon start MP-599
23 sru_z3950: undo Serialize identical SRU GET requests MP-598
24 Now much more elegantly handled by session_shared.
26 session_shared: anticipated init and search MP-597
28 z3950_client: separate init timeout MP-596
29 Both init-timeout and connect-timeout are configurable by this change.
30 Default is 10 seconds.
34 zoom: support cf_-params MP-595
36 http_client: returns 404 if no destination URI is given
40 zoom: allow / in user and password db args MP-592
44 Log rotate no longer reloads configuration - instead Metaproxy just
45 re-opens log files when SIGHUP is received. MP-485
47 Debian : init.d metaproxy reload should check configuration MP-591
49 Fix Metaproxy stops logging after check config failed MP-590
53 Fix double free in log filter (with incorrect config) MP-589
55 zoom: Add allow_ip feature - fixes MP-588
56 Allow a list of IPs to be given separated by blanks
57 <allow auth_url="http://mkc-admin.indexdata.com/..."
58 allow_ip="127.0.0.1 ::1" .. >
60 cql2pqf.txt: Maps dc.subject to Bib-1 21 rather than 47
62 zoom: fix CS write-check
66 zoom: handle contentAuthentication MP-587
70 Destroy router and filters in parent process MP-584
72 Update NMAKE makefile to use Visual Studio 2013 along with Boost 1.57,
73 ICU 54.1, Libxml2 2.9.2, Libxslt 1.1.28.
77 Use YAZ backtrace facility MP-582
79 Fix libmetaproxy-dev depends on libgnutls-dev - MP-580
80 libgnutls-dev is unavailable on jessie.
82 Update template filter to avoid Pimpl MP-579
84 cgi: POSTed content - part of MP-562
86 Fix filter cgi does not relay session close MP-577
90 Add support for binding outgoing IP for http_client and z3950_client
91 This is enabled by bind_host setting. MP-575
95 z3950_client: allows negotiation charset to be set MP-574
97 cgi: more functional but no support for POSTed content yet (part of MP-564)
101 http_file: add include of sys/stat.h fixes MP-576
103 Fix documentation about SRU client support MP-572
105 Initialize Libxml2 - for threaded operation MP-571
107 --- 1.5.10 2014/08/26
109 On SIGTERM shut down connection+listening sockets MP-568
110 This fixes a problem with 'metaproxy stop' sometimes taking a long time.
114 zoom: make retry on failure configurable MP-565
115 The default and existing behavior is that backend failures (any
116 diagnostic) makes the module re-search once. The behavior may
117 be changed by db parameter 'retry'. If given value '0' disables
118 retry and '1' enables it. If not given, the Torus record may
119 specify with element retryOnFailure (value '0'/'1').
123 Fix race condition in SIGTERM handling. Could terminate whole metaproxy
124 instead of just a child process. Extremely rare in real life, hit me with
125 CF stress testing. MP-559.
129 http_file: passthru option MP-557
130 New facility for http_file to passthru - even if an area is matched. The
131 default behavior (passthru=false) is to return 404: Not found. With
132 passthru=false, next filter is consulted.
136 Fix ref to freed memory in log filter 1line - MP-556
138 echoedSearchRetrieveRequest support MP-555
142 zoom: allow hostname to be given for ipauth MP-552
143 The Torus setting for that is called auth_hostname.
147 zoom: IP auth use field "ipRanges" rather than "ip" MP-551
151 session_shared: close in ~BackendInstance MP-549
152 This fixes a serious issue where some MP would leak sockets.
154 session_shared: mutex lock in BackendClass::release_backend MP-550
155 Fixes a SEGV that could occur (in rare cases).
159 zoom: Do not include ZOOM C's fake surrogate diag recs MP-547
161 zoom: fix invalid present response in some cases MP-546
163 zoom: Relay Torus HTTP error message
167 Check for proper limits before using RecordCache functions MP-544
171 Build packages for Ubuntu Trusty Tahr 14.04 LTS
173 sort: crash / invalid_read in filter sort MP-541
175 sru_z3950: facet should be stored in additionalSearchInfo MP-533
177 doc: fix missing man pages MP-542
179 cql_rpn: fix threading problem with CQL to RPN conversion MP-497
181 cql_rpn: allow conversion from RPN to CQL (reverse) MP-537
185 sru_z3950: fix facet response (memory corruption) MP-532
187 log: fix crash idPass user is omitted MP-530
191 query_rewrite: pass-thru non Type-1 queries MP-527
193 metaproxy stop (SIGTERM) kills all child processes spanwed by
194 filter (if any) before invoking filter destructors. MP-525
198 http_file: only supports HTTP GET MP-523
200 session_shared: shut down expire thread in destructor
201 This ensures that expire thread is not running after destruction
202 and does bad memory references, etc.
204 frontend_net: fix segfault on startup MP-524
205 Would happen if MP was listening on multiple ports and one
206 of the ports was already in use (and MP would exit).
208 frontend_net: fix memory leak MP-521
209 This leak would occur if all sessions were in use and the input
210 queue was cleared when a client would close connection (socket).
212 frontend_net: fix compilation on Windows (SIGUSR1 does not exist)
216 http_rewrite: use local skiplist; fixes memory corruption. MP-520
218 http_client: x-forwarded-for controls X-Forwarded-For presence
219 If x-forwarded-for setting (boolean) is enabled, http_client will
220 generate an X-Forwarded-For header entry which includes existing
221 X-Forwarded-For (if any) and current peer address (immediate client
222 of Metaproxy). By default x-forwarded-for disabled and X-Forwarded-For
223 will not be generated.
225 z3950_client: client_ip controls client-IP presence
226 If client_ip setting (boolean) is enabled, z3950_client will
227 generate a client_ip OID as part of init request which includes
228 previous client_ip (if any) and current peer address (immediate
229 client of Metaproxy). By default client_ip is disabled and client_ip
230 will not be generated.
232 HTTP X-Forwarded-For/Z39.50 Client-IP support
233 virt_db, multi: relays Z39.50 client-IP.
234 sru_z3950: converts X-Forwarded-For header to Z39.50 client-IP.
235 zoom: uses Client-IP or origin address (prefer Client-IP).
236 frontend_net: Strips tcp: from peer address (so that it is no longer
237 printed and stripped in zoom filter).
238 z3950_client: builds client-IP list - combining immediate peer address
239 as returned by COMSTACK and existing client-IP list (if avaiable).
240 The Origin only printes first X-Forwarded address.
244 Log when SIG{TERM,USR1} is received ASAP MP-513
245 Do it in frontend_net event loop rather than in place for metaproxy
246 main, which only exits when all sessions are terminated for SIGUSR1
249 metaproxy-config: quote some RHS values (that might include blanks)
251 Fix leak in sru_z3950 filter - when explain is returned MP-511
253 Allow stylesheet to be given for sru_z3950 filter MP-510
254 This is based on a patch by Sven Porst and the functionality
255 of the YAZ Generic Frontend Server.
257 Allow base attribute in configuration file tags - the attributes are
258 inserted by XInclude usage as mentioned on
259 yazlist: http://lists.indexdata.dk/pipermail/yazlist/2012-Au
260 and noted in a gist: https://gist.github.com/3551094
262 Package metaproxy provides virtual package metaproxy6 MP-508
263 This allows module packages to depend on a metaproxy server
266 Filter destructors called upon daemon termination MP-505
267 When metaproxy daemon receives SIGTERM the stop method of each filter
268 is called. The stop method existed before, but did not take any
269 arguements (void).. The frontend_net filter can now distinguish
270 between SIGUSR1 (stop bind, but keep sessions running) and SIGTERM
271 (stop immediately). Note that this changes the API+ABI of Metaproxy
274 zoom: sync up with Pazpar2 WRT authentication handling MP-492
276 Router: use shared_ptr rather than naked one - to avoid leak if an
277 exception is thrown in configure.
281 zoom: Add nocproxy=1 for contentConnector sessions MP-501
283 Doc: mention proper versions; fix link to Boost win binaries.
285 Windows: update for Boost 1.55
287 Windows: avoid warning when using boost::split. Done by defining
288 _SCL_SECURE_NO_WARNINGS for Visual Studio.
290 Fix LSB conformance for /etc/init.d/metaproxy MP-500
291 Debian: add support for /etc/init.d/metaproxy status
293 sort: Add const to Record less than operator in order to compile on
298 session_shared: fix element-set handling in record caching. MP-499
300 document http_rewrite. MP-468
302 http_write: Honor X-Metaproxy-SkipLink MP-479 . Filter understands and
303 respects the header (which will normally come from the cproxy filter)
307 RPM: fix dependency for libmetaproxy5-devel MP-496. The libmetaproxy5-devel
308 RPM was unsable in version 1.4.0.
310 Remove log message about "backend classes". Appeared in version 1.4.0.
314 Build RPM/Deb packages with YAZ 5 and yazpp 1.5. Metaproxy still compiles
315 with older version from source, but packages now use YAZ 5 that supports
318 sru_z3950: Fix SEGV for decoding invalid SRU requests
319 Incorrect reference to union (was explain response rather than
322 session_shared: match additionalSearchInfo (includes facets). In
323 layman's terms means that means that facets are properly handled
324 by this filter. Eg a change in requested facets will issue new
325 search and facets from exisiting result set are cached.
327 --- 1.3.62 2013/09/11
329 http_rewrite: better handling of <script> content in HTML parser. MP-486
331 http_rewrite: fix threading issue with regex. MP-482
333 bounce: don't use strdup for fixed length content. Error occurred in echo
336 session_shared: expire backend class when no instances left. This
337 means memory clean up, but not really a leak fix.
339 virt_db: fix leak for naked ptr.
341 cql_rpn: use config relative path for cql2rpn file. MP-481
343 Updates for upcoming YAZ 5.
345 --- 1.3.61 2013/08/29
347 New configuration directories ports.d/routes.d for metaproxy
348 configuration. This allows 3rd party packages to install config
349 for ports and new routes. MP-477
351 --- 1.3.60 2013/08/21
353 Fix metaproxy-config --libs to return non-mt over mt libs.
354 The -mt versions do not exist as shared objects and cause
355 linker errors for applications linking with Metaproxy.
356 Problem present in versions 1.3.56 - 1.3.59. MP-475
358 HTML: clean up char checks. Add ptr to HTML parse spec
360 HTML parser stops eating tag when <-char is met MP-473
362 rewrite: do not even compare content types, if we don't have any
363 the regex_match caused a segfault if we had no content-type in the
366 rewrite: within header=... matches only the header value
367 Used to match the whole header line, but we need to use
368 ^$ anchoring for host-relative regexps, and they need to
369 anchor at the ends of the value. MP-470.
371 rewrite: Ruleset functional MP-469
373 --- 1.3.59 2013/07/12
375 session_shared: negotiate init sz parameters.
376 By default, session_shared will honor the paramters given by client.
377 An alternative, but not implemented, algorithm would be to only
378 re-use sessions with same sz parameters. This however, could reduce
379 re-use of sessions a lot. Hence this, simple algorithm instead. The
380 negotiation to a maximum sz values can be enabled by using
381 <init maximum-record-size="sz1" preferred-message-size="sz2"/>
382 in configuration. This will make session_shared send those values
383 to backends and use returned init values in negotaition to
384 client before session_shared.
386 session_shared: resolve result-set references.
387 The reference is substitued with the query for old set if database
388 match and query type is Type-1. If not the reference will issue a
391 sort filter: relays RecordComposition including elementSet in use for
394 http_client: better diagnostics
396 http_client: disables HTTP redirect handling by default.
397 It can be configured with max-redirects in configuration.
399 --- 1.3.58 2013/06/12
401 Fix loading of filters cql_rpn and sru_z3950 . Was broken by 1.3.57.
403 --- 1.3.57 2013/06/12
405 Make RouterChain and RouterXML part of public API (libmetaproxy).
407 http_client: honor X-Metaproxy-Proxy as an alternative to
408 the "proxy" configuration. Allows proxy to be set per HTTP request.
410 sru_z3950: For SRU requests recognize x-client prefixes as a way
411 to ingest "database parameters".. The suffix of x-client- serves
412 as database argument name. Multiple may be given. For example:
413 http://path/db/?operation=searchRetrieve&x-client-user=a&x-client-password=b
414 is turned into Z39.50 database
417 --- 1.3.56 2013/05/27
419 New filter present_chunk. This filter allows splitting of present requests into smaller chunks.
421 New filter sd_remove, which replaces surrogate diagnostics with
422 SUTRS records. This filter tries to deal with clients that breaks
423 when receiving surrogate diagnostics.
425 new filter http_client. Same role as z3950_client, but just for
426 HTTP. Allows Metaproxy to operate as a HTTP proxy.
428 New filter http_rewrite1, which serves as purpose on how to rewrite
429 HTTP content with Metaproxy.
431 Use libboost-system if available, because newer versions of libboost-threads
432 requires libboost-system.
434 Allow frontend_net to serve SSL/HTTPS, because we can specify a server
437 --- 1.3.55 2013/04/10
439 zoom: Torus setting: authenticationMode which may hold values "basic"
442 --- 1.3.54 2013/03/27
444 configure: check for Libxslt support in YAZ and rely on definitions
445 from yaz-config, rather than doing own xslt/xml2 checks.
447 Allow timestamp format for log lines to be given with option -m
448 for metaproxy. Similar to yaz-ztest/GFS option -m.
450 Document log category 'line' for log filter.
452 Solr configuration example in etc/config-solr.xml
454 multi: do not mess with request package. For scan and search,
455 database-names were modified and the request package was left with
456 dangling pointers that caused a log filter to fail (request package
457 inspected after multi was invoked).
459 Documentation: fix id of metaproxy-config ref .
461 Documentation: update for USEMARCON support.
463 --- 1.3.53 2013/01/31
465 record_transform: allow OPACXML to OPAC conversion
467 zoom: document content-proxy
469 zoom: document db parm content-{user,password}, torus_url. Also
470 <torus auth_url="..> which makes zoom operate in authenticated mode
473 --- 1.3.52 2012/11/30
475 zoom: fix http://-check. SRU search broken in 1.3.51.
477 --- 1.3.51 2012/11/15
479 zoom: only append http:// for SRU if not already given . Makes it
480 possible to use https-URLs.
482 Use yazpp 1.4 or later due to new ABI.
484 frontend_net: allow max package size to be specified. Controlled by
485 attribute 'max_recv_bytes' of element 'port'.
487 --- 1.3.50 2012/10/29
489 For most generated diagnostics by filters, typically temporary
490 system error, augment addinfo message with filter name.
492 Add support for CentOS 6 packages.
494 sru_z3950: interpret Z39.50 diagnostics part of Init Response.
496 Add man page for metaproxy-config.
498 --- 1.3.49 2012/10/18
500 zoom: new config element passthru. This defines an element set that is
501 passed verbatim to the backend in pz2 mode.
503 auth_simple: allow both idPass and open auth. Also fix SEGV that could
506 --- 1.3.48 2012/10/08
508 z3950_client: fix string handling for init diagnostics in the case where
511 query_rewrite: no charset conversion for error queries. Avoid performing
512 charset conversion for query conversion errors. The resulting Type-1
513 query is invalid in this case.
515 --- 1.3.47 2012/10/04
517 For graceful stop (SIGUSR1), metaproxy will kill children processes.
519 Log when metaproxy is invoked in test mode (-t).
521 Log PID for each log message.
523 multi: combine both NSDs and multiple NSDs into one (diagnostics).
525 z3950_client: fixup multiple NSD's too. Like surrogate diagnostics,
526 a (backend=target) is appended for each diagnostic so that can be
527 determined the origin of error.
529 multi: hideerrors also in use for present response.
531 Solr example in zoom man page.
533 Fix typo in query_rewrite config example.
535 Log at least first non surrogate diagnostic. Instead of
536 "Z_Records_multipleNSD"
538 multi: Fix check for opt Records in present response. A SEGV could occur
539 if a target did not return records and no diagnostics.
541 --- 1.3.46 2012/09/24
543 Yet another fix for graceful stop.
545 --- 1.3.45 2012/09/12
547 sru_z3950: relay surrogate diagnostics.
549 --- 1.3.44 2012/09/10
551 zoom: Honor extraArgs, strip # in zurl.
553 multi: fix SEGV for scan. Reported by Rustam T. Usmanov.
555 zoom: url_recipe allow %{var[reg]} substitutions.
556 It's like ${var[reg]} but does URI component encoding as well.
558 --- 1.3.43 2012/08/22
560 RPM/Deb: require yazpp 1.3.2, because it fixes a missing close of
561 non-keepalive HTTP sessions.
563 http_file: allow zero size files (bug fix)
565 Fix zoom schema: auth_url is optional
567 --- 1.3.42 2012/08/20
569 zoom: fix un-init memory (could result in SEGV at session close)
571 frontend_net: handle X-Forwarded-For. This is stored in package.origin()
572 and may be used in filters as usual.
574 zoom: authentication via Torus lookup
575 Enabled by new configuration setting: auth_url . If this is defined,
576 the zoom module will contact Torus for auth/IP lookup and that will
577 define realm to be used in session.
579 --- 1.3.41 2012/08/10
581 virt_db: Fix database name - first character we removed by mistake.
582 Bug introduced in 1.3.40.
584 --- 1.3.40 2012/08/06
586 virt_db: Don't use "unix path" as database for Unix sockets.
588 --- 1.3.39 2012/08/02
590 z3950_client: Don't tamper with / in zurl - fixes problems
591 using Unix sockets for backends.
593 session_shared: fix integer overflow problem with hit count.
595 session_shared: avoid long usage of cached queries.
597 zoom: New database argument , torus_url to set URL of Torus
598 record to be fetched.
600 --- 1.3.38 2012/07/04
602 Fixes for 'metaproxy reload' for RPM/Debian packages.
604 zoom: Allow rpn2cql conversion to be augmented with a properties file.
605 Element rpn2cql can be specified per-target for the zoom filter.
607 log: New category "line" which is a single-line log message with
608 most important parts of a HTTP/Z39.50 request/response.
610 --- 1.3.37 2012/06/01
612 frontend_net: add facility to report live statistics about response
613 times and current thread usage. The report is an XML document
614 and is triggered for a specific URL path. This is set by <stat-req>
615 in the configuration of frontend_net. By default this report is
616 disabled (same as empty value for <stat-req>).
618 Fix reload problem in init.d script for RPM/Debian.
619 The '/etc/init.d/metaproxy reload' in some cases would stop but not
620 start metaproxy - effectively stopping the service.
622 Don't display start log message when config testing (-t).
624 zoom: avoid CCL message limit of 1K in ZOOM filter.
626 --- 1.3.36 2012/05/10
628 metaproxy init script reacts to reload which does graceful stop +
629 start and is used by logrorate script.
631 --- 1.3.35 2012/05/09
633 Fixes for Windows compilation.
635 Metaproxy daemon reacts to SIGUSR1 in which case it will leave
636 existing sessions running but terminate the monitor process that is
637 used in keepalive mode.
639 Change start log message to 'metaproxy start'. Was 'Metaproxy start'
640 before. Consistent with 'metaproxy stop' message.
642 zoom: document zoom's proxy_timeout
644 z3950_client: fixup addinfo for init response
646 virt_db: return other diagnostic if init is rejected. Diagnostic 236:
647 "Access to specified database denied" is returned, but only if init
648 response from backend does not carry diagnostics already.
650 multi: relays user info for first rejected target. The other-information
651 field for init response for first rejected target is in common init
652 response. This ensures that some backend init diagnostics are returned to
655 --- 1.3.34 2012/04/25
657 frontend_log: extend logging (when message is given in config).
659 --- 1.3.33 2012/04/25
661 zoom: Fix check for proxy. Use diagnostic 1074 for proxy failures.
663 --- 1.3.32 2012/04/24
665 sru_z3950 filter passes through incoming Z39.50 requests again. Was
666 not handled by mistake in Metaproxy versions 1.3.29, 1.3.30 and 1.3.31.
668 --- 1.3.31 2012/04/24
670 zoom: fixes for retry/proxy failover logic. More logging.
672 --- 1.3.30 2012/04/23
674 zoom: return addinfo="proxy failure" for proxy failures. This also
675 changes the scheme for dealing with proxies a bit. zoom now always
676 do proxy check, even if there's no failover. Fortunately, that's not
679 zoom: Init rejected wo diagnostics maps to Bib-1:1014.
680 Bib-1 1014, "Init/AC: Authentication System error", seems pretty
681 generic. We don't know why the init would fail; IP, user, block IP, etc.
682 sru_z3950 filter maps this to SRU diagnostic 3: "Authentication error".
684 zoom: guess if invalid SRU response was an auth failure
686 session_shared: disable session retry by default . Can be enabled by
687 restart="true" in resultset section.
689 --- 1.3.29 2012/04/18
691 zoom: may read cf-proxy's config settings.
692 This reduces manual configuration of the content proxy server host.
693 The ZOOM module will use the old style session.proxyhost if "server"
694 is given (deprecated) and use the new style proxyhost/session if
695 "config_file" is in use.
697 frontend_net: remove incoming requests that can not be handled
698 Requests in queue for filter frontend_net are removed if client
699 closes connection for the session and request is not yet handled.
701 sru_z3950: serialize requests. This is to ensure that pipelined
702 HTTP requests are handled properly.
704 --- 1.3.28 2012/04/04
706 New class, wrbuf, that wraps YAZ' WRBUF.
708 --- 1.3.27 2012/03/30
710 Metaproxy daemon is now running as user "metaproxy". This user is
711 managed by package maintainer scripts. The user information is stored
712 in /etc/metaproxy/metaproxy.user .
714 --- 1.3.26 2012/03/20
716 New filter, sort, that allows sorting of XML records via Z39.50
719 Filter record_transform: USEMarcon support. For example:
720 <retrieval syntax="usmarc">
721 <backend syntax="unimarc" name="F">
722 <usemarcon stage1="/etc/usemarcon/uni2us/uni2us.ini"/>
726 Filter multi: empty route pattern uses route as default.
728 <target route="z3950.indexdata.com">z3950.indexdata.com</route>
729 may use the shorter notation
730 <target route="z3950.indexdata.com"/>
732 Filter query_rewrite: use config path to locate XSLT.
734 Filter frontend_net: log statistics.
735 If a custom message element in frontend_net configuration it makes
736 the frontend_net filter produce a log entry whenever an operation
737 is completed. The log is always written using yaz_log with the
738 custom message given, the package ID (session ID) , the time
739 the operation has been active (end-to-end) , the threads currently
740 active/total and the size of the request input/output queues.
742 query_rewrite: charset conversion of query terms.
743 This is an optional feature. Enabled by element <charset> in
744 configuration with attribute 'from' and 'to' that specifies
745 from/to encodings. The default 'from' encoding is UTF-8.
747 Filter record_transform: honor piggyback searches.
749 Filter zoom: re-connect when database is reused.
750 Re-connect is necessary if a connection is lost or a timeout occurs.
751 If not, we'll be seeing zero hits, when we shouldn't.
753 --- 1.3.25 2012/02/29
755 zoom: Change scheme for dealing with content proxy URLs. The module
756 now has its own common XSL transform that is enabled by record_xsl
757 attribute in the configuration. This XSL gets parameter cproxyhost
758 that holds the host for the content proxy session . The genearted-url
759 is created only if urlRecipe is enabled. In previous version default
760 value of urlRecipe was ${md-electronic-url}; it is now empty and
761 disabled by default. Also generated-url no longer includes the content
762 proxy host. Content proxying URLs is supposed to the handle in the record_xsl
765 zoom: new setting timeout that specifies timeout for outgoing Z39.50/SRU
766 connections. Default value is 40 (seconds).
768 zoom: tune CCL to Z39.50 diagnostics mapping. Throw Bib-1: 108
769 "Malformed query" for syntax errors and related ones; throw
770 Bib-1: 3 "Unsupported search" for everything else. Details from
771 the CCL parser is provided as additional-info.
773 multi: new setting hideerrors that makes multi only relay diagnostics
774 to a client if all backends fail.
776 --- 1.3.24 2012/02/23
778 zoom: empty ccl_map field-mappings disables CCL map.
780 zoom: fix Explain search that could return error if session was
783 --- 1.3.23 2012/02/10
785 zoom: returns Explain records for database IR-Explain---1. The
786 target profile records are converted to Explain records via XSLT.
788 session_shared: make error recovery configurable. Whether a search
789 is restarted on errors or not, is configurable by attribute "restart"
790 in element "resultset" in configuration.
792 session_shared: only relay init for first request. session_shared, for
793 each backend class, now only relays first init request (rather than all).
794 The module only needs to save init response info once. This avoids the
795 need to check for session max.
797 --- 1.3.22 2012/02/02
799 zoom: fix memory leaks.
801 session_shared: maximum number of sessons is configurable. Default
802 value is 100. Result-sets for backends without named result sets are
803 only re-used if databases is identical for a search. This is under the
804 assumption that performance may suffer for those backends when
805 changing the database for each search.
807 multi: combines diagnostics from all backends. All diagnostics from
808 backends are combined into multiple non-surrogate diagnostics; rather
809 than just one diagnostic from first backend.
811 --- 1.3.21 2011/12/27
813 zoom: relay realm to cproxy parameter file.
815 Configuration: Allow filter collection element inside route. This
816 makes it possible to include multiple filters at once.
818 zoom: nocproxy also disables urlRecipe.
820 --- 1.3.20 2011/12/21
822 zoom: return diagnostic if CQL sortby conv fails. Diagnostic Bib-1 214
823 "Illegal sort relation" is returned. Gets translated to SRU diagnostic
824 90: "Unsupported direction value".
826 zoom: honor database argument nocproxy. This disables creating a content
827 connector session (for non-CF targets, usually) and also relays nocproxy
828 as database argument to a CF target.
830 --- 1.3.19 2011/12/16
832 zoom: Multiple proxy hosts may be given for proxy rich database
833 parameter. List is comma separated.
835 http_file: decodes URI paths properly. Does not return 404: not found
836 if no prefix are matches. Instead packages are passed on.
838 --- 1.3.18 2011/12/08
840 zoom: content-{user,password,proxy} are passed on to content proxy
841 system and takes precedence over user,password,proxy .
843 sru_z3950: SRU extra argument x-log-enable=1 enables a search response
844 with a log element including log material from children filters. At
845 this point, only the zoom filter uses this log facility. It will
846 eventually be used by other filters as well. In particular it might be
847 useful for this feature to track all filters in used during a search.
849 zoom: for x-log-enable=1, APDUs sent by ZOOM C, records as received
850 and queries as they are manipulated are logged.
852 zoom: extend addinfo with native diagnostics. Diagnostics as received
853 by ZOOM C are put into addinfo - including ZOOM, HTTP, SRU and Bib-1
854 diagnostics. This indicates both a backend diagnostic and the original
857 zoom: default urlRecipe value is ${md-electronic-url}
859 zoom: target profile setting sruVersion is recognized.
861 --- 1.3.17 2011/11/17
863 zoom: log target profile record fetched (AKA Torus).
865 --- 1.3.16 2011/11/17
867 Change target profile parameter CfSubDb to CfSubDB.
869 --- 1.3.15 2011/11/12
871 zoom: bug fix: realm was relayed to CF targets by mistake (realm only
872 makes sense to the zoom module itself).
874 --- 1.3.14 2011/11/11
876 zoom: realm may be given as part of database.
878 --- 1.3.13 2011/10/26
880 Fix Origin class assigment method; was removd by mistake in 1.3.12.
882 --- 1.3.12 2011/10/26
884 zoom: database args x-name=value are passed through to backend database.
886 SRU filter: user may specify session ID that is passed to log entries
887 that follows. It is specified by using x-session-id in the SRU arguments.
889 zoom: fix null pointer reference which would occur for bad url parameter
890 inside "torus" or if url was not given.
892 --- 1.3.11 2011/09/09
893 Fix bug in filter session_shared where sessions would not expire
894 properly (session ttl). This in turn could make the target close the
895 connection before expected and session_shared would return diagnostic
896 2: system temporarily available.
898 --- 1.3.10 2011/09/09
900 zoom: new target profile setting: sortmap_field. If sortmap_field is given
901 the field is mapped to the value for the sortmap. Values not matching
902 sortmap_field are passed verbatim.
904 zoom: new target profile setting: sortStrategy. One of: "z3950", "type7",
905 "cql", "sru11" or "embed". The "embed" chooses type-7 or CQL sortby
906 depending on whether RPN or CQL is actually sent to the target.
910 zoom: urlRecipe result is stored in <pz:metadata type="generated-url">.
912 zoom: For content proxy authentication is stored in param name
913 "auth", instead of "authentication".
917 zoom: relay schema in SRU mode. Previously recordSchema was not affected
922 zoom: new target profile element literalTransform that holds XSLT
923 (encoded as string) for target. Only if present and non-zero length it is
924 considered present. This takes precedence over transform.
926 Don't rely on trang anymore for Git checkout builds. Configuration in etc
927 will only be properly validated if trang is available. From now on only
928 relax NC files are bundled with the source dist.
930 Updates to check for Boost unit test (autoconf stuff). On MacOSX this
931 component was not detected when it should be.
935 z3950_client: mark non-surrogate diagnostics from backend.
937 zoom: a proxy may be specified for HTTP fetch of target profiles.
941 Honor piggyback. Makes some SRU targets behave that insist on
942 maximumRecords > 0, but also increases performance.
946 Fix dlpath in installed metaproxy.xml for RPM/Deb package. The
947 file was not update for libdir/metaproxy4 in version 1.3.2.
951 Change location of Metaproxy modules from libdir/metaproxy to
952 libdir/metaproxy4. Directory libdir/metaproxy is also owned by
953 libmetaproxy3 and, thus, should not be used by libmetaproxy4.
955 New facility to dump APDUs from zoom filter. Enabled by
956 <log apdu="true"/> in the zoom filter configuation.
958 zoom filter bug fix: SRU diagnostics received from backend was
959 not properly converted to Bib-1 diagnostics.
961 Package metaproxy depends on libmetaproxy4, same version.
965 zoom: fix a bug WRT passing authentication parameters to backends.
969 Fixes for windows Makefile.
971 --- 1.2.10 2011/07/25
973 Change major version of metaproxy library from 3 to 4. This in turn
974 makes new package names for Debian and RPM.
978 zoom: enable marc-8 encoding by default for usmarc and opac (in pz2
981 zoom: configurable element sets for record transforms.
983 zoom: the target profile based transform is specified by element_transform
984 in element torus of of the ZOOM filter configuration ; default value
985 is "pz2". Target profile based retrieval is specified by element_raw
986 in configuration. It will perform same steps, but omit the XSL transform.
987 Default value is "raw".
989 zoom: element set is omitted if not set in profile. But only if pz2
990 transform is in effect. Previously the default element set was to "F".
992 zoom: For non-CF targets database arguments are parsed. User may supply
993 db,user=myuser&password=mypass for non-CF targets. These values override
994 what's given the authentication from the target profile.
996 session_shared: fix reference to freed memory. Would occur if a search
997 response had non-surrogate diagnostics.
1001 Route may be given for each port in frontend_net.
1003 --- 1.2.7 2011/06/22
1005 Documentation for zoom filter. Local target profiles may be specified.
1007 Fixes for zoom filter.
1009 --- 1.2.6 2011/06/15
1011 First version with zoom filter.
1013 --- 1.2.5 2011/05/06
1015 Filter z3950_client may be configured to always send a close APDU
1016 to backend target when connection/session is closed. This will only
1017 happen if close APDU is not already sent. Enabled by configuration
1018 for z3950_client (force_close).
1020 Filter virt_db and multi: relay close APDU.
1022 Filter virt_db and multi: relay init size parameters
1023 preferredMessageSize and maximumRecordSize.
1025 Filter sru_z3950: increase init sz parameters from 1MB to 10 MB.
1027 --- 1.2.4 2011/01/27
1029 RPM package for Metaproxy works for both SLES11 and Centos 5.5.
1031 metaproxy-config: exec_prefix, libdir, includedir. Use these variables
1032 as determined by configure.
1034 RPM: Release includes 'indexdata' name. Use indexdata in release name so
1035 this package can be distinguished from other vendors.
1037 --- 1.2.3 2010/10/04
1039 Fix filter multi: relay idAuthentication parameters.
1041 --- 1.2.2 2010/09/15
1043 Add metaproxy-config for returning compiler flags, libraries.
1045 --- 1.2.1 2010/08/18
1047 Fix --with-boost=PREFIX .
1049 --- 1.2.0 2010/07/09
1051 session_shared: fix use of maintenance thread.
1053 Introduce 'start' method for filters and routers. It gets called after
1054 configure and after fork, but before processing. This changes API -
1055 from libmetaproxy2 to libmetaproxy3.
1057 --- 1.1.7 2010/06/30
1059 session_shared: ensure backend session is closed if init rejected
1062 z3950_client: fix NULL ptr reference that could occur if two clients
1063 connected concurrently and if max-sockets was in effect.
1065 --- 1.1.6 2010/06/21
1067 Fix bug 3497 - Metaproxy unstable while stopping.
1069 Fix bug 3495 - SEGV in SRU filter.
1071 --- 1.1.5 2010/06/15
1073 Filter multi throws diagnostic 'Present Out of Range' when
1074 appropriate - rather than returning 0 records.
1076 Filter virt_db: fix bad result reuse. Could happen if a result
1077 was overriden and a backend did not supported named result sets.
1079 --- 1.1.4 2010/05/11
1081 Filter log: category access logs diagnostics even if searchStatus
1082 or presentStatus is 'success'.
1084 --- 1.1.3 2010/04/21
1086 The SRU to Z39.50 filter does repeated Z39.50 present requests
1087 to fetch all records. Needed when a Z39.50 server returns partial
1088 results (due to message size limits).
1090 --- 1.1.2 2010/03/18
1092 Metaproxy now kills all child processes that are spawned by
1093 modules (in case of fork, exec).
1095 --- 1.1.1 2010/01/28
1097 Debian package now installs /etc/metaproxy/metaproxy.xml which
1098 includes all XML files /etc/metaproxy/filters-enabled .
1099 The include facility uses YAZ' yaz_xml_include_simple (YAZ 4.0.1).
1101 --- 1.1.0 2010/01/20
1103 Package based on YAZ version 4 and YAZ++ 1.2.0. It now includes a
1104 development package to facilitate 3rd party Metaproxy modules.
1106 --- 1.0.23 2010/01/04
1108 Filter virt_db: Close backend filter session when Init rejected is received
1109 from it (in which case it's not really closed yet). This will ensure we don't
1110 run out of resources such as FDs in this case.
1112 sru_z3950 filter: Accept any database (including those not listed).
1114 --- 1.0.22 2009/12/03
1116 Prepare for 64-bit YAZ. yazproxy will still work with YAZ++ 1.1.4 or
1117 later which means YAZ 3.0.47 or later.
1119 --- 1.0.20 2009/11/19
1121 For filter virt_db, the database is a glob pattern and the virtual
1122 database sections are consulted in the order given.
1124 --- 1.0.19 2009/07/08
1126 For filter multi, the target (for routing) may be given as a glob-pattern.
1128 More documentation for filters virt_db and multi.
1130 Update schema to allow for no database in sru_z3950 filter.
1132 --- 1.0.18 2009/06/30
1134 Added limit filter to put sleep (penalty) for heavy use.
1136 Filter frontend_net may be configured to limit the number of new connections
1137 from same IP to some value (connect-max).
1139 Fixed the load_balance filter.
1141 --- 1.0.17 2009/06/16
1143 Fix path for metaproxy executable for Debian init.d script.
1145 --- 1.0.16 2009/06/10
1147 SRU to Z39.50 filter honors x-username and x-password. If only
1148 x-username is given that translates to open authentication (Z39.50v2). If
1149 both x-username and x-password is present that translates to idPass
1150 authentication (Z39.50v3).
1152 New facility to change current working directory (-w).
1154 Update to upstream skeleton of init.d script. Should fix bug #2619.
1156 Filter session_shared now caches records (used to only cache connections
1159 Filter session_shared now invalidates a Z39.50 session if a server
1160 returns -1 hits. This facility was also part of yazproxy and gets around
1161 a bug in Voyager-based Z39.50 servers.
1163 --- 1.0.15 2008/11/18
1165 Fixed reference counting bug in Z39.50 client module (could cause SEGV).
1167 --- 1.0.14 2008/06/09
1169 Fixed the value of SRU record schema in searchRetrieve response. It was set
1170 to a fixed value of "dc" before.
1172 Serialize identical SRU requests. This is useful if HTTP client software
1173 fires identical requests against metaproxy.
1175 Allow Z39.50 target to be specified for SRU requests by using SRU extra
1176 parameter x-target. Allows SRU to contact arbitrary Z39.50 targets and
1177 avoid static configuration. This facility is handled by the sru_z3950 module
1178 and the z3950_client module.
1180 Allow maximum number of sockets to be used for a Z39.50 client by the
1181 use of SRU extra parameter x-max-sockets. This facility is handled by the
1182 sru_z3950 module and the z3950_client module.
1184 --- 1.0.13.1 2008/02/29
1186 Simplified check for Boost libraries.
1188 --- 1.0.13 2008/02/29
1190 First Debian package.
1192 The sru_z9350 filter now recognizes SRU parameter z-target as being
1193 a ZURL of the form host/database .
1195 Mergetype may be specified for filter 'multi'.
1197 --- 1.0.12 2007/09/19
1199 Fixed problem in Makefile WRT library specifictions. This could produce
1200 linker errors (when they should not happen).
1202 Fixed bug #1341: MetaProxy returning different results. Problem was that
1203 fix-up of record database did not normalize the database name.
1205 Documentation updates for Windows compilation.
1207 --- 1.0.11 2007/06/14
1209 Fixed problem with logfile being truncated.
1211 --- 1.0.10 2007/05/23
1213 Fixed bug #1136: Access rights not enforced.
1215 Extension for log module. The log category 'access' logs more details.
1216 New category 'user-access' added which is simlar to 'access' but adds
1217 the Z39.50 user as for all entries in a session.
1221 Added support for configurable default/force target/vhost for module Z39.50
1224 --- 1.0.8 2007/01/25
1226 Implemented filter, session_shared, which optimizes usage of Z39.50
1227 sessions and result sets.
1229 New filter, record_transform, which converts MARC/XML records.
1231 New filter, sru_z3950, which converts SRU to Z39.50 packages.
1233 New filter, load_balance, in development.
1235 New filter, zeerex_xplain.
1237 XML framework for config files started.
1239 Master RelaxNG Compact schema's are found in xml/schema/*.rnc,
1240 RelaxNG XML schemas and XML Schema's are generated from RNC syntax.
1241 XML config files are checked against RNG and XML Schema's.
1243 XSLT transformation framework added in xml/xslt/*.xsl, consisting mainly of
1244 LOC Marc21 stylesheets found at http://www.loc.gov/marcxml/xslt.
1245 Added stylesheet explain2cqlpqftxt.xsl which transforms a standard SRU ZeeReX
1246 explain record to YAZ CQL-to-PQF text config file.
1248 --- 1.0.7 2006/11/07
1250 Added 'timeout' setting for filter frontend_net which specifies the number
1251 of seconds a session is idle before it is closed. Default timeout is
1254 --- 1.0.6 2006/07/07
1256 Database name in records returned set for virt_db/multi filters.
1258 Filter session_shared now functional.
1260 Log filter can be configured to write to a given file using 'filename'
1261 element. Also information category can be specified with 'category'. If
1262 filename is omitted, the log filter writes to stdout. See etc/config5.xml
1265 --- 1.0.5 2006/05/16
1267 Fixed compilation on Windows.
1269 --- 1.0.4 2006/05/16
1271 Added documentation for the hidenavailable option for the multi filter.
1273 --- 1.0.3 2006/05/16
1275 Fixed bug #573: Hide errors for individual servers. If the element
1276 'hideunavailable' is given in the configuration, individual servers
1277 being unavailable are hidden (unless all are unavailable).
1279 Fixed bug #574: Database names are recognised case-sensitively.
1281 Fixed bug #567: Fix up database name in Name-Plus-Record.
1283 Fixed bug #568: Update win/makefile for VS 2005.
1285 Fixed bug #569: Some options throws unknown exception.
1287 --- 1.0.2 2006/04/28
1289 More information about virtual hosts. The 'etc' directory is part of the
1292 --- 1.0.1 2006/04/27
1294 Build instructions for Windows. NMake makefile part of distribution tar.
1296 --- 1.0.0 2006/04/24
1300 Filters functional: auth_simple, backend_test, frontend_net, http_file,
1301 log, multi, query_rewrite, template, virt_db, z3950_client.
1303 Filters in development: session_shared.
1305 Pseudo-filters: template, dl