Installing and Administering an AnswerBook2 Server

AnswerBook2 Error Messages

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

Cannot find local AnswerBook2 server to administer.

What it means: 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.

How to respond: Either go to the system where the documentation server is and use the same procedure or enter the URL for the documentation server you want to administer in your browser.

No AnswerBook2 documentation server was found.

What it means: 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.

How to respond: 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 attempts to access the URL: http://localhost:8888

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

AnswerBook2 server software not found at path %s.

What it means: An attempt to launch the ab2cd script failed because the path given was not valid.

How to respond: Make sure you type the command from the directory where the ab2cd script is or that you enter the complete path to the ab2cd script.

Architecture not supported: %s.

What it means: You tried to run the ab2cd script from a system it does not support.

How to respond: The documentation server software requires the Solaris 7 operating environment running on either a SPARC or Intel-based system.

ab2cd does not support the locale %s.

What it means: You tried to run the ab2cd script from a system that is set to an unsupported locale or encoding.

How to respond: The documentation server software supports the following locales and encodings: C, en_*, es, es_*, fr, fr_*, it, it_*, sv, sv_*, de, de_*, ja, japanese, ja_JP.PCK, ko, zh, zh_TW, zh_TW.BIG5, and *[Uu][Tt][Ff]-8*.

Authentication failed, try again.

What it means: An administrative user mis-typed the administrative password.

How to respond: Re-type the password. If it fails again, make sure you are trying to administer the server for which this administrator and password are valid.

Missing required options.

What it means: An ab2cd command was given, but the correct options were not included.

How to respond: Verify you correctly entered the command and options. For more information about the options, see the ab2cd man page.