This document contains information about installing the SolarisTM 9 12/02 online documentation from the Solaris 9 12/02 Documentation media.
pkgadd
to Install Book
Collections
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:
A navigable table of contents file that enables you to read the HTML or PDF documentation on the media. See Solaris 9 12/02 Documentation Contents.
A point-and-click interface called "installer" that you can use to install document collections for use with your own web server and environment. The installer is a Web Start utility. See Using the Installer to Install Book Collections.
Directories (/
cdrom-mount-point/common/
)
that contain online documentation in either HTML or PDF format that
can be installed using pkgadd
. See Using
pkgadd
to Install Book Collections.
To read documentation directly from the CD or DVD, perform the following steps:
Insert the Solaris 9 12/02 Documentation media into the appropriate drive.
The Volume Manager should mount the media automatically.
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
).
Double-click the index.html
icon or
load the file into your web browser.
Select the format (HTML or PDF) for the collection that you want to view.
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:
Insert the Solaris 9 12/02 Documentation media into the appropriate drive.
The Volume Manager should mount the media automatically.
Double-click the installer icon and follow the instructions on the screens.
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.
If you are not already logged in as superuser on the system, type the system's root password when prompted.
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.
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.
pkgadd
to Install
Book CollectionsTo install document collection packages from the Solaris 9 12/02
Documentation media using the pkgadd
utility:
Log in as superuser on the documentation server machine.
Insert the Solaris 9 12/02 Documentation media into the appropriate drive.
The Volume Manager should mount the media automatically.
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.
Launch the installation utility.
For example, type:
# pkgadd -d .
Select the collections you want to install from the list.
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:
Most PDF collections in French, German, Italian, Spanish, and Swedish locales
Most PDF collections in Korean, Traditional Chinese, Simplified Chinese, and Japanese locales
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.
Log in to the documentation server running the Solaris 7 or Solaris 8 operating environment.
Go to the SunSolveSM program patch site at http://sunsolve.Sun.COM/pub-cgi/show.pl?target=patches/patch-access.
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 |
|
Solaris 8 operating environment |
|
Click Download HTTP or FTP for each patch you want to download.
Change to the directory with the library .zip patch package.
Unzip the library patch package.
% unzip
library-patch-id.zip
Become superuser.
Apply the patch.
# patchadd
library-patch-id
Repeat steps 5 through 8 for the second patch you downloaded in step 4.
Install the Solaris 9 12/02 documentation collection packages.
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:
Go to the Sun online documentation web site at http://docs.sun.com. This web site contains online documentation for current and previous Solaris releases, as well as for many other Sun products. docs.sun.com provides multiple entry points into the documentation, including a robust search engine that can handle complex searches.
Install the document collections in your own environment and connect them to a search engine. This approach requires that you:
Have a web server installed on your system.
Have a search engine installed on your system.
If you do not have a search engine, Sun includes a simple
freeware search utility (sgrep
) on the Solaris 9
12/02 Companion CD. For more information, see the sgrep
man
page on the Solaris 9 12/02 Companion CD or the sgrep
Web
site at http://www.cs.Helsinki.FI/u/jjaakkol/sgrep.html.