Name

multi — Metaproxy Package Multiplexer Module

DESCRIPTION

This filter multiplexes packages.

The multi filter consists of zero or more <target> elements. If a target matches a given target specified as CDATA in the target element, the multi filter will route traffic to the route given by the route attribute. The target element may also apply credentials to be sent to the target. This is given by the auth attribute.

A target element is not required for multiplexing to work. It merely serves as a way to route differently.

If an empty <hideunavailable> element is placed inside the multi filter, then unavailable databases are not reported to the client, but simply ignored (unless every one of the databases is unavailable).

If an empty <hideerrors> element is placed inside the multi filter, then databases that report diagnostics are not reported back to the client, but simply ignored (unless every one of the databases report diagnostics).

SCHEMA

# Metaproxy XML config file schemas
#
#   Copyright (C) Index Data
#   See the LICENSE file for details.

namespace mp = "http://indexdata.com/metaproxy"

filter_multi =
  attribute type { "multi" },
  attribute id { xsd:NCName }?,
  attribute name { xsd:NCName }?,
  element mp:target {
    attribute route { xsd:string }?,
    attribute auth { xsd:string }?,
    xsd:string
  }*,
  element mp:hideunavailable { empty }?,
  element mp:hideerrors { empty }?,
  element mp:mergetype { xsd:string }?

   

EXAMPLES

A typical configuration looks like this:

    <filter type="multi">
     <target route="route1">lx2.loc.gov:210/LCDB_MARC8</target>
     <target route="route2">z3950.indexdata.com/gils</target>
     <target route="route3" auth="myuser/mypass">localhost:9999</target>
     <target route="other">*</target>
    </filter>

   

SEE ALSO

metaproxy(1)

virt_db(3mp)

COPYRIGHT

Copyright (C) 2005-2023 Index Data