Fluid Dynamics Search Engine v2.0.0.0049

Manual Install Instructions

Last modified on Friday, August 24, 2001.

This product has been designed for fast and easy installation. Follow these simple steps to get the script up and running in just a few minutes.

  1. Download

    Download the product appropriate to your platform:

    Each archive contains the exact same code, except that the Windows version uses "\r\n" line endings, and the Unix version uses "\n" endings.

    The .tar.gz version can be decompressed with the commands:

    gzip -d fdse.2.0.0.0049.tar.gz
    tar -xf fdse.2.0.0.0049.tar

    The .zip version can be decompressed with Winzip from www.winzip.com.

    If you install a version other than 2.0.0.0049, follow the install file included with it, rather than this one.


  2. Build Directory Structure

    The script uses a specific directory structure to organize its libraries and data files. When the downloaded archives are expanded, they will automatically expand into the desired structure. You must retain that structure when transferring files between computers.

    For your reference, Appendix II contains a detailed list of all files and folders, describing what they do and where they belong.

    Note: this script uses relative paths extensively, and so its very demanding about its directory structure. It does not use absolute paths at all, however. That means you don't need to enter the absolute path into the script configuration files (if it needs to know its absolute path, it will auto-detect it).


  3. Customize Script

    In this step, you customize the CGI script files. Some library and data files also use the ".pl" extension, but those files must not be renamed or edited. The only files that you should edit are:

    • search/search.pl
    • search/searchmods/powerusr/cmd_admin.pl
    • search/searchmods/powerusr/hacksubs.pl
    • search/searchmods/powerusr/lang.pl

    99.9% of this script is configured after the install is complete, using the admin control panel. Only two things need to be configured during installation:

    1. If your path to Perl is not "/usr/local/bin/perl", then edit the first line of the script to point the appropriate path. Popular locations include "/usr/bin/perl" and "/usr/bin/perl5".

    2. Rename the CGI script file(s) to use the Perl CGI file extension required on your system. Different systems have different rules about which extension to use. Most nice systems accept either .cgi or .pl, in which case you can skip this step. Others allow only .cgi, and others allow only .pl. Still others require .plx or other weird names. Ask your administrators, or copy the extensions of working scripts, or experiment to find the extension that works for you.

    When you open the script file to edit the path to Perl, use the most hardcore text editor you have. Like, Notepad on Windows, Simple Text on Mac, vi on Unix. Do not use high-level editors like Microsoft Word or HTML editors like FrontPage. There is a risk that these high-level editors will damage the code.


  4. Transfer Files

    Unless you're doing all of your work on the web server itself, you must transfer the files and folders over to your web server. When transferring script files or data files in FTP, always use ASCII mode.

    If your web server requires that CGI scripts be installed into a special folder, like "cgi-bin" or "cgi", then install all of the files to that folder.


  5. Set Permissions

    The easiest way to set permissions is to run the "setperms" script appropriate for your platform. Run setperms.bat on Windows and setperms.sh on Unix.

    If you have only FTP access to a Unix server, then you can set the permissions with FTP while you're transferring. Use the permissions guide in Appendix II below.

    If you have a Windows web server without shell access, then typically you won't be able to run "setperms.bat" from the command line nor set permissions via FTP. In this case, the best approach is to try an install anyway (the server file system is often read/write/exec by default). If this doesn't work then contact the tech support people and ask them to run setperms.bat for you. If tech support can't help, you can use the Auto Installer process. It will attempt a few work-arounds to remotely set Windows file permissions. The methods don't always work so keep your tech support people as a backup.

    Advanced:

    CGI processes are usually executed under a user context different than your login account. Your login account owns the files and folders that store data. Because CGI processes are only allowed to write to files and folders which they own, or for which they've been given special permission, we take the extra step to make all data files and folders world-writable (any and all processes are allowed to write to them). That way, data can be saved by any user/process, and thus the script will work no matter how your CGI privileges have been configured.

    Obviously, if your web server runs CGI processes under your login account context and not a separate context, then you may apply more restrictive permissions. Data folders can have permission 755 instead of 777; data files can have permission 744 instead of 766. If you are using CGI Wrap, or if you are installing to Hypermart.net or Netfirms.com, then this applies to you and you may use the more restrictive permissions.


  6. Test

    Visit the URL "search/search.cgi?Mode=Admin" to get started.

    Please visit your admin page immediately. If this is your first install, you will have to set a new password.


Manual Install Complete!


Appendix I: Error Handling

If you run into trouble, consider an automated install. The automatic install can self-heal from most common error conditions.

Free custom installs are available from the script author (as of Friday, August 24, 2001). To take advantage of this service, first attempt an automatic install. If it fails, you will have the option to forward an install request. Installs are usually finished within 24 hours.

You can also visit the Discussion Forum with a description of your problem. It stays very busy and there are many helpful people there.

The Auto-Installer is here: www.xav.com/cgi-sys/cgiwrap/xav/install.cgi


Appendix II: Directory Structure and File Descriptions


This file manifest applies to version 2.0.0.0049. If you are installing a different version, use the install.html file included with it.

The file permissions are modeled on the default Apache or Microsoft IIS permissions system, where a user account owns the files and a separate, unprivileged account, executes the CGI scripts. This is not the most secure configuration in the world, but it is the default that has been established, and so these file permissions follow it. If you have a system where your CGI scripts are executed under your user account context (as when using CGIWrap, when using setuid Perl, using Hypermart.net or many other free web hosts, etc.) then you can and should replace all permissions with 755/rwxr-xr-x.


Icons
folder
script file
data file
optional file
Required
Required file or folder
Optional file or folder
Permissions
755 / rwx r-x r-x read and execute
766 / rwx rw- rw- read and write
777 / rwx rwx rwx read, write, and execute


Is Required Object

Permissions File / Folder Description
755 / r-x search main product folder
755 / r-x     install.html Manual install help file
755 / r-x     license.html License agreement
755 / r-x     search.pl Main script file
755 / r-x     setperms.bat Windows batch file for setting file permissions
755 / r-x     setperms.sh Unix shell script for setting file permissions
777 / rwx search/searchdata contains data - index files, system settings, etc.
755 / r-x        .htaccess Prevents access to data folder
755 / r-x        default.htm Prevents access to data folder
766 / rw-        filter_rules.txt Stores Filter Rules
755 / r-x        index.html Prevents access to data folder
766 / rw-        settings.pl Stores script settings
777 / rwx search/searchdata/templates HTML templates and other files
755 / r-x           admin_style.inc Global stylesheet for admin HTML pages
755 / r-x           admin_template.html Template for admin HTML pages
766 / rw-           footer.htm HTML text for the bottom of each publicly-viewable page
766 / rw-           header.htm HTML text for the top of each publicly-viewable page
766 / rw-           line_listing.txt Template for appearance of each item in search results list
766 / rw-           pics_descriptions.txt Stores PICS standards definitions
766 / rw-           style.inc Global stylesheet for public HTML pages
777 / rwx search/searchdata/templates/dutch Dutch language files
755 / r-x              admin_ads.txt
755 / r-x              admin_fr.txt
755 / r-x              admin_fr2.txt
755 / r-x              admin_navbar.txt
755 / r-x              admin_pass1.txt
755 / r-x              admin_pass2.txt
755 / r-x              admin_personal.txt
755 / r-x              admin_ui.txt
766 / rw-              linkline1.txt
766 / rw-              linkline2.txt
766 / rw-              searchform.htm
755 / r-x              settings_desc.txt
755 / r-x              strings.txt
766 / rw-              tips.htm
755 / r-x              translation_credits.txt
777 / rwx search/searchdata/templates/english English language files
755 / r-x              admin_ads.txt
755 / r-x              admin_fr.txt
755 / r-x              admin_fr2.txt
755 / r-x              admin_navbar.txt
755 / r-x              admin_pass1.txt
755 / r-x              admin_pass2.txt
755 / r-x              admin_personal.txt
755 / r-x              admin_ui.txt
766 / rw-              linkline1.txt
766 / rw-              linkline2.txt
766 / rw-              searchform.htm
755 / r-x              settings_desc.txt
755 / r-x              strings.txt
766 / rw-              tips.htm
777 / rwx search/searchdata/templates/french French language files
755 / r-x              admin_ads.txt
755 / r-x              admin_fr.txt
755 / r-x              admin_fr2.txt
755 / r-x              admin_navbar.txt
755 / r-x              admin_pass1.txt
755 / r-x              admin_pass2.txt
755 / r-x              admin_personal.txt
755 / r-x              admin_ui.txt
766 / rw-              linkline1.txt
766 / rw-              linkline2.txt
766 / rw-              searchform.htm
755 / r-x              settings_desc.txt
755 / r-x              strings.txt
766 / rw-              tips.htm
755 / r-x              translation_credits.txt
777 / rwx search/searchdata/templates/german German language files
755 / r-x              admin_ads.txt
755 / r-x              admin_fr.txt
755 / r-x              admin_fr2.txt
755 / r-x              admin_navbar.txt
755 / r-x              admin_pass1.txt
755 / r-x              admin_pass2.txt
755 / r-x              admin_personal.txt
755 / r-x              admin_ui.txt
766 / rw-              linkline1.txt
766 / rw-              linkline2.txt
766 / rw-              searchform.htm
755 / r-x              settings_desc.txt
755 / r-x              strings.txt
766 / rw-              tips.htm
755 / r-x              translation_credits.txt
777 / rwx search/searchdata/templates/italian Italian language files
755 / r-x              admin_ads.txt
755 / r-x              admin_fr.txt
755 / r-x              admin_fr2.txt
755 / r-x              admin_navbar.txt
755 / r-x              admin_pass1.txt
755 / r-x              admin_pass2.txt
755 / r-x              admin_personal.txt
755 / r-x              admin_ui.txt
766 / rw-              linkline1.txt
766 / rw-              linkline2.txt
766 / rw-              searchform.htm
755 / r-x              settings_desc.txt
755 / r-x              strings.txt
766 / rw-              tips.htm
777 / rwx search/searchdata/templates/portuguese Portuguese language files
755 / r-x              admin_ads.txt
755 / r-x              admin_fr.txt
755 / r-x              admin_fr2.txt
755 / r-x              admin_navbar.txt
755 / r-x              admin_pass1.txt
755 / r-x              admin_pass2.txt
755 / r-x              admin_personal.txt
755 / r-x              admin_ui.txt
766 / rw-              linkline1.txt
766 / rw-              linkline2.txt
766 / rw-              searchform.htm
755 / r-x              settings_desc.txt
755 / r-x              strings.txt
766 / rw-              tips.htm
777 / rwx search/searchdata/templates/ro Romanian language files
755 / r-x              admin_ads.txt
755 / r-x              admin_fr.txt
755 / r-x              admin_fr2.txt
755 / r-x              admin_navbar.txt
755 / r-x              admin_pass1.txt
755 / r-x              admin_pass2.txt
755 / r-x              admin_personal.txt
755 / r-x              admin_ui.txt
766 / rw-              linkline1.txt
766 / rw-              linkline2.txt
766 / rw-              searchform.htm
755 / r-x              settings_desc.txt
755 / r-x              strings.txt
766 / rw-              tips.htm
755 / r-x              translation_credits.txt
777 / rwx search/searchdata/templates/spanish Spanish language files
755 / r-x              admin_ads.txt
755 / r-x              admin_fr.txt
755 / r-x              admin_fr2.txt
755 / r-x              admin_navbar.txt
755 / r-x              admin_pass1.txt
755 / r-x              admin_pass2.txt
755 / r-x              admin_personal.txt
755 / r-x              admin_ui.txt
766 / rw-              linkline1.txt
766 / rw-              linkline2.txt
766 / rw-              searchform.htm
755 / r-x              settings_desc.txt
755 / r-x              strings.txt
766 / rw-              tips.htm
777 / rwx search/searchdata/templates/sv Swedish language files
755 / r-x              admin_ads.txt
755 / r-x              admin_fr.txt
755 / r-x              admin_fr2.txt
755 / r-x              admin_navbar.txt
755 / r-x              admin_pass1.txt
755 / r-x              admin_pass2.txt
755 / r-x              admin_personal.txt
755 / r-x              admin_ui.txt
766 / rw-              linkline1.txt
766 / rw-              linkline2.txt
766 / rw-              searchform.htm
755 / r-x              settings_desc.txt
755 / r-x              strings.txt
766 / rw-              tips.htm
755 / r-x              translation_credits.txt
755 / r-x search/searchmods contains function libraries
755 / r-x        common.pl common library file - shared functions and search functions
755 / r-x        common_admin.pl admin library
755 / r-x        common_parse_page.pl library of functions for parsing a document
755 / r-x        do_not_rename_pl_to_cgi_here.txt Warning file
755 / r-x search/searchmods/powerusr contains optional tools for hardcore users
755 / r-x           cmd_admin.pl example script for how to manage FDSE from command line
755 / r-x           function_spec.txt code spec for all functions
755 / r-x           hacksubs.pl dev util for managing/testing/optimizing Perl functions
755 / r-x           lang.pl script to manage/test/optimizing @lang_strings and strings.txt
755 / r-x           lib.pl lightweight code lib for powerusr tools

Permissions File / Folder Description
Is Required Object



Appendix III: Upgrade

To upgrade over a previous installation, without losing data, replace only these files:

search main product folder
search/search.pl Main script file
search/searchdata contains data - index files, system settings, etc.
search/searchdata/templates HTML templates and other files
search/searchdata/templates/admin_style.inc Global stylesheet for admin HTML pages
search/searchdata/templates/admin_template.html Template for admin HTML pages
search/searchdata/templates/dutch Dutch language files
search/searchdata/templates/dutch/admin_ads.txt
search/searchdata/templates/dutch/admin_fr.txt
search/searchdata/templates/dutch/admin_fr2.txt
search/searchdata/templates/dutch/admin_navbar.txt
search/searchdata/templates/dutch/admin_pass1.txt
search/searchdata/templates/dutch/admin_pass2.txt
search/searchdata/templates/dutch/admin_personal.txt
search/searchdata/templates/dutch/admin_ui.txt
search/searchdata/templates/dutch/settings_desc.txt
search/searchdata/templates/dutch/strings.txt
search/searchdata/templates/dutch/translation_credits.txt
search/searchdata/templates/english English language files
search/searchdata/templates/english/admin_ads.txt
search/searchdata/templates/english/admin_fr.txt
search/searchdata/templates/english/admin_fr2.txt
search/searchdata/templates/english/admin_navbar.txt
search/searchdata/templates/english/admin_pass1.txt
search/searchdata/templates/english/admin_pass2.txt
search/searchdata/templates/english/admin_personal.txt
search/searchdata/templates/english/admin_ui.txt
search/searchdata/templates/english/settings_desc.txt
search/searchdata/templates/english/strings.txt
search/searchdata/templates/french French language files
search/searchdata/templates/french/admin_ads.txt
search/searchdata/templates/french/admin_fr.txt
search/searchdata/templates/french/admin_fr2.txt
search/searchdata/templates/french/admin_navbar.txt
search/searchdata/templates/french/admin_pass1.txt
search/searchdata/templates/french/admin_pass2.txt
search/searchdata/templates/french/admin_personal.txt
search/searchdata/templates/french/admin_ui.txt
search/searchdata/templates/french/settings_desc.txt
search/searchdata/templates/french/strings.txt
search/searchdata/templates/french/translation_credits.txt
search/searchdata/templates/german German language files
search/searchdata/templates/german/admin_ads.txt
search/searchdata/templates/german/admin_fr.txt
search/searchdata/templates/german/admin_fr2.txt
search/searchdata/templates/german/admin_navbar.txt
search/searchdata/templates/german/admin_pass1.txt
search/searchdata/templates/german/admin_pass2.txt
search/searchdata/templates/german/admin_personal.txt
search/searchdata/templates/german/admin_ui.txt
search/searchdata/templates/german/settings_desc.txt
search/searchdata/templates/german/strings.txt
search/searchdata/templates/german/translation_credits.txt
search/searchdata/templates/italian Italian language files
search/searchdata/templates/italian/admin_ads.txt
search/searchdata/templates/italian/admin_fr.txt
search/searchdata/templates/italian/admin_fr2.txt
search/searchdata/templates/italian/admin_navbar.txt
search/searchdata/templates/italian/admin_pass1.txt
search/searchdata/templates/italian/admin_pass2.txt
search/searchdata/templates/italian/admin_personal.txt
search/searchdata/templates/italian/admin_ui.txt
search/searchdata/templates/italian/settings_desc.txt
search/searchdata/templates/italian/strings.txt
search/searchdata/templates/portuguese Portuguese language files
search/searchdata/templates/portuguese/admin_ads.txt
search/searchdata/templates/portuguese/admin_fr.txt
search/searchdata/templates/portuguese/admin_fr2.txt
search/searchdata/templates/portuguese/admin_navbar.txt
search/searchdata/templates/portuguese/admin_pass1.txt
search/searchdata/templates/portuguese/admin_pass2.txt
search/searchdata/templates/portuguese/admin_personal.txt
search/searchdata/templates/portuguese/admin_ui.txt
search/searchdata/templates/portuguese/settings_desc.txt
search/searchdata/templates/portuguese/strings.txt
search/searchdata/templates/ro Romanian language files
search/searchdata/templates/ro/admin_ads.txt
search/searchdata/templates/ro/admin_fr.txt
search/searchdata/templates/ro/admin_fr2.txt
search/searchdata/templates/ro/admin_navbar.txt
search/searchdata/templates/ro/admin_pass1.txt
search/searchdata/templates/ro/admin_pass2.txt
search/searchdata/templates/ro/admin_personal.txt
search/searchdata/templates/ro/admin_ui.txt
search/searchdata/templates/ro/settings_desc.txt
search/searchdata/templates/ro/strings.txt
search/searchdata/templates/ro/translation_credits.txt
search/searchdata/templates/spanish Spanish language files
search/searchdata/templates/spanish/admin_ads.txt
search/searchdata/templates/spanish/admin_fr.txt
search/searchdata/templates/spanish/admin_fr2.txt
search/searchdata/templates/spanish/admin_navbar.txt
search/searchdata/templates/spanish/admin_pass1.txt
search/searchdata/templates/spanish/admin_pass2.txt
search/searchdata/templates/spanish/admin_personal.txt
search/searchdata/templates/spanish/admin_ui.txt
search/searchdata/templates/spanish/settings_desc.txt
search/searchdata/templates/spanish/strings.txt
search/searchdata/templates/sv Swedish language files
search/searchdata/templates/sv/admin_ads.txt
search/searchdata/templates/sv/admin_fr.txt
search/searchdata/templates/sv/admin_fr2.txt
search/searchdata/templates/sv/admin_navbar.txt
search/searchdata/templates/sv/admin_pass1.txt
search/searchdata/templates/sv/admin_pass2.txt
search/searchdata/templates/sv/admin_personal.txt
search/searchdata/templates/sv/admin_ui.txt
search/searchdata/templates/sv/settings_desc.txt
search/searchdata/templates/sv/strings.txt
search/searchdata/templates/sv/translation_credits.txt
search/searchmods contains function libraries
search/searchmods/common.pl common library file - shared functions and search functions
search/searchmods/common_admin.pl admin library
search/searchmods/common_parse_page.pl library of functions for parsing a document
search/searchmods/powerusr contains optional tools for hardcore users


Appendix IV: Uninstall

To remove the product, simply delete the folder that contains all the scripts and data files. The script does not effect anything outside of its folder.


Appendix V: Additional Resources



© 1997-2001 by Zoltan Milosevic