test

Viewing Online Documentation Using the AnswerBook2 System

Chapter 7 Solving AnswerBook2 Problems

This section explains how to solve known problems with the AnswerBook2 product and includes the following:

Functional Errors

This section lists problems you might encounter when viewing online documentation.

Table 7-1 Possible Functional Problems

If you see this... 

Try this... 

See also... 

Browser proxy error

Contact your document administrator to find out if the documentation server you are trying to access is set up correctly. 

If the problem persists, try turning off the proxies on your web browser. 

Error message when launching AnswerBook2 from the CDE front panel

If you do not have an HTML 3.2-compliant web browser on your system, install the browser from the Solaris product CD and try again. If you launch a browser, but it cannot find a documentation server, you need to find a valid URL for the documentation server and use your browser's normal functions to go to that URL. The URL for a documentation server is typically http://server_name:8888/, for example http://imaserver:8888/

If you do not have a local documentation server, but have Internet access, you can view all released Solaris documentation at http://docs.sun.com

Problems using the AnswerBook2 printing function 

Set up the application/postscript mime type in your browser to print to a file or directly to a printer.

For more information about the AnswerBook2 printing function, see Chapter 6, Printing AnswerBook2 Documents.

Unrecognized characters on the library page 

Either change your language preference or change the language encoding in your browser. 

For more information about defining language preferences, see "Specifying a Language" and "Specifying Language Encoding".

A document collection that you are certain exists is not listed on the library page 

Check your Personal Library definition to see if it includes the "missing" collection. 

For information on defining your Personal Library, see "Defining Your Personal Library".

TCL script exception messages when trying to view a book

If you see a TCL script exception message, this means that something is wrong with the book you are trying to view. 

Ask whoever provided the book source for a fixed version of the book. 

Browser errors indicating documentation server is not responding

Wait a few minutes and try to access the server again. This error usually means the server is down or busy. 

If the problem persists, contact the document administrator for the documentation server. 

You cannot access functions for defining your personal library or language preferences 

Your browser does not support cookies or you have turned off cookie support in your browser.

Contact your browser's support center. 

Library or language preferences, although set, do not appear to be active 

Your browser does not support persistent cookies.

Contact your browser's support center. 

Library page (http://server:8888/ab2/) displays the navigation bar, but no document collections

Click on the Reload button on your web browser's button panel in case the page did not load correctly or has not finished loading yet. To ensure the page reloads from the server rather than from the web browser's cache, hold down the Shift key while clicking on the Reload button.

Contact the document administrator for the documentation server. 

While looking through a book, you see text displayed in red with the word "BUG" 

The document source for this book contains unrecognized markup information. 

Contact the document administrator for the documentation server. 

Unable to access administrative functions on documentation server

Only authorized administrative users can access these functions. 

If you need access, contact the document administrator for the server. 

Error Messages

This section lists AnswerBook2 error messages and how to respond to them.

No AnswerBook2 documentation server was found.

An attempt to use the answerbook2 script or launch the client viewer from the CDE front panel failed because there is no default documentation server defined.

The client viewer uses the following approach to finding a default documentation server:

  1. If the AB2_DEFAULTSERVER environment variable is defined, the AnswerBook2 viewer launches using the URL defined by that variable. For example, you might have the following line in your .cshrc file:


    setenv AB2_DEFAULTSERVER http://imaserver.eng.sun.com:8888/

  2. If the machine from which you initiated the AnswerBook2 function is a documentation server, the AnswerBook2 viewer launches using the URL: localhost:port, where port defaults to 8888.

  3. If an AnswerBook2 server is registered with FNS (Federated Naming Service), the AnswerBook2 viewer uses the URL of the registered server.

Cannot find local AnswerBook2 server to administer.

An attempt to use the answerbook2_admin script or launch the Admin GUI from the CDE front panel failed because there is no documentation server on this system.

Do one of the following to administer the AnswerBook2 server:

  • Log in on the system on which the documentation server software is installed and try again.

    Enter the URL for the documentation server you want to administer in your browser.