-<!doctype linuxdoc system>
-
-<!--
- $Id: egate.sgml,v 1.11 1996/08/09 15:42:12 adam Exp $
+ <!doctype linuxdoc system>
+
+<!--
+ $Id: egate.sgml,v 1.14 2001/02/26 14:32:36 adam Exp $
-->
<article>
-<title>Email/Z39.50 gateway guide
+<title>Email - Z39.50 gateway guide
<author>Europagate, 1996 <htmlurl url="http://europagate.dtv.dk"
name="http://europagate.dtv.dk">
-<date>$Revision: 1.11 $
+<date>$Revision: 1.14 $
<abstract>
This document describes a Email server that provides access to the
Z39.50 protocol.
deviations from the design. Also, the second part contains
a quick overview of the source code.
-The software distribution also includes a Web to Z39.50 gateway. Refer
-to the web.txt documentation about installation on this gateway.
-
<sect>Installation
<p>
The zdist package can be found in:
<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">
+url="ftp://ftp.cnidr.org/pub/NIDR.tools/zdist/archive/1.02/zdist102b1-1.tar.Z"
+name="ftp://ftp.cnidr.org/pub/NIDR.tools/zdist/archive/1.02/zdist102b1-1.tar.Z">
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
YAZ can be found at the FTP host:
-<htmlurl url="ftp://ftp.indexdata.dk/index/yaz"
- name="ftp://ftp.indexdata.dk/index/yaz">
+<htmlurl url="ftp://ftp.indexdata.dk/pub/yaz/"
+ name="ftp://ftp.indexdata.dk/pub/yaz/">
The ES also uses GNU's regex package to parse regular expressions.
The ES has been tested with regex-0.12. Some systems, such as Linux,
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 by setting the variables <tt/REGEXOBJ/
-and <tt/REGXINC/.
+Unpack <tt>email-z39-...tar.gz</tt> and edit the top level
+<tt/Makefile/. Specify where the GNU regex package is located by
+setting the variables <tt/REGEXOBJ/ and <tt/REGXINC/.
-A little further down the <tt/Makefile/ you find a section called
-<tt/Common settings/ where you specify the location of either YAZ or zdist.
-On some systems, you may have to set the <tt/ELIB/ as well to link with
-BSD socket libraries.
+Some systems need you to add libraries for socket access. In this
+case specify the <tt/ELIB/ variable.
-If you intend only to compile the Email server and not the Web server
-you don't have to worry about the section entitled <tt/WWW gateway settings/.
+The next section of the <tt/Makefile/ you specify the location of your
+Z39.50 library - zdist or YAZ.
The shell variables <tt/CC/ and <tt/CFLAGS/ are used by the
<tt/Makefile/ so you may set these in your shell before you start
compiling.
-Now, type <tt/make email/.
+Now, run <tt/make/.
<p>
If the compilation succeeds, you should install the software in some
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.email/.
+When satisfied, type <tt/make install/.
Three executables are installed in EMAILLIBDIR:
<descrip>
as the ES user and edit <tt/aliases/ used by your mail system (usually
<tt>usr/lib/aliases</tt>). Now add the following line:
-<tt>es:"|/usr/local/lib/es/eti </tt><em>options</em><tt>"</tt>
+<tt>es:"|/usr/local/lib/emailgw/eti </tt><em>options</em><tt>"</tt>
In this example the mail user name is <tt/es/ and the EMAILLIBDIR is
-<tt>/usr/local/lib/es</tt>.
+<tt>/usr/local/lib/emailgw</tt>.
The ES system can operate with or without the monitor. When using
the monitor the number of simultanous running kernels can be
might be put in a boot script:
<tscreen><verb>
-(cd /usr/local/lib/es; ./monitor -d -l mon.log -- -d -l kernel.log &)
+(cd /usr/local/lib/emailgw; ./monitor -d -l mon.log -- -d -l kernel.log &)
</verb></tscreen>
Here the monitor is started with the options <tt>-d -l mon.log</tt>
the kernel), so the following might be put in the aliases file:
<tscreen><verb>
-es:"|/usr/local/lib/es/eti -c /usr/local/lib/es"
+es:"|/usr/local/lib/emailgw/eti -c /usr/local/lib/emailgw"
</verb></tscreen>
The eti sets current directory to the path specified by option <tt>-c</tt>.
be put in your aliases file:
<tscreen><verb>
-es:"|/usr/local/lib/es/eti -c /usr/local/lib/es -- -d -l kernel.log"
+es:"|/usr/local/lib/emailgw/eti -c /usr/local/lib/emailgw -- -d -l kernel.log"
</verb></tscreen>
<sect1>eti
During the work with the Zdist package a few bugs were discovered.
Fortunately, they could be solved within a few days. We also
discovered that the package lacks result-set references.
-We posted the bug fixes to Kevin Gamiel who is responsible for
-the package but we didn't get responses. So, eventually, we weren't
-satisfied with the package after all.
In February some of us began the development of a new Z39.50 package
called YAZ — in retrospect somewhat motivated by the