X-Git-Url: http://git.indexdata.com/?a=blobdiff_plain;f=doc%2Finstallation.xml;h=e1c77d341dd5579a4eaaa64fb09759dbfab720ef;hb=9d9266bfed4daa001a3f038f0d5b6e8c51a37373;hp=9b0f6979cbbc458aa35a86f3fdd73851cf9af923;hpb=54f62385efb0b6b99dff15d0c72e0e257f45a843;p=idzebra-moved-to-github.git diff --git a/doc/installation.xml b/doc/installation.xml index 9b0f697..e1c77d3 100644 --- a/doc/installation.xml +++ b/doc/installation.xml @@ -1,9 +1,12 @@ - + 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. @@ -12,11 +15,11 @@ Redhat Linux, Gentoo Linux, SuSE Linux, - NetBSD (Cobalt), FreeBSD (i386), MAC OSX, - SunOS 5.8 (sparc), - Windows 2000 SP3. + SunOS 5.8 + (sparc), + Windows 2000. @@ -29,7 +32,7 @@ (required) - Zebra uses YAZ to support Z39.50/SRW. Also the memory management + Zebra uses YAZ to support Z39.50/ SRW. Also the memory management utilites from YAZ is used by Zebra. @@ -111,7 +114,7 @@ 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. @@ -194,11 +197,86 @@ 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 + 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. + + + + 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://ftp.indexdata.dk/debian sarge main + deb-src http://ftp.indexdata.dk/debian sarge main + + or the Etch sources from + + 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 + easily installed issuing + + apt-get install idzebra-2.0 idzebra-2.0-doc + + + + + + Ubuntu/Debian and GNU/Debian on other platforms + + 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://ftp.indexdata.dk/debian sarge main + + or the Etch sources + + 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 + recompiled and installed issuing + + apt-get source --compile idzebra-2.0 + + as normal user. + The compiled GNU/Debian packages can then be + installed as root issuing + + 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 @@ -249,8 +327,12 @@ 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 + . @@ -261,14 +343,14 @@ 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 + Iconv binaries can be downloaded from - this site. - + this site + . + - + BZIP2INCLUDE, BZIP2LIB, @@ -276,7 +358,8 @@ Define these symbols if Zebra is to be compiled with - BZIP2 record compression support. + BZIP2 + record compression support. @@ -332,6 +415,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 + + + +