You need the YAZ package in order to compile this software. We suggest you unpack YAZ in the same directory as Zebra. Running ./configure (UNIX Only) and running make (nmake on WIN32) is in usully what it takes to compile YAZ.
An ANSI C compiler is required to compile the Zebra
server system — gcc works very well if your own system doesn't
provide an adequate compiler.
Unpack the distribution archive. The configure 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.
To run the configure script type:
./configure
The configure script attempts to use the C compiler specified by
the CC environment variable. If not set, GNU C
will be used if it is available. The CFLAGS environment variable
holds options to be passed to the C compiler. If you're using a
Bourne-compatible shell you may pass something like this:
CC=/opt/ccs/bin/cc CFLAGS=-O ./configure
To customize Zebra the configure script accepts a set of options. The most important are
--prefix pathSpecifies installation prefix. This is
only needed if you run make install later to perform a
"system" installation. The prefix is /usr/local if not
specified.
--with-tclconfig pathIf Tcl is installed on
the system you can tell configure where Tcl's tclConfig.sh
installed. The tclConfig.sh include information about settings
required to link with Tcl's libraries. If you don't specify this
option, configure will see if Tcl's shell tclsh is in your
path and if it is, it will guess where the equivalent tclConfig.sh
is located. If tclsh is not found in your path and this option is not
given Zebra will not include Tcl support.
--with-yazconfig pathThis options allows you to
specify the path of YAZ's yaz-config. Therefore this option
forces Zebra to use a particular version of YAZ. YAZ version 1.5 and
later creates a script yaz-config that includes information
on compiler settings needed to link with it.
When configured build the software by typing:
make
As an option you may type make depend to create
source file dependencies for the package. This is only needed,
however, if you modify the source code later.
If successful, two executables have been created in the sub-directory
bin.
zebrasrvThe Z39.50 server and search engine.
zebraidxThe administrative tool for the search index.
The next step is optional and is only needed if you wish to install zebra in system directories such as /usr/bin, /usr/lib, etc.
To perform this step, type
make install
The executables will be installed in prefix/bin, and profile tables will be installed in prefix/lib/zebra/tab. Here prefix represents the prefix as specified -- default being /usr/local.
Zebra is shipped with "makefiles" for the NMAKE tool that comes with Visual C++.
Start an MS-DOS prompt and switch the sub directory WIN where
the file makefile is located. Customize the installation
by editing the makefile file (for example by using wordpad).
The following summarises the most important settings in that file.
YAZDIRSpecifies where YAZ is located.
DEBUGIf set to 1, the software is compiled with debugging libraries. If set to 0, the software is compiled with release (non-debugging) libraries.
A group of settings (BZIP2LIB,..)
that must be defined if BZIP2 compression support is desired.
When satisfied with the settings in the makefile type
nmake
If compilation was successful the executables zebraidx.exe
and zebrasrv.exe are put in the sub directory BIN.