corner1.gif (159 bytes) corner2.gif (159 bytes)

TurboSeek » TurboSeek Documentation >> 5. Building a Search Index


Turbo Seek Documentation

Index

1. Installation
2. Settings and Options (After installation)
3. The Directory Manager
4. How templates & their variables work
5. Building a Search Index
6. Running your directory
7. Tips, Tricks & Notes
8. Plug-In's

<< Previous Page
How templates Work

Index

Next Page >>
Running Your Directory

 

5. Building a Search Index

5.0 Overview
5.1 Building a search index from the admin control panel.
5.2 Building a search index from the Unix command prompt.
5.3 Using cron to build an index on a scheduled basis.
       5.3.1 Overview of how cron and admin4.cgi would work

 

5.0 Overview

The 'Search Index' is a special database file that is built for searching purposes. The reason such a database file is built is for search performance reasons. The database file has been structured for searching and optimum speed.

There are two ways to build a Search Database. (Search Index) You can do it from the web (admin control panel) or from the Unix/Linux command prompt.

If you make any changes to any links and want the changes to take effect in the Search Index, you will have to rebuild the search index. You can rebuild this index on a daily basis with Unix/Linux cron. See 5.3

 

5.1 Building a search index from the admin control panel.

Click the 'Build Indexes' button. Then click 'Build Search Index'. An index will be generated. Building the index from the Unix/Linux prompt will be approximately 100% -1000% faster than from the browser. This is due to browser constraints.

 

5.2 Building a search index from the Unix command prompt.

Telnet/SSH into your server/hosting-account. Go to the directory where Turbo Seek's admin scripts resides in. Type in: perl admin4.cgi

After executing admin4.cgi with Perl, the index will be generated.

 

5.3 Using cron to build an index on a scheduled basis.

The Unix Cron program is a task scheduler that usually comes with all flavours of Unix/Linux. If you are on a virtual account you may need special permission from your hosting company to use the Unix/Linux Cron program.

It is highly recommended that you know how to use Unix/Linux Cron before attempting to use the Unix/Linux Cron program for building indexes. You should be able to find help on Unix/Linux Cron all over the web via Search Engines.

You may use the Unix/Linux Cron program to rebuild the index daily, weekly or whatever schedule would suite you.
   
You will have to know how Cron works. Note that you cannot just execute admin4.cgi with Cron. The reason for this is that admin4.cgi needs the working directory to be the directory in which it resides.

To make the directory in which admin4.cgi resides in, the working directory, you can create a Unix shell script, (Almost like a dos batch file) which executes admin4.cgi

The creation of the script file should be simple. If you create it in windows and ftp it to your hosting account remember that you will have to make this script file executable by using setting it's permission setting to 755

Also remember that you will have to save this script file in unix file format if created and ftp'ed to your server account. Use textpad to save files in unix file format when creating the file in windows.
   
The shell script should look something like this:
   
    ### START OF SHELL SCRIPT
    cd /home/yourdomain/www/cgi-bin/admin  ### Change to admin4.cgi's working dir
    perl admin4.cgi                                       ### Execute admin4.cgi   
    ### END OF SHELL SCRIPT

The shell script will execute admin4.cgi with the unix perl interpreter. The file name of the shell script could be called anything. For example: build_index or build
      

5.3.1 Overview of how cron and admin4.cgi would work

Step 1.
Create a Unix shell script that executes admin4.cgi - You can create this file on your hosting server or in Windows. If created in Windows ftp it to your hosting account where the Unix Cron program can execute it.

Step 2.
Configure Cron to execute the shell script you have created, on the scheduled intervals you specify.

 

<< Previous Page
How templates Work

Index

Next Page >>
Running Your Directory

ffbotl.gif (1447 bytes) FocalMedia.Net Support ffbotr.gif (1456 bytes)