test

Trusted Solaris 7 Roadmap

To Install AnswerBook2 Document Collections

You can install collections from the Trusted Solaris 7 Documentation CD, the Solaris 7 Documentation CD, or from other locations. You can install Trusted Solaris collections in either the Trusted Solaris or Solaris environment, and you can also install Solaris collections in the Trusted Solaris environment. This section describes how to install collections on a Trusted Solaris host. For installing the server software from the Solaris Documentation CD in the Solaris environment, see "Accessing Online Documentation" in Solaris 7 (SPARC Platform Edition) Installation Library

The collections do not need to be installed on the same host that is running the document server software. Step 10 tells how to identify collections to the server when they are located on another host.

  1. Assume the administrator role and go to an ADMIN_LOW workspace.

    See "Assuming a Role and Working in a Role Workspace" in Trusted Solaris Administrator's Procedures, if needed.

  2. If installing from a documentation CD, insert the CD into the CD-ROM device and allocate the device.

    See "Device Management Procedures" in Trusted Solaris Administrator's Procedures for how to allocate the device, if needed.

    1. Move the device to the Allocated Devices list.

    2. Insert the Trusted Solaris 7 Documentation CD into the CD-ROM device.

    3. Press RETURN when prompted.


      Press RETURN when cdrom_0 is ready, or ^C to cancel.

    4. Enter y to mount the CD-ROM, when prompted.


      Do you want cdrom_0 mounted (y/n)?  y

    5. Enter RETURN to close the Device Allocation window.


      Press RETURN to quit window.

  3. Change to the directory where the document packages are located.

    If you are installing from the Trusted Solaris documentation CD, use the following path.


    $ cd /cdrom/admin/trusted_sol7_doc/Trusted_Solaris_7_Doc/common/Product

  4. Use the pkgadd(1M) installation utility and select document collection packages to install. 


    $ pkgadd -d .

    For a detailed list of document collections included on the Trusted Solaris 7 Documentation CD, see the README_en.html or README_en.txt file located on the CD.

  5. If installing from the Trusted Solaris Documentation CD, select from the collections shown in the following table. For the contents of the collections see Missing Cross Reference Target (SUNWtab), Missing Cross Reference Target (SUNWtaman), Missing Cross Reference Target (SUNWadac), and Missing Cross Reference Target (SUNWabhdw).

     Collection Name Package Name Size in Megabytes

    Trusted Solaris AnswerBook  

    SUNWtab 

    14.8 

    Trusted Solaris Reference Manual AnswerBook 

    SUNWtaman 

    149 

    Solstice AdminSuite 2.3 AnswerBook 

    SUNWadac 

    3.7 

    Solaris 7 8/99 AnswerBook 

    SUNWabhdw 

    9.6 

  6. Stop and restart the AnswerBook2 server software, either by using ab2mgr or rebooting.

    If the security administrator role added the answerbook2 profile to the administrator role, as described in Step 6, enter the /etc/init.d/ab2mgr start command to stop and start the server. Otherwise, reboot to restart the server.


    $ reboot
/* OR */
$ /etc/init.d/ab2mgr stop
$ /etc/init.d/ab2mgr start

  7. Make sure all collections are available.

    Launch any web browser and enter the name of the host running the server software. If the server is local, enter: http://localhost:8888 in the address field.

    For example, on the Netscape browser, you would enter http://localhost:8888 in the Location field. 


    Location: http://localhost:8888

    All the collections you have installed should display in the browser window.

  8. If installing document collections from another location than the Trusted Solaris Documentation CD, use the following command if the collections are not automatically added to the server's database.


    $ /usr/lib/ab2/bin/ab2admin -o add_coll -d path_to_collection

    Replace path_to_collection with the full path to the location of the collinfo file (for AnswerBook2 collections) or the ab_cardcatalog file (for AnswerBook1 collections).

  9. If the server does not find any collection packages that may be already installed, use the ab2admin -o scan command to locate the collections and have them added to the server's document database.

    This function only works for locally installed packages. 


    $ /usr/lib/ab2/bin/ab2admin -o scan

  10. To serve document collections located on another host, use the ab2admin -o add_coll command and provide the full path name to the ab_cardcatalog or collinfo file.

    For example, if you want the document server to serve document collections located on a host, use the following command, substituting the host's name for hostname: 


    $ ab2admin -o add_coll -d /net/hostname/books/SUNWdtad/collinfo
    Note -

    For the example to work, the other host would need to share the directory with the current host (see share(1M), and the automountd(1M)would need to be running.