1 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.4//EN"
2 "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
3 <!ENTITY copyright SYSTEM "copyright.xml">
4 <!ENTITY % idcommon SYSTEM "common/common.ent">
7 <refentry id="ref-multi">
9 <productname>Metaproxy</productname>
10 <orgname>Index Data</orgname>
14 <refentrytitle>multi</refentrytitle>
15 <manvolnum>3mp</manvolnum>
16 <refmiscinfo class="manual">Metaproxy Module</refmiscinfo>
20 <refname>multi</refname>
21 <refpurpose>Metaproxy Package Multiplexer Module</refpurpose>
24 <refsect1><title>DESCRIPTION</title>
26 This filter multiplexes packages.
29 The multi filter consists of zero or more
30 <literal><target></literal> elements.
31 If a target matches a given target specified as CDATA in the
32 target element, the multi filter will route traffic to the route
33 given by the route attribute. The target element may also apply
34 credentials to be sent to the target. This is given by the
35 <literal>auth</literal> attribute.
38 A target element is not required for multi-plexing to work.
39 It merely serves as a way to route differently.
43 <literal><hideunavailable></literal>
44 element is placed inside the
45 <literal>multi</literal>
46 filter, then unavailable databases are not reported to the client,
47 but simply ignored (unless every one of the databases is
52 <literal><hideerrors></literal>
53 element is placed inside the
54 <literal>multi</literal>
55 filter, then databases that reports diagnostics are not reported back
56 to the client, but simply ignored (unless every one of the databases report
61 <refsect1><title>SCHEMA</title>
62 <literallayout><xi:include
63 xi:href="../xml/schema/filter_multi.rnc"
65 xmlns:xi="http://www.w3.org/2001/XInclude" />
69 <refsect1><title>EXAMPLES</title>
71 A typical configuration looks like this:
74 <target route="route1">lx2.loc.gov:210/LCDB_MARC8</target>
75 <target route="route2">z3950.indexdata.com/gils</target>
76 <target route="route3" auth="myuser/mypass">localhost:9999</target>
77 <target route="other">*</target>
85 <refsect1><title>SEE ALSO</title>
88 <refentrytitle>metaproxy</refentrytitle>
89 <manvolnum>1</manvolnum>
94 <refentrytitle>virt_db</refentrytitle>
95 <manvolnum>3mp</manvolnum>
103 <!-- Keep this comment at the end of the file