
CNSearch Pro - Simple to Install and Maintain Search System for Web-sites
               with extended capabilities.
                
                E-mail:support@cn-software.com
                http://cn-software.com


 
 Contents of this file:
 
 I. BRIEF OVERVIEW.
 - Features.
 II. INSTALLATION.
 - downloading;
 - Windows installation;
 - UNIX installation;
 - TIPS
 - IMPORTANT NOTES
 III. REGISTRATION
 IV. SUPPORT.
 
 I. BRIEF OVERVIEW.
 
 CNSearch Pro is a search system that works under Windows, UNIX, and
 Linux servers.

 CNSearch Pro is a very convenient solution for those, who runs their 
 web-sites on third-party hosting systems.
 
 The system is composed of two parts - an Indexer and a Frontend. The
 Indexer performs analysis of one or more web-sites according
 to the settings you make. You may select file types to be indexed,
 set index templatesand rules, etc. There are plug-ins included in this
 distribution which may be used for precise analysis of .mp3 .doc, .rtf, 
 and .txt files. The Frontend performs a search in the created index file.
 Special features of the system are possibility of installation of the
 Indexer and Frontend on different computers and fast search in the 
 index file.

 Features:
 - Simple-to-install and use;
 - Supports Linux, FreeBSD, Windows, and Solaris platforms;
 - Indexes files of types: .mp3, .html, .doc, .rtf, .txt;
 - Provides full-text indexing;
 - Povides highlighted quotations in search results;
 - Accumulates statistics on user requests (with an opportunity of password 
   management, date and phrase ranking);
 - Doesn't require any database, only access to '/cgi-bin' directory is 
   required. 

 
 Latest versions are available at http://cn-software.com/
 
 II. INSTALLATION
 
 a) CNSoftware distributes CNSearch Pro as one .zip (for Windows OS) or .tgz 
 (for UNIX-based OS) file.

 The following OS are supported:
 
 Windows 95/98/Me/NT/2000/XP, Linux, FreeBSD, Solaris 7/8(Sparc)

 
 Please, contact your hosting provider, if you do not know which OS your
 web-server is running on.
 
 NOTE: since the two parts (Frontend and Indexer) of CNSearch Pro can work
 independedly on different computers, you may select necessary versions 
 and run them on different operating systems. See below for details.
 
 b) WINDOWS INSTALLATION.
 
 1) - unpack downloaded zip-archive with pkunzip supporting long file
 names (pkzip25 or WinZIP). More information about archivers may be
 found at http://www.pkware.com/ or see NOTE 3 below:
 
	pkzip25 -extract -dir cnsearch_pro-VERSION-windows.zip
 
 2) - go to 'cnsearch_pro-VERSION-windows' directory, where you'll find 
 three directories and two files 'readme.txt', 'License.txt', and
 'index_example.htm':

  manual            - contains Manual pages
  windows           - contains Windows version
  index_example.htm - example HTML file containing search form code
  License.txt       - license notes
  readme.txt        - this file


 
 3) - go to 'windows/indexer' directory and run 'searchctl.exe' with
 necessary params (see section 'Setting Up the Indexer' of the Manual
 for details).

 For example:
 
        searchctl.exe localhost
 
 will build index files of your local web-server documents.
 You will also get some new files: 
 
        docs.cns
        files.cns
        index.cns
        fulltxt.cns
        stats.log
         
 Copy them to 'cgi-bin' directory of your web-site and make sure you
 set read/write permissions for them. The server must be able to change
 these files.
 
 4) - go to 'windows/frontend' directory and copy two files 'search.exe'
 and 'search.htm' to 'cgi-bin' directory of your web-site.
 
 5) Now, you may check how it is working. Start your browser and 
 (assuming that we are searching at localhost) enter
 http://localhost/cgi-bin/search?q=document
 
 You should see a page with search results. See Manual for details how
 include search forms in pages and organize templates.

 6) You may use 'index_example.htm' file found in 'cnsearch-VERSION'
 directory to insert a search form into your web-pages and experiment 
 with its settings.
 
 c) UNIX INSTALLATION

 1) - unpack downloaded tgz-archive:
 
	gunzip cnsearch_pro-VERSION-UNIX.tgz
	tar -xf cnsearch_pro-VERSION-UNIX.tar
	
	
 
 2) - go to 'cnsearch-VERSION-UNIX' directory, where you'll find 
 three directories and two files 'readme.txt', 'License.txt', and
 'index_example.htm':

  manual            - contains Manual pages
  UNIX              - contains UNIX versions
  index_example.htm - example HTML file containing search form code
  License.txt       - license notes
  readme.txt        - this file


 
 3) - go to 'UNIX' directory, where you'll find two
 sub-directories:
 
   frontend          - contains the Frontend
   indexer           - contains the Indexer
   
 
 6) Now, you have to build indexes with the Indexer which
 is stored in 'indexer' directory. Go to 'indexer' directory
 and run 'searchctl' with necessary params (see section 'Setting
 Up the Indexer' of the Manual for details).
 
 For example:
 
 	./searchctl localhost
 
 will build index files of your local web-server documents.
 You will also get some new files: 
 
        docs.cns
        files.cns
        index.cns
        fulltxt.cns
        stats.log
 
 Copy them to 'cgi-bin' directory of your web-site and make sure you
 set read/write permissions for them. The server must be able to change
 these files.
 
 7) - go to 'frontend' directory and copy two files 'search' and
 'search.htm' to 'cgi-bin' directory of your web-site. Don't forget
 to check out for permission for the web-server to run 'search' and read
 'search.htm'
 
 5) Now, you may check how it is working. Start your browser and
 (assuming that we are searching at localhost)
 enter http://localhost/cgi-bin/search?q=document
 
 You should see a page with search results. See Manual for details
 how include search forms in pages and organize templates.
 
 6) You may use 'index_example.htm' file found in 'cnsearch-VERSION'
 directory to insert a search form into your web-pages and experiment 
 with its settings.

 
 TIPS:
 
 Tip 1.
 
 You may view your registration information via link:
 http://site.com/cgi-bin/search?reginfo=1
 
 Tip 2. 
 
 If you want to see statistical information (see Manual), use link:
 http://site.com/cgi-bin/search?stats=1&password=pwd 
 
 IMPORTANT NOTES:

 NOTE 1.

 If your server uses third party hosting, all you need for installation
 is access to 'cgi-bin'.
 
 NOTE 2.

 You  can  also  run the Indexer on Windows machine and the Frontend
 on UNIX and  vice  versa. For example, you have only ftp-access
 to 'cgi-bin' directory at your hosting-provider and your home computer
 runs under MS Windows. 

 On your home computer install the Indexer and perform indexing of your
 web-site. When you finish, you need to copy the Frontend and files 
 created by the Indexer (docs.cns, files.cns, index.cns, fulltxt.cns, 
 stats.log) to your hosting-provider's 'cgi-bin' directory. 

 ATTENTION! Do not forget to set write permissions for these files.

 NOTE 3.

 This product was compressed using the Zip utility from INFOZIP, which 
 can be downloaded from one of the following sites: 

    * ftp.leo.org/pub/comp/general/utils/infozip/index.html
    * www.ctan.org/tex-archive/tools/zip/info-zip/
    * sunsite.org.uk/Mirrors/ftp.freesoftware.com/pub/infozip/


 III. REGISTRATION
 
 According to the License Agreement (see License.txt) you must register 
 your version of CNSearch Pro within the period of 40 days or less. 
 Otherwise you must stop using the product.
 
 To register your software, please visit www.cn-software.com and order
 your Registration Code. 
 
 When the Registration Code is delivered to you, you have to insert it 
 in the search template (file 'search.htm'). See "Registration" 
 section of the Manual for more details.
 
 IV. SUPPROT.

 Technical support is available at  http://cn-software.com or via 
 e-mail: support@cn-software.com
