Common Documentation Search Service Errors


About this document

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.


Common Errors and Solutions

1. "docsearch: Command not found"
2. "Error: Can't open display: XXX"
3. There is no Documentation Search Service icon in the help subpanel of your desktop.
4. Nothing happens when you click on the Documentation Search Service icon.
5. "Can not launch the default browser.
The launch command specified for the DEFAULT_BROWSER environment variable does not work."

6. "No default browser is specified in the system or user profile files.
Therefore, an attempt was made to start the Netscape browser.
Launch of the Netscape browser failed because the browser can not be located."

7. The Web browser launches but generates an error message saying that it can not locate the Web server.
8. The Web browser launches but generates an error message saying that it is unable to connect to the Web server.
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.
10. "ds_form: Error EhwStartSession 70
There was a problem communicating with the search program."

11. When the search form appears, it isn't in the correct default language of the search server computer
12. "No indexes are registered with the search program."
13. "The lookup table that tells the search program where to find the documents does not exist or is read-protected."
14. "The specific set of indexes requested to be shown in the search form are not registered with the search program."
15. "The configuration <filename> that specified the design of the search page does not exist or is read-protected."
16. "The search page is not available in the requested language 'xx_XX'."
17. "No volumes were selected or no selected volumes were searchable. You must select at least one searchable volume."
18. Error 77 in index <index name>
An error occurred when attempting to open or read an index file

19. "The search program reported an unexpected error condition."
20. "ds_rslt: Error EhwSearch 8"
21. "ds_rslt: Error EhwSearch 76 "
22. In the Documentation Search Service search form, the names of the volumes that are in different languages have scrambled characters.

1. "docsearch: Command not found."


2. Error message "Error: Can't open display: XXX"

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.

OR

Log out and log back in.

  • The Documentation Search Service is not installed, or parts of the package are missing or corrupted.

    Install the bos.docsearch package.


    4. Nothing happens when you click on the Documentation Search Service icon.

  • If the DEFAULT_BROWSER environment variable is not defined, the desktop action launched by the Documentation Search Service icon attempts to run the Netscape browser.

    Enter the command netscape to test if the Netscape browser launches successfully.

  • Parts of the Documentation Search Service are missing or corrupted.

    Reinstall the bos.docsearch package.


    5. You receive the "Can not launch the default browser message."
    Can not launch the default browser.
    The launch command specified for the DEFAULT_BROWSER environment variable does not work.
    .
    .
    .


    6. You receive the "No default browser is specified in the system or user profile files."
    No default browser is specified in the system or user profile files.
    Therefore, an attempt was made to start the Netscape browser.
    Launch of the Netscape browser failed because the browser can not be located.
    .
    .
    .


    7. The Web browser launches but generates an error message saying that it can not locate the Web 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.


    10. You receive the following error message:
    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:

    imnss -start imnhelp

    Retry the search. If problem persists, reinstall the IMNSearch.rte package.


    11. When the search form appears it isn't in the correct default language of the search server computer.

    Unless otherwise instructed, the search form will be displayed in the locale in which the documentation Web server is running.


    12. You receive the following error message:
    ds_form: Error
    No indexes are registered with the search program.
    .
    .
    .

    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
    The lookup table that tells the search program where to find the documents does not exist or is read-protected.
    .
    .
    .


    14. You receive the following error message:
    ds_form: Error
    The specific set of indexes requested to be shown in the search form are not registered with the search program.
    .
    .
    .

    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:

    /usr/IMNSearch/cli/imnixlst

    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:


    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.


    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.


    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.
    Contact the system administrator of the search server computer.

    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.


    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.
    Contact the system administrator of the search server computer.

    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:

    /usr/IMNSearch/cli/imnixrst <index name>
    where <index name> is the name of the index to be reset.


    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:

    /usr/IMNSearch/cli/imnixrst <index name>
    where <index name> is the name of the index to be reset.

    Repeat the search. If the problem persists, reinstall the filesets containing the non-functional indexes.


    22. In the Documentation Search Service search form, the names of the volumes that are in different languages have scrambled characters.

    The volumes are written using different international character sets. The browser cannot display different character sets simultaneously.


    [ Doc Ref: 97362273320098     Publish Date: Nov. 09, 2000     4FAX Ref: none ]