Installation Guide for pssSearch
A Product of Progressive Software Solutions

Return to Progressive Software Solutions Home Page

April 15, 2001

CONTENTS

• About This Program
• Supported Operating Systems
• System Requirements
• Contents of the Zip File
• .ini File
• Installation
• Release History
• Contacting the Author
• License Agreement
• Purchase pssSearch

About This Program

pssSearch(R) V2.51 EASY! Web-based Search Capability

Copyright 2000 Progressive Software Solutions, LLC All Rights Reserved

Licensed for a single Web server.

Software Product Description: pssSearch is a web-based search tool for your web server. pssSearch enables your web-site visitors to find the information they seek on your web-site by entering words or phrases. pssSearch logs the user's search request providing information valuable to your business (address of requester,date/time,search words/phrases). The pssSearch interface is fully customizable to support your branding, banner advertisements and language choice.

FEATURES:
• Runs on any CGI-capable Web Server
• Clean, fast and simple Web-page interface, which you can create if you choose to
• "Just-copy-it" installation
• Does NOT require Perl or any Perl Program Modules
• NO client software required
• Automatic hot links to results
• Fully configured with a TEXT based .ini file
• Multiple-language interfaces -- you provide the language
• Customizable user interface for Corporate Branding
• Integrate your own Banner Advertisements
• Support for Linux, Unix, and NT/2000 Web Server platforms
• Firewall and Proxy/Cache compliant
• SSL Web Server compliant
• Absolutely NO maintenance
• One-time cost
• Own your own Web-based search service

Supported Operating Systems

• Not sure of what binary you need?
• Download binary for AIX
• Download binary for BSD/OS Unix
• Download binary for Caldera OpenLinux
• Download binary for Cobalt Linux (x86)
• Download binary for Cobalt Linux (MIPS)
• Download binary for Debian Linux
• Download binary for Digital Unix, OSF/1
• Download binary for FreeBSD 3.x Unix
• Download binary for FreeBSD 4.x Unix
• Download binary for HP-UX
• Download binary for IRIX
• Download binary for Linux Mandrake
• Download binary for OpenBSD
• Download binary for Red Hat Linux
• Download binary for Slackware Linux
• Download binary for Sun Solaris
• Download binary for SuSE Linux
• Download binary for Windows NT / 2000

• Don't see your OS - email us at support@progressivesoft.com

System Requirements

• NT VersionWindows NT with IIS, PWS, Apache or other CGI-capable webserver.
• Linux/Unix VersionLinux/Unix with Apache or other CGI-capable webserver.

Contents of the Zip File

The zip file you downloaded contains the following files:
• pssSearch.exe or pssSearch.cgi The executable.
• pssSearch.ini The customization file. This file is used to customize pssSearch to your site.
• header.tpl This is the name of the file containing the HTML code that will be displayed as the header on all pages.
• footer.tpl This is the name of the file containing the HTML code that will be displayed as the footer on all pages.
• body1.tpl This is the name of the file containing the HTML code that will be displayed as the start search page. The input names must be the same as those supplied in the original body1.tpl file.
• readme.txt Points the user to this file.
• SEman.htm This file.

Installation

Currently pssSearch has been compiled, tested and validated on Intel X86 or compatible platforms with the Supported Operating Systems listed previously.

The Solaris version requires a Sun SPARC or compatible platform. The Digital Unix and OSF/1 binaries require an Alpha platform. IRIX requires a Silicon Graphics platform. Cobalt Linux (MIPS) requires a MIPS platform. Compiled versions for other Linux or Unix versions are available upon request. No traditional installation is required. One merely follows the following process to set up pssSearch:

• Step 1. Extract the distribution files into a temporary location.
• Step 2. Copy pssSearch.exe or pssSearch.cgi, pssSearch.ini, header.tpl, footer.tpl and body1.tpl to the location on your Web Server that has execution enabled. Also, if you are running the evaluation copy of pssSearch, you must write-enable pssSearch.ini. Once you run pssSearch the first time, you may reset the pssSearch.ini file attribute to Read-only. This procedure can be run once "off-line."
  • NT Version -- The default location on IIS v4.0 is "C:\Inetpub\scripts". Don't forget to ensure that the pssSearch.ini file attribute is not set to Read-only unless you have already run pssSearch.exe once.
  • Linux/Unix Version -- The default location on Apache v1.3.9 is /home/httpd/cgi-bin or /usr/local/www/cgi-bin.

  Don't forget to "chmod +x pssSearch.cgi" when you get pssSearch.cgi in the appropriate directory. Also, don't forget to "chmod o+w pssSearch.ini" unless you have already run pssSearch.cgi once.

• Step 3. put a button on your home page or other appropriate page that points to pssSearch. Or give your users a URL that points them to the Server on which pssSearch resides, e.g., "www.mycompany.com/scripts/pssSearch.exe" or "www.mycompany.com/cgi-bin/pssSearch.cgi".
• Step 4. Modify the appropriate portions in the pssSearch.ini file, as explained in the following section (pssSearch.ini).

You may rename pssSearch. If you choose to do so, you must also rename pssSearch.ini to correspond to the new name. For example, if you rename it MySearch.exe or MySearch.cgi, you must rename the .ini file MySearch.ini. If you do this and it it still looks for pssSearch.ini, then your OS is using a source executable environment variable other then "SOURCEEXE" or "sourceExe." If this is the case, simply continue to use pssSearch.ini, run "printenv" (most systems have this program), and e-mail us the output along with the type of OS you are running. From this we can add the new source executable variable and get a new executable to you that will allow you to rename pssSearch to whatever you desire. If your system does not have a "printenv" e-mail us, and we will send you a copy.

You may completely change the look of the page header and/or footer by providing your own "header.tpl" and/or "footer.tpl" file.

You may also completely change the look of the start page by providing your own "body1.tpl" file. Note, however, that you must use the same input names that were used in the "body1.tpl" file provided in the distribution media.
Return to Top

pssSearch.ini

This file is used to customize pssSearch for your use. The letters preceding the " = " and the " = " are important key characters and should not be changed in any way. The file contains the following information:

• Key = U2VhcmNoRXhwcmVzcwo= This is an example of the key used by pssSearch. When you purchase the authentication key, you must replace this temporary key. The temporary key will allow you to use and evaluate pssSearch free of charge for 30 days. During that time you will notice two additional lines on the pages. One will tell you how many days are left before your evaluation copy will expire and one is an advertisement for Progressive Software Solutions. Rest assured these two additional lines will not appear once you purchase your authentication key.

  NOTE: The first time you run the Evaluation Copy of pssSearch, you must allow a single, one-time write to pssSearch.ini. This write updates your evaluation key. Without this initial write, your evaluation copy will not run. You may run this one time off-line, if you wish. Once this update occurs, there is no requirement for write privledges on pssSearch.ini. The command for UNIX/Linux is "chmod o+w pssSearch.ini"

• (NT Version) SearchURL = http://0.0.0.0/scripts/pssSearch.exe This is the URL pointing to pssSearch.exe. Each command (button) executed in pssSearch will return to this URL for execution. This URL can include a fully qualified domain name or simply an IP address.
• (Linux/Unix Version) SearchURL = http://0.0.0.0/cgi-bin/pssSearch.cgi This is the URL pointing to pssSearch.cgi. Each command (button) executed in pssSearch will return to this URL for execution. This URL can include a fully qualified domain name or simply an IP address.
• Header = header.htm This is the name of the file containing the HTML code that will be displayed as the header on all pages. It should be placed in the same directory as SearcExpress.
• Footer = footer.htm This is the name of the file containing the HTML code that will be displayed as the footer on all pages. It should be placed in the same directory as SearcExpress.
• Body1 = body1.htm This is the name of the file containing the HTML code that will be displayed as the start search page. The input names must be the same as those supplied in the original body1.htm file provided in the distribution media. It should be placed in the same directory as SearcExpress.
• LogFile = SElog.log This is the name of the log file that will contain the following information:
  Date and Time
  IP address of requester
  Words or Phrases searched
  The log file will be continuously appended. If it is not present it will be created. If you do not want a log file remove the "LogFile =" line from the .ini file or simply place an "x" in front of LogFile (xLogFile =). You must supply a fuul path for the log file otherwise it will be written in your root directory.
• ResultsPerPage = 5 This is the number of results that will be displayed per page. You may change this number to suite your site.
• MatchesFound = Below are the results of your search: These are the words the user will see when the results are listed. You may not use multiple line.
• NoMatchesFound = Sorry, No Matches Found! These are the words the user will see if no matches were found. You may not use multiple lines.
• BaseURL = http://0.0.0.0 This is the base URL of your site. You may use IP address or a fully qualified name. Results will be referenced to this address.
• BaseDir = C:/inetpub This is the full path equivalent of BaseURL.
• [Directories] These are the directories you want to be available to the user to search. "[Directories]" begins the list and "[]" ends the list. Use a blank line for the root directory. Each directory must be on a separate line.

  In this example pssSearch would look in the root directory and the directories named Faqs, News, and Products: [Directories] /Faqs /News /Products []

• [] Designates the end of the Directories list.
• Subdirectories = no This will allow the user to search subdirectories.
• [SearchTypes] These are the file types you will allow the user to search. Note: htm works for htm, html, phtml, shtml, etc. "[SearchTypes]" begins the list and "[]" ends the list. Each type must be on a separate line. In this example pssSearch would search all files with file exentions of htm, html, phtml, shtml, txt, doc, and log. [SearchTypes] htm txt doc log []
• [] Designates the end of the SearchTypes list.

Release History

• Last Updated Sunday, April 15, 2001
  Version 2.51 released
  Improved special character support
  Verified name change to pssSearch
  
• Sunday, September 3, 2000
  Version 2.50 released

Contacting the Author

We'd like to hear your questions and comments! You can reach us at:

Internet Email: support@progressivesoft.com
WWW: http://www.progressivesoft.com/
Return to Top

License Agreement

You should carefully read the following terms and conditions before using this software. Unless you have a different license agreement signed by Progressive Software Solutions, LLC, your use of this software indicates your acceptance of this license agreement and warranty.

Registered Version

Each registered copy of pssSearch is subject to the following conditions:

A separate registered copy of pssSearch must be obtained for each web-site on which pssSearch will be used, even if such use is only temporary. This is not a "concurrent use" license.

No registered user, nor anyone else, may alter or modify the pssSearch exe/cgi file. Nor can you give anyone else permission to modify the pssSearch exe/cgi file.

All rights not expressly granted in this license agreement are reserved entirely to Progressive Software Solutions, LLC.

Governing Law

This agreement shall be governed by the laws of the State of Virginia, USA.

Disclaimer of Warranty

THIS SOFTWARE AND THE ACCOMPANYING FILES ARE SOLD "AS IS" AND WITHOUT WARRANTIES AS TO PERFORMANCE OF MERCHANTABILITY OR ANY OTHER WARRANTIES WHETHER EXPRESSED OR IMPLIED. Because of the various hardware and software environments into which pssSearch may be put, NO WARRANTY OF FITNESS FOR A PARTICULAR PURPOSE IS OFFERED. Good data processing procedure dictates that any program be thoroughly tested with non-critical data before relying on it. The user must assume the entire risk of using the program. ANY LIABILITY OF THE SELLER WILL BE LIMITED EXCLUSIVELY TO PRODUCT REPLACEMENT OR REFUND OF PURCHASE PRICE.

Shareware Version

This is not free software. You are hereby licensed to use the shareware evaluation version of pssSearch for evaluation purposes without charge for a period of 30 days. If you use this software after the 30 day evaluation period a registration fee is required. Unregistered use of pssSearch after the 30 day evaluation period is in violation of copyright laws.

Distribution of pssSearch

You are hereby licensed to make as many copies of the shareware evaluation version of this software and documentation as you wish; give exact copies of the original shareware version to anyone; and distribute the shareware version of the software and documentation in its unmodified form via electronic means. There is no charge for any of the above.

You are specifically prohibited from charging, or requesting donations, for any such copies, however made; and from distributing the software and/or documentation with other products (commercial or otherwise) without prior written permission from Progressive Software Solutions, LLC., with one exception: Disk Vendors approved by the Association of Shareware Professionals are permitted to redistribute pssSearch subject to the conditions in this license, without specific written permission.