X-Git-Url: http://git.indexdata.com/?a=blobdiff_plain;f=doc%2Finstallation.xml;h=c19627fd029a6e14c5124580fe67b7e1d55c63e4;hb=c33ea56e3771c3b80ba66ef8fda3a09cad171ebb;hp=4bcadb930814b59d1be4c07beaa353e2146d2eeb;hpb=105e2d14529d13a05ac9723daf0640e81a1b71c0;p=idzebra-moved-to-github.git diff --git a/doc/installation.xml b/doc/installation.xml index 4bcadb9..c19627f 100644 --- a/doc/installation.xml +++ b/doc/installation.xml @@ -1,25 +1,23 @@ - + 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. + 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 + Debian GNU/Linux, + Redhat Linux, + Gentoo Linux, + SuSE Linux, + FreeBSD (i386), + MAC OSX, + SunOS 5.8 (sparc), - Windows 2000. + Windows 2000. @@ -28,17 +26,18 @@ - 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 Z39.50 / + SRU. + Also the memory management utilites from YAZ is used by Zebra. - iconv + iconv (optional) @@ -49,7 +48,7 @@ - Expat + Expat (optional) @@ -61,19 +60,7 @@ - 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 @@ -85,8 +72,8 @@ - Autoconf, - Automake + Autoconf, + Automake (optional) @@ -98,7 +85,7 @@ - Docbook + Docbook and friends (optional) @@ -112,9 +99,9 @@ - UNIX +
UNIX - On Unix, gcc works fine, but any native + On Unix, GCC works fine, but any native C compiler should be possible to use as long as it is ANSI C compliant. @@ -197,87 +184,87 @@ By default this will install the Zebra executables in /usr/local/bin, and the standard configuration files in - /usr/local/share/idzebra + /usr/local/share/idzebra-2.0 You can override this with the --prefix option to configure. - +
- GNU/Debian - GNU/Debian Linux on + <section id="installation-debian"><title>GNU/Debian +
GNU/Debian Linux on i686 Platform - Index Data provides pre-compiled GNU/Debian i686 - Linux packages at our Debian package archive, both for - the Sarge and the Etch release. + Index Data provides pre-compiled GNU/Debian i686 Linux packages + at our Debian package archive, both for + the Sarge and the Etch release. To install these packages, you need to add two lines to your - /etc/apt/sources.list configuration file, - either the Sarge sources found at + /etc/apt/sources.list configuration file, + either the Sarge sources found at - deb http://ftp.indexdata.dk/t/debian sarge main - deb-src http://ftp.indexdata.dk/t/debian sarge main + deb http://ftp.indexdata.dk/debian sarge main + deb-src http://ftp.indexdata.dk/debian sarge main - or the Etch sources from + or the Etch sources from - deb http://ftp.indexdata.dk/t/debian etch main - deb-src http://ftp.indexdata.dk/t/debian etch main + deb http://ftp.indexdata.dk/debian etch main + deb-src http://ftp.indexdata.dk/debian etch main After refreshing the package cache with the command apt-get update as root, the - Zebra indexer is + 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 +
+ Ubuntu/Debian and GNU/Debian on other platforms - These Zebra + These Zebra packages are specifically compiled for - GNU/Debian Linux systems. Installation on other - GNU/Debian systems is possible by + 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 + /etc/apt/sources.list configuration file, + that is either the Sarge sources - deb-src http://ftp.indexdata.dk/t/debian sarge main + deb-src http://ftp.indexdata.dk/debian sarge main - or the Etch sources + or the Etch sources - deb-src http://ftp.indexdata.dk/t/debian etch main + deb-src http://ftp.indexdata.dk/debian etch main After refreshing the package cache with the command apt-get update + apt-get build-dep idzebra-2.0 as root, the - Zebra indexer is + Zebra indexer is recompiled and installed issuing - apt-get build-dep idzebra - apt-get source --compile idzebra + 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 +
WIN32 The easiest way to install Zebra on Windows is by downloading an installer from here. @@ -287,10 +274,9 @@ 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. + with Microsoft Visual C++. + Version 2003 and 2005 has been tested. We expect that zebra compiles + with version 6 as well. Start a command prompt and switch the sub directory @@ -327,12 +313,11 @@ EXPAT_DIR If HAVE_EXPAT is set to 1, Zebra is compiled - with Expat support. In this configuration, set - ZEBRA_DIR to the Expat source directory. + with Expat support. + In this configuration, set + ZEBRA_DIR to the Expat source directory. Windows version of Expat can be downloaded from - - SourceForge - . + SourceForge. @@ -344,9 +329,7 @@ with iconv support. In this configuration, set ICONV_DIR to the iconv source directory. Iconv binaries can be downloaded from - - this site - . + this site. @@ -358,8 +341,7 @@ Define these symbols if Zebra is to be compiled with - BZIP2 - record compression support. + BZIP2 record compression support. @@ -414,8 +396,84 @@ - +
+ + +
+ 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/ + + + + The internal binary register structures have changed; all Zebra + databases must be re-indexed after upgrade. + + + The attribute set defintion files may no longer contain + redirection to other fields. + For example the following snippet of + a custom custom/bib1.att + Bib-1 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 GRS + *.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 GRS + *.abs record indexing configuration files. + + + Server installations which use the special + IDXPATH attribute set must add the following + line to the zebra.cfg configuration file: + + attset: idxpath.att + + +