1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
|
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Chapter2.Installation</title><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="Zebra - User's Guide and Reference"><link rel="up" href="index.html" title="Zebra - User's Guide and Reference"><link rel="prev" href="introduction-support.html" title="4.Support"><link rel="next" href="installation-debian.html" title="2.GNU/Debian"></head><body><link rel="stylesheet" type="text/css" href="common/style1.css"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter2.Installation</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="introduction-support.html">Prev</a></td><th width="60%" align="center"></th><td width="20%" align="right"><a accesskey="n" href="installation-debian.html">Next</a></td></tr></table><hr></div><div class="chapter"><div class="titlepage"><div><div><h1 class="title"><a name="installation"></a>Chapter2.Installation</h1></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl class="toc"><dt><span class="section"><a href="installation.html#installation-unix">1. UNIX</a></span></dt><dt><span class="section"><a href="installation-debian.html">2. GNU/Debian</a></span></dt><dd><dl><dt><span class="section"><a href="installation-debian.html#installation-debian-linux">2.1. GNU/Debian Linux on
amd64/i386 Platform</a></span></dt><dt><span class="section"><a href="installation-debian.html#installation-debia-nother">2.2. GNU/Debian and Ubuntu on other architectures</a></span></dt></dl></dd><dt><span class="section"><a href="installation-win32.html">3. Windows</a></span></dt><dt><span class="section"><a href="installation-upgrade.html">4. Upgrading from <span class="application">Zebra</span> version 1.3.x</a></span></dt></dl></div><p>
<span class="application">Zebra</span> is written in <acronym class="acronym">ANSI</acronym> C and was implemented with portability in mind.
We primarily use <a class="ulink" href="http://gcc.gnu.org" target="_top">GCC</a> on UNIX and
<a class="ulink" href="http://www.visualstudio.com" target="_top">Microsoft Visual C++</a> on Windows.
</p><p>
The software is regularly tested on
<a class="ulink" href="https://www.debian.org/" target="_top">Debian GNU/Linux</a>,
<a class="ulink" href="https://www.redhat.com/" target="_top">Red Hat Linux</a>,
<a class="ulink" href="https://www.freebsd.org/" target="_top">FreeBSD (i386)</a>,
<a class="ulink" href="https://www.apple.com/osx/" target="_top">MAC OSX</a>,
Windows 7.
</p><p>
<span class="application">Zebra</span> can be configured to use the following utilities (most of
which are optional):
</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><a class="ulink" href="http://www.indexdata.com/yaz" target="_top"><span class="application">YAZ</span></a>
(required)</span></dt><dd><p>
<span class="application">Zebra</span> uses <span class="application">YAZ</span> to support <a class="ulink" href="https://www.loc.gov/z3950/agency/" target="_top"><acronym class="acronym">Z39.50</acronym></a> /
<a class="ulink" href="https://www.loc.gov/standards/sru/" target="_top"><acronym class="acronym">SRU</acronym></a>.
Zebra also uses a lot of other utilities (not related to networking),
such as memory management and XML support.
</p><p>
For the <a class="link" href="record-model-domxml.html" title="Chapter7.DOM XML Record Model and Filter Module">DOM XML</a>
/ <a class="link" href="record-model-alvisxslt.html" title="Chapter8.ALVIS XML Record Model and Filter Module">ALVIS</a>
record filters, <span class="application">YAZ</span> must be compiled with
<a class="ulink" href="http://xmlsoft.org/" target="_top">Libxml2</a>
and
<a class="ulink" href="http://xmlsoft.org/XSLT/" target="_top">Libxslt</a>
support and Libxml2 must be version 2.6.15 or later.
</p></dd><dt><span class="term"><a class="ulink" href="https://www.gnu.org/software/libiconv/" target="_top">iconv</a>
(optional)</span></dt><dd><p>
Character set conversion. This is required if you're
going to use any other character set than UTF-8 and ISO-8859-1
for records. Note that some Unixes has iconv built-in.
</p></dd><dt><span class="term"><a class="ulink" href="https://libexpat.github.io" target="_top">Expat</a>
(optional)</span></dt><dd><p>
<acronym class="acronym">XML</acronym> parser. If you're going to index real <acronym class="acronym">XML</acronym> you should
install this (filter grs.xml). On most systems you should be able
to find binary Expat packages.
</p></dd><dt><span class="term"><a class="ulink" href="http://www.tcl.tk/" target="_top">Tcl</a> (optional)</span></dt><dd><p>
Tcl is required if you need to use the Tcl record filter
for <span class="application">Zebra</span>. You can find binary packages for Tcl for many
Unices and Windows.
</p></dd><dt><span class="term">
<a class="ulink" href="https://www.gnu.org/software/autoconf/" target="_top">Autoconf</a>,
<a class="ulink" href="https://www.gnu.org/software/automake/" target="_top">Automake</a>
(optional)</span></dt><dd><p>
GNU Automake and Autoconf are only required if you're
using the CVS version of <span class="application">Zebra</span>. You do not need these
if you have fetched a <span class="application">Zebra</span> tar.
</p></dd><dt><span class="term"><a class="ulink" href="https://docbook.org" target="_top">Docbook</a>
and friends (optional)</span></dt><dd><p>
These tools are only required if you're writing
documentation for <span class="application">Zebra</span>. You need the following
Debian packages: docbook, docbook-xml, docbook-xsl,
docbook-utils, xsltproc.
</p></dd></dl></div><p>
</p><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="installation-unix"></a>1.UNIX</h2></div></div></div><p>
On Unix, GCC works fine, but any native
C compiler should be possible to use as long as it is
<acronym class="acronym">ANSI</acronym> C compliant.
</p><p>
Unpack the distribution archive. The <code class="literal">configure</code>
shell script attempts to guess correct values for various
system-dependent variables used during compilation.
It uses those values to create a <code class="literal">Makefile</code> in each
directory of <span class="application">Zebra</span>.
</p><p>
To run the configure script type:
</p><pre class="screen">
./configure
</pre><p>
</p><p>
The configure script attempts to use C compiler specified by
the <code class="literal">CC</code> environment variable.
If this is not set, <code class="literal">cc</code> or GNU C will be used.
The <code class="literal">CFLAGS</code> 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:
</p><pre class="screen">
CC=/opt/ccs/bin/cc CFLAGS=-O ./configure
</pre><p>
</p><p>
The configure script support various options: you can see what they
are with
</p><pre class="screen">
./configure --help
</pre><p>
</p><p>
Once the build environment is configured, build the software by
typing:
</p><pre class="screen">
make
</pre><p>
</p><p>
If the build is successful, two executables are created in the
sub-directory <code class="literal">index</code>:
</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="literal">zebrasrv</code></span></dt><dd><p>
The <acronym class="acronym">Z39.50</acronym> server and search engine.
</p></dd><dt><span class="term"><code class="literal">zebraidx</code></span></dt><dd><p>
The administrative indexing tool.
</p></dd><dt><span class="term"><code class="literal">index/*.so</code></span></dt><dd><p>
The <code class="literal">.so</code>-files are <span class="application">Zebra</span> record filter modules.
There are modules for reading
<acronym class="acronym">MARC</acronym> (<code class="filename">mod-grs-marc.so</code>),
<acronym class="acronym">XML</acronym> (<code class="filename">mod-grs-xml.so</code>) , etc.
</p></dd></dl></div><p>
</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>
Using configure option <code class="literal">--disable-shared</code> builds
<span class="application">Zebra</span> statically and links "in" <span class="application">Zebra</span> filter code statically, i.e.
no <code class="literal">.so-files</code> are generated
</p></div><p>
You can now use <span class="application">Zebra</span>. If you wish to install it system-wide, then
as root type
</p><pre class="screen">
make install
</pre><p>
By default this will install the <span class="application">Zebra</span> executables in
<code class="filename">/usr/local/bin</code>,
and the standard configuration files in
<code class="filename">/usr/local/share/idzebra-2.0</code>. If
shared modules are built, these are installed in
<code class="filename">/usr/local/lib/idzebra-2.0/modules</code>.
You can override this with the <code class="literal">--prefix</code> option
to configure.
</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="introduction-support.html">Prev</a></td><td width="20%" align="center"></td><td width="40%" align="right"><a accesskey="n" href="installation-debian.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">4.Support</td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top">2.GNU/Debian</td></tr></table></div></body></html>
|
