As SiteSearch uses not just PHP but also Java code, it requires that you have a Java Virtual Machine installed before it can be started. If you do not have a Java VM installed already, one can be obtained from http://java.sun.com/

Next, you should open the server configuration file at inc/app/sitesearch/conf/server.ini.php and make any necessary changes. The only changes that are usually required are the "key_code", and "port" fields. Instructions for each field are included in that file.

Now you should be ready to run the SiteSearch server. On the UNIX command-line, enter these commands (adjust the /PATH/TO/SITELLITE/ in the first line to reflect the root of your Sitellite installation):

<code> $ cd /PATH/TO/SITELLITE/inc/app/sitesearch/java $ ./start.sh </code>

This will start the server daemon as a background process, so you may safely exit and it will continue to run. Similarly, you can stop the server using the following commands:

<code> $ cd /PATH/TO/SITELLITE/inc/app/sitesearch/java $ ./stop.sh </code>

There is also a script named running.sh that can replace start.sh in that it checks if the server daemon is running, and if not starts it for you. This script can be run as often as you like to ensure that even if SiteSearch should crash, it will come right back up automatically.

It is usually a good idea to have these commands executed automatically when your server starts up and shuts down, so that you don't have to execute these commands each time your server is rebooted. Please consult your operating system documentation for instructions to do that, however here is a simple example using Cron:

<code> 0 0 * * * /home/example/public_html/inc/app/sitesearch/java/running.sh 0 * * * * cd /home/example/public_html; php -f index scheduler-app sitesearch </code>

The first line ensures that the SiteSearch daemon is running, checking every hour. The second line runs the indexer at midnight each night.

Next: Running the SiteSearch indexer