System Management Guide: Operating System and Devices

Problem Determination

This section contains discussions of two different types of problems:

Note: If you receive an error message when using the documentation search service, and your web browser is using a cache, that error message page is stored in your web browser cache. This means that even if you fix the problem that caused the error, the error message continues to be displayed 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 cache before you retest the search after you have done a fix. Usually, there is a clear cache function in the Options screen of the browser.

Problems That Don't Generate Error Messages

When the search form is displayed it is not in the correct language.
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 provides the search form in Spanish. Look at the Search link and see if it is specifying a language.
The web server software might not be reading the locale value correctly. Try restarting your web server to see if it picks up the correct locale.

Error Message Listings

ds_form: Error
```
There was a request to open a viewset named 'XXX'. Either there is no viewset
named 'XXX', or there is no configuration file named '/usr/docsearch/views
/<locale>/XXX/config' for the viewset. 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 a viewset name and that viewset does not exist or is not readable by the user imnadm.
In this message XXX indicates the name of the viewset. If the viewset given in the message does not match the name of the desired viewset, edit the HTML link being used to call the search form and change the viewset given.

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. They may want to try restarting the search program.

This error occurs if the search engine is not running.

To start the search engine, you must be root or a member of the group imnadm. To start the search engine type:

itess -start search

ds_form: Error
```
The search page is not available in the requested language 'xx_XX'.
```
This error occurs if the CGIs are passed a language for which the documentation server does not have the locale installed.
In this message xx_XX is the language for which there was no locale installed. If it is available, the locale for the language can be installed. Otherwise, specify a language for which there is a locale installed by using the lang parameter.
ds_form: Error EhwSearch 77
```
An error occurred when attempting to open or read an index file.
Contact the system administrator of the search server computer.
```
This error occurs if the file permissions for an index are incorrectly set on files or directories that are part of that index.
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 adhere to the following rules:
- All index files and directories are readable by the user imnadm.
- The work directory and all files in it are writable by the user imnadm.
- In the data directory the iteadmtb.dat and iteiq.dat files are writable.
- All index files and directories have imnadm as owner and group.
ds_rslt: Error EhwSearch 32
```
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 incorrectly 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
```
- All index files and directories are readable by the user imnadm.
- The work directory and all files in it are writable by the user imnadm.
- In the data directory the iteadmtb.dat and iteiq.dat files are writable.
- All index files and directories have imnadm as owner and group.

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 indexname
 
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 itectrix command by typing:

/usr/IMNSearch/bin/itectrix -s server -x indexname -reset

ds_rslt: Error EhwSearch 76
```
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 itectrix command by typing:
```
/usr/IMNSearch/bin/itectrix -s server -x indexname -reset
```
Cannot run ds_form
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 might say something like:
```
ds_form is not an executable
```
or
```
Cannot locate ds_form
```
The web server software cannot find the search service ds_form CGI program because the server has not been configured correctly. See Changing the Configuration of the Documentation Library Service to make sure that the Documentation Library Service is installed and configured correctly on the server computer.