Go to the first, previous, next, last chapter, table of contents.

2 Requirements and Related Stuff

. .

To run SFgate you need the following pieces of software:

SFgate, the freeWAIS-sf distribution and the Wais Perl module are available per ftp. Please check archie to find a mirror site near to you.

The load on our server is growing out of bounds. We had to close it for the public -- for the big files at least. Since all Packets are routed over the EUnet site, it will be faster to get the stuff from there as from ls6-www (`ftp://ftp.germany.eu.net/pub/infosystems/wais/Unido-LS6/').

If you want to download freeWAIS-sf, SFgate or the Perl Wais module be sure to get the latest patchlevel (indicated by the last number in the revision number).

2.1 HTTP Server

. . . . .

First of all, you need a HTTP server. SFgate is tested with CERN HTTPD and NCSA HTTPD. If you use another HTTP server you should consider that it implements the CGI specification as SFgate uses the CGI environement variables PATH_INFO, QUERY_STRING and REQUEST_METHOD.

2.2 Perl

.

SFgate is written in Perl, so the next thing you need is a perl interpreter, version 5.002 or higher. Take a look at CPAN (Comprehensive Perl Archive Network) for the sources:

(`http://www.perl.com/CPAN/').

2.3 freeWAIS-sf

.

Although SFgate can connect to every freeWAIS server, it is best suited for use with the freeWAIS-sf (see section `Overview' in The freeWAIS-sf Manual) distribution and its extensions. Get freeWAIS-sf 2.0:

`ftp://ftp.germany.eu.net/pub/infosystems/wais/Unido-LS6/freeWAIS-sf/'

Beside for offering own databases the freeWAIS-sf libraries are needed for linking with the Wais.pm module (see section 2.4 The Perl Module Wais.pm). So just compile them and do not remove the freeWAIS-sf source tree until you didn't link Wais.pm.

2.4 The Perl Module Wais.pm

. . .

The Perl module Wais provides access to the freeWAIS-sf libraries. It encapsulates the WAIS protocol and for local databases even the WAIS server. SFgate relies on Wais.pm so before installing SFgate you must install Wais.pm.

Having Perl 5.002 or higher and freeWAIS-sf 2.0 installed it is really easy to install Wais. Look at the included documentation.

Obtain Wais from CPAN (Comprehensive Perl Archive Network):

(`http://www.perl.com/CPAN/authors/id/ULPFR/').

2.5 SFgate

.

That's this WWW gateway to WAIS! Get SFgate 5.1:

`ftp://ftp.germany.eu.net/pub/infosystems/wais/Unido-LS6/SFgate/'

2.6 SFproxy

. .

SFproxy (see section `Overview' in The SFproxy Manual) is an indexing HTTP proxy. You can configure it that it watches all your HTTP requests. If a document of content type text/html is sent as response, that document is indexed under the URL given in the request using freeWAIS-sf. This way you get a better hotlist because you can search it.

Another mode of operation is that you feed SFproxy with a list of URLs (e.g. the URLs in your history file). SFproxy then fetches the documents and processes them as described above.

SFproxy comes with SFgate (inclusive its own manual).

2.7 Further Documentation

. . . . . . . .

The SFgate Welcome Page
`http://ls6-www.informatik.uni-dortmund.de/ir/projects/SFgate/'
This Manual
is included in the SFgate distribution in texinfo/postscript/dvi/html format. A standalone postscript version is also available (`ftp://ftp.germany.eu.net/pub/infosystems/wais/Unido-LS6/SFgate/SFgate.ps.gz'). A HTML version is available at `http://ls6-www.informatik.uni-dortmund.de/ir/projects/SFgate/SFgate.html'.
The Manual of freeWAIS-sf (see section `Overview' in The freeWAIS-sf Manual)
The Manual of SFproxy (see section `Overview' in The SFproxy Manual)
is included in the SFgate distribution in texinfo/postscript/dvi/html format. A standalone postscript version is also available (`ftp://ftp.germany.eu.net/pub/infosystems/wais/Unido-LS6/SFgate/'). A HTML version is available at
`http://ls6-www.informatik.uni-dortmund.de/ir/projects/SFgate/SFproxy.html'.
The freeWAIS-sf Frequently Asked Questions
`ftp://ftp.germany.eu.net/pub/infosystems/wais/Unido-LS6/freeWAIS-sf-faq'
Mailinglist `wais@wsct.wsc.com'
There's a mailinglist for freeWAIS-sf and SFgate: Messages to
`wais@wsct.wsc.com' will be forwarded to the subscribers. To get on the list send a mail to `majordomo@wsct.wsc.com':
To: majordomo@wsct.wsc.com

subscribe wais
To leave the mailing-list send the same mail, but replace subscribe with unsubscribe. Please note that e-mail should be sent to `wais@wsct.wsc.com', not to `wais@wsc.com'!
Newsgroup
See the discussion of WAIS related topics in the newsgroup `comp.infosystems.wais'. There's an archiv of this newsgroup:
`http://ls6-www.informatik.uni-dortmund.de/ir/search/ciw.html'.
3rd International WWW Conference '95
Ulrich Pfeifer, Norbert Fuhr and Tung Huynh, Searching Structured Documents with the Enhanced Retrieval Functionality of freeWAIS-sf and SFgate:
`http://www.igd.fhg.de/www/www95/proceedings/papers/47/fwsf/fwsf.html'
(Alternativly you can look up this paper in the Computer Networks and ISDN Systems journal 27 (6), 1995.)
freeWAIS-sf 2.x & SFgate 5.x User Manual with Figure and Live Examples
from Leopoldo Saggin (`lsaggin@civ.bio.unipd.it'):
`http://www-fog.bio.unipd.it/waishelp/waishlp.html'.

Go to the first, previous, next, last chapter, table of contents.
SFgate 5.111