X-Git-Url: http://git.indexdata.com/?p=idzebra-moved-to-github.git;a=blobdiff_plain;f=doc%2Finstallation.xml;h=bdaebc4865936ae315d1d659631862c51dbdffdb;hp=d4bc6fdceed9524908acec6a6e4f3c25d3d8884e;hb=dcda88860b03641b6900d43135ca769f005105e8;hpb=9d362ae644a6dafc54920b7dc18bf9e5be8b6b60 diff --git a/doc/installation.xml b/doc/installation.xml index d4bc6fd..bdaebc4 100644 --- a/doc/installation.xml +++ b/doc/installation.xml @@ -1,44 +1,48 @@ - Installation - Zebra is written in ANSI C and was implemented with portability in mind. - We primarily use GCC on UNIX and - - Microsoft Visual C++ - on Windows. + &zebra; is written in &acro.ansi; C and was implemented with portability in mind. + We primarily use GCC on UNIX and + Microsoft Visual C++ on Windows. The software is regularly tested on - Debian GNU/Linux, - Redhat Linux, - Gentoo Linux, - SuSE Linux, - FreeBSD (i386), - MAC OSX, - SunOS 5.8 - (sparc), - Windows 2000. + Debian GNU/Linux, + Red Hat Linux, + FreeBSD (i386), + MAC OSX, + Windows 7. - + - Zebra can be configured to use the following utilities (most of + &zebra; can be configured to use the following utilities (most of which are optional): - yaz + &yaz; (required) - Zebra uses YAZ to support Z39.50/SRW. Also the memory management - utilites from YAZ is used by Zebra. + &zebra; uses &yaz; to support &acro.z3950; / + &acro.sru;. + Zebra also uses a lot of other utilities (not related to networking), + such as memory management and XML support. + + + For the DOM XML + / ALVIS + record filters, &yaz; must be compiled with + Libxml2 + and + Libxslt + support and Libxml2 must be version 2.6.15 or later. - iconv + iconv (optional) @@ -49,93 +53,81 @@ - Expat + Expat (optional) - XML parser. If you're going to index real XML you should + &acro.xml; parser. If you're going to index real &acro.xml; you should install this (filter grs.xml). On most systems you should be able to find binary Expat packages. - - - Perl (optional) - - - Perl is required if you're going to use the Zebra perl - filter facility or the Zebra perl API. Perl is preinstalled - on many Unixes. We've not tried the Perl extension on - Windows ourselves. - - - - + - Tcl (optional) + Tcl (optional) Tcl is required if you need to use the Tcl record filter - for Zebra. You can find binary packages for Tcl for many + for &zebra;. You can find binary packages for Tcl for many Unices and Windows. - + - Autoconf, - Automake + Autoconf, + Automake (optional) GNU Automake and Autoconf are only required if you're - using the CVS version of Zebra. You do not need these - if you have fetched a Zebra tar. + using the CVS version of &zebra;. You do not need these + if you have fetched a &zebra; tar. - + - Docbook + Docbook and friends (optional) These tools are only required if you're writing - documentation for Zebra. You need the following - Debian packages: jadetex, docbook, docbook-dsssl, - docbook-xml, docbook-utils. + documentation for &zebra;. You need the following + Debian packages: docbook, docbook-xml, docbook-xsl, + docbook-utils, xsltproc. - UNIX +
UNIX - On Unix, gcc works fine, but any native - C compiler should be possible to use as long as it is - ANSI C compliant. + On Unix, GCC works fine, but any native + C compiler should be possible to use as long as it is + &acro.ansi; C compliant. - + 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. + directory of &zebra;. - + To run the configure script type: - + ./configure - + - + The configure script attempts to use C compiler specified by the CC environment variable. @@ -143,7 +135,7 @@ The CFLAGS 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: - + CC=/opt/ccs/bin/cc CFLAGS=-O ./configure @@ -155,7 +147,7 @@ ./configure --help - + Once the build environment is configured, build the software by typing: @@ -163,142 +155,147 @@ make - + If the build is successful, two executables are created in the sub-directory index: - + zebrasrv - The Z39.50 server and search engine. + The &acro.z3950; server and search engine. - zebraidx + zebraidx The administrative indexing tool. + + + index/*.so + + + The .so-files are &zebra; record filter modules. + There are modules for reading + &acro.marc; (mod-grs-marc.so), + &acro.xml; (mod-grs-xml.so) , etc. + + + + - + + + + Using configure option --disable-shared builds + &zebra; statically and links "in" &zebra; filter code statically, i.e. + no .so-files are generated + + + - You can now use Zebra. If you wish to install it system-wide, then + You can now use &zebra;. If you wish to install it system-wide, then as root type make install - By default this will install the Zebra executables in + By default this will install the &zebra; executables in /usr/local/bin, - and the standard configuration files in - /usr/local/share/idzebra + and the standard configuration files in + /usr/local/share/idzebra-2.0. If + shared modules are built, these are installed in + /usr/local/lib/idzebra-2.0/modules. You can override this with the --prefix option to configure. - +
- GNU/Debian - GNU/Debian Linux +
GNU/Debian +
GNU/Debian Linux on + amd64/i386 Platform - Index Data provides pre-compiled GNU/Debian - Linux packages at our Debian package archive, both for - the Sarge and the Etch release. + Index Data provides pre-compiled GNU/Debian and Ubuntu packages + at our Debian package archive, both for recent releases. - + - To install these packages, you need to add two lines to your - /etc/apt/sources.list configuration file, - either the Sarge sources found at - - deb http://www.indexdata.dk/debian indexdata/sarge released - deb-src http://www.indexdata.dk/debian indexdata/sarge released - - or the Etch sources from - - deb http://www.indexdata.dk/debian indexdata/etch released - deb-src http://www.indexdata.dk/debian indexdata/etch released - + For Debian, refer to + + for how to configure APT. For Ubuntu, refer to + . After refreshing the package cache with the command apt-get update - as root, the - Zebra indexer is + as root, the + &zebra; indexer is easily installed issuing - apt-get install idzebra idzebra-doc + apt-get install idzebra-2.0 idzebra-2.0-doc - - - - GNU/Debian On Other Platforms +
+ +
+ GNU/Debian and Ubuntu on other architectures - These Zebra + These &zebra; packages are specifically compiled for - GNU/Debian Linux systems. Installation on other - GNU/Debian systems is possible by - re-compilation the Debian way: you need to add only the - deb-src sources lines to the - /etc/apt/sources.list configuration file, - that is either the Sarge sources - - deb-src http://www.indexdata.dk/debian indexdata/sarge released - - or the Etch sources - - deb-src http://www.indexdata.dk/debian indexdata/etch released - + GNU/Debian Linux systems and Ubuntu. Installation on other + GNU/Debian systems is possible by + re-compilation the Debian way: you need to add only the + deb-src sources lines to the + /etc/apt/sources.list configuration file, After refreshing the package cache with the command apt-get update + apt-get build-dep idzebra-2.0 - as root, the - Zebra indexer is + as root, the + &zebra; indexer is recompiled and installed issuing - apt-get build-dep idzebra - apt-get source --compile idzebra + fakeroot apt-get source --compile idzebra-2.0 as normal user. - The compiled GNU/Debian packages can then be + The compiled GNU/Debian packages can then be installed as root issuing - dpkg -i install idzebra*.deb idzebra-doc*.deb + dpkg -i install idzebra-2.0*.deb libidzebra-2.0*.deb - - +
+
- WIN32 - The easiest way to install Zebra on Windows is by downloading - an installer from - here. +
Windows + The easiest way to install &zebra; on Windows is by downloading + an installer from + here. The installer comes with source too - in case you wish to - compile Zebra with different Compiler options. + compile &zebra; with different Compiler options. - + - Zebra is shipped with "makefiles" for the NMAKE tool that comes - with - Microsoft Visual C++. - Version 6 has been tested. We expect that zebra compiles - with version 5 as well. + &zebra; is shipped with "makefiles" for the NMAKE tool that comes + with Microsoft Visual C++. + Version 2013 has been tested. Start a command 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 notepad). - + The following summarizes the most important settings in that file: - + DEBUG @@ -309,67 +306,50 @@ (code generation is multi-threaded DLL). - + YAZDIR - Directory of YAZ source. Zebra's makefile expects to find - yaz.lib, yaz.dll + Directory of &yaz; source. &zebra;'s makefile expects to find + YAZ.lib, YAZ.dll in yazdir/lib and yazdir/bin respectively. - + HAVE_EXPAT, EXPAT_DIR - If HAVE_EXPAT is set to 1, Zebra is compiled - with Expat support. In this configuration, set + If HAVE_EXPAT is set to 1, &zebra; is compiled + with Expat support. + In this configuration, set ZEBRA_DIR to the Expat source directory. Windows version of Expat can be downloaded from - - SourceForge - . + SourceForge. - - - HAVE_ICONV, - ICONV_DIR - - If HAVE_ICONV is set to 1, Zebra is compiled - with iconv support. In this configuration, set - ICONV_DIR to the iconv source directory. - Iconv binaries can be downloaded from - - this site - . - - - - + BZIP2INCLUDE, BZIP2LIB, BZIP2DEF - Define these symbols if Zebra is to be compiled with - BZIP2 - record compression support. + Define these symbols if &zebra; is to be compiled with + BZIP2 record compression support. - + - The DEBUG setting in the makefile for Zebra must + The DEBUG setting in the makefile for &zebra; must be set to the same value as DEBUG setting in the - makefile for YAZ. - If not, the Zebra server/indexer will crash. + makefile for &yaz;. + If not, the &zebra; server/indexer will crash. @@ -389,8 +369,8 @@ - If you wish to recompile Zebra - for example if you modify - settings in the makefile you can delete + If you wish to recompile &zebra; - for example if you modify + settings in the makefile you can delete object files, etc by running. nmake clean @@ -398,24 +378,102 @@ The following files are generated upon successful compilation: - + bin/zebraidx.exe - The Zebra indexer. + The &zebra; indexer. - + bin/zebrasrv.exe - The Zebra server. + The &zebra; server. - + - + + +
+ + +
+ Upgrading from &zebra; version 1.3.x + + &zebra;'s installation directories have changed a bit. In addition, + the new loadable modules must be defined in the + master zebra.cfg configuration file. The old + version 1.3.x configuration options + + # profilePath - where to look for config files + profilePath: some/local/path:/usr/share/idzebra/tab + + must be changed to + + # profilePath - where to look for config files + profilePath: some/local/path:/usr/share/idzebra-2.0/tab + + # modulePath - where to look for loadable zebra modules + modulePath: /usr/lib/idzebra-2.0/modules + + + + + The internal binary register structures have changed; all &zebra; + databases must be re-indexed after upgrade. + + + + The attribute set definition files may no longer contain + redirection to other fields. + For example the following snippet of + a custom custom/bib1.att + &acro.bib1; attribute set definition file is no + longer supported: + + att 1016 Any 1016,4,1005,62 + + and should be changed to + + att 1016 Any + + + + Similar behaviour can be expressed in the new release by defining + a new index Any:w in all &acro.grs1; + *.abs record indexing configuration files. + The above example configuration needs to make the changes + from version 1.3.x indexing instructions + + xelm /*/alternative Body-of-text:w,Title:s,Title:w + xelm /*/title Body-of-text:w,Title:s,Title:w + + to version 2.0.0 indexing instructions + + xelm /*/alternative Any:w,Body-of-text:w,Title:s,Title:w + xelm /*/title Any:w,Body-of-text:w,Title:s,Title:w + + + + It is also possible to map the numerical attribute value + @attr 1=1016 onto another already existing huge + index, in this example, one could for example use the mapping + + att 1016 Body-of-text + + with equivalent outcome without editing all &acro.grs1; + *.abs record indexing configuration files. + + + + Server installations which use the special + &acro.idxpath; attribute set must add the following + line to the zebra.cfg configuration file: + + attset: idxpath.att + - +
-