Common Documentation Search Service Errors

Install the bos.docsearch package.

• The Documentation Search Service icon launches a desktop action that attempts to run the command specified in the DEFAULT_BROWSER environment variable. The command specified in the DEFAULT_BROWSER environment variable may fail to launch a Web browser but still not return an error code.
  1. Enter the command echo $DEFAULT_BROWSER to print out the contents of the DEFAULT_BROWSER environment variable.

  2. Enter the command in the DEFAULT_BROWSER environment variable to test if it is a valid command to start a Web browser.

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."

Can not launch the default browser. The launch command specified for the DEFAULT_BROWSER environment variable does not work. . . .

• Your defined DEFAULT_BROWSER environment variable does not define a valid, executable Web browser command.

  Edit the .profile/.login/.dtprofile/.cshrc file to set the DEFAULT_BROWSER to a valid Web browser command.

• The browser command in the system environment variable DEFAULT_BROWSER either can not be found, or does not work.

  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."

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. . . .

• Your path does not contain the location of the Netscape executable.

• You do not have the Netscape browser installed on your machine.

  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.

• The DOCUMENT_SERVER_MACHINE_NAME environment variable does not define a valid documentation server machine.

  Use one of the system management tools (SMIT, WebSM) to set a valid system default documentation server.

• The computer is unable to translate the name given in the DOCUMENT_SERVER_MACHINE_NAME environment variable into a valid IP address.

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.

• The Documentation Search Service is not completely installed.

  Install the complete Documentation Search Service package (bos.docsearch).

• The Documentation Search Service has not been configured.

  Use one of the system management tools (SMIT, WebSM) to configure the Documentation Search Service.

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.

• The language of the search form may be 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. If this link is specifying a language, it will override the default language of the search server.

  For example the link <A HREF=/cgi-bin/ds_form?lang=es_ES> specifies that the search form be displayed in Spanish.

• The Web server software may not be reading the locale value correctly. If the Web server is automatically started up when the machine reboots, the Web server will be started before the locale is set as defined by the system administrator. This can cause the Web server to have the default locale of C every time the machine is rebooted.

  Try stopping and restarting the Web server to see if it picks up the correct locale.

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. . . .

• The file /var/docsearch/indexes/imnmap.dat is not readable by the imnadm.

  Change the ownership of the file.

• You have created an index, but not registered the index with the lookup table.

  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.

• The index lookup table has been deleted.
  1. If the file /usr/docsearch/indexes/imnmap.dat still exists and has the correct contents, copy it to /var/docsearch/indexes/imnmap.dat.

  2. Restore the file /var/docsearch/indexes/imnmap.dat from your backups and copy it to /usr/docsearch/indexes/imnmap.dat.

  3. Reinstall the filesets containing the indexes.

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

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:

• The file is not readable.

  Change the permissions of the file and/or the directory in which the file resides to enable the imnadm to read the file.

• The file does not exist.

  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.

• If a language was specified in either the HTML link or in a configuration file, the message catalog for that language is either not available or not installed.

  For example, the link <A HREF="/cgi-bin/ds_form?lang=es_ES"> specifies that the search form be displayed in Spanish.

  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:

  			
  lang=ru_RU
  		

  which specifies that the search form be displayed in Russian.

• If no language was specified, the message catalog for the default language of the system is not installed. If it is available, install the message catalog for the language to be installed. Otherwise, specify a language for which there is a message catalog by using the language parameter. For how to do this, see the "Documentation Search Service" chapter of the AIX Programming Concepts Guide.

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.

• You did not select any indexes to search.

  Back up to the search form and select at least one book to search.

• All of the indexes that you selected to search were unsearchable. In this case, one or more index specific error messages should appear below this message. See the index specific error message support instructions.

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

19. You receive the following error message:

ds_rslt: Error EhwSearch 32 The search program reported an unexpected error condition.

• The file permissions for one or more indexes are improperly set.

  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:

  • All index files and directories should be readable by the imnadm.
  • All index directories should be executable by the imnadm.
  • The index work directory and all files in it should be writable by the imnadm.
  • In the index data directory, the imnadmtb.dat and imniq.dat files should be writable.

• Parts of the indexes are missing or have been corrupted.

  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. 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>

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>

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 ]