X-Git-Url: http://git.indexdata.com/?p=yazproxy-moved-to-github.git;a=blobdiff_plain;f=doc%2Finstallation.xml;h=62356a597c670ba62c9b659fd69b91793724fab2;hp=62a5228bb69ae36c34637c0e7c9a2ec13f1692a4;hb=2bab0500e690612c044b1d9f87a0f03bc1640743;hpb=3f57a94d4bb1753d013d5bf450af407d6a32d36d diff --git a/doc/installation.xml b/doc/installation.xml index 62a5228..62356a5 100644 --- a/doc/installation.xml +++ b/doc/installation.xml @@ -1,9 +1,10 @@ - + 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 @@ -15,7 +16,17 @@ 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. + YAZ must be configured with libxml2 support. + If not, + SRW/SRU + is not supported. + The YAZ Proxy uses libXSLT for record conversions via XSLT.
Building on Unix @@ -39,7 +50,7 @@ - --with-yazppconfig directory + --with-yazpp directory Specifies the location of yaz++-config. The yaz++-config program is generated in @@ -56,7 +67,7 @@ --with-xslt directory - Specifies prefix for libxslt (and libxml2). + Specifies prefix for libXSLT (and libxml2). configure must be able to locate xslt-config in PREFIX/bin. If this option is omitted, configure looks for xslt-config in the current PATH. @@ -70,8 +81,8 @@ Configure uses GCC's C/C++ compiler if available. To specify another compiler, set CXX. To use other compiler flags, - specify CXXFLAGS. To use CC - with debugging you could use: + specify CXXFLAGS. For example, to use + CC with debugging do: CXXFLAGS="-g" CXX=CC ./configure @@ -82,8 +93,8 @@ src/yazproxy - The YAZ Z39.50 Proxy. - This program gets installed in your binaries directory + The YAZ Proxy program. + It gets installed in your binaries directory (prefix/bin). @@ -92,7 +103,7 @@ src/libyazproxy.la The YAZ proxy library. This library gets installed in - your libraries directory + the libraries directory (prefix/lib). @@ -100,12 +111,25 @@ include/yazproxy/*.h - Various C++ header files, which you'll need for YAZ proxy - development. All these are installed in your header files area + C++ header files, which you'll need for YAZ proxy + development. All these are installed in the header files area (prefix/include/yazproxy). + + etc + + 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). + + +
@@ -118,7 +142,16 @@ Version 6 and .NET has been tested. We expect that YAZ++ compiles with version 5 as well. + + The YAZ proxy has never been used in production on Windows. Although + it compiles and runs, doesn't mean it scale on that platform. + Furthermore the + YAZ proxy currently doesn't run as a Service - only as a Console + application. + + + Start a command prompt and switch the sub directory WIN where the file makefile is located. Customize the installation by editing the @@ -137,6 +170,18 @@ + YAZ_DIR + + This must be set to the home of the YAZ source directory. + + + + YAZPP_DIR + + This must be set to the home of the YAZ++ source directory. + + + HAVE_XSLT, LIBXSLT_DIR @@ -145,7 +190,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. @@ -157,7 +202,7 @@ - Windows versions of libxslt, libxml2, zlib and iconv can be found + Windows versions of libXSLT, libxml2, zlib and iconv can be found here. @@ -238,7 +283,6 @@ bin/yazproxy.exe YAZ proxy. It's a WIN32 console application. - See for more information.