<chapter id="administration">
- <!-- $Id: administration.xml,v 1.40 2006-06-30 10:46:26 marc Exp $ -->
+ <!-- $Id: administration.xml,v 1.42 2006-08-14 22:33:46 adam Exp $ -->
<title>Administrating Zebra</title>
<!-- ### It's a bit daft that this chapter (which describes half of
the configuration-file formats) is separated from
Specifies a file with description of user accounts for Zebra.
File format is similar to that used by the passwd directive except
that the password are encrypted. Use Apache's htpasswd or similar
- for maintenanace.
+ for maintenance.
</para>
</listitem>
</varlistentry>
to access Zebra via the passwd system. There are two kinds
of permissions currently: read (r) and write(w). By default
users not listed in a permission directive are given the read
- priviledge. To specify permissions for a user with no
+ privilege. To specify permissions for a user with no
username, or Z39.50 anonymous style use
<literal>anonymous</literal>. The permstring consists of
a sequence of characters. Include character <literal>w</literal>
with or without static ranking enabled.
</para>
- </sect3>
<!--
<sect3 id="administration-ranking-dynamic-rank1">
</para>
</sect3>
-->
-
<warning>
<para>
mitaylor2microsoft.com
-->
+ </sect3>
<sect3 id="administration-ranking-dynamic-cql">
<title>Dynamically ranking CQL queries</title>
<title>Extended Services: Remote Insert, Update and Delete</title>
<note>
- Extended services are only supported when acessing the Zebra
+ <para>
+ Extended services are only supported when accessing the Zebra
server using the <ulink url="&url.z39.50;">Z39.50</ulink>
protocol. The <ulink url="&url.sru;">SRU</ulink> protocol does
not support extended services.
- </note>
-
+ </para>
+ </note>
+
<para>
The extended services are not enabled by default in zebra - due to the
fact that they modify the system. Zebra can be configured
</screen>
And in the password file
<filename>passwordfile</filename>, you have to specify users and
- encrypted passwords as colon seperated strings.
+ encrypted passwords as colon separated strings.
Use a tool like <filename>htpasswd</filename>
to maintain the encrypted passwords.
<screen>
</screen>
The general record type should be set to any record filter which
is able to parse XML records, you may use any of the two
- declarations (but not both simultaniously!)
+ declarations (but not both simultaneously!)
<screen>
recordType: grs.xml
# recordType: alvis.filter_alvis_config.xml
shadow: directoryname: size (e.g. 1000M)
</screen>
</para>
- <note>It is not possible to carry information about record types or
- similar to Zebra when using extended services, due to
- limitations of the <ulink url="&url.z39.50;">Z39.50</ulink>
- protocol. Therefore, indexing filters can not be choosen on a
- per-record basis. One and only one general XML indexing filter
- must be defined.
- <!-- but because it is represented as an OID, we would need some
- form of proprietary mapping scheme between record type strings and
- OIDs. -->
- <!--
- However, as a minimum, it would be extremely useful to enable
- people to use MARC21, assuming grs.marcxml.marc21 as a record
- type.
- -->
+ <note>
+ <para>
+ It is not possible to carry information about record types or
+ similar to Zebra when using extended services, due to
+ limitations of the <ulink url="&url.z39.50;">Z39.50</ulink>
+ protocol. Therefore, indexing filters can not be chosen on a
+ per-record basis. One and only one general XML indexing filter
+ must be defined.
+ <!-- but because it is represented as an OID, we would need some
+ form of proprietary mapping scheme between record type strings and
+ OIDs. -->
+ <!--
+ However, as a minimum, it would be extremely useful to enable
+ people to use MARC21, assuming grs.marcxml.marc21 as a record
+ type.
+ -->
+ </para>
</note>
<title>Extended services in the Z39.50 protocol</title>
<para>
- The <ulink url="&url.z39.50;">Z39.50</ulink> standard allowes
+ The <ulink url="&url.z39.50;">Z39.50</ulink> standard allows
servers to accept special binary <emphasis>extended services</emphasis>
protocol packages, which may be used to insert, update and delete
records into servers. These carry control and update
information to the servers, which are encoded in seven package fields:
</para>
-
- <table id="administration-extended-services-z3950-table"
- frame="all" rowsep="1" colsep="1" align="center">
-
- <caption>Extended services Z39.50 Package Fields</caption>
+ <table id="administration-extended-services-z3950-table" frame="top">
+ <title>Extended services Z39.50 Package Fields</title>
+ <tgroup cols="3">
<thead>
- <tr>
- <td>Parameter</td>
- <td>Value</td>
- <td>Notes</td>
- </tr>
+ <row>
+ <entry>Parameter</entry>
+ <entry>Value</entry>
+ <entry>Notes</entry>
+ </row>
</thead>
<tbody>
- <tr>
- <td><literal>type</literal></td>
- <td><literal>'update'</literal></td>
- <td>Must be set to trigger extended services</td>
- </tr>
- <tr>
- <td><literal>action</literal></td>
- <td><literal>string</literal></td>
- <td>
+ <row>
+ <entry><literal>type</literal></entry>
+ <entry><literal>'update'</literal></entry>
+ <entry>Must be set to trigger extended services</entry>
+ </row>
+ <row>
+ <entry><literal>action</literal></entry>
+ <entry><literal>string</literal></entry>
+ <entry>
Extended service action type with
one of four possible values: <literal>recordInsert</literal>,
<literal>recordReplace</literal>,
<literal>recordDelete</literal>,
and <literal>specialUpdate</literal>
- </td>
- </tr>
- <tr>
- <td><literal>record</literal></td>
- <td><literal>XML string</literal></td>
- <td>An XML formatted string containing the record</td>
- </tr>
- <tr>
- <td><literal>syntax</literal></td>
- <td><literal>'xml'</literal></td>
- <td>Only XML record syntax is supported</td>
- </tr>
- <tr>
- <td><literal>recordIdOpaque</literal></td>
- <td><literal>string</literal></td>
- <td>
+ </entry>
+ </row>
+ <row>
+ <entry><literal>record</literal></entry>
+ <entry><literal>XML string</literal></entry>
+ <entry>An XML formatted string containing the record</entry>
+ </row>
+ <row>
+ <entry><literal>syntax</literal></entry>
+ <entry><literal>'xml'</literal></entry>
+ <entry>Only XML record syntax is supported</entry>
+ </row>
+ <row>
+ <entry><literal>recordIdOpaque</literal></entry>
+ <entry><literal>string</literal></entry>
+ <entry>
Optional client-supplied, opaque record
identifier used under insert operations.
- </td>
- </tr>
- <tr>
- <td><literal>recordIdNumber </literal></td>
- <td><literal>positive number</literal></td>
- <td>Zebra's internal system number, only for update
+ </entry>
+ </row>
+ <row>
+ <entry><literal>recordIdNumber </literal></entry>
+ <entry><literal>positive number</literal></entry>
+ <entry>Zebra's internal system number, only for update
actions.
- </td>
- </tr>
- <tr>
- <td><literal>databaseName</literal></td>
- <td><literal>database identifier</literal></td>
- <td>
+ </entry>
+ </row>
+ <row>
+ <entry><literal>databaseName</literal></entry>
+ <entry><literal>database identifier</literal></entry>
+ <entry>
The name of the database to which the extended services should be
applied.
- </td>
- </tr>
- </tbody>
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
</table>