<chapter id="installation">
- <!-- $Id: installation.xml,v 1.3 2002-10-22 08:23:57 adam Exp $ -->
<title>Installation</title>
<para>
You need a C++ compiler to compile and use YAZ++.
- The software was implemented using GCC so we know that works
- well with YAZ++. 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
- your system!
+ The software was implemented using <ulink url="&url.gcc;">GCC</ulink>
+ so we know that works well with YAZ++. From time to time the
+ software is compiled on Windows using Visual C++.
+ Other compilers should work too. Let us know of portability
+ problems, etc. with your system.
</para>
<para>
YAZ++ is built on top of the
- <ulink url="http://indexdata.dk/yaz/">YAZ</ulink>
+ <ulink url="&url.yaz;">YAZ</ulink>
toolkit.
You need to install that first.
For some platforms there are binary packages for YAZ.
</para>
<section id="unix">
- <title>UNIX</title>
+ <title>Installation on Unix (from source)</title>
<para>On UNIX, the software is compiled as follows:
<screen>
- ./configure
- make
- su
- make install
+ $ ./configure
+ $ make
+ $ su
+ # make install
</screen>
</para>
<para>
- You can supply options for the configure script.
+ You can supply options for the <literal>configure</literal> script.
The most useful ones are:
<variablelist>
<varlistentry>
<term><literal>--prefix </literal>directory</term>
<listitem><para>
Specifies installation prefix. By default
- <literal>/usr/local</literal> is used.
+ <filename>/usr/local</filename> is used.
</para></listitem>
</varlistentry>
<varlistentry>
- <term><literal>--with-yazconfig </literal>directory</term>
+ <term><literal>--with-yaz </literal>directory</term>
<listitem><para>
- Specifies location of <filename>yaz-config</filename>.
- The <filename>yaz-config</filename> is generated in
+ Specifies the location of <filename>yaz-config</filename>.
+ The <filename>yaz-config</filename> program is generated in
the source directory of YAZ as well as the binaries
directory when YAZ is installed (via make install).
</para>
<para>
- If you don't supply this option, configure, will
+ If you don't supply this option, <literal>configure</literal> will
look for <filename>yaz-config</filename> in directories of the
- <literal>PATH</literal> environment.
+ <envar>PATH</envar> environment - which is nearly always
+ what you want.
</para></listitem>
</varlistentry>
</variablelist>
- For the whole list of configure options, refer to the help:
+ For the whole list of <literal>configure</literal> options, refer
+ to the help:
<literal>./configure --help</literal>.
</para>
<para>
- This is a list of what you have after successful compilation:
+ Configure uses GNU's C/C++ compiler if available. To specify another
+ compiler, set <literal>CXX</literal>. To use other compiler flags,
+ specify <literal>CXXFLAGS</literal>. To use <literal>CC</literal>
+ with debugging you could use:
+ <screen>
+ CXXFLAGS="-g" CXX=CC ./configure
+ </screen>
+ </para>
+ <para>
+ This is what you have after successful compilation:
<variablelist>
<varlistentry>
- <term>src/yaz-proxy</term>
+ <term><filename>src/libyazpp.la</filename></term>
<listitem><para>
- Z39.50 Proxy. This program gets installed in
- your binaries directory (prefix<literal>/bin</literal>).
+ The YAZ++ library.
+ This library gets installed in your libraries directory
+ (<parameter>prefix</parameter><filename>/lib</filename>).
</para></listitem>
</varlistentry>
+
<varlistentry>
- <term>lib/libyaz++.la</term>
+ <term><filename>src/libzoompp.la</filename></term>
<listitem><para>
- YAZ++ library. This library gets installed in your
- libraries directory (prefix<literal>/lib</literal>).
+ The <link linkend="zoom">ZOOM-C++</link> library.
+ This library gets installed in your libraries directory
+ (<parameter>prefix</parameter><filename>/lib</filename>).
</para></listitem>
</varlistentry>
-
+
<varlistentry>
- <term>include/yaz++/*.h</term>
+ <term><filename>include/yazpp/*.h</filename></term>
<listitem><para>
- Various header files. All these are installed in
- your header files area (prefix<literal>/include/yaz++</literal>).
+ Various C++ header files, which you'll need for YAZ++
+ development. All these are installed in your header files area
+ (<parameter>prefix</parameter><filename>/include/yazpp</filename>).
</para></listitem>
</varlistentry>
<varlistentry>
- <term>yaz++-config</term>
+ <term><filename>yazpp-config</filename></term>
<listitem><para>
- Bourne shell script utility that returns CFLAGS/LIBS
- needed in order to compile with the YAZ++ library.
- This script gets installed in your binaries directory
- (prefix<literal>/bin</literal>).
+ A Bourne shell-script utility that returns the values of the
+ <envar>CFLAGS</envar> and <envar>LIBS</envar>
+ environment variables
+ needed in order to compile your applications with the YAZ++
+ library. This script gets installed in your binaries directory
+ (<parameter>prefix</parameter><filename>/bin</filename>).
</para></listitem>
</varlistentry>
<varlistentry>
- <term>zoom/zclient</term>
+ <term><filename>zoom/zclient</filename></term>
<listitem><para>
- ZOOM C++ demonstration client. This client does not
- get installed in the system directories.
+ ZOOM C++ demonstration client that uses the ZOOM C++ classes.
+ This client does not get installed in the system directories.
</para></listitem>
</varlistentry>
<varlistentry>
- <term>src/yaz-my-client</term>
+ <term><filename>src/yaz-my-client</filename></term>
<listitem><para>
YAZ C++ demonstration client. This client does not
get installed in the system directories.
</varlistentry>
<varlistentry>
- <term>src/yaz-my-server</term>
+ <term><filename>src/yaz-my-server</filename></term>
<listitem><para>
YAZ C++ demonstration server. This server does not
get installed in the system directories.
</variablelist>
</para>
</section>
+ <section id="windows">
+ <title>Installation on Windows</title>
+ <para>
+ YAZ++ is shipped with "makefiles" for the NMAKE tool that comes
+ with <ulink url="&url.vstudio;">Microsoft Visual Studio</ulink>.
+ Version 2003 (7) and 2005 (8) has been tested.
+ We expect that YAZ++ compiles with versions 5 and 6 as well.
+ </para>
+ <para>
+ Start a command prompt and switch the sub directory
+ <filename>WIN</filename> where the file <filename>makefile</filename>
+ is located. Customize the installation by editing the
+ <filename>makefile</filename> file (for example by using notepad).
+
+ The following summarizes the most important settings in that file:
+
+ <variablelist>
+ <varlistentry><term><literal>DEBUG</literal></term>
+ <listitem><para>
+ If set to 1, the software is
+ compiled with debugging libraries (code generation is
+ multi-threaded debug DLL).
+ If set to 0, the software is compiled with release libraries
+ (code generation is multi-threaded DLL).
+ </para></listitem>
+ </varlistentry>
+ <varlistentry><term><filename>YAZ_DIR</filename></term>
+ <listitem><para>
+ Specifies the directory of the YAZ source.
+ </para></listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ <para>
+ When satisfied with the settings in the makefile, type
+ <screen>
+ nmake
+ </screen>
+ </para>
+ <tip>
+ <para>
+ If the <filename>nmake</filename> command is not found on your system
+ you probably haven't defined the environment variables required to
+ use that tool. To fix that, find and run the batch file
+ <filename>vcvars32.bat</filename>. You need to run it from within
+ the command prompt or set the environment variables "globally";
+ otherwise it doesn't work.
+ </para>
+ </tip>
+ <para>
+ If you wish to recompile YAZ++ - for example if you modify
+ settings in the <filename>makefile</filename> you can delete
+ object files, etc by running.
+ <screen>
+ nmake clean
+ </screen>
+ </para>
+ <para>
+ The following files are generated upon successful compilation:
+
+ <variablelist>
+ <varlistentry><term><filename>bin/yazpp5.dll</filename></term>
+ <listitem><para>
+ YAZ++ DLL . Includes ZOOM C++ as well.
+ For the debug version <filename>lib/yazpp5d.dll</filename>
+ is created instead.
+ </para></listitem></varlistentry>
+
+ <varlistentry><term><filename>lib/yazpp5.lib</filename></term>
+ <listitem><para>
+ Import library for <filename>yazpp5.dll</filename>.
+ For the debug version <filename>lib/yazpp5d.lib</filename>
+ is created instead.
+ </para></listitem></varlistentry>
+
+ <varlistentry><term><filename>bin/yaz-my-client.exe</filename></term>
+ <listitem><para>
+ Z39.50 client demonstrating the YAZ++ API.
+ </para></listitem></varlistentry>
+
+ <varlistentry><term><filename>bin/yaz-my-server.exe</filename></term>
+ <listitem><para>
+ Z39.50 server demonstrating the YAZ++ API.
+ </para></listitem></varlistentry>
+
+ <varlistentry><term><filename>bin/zclient.exe</filename></term>
+ <listitem><para>
+ ZOOM C++ demo client. A simple WIN32 console application.
+ </para></listitem></varlistentry>
+
+ </variablelist>
+
+ </para>
+
+ </section>
</chapter>
<!-- Keep this comment at the end of the file
Local variables:
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
- sgml-parent-document: "yaz++.xml"
+ sgml-parent-document: "yazpp.xml"
sgml-local-catalogs: nil
sgml-namecase-general:t
End: