- SSServer does not respond: I type in a query,
hit the Search button on the query form but my browser indicates
"Connection refused".
Check if your computer is connected to the Internet. For example, enter
your Home Page URL in the browser: your Web server may be simply "down" at
the moment.
- My Home Page is seen perfectly but still
after typing in queries, I receive the error message "The page cannot be
found".
Your Web server is unable to find and execute the file ssserver.
Make sure the directory in which you have installed SSServer can be
accessed by your Web server; check also if the virtual name (alias) that
corresponds to this directory is correct.
If not, fix the problem(s) by configuring
your server or by editing the ACTION attribute in the search form:
<FORM ACTION="cgi-bin/ssserver" METHOD="POST">
- While issuing a query, I am prompted to
download the file ssserver. Why doesn't it respond with a search
report?
SSServer is now accessible by remote browsers, but yet your Web server has
not been instructed to execute files from the SSServer root directory.
You should allow your Web server to execute files from this directory.
- SSServer replies with an error message
"Error reading configuration file".
The configuration file must exist in the ssserverdata subdirectory
of the SSServer root directory. The simplest way to fix the problem is to
reinstall SSServer: the required configuration file ssserver.ini with the
default SSServer settings will be automatically created.
- SSServer replies with the error message
"Unable to create work directory".
SSServer must be allowed to read, write and execute files in the
ssserverdata subdirectory of its root directory. Modify permission
and give ssserver the required rights.
- When I press the Help button on the
SSServer query form, I get a message "Help is not available".
Place the file help.htm in the ssserverdata subdirectory of the
SSServer root directory.
- I get the error message "Unable to search:
error opening file filelist.txt"
The file filelist.txt must exist in the ssserverdata
subdirectory of the SSServer root directory. Run SSServer Web-based
configuration utility sssconf to create and modify this file.
- I get the error message "Unable to search:
error opening dictionary."
Reinstall SSServer. Also, you can visit Kryloff Technologies' Page
and download the required language dictionary from
http://www.kryltech.com/langsupp.htm.
- I get an error message "Error generating the
final report" or "error generating the site map"
While functioning, ssserver creates, modifies and deletes temporary
files in the ssserverdata/workdir subdirectory. Modify permission
to give ssserver the required rights.
- I get the error message "Building maps is
not allowed on this site"
Despite the fact that your configuration file (usually, ssserver.ini)
contains the instruction ALLOWSITEMAP=NO, somebody is trying to
obtain it! All instructions in your configuration file have the highest
priority.
- My site contains pages in two languages.
How can I instruct SSServer to process my files correctly?
Create two different query forms for these languages. These
two forms should refer to different configuration files, for example:
<INPUT TYPE="HIDDEN" NAME="CONFIG" VALUE="ssserver1.ini"> in the first form, and
<INPUT TYPE="HIDDEN" NAME="CONFIG" VALUE="ssserver2.ini"> in the second one.
File ssserver1.ini instructs SSServer to search files listed
in filelist1.txt in one language while file ssserver2.ini instructs
the program to process other files in another language. For example:
File ssserver1.ini:
LANGUAGE=English.ssl
FILELIST=EnglishFilesList.txt
WORKDIR=WorkdirForEnglishFiles
File ssserver2.ini:
LANGUAGE=Russian.ssl
FILELIST=RussianFilesList.txt
WORKDIR=WorkdirForRussianFiles
File EnglishFileList.txt:
DIR=/usr/local/www/data/EnglishFolder/
URL=http://www.mycompany.com/EnglishFolder/
File RussianFileList.txt:
DIR=/usr/local/www/data/RussianFolder/
URL=http://www.mycompany.com/RussianFolder/
Finally, place both forms on your Web server's pages; also explain
your visitors that they may type in queries in English using the first form,
and in Russian using the second one. The search form can look as follows:
Search my site in English: | Search my site in Russian: |
Note that the WORKDIR parameters should be different in different
configuration files as it is shown in this example.
- SSServer is too slow; also,
I see "garbage" in some quotations that are displayed
in its search reports.
SSServer v1.1 is designed to process HTML and ASCII text files only.
But, if file filelist.txt contains the instruction
DIR= or TREE=, the application scans ALL
FILES IN THIS DIRECTORY (except for .JPG, .JPEG or .GIF files).
So, if along with HTML's and texts, a directory also contains huge binary files,
then these files are being searched as well! This could slow down the
performance and also produce "garbage".
If "unnecessary" files have some unique extension(s), you may include the
statement ExcludeFileExtensions with the corresponding file extension(s)
in SSServer configuration file. Also consider using the statement
FileExtensions to make SSServer process just the required files
only.
If using any of these instructions does not help (for example, there are
huge binary files with the .HTM extension in the same directory where
your pages are), you've got to exclude this directory from the filelist.txt.
After it, include into the list only the required files from this directory
on the "per file" level, e.g. using the instruction FILE=.
- While searching literally, SSServer reports with the beginning
of my HTML documents. Is there any way to make it display document summaries,
instead?
Yes, there is. Include the META tag in the header section of your
Web site documents. For example:
<META NAME="DESCRIPTION" CONTENT="This document is about
this and that...">
SSServer identifies this tag with the document summary and places it
into the resulting report for all files in which it is found.
- I see the warning message "English (or another
language) does not appear to be the language of your search phrase."
How can I get rid of it?
First, try another question: it is very unlikely that the one you have asked
was really in English. For example, you could have typed in digits only.
SSServer checks the language of your search phrase and compares it
with the language dictionary. If this error message constantly appears in
SSServer reports, make sure that you have correctly entered your
language in the configuration file ssserver.ini
(check the statement LANGUAGE=).
- I see the warning message "Error reading file
"file.html" in all SSServer reports."
The actual file has been renamed or deleted while the FILE= instruction,
which refers to the old file, is still present in filelist.txt.
Remove the corresponding instruction from the file list.
- My Web site is hosted on a remote
computer. Is there any way to install and use SSServer on my site?
Yes, there is. Just extract it in a temporary directory on your PC,
edit configuration files and upload the contents of this temporary
directory with subdirectories on your Web server. The detailed
instructions are given in the Read Me file,
the section "Remote Installation".
- What file types are supported by SSServer?
SSServer internally supports HTML and plain text documents. However,
there is a way to process other types of files, see
Read Me file,
the section "File types supported by SSServer" for details.
- The SSServer reports look fine but
they do not fit into the overall layout of my Web pages. Is there a
way to customize the design of the reports to my own requirements? For example,
can I change the report color, header or footer? Can I get rid of mentioning
English as a search language in each report that SSServer generates? All my
pages are only in English; why is SSServer so intrusive that it reminds it
of this fact again and again?
Yes, you can customize the design of the SSServer reports to your
own requirements. Furthermore, instead of the files footer.txt or
header.txt, which are now obsolete, version 1.1 of SSServer
produces reports based on the layout files which are used as templates.
These tempates are nearly finished HTML documents, which you may modify
according to your requirements. All you have to do is to include in these files
macroinstructions which point out space where you want SSServer to place
such elements of the report as document titles, summaries, quotations, new
query form, etc. So, the whole design of the SSServer reports is fully yours!
Provided are just the layout files layout_s.htm, layout_l.htm
and sitemap.htm in the ssserverdata subdirectory
of the SSServer root directory. Modify these files at any time to make
SSServer generate reports that you need.
See also the Read Me file.
SSServer and
Subject Search Server
are trademarks of
Kryloff Technologies, Inc.