Overview of AnswerBook Installation

• First you run pkgadd to install one or more AnswerBook packages from the CD-ROM disk.
• For each AnswerBook package you install, you are asked to choose an installation option, nil or heavy. A choice of nil takes up less disk space, but choosing heavy results in better AnswerBook performance.
• You choose a parent directory for the AnswerBook package and check available disk space there.
• If users will be sharing AnswerBooks on a network, you perform an administrative procedure, covered in Chapter 3, "AnswerBook Administration."

Hardware and Software Requirements

Review these requirements before you begin installation.

For Installing a Typical AnswerBook Package

To install an AnswerBook package, you need:

• A system or server running Solaris system software
• A CD-ROM drive available somewhere on the network
• Available disk space: from under 1 to more than several hundred Mbytes, depending on the AnswerBook package and the installation option you choose

For Viewing the Installed AnswerBook Package

Once you've installed the AnswerBook package, to use it you should have:

• A system or server running Solaris system software and a black-and-white or color bitmap graphics monitor
• OpenWindows^(TM) Version 3.2 or later
• For printing pages from AnswerBook: A laser printer with Palatino^(TM) style fonts resident (such as the Sun LaserWriter^(TM) or Sun SPARCprinter^(TM))

AnswerBook Installation

This procedure assumes you have a CD-ROM drive installed locally (connected to your system). Otherwise, see Chapter 1, "Adding and Removing Packages" for supplementary instructions, such as those for installing from a remote CD-ROM drive.

Installing an AnswerBook Package

1. Become superuser.

2. Place the AnswerBook CD-ROM into the caddy.

3. Insert the caddy into the drive.

   If the volume management daemon is enabled (the default), inserting the CD-ROM mounts it automatically. If you have disabled volume management, mount the CD-ROM using the mount(1M) command.

4. Run pkgadd to begin the installation.

# pkgadd -d /cdrom/cdrom0

---

Note - The path name shown in the example above is the mount point if volume management is enabled (the default). If you have disabled volume management, make sure the path name you specify is the correct mount point for the CD-ROM.

---

The pkgadd software presents a numbered list of one or all the packages on the disk and their associated AnswerBook titles.

For example:

1    SUNWabc      ABC AnswerBook
                  (pltfrm) 1.2.1
2    SUNWabook    Another AnswerBook
                  (pltfrm) 40.5.2
3    SUNWasys     System AnswerBook
                  (pltfrm) 78.9.3

Select package(s) you wish to process (or 'all' to process all
packages). (default: all) [?,??,q]:

5. Specify one or all AnswerBook packages by number and press Return.

   Each AnswerBook package will be installed successively. Prior to each package installation you will be prompted for information.

   Alternatively, you can install a single AnswerBook package by typing its number from the list.

Considerations As You Install AnswerBook Packages

If you are concerned about having enough disk space for the installation, you should see:

• "A Review of AnswerBook Installation Options" on page 30
• "Checking the Size of AnswerBook Packages on the CD-ROM" on page 31
• "Checking Disk Space for the AnswerBook Package(s)" on page 31

Otherwise, skip to "Finishing Up Each AnswerBook Installation" on page 32.

A Review of AnswerBook Installation Options

For each AnswerBook package you install, you are asked to choose an installation option.

Copyright information.... The installation options are as follows: Option: Description: -------------------------------------------- 1. nil: less than X Megabyte disk space required [slowest performance]. 2. heavy: XX Megabytes disk space required [best performance]. Enter the number of an installation option from the list above (1 or 2). Make sure to choose a parent directory on a file system big enough to accommodate all the files to be moved for the INSTALL OPTION you selected.

Table 2-1 explains more about these install options.

Table 2-1

Option	Description	Required Disk Space (Mbytes)	Install Time
nil	Leaves almost all AnswerBook files on the CD-ROM. Saves disk space but requires that the AnswerBook CD-ROM remain in the drive, dedicated to AnswerBook use. Not an option when installing the Solaris User AnswerBook.	< 1	< 5 min.
heavy	Stores all AnswerBook files on hard disk. Optimizes AnswerBook performance. This configuration is recommended if the AnswerBook package is to be shared by multiple systems and users.	varies with the package, from < 1 up to 50 or more	< 15-30 min.

Checking the Size of AnswerBook Packages on the CD-ROM

If you're concerned about available disk space for the installation, you can determine the approximate size of the contents of the CD-ROM before you install the AnswerBook package(s).

1. Type cd /cdrom/cdrom0 to change to the CD-ROM directory.

2. At the prompt, type du -s . to see the files in the current CD-ROM directory and determine their size.

This will tell you how much disk space you'll need when you install.

Checking Disk Space for the AnswerBook Package(s)

As each AnswerBook package is installed, the installation software requires you to designate a parent directory.

Typically AnswerBook packages are installed in /opt, but they can be installed in any appropriate directory with enough disk space.

In a separate command window:

1. Type df -k to check available disk space in the directories under the root partition.

2. Compare the available space in the list with the sizes listed for the nil and heavy installations.

In the example below, the system has enough space in the /opt partition to do a heavy installation of an AnswerBook package under 18 Mbytes.

Filesystem           kbytes     used     avail     capacity    mounted on
/dev/dsk/c0t0d0s5 31966         10837    17939     38%         /opt

Finishing Up Each AnswerBook Installation

To proceed, you are prompted to choose an installation option.

Enter the number of an installation option from the list above (1
or 2).

1. Type 1 for nil, 2 for heavy.

2. Type the name of the parent directory for the package.

   The default is /opt.

  Specify the parent of the AnswerBook home directory:
  /opt

3. Type y to complete the installation.

Do you want to continue with the installation of this package?
[y, n,?]
y

The installation proceeds, listing AnswerBook components as they are installed, until you see this message:

Installation was successful.

[Information varies...]

Select package(s) you wish to process (or 'all' to process all
packages). (default: all) [?,??,q]:

4. Type q to quit the installation or specify another AnswerBook package and continue installing.

5. When you're finished with the installation, view the list of installed packages.

# pkginfo | grep AnswerBook

A list of all installed AnswerBook packages is displayed.

6. Check the installation accuracy of each installed package.

   # pkgchk packagename packagename packagename [and so on]

---

Note - The pkgchk process takes time, even for one package.

---

7. Examine the new AnswerBook collection, and optionally make it available to other users.

   See "Verifying AnswerBook Installation" on page 35.

Notes about the Solaris User AnswerBook

The Solaris User AnswerBook is a package of on-line documentation written for users of the Solaris desktop. It is included on the Solaris CD-ROM (the disk from which Solaris is installed), and consumes about 20 Mbytes of available disk space when installed.

There are two ways to install the Solaris User AnswerBook:

• As part of the Solaris installation, you can install it into a predetermined directory on the local system. To do so, you choose "customize" at the appropriate point during Solaris installation and include the Solaris User AnswerBook package (SUNWabe). This package is installed in the /opt directory during Solaris installation.

  Note that the Solaris User AnswerBook package is installed on the local system by default if you have chosen the "Entire Distribution" software group. It is also installed automatically by certain configurations of JumpStart installation.

• You can install it after Solaris installation into the directory of your choice, using pkgadd, as shown in the following section. Many sites prefer to install the Solaris User AnswerBook this way, locating a single copy in the same place as other AnswerBook packages on their network.

Note that no nil installation option exists for the Solaris User AnswerBook.

Installing the Solaris User AnswerBook Package using pkgadd

Because the Solaris User AnswerBook package is part of the Solaris CD-ROM, installation steps are slightly different from those of other AnswerBook packages. Follow these steps:

1. Become superuser.

2. Place the Solaris CD-ROM into the caddy.

3. Insert the caddy into the drive.

   If the volume management daemon is enabled (the default), inserting the CD-ROM mounts it automatically. If you have disabled volume management, mount the CD-ROM using the mount(1M) command.

---

Note - The path name shown in the following examples is the mount point if volume management is enabled (the default). If you have disabled volume management, make sure the path name you specify is the correct mount point for the CD-ROM.

---

4. Add the SUNWabe package.

   To install the Solaris User AnswerBook in the /opt directory, type:

# pkgadd -d /cdrom/cdrom0 SUNWabe

Or, to install the Solaris User AnswerBook in a different location, type the following command and specify a directory when prompted:

# pkgadd -d /cdrom/cdrom0 -a none SUNWabe
Enter the path to the package base directory [?,q] /export/ab

A list of files is displayed as the package is installed. When the package installation is complete you will see:

Installation of <SUNWabe> was successful.

5. Check the installation accuracy of the package.

   # pkgchk SUNWabe

---

Note - The pkgchk process takes time, even for one package.

---

6. Make the Solaris User AnswerBook available to other users, if applicable.

   If you are planning to run the Solaris User AnswerBook only on the system where it is installed, you're done; it will be accessed automatically the next time you run the AnswerBook software.

   If users on other systems will want access to this AnswerBook collection, make it available to them following the instructions in Chapter 3, "AnswerBook Administration."

Verifying AnswerBook Installation

Verify the installation on the system where you installed the AnswerBook package(s) with a trial run.

To start the AnswerBook application:

* Double-click on its icon in File Manager.

or:

* If the environment variable OPENWINHOME is not set, and you did not install OpenWindows in the default location (/usr/openwin), then type the following:

% setenv OPENWINHOME /<your_openwin_area>/openwin
% /<your_openwin_area>/openwin/bin/answerbook

---

Note - In setting the environment variable OPENWINHOME, you must give the exact path name /usr/openwin. You must have OpenWindows installed locally in /usr/openwin or mounted on /usr/openwin.

---

When the AnswerBook Navigator opens, click the Modify Library button and select AnswerBook titles from the scrolling list so they are included in the Navigator Contents.

Making AnswerBook Documentation Available to Users

Once you have installed the AnswerBook package(s), see Chapter 3, "AnswerBook Administration," for instructions on how to make them available to users on a network.

Removing an AnswerBook Package

You may decide you want to remove an AnswerBook package. For example, during the install you may have chosen the nil option, but now you want to install the complete heavy AnswerBook package.

First remove the AnswerBook package:

1. Open a shell tool, and become superuser.

2. To find the pkgid of the package you want to remove, type pkginfo. A list of packages is displayed; the package identifiers are in the second column.

3. Type pkgrm pkgid.

   Insert the identifier of the package you want to remove.

---

Caution - Always remove AnswerBook packages using the pkgrm command. Using the rm command will remove the files associated with the package, but it leaves the database of packages unchanged, as if the package were still installed.

---

4. Type y to verify you want to remove the package.

The following package is currently installed.

[pkgid]

Do you want to remove this package? y/n/q?
y