home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Spezial / SPEZIAL2_97.zip / SPEZIAL2_97.iso / ANWEND / ONLINE / SREFV12J / READ.ME < prev    next >
Text File  |  1997-07-26  |  9KB  |  209 lines
  1. 11 Jul 1997.  Notes on the SRE-FILTER 1.2j WWW server
  2.  
  3. SRE-FILTER is a "filter" for the free, GoServe IBM EWS Internet Server.
  4. It is designed to work with OS/2 Warp (3 or 4), and with
  5. GoServe 2.45+. It will work under  OS/2 2.11, but it uses the Warp
  6. version of the REXXUTIL library (which contains some routines not in the
  7. OS/2 2.1x version). In other words:
  8.     If you use GoServe under OS/2 2.11, or with earlier versions
  9.     of GoServe (prior to 2.45),you might have sporadic problems!
  10.  
  11. Cautions: 
  12.    * if you are using OS/2 Warp Server; you may need to install
  13.          the latest fix packs
  14.    * If you are using Object Rexx (under OS/2 4.0), you will NOT be 
  15.      able to use SRE-Filter.
  16.  
  17.  
  18. Installation notes:
  19.  
  20. 1) Obtain and install GoServe.
  21. 2) Unzip SREFV12I.ZIP to an empty, temporary directory...
  22.    (you can use UNZIP, a recent copy of which is on the SRE-Filter home page)
  23. 3) Open an os/2 window
  24. 4) CD to this temporary directory
  25. 5) Run INSTALL.CMD.  You will be asked for a variety of
  26.    directories.    You will also be asked for your IP address
  27.    (it's optional). Furthermore, you will be given the opportunity to
  28.    set a few parameters -- though you can always modify them later.
  29.  
  30.   If you are reinstallating SRE-FILTER:
  31.  
  32.      INSTALL will ask if you want to archive the (potentially) user-
  33.      configurable files.  We recommend selecting this option.
  34.  
  35.      If INSTALL detects a pre-existing file, it will ask you if
  36.      you want to overwrite it.  For some "configuration" files
  37.      if will ask you twice!
  38.  
  39.  
  40. 6) Change your default filter (in GoServe) to be SREFILTR.80
  41.    Alternatively, the SREFQUIK.80 or SREFAST.80 "simple-filter front-ends"
  42.    can often be used (with some extra configuration) to improve performance.
  43.  
  44. 7) After INSTALL is done, and assuming you were able to choose the defaults,
  45.    point your browser at http://your.server.whereever/index.htm
  46.    This SRE-Filter home page contains a number of useful links
  47.    to documentation, demos, and configuration tools. Of particular
  48.    interest is the users-guide, and the configurator.
  49.  
  50.    The users guide (GUIDE.HTM) outlines the capabilites of SRE-Filter, and
  51.    points to further help.  It's a good place to start ...
  52.  
  53.    The configurator (which can also be accessed via
  54.           http://your.server.whereever/CONFIGUR.HTM)
  55.    has three modes: simple, intermediate, and expert.
  56.    New users will probably be most comfortable with the simple mode.
  57.  
  58.  
  59. Notes:
  60.  
  61.   *  For the latest version of SRE-Filter, demos, and add-ons --
  62.      visit the SRE-Filter home page at http://rpbcam.econ.ag.gov/srefilter
  63.  
  64.   *  You can get the latest copy of GoServe (currently 2.50) from:
  65.          http://www2.hursley.ibm.com/goserve/
  66.  
  67.   *  If GoServe won't let you in (because it can't find a filter), you can
  68.      add "FILTER SREFILTR.80 " (without the quotes) to the
  69.      GoServe WPS object (the icon's) "parameters" option.
  70.  
  71.   *  SRE-Filter ver 1.2j will NOT run under Object Rexx.  There
  72.      is a (now aging) version of ver 1.2g that will run under Object Rexx
  73.      (see the SRE-Filter home page for details).
  74.  
  75.   *  If you have relatively simple demands, the simple mode configurator
  76.      may be adequate for all your needs. Conversely, if you want to
  77.      optimize SRE-Filter's performance, you will probably want to
  78.      use the intermediate, or expert, mode. If you decide to use
  79.      SREFAST, you can use the SREFAST.HTM configurator.
  80.  
  81.   *  INTRO.DOC contains a 1 page summary of SRE-Filter's capabilites.
  82.  
  83.   *  Upgraders from prior versions of SRE-Filter should read CHANGES.DOC
  84.      In particular, you should note that an ADDON_DIR has been
  85.      added as of ver 1.2j (which might require updating earlier
  86.      versions of SRE-Filter addons).
  87.      .
  88.   *  SREFILTR.FAQ contains answers to some frequently asked questions.
  89.  
  90.   *  The SRE-Filter "web-accessible manual" is SREFILTR.HTM.
  91.  
  92.   *  For optimization hints, and a complete description of the user
  93.      configurable parameters, see INITFILT.DOC
  94.  
  95.   *  The various .IN and .CTL files that come with SRE-FILTER contain
  96.      descriptons, and examples, of how to set up these "username,
  97.      URL access control, etc." files.
  98.  
  99.   *  SRE-FILTER uses "OS/2 macro space" to store frequently
  100.      used routines, and uses queues and semaphores for inter-thread
  101.      communication.  To do this, the REXXLIB  library is used.
  102.      Although you have free rights to use REXXLIB with SRE-FILTER,
  103.      if you intend to use REXXLIB for something other then SRE-FILTER,
  104.      you should obtain the REXXLIB package  from
  105.      http://www.quercus-sys.com/rexxlib.htm.
  106.  
  107.   *  Several of the functions used by GoServe requires RxSock.DLL --
  108.      the Rexx Sockets Support library.  It should be in your LIBPATH
  109.      (it is usually in your \TCPIP\DLL directory).
  110.  
  111.   *  Several of SRE-Filter's facilities (i.e.; GETAFILE and !DIR) use
  112.      Info-Zip's UNZIPAPI.DLL dynamic link library. It's free GNU-ware,
  113.      available from hobbes.nmsu.edu.
  114.  
  115.   *  Several of SRE-Filter's facilities (i.e.; the send as output mode
  116.      of CGI-BIN scripts, and the goaudit.80 file reader in the NUSTATUS
  117.      addon) use the FILEREXX.DLL dynamic link library.  It's freely
  118.      distributed software, available from hobbes.nmsu.edu (as FILEREXX.ZIP).
  119.  
  120. Acknowledgements:
  121.  
  122.  > Steve Ryckman provided great help: good suggestions, bug finds,
  123.    and hosting the partial mirror site.
  124.  
  125.  > Don Meyer, author of the GoHTTP filter, was very gracious
  126.    in allowing me to "build on his work".  In particular,
  127.    much of the source code for HTACCESS file access-controls,
  128.    CGI-BIN script processing,  and image map processing was adapted
  129.    from his code.
  130.  
  131.  > Derek Sims (author of the IntrFilt filter) for helpful advice
  132.    regarding multi-host servers.
  133.  
  134.  > Charles Daney for providing the REXXLIB library at a very reasonable
  135.    price.
  136.  
  137.  > Dave Briccetti for providing the "SMTP using socket calls" code.
  138.  
  139.  > Ariel L. Szczupak for advice on working with queues and semaphores.
  140.  
  141.  > Richard Hughes for useful thoughts on discussion group software
  142.  
  143.  > The people at the INFO-ZIP project, for providing the UNZIPAPI
  144.    dynamic link library.
  145.  
  146.  > the several early adopters (may they rest in peace) for their
  147.    patience in dealing with stupid bugs
  148.  
  149.  > several individuals (mm, dr,  et al) for good suggestions that
  150.    are now realities
  151.  
  152.  > .... and (of course) Mike Cowlishaw for creating GoServe, and always
  153.    finding time to try and answer.
  154.  
  155.  
  156.  
  157. Questions? Contact Daniel Hellerstein : DANIELH@ECON.AG.GOV
  158.  
  159.  
  160.                         ------------------------------
  161.  
  162. Basic copyright and it's never our fault disclaimer:
  163.  
  164.   Copyright 1996,1997 by Daniel Hellerstein. Permission to use this program
  165.   for any purpose is hereby granted without fee, provided that
  166.   the author's name not be used in advertising or publicity
  167.   pertaining to distribution of the software without specific written
  168.   prior permision.
  169.   With some proviso, this includes the right to subset and reuse the code,
  170.   with proper attribution  The provisos are  several fold:
  171.    1)  Portions of the code are adapted from other authors' work
  172.        (these are noted where appropriate); you'll need to contact these other
  173.        authors for appropriate permissions.
  174.    2)  SRE-Filter uses Quercus System's REXXLIB procedure library.  The
  175.        license for REXXLIB gives the author the right to distribute REXXLIB
  176.        without charge.  This right may NOT extend to redistributors.
  177.        Please contact Quercus Systems for details.
  178.        SRE-Filter also uses Info-Zip's UNZIPAPI.  Although this is freely
  179.        available software, you may wish to contact Info-Zip for details.
  180.        Similarly, SRE-Filter uses Jeff Glatt's FILEREXX (a 1995 address
  181.        is 6 Sycamore Drive East, New Hartford, NY 13413, 315-735-5350).
  182.   3)  We, the authors of SRE-Filter and any potentially affiliated institutions,
  183.       disclaim any and all liability for damages due to the use, misuse, or
  184.       failure of the product or subsets of the product.
  185.  
  186.   Furthermore you may also charge a reasonable re-distribution fee for
  187.   SRE-Filter; with the understanding that this does not remove the
  188.   work from the public domain and that the above provisos remain in effect.
  189.  
  190.     THIS SOFTWARE PACKAGE IS PROVIDED "AS IS" WITHOUT EXPRESS
  191.     OR IMPLIED WARRANTY.
  192.     THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE PACKAGE,
  193.     INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS.
  194.     IN NO  EVENT SHALL THE AUTHOR (Daniel Hellerstein) OR ANY PERSON OR
  195.     INSTITUTION ASSOCIATED WITH THIS PRODUCT BE LIABLE FOR ANY
  196.     SPECIAL,INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER
  197.     RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION
  198.     OF CONTRACT,NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR
  199.     IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE PACKAGE.
  200.  
  201.  
  202.    SRE-FILTER was developed on the personal time of Daniel Hellerstein,
  203.    and is not supported, approved, or in any way an official product
  204.    of my employer (USDA/ERS).
  205.  
  206.  
  207.  
  208.  
  209.