Instructions for installing the url directory search engine
--------------------------------------------------------------------------------

Welcome to the world of URL directories! Soon, you will be able to
provide your users with your very own URL directory, just like our own
"AceSearch" directory.  Your users will be able to search your database
using your search engine.  Also, your database will grow as users add
their URLs to your database.  This will be YOUR directory; what you name
it will be up to you!



Follow the few, simple steps below to get your directory up and running...


Note:  This program was written for UNIX platforms.  This program is
       freeware, and may be freely distributed.  SPAK Dynamics or
       Absolute Dimension Software  shall not be liable in any event
       for incidental or consequential damages in connection with the
       use of this program.  As a "payment" for this script, a link to
       our site was included within the scripy.  You may modify this if you
       wish, but please consider leaving it in.





add_url.pl
---------------


This file allows users to add their URLs to your URL database.  Open
this file in a text editor and modify the first five parameters:


           #! /usr/bin/perl

	This line is located at the top of the file.  Be sure to replace it with
	the location where the perl library is located on your server (do not
	remove the #! charactors).  If you do not know the location, check
	with the server administrator, or try typing this command while logged
	onto the server:

	which perl

           	If the system can find it, it will tell you the path.






           $dbase ='/your_server_directory/your_cgi_directory/url_base.txt'; 

	Change the path between the single quotes to the directory where
                   you will place the database file url_base.txt.  Note that this is not a 
                   WWW address; it is a path on your server. 


           $mail_to='your_e-mail_address';
	
	Change the e-mail address between the single quotes to that of your
	own e-mail address.


           $return_url='http://www.your_main-page_url';

	Change the WWW URL between the single quotes to that of your
	main page. 


          $background_color="#FFFFE6";

	The color of the output page is set at a very light yellow.  If you wish to
	change this background color, then replace the color code between
	the single quotes to that of the desired color.



After the changes are completed, upload this file to your server.  
IMPORTANT:  BE SURE TO USE TRANSFER TYPE = ASCII !!!

You may want to check with your server before you upload; servers
often have different requirements concerning perl programs.  Some
may allow the .pl extension, while others may have you change the
file extension to .cgi.  Also, there may be a cgi-bin directory provided
for you; other servers may tell you to create a local cgi subdirectory
(such as /cgi-local/). 


Once the file is uploaded, set the permissions of the file to readable
and executable.  To do this from the UNIX command line, use the
command:

	chmod 755 add_url.pl

of, if you changed the extension to .cgi:

	chmod 755 add_url.cgi


Alternatively, you may be able to set permissions via FTP.  If you have this
option, simply set the file attribute to 755.




url_find.pl
--------------

This is the actual search engine program. Open this file in a text editor and 
modify the first six parameters:


           #! /usr/bin/perl

	This line is located at the top of the file.  Be sure to replace it with
	the location where the perl library is located on your server (do not
	remove the #! charactors).  If you do not know the location, check
	with the server administrator.


           $dbase ='/your_server_directory/your_cgi_directory/url_base.txt'; 

	Change the path between the single quotes to the directory where
                   you will place the database file url_base.txt.  Note that this is not a 
                   WWW address; it is a path on your server. 


           $mail_to='your_e-mail_address';
	
	Change the e-mail address between the single quotes to that of your
	own e-mail address.



           $return_url='http://www.your_main-page_url';

	Change the WWW URL between the single quotes to that of your
	main page. 



           $title='AceSearch';

	Replace the name 'AceSearch'  between the single quotes with the name
	you gave to your search engine.


          $background_color="#FFFFE6";

	The color of the output page is set at a very light yellow.  If you wish to
	change this background color, then replace the color code between
	the single quotes to that of the desired color.



After the changes are completed, upload this file to your server.  
IMPORTANT:  BE SURE TO USE TRANSFER TYPE = ASCII !!!

You may want to check with your server before you upload; servers
often have different requirements concerning perl programs.  Some
may allow the .pl extension, while others may have you change the
file extension to .cgi.  Also, there may be a cgi-bin directory provided
for you; other servers may tell you to create a local cgi subdirectory
(such as /cgi-local/). 


Once the file is uploaded, set the permissions of the file to readable
and executable.  To do this from the UNIX command line, use the
command:

	chmod 755 url_find.pl

of, if you changed the extension to .cgi:

	chmod 755 url_find.cgi


Alternatively, you may be able to set permissions via FTP.  If you have this
option, simply set the file attribute to 755.



url_base.txt
-----------------

This is the actual database file.  In order to "prime" your directory listings,
a record for each category has been provided; there is nothing worse than
an empty database!  

Simply upload this file to your server.  
IMPORTANT:  BE SURE TO USE TRANSFER TYPE = ASCII !!!

Once the file is uploaded, set the permissions of the file to readable,
writable, and executable.  To do this from the UNIX command line, use the
command:

	chmod 777 url_base.txt

Alternatively, you may be able to set permissions via FTP.  If you have this
option, simply set the file attribute to 777.





Search.htm
----------------

This is the html document with the search forms. Be sure to change the line:

<form action="http://www.your_url/your_cgi_directory/url_find.pl" method="POST">

on BOTH forms!!

These forms are, by design, basic looking.  Feel free to spruce them up before 
you upload it to your server.



add_url.htm
-----------------

This is the html document with the add url form. Be sure to change the line:

<form action="http://www.your_url/your_cgi_directory/add_url.pl" method="POST">



This form is, by design, a basic looking form.  Feel free to spruce it up before 
you upload it to your server.













