test

Information Library for Solaris 2.6 (Intel Platform Edition)

Installing Server Software

Caution - Caution -

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.