Trusted Solaris 8 4/01 Roadmap

Installing and Using the Online Documentation Viewer

This section contains the following topics:

Viewing AnswerBook2 Documents

AnswerBook2 is an online documentation system from Sun Microsystems, Inc. It consists of SGML source documentation and AnswerBook2 server software. The documents can be viewed using any web browser that supports HTML 3.2, by entering the name of the server host, followed by a colon (:) and the port number. For example, to access documentation displayed on a remote documentation server at the default port, enter http://doc_server_name:8888.

For a complete description of AnswerBook2 features, see "Introduction to the AnswerBook2 Product" in Solaris 7 (SPARC Platform Edition) Installation Library or "Introduction to the AnswerBook2 Product" in Solaris 7 (Intel Platform Edition) Installation Library. For information on viewing documentation using AnswerBook2, see "Getting Started" in Solaris 7 (SPARC Platform Edition) Installation Library or "Getting Started" in Solaris 7 (Intel Platform Edition) Installation Library.

AnswerBook2 server software can be installed in either the Solaris or Trusted Solaris operating environment. If the server host is running the Solaris 8 4/01 operating environment, use the version of the AnswerBook2 server software provided on the Solaris 8 4/01 Documentation CD and follow the instructions in "Installing Documentation Server Software" in Solaris 7 (SPARC Platform Edition) Installation Library or "Installing Documentation Server Software" in Solaris 7 (Intel Platform Edition) Installation Library.

If the server host is running in the Trusted Solaris 8 4/01 operating environment, install the AnswerBook2 server software from the Trusted Solaris Documentation CD and follow the instructions in the next section.

To install the Trusted Solaris AnswerBook2 documentation server, you must be running the Trusted Solaris 8 4/01 operating environment on either a SPARCstation 5 or higher or an Intel-based personal computer. You need approximately 36 Megabytes of hard disk space available for the server software plus approximately 55 megabytes for the Trusted Solaris-related collections, and up to 600 megabytes for all available collections.


Note -

You cannot install the AnswerBook packages in the Trusted Solaris environment using WebStart. You cannot run the AnswerBook server or the AnswerBook2 server from the CD.


To Install the AnswerBook2 Server Software


Caution - Caution -

You cannot install the server software from the Solaris Documentation CD in the Trusted Solaris environment or install the server software from the Trusted Solaris Documentation CD in the Solaris environment.


In the Trusted Solaris environment, install the AnswerBook2 server software from the Trusted Solaris Documentation CD only. This procedure describes how to install the AnswerBook2 server. For installing the server software from the Solaris Documentation CD in the Solaris environment, see "Accessing Online Documentation" in Solaris 8 4/01 (SPARC Platform Edition) Installation Library.

  1. Assume the system administrator (admin) role and go to an ADMIN_LOW workspace.

    See "Administering Systems in an Administrative Role" in Trusted Solaris Administrator's Procedures, if needed.

  2. Allocate the CD-ROM device With the Device Allocation Manager.

    1. Click the Tools subpanel on the Front Panel, and click the Device Allocation icon.

    2. Move the device to the Allocated Devices list.

    3. Open the CD-ROM device when prompted and insert the Trusted Solaris 8 4/01 Documentation CD.

    4. Click OK to confirm the insertion.

    5. Click OK to mount the CD-ROM.

  3. Open a terminal and change to the directory where the documentation server packages are located.

    Use the following path on a SPARC system:


    $ cd /cdrom/trusted_sol_8_doc/Solaris_8_Doc/sparc/Product
    

    Use the following path on an Intel architecture system:


    $ cd /cdrom/trusted_sol_8_doc/Solaris_8_Doc/i386/Product
    
  4. Run pkgadd(1M) and select the three server software packages.


    $ pkgadd -d .
    

    Select these server software packages:

    • SUNWab2r - Installs in root partition and provides configuration and start-up files.

    • SUNWab2s - Provides shared files for performing document processing.

    • SUNWab2u - Provides executable and back-end processing files for server and administration functions.

  5. Using the Device Allocation Manager, deallocate the CD-ROM, remove the CD, and click OK to dismiss the dialog.

  6. Install the document collections as described in "To Install AnswerBook2 Document Collections".

    You will reboot the system after the document collections are installed.

To Install AnswerBook2 Document Collections

You can install collections from the Trusted Solaris 8 4/01 Documentation CD, the Solaris 8 4/01 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 8 4/01 (SPARC Platform Edition) Installation Library.

  1. Assume the system administrator (admin) role and go to an ADMIN_LOW workspace.

  2. If installing from a documentation CD, insert the CD into the CD-ROM device and allocate the device as described in the previous section.

  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/trusted_sol8_doc/Solaris_8_Doc/common/Product
    

    If you are installing from the Solaris 8 Documentation CD, use the following path.


    $ cd /cdrom/sol_8_doc/Solaris_8_Doc/common/Product
    
  4. Use the pkgadd(1M) installation utility.


    $ pkgadd -d .
    
  5. For each documentation CD, select collections to install.

  6. When prompted, answer 2 [heavy] installation, Return for AnswerBook location, and y for superuser capabilities during installation.

  7. Deallocate each CD, as described in Step 5 in "To Install the AnswerBook2 Server Software".

  8. Reboot the system when all collections and the servers have been installed.

  9. Make sure all collections are available.

    Launch any web browser and enter the name of the host running the server software. For example, on the Netscape browser, you would enter http://server_name:8888 in the Location field.


    Location: http://server_name:8888
    

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

CD Contents

The Trusted Solaris 8 4/01 Documentation CD includes the following directories:

The following tables show the contents of the AnswerBook collections included on the Trusted Solaris Documentation CD.

Table 1-1 Trusted Solaris AnswerBook Collection

Package Name/Release Number/Size in Megabytes 

(Part Number) Manual Title 

SUNWtab/175.5/14.8 

(816-1043-10) Trusted Solaris 8 4/01 Release Notes 

(816-1039-10) Trusted Solaris 8 4/01 Roadmap 

(816-1041-10) Trusted Solaris User's Guide 

(816-1047-10) Trusted Solaris Administration Overview 

(816-1048-10) Trusted Solaris Administrator's Procedures 

(816-1040-10) Trusted Solaris Installation and Configuration 

(816-1049-10) Trusted Solaris Audit Administration 

(816-1050-10) Trusted Solaris Label Administration 

(816-1044-10) Trusted Solaris 8 4/01 Transition Guide 

(816-1042-10) Trusted Solaris Developer's Guide 

(816-1051-10) Compartmented Mode Workstation Labeling: Encodings Format 

Table 1-2 Trusted Solaris Reference Manual AnswerBook Collection

Package Name/Release Number/Size in Megabytes 

Manual Title 

SUNWtaman/475.3/14.9 

Man Pages (1), (1B): User Commands 

Man Pages (1M): Maintenance Commands 

Man Pages (2): System Calls 

Man Pages (3), (3BSM), (3C), (3DOOR), (3KSTAT), (3NSL), (3RESOLV), (3RT), (3SECDB), (3SOCKET), (3TSOL): Library Functions 

Man Pages (4): File Formats 

Man Pages (5): Standards, Environments, and Macros 

Man Pages (7), (7D), (7M): Device and Network Interfaces 

Man Pages (9): Device Driver Interfaces 

Man Pages (9F): Kernel Functions for Device Drivers