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
|
<html><head><meta 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 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="https://gcc.gnu.org" target="_top">GCC</a> on UNIX and
<a class="ulink" href="https:/visualstudio.microsoft.com" target="_top">Microsoft Visual C++</a> on Windows.
</p><p>
The software is regularly tested on
<a class="ulink" href="https://debian.org" target="_top">Debian GNU/Linux</a>,
<a class="ulink" href="https://ubuntu.com" target="_top">Ubuntu Linux</a>,
<a class="ulink" href="https://apple.com/os/macos/" 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="https://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="https://xmlsoft.org/" target="_top">Libxml2</a>
and
<a class="ulink" href="https://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="https://www.tcl-lang.org" 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>
|
