1 <!-- $Id: installation.xml,v 1.7 2003-03-04 23:30:20 adam Exp $ -->
2 <chapter id="installation">
3 <title>Installation</title>
5 Zebra is very portable. An ANSI C compiler is required. We
6 primarily use GNU C on UNIX and Microsoft Visual C++ on Windows.
10 Zebra uses following components. Most of these are optional.
13 <term><ulink url="http://www.indexdata.dk/yaz/">yaz</ulink> (required)</term>
16 Zebra uses lots of utilities provided by YAZ. Most notably
22 <term><ulink url="http://www.gnu.org/software/libiconv/">iconv</ulink>
26 Character set conversion. This is required if you're
27 going to use any other character set than UTF-8 and ISO-8859-1
28 for records. Note that some Unixes has iconv built-in.
33 <term><ulink url="http://expat.sourceforge.net/">Expat</ulink>
37 XML parser. If you're going to index real XML you should
38 install this (filter grs.xml). On most system, you should be able
39 to find binary Expat packages.
45 <term><ulink url="http://www.perl.com/">Perl</ulink> (optional)</term>
48 Perl is required if you're going to use the Zebra perl
49 filter facility or the Zebra perl API. Perl is preinstalled
50 on many Unixes. We've not tried the Perl extension on
57 <term><ulink url="http://www.tcl.tk/">Tcl</ulink> (optional)</term>
60 Tcl is required if you need to use the Tcl record filter
61 for Zebra. You can find binary packages for Tcl for many
69 <ulink url="http://www.gnu.org/software/autoconf/">Autoconf</ulink>,
75 GNU Automake and Autoconf are only required if you're
76 using the CVS version of Zebra. You do not need these
77 if you have fetched a Zebra tar.
83 <term>Docbook and friends (optional)</term>
86 These tools are only required if you're writing
87 Documentation for Zebra. You need the following
88 Debian packages: jadetex, docbook, docbook-dsssl,
89 docbook-xml, docbook-utils.
96 <sect1 id="installation.unix"><title>UNIX</title>
98 On Unix, <literal>gcc</literal> works fine, but any native
99 C compiler should be possible to use as long as it is
104 Unpack the distribution archive. The <literal>configure</literal>
105 shell script attempts to guess correct values for various
106 system-dependent variables used during compilation.
107 It uses those values to create a <literal>Makefile</literal> in each
112 To run the configure script type:
121 The configure script attempts to use C compiler specified by
122 the <literal>CC</literal> environment variable.
123 If this is not set, <literal>cc</literal> or GNU C will be used.
124 The <literal>CFLAGS</literal> environment variable holds
125 options to be passed to the C compiler. If you're using a
126 Bourne-shell compatible shell you may pass something like this:
129 CC=/opt/ccs/bin/cc CFLAGS=-O ./configure
133 The configure script support various options: you can see what they
141 Once the build environment is configured, build the software by
149 If the build is successful, two executables are created in the
150 sub-directory <literal>index</literal>:
154 <term><literal>zebrasrv</literal></term>
157 The Z39.50 server and search engine.
162 <term><literal>zebraidx</literal></term>
165 The administrative indexing tool.
173 You can now use Zebra. If you wish to install it system-wide, then
178 By default this will install the Zebra executables in
179 <filename>/usr/local/bin</filename>,
180 and the standard configuration files in
181 <filename>/usr/local/share/idzebra</filename>
182 You can override this with the <literal>--prefix</literal> option
186 <sect1><title>WIN32</title>
192 <!-- Keep this comment at the end of the file
197 sgml-minimize-attributes:nil
198 sgml-always-quote-attributes:t
201 sgml-parent-document: "zebra.xml"
202 sgml-local-catalogs: nil
203 sgml-namecase-general:t