Solaris 7 (SPARC Platform Edition) Installation Library

Chapter 8 Accessing Online Documentation

This chapter explains how to install and use the AnswerBook2TM product to browse, search, and print online documentation. It includes the following information:


Note -

The name of this product is Solaris 7 but code and path or package path names may use Solaris 2.7 or SunOS 5.7. Always follow the code or path as it is written.


Introduction to the AnswerBook2 Product

The AnswerBook2 product is the Sun online documentation system. It uses a web-browser interface that lets you view and print a variety of SolarisTM information, including SGML-based AnswerBookTM collections, Display PostScriptTM AnswerBook collections, and man pages.

The AnswerBook2 product provides a search engine that lets you find information throughout the documentation library. You can install document collections on a centralized documentation server or on a local server.


Note -

Throughout the AnswerBook2 documentation, the term AnswerBook1 refers to the version of the AnswerBook product provided with pre-2.6 versions of the Solaris operating environment.


AnswerBook2 Features and Functions

The AnswerBook2 product provides the following features and functions:

New AnswerBook2 Features for This Release

The following list identifies the new or substantially enhanced features provided in this release of the AnswerBook2 software.

Pieces and Parts

The AnswerBook2 product consists of the following elements:

Frequently Asked Questions

This section lists some common questions about the AnswerBook2 product along with answers to those questions.

Where's the Documentation?

The document server software and Solaris 7 document collections are on the Solaris 7 Documentation CD. Figure 8-1 through Figure 8-6 list the specific document collections available and identify those documents that are available only in hard-copy (printed) format.

Figure 8-1 Desktop Documentation

Graphic

Figure 8-2 Reference Documentation (Man Pages)

Graphic

Figure 8-3 System Administration Documentation -- Part 1

Graphic

Figure 8-4 System Administration Documentation -- Part 2

Graphic

Figure 8-5 Developer Documentation -- Part 1

Graphic

Figure 8-6 Developer Documentation -- Part 2

Graphic

Getting Started

To view online documentation using the AnswerBook2 system, you need an HTML 3.2-compatible browser (such as HotJavaTM, Netscape NavigatorTM, or LynxTM), and access to a documentation server (a URL that identifies a machine on which the document collections are installed and which runs a web-based server to deliver them to you). For more information, choose from the following:

For detailed information about using the AnswerBook2 product or administering a documentation server, use the AnswerBook2 Help once you have a documentation server to access.

Do I Need to Install Anything?

The following table indicates what you need to do or install to provide specific AnswerBook2 functionality.

Table 8-1 When and What to Install
 If you want to do this... Then do this...
 View online documentation from your desktop (any platform, any operating environment).Start a web browser and enter the documentation server's URL (for example, http://imaserver:8888/). See "Launching the AnswerBook2 Viewer".
 Automatically launch a web browser with the appropriate server URL from your desktop.If you are running the Solaris 7 operating environment, identify a documentation server and select the AnswerBook2 option from the CDE Help menu or the OpenWindowsTM Programs menu. See "Launching the AnswerBook2 Viewer".
 Enable your system (machine) to deliver (serve) documentation.Install the documentation server software from the Solaris 7 Documentation CD. See "Installing Documentation Server Software".
 Add documentation from the Solaris 7 Documentation CD or other locations to your document server.The document administrator is the only user authorized to perform this function. See "To Install Document Collections Onto the Server".

Launching the AnswerBook2 Viewer

The system launches a web browser with the URL for the document server if you are running the Solaris 2.6 (or later version) operating environment and you either:

The system determines the web browser to launch by searching your path and launching Netscape NavigatorTM or the first web browser it finds. For information on how the system determines the URL for the documentation server, see "Finding a Documentation Server".

You can also access the AnswerBook2 product from any HTML 3.2-compliant web browser. Start your web browser and enter the appropriate documentation server URL. For example, if your system administrator installed an AnswerBook2 documentation server on the system imaserver using the default port number, you would type the URL: http://imaserver:8888/

Viewing Information

Once you have launched the AnswerBook2 viewer, you click on underlined text (depending on how your browser is configured to display its links) to navigate to a book or chapter. For more information about how to navigate through the AnswerBook2 system, see the AnswerBook2 Help.

Finding a Documentation Server

When you launch the AnswerBook2 viewer from the Solaris operating environment, the software displays a list of collections installed on the default documentation server. The default server is identified using the following mechanisms in this sequence:

  1. If you have defined the environment variable AB2_DEFAULTSERVER 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: http://localhost:port

    Where port is the port number on which the documentation server is running and defaults to 8888.

  3. If your document administrator has registered the AnswerBook2 server with FNS (Federated Naming Service), the AnswerBook2 viewer uses the URL of the registered server.

If you have no document servers available and you have Internet access, you can also access Sun's master document server at: http://docs.sun.com/

Installing Documentation Server Software

This section explains the requirements you must meet and decisions you should make before you install the AnswerBook2 server software.

This section applies only to the person who is administering an AnswerBook2 server system. Users who are only viewing online documentation do not need to read this section. There is no specific installation needed to be an AnswerBook2 client.


Note -

There is no client-level access control for this product. If a client machine can access the URL for a documentation server, it can view the documents on that server.


This section contains the following information:

For detailed information about administering a documentation server, use the online Help available from the AnswerBook2 interface once you have installed the documentation server software.

Before Installing Server Software

Before you start the installation process, verify that your system meets the requirements listed in "Hardware and Software Requirements" and decide where you want to install the software as explained in "Installation Choices".

Hardware and Software Requirements

Before you start the installation process, verify that the systems on which you plan to install AnswerBook2 server software meet the hardware and software requirements listed in Table 8-2 and Table 8-3.

Table 8-2 Hardware and Software Requirements

Component 

Requirement 

Documentation server system hardware 

SPARCstationTM 2 computer or higher (SPARCstation 5 computer recommended)

Intel-based personal computer 

Operating environment 

Solaris 7 (for SPARC or x86, as appropriate) 

Admin GUI and AnswerBook2 client viewer 

Any HTML 3.2-compliant browser, such as Netscape Navigator, HotJava, or Lynx 

Table 8-3 Disk Space Requirements Table

Directory Path 

Description 

Space 

/usr/lib/ab2/

Contains executable files, server processing files, library files, and graphics and document source files for the product interface. 

26.0 Megabytes 

/var/log/ab2/

Contains catalog files and log files, if logging functions are enabled. 

5.0 Megabytes (recommended - grows as server is used) 

/etc/init.d/ab2mgr

Server start-up file 

0.01 Megabytes 

In addition, you need to set aside some amount of disk space (600 Megabytes recommended) for the actual book files. The exact amount of space depends on the specific collections. For a list of collections available on the Solaris 7 Documentation CD, see the README file located on that CD.

Installation Choices

Before you install the AnswerBook2 server software, you should consider your installation choices:

To Install the AnswerBook2 Server Software

To install documentation server software, you can use the point-and-click interface available from the Solaris Web StartTM utility, or you can use standard installation utilities, such as pkgadd .

  1. Insert the Solaris 7 Documentation CD into your CD-ROM drive.

    The Volume Manager should automatically mount the CD.

  2. If you choose to use the Solaris Web Start utility to install your products, double-click on the installer icon, follow the instructions on the Web Start screens, and go to Step 6.

    The Web Start utility provides pre-selected groups of packages for you to install. Follow the instructions on the Web Start screens to continue.

  3. If you choose to use the pkgadd utility or the swmtool utility, log in as superuser on the documentation server machine.

    For example, enter the following at the command line:


    % su -
    
  4. Change directory to the location of the documentation server packages.

    For example, you might enter a command similar to the following to go to the location of the server software packages for a SPARC server:


    # cd cdrom/Solaris_2.7_Doc/sparc/Product/
    

    Where cdrom is the mount-point for the CD-ROM device and defaults to: /cdrom/sol_2_7_doc

  5. Launch the installation utility and select the server software packages.

    For example, use the following command to launch the pkgadd utility:


    # pkgadd -d .
    

    Select these server software packages:

    • SUNWab2r (0.25 Megabytes) - Installs in root partition and provides configuration and start-up files.

    • SUNWab2s (1.00 Megabytes) - Provides shared files for performing document processing.

    • SUNWab2u (26.00 Megabytes) - Provides executable and back-end processing files for server and administration functions.

  6. Start up the server, if needed.

    Installing the packages should cause the server to start up on the default port of 8888. If it does not start, use the following command to start it:


    # /usr/lib/ab2/bin/ab2admin -o start
    

  7. Install the book collections.

    Your documentation server cannot do its job if no documents are installed for it to serve. You can install collections from the Solaris 7 Documentation CD or from other locations, such as existing document collections or collections that come on other CDs. For more information about installing document collections, see "To Install Document Collections Onto the Server".

  8. (Optional) Change configuration files and create links to run the documentation server as a CGI process on an existing httpd server.

    If you already run an httpd server on your system, yo u can run the documentation server as a CGI process on that server. You must ins tall the standard documentation server software, then change several configurati on files and create links to run the documentation server as a CGI process. For more information, see "Running the AnswerBook2 Server as a CGI Process".

  9. (Optional) Register the server.

    If you want other users to automatically find your documentation server through Federated Naming Service (FNS), you need to register the server. To register your server, use the following command:


    # /usr/lib/ab2/bin/ab2regsvr server_url
    

    Where server_url is the fully qualified URL to get to this server (for example: http://imaserver.eng.sun.com:8888/). See "Registering the Server" for more information.

To Install Document Collections Onto the Server

Your documentation server cannot do its job if no documents are installed for it to serve. You can install collections from the Solaris 7 Documentation CD or from other locations, such as existing document collections or collections that come on other CDs.

To install document collection packages from the Solaris 7 Documentation CD, you can use the point-and-click interface available from the Solaris Web Start utility, or you can use standard installation utilities, such as pkgadd . To install document collections:

  1. Insert the Solaris 7 Documentation CD into your CD-ROM drive.

    The Volume Manager should automatically mount the CD.

  2. If you choose to use the Solaris Web Start utility to install your products, double-click on the installer icon, follow the instructions on the Web Start screens, and go to Step 6.

    The Web Start utility provides pre-selected groups of packages for you to install. Follow the instructions on the Web Start screens to continue.

  3. If you choose to use the pkgadd utility or the swmtool utility, log in as superuser on the documentation server machine.

    For example, enter the following at the command line:


    % su -
    
  4. Change directory to the location of the document collection packages.

    For example:


    # cd cdrom/Solaris_2.7_Doc/common/Product/
    

    Where cdrom is the mount-point for the CD-ROM device and defaults to /cdrom/sol_2_7_doc.

  5. Launch the installation utility and select document collection packages to install.

    For example, to launch the pkgadd utility:


    # pkgadd -d .
    

    For a detailed list of document collections included on the Solaris 7 Documentation CD, see the README file located on that CD.

  6. The document collection packages included on the Solaris 7 Documentation CD include a post-install script that add the collections to the server's database and restart the server.

    If you install collection packages from any other location besides the Solaris 7 Documentation CD, you might need to use either the Admin GUI's Add Collection to List function or the ab2admin -o add_coll command to add these collections to the documentation server's database.

    If you have document collections already installed on your system, you can use either the Admin GUI's Scan for Locally Installed Collections function or the ab2admin -o scan command to have them found and added to the documentation server's database. This function only works for locally-installed packages.

    To serve document collections located on some other system, use the Add Collection to List function or the ab2admin -o add_coll command and provide the full path name to the ab_cardcatalog or collinfo file. For example, if the documentation server is imaserver and you want it to serve document collections located on the system elsewhere, you might use the following command:


    # /usr/lib/ab2/bin/ab2admin -o add_coll -d /net/elsewhere/books/SUNWdtad/collinfo
    

Registering the Server

To give users the ability to locate your documentation server without knowing the URL, you can register the name of your server with the FNS system. Users can still access unregistered documentation servers if they know the URL.

How you register your server depends on two things:

Registering Your Server Using the ab2regsvr Command

To register your server, use the ab2regsvr command. The ab2regsvr command looks at your system's configuration and sets up the appropriate name space for your server.

To register your server, type:


# /usr/lib/ab2/bin/ab2regsvr server_url

Where server_url is the fully qualified URL to get to this server (for example: http://imaserver.eng.sun.com:8888/).

The ab2regsvr command also provides some other options you might find useful:

For more information about the ab2regsvr command, see the ab2regsvr(1m) man page.

Registering Your Server Using Standard FNS Commands

If you want to use FNS commands to register your server and you already have FNS installed at your location, use the following command to register the specified URL as a documentation server for your organization (domain):


# fnbind -r thisorgunit/server/answerbook2 onc_answerbook2 \
onc_addr_answerbook2 server_url

Where server_url is the fully qualified URL to get to this server (for example: http://imaserver.eng.sun.com:8888/).

To find out what servers are currently registered, use the following command:


% fnlookup -v thisorgunit/service/answerbook2

This returns a list of registered servers that looks similar to the following:


Reference type: onc_answerbook2
Address type: onc_addr_answerbook2
  length: 19
  data: 0x68 0x74 0x74 0x70 0x3a 0x2f 0x2f 0x61 0x6e 0x73  http://ans
        0x77 0x65 0x72 0x73 0x3a 0x38 0x38 0x38 0x38       wers:8888

In this example, the registered server is http://answers:8888/.

If you get a response similar to the following, then no documentation servers are registered with FNS:


Lookup of 'thisorgunit/service/answerbook2' failed: \
Name Not Found: 'answerbook2'

For more information about FNS, including how to install it, see the FNS documentation.

Name Services and AnswerBook2 Users

Rather than using the described name services to find a documentation server, the user can define a default AnswerBook2 server using the environment variable AB2_DEFAULTSERVER. For example, the user could have the following line in the .cshrc file:


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

If the user has not defined an environment variable, when the user launches the AnswerBook2 product from the desktop, the product looks to see if the system from which it was launched is running a documentation server. If so, it launches using the URL: http://localhost:port, where port defaults to 8888.

If the user has not defined an environment variable and the current system is not a documentation server, when the user launches AnswerBook2 from the desktop, the system performs an fnlookup thisorgunit/service/answerbook2 command to find out what documentation servers are available. It then chooses one of those servers and launches the AnswerBook2 browser using that server name for the URL.

To Run a Documentation Server From the Solaris 7 Documentation CD

  1. Insert the Solaris 7 Documentation CD into your CD-ROM drive.

  2. Make sure you are logged in as superuser.


    % su -
    
  3. Change the directory to (or bring up and go to) the top level of the CD-ROM volume.

    This should look similar to the following location:


    /cdrom/sol_2_7_doc/

    This directory contains one directory, a README file, the installer utility, and the ab2cd script. Use the ab2cd script to run the documentation server directly from the CD.

  4. Type the following command:


    # ./ab2cd
    
  5. Access the documentation server using the URL:


    http://server:8888/
    

    Where server is the name of the machine to which the CD-ROM drive is attached.

    Note that a documentation server run from the CD always runs on port 8888.

  6. (Optional) If document collections are installed already on your server machine and you want the CD-driven server software to recognize those collections, use the following command: .


    # ab2cd -s
    

    This form of the command causes the CD-driven server software to look for other collections installed on this system and add them to its database.

  7. To stop running the server from the CD, type:


    # /cdrom/sol_2_7_doc/ab2cd stop
    

Caution - Caution -

Running the documentation server directly from the CD tends to be slow. Do not use this approach if you expect other users to access this documentation server.


Important Notes When Running the AnswerBook2 Server From the CD

Keep these things in mind when you run the server from the CD:

Notes About Running Two Servers

To run two AnswerBook2 servers (one on your system, one from the CD), keep these rules in mind:

Running the AnswerBook2 Server as a CGI Process

By default, the AnswerBook2 documentation server runs as an NSAPI plug-in on top of the httpd server that is included in the SUNWab2u package. Because the AnswerBook2 server complies with standard web protocols, you can choose to run the documentation server as a CGI (Common Gateway Interface) process on top of some other web server already on your system (for example, Netscape Server or Sun Web Server).

Be aware that the following functions will not work if you change from the default AnswerBook2 web server:

You will need to use your server's start and stop functions instead.

To Change To a CGI-based Server

Because specific details differ by web server, this procedure describes the general steps you need to follow to use a CGI-based web server rather than the default (NSAPI plug-in) server. Specific examples are included below for Sun Web Server and Netscape Server.

  1. Shut down the AnswerBook2 server if it is running.

    Use one of the following commands:


    # /usr/lib/ab2/bin/ab2admin -o stop
    # /etc/init.d/ab2mgr stop
    
  2. Edit your web server's configuration file and make icons available.

    Your web server's documentation should explain specific details, such as where to find the configuration file. The entry /icons/ should point to /usr/lib/ab2/data/docs/icons/.

    If /icons/ is already being used, link all files in /usr/lib/ab2/data/docs/icons/ to the existing /icons/ directory.

  3. Link AnswerBook2 Help documents to the current documentation root directory.

    Go to your web server's documentation root directory and create a soft link to /usr/lib/ab2/data/docs/.

  4. Make AnswerBook2 cgi-bin files available to your server.

    Go to your web server's cgi-bin directory and create soft links to the following:


    /usr/lib/ab2/bin/cgi/admin
    /usr/lib/ab2/bin/cgi/nph-dweb
    /usr/lib/ab2/bin/cgi/gettransbitmap
    /usr/lib/ab2/bin/cgi/getepsf
    /usr/lib/ab2/bin/cgi/getframe
    /usr/lib/ab2/bin/cgi/ab2srwrap
  5. Edit your web server's configuration file and map /ab2/ to call AnswerBook2 cgi.

    Your web server's documentation should explain specific details, such as where to find the configuration file. You need to change the entry for /ab2/ to /usr/lib/ab2/bin/cgi/nph-dweb/ab2/.

  6. Edit the AnswerBook2 administration configuration file.

    You need to edit the /usr/lib/ab2/bin/cgi/nph-dweb file and change the entries for servertype, errorlog, and accesslog.

To Run an AnswerBook2 Server as a CGI Process on Sun WebServer

By default, the Sun Web Server configuration file is /etc/http/httpd.conf and files are in /var/http/demo/. If you did not install in the default location (/usr/), all paths that begin /usr/lib/ab2/ should be the path where you installed the files (for example, /usr2/lib/ab2/).

  1. Edit the /etc/http/httpd.conf file and put the following line in the server section of the file:


    map /icons /usr/lib/ab2/data/docs/icons

    When you have made this change, use the following command to restart the SWS server:


    # /etc/init.d/httpd start
    

    To verify your changes, enter the following URL in your web browser to see a Help icon:


    http://localhost:port/icons/ab2_help.gif
    

    Where port is the port number on which your documentation server is running and defaults to 8888.

  2. Go to the /var/http/demo/public/ directory and put in the following soft link:


    # ln -s /usr/lib/ab2/data/docs/Help Help
    

    To verify your changes, enter the following URL in your web browser to see a Help icon:


    http://localhost:port/Help/C/Help/books/Help/figures/ab2_help.gif
    

    Where port is the port number on which your documentation server is running and defaults to 8888.

  3. Go to the /var/http/demo/cgi-bin/ directory and create the following soft links:


    # ln -s /usr/lib/ab2/bin/cgi/admin
    # ln -s /usr/lib/ab2/bin/cgi/nph-dweb
    # ln -s /usr/lib/ab2/bin/cgi/gettransbitmap
    # ln -s /usr/lib/ab2/bin/cgi/getepsf
    # ln -s /usr/lib/ab2/bin/cgi/getframe
    # ln -s /usr/lib/ab2/bin/cgi/ab2srwrap

    To verify your changes, enter the following URL in your web browser to see the AnswerBook2 library page:


    http://localhost:port/cgi-bin/nph-dweb/ab2
    

    Where port is the port number on which your documentation server is running and defaults to 8888.

  4. Edit the /etc/http/httpd.conf file and add the following entry in the host section of the file:


    map /ab2 /var/http/demo/cgi-bin/nph-dweb/ab2 cgi

    Restart the SWS server using the following command:


    # /etc/init.d/httpd start
    

    To verify your changes, enter the following URL in your web browser to see the AnswerBook2 library page:


    http://localhost:port/ab2
    

    Where port is the port number on which your documentation server is running and defaults to 8888.

  5. Edit the /usr/lib/ab2/bin/cgi/nph-dweb file and change the following entries:


    setenv servertype sws
    setenv errorlog
    setenv accesslog /var/http/logs/http.elf.1
To Run an AnswerBook2 Server as a CGI Process on Netscape Server

For this example, the Netscape Server configuration file is /ul/netscape/suitespot/httpd-threads1/config/obj.conf and files are in /ul/netscape/suitespot/docs/. If you did not install in the default location (/usr/), all paths that begin /usr/lib/ab2/ should be the path where you installed the files (for example, /usr2/lib/ab2/).

  1. Edit the /ul/netscape/suitespot/httpd-threads1/config/obj.conf file and add the following line:


    NameTrans fn="pfx2dir" from="/icons" dir="/usr/lib/ab2/data/docs/icons"

    To verify your changes, restart the Netscape Server. Then, enter the following URL in your web browser to see a Help icon:


    http://localhost:port/icons/ab2_help.gif
    
  2. Go to the /ul/netscape/suitespot/docs/ directory and put in the following soft link:


    # ln -s /usr/lib/ab2/data/docs/Help Help
    

    To verify your changes, enter the following URL in your web browser to see a Help icon:


    http://localhost:port/Help/C/Help/books/Help/figures/ab2_help.gif
    

    Where port is the port number on which your documentation server is running and defaults to 8888.

  3. Go to the /ul/netscape/suitespot/cgi-bin/ directory and create the following soft links:


    # ln -s /usr/lib/ab2/bin/cgi/admin
    # ln -s /usr/lib/ab2/bin/cgi/nph-dweb
    # ln -s /usr/lib/ab2/bin/cgi/gettransbitmap
    # ln -s /usr/lib/ab2/bin/cgi/getepsf
    # ln -s /usr/lib/ab2/bin/cgi/getframe
    # ln -s /usr/lib/ab2/bin/cgi/ab2srwrap
    

    To verify your changes, enter the following URL in your web browser to see the AnswerBook2 library page:


    http://localhost:port/cgi-bin/nph-dweb/ab2
    

    Where port is the port number on which your documentation server is running and defaults to 8888.

  4. Edit the /ul/netscape/suitespot/httpd-threads1/config/obj.conf file and add the following entry:


    NameTrans fn="pfx2dir" from="/ab2" 
    dir="/ul/netscape/suitespot/cgi-bin/nph-dweb/ab2" name="cgi"

    To verify your changes, restart the Netscape server and enter the following URL in your web browser to see the AnswerBook2 library page:


    http://localhost:port/ab2
    

    Where port is the port number on which your documentation server is running and defaults to 8888.

  5. Edit the /usr/lib/ab2/bin/cgi/nph-dweb file and change the following entries:


    setenv servertype netscape
    setenv errorlog /ul/netscape/suitespot/httpd-threads1/logs/errors
    setenv accesslog /ul/netscape/suitespot/httpd-threads1/logs/access

Solving AnswerBook2 Problems

Table 8-4 lists some areas of known confusion in the AnswerBook2 product and provides suggestions for how to respond to them.

Table 8-4 Possible Server Problems

For this issue... 

Consider this... 

See also... 

Browser proxy error

Edit the /usr/lib/ab2/dweb/data/config/dwhttpd.cfg file and change the host name to hostname.domain.

For example, instead of the following line:


set ServerHost imaserver ;#
Use this line:

set ServerHost imaserver.eng.sun.com ;#
Then, restart the documentation server.

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

Browser errors indicating documentation server is not responding

If the documentation server is not responding, restart it. 

For information on stopping and starting the server, see the AnswerBook2 Help. 

Error 404, File not Found when trying to access the documentation server

A server process is running, however the server software has been removed. Reinstall the server software.

For information on installing the software, see "Installing Documentation Server Software".

User indicates that library page displays only the navigation bar and no document collections

Verify that the collections template file (/usr/lib/ab2/dweb/data/config/ab2_collections.template) does not contain any empty or duplicate entries.

If fixing the template file does not correct the problem, you might need to reinstall document collections or server software. For information about installing the software, see "To Install the AnswerBook2 Server Software".

User reports seeing red text and the word "BUG" in a book (or several books) 

The book's source contains markup tags that AnswerBook2 does not recognize and the AB2_DEBUG environment variable is set to "1" on the server. 

To turn off the bug display, set the AB2_DEBUG environment variable to "0," stop the server and start the server.

Contact whoever provided the book to get the markup fixed. 

Unable to access administrative functions on documentation server

The documentation server uses access control mechanisms to identify users who can perform administrative functions. The AnswerBook2 administration tools allow the document administrator for the server machine to add and remove administrative users for the server and change their passwords. 

To add or remove administrative users for your server, see the AnswerBook2 Help. If you need access to another server, contact the document administrator for that server. 

Cannot perform administrative commands from AnswerBook2 Administration GUI (browser interface)

Certain functions do not work from the Admin GUI because of permission issues. Try to perform the same function from the ab2admin command-line interface.

For information about the command line options, see the ab2admin(1m) man page.

A Scan for Locally Installed Collections function does not list document collections that are installed on a local mount point

Verify that the directory into which the collections were installed has read access set for others.

 

You added an AnswerBook1 collection, but users do not see it in their libraries 

Verify that the information in /var/log/ab2/catalog/ab1_cardcatalog is correct.

This means something is wrong with the collection's data in the ab_cardcatalog file.

You see the message Failed to add collection. when trying to add a collection through the Admin GUI

Verify that the path to the collection's collinfo or ab_cardcatalog file is correct.

 

Using the restart command to restart the documentation server failed or did not produce the expected results

In some instances, the restart command does not work correctly.

Use the stop and start commands instead.

Document collections appear to be corrupted and need to be reinstalled 

Use the ab2admin -o del_coll function or Delete Collections from List in the Admin GUI to remove these collections from the documentation server's database.

Then, use pkgrm to remove them from the server before installing the new packages.

For more information about removing collections, see the AnswerBook2 Help.