Solaris Documentation
Important Information

Copyright

This document contains information about installing the SolarisTM 9 12/02 online documentation from the Solaris 9 12/02 Documentation media.

Media Overview and Contents
Reading Information Directly From the Solaris Documentation Media
Using the Installer to Install Book Collections
Using pkgadd to Install Book Collections
Installing Localized Collections in PDF Format
Finding the Right Book

Media Overview and Contents

The Solaris 9 12/02 Documentation media include the Solaris 9 12/02 documentation in HTML and PDF formats for direct viewing from the media or for installation into your own environment and integration with your company's web server. To view the Solaris 9 12/02 documentation in HTML format, use any HTML 3.2-compliant web browser. To view Solaris 9 12/02 online documentation in PDF format, use Adobe® Acrobat or Adobe Acrobat Reader software.

Note: The AnswerBook2TM server software is not needed to read Solaris 9 12/02 online documentation. If you have documentation from previous Solaris releases, continue to use the existing AnswerBook2 server software to read it. If you do not have the AnswerBook2 server software but need it to read existing product documentation, see http://www.sun.com/software/ab2.

The Solaris 9 12/02 Documentation media contains the following:


Reading Information Directly From the Solaris Documentation Media

To read documentation directly from the CD or DVD, perform the following steps:

  1. Insert the Solaris 9 12/02 Documentation media into the appropriate drive.

    The Volume Manager should mount the media automatically.

  2. Change the directory to the top level of the media volume.

    Among other things, this directory contains a table of contents for the documentation located on the media (index.html).

  3. Double-click the index.html icon or load the file into your web browser.

  4. Select the format (HTML or PDF) for the collection that you want to view.


Using the Installer to Install Book Collections

The Documentation media include a point-and-click interface called "installer" that you can use to install documentation collections. The installer is a Web Start utility. You can also use standard utilities, such as pkgadd. See Using pkgadd to Install Book Collections.

To install the document collections using the installer, perform the following steps:

  1. Insert the Solaris 9 12/02 Documentation media into the appropriate drive.

    The Volume Manager should mount the media automatically.

  2. Double-click the installer icon and follow the instructions on the screens.

  3. If you are running CDE (Common Desktop Environment) and you see an Action:Run window that has Options and Argument fields, click OK to close the window.

  4. If you are not already logged in as superuser on the system, type the system's root password when prompted.

  5. Select Default Install or Custom Install, then click Next to continue.

    Default Install installs all document collections on the media in HTML format for your default locale. Custom Install enables you to install specific collections or collections in PDF format.

    You can follow the progress of the installation through the status bar.

  6. To view the installed collections, launch an HTML 3.2-compliant web browser, such as Netscape NavigatorTM, and open the /var/opt/sun_docs/sundocs.html file.


Using pkgadd to Install Book Collections

To install document collection packages from the Solaris 9 12/02 Documentation media using the pkgadd utility:

  1. Log in as superuser on the documentation server machine.

  2. Insert the Solaris 9 12/02 Documentation media into the appropriate drive.

    The Volume Manager should mount the media automatically.

  3. Go to the location of the document collection packages.

    For example, you might type a command similar to the following to go to the location on a CD of the document collection packages:

    # cd /cdrom-mount-point/common/

    where cdrom-mount-point is the mount-point, including volume name, for the CD-ROM device.

  4. Launch the installation utility.

    For example, type:

    # pkgadd -d .

  5. Select the collections you want to install from the list.


Installing Localized Collections in PDF Format

Documentation servers running the Solaris 2.6, Solaris 7, or Solaris 8 operating environment cannot install certain Solaris 9 12/02 documentation collection packages with file names that are longer than nine characters. You will need patches in order to install these packages. (If you are installing these packages on a server running the Solaris 9 12/02 operating environment, you do not need these patches.)

The following documentation collection packages on the Solaris 9 12/02 Documentation 1 of 2 and 2 of 2 media have file names that are longer than nine characters:

To install these packages on documentation servers running the Solaris 7 or Solaris 8 operating environment, you must first apply two patches.


Note - No patches exist at the time of this release for Solaris 2.6 servers.


Follow these steps to install documentation collection packages with file names longer than nine characters.

  1. Log in to the documentation server running the Solaris 7 or Solaris 8 operating environment.

  2. Go to the SunSolveSM program patch site at http://sunsolve.Sun.COM/pub-cgi/show.pl?target=patches/patch-access.

  3. In the Find Patch field, provide the appropriate patch IDs from the following table.


    Note - Check the SunSolve site to make sure you are downloading the current version of the patch.


    Table 1-1 Solaris Documentation Server Patches

    Operating Environment

    Patches to Apply

    Solaris 7 operating environment

    • 107332-02 (library)

    • 107443-14

    Solaris 8 operating environment

    • 110380-03 (library)

    • 110934-04

  4. Click Download HTTP or FTP for each patch you want to download.

  5. Change to the directory with the library .zip patch package.

  6. Unzip the library patch package.

    % unzip library-patch-id.zip

  7. Become superuser.

  8. Apply the patch.

    # patchadd library-patch-id

  9. Repeat steps 5 through 8 for the second patch you downloaded in step 4.

  10. Install the Solaris 9 12/02 documentation collection packages.


Finding the Right Book

Because there is no web server located on the Solaris 9 12/02 Documentation media, there is no built-in search feature on the media. To search the Solaris 9 12/02 documentation to find the right book, use one of these actions:


Return to top of page