This document lists some of the more common errors and their solutions within the Document Search Service.
NOTE: If you receive an error message when using the AIX Documentation Search Service, and your Web browser is using a cache file, that error message page may be stored in this file. So, even if you fix the problem that caused the error, the same error message may continue to appear if you repeat the search that first caused the error. Therefore, ensure that you clear your browser's cache file after applying any of the following fixes, otherwise, the browser may not recognize your changes.
Give the command /usr/bin/echo $PATH to print out the contents of the PATH environment variable.
Install the bos.docsearch package.
Your Web browser is attempting to open up a window on the display defined by the DISPLAY environment variable. Your DISPLAY environment variable is set to display on a machine on which you do not currently have the permissions to display.
3. There is no Documentation Search Service icon in the help subpanel of your desktop.
Restart the workspace manager:
OR
Log out and log back in.
Install the bos.docsearch package.
Enter the command netscape to test if the Netscape browser launches successfully.
Reinstall the bos.docsearch package.
5. You receive the "Can not launch the default browser message."
|
Edit the .profile/.login/.dtprofile/.cshrc file to set the DEFAULT_BROWSER to a valid Web browser command.
Use one of the system management tools (SMIT, WebSM) to set the system default browser.
6. You receive the "No default browser is specified in the system or user profile files."
|
If you want to use the Netscape Web browser, install it.
If you want to use another Web browser, install it and use one of the system management tools (SMIT, WebSM) to set a system default Web browser.
7. The Web browser launches but generates an error message saying that it can not locate the Web server.
Use one of the system management tools (SMIT, WebSM) to set a valid system default documentation server.
8.
The Web browser launches but generates an error message saying that it is unable
to
connect to the Web server.
The Web server on the documentation server is either down or not installed.
9.
The Web browser launches but generates an error message saying that
file /cgi-bin/ds_form or /cgi-bin/ds_rslt is not found or is not
executable.
Install the complete Documentation Search Service package
(bos.docsearch).
Use one of the system management tools (SMIT, WebSM) to configure
the Documentation Search Service.
ds_form: Error EhwStartSession 70
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. |
The NetQuestion search engine may be turned off.
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:
Retry the search. If problem persists, reinstall the IMNSearch.rte package.
ds_form: Error
|
The Documentation Search Service is installed but no documentation indexes have been installed, or the indexes have been deleted.
Install the documentation indexes that you want to search.
13. You receive the following error message:
ds_form: Error
|
Change the ownership of the file.
Follow the instructions in the "Documentation Search Service" chapter of the AIX General Programming Concepts Guide on how to register an index with the lookup table.
14. You receive the following error message:
ds_form: Error
|
This error can occur when the search form is passed a list of index 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, enter the following as root or a member of the group imnadm:
To determine which indexes were passed to the search form, examine the HTML source for the link that was clicked on to reach the search form. The link may contain a list of indexes, or it may refer to a configuration file that contains a list of indexes, or both.
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 do not show up in the list of indexes registered with the search engine, their install process may not include automatic registration. In this case, see the "Documentation Search Service " chapter of the System Administration Guide under the section titled 'Creating Documents and Indexes.'
15. You receive the following error message:
ds_form: Error
The configuration <filename> that specified the design of the the search page does not exist or is read-protected. Ensure 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 |
This error occurs when the search form is passed the name of a configuration file that does not exist, or it is not readable by the imnadm.
In this message, <filename> will indicate the path and name of the configuration file as requested. If the file does exist and is readable to the imnadm, ensure the full path is specified. If the path <filename> given in the message does not match the path of the configuration file, either move the file to the path specified by the error message, or edit the HTML file that specifies the link being used to call the search form. Also change the path given for the configuration file to match its actual location.
If the configuration file mentioned is either the AIX Base Documentation configuration file, /usr/share/man/info/$LANG/a_doc_lib/base.cfg, or the AIX Extended Documentation configuration file, /usr/share/man/info/$LANG/a_doc_lib/base.cfg, the problem may be one of the following:
Change the permissions of the file and/or the directory in which the file resides to enable the imnadm to read the file.
Reinstall the bos.html.$LANG.topnav package.
16. You receive the following error message:
ds_form: Error
The search page is not available in the requested language 'xx_XX'. |
This error can occur if the search form 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.
The link <A HREF="/cgi-bin/ds_form?configuration=/path/file"> specifies that the search form be displayed using the information in the specified configuration file. If you examine the contents of that file you may see a line like the following:
17. You receive the following error message:
ds_rslt: Error
No volumes were selected or no selected volumes were searchable. You must select at least one searchable volume. |
Back up to the search form and select at least one book to search.
18. You receive the following error message:
ds_rslt: Error EhwOpenIndex 1
Error 77 in index <index name>
An error occurred when attempting to open or read an index file.
|
This error can occur if the file permissions for the index specified by <index name> are improperly set on files or directories that are part of that index.
Where <index name> is the name of the index, the index files, or links to them can be found in:
/usr/docsearch/indexes/<index name>/data /usr/docsearch/indexes/<index name>/work
Ensure all index file permissions follow the rules below:
19. You receive the following error message:
ds_rslt: Error EhwSearch 32
The search program reported an unexpected error condition. |
Where <index name> is the name of an index, the index files, or links to them, can be found in:
/usr/docsearch/indexes/<index name>/data
/usr/docsearch/indexes/<index name>/work
Ensure all index file permissions follow these rules:
Reinstall the filesets containing the indexes. Repeat the search. If problem persists, reinstall the IMNSearch.rte package.
20. You receive the following error message:
ds_rslt: Error EhwSearch 8
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.
|
This error can occur 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 following command:
21. You receive the following error message:
ds_rslt: Error EhwSearch 76
The requested function is in error. Contact the system administrator of the search server computer. |
This error can occur 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 command:
Repeat the search. If the problem persists, reinstall the filesets containing the non-functional indexes.