X-Git-Url: http://git.indexdata.com/?p=yazproxy-moved-to-github.git;a=blobdiff_plain;f=doc%2Finstallation.xml;h=364e4fdb7acf942c66eba2924f42accf21deabd5;hp=4c32b9d3915378a3b6fb3d9961b9c8f05a79ba1a;hb=9b8dda8226cff9fb0ee5bf8d7c0e88e9613df63e;hpb=b65837a1f4aadf842d112f5e37382d93f26da83d diff --git a/doc/installation.xml b/doc/installation.xml index 4c32b9d..364e4fd 100644 --- a/doc/installation.xml +++ b/doc/installation.xml @@ -1,9 +1,9 @@ - Installation You need a C++ compiler to compile and use YAZ proxy. - The software was implemented using GCC so we know that works + The software was implemented using + GCC so we know that works well with YAZ proxy. From time to time the software has been compiled on Windows using Visual C++. Other compilers should work too. Let us know of portability problems, etc. with @@ -11,20 +11,30 @@ YAZ proxy is built on top of the - YAZ and - YAZ++ + YAZ and + YAZ++ toolkits. You need to install these first. - For some platforms there are binary packages for YAZ/YAZ++. + For some platforms there are binary packages available for YAZ/YAZ++. We also highly recommend that - libxml2 and - libXSLT are installed. + libxml2 and + libXSLT are installed. YAZ must be configured with libxml2 support. - If not, SRW/SRU is not supported. + If not, + SRU + is not supported. The YAZ Proxy uses libXSLT for record conversions via XSLT. + + YAZ proxy may also use USEMARCON to convert between MARC + formats. This is useful if you want the proxy to offer more + MARC record types than the backend target supports. Get USEMARCON + from: + British Library USEMARCON page + . +
Building on Unix On UNIX, the software is compiled as follows: @@ -47,16 +57,16 @@ - --with-yazppconfig directory + --with-yazpp directory - Specifies the location of yaz++-config. - The yaz++-config program is generated in + Specifies the location of yazpp-config. + The yazpp-config program is generated in the source directory of YAZ++ as well as the binaries directory when YAZ++ is installed (via make install). If you don't supply this option, configure will - look for yaz++-config in directories of the + look for yazpp-config in directories of the PATH environment - which is nearly always what you want. @@ -70,6 +80,15 @@ for xslt-config in the current PATH. + + --with-usemarcon directory + + Specifies USEMARCON installation prefix. + configure must be able to locate usemarcon-config + in PREFIX/bin. If this option is omitted, configure looks + for usemarcon-config in the current PATH. + + For the whole list of configure options, refer to the help: @@ -117,8 +136,11 @@ etc - Various files that may be read by YAZ proxy - including - configuration file, XSLT files, CQL to RPN conversion. + Various files such as + configuration files, XSLT files, CQL to RPN conversion files, + a sample start/stop control script + yazproxy.ctl.sh that can be used as + template for an /etc/init.d script. These files are installed in the YAZ proxy's data area (prefix/share/yazproxy). @@ -131,7 +153,7 @@ Building on Windows 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. @@ -184,7 +206,7 @@ If HAVE_LIBXSLT is set to 1, the proxy is compiled with XSLT and XML support. In this configuration, set LIBXSLT_DIR to the - libXSLT source + libXSLT source directory. @@ -197,7 +219,7 @@ Windows versions of libXSLT, libxml2, zlib and iconv can be found - + here. @@ -221,7 +243,7 @@ If HAVE_LIBXML2 is set to 1, the proxy is compiled with XML support. In this configuration, set LIBXML2_DIR to the - libxml2 source directory + libxml2 source directory and ZLIB_DIR to the zlib directory.