X-Git-Url: http://git.indexdata.com/?a=blobdiff_plain;f=doc%2Fegate.sgml;h=72963b66d0469f53d5c821446813771364f6d2de;hb=373495ef158d123d95ab44465d4249e65847492b;hp=5c3704c2fc38e97f31cdefe1620d3f44a6dd11eb;hpb=1dcb80b009d6e07089380c15b920f3e3b2937799;p=egate.git diff --git a/doc/egate.sgml b/doc/egate.sgml index 5c3704c..72963b6 100644 --- a/doc/egate.sgml +++ b/doc/egate.sgml @@ -1,13 +1,13 @@
Email/Z39.50 gateway guide <author>Europagate, 1995 -<date>$Revision: 1.7 $ +<date>$Revision: 1.9 $ <abstract> This document describes a Email server that provides access to the Z39.50 protocol. @@ -34,11 +34,13 @@ The ES can use either CNIDR's Zdist package or the YAZ package from Index Data to interface the Z39.50 protocol. So you need to obtain one of these first. -The Zdist package can be found in: +The zdist package can be found in: -<url url="ftp://ftp.cnidr.org/pub/NIDR.tools/zdist/zdist102b1-1.tar.Z" > +<htmlurl +url="ftp://ftp.cnidr.org/pub/NIDR.tools/zdist/zdist102b1-1.tar.Z" + name="ftp://ftp.cnidr.org/pub/NIDR.tools/zdist/zdist102b1-1.tar.Z"> -The Zdist package doesn't support result-set references. Also, it has a few +The zdist package doesn't support result-set references. Also, it has a few bugs. Therefore we've included a patch <tt/zdist.patch/ which fixes some of these bugs. Run patch in the directory above <tt/zdist102b1-1/: @@ -47,11 +49,12 @@ $ patch <zdist.patch </verb></tscreen> The ES server only depends on <tt>libz3950.a</tt> so you only need -to build the Zdist software in the directory <tt/libz3950/. +to build the zdist software in the directory <tt/libz3950/. -YAZ can be found in: +YAZ can be found at the FTP host: -<url url="ftp://ftp.algonet.se/pub/index/yaz/">. +<htmlurl url="ftp://ftp.indexdata.dk/index/yaz" + name="ftp://ftp.indexdata.dk/index/yaz"> The ES also use GNU's regex package to parse regular expressions. The ES has been tested with regex-0.12. Some systems, such as Linux, @@ -59,25 +62,26 @@ come with the regex package preinstalled. Unpack <tt>egate.tar.gz</tt> and edit the top level <tt/Makefile/. Specify where the GNU regex package is located and specify whether you use -YAZ or Zdist. One some systems, you may have to set the <tt/NETLIB/ as +YAZ or zdist. One some systems, you may have to set the <tt/NETLIB/ as well. The shell variables <tt/CC/ and <tt/CFLAGS/ are used by the <tt/Makefile/ so you may modify these before compiling. -Now, type <tt/make/. +Now, type <tt/make email/. <sect>Installation <p> -If the compilation succeeds, you should install the software. -Edit the <tt/Makefile/ and set the LIBDIR to the installation +If the compilation succeeds, you should install the software in some +system location. +Edit the <tt/Makefile/ and set EMAILLIBDIR to the installation directory. Since, the ES is executed by the mail system, and not by a user, this directory shouldn't be globally executable. -When satisfied, type <tt/make install/. +When satisfied, type <tt/make install.email/. -Three executables are installed in LIBDIR: +Three executables are installed in EMAILLIBDIR: <descrip> <tag/eti/ The email transport interface. This program receives incoming mail, identifies the user, and delivers the mail request @@ -96,7 +100,7 @@ The <tt/sendmail/ or a similar program delivers the mail to the you create a special user and group for the ES software. In this case you should use <tt/chmod/ to and set the 'set user ID on execution' bits on the executable files and give that user read/write/execute -permissions in LIBDIR. +permissions in EMAILLIBDIR. The mail system needs to know about the ES. Pick some name that serves as the ES user and edit <tt/aliases/ used by your mail system (usually @@ -104,7 +108,7 @@ as the ES user and edit <tt/aliases/ used by your mail system (usually <tt>es:"|/usr/local/lib/es/eti </tt><em>options</em><tt>"</tt> -In this example the mail user name is <tt/es/ and the LIBDIR is +In this example the mail user name is <tt/es/ and the EMAILLIBDIR is <tt>/usr/local/lib/es</tt>. The ES system can operate with or without the monitor. When using