<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN"
"http://www.oasis-open.org/docbook/xml/4.1/docbookx.dtd" [
<!ENTITY copyright SYSTEM "copyright.xml">
+ <!ENTITY % idcommon SYSTEM "common/common.ent">
+ %idcommon;
]>
-<!-- $Id: load_balance.xml,v 1.1 2007-01-03 15:34:50 marc Exp $ -->
-<refentry>
+<refentry id="ref-load_balance">
<refmeta>
<refentrytitle>load_balance</refentrytitle>
<manvolnum>3mp</manvolnum>
<refnamediv>
<refname>load_balance</refname>
- <refpurpose>balances load among Z39.50 targets</refpurpose>
+ <refpurpose>Metaproxy Module balancing load among multiple identical
+ Z39.50 targets</refpurpose>
</refnamediv>
<refsect1><title>DESCRIPTION</title>
This filter balances load among Z39.50 targets based on statistics
gathered on number of open sessions and number of open package requests.
</para>
+ <para>
+ The load balancing is depending on targets to be specified (vhosts).
+ Most Z39.50 clients do not specify that. For this reason, this
+ filter is mostly used as a follower to filter virt_db.
+ </para>
</refsect1>
<refsect1><title>EXAMPLES</title>
<para>
- A typical configuration looks like this:
+ This configuration offers one database, <literal>Default</literal>,
+ which is load-balanced between two backend servers.
<screen><![CDATA[
+ <filter type="virt_db"/>
+ <database>Default</database>
+ <target>host1:210/Default</target>
+ <target>host2:210/Default</target>
+ </filter>
<filter type="load_balance"/>
]]>
</screen>
</para>
+
</refsect1>
<refsect1><title>SEE ALSO</title>
<para>
<citerefentry>
- <refentrytitle>metaproxy</refentrytitle>
- <manvolnum>1</manvolnum>
+ <refentrytitle>virt_db</refentrytitle>
+ <manvolnum>3mp</manvolnum>
</citerefentry>
</para>
</refsect1>