Running a Documentation Server from the CD

To run a documentation server directly 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 super-user.

   % su -

3. Change 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. Run the following command:

   # ./ab2cd

5. Access the documentation server using the following 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 this 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, enter the following command:

   # /cdrom/sol_2_7_doc/ab2cd stop

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

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

• The AnswerBook2 server always runs on port 8888 when run from the CD. If you already have an AnswerBook2 server running on your system using the default port (8888), the ab2cd script will display the following message:

  
  
  
  A document server is already running on this system as server:8888.
  
  
  
  
  
  Please shut down the current server before running the ab2cd command.
  
  
  

  Use the following command to shut down the existing server:

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

• Always use ab2cd stop to stop the server running from the CD. Do not use /etc/init.d/ab2mgr stop to stop the CD-based server.

  The ab2cd stop command stops the AnswerBook2 server process and cleans up all files in the /tmp/ab2 and /tmp/ab2cd_config directories. The /etc/init.d/ab2mgr stop command stops all server processes, but does not clean up the files in the /tmp/ab2 and /tmp/ab2cd_config directories.

Running a Server from the CD and a Server on your System

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

• Starting up the server

  • The /etc/init.d/ab2mgr start command always starts the server on your system.

  • The ab2cd command always starts the server from the CD.

• Shutting down the server

  • Always use the ab2cd stop command to stop the server running from the CD.

  • To stop both servers, first use the ab2cd stop command to stop the server running from the CD, then use either /etc/init.d/ab2mgr stop or /usr/lib/ab2/bin/ab2admin -o stop to stop the server running on your system.