10 May 2004. GoSWISH/2 ver 1.96 GoSWISH/2: A Search Engine Utility For OS/2 Abstract: GoSWISH/2 is a free search engine that runs under the SREhttp/2 OS/2 Web Server. GoSWISH/2 uses the SWISH "web indexer" to create and search for words in web documents. GOSWISH/2 is optimized to work on multi-host sites. -------------------------- 1. Introduction The Simple Web Indexing System for Humans (SWISH) is a fast (and free) multi-platform program for generating & searching indices of the contents of a set of files. SWISH is designed to be used as "keyword search" tool, and will return that output can be incorporated into WWW output. SWISH does the hard part of indexing (extracting words from selected documents and organizing them in compact fashion), and of searching this index for specified keywords. Although not terribly difficult to use, it is a bit idiosyncratic. By providing a simple, web-based interface to SWISH, GoSwish/2 can help the typical (i.e.; lazy and/or overworked) web administrator use SWISH to keep his search tools up-to-date and easy-to-use. In addition, GoSwish/2 makes it easy to create, and display, descriptions of the files that are found during a keyword search! To use GoSwish/2 you must be running the SREhttp/2 OS/2 web server (see http://srehttp2.srehttp.org for details). GOSWISH/2 is designed to be used by a web site administrator, someone who has privileges for all the hosts supported by an http server. In addition, GOSWISH/2 makes it easy to regenerate indices, so that you can easily update your search indices whenever the contents of a web site (or a portion of a web site) changes. 2. Installation a) UNZIP GOSWISH2_190.ZIP to an empty, temporary directory b) Open an OS/2 box, and CD (change directory) to this temporary directory c) From an OS/2 command prompt, run the INSTALL.CMD program d) You'll be asked a few questions 3. Using GOSWISH/2 Assuming that you have * installed GOSWISH/2, * SREhttp/2 is running, * xxx.yyy.zzz is the "canonical" host supported by this server * you have set up a username with SUPERUSER privileges Then ... 1) Fire up your favorite web browser 2) Request http://xxx.yyy.zzz/goswish2/goswish2? 3) You will be then asked to select a "host" -- if you are not supporting multiple hosts, just choose the "Default" host. 4) You can then specify several search options, generate a SWISH index (and possibly a "description index"), and save these options in a a GoSWISH/2 "spec" file. 5) If at some future date, after many files have been added or modified, you can re-run GOSWISH/2 (see step 2 above), and "regenerate" these indices -- just choose the GoSWISH/2 "spec" file you specified in step 4! 4. Notes: * For more information on SWISH, check out http://swish-e.org. For example, a complete (though old) version of SWISH for OS/2 can be found at http://swish-e.org/Ports/OS2/ * A SWISH GIF image: Included with the these files is SWISH-E.GIF -- a nice animated gif you can use to tell the world what's powering your search engine. * Advanced Users Notes ** After installation, you may wish to examine GOSWISH2.CMD -- it has a few user configurable parameters. ** For those running GoSWISH/2 on busy servers, you can reduce the priority of the various SWISH and GoSWISH processes by using the EXEC_MODIFIER parameter in GoSWISH2.CMD in conjuction with a priority setting utility -- such as the "SPE" priority setting program. * SWI_HTML.CMD is a standalone utility that searches a Swish Index, generates an HTML output file, and fires up a web browser to look this output file. * Files installed to the GOSWISH2 "addon" directory: GOSWISH2.CMD - the SREhttp/2 addon SWISH-E.EXE - the SWISH program INC1.HTM and INC2.HTM - files used by GOSWISH2.CMD SWISH-E.GIF - a SWISH image! SWI_HTML.CMD - a standalone utility that searches a Swish Index, generates an HTML output file, and fires up a web browser to view the results. DESCRIBE.TXT - a sample "description file" READ.ME - this document