<< Previous Page
Index
Index Next Page >>
Search Settings & Options

FM SiteSearch Documentation

Installation

1.1 Requirements to run FM SiteSearch
1.2 Lunix/Unix Installation instructions
1.4 Final Installation Notes
1.5 Mysql Notes
1.6 Upgrade Instructions to upgrade From Version 4.x to a newer Version 4.x
1.7 Upgrade Instructions to upgrade From Version 3.x to Version 4.x

 

1.1 Requirements

The requirements are those that most CGI scripts in general will require. What is required to run FM SiteSearch?

  • Your own standard cgi-bin directory.
    This is the directory where the cgi scripts are executed from. An example of a standard cgi-bin directory:
    http://www.yourdomain.com/cgi-bin    

  • Perl Ver 5+    

  • FTP access to transfer files and to set permissions of files and directories.    

  • Linux/Unix web host or server

  • Mysql (Optional but recommended for web sites with thousands of pages - You can switch to Mysql at any time)

 

1.2 Installation Instructions

The installation of FM SiteSearch should be painless. Every measure has been taken to ensure that you get it right the first time. You don't have to edit any files, and only need to supply information with the setup interface.

Follow the steps below exactly as described and you should have FM SiteSearch serving you in a couple of minutes. Do the steps as you read through them.

Step 1. (Extract the .zip archive)

Extract the files with their directories that came in the .zip archive.

Step 2. (Transfer files to your cgi-bin directory)

The .zip archive will contain directories inside it. These directories are 'cgi-bin' and 'images'
Transfer the files and directory in the 'cgi-bin' directory to your 'cgi-bin' directory on your web host.
(The cgi-bin directory in the .zip installation archive has a sub directory called 'data' - also transfer this together with it's files)

You could place the files in for example: http://www.yourdomain.com/cgi-bin/fmsearch

Watch Movie of this step


movie.gif (975 bytes)
  • Requires: Flash
  • File Size: 300 KB

Step 3. (Set permissions of the .cgi and .pm script files)

Set the permissions of the .cgi and .pm files to the permission setting of 755.

How to set file permissions:
Most FTP clients have this ability. Go to the cgi-bin directory where the main .cgi and .pm script files resides. Select the files that you just copied. In your FTP client there should be a menu item (by right clicking the files) or button where you change the file attributes or file permissions. Set the permissions/attributes to 755.

Watch Movie of this step


movie.gif (975 bytes)
  • Requires: Flash
  • File Size: 500 KB

Step 4. (Set config.cgi to the permission setting of 777)

Assign the permission setting of 777 to config.cgi - config.cgi is one of the files that you transferred into your cgi-bin directory as explained in the above step.

Watch Movie of this step


movie.gif (975 bytes)
  • Requires: Flash
  • File Size: 520 KB

Step 5. (Set permissions of the 'data' directory and files within it)

In your cgi-bin directory on your web host the FM SiteSearch .cgi and .pm files should now reside. You should also have a directory called 'data' that should also have been transferred with the .cgi and .pm files.

Set the 'data' directory to the permission setting of 777 - Also set the files inside this directory to the permission setting of 777

Watch Movie of this step


movie.gif (975 bytes)
  • Requires: Flash
  • File Size: 600 KB

Step 6. (Create an 'images' directory)

With the files/directories you extracted from the .zip archive there should have been a directory called 'images'.

On your web host, create a directory called 'images' or whatever you would like to call it. This directory has to be in your public html document tree. Your public html document tree is where you store the web pages of your web site.

Now you should have created the 'images' directory. Transfer the contents of the 'images' directory you have extracted from the installation .zip archive to the 'images' directory you just created.

Watch Movie of this step


movie.gif (975 bytes)
  • Requires: Flash
  • File Size: 550 KB

Step 7. (The setup interface)

Load setup.cgi in your browser and follow the instructions from there. setup.cgi is in your 'cgi-bin' directory where you have copied the .cgi and .pm files.

It should be located at, for example:
http://www.yourdomain.com/cgi-bin/fmsitesearch/setup.cgi

 

1.4 Final Installation Notes

When you have completed the installation, log into the control panel and change the search settings so that it suites your needs. It would be a good idea to look at all settings in the control panel and to set them according to your preferences. There are many functions and options available which is thoroughly explained in the rest of the documentation.

If you are going to use a search index, (Pro version only) you will need to build a search index before your web site can be searched. If any of the contents of your web site changes then you will need to rebuild the search index to reflect the changes. Using a Search Index will ensure maximum speed when searches are performed.

 

1.5 Mysql Notes

If you are going to use Mysql then you just need to choose that you are going to use mysql from setup.cgi - You will also need to supply a database name, database user name and password.

If you decide to switch to Mysql at a later stage you may do so at any time. Please note that the search box HTML code will change and fmsearch2.cgi will be used for searches instead of fmsearch.cgi

 

1.6 Upgrade Instructions to upgrade From Version 4.x to a newer Version 4.x

Only follow these instructions if you are upgrading from ver 4.0 to 4.1 for example. If you are upgrading from ver 3.x to ver 4 for example then you will need to re-install FM SiteSearch. (These versions are not backwards compatible)

Upgrading your copy of FM SiteSearch should be painless. Follow the instructions as you read through them below.

Step 1. (Extract the .zip archive)

Download the free version of FM SiteSearch and extract the files with their directories that came in the .zip installation archive archive.

Step 2. (Replace all .cgi and .pm files)

The .zip installation archive will contain directories inside it. These directories are 'cgi-bin' and 'images'

Transfer the files in the 'cgi-bin' directory to your 'cgi-bin' directory replacing the old .cgi and .pm files of FM SiteSearch. Don't transfer and replace config.cgi

Read the notes below carefully:

CAUTION: Do not replace the config.cgi of your FM SiteSearch installation. This file will be located amongst the .cgi and .pm files inside your cgi-bin directory where the .cgi and .pm files of FM SiteSearch resides.

CAUTION: Do not transfer the 'data' directory under the cgi-bin directory of the .zip installation archive. (Don't replace the 'data' files from the .zip archive over your old ones)

Step 3. (Set permissions of the .cgi and .pm script files)

Set the permissions of the .cgi and .pm files that you replaced to the permission setting of 755.

Step 4. (Re-transfer image files)

Inside the installation .zip archive there will be a directory called 'images', Transfer the contents of this directory replacing the files inside the directory holding the image files of your FM SiteSearch installation.

Step 5. (Upgrade to 'Pro' version)

If you own the 'Pro' version of FM SiteSearch then upgrade your copy to the 'Pro' version. To do this follow the instructions you received when you purchased the 'Pro' version.

 

1.7 Upgrade Instructions to upgrade From Version 3.x to Version 4.x

Version 3 and Version 4 are not backwards compatible. To use version 4, do a clean installation of Version 4. You can find installation instructions here.

 

 


<< Previous Page
Index
Index Next Page >>
Search Settings & Options
Site Map | PowerSeek | Turbo Seek | HTML Rotate | Quick Polls | FM SiteSearch Pro | Download Monitor | SiteNet BBS | More...
Products | Support Desk | Affiliate Program | Web Hosting | FocalMedia.Net Featured On | Contact us