mySearch V1.0

Last modified on Wednesday, October 16, 2002

mySearch is completely open source and may be freely distributed without charge. It was designed to be easily installed and configured on any system and supports perl. By following the simple instructions below you will have your own customizable search engine in a matter of minutes. If you encounter problems or have comments, please contact support@searchcluster.com

INSTALLATION:

1.  DOWNLOAD THE SCRIPT

Most likely if you are viewing this installation file you have already successfully downloaded your version of MySearch. If for whatever reason you need re-download the script, you may do so at http://www.searchcluster.com/mysearch/

Download the appropriate version

Widows
http://www.searchcluster.com/mysearch/mysearch.zip

Unix / Linux
http://www.searchcluster.com/mysearch/mysearch.tar.gz

All Current Versions 
http://www.searchcluster.com/mysearch/

2.  DECOMPRESS FILES

Unzip your mySearch script using your unzip program and to retain the directory structure.  After you have unzipped your files, follow the instructions located in the install.htm file 

The .tar.gz version can be decompressed with the unix command:

tar -fxz fdse.beta.tar.gz

The .zip version can be decompressed with any .zip compatible utility.

Click here to view a visual of the directory structure and permissions.

3.  PATH TO PERL

The current path to PERL is set to: 

#!/usr/bin/perl

and should work with most systems.  You may need to change this line at the beginning of  the search.cgi (search.pl if you had to rename it) file in order for this script to work. Again, consult with your system administrator for the correct path information.

4.  CUSTOMIZE YOUR SCRIPT

You can customize the look and feel of your script by customizing the template files provided with the script.  These files are:

index.htm - sample index file. 

cgi-bin/header.htm  - header for your search results page. 

cgi-bin/sidebar.htm  - sidebar for your search results page. 

The current setup keeps all paths local and are not absolute.  This makes it easy to update or move your script it the future.  Keep this in mind when modifying or updating the htm template files.

5.  TRANSFER YOUR FILES

Transfer your files to your web sever into your directory of choice. In many cases, you can upload it to your root directory. The index.htm file will be your homepage and your CGI-BIN will contain your search.cgi script and template files.

The most common ways to transfer your files is via FTP. You should be able to use any ftp client.

Be sure to upload your files using ASCII file transfer method. Otherwise, you scripts will contain binary coding and will not function.

6.  SET FILE PERMISSIONS

Below is a visual of the directory structure, files and permissions required by the script. The script will not function and may generate at "Internal Server Error" unless the proper permissions are set. Please follow the following to ensure the directory structure and permissions are properly set.

Directory Structure

Permissions Folder / File	Description 
755 / r-x index.htm		Sample search and director file. 
755 / r-x cgi-bin			The main directory that contains the search script. 
755 / r-x header.htm		Header template that you should customize to match your site. 
755 / r-x sidebar.htm		Sidebar template that you should customize to match your site. 
755 / r-x search.cgi		The CGI script that makes it all work. Check the PERL path. 

8.  TEST YOUR SCRIPT

Visit http://www.yoursite.com/yourdirectory/index.htm to test your script. Perform a search and click on the links provided. Your site should now generate search results.  

If you encounter problems be sure to double check your installation process.  If you need additional help or wish to have this script professionally installed, please contact support@searchcluster.com

TO REMOVE THIS SCRIPT

Simply delete the folder that contains this script.   There is nothing else you need to do to uninstall this script.

FREE INSTALLATION

If you need assistance installing this script or would like a completely free installation onto your web server, please contact support@searchstand.com to make arrangements.

DISTRIBUTION

You are free to distribute this script as you see fit. Please keep all links to searchcluster.com in tack.