-<!-- $Id: installation.xml,v 1.23 2006-06-27 12:37:43 marc Exp $ -->
+<!-- $Id: installation.xml,v 1.28 2006-08-14 19:56:50 adam Exp $ -->
<chapter id="installation">
<title>Installation</title>
<para>
<sect1 id="installation.unix"><title>UNIX</title>
<para>
- On Unix, <literal>gcc</literal> works fine, but any native
+ On Unix, GCC works fine, but any native
C compiler should be possible to use as long as it is
ANSI C compliant.
</para>
By default this will install the Zebra executables in
<filename>/usr/local/bin</filename>,
and the standard configuration files in
- <filename>/usr/local/share/idzebra</filename>
+ <filename>/usr/local/share/idzebra-2.0</filename>
You can override this with the <literal>--prefix</literal> option
to configure.
</para>
<sect2 id="installation.debianlinux"><title>GNU/Debian Linux on
i686 Platform</title>
<para>
- Index Data provides pre-compiled <literal>GNU/Debian i686
- Linux</literal> packages at our Debian package archive, both for
- the <literal>Sarge</literal> and the <literal>Etch</literal> release.
+ Index Data provides pre-compiled GNU/Debian i686 Linux packages
+ at our Debian package archive, both for
+ the Sarge and the Etch release.
</para>
<para>
To install these packages, you need to add two lines to your
- <literal>/etc/apt/sources.list</literal> configuration file,
- either the <literal>Sarge</literal> sources found at
+ <filename>/etc/apt/sources.list</filename> configuration file,
+ either the Sarge sources found at
<screen>
- deb http://ftp.indexdata.dk/t/debian sarge main
- deb-src http://ftp.indexdata.dk/t/debian sarge main
+ deb http://ftp.indexdata.dk/debian sarge main
+ deb-src http://ftp.indexdata.dk/debian sarge main
</screen>
- or the <literal>Etch</literal> sources from
+ or the Etch sources from
<screen>
- deb http://ftp.indexdata.dk/t/debian etch main
- deb-src http://ftp.indexdata.dk/t/debian etch main
+ deb http://ftp.indexdata.dk/debian etch main
+ deb-src http://ftp.indexdata.dk/debian etch main
</screen>
After refreshing the package cache with the command
<screen>
<ulink url="http://indexdata.dk/zebra/">Zebra</ulink> indexer is
easily installed issuing
<screen>
- apt-get install idzebra idzebra-doc
+ apt-get install idzebra-2.0 idzebra-2.0-doc
</screen>
</para>
</sect2>
<sect2 id="installation.debianother">
- <title>GNU/Debian On Other Platforms</title>
+ <title>Ubuntu/Debian and GNU/Debian on other platforms</title>
<para>
These <ulink url="http://indexdata.dk/zebra/">Zebra</ulink>
packages are specifically compiled for
- <literal>GNU/Debian Linux</literal> systems. Installation on other
- <literal>GNU/Debian</literal> systems is possible by
+ GNU/Debian Linux systems. Installation on other
+ GNU/Debian systems is possible by
re-compilation the Debian way: you need to add only the
<literal>deb-src</literal> sources lines to the
- <literal>/etc/apt/sources.list</literal> configuration file,
- that is either the <literal>Sarge</literal> sources
+ <filename>/etc/apt/sources.list</filename> configuration file,
+ that is either the Sarge sources
<screen>
- deb-src http://ftp.indexdata.dk/t/debian sarge main
+ deb-src http://ftp.indexdata.dk/debian sarge main
</screen>
- or the <literal>Etch</literal> sources
+ or the Etch sources
<screen>
- deb-src http://ftp.indexdata.dk/t/debian etch main
+ deb-src http://ftp.indexdata.dk/debian etch main
</screen>
After refreshing the package cache with the command
<screen>
apt-get update
+ apt-get build-dep idzebra-2.0
</screen>
as <literal>root</literal>, the
<ulink url="http://indexdata.dk/zebra/">Zebra</ulink> indexer is
recompiled and installed issuing
<screen>
- apt-get build-dep idzebra
- apt-get source --compile idzebra
+ apt-get source --compile idzebra-2.0
</screen>
as normal user.
- The compiled <literal>GNU/Debian</literal> packages can then be
+ The compiled GNU/Debian packages can then be
installed as <literal>root</literal> issuing
<screen>
- dpkg -i install idzebra*.deb idzebra-doc*.deb
+ dpkg -i install idzebra-2.0*.deb libidzebra-2.0*.deb
</screen>
</para>
</sect2>
must be changed to
<screen>
# profilePath - where to look for config files
- profilePath: some/local/path:/usr/share/idzebra2.0/tab
+ profilePath: some/local/path:/usr/share/idzebra-2.0/tab
# modulePath - where to look for loadable zebra modules
- modulePath: /usr/lib/idzebra2.0/
+ modulePath: /usr/lib/idzebra-2.0/
</screen>
</para>
<para>
redirection to other fields.
For example the following snippet of
a custom <filename>custom/bib1.att</filename>
- <literal>Bib-1</literal> attribute set definition file is no
+ Bib-1 attribute set definition file is no
longer supported:
<screen>
att 1016 Any 1016,4,1005,62
<screen>
att 1016 Any
</screen>
+ </para>
+ <para>
Similar behaviour can be expressed in the new release by defining
a new index <literal>Any:w</literal> in all GRS
<filename>*.abs</filename> record indexing configuration files.
xelm /*/title Any:w,Body-of-text:w,Title:s,Title:w
</screen>
</para>
+ <para>
+ It is also possible to map the numerical attribute value
+ <literal>@attr 1=1016</literal> onto another already existing huge
+ index, in this example, one could for example use the mapping
+ <screen>
+ att 1016 Body-of-text
+ </screen>
+ with equivalent outcome without editing all GRS
+ <filename>*.abs</filename> record indexing configuration files.
+ </para>
+
+ <para>
+ Server installations which use the special
+ <literal>IDXPATH</literal> attribute set must add the following
+ line to the <filename>zebra.cfg</filename> configuration file:
+ <screen>
+ attset: idxpath.att
+ </screen>
+ </para>
</sect1>
</chapter>