<chapter id="installation">
+ <!-- $Id: installation.xml,v 1.5 2002-10-08 08:09:43 mike Exp $ -->
+ <title>Installation</title>
+ <para>
+ An ANSI C compiler is required to compile the Zebra
+ server system — <literal>gcc</literal> works fine if your
+ own system doesn't provide an adequate compiler.
+ </para>
+
+ <para>
+ Unpack the distribution archive. The <literal>configure</literal>
+ shell script attempts to guess correct values for various
+ system-dependent variables used during compilation.
+ It uses those values to create a 'Makefile' in each directory of Zebra.
+ </para>
+
+ <para>
+ To run the configure script type:
-<title>Installation</title>
-
-<para>
-An ANSI C compiler is required to compile the Zebra
-server system — <literal remap="tt">gcc</literal> works fine if your own system doesn't
-provide an adequate compiler.
-</para>
-
-<para>
-Unpack the distribution archive. The <literal remap="tt">configure</literal> shell script
-attempts to guess correct values for various system-dependent variables
-used during compilation. It uses those values to create a 'Makefile' in
-each directory of Zebra.
-</para>
-
-<para>
-To run the configure script type:
-
-<screen>
+ <screen>
./configure
-</screen>
-
-</para>
+ </screen>
-<para>
-The configure script attempts to use C compiler specified by
-the <literal remap="tt">CC</literal> environment variable. If not set, <literal remap="tt">cc</literal>
-will be used. The <literal remap="tt">CFLAGS</literal> environment variable holds
-options to be passed to the C compiler. If you're using a Bourne-shell
-compatible shell you may pass something like this:
-
-<screen>
+ </para>
+
+ <para>
+ The configure script attempts to use C compiler specified by
+ the <literal>CC</literal> environment variable.
+ If not set, <literal>cc</literal> or GNU C will be used.
+ The <literal>CFLAGS</literal> environment variable holds
+ options to be passed to the C compiler. If you're using a
+ Bourne-shell compatible shell you may pass something like this:
+
+ <screen>
CC=/opt/ccs/bin/cc CFLAGS=-O ./configure
-</screen>
+ </screen>
+
+ The configure script takes a number of arguments, you can see
+ them all with
+ <screen>
+ ./configure --help
+ </screen>
-</para>
-
-<para>
-When configured build the software by typing:
-
-<screen>
+ </para>
+
+ <para>
+ When configured, build the software by typing:
+
+ <screen>
make
-</screen>
+ </screen>
-</para>
-
-<para>
-As an option you may type <literal remap="tt">make depend</literal> to create
-source file dependencies for the package. This is only needed,
-however, if you alter the source.
-</para>
-
-<para>
-If successful, two executables have been created in the sub-directory
-<literal remap="tt">index</literal>.
-<variablelist>
-
-<varlistentry>
-<term><literal remap="tt">zebrasrv</literal></term>
-<listitem>
-<para>
-The Z39.50 server and search engine.
-</para>
-</listitem>
-</varlistentry>
-<varlistentry>
-<term><literal remap="tt">zebraidx</literal></term>
-<listitem>
-<para>
-The administrative tool for the search index.
-</para>
-</listitem>
-</varlistentry>
-</variablelist>
-</para>
-
+ </para>
+
+ <para>
+ If successful, two executables are created in the sub-directory
+ <literal>index</literal>.
+ <variablelist>
+
+ <varlistentry>
+ <term><literal>zebrasrv</literal></term>
+ <listitem>
+ <para>
+ The Z39.50 server and search engine.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><literal>zebraidx</literal></term>
+ <listitem>
+ <para>
+ The administrative indexing tool.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+
+ <para>
+ You can now use Zebra. If you wish to install it system-wide, then
+ as root type
+ <screen>
+ make install
+ </screen>
+ By default this will install the Zebra executables in
+ <filename>/usr/local/bin</filename>,
+ and the standard configuration files in
+ <filename>/usr/local/share/zebra</filename>
+ You can override this with the <literal>--prefix</literal> option
+ to configure.
+ </para>
</chapter>
+ <!-- Keep this comment at the end of the file
+ Local variables:
+ mode: sgml
+ sgml-omittag:t
+ sgml-shorttag:t
+ sgml-minimize-attributes:nil
+ sgml-always-quote-attributes:t
+ sgml-indent-step:1
+ sgml-indent-data:t
+ sgml-parent-document: "zebra.xml"
+ sgml-local-catalogs: nil
+ sgml-namecase-general:t
+ End:
+ -->