Installing Document Server Software

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

There is no specific installation needed to be an AnswerBook2 client. Only the person who wants to serve documentation needs to read this section.

Be aware that there is no client-level access control for this product. If a client machine can access the URL for your document server, it can view the documents on that server.

For the Beta Refresh release, the browser-based installation tool does not support installing the document server software, although it does support installing the document collections. To have your system function as a document server, follow the instructions in this section.

This section contains the following information:

• "Before Installing Server Software"

• "Installing Server Software"

• "Registering the Server"

• "Name Services and AnswerBook2"

For detailed information about administering a document server, use the online help available from the AnswerBook2 interface once you have installed the document 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 system(s) on which you plan to install AnswerBook2 server software meet the hardware and software requirements listed in Table 9-2 and Table 9-3.

In addition, you need to set aside some amount of disk space for the actual book files. The exact amount of space depends on the specific collections.

Installation Choices

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

• Install Everything on One System

  The AnswerBook2 server software and documentation collections are on the Solaris 2.6 Documentation CD. If you install both parts of the server product on a single system, when you finish the installation process and start the server, it will be ready to serve documents to all clients. See "Installing Server Software" for more information.

• Install Server and Documentation on Separate Systems

  You can install the document server software on one system and point to document collections that are physically located on a different system. You might want to do this if you have minimal space available on your server's system or if you have existing collections location on another system. If you do this, you will need to manually add each collection to the server's database and the Scan for Locally Installed Collections function will not find these collections. See "Installing Server Software" for more information.

• Run from the CD

  If you are operating in a non-networked environment (stand-alone) or you only occassionally view the online documentation, you can run the AnswerBook2 server directly from the Solaris 2.6 Documentation CD. To run the server directly from the CD:

  1. Make sure you are logged in as root. % su -

  2. Change directory to, or bring up file manager and go to, the following location: /cdrom/Solaris_2.6_Doc/

     This directory contains three directories and one executable script (ab2_cd).

  3. Run the following command:./ab2_cd

  4. Access the document server using the following URL:http://localhost:8888

     where localhost is the name of the machine to which the CD is attached.

  5. To stop running the server from the CD, run the following command: /cdrom/Solaris_2.6_Doc/ab2_cd stop

  ---

  Caution -

  Be aware that running the document server directly from the CD is slow. Thus, it is not recommended that you use this approach if you expect other users to access this document server.

  ---

Installing Server Software

Due to changes in document collections and server software since the Solaris 2.6 Beta release, you should remove any 2.6 Beta document collection packages from the document server before you install new document server software or document collection packages.

Use the ab2admin -o del_coll function or Delete Collections from List in the Admin GUI to remove these collections from the document server's database. Then, use pkgrm to remove them from the server before installing the new packages.

To install the AnswerBook2 server software, perform the following steps:

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

2. Log in as root on the document server machine and change directory to the location of the installation packages.

   For example, the path to the server software packages for a SPARC server might look like the following:

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

   where cdrom is the mount-point for the CD-ROM device.

3. Use the pkgadd utility or the swmtool utility and select the following server software packages:

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

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

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

   ---

   Note -

   To install the server packages into a non-default directory, use the following command: # pkgadd -d . -a none. This causes the pkgadd utility to prompt you for the directory into which you want the software installed.

   ---

4. 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

5. Install the book collections.

   Your document server cannot do its job if no documents are installed for it to serve. You can install collections from the Solaris 2.6 Documentation CD or from other locations, such as existing document collections or collections that come with other products. Table 9-4 lists the document collections available on the Solaris 2.6 Documentation CD.

   Table 9-4 Solaris 2.6 Documentation CD Book Packages

   Package Name	Collection Title
   SUNWabe	Solaris 2.6 User Collection
   SUNWAxg	Solaris XGL 3.3 AnswerBook
   SUNWAxi	Solaris XIL 1.3 AnswerBook
   SUNWapex	PEX AnswerBook
   SUNWaman	Reference Manual AnswerBook
   SUNWabsdk	Solaris 2.6 Software Developer Collection Vol 1
   SUNWaadm	Solaris 2.6 System Administrator Collection
   SUNWakcs	KCMS AnswerBook
   SUNWdtad	Solaris Common Desktop Environment Developer AnswerBook
   SUNWabdev	Solaris 2.6 Software Developer AnswerBook Vol 2

   1. Use the pkgadd utility or the swmtool utility to install new book collections onto your server.

      The document collection packages are located in the following directory on the Solaris 2.6 Documentation CD:

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

      If you install document collection packages from this CD, the collections are automatically added to the document server's database during the pkgadd process. If you install collection packages from any other location, you 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 document server's database.

   2. If collection packages are already installed on your system, you can use the server's Scan for Locally Installed Collections function or the ab2admin -o scan command to have them automatically found and added to the server's document 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 document server is imayoyo and you want it to serve document collections located on the system elsewhere, you might use the following command: ab2admin -o add_coll -d /net/elsewhere/books/SUNWdtad

6. (Optional) Register the server.

   If you want other users to automatically find your document server through Federated Naming Services (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: imayoyo.eng.sun.com:8888). See "Registering the Server" for more information.

Registering the Server

To include your document server in a pool of servers for a site, or to give users the ability to choose from several document servers, you can register the name of your server with the Federated Naming Services system. Users can still access unregistered document servers if they know the URL.

To register your server, use the ab2regsvr command. The ab2regsvr command looks at your system's configuration and, depending on the naming service you are using, sets up the appropriate name space for your 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: imayoyo.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 answers:8888.

If you get a response similar to the following, then no document servers are registered.

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

Name Services and AnswerBook2

In the Solaris environment, the primary name services are:

• NIS+ (Network Information Service Plus)

  NIS+ is the primary name service used for Solaris 2.6 and is a redesigned version of NIS that takes into account recent changes in client/server environments. NIS+ was introduced in the SunOS 5.0 (Solaris 2.0) release. If your system is using NIS+, you can run ab2regsvr on the document server system. It creates an entry like this: thisorgunit/service/answerbook2.

• NIS (Network Information Service)

  NIS was the standard name service provided in SunOS 4.x (Solaris 1.x) environments. If your system is using NIS, you must contact your NIS administrator and have that person run ab2regsvr on the NIS master system to set up the name space for AnswerBook2 servers.

• File System

  If a user chooses not to run either NIS or NIS+, the AnswerBook2 product also works with a file-system defined naming system in which all names are manually entered into data files. In this instance, these files would be stored in the directory /var/fn. The server would need to export this directory and any clients that wanted to access documents on this server would need to mount this directory.

Rather than using the described name services to find a document 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://imayoyo.eng.sun.com:8888

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