This section contains discussions of two different types of problems:
Note: If you receive an error message when using the AIX documentation search service, and your web browser is using a cache, that error message page will be stored in your web browser's cache. This means that even if you fix the problem that caused the error, the error message will continue to reappear if you repeat the exact same search that caused the error in the first place. Therefore, it is important that you clear out the contents of the browser's cache before you retest the search after you have done a fix. Usually, there is a clear cache function in a browser's Options screens.
The volumes are written using different international character sets. The browser cannot display different character sets simultaneously.
The language of the search form is possibly being set by the document that is opening the search form. For example, if the document was written in Spanish, the author may have specified that when the Search link in the document is clicked, the search service should provide the search form in Spanish. Look at the Search link and see if it is specifying a language.
ORThe web server software may not be reading the locale value correctly. Try restarting your web server to see if it picks up the correct locale.
The specific set of indexes requested to be shown in the search form are not registered with the search program. If you want to continue now, you can use the generic search page, which will allow you to search all volumes.
Use generic page
Invalid Index List
This error occurs when the searchform is passed a list of indexes names and none of them are names of indexes registered with the search engine.
To get a list of the indexes registered with the search engine, execute the following:
/usr/IMNSearch/cli/imnixlst
To determine which indexes were passed to the searchform examine the HTML source for the link that was clicked on to get to the search form. The link may contain a list of indexes, or it may refer to a config file that contains a list of indexes.
If the indexes to be searched do not appear on the list of indexes registered with the search engine, the indexes will need to be installed. If the indexes have already been installed and still don't show up in the list of indexes registered with the search engine, then their install process may not include automatic registration. In this case, see the System Administration guide, Creating Documents and Indexes.
The configuration file 'XXX' that specified the design of the search page does not exist or is read-protected.
Make sure the file exists and that imnadm has permission to read the file. If you want to continue now, you can use the generic search page, which will allow you to search all volumes.
Use generic page
Invalid Configuration File
This error occurs when the searchform is passed a configuration file name and that file does not exist or is not readable by the user imnadm.
In this message XXX will indicate the path and name of the configuration file as requested. If the file does exist and is readable to the user imnadm, make sure the full path is specified. If the path XXX given in the message does not match the path of the configuration file, then either move the file to the path specified by the error message, or edit the HTML link being used to call the searchform and change the path given for the configuration file to match its location.
There was a problem communicating with the search program.
Retry your search. If you repeatedly get this error, contact the system administrator of the search server computer. They may want to try restarting the search program.
Search Engine Server stopped
This error occurs if the NetQuestion search engine is not running.
To start the NetQuestion search engine, you must be root or a member of the group imnadm. Start the NetQuestion search engine with the following command:
imnss -start imnhelp
The search page is not available in the requested language 'xx_XX'.
Unavailable Language
This error occurs if the searchform is passed a language for which no message catalog is available, or no language is specified and there is no message catalog for the locale of the system.
In this message xx_XX is the language for which there was no message catalog. If it is available, the message catalog for the language can be installed. Otherwise, specify a language for which there is a message catalog by using the lang parameter. For how to do this, see the developers guide.
No volumes were selected or no selected volumes were searchable. You must select at least one searchable volume.
ds_rslt: Error EhwOpenIndex 1
Error 77 in index INDEXNAME
An error occurred when attempting to open or read an index file.
Contact the system administrator of the search server computer.
Index file permissions improperly set
This error occurs if the file permissions for the index specified by INDEXNAME are improperly set on files or directories that are part of that index.
Where INDEXNAME is the name of the index, the index files, or links to them can be found in:
/usr/docsearch/indexes/INDEXNAME/data
/usr/docsearch/indexes/INDEXNAME/work
Make sure all index file permissions follow the following rules:
The search program reported an unexpected error condition.
The most likely cause of this error is that the file permissions for one or more indexes are improperly set.
Where INDEXNAME is the name of an index, the index files, or links to them can be found in:
/usr/docsearch/indexes/INDEXNAME/data
/usr/docsearch/indexes/INDEXNAME/work
Make sure all index file permissions follow the following rules:
One or more of the indexes for the selected volumes contain errors that make them unsearchable.
Error 76 in index AIXASSEM
The requested function is in error.
Contact the system administrator of the search server computer.
This error occurs when one or more of the indexes being searched needs to be reset.
To reset an index you must be root or a member of the group imnadm. Reset the index with the imnixrst command:
/usr/IMNSearch/cli/imnixrst <index name>
The requested function is in error.
Contact the system administrator of the search server computer.
This error occurs when all of the indexes being searched need to be reset.
To reset an index you must be root or a member of the group imnadm. Reset the index with the imnixrst command:
/usr/IMNSearch/cli/imnixrst <index name>
A web server error message saying it cannot run ds_form. The exact wording of the message varies across different web server software. For example, the message may say something like:
ds_form is not an executeable.OR
Cannot locate ds_form
Documentation Search Service is not configured properly.
The web server software cannot find the search service ds_form CGI program because the server has not been configured properly. Read the Installation and configuration section of this chapter and make sure the Documentation Search Service is installed and configured properly on the server computer.