README-SWISH-E
上传用户:qin5330
上传日期:2007-01-05
资源大小:114k
文件大小:4k
源码类别:

搜索引擎

开发平台:

Perl

  1. THE SWISH-E README 
  2.  
  3. SYSTEM REQUIREMENTS
  4. SWISH-E is written in C, and, up to this time, it has been tested on
  5. Solaris 2.5.1 and Dec Alpha 3.2 in house and by users on BSDI 2.0.  To
  6. compile, a C compiler is needed. Pretty much any standard compiler
  7. should do, the ones we used are: gcc version 2.7.0 and ucbb SC3.0.1.
  8. The HTTP file access method uses a Perl helper script that requires
  9. the LWP,HTTP,HTML modules(Note: depending on your perl installation, you might need to
  10. install additional modules required by LWP; for requirements and
  11. downloads check http://www.cpan.org or http://theory.uwinnipeg.ca/search/cpan-search.html).
  12. It was tested with Perl 5.005 although should probably work with any version 5 release.
  13. A tip from Wil Vree about compiling with a Sun C compiler:
  14. In the Makefile the following two opions need to be modified
  15. CC = /opt/SUNWspro/bin/cc
  16. CFLAGS= -xO2
  17.  
  18. INSTALLATION
  19. Downloading the C files and recompiling the executable
  20. ------------------------------------------------------
  21. 1) Create a directory where to keep the source code files, for
  22.         example /opt/swish-e.x
  23.         %mkdir /opt/swish-e.x
  24. 2) Download the swish-efiles.x.x.tar.gz into the directory, uncompress and
  25.          untar it
  26.          % gunzip swish-efiles.x.x.tar.gz
  27.          %tar -xvf swish-efiles.x.x.tar
  28.  
  29.          The command should create the following directory and files:
  30.       src/
  31. Makefile        file.h          list.c          string.h
  32. README-SWISH-E  fs.c            list.h          swish.c
  33. user.config     hash.c          mem.c           swish.h
  34. check.c         hash.h          mem.h           swishspider
  35. check.h         http.c          merge.c         swishspider.pl
  36. config.h        http.h          merge.h         test.html
  37. docprop.c       httpserver.c    search.c        /win32
  38. docprop.h       httpserver.h    search.h        
  39. error.c         index.c         stemmer.c
  40. error.h         index.h         stemmer.h
  41. file.c          index.swish     string.c
  42. 3) In the Makefile change the path for the C compiler
  43.           Change
  44.           CC = /usr/local/bin/gcc
  45.           to
  46.           CC = {PATH}/gcc
  47.  
  48.           as stated in the SYSTEM REQUIREMENTS section, you do not need to
  49.           necessarily use gcc to compile.
  50.  
  51. 4) Make any needed changes in the config.h to customize swish-e to
  52.           your site.
  53. 5) Compile the swish-e executable from the src/ directory
  54.           %cd src 
  55.           %make
  56.  
  57. 6) Run a quick test to make sure that the executable is working
  58.           correctly.
  59.  
  60.            %make test
  61.  
  62.            If the test is successful, you should see the
  63.            following:
  64.         sunsite% make test
  65.         ./swish-e -i test.html -v -f index.swish
  66.  
  67.         Checking file "test.html"...
  68.         test.html (41 words)
  69.  
  70.         Removing very common words... no words removed.
  71.         Writing main index... 25 unique words indexed.
  72.         Writing file index... 1 file indexed.
  73.         Running time: Less than a second.
  74.         Indexing done!
  75.         ./swish-e -f index.swish -w test
  76.         # SWISH format 1.x
  77.         # Search words: test
  78.         # Name: (no name)
  79.         # Saved as: index.swish
  80.         # Counts: 25 words, 1 files
  81.         # Indexed on: 13/08/97 10:40:54 PDT
  82.         # Description: (no description)
  83.         # Pointer: (no pointer)
  84.         # Maintained by: (no maintainer)
  85.         1000 test.html "If you are seeing this, the test was successful!" 358
  86.         .
  87. 7) Move the swish-e executable to /usr/local/bin 
  88.  
  89. 8) For instructions about how to index and search with swish-e check
  90.          the Quick Start (http://sunsite.berkeley.edu/SWISH-E/Manual/quickstart.html)
  91. 9) The user.config file provided in the distribution is set for use with the FILESYSTEM.
  92.    If you are using HTTP, comment out the directory of FILESYSTEM ONLY and set the ones for
  93.    HTTP ONLY.
  94. QUESTIONS AND TROUBLESHOOTING
  95. If you run in any problem during installation, or if you have any
  96. question about swish-e use and features, let us know through our
  97. discussion group(http://sunsite.berkeley.edu/SWISH-E/Discussion
  98.  
  99.  
  100. Giulia Hill
  101. Library System Office
  102. UC Berkeley Libraries
  103. ghill@library.berkeley.edu
  104.  
  105. 8/13/97
  106. Last updated 12/10/98
  107.