X-Git-Url: http://git.indexdata.com/?p=yaz-moved-to-github.git;a=blobdiff_plain;f=doc%2Finstallation.xml;h=e07f1c944b88400a037e31ccfb0fce820d9a2dc4;hp=7dd99865e1ec5e08e88c4f1b4243ee02077642cd;hb=e26f2eaefc5fae6784beb45a1435a4fbfa25f25c;hpb=8d0e0fa62fea7c440a92d43452774523b5cf5faa diff --git a/doc/installation.xml b/doc/installation.xml index 7dd9986..e07f1c9 100644 --- a/doc/installation.xml +++ b/doc/installation.xml @@ -1,4 +1,4 @@ - + Compilation and Installation Introduction @@ -6,8 +6,7 @@ The latest version of the software will generally be found at: - - http://ftp.indexdata.dk/pub/yaz/ + We have tried our best to keep the software portable, and on many @@ -17,21 +16,20 @@ The software is regularly tested on - Debian GNU/Linux, - Redhat Linux, - Gentoo Linux, - FreeBSD (i386), - MAC OSX, - - SunOS 5.8 (sparc), - - Windows 2000. + Debian GNU/Linux, + Redhat Linux, + Gentoo Linux, + FreeBSD (i386), + MAC OSX, + SunOS 5.8 (sparc), + Windows 2000, + Windows 2003 server. Some versions have be known to work on HP/UX, - DEC Unix, NetBSD, - OpenBSD, + DEC Unix, NetBSD, + OpenBSD, IBM AIX, Data General DG/UX (with some CFLAGS tinkering), SGI/IRIX, DDE Supermax, Apple Macintosh (using the Codewarrior programming @@ -50,16 +48,12 @@ We maintain a mailing-list for the purpose of announcing new releases and - bug-fixes, as well as general discussion. Subscribe by sending mail to - - yaz-request@indexdata.dk - or fill-in the form - - here. + bug-fixes, as well as general discussion. Subscribe by + filling-in the form + here. General questions and problems can be directed at - - yaz-help@indexdata.dk - , or the address given at the top of this document. + , or the address given at the top of + this document. @@ -67,9 +61,9 @@ We provide - Debian GNU/Linux + Debian GNU/Linux and - Redhat packages for &yaz;. + Redhat packages for &yaz;. Only i386 binary packages are available. You should be able to create packages for other CPUs by building them from the source package. @@ -81,7 +75,7 @@ Note that if your system doesn't have a native ANSI C compiler, you may have to acquire one separately. We recommend - GCC. + GCC. @@ -89,22 +83,23 @@ are compiling &yaz; for use with Zebra it is a good idea to ensure that the iconv library is installed. Some Unixes today already have it - if not, we suggest - GNU iconv. + GNU libiconv. - The XML C library libxml2 - is required if &yaz; is to support SRW (and SOAP). - This library is very portable and should compile out-of-the + The libxslt, + libxml2 librararies are required + if &yaz; is to support SRU. + These libraries are very portable and should compile out-of-the box on virtually all Unix platforms. It is available in binary forms for Linux and others. The GNU tools - Autoconf, - Automake and - Libtool + Autoconf, + Automake and + Libtool are used to generate Makefiles and configure &yaz; for the system. You do not these tools unless you're using the CVS version of &yaz;. @@ -112,13 +107,13 @@ The CQL parser for &yaz; is built using - GNU Bison. + GNU Bison. This tool is only needed if you're using the CVS version of &yaz;. &yaz; includes a tiny ASN.1 compiler. This compiler is - written in Tcl. + written in Tcl. But as for Bison you do not need it unless you're using CVS version of &yaz; or you're using the compiler to built own codecs for private ASN.1. @@ -161,10 +156,10 @@ --enable-tcpd The front end server will be built using Wietse's - - TCP wrapper library. It allows you to allow/deny - clients depending on IP number. The TCP wrapper library is - often used in Linux/BSD distributions. + TCP wrapper library. + It allows you to allow/deny clients depending on IP number. + The TCP wrapper library is often used in GNU/Linux and + BSD distributions. See hosts_access @@ -206,25 +201,25 @@ Compile &yaz; with iconv library in directory prefix. By default configure will - search for iconv on your system. Use this option if it - doesn't find iconv. Alternatively you can use - --without-iconv to force &yaz; not to use - iconv. + search for iconv on the system. Use this option if it + doesn't find iconv. Alternatively, + --without-iconv, can be uset to force &yaz; + not to use iconv. - --with-xml2[=prefix] + --with-xslt[=prefix] Compile &yaz; with - libxml2 in directory + libxslt in directory prefix. - Use this option if you want SOAP support. - By default configure will - search for libxml2 on your system. Use this option if it - doesn't find libxml2. Alternatively you can use - --without-xml2 to force &yaz; not to use - libxml2. + Use this option if you want SRU support. + By default, configure will + search for libxslt on the system. Use this option if it + libxslt is not found automatically. Alternatively, + --without-xslt, can be used to force &yaz; + not to use libxslt. @@ -434,7 +429,7 @@ The easiest way to install YAZ on Windows is by downloading an installer from - here. + here. The installer comes with source too - in case you wish to compile YAZ with different Compiler options etc. @@ -443,7 +438,7 @@ Compiling from Source on WIN32 &yaz; is shipped with "makefiles" for the NMAKE tool that comes - with + with Microsoft Visual Studio. Version 6 and .NET has been tested. We expect that &yaz; compiles with version 5 as well. @@ -491,8 +486,8 @@ (cql.y). - GNU Bison for Windows is part of - unxutils. + A Windows version of GNU Bison is part of + unxutils. @@ -512,17 +507,45 @@ If HAVE_LIBXML2 is set to 1, YAZ is compiled - with SRW (and SOAP) support. In this configuration, set + with SRU support. In this configuration, set LIBXML2_DIR to the - libxml2 source directory. + libxml2 source directory + and + ZLIB_DIR to the zlib directory. - Windows versions of libxml2 and iconv can be found - - here. + Windows versions of libxslt, libxml2, zlib and iconv can be found + + Igor Zlatković' site. + + + + YAZ is not using zlib but libxml2 is depending on it. + + + + + + + HAVE_LIBXSLT, + LIBXSLT_DIR + + + If HAVE_LIBXSLT is set to 1, YAZ is compiled + with XSLT support. In this configuration, set + LIBXSLT_DIR to the + libxslt source directory. + + + + + libxslt depends libxml2. + + + @@ -557,7 +580,7 @@ bin/yaz.dll - &yaz; multi-threaded Dynamic Link Library. + &yaz; release mode multi-threaded Dynamic Link Library. lib/yaz.lib @@ -565,6 +588,16 @@ Import library for yaz.dll. + bin/yazd.dll + + &yaz; debug mode multi-threaded Dynamic Link Library. + + + lib/yazd.lib + + Import library for yazd.dll. + + bin/yaz-client.exe &yaz; Z39.50 client application. It's a WIN32 console application. @@ -619,6 +652,8 @@ You must link with this library. It's located in the sub directory lib of &yaz;. + If you want to link with the debug version of &yaz;, you must + link with yazd.dll instead. dynamic link library yaz.dll