Sun and OracleChannel SunHow to BuyLog InItaliano

System Administration Guide, Volume I
  Cerca solo questo libro
Aiuto alla Ricerca
Contained Within
Find More Documentation
Featured Support Resources
 Scarica il manuale in formato PDF

Installing AnswerBook

21

This chapter describes how to install and administer AnswerBook packages with Solaris commands. You can also use the Admintool software management capability to install or remove AnswerBook packages.
This is a list of step-by-step instructions in this chapter.
How to Check the Size of AnswerBook Packagespage 350
How to Check the Size of AnswerBook Packagespage 350
How to Install an AnswerBook From an AnswerBook or Product CDpage 351
How to Install the User AnswerBook From the Solaris CDpage 357

Managing AnswerBook on the Network

Table 21-1 Task Map: AnswerBook Administration
Activity........Description
For Instructions, Go To
Before You Install
Verify you have enough disk space for the AnswerBook
· How to Check..page
AnswerBook
you want to install.
Required Disk

349

Space for AnswerBook Packages
· How to Check the Size of AnswerBook

page

Packages

350

Install AnswerBook
Install AnswerBook from a product CD image, an
· How to Install an page
AnswerBook CD image, or from a Solaris CD image.
AnswerBook From
351
an AnswerBook or Product CD
· How to Install the

page

User AnswerBook

357

From the Solaris CD
Set Up an
Set up a central ab_cardcatalog file. Modify it to point
Chapter 22, "Setting Up page
AnswerBook
to all installed AnswerBook packages on the AnswerBook
AnswerBook on the..361
Server
server.
Network"
Set Up
Set the AB_CARDCATALOG environment variable and
Chapter 22, "Setting Up page
AnswerBook
make it available to all users wanting to access the
AnswerBook on the..361
Clients
AnswerBook server.
Network"

Prerequisites

To install a typical AnswerBook package, you need:
  • A system or server running Solaris system software.
  • Access to the AnswerBook software package you want to install. This can be an AnswerBook package on a mounted CD-ROM drive or an AnswerBook package on a spool directory.
  • Available disk space. The disk space required varies depending on the particular AnswerBook. The best way to calculate the space required is to change to the directory where the AnswerBook package resides (this can be a mounted AnswerBook CD or a spool directory) and use the du -s command.
Once you've installed the AnswerBook package, you should have the following system setup to view the AnswerBook:
  • 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))
  • For displaying AnswerBook on X terminals, the remote X-based system supports the Display PostScript extension to X or supports Adobe Display PostScript NX software's remote display capabilities and the remote X-based system (or appropriate host) is installed with a complete LWII Type1 font set.

Considerations Before Installing AnswerBook on a Standalone System or Server

Before you install an AnswerBook package, determine whether or not there is an existing site policy for AnswerBook installation and administration. In particular, does your site use a central server for all AnswerBooks? If so, be sure to install AnswerBook packages on that server and share them with users on the network. If your site doesn't have such a policy, you may want to consider it. If you want to install AnswerBook to run only on a local system, you just need access to the AnswerBook package and enough disk space on the local system for the AnswerBook.
Also, before you install an AnswerBook, you need to know where you want to install the AnswerBook and what AnswerBook installation option you want to use. To install an AnswerBook, you can use either the pkgadd command or the Solaris Desktop Admintool. After you initiate the installation with one of these tools, an interactive AnswerBook installation script takes control. This script prompts you to choose an installation option (the choices are nil or heavy) and an installation directory (called the parent directory in the installation script).

AnswerBook Installation Options

The AnswerBook installation script also prompts you for the installation option you want to use. For each AnswerBook package you install, the installation script prompts you to choose either the nil or heavy installation option, as illustrated here:

  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.
A choice of nil takes up less disk space, but choosing heavy results in better AnswerBook performance. If your site policy is to use a central AnswerBook server, then you'll probably want to use the heavy option and make sure there's enough disk space for all the AnswerBooks you want to install on it. It makes sense to use the nil option when you're installing an AnswerBook on a desktop system with a dedicated CD-ROM drive.
Table 21-2 explains more about the AnswerBook installation options.
Table 21-2


Option

Description		Required
Disk Space
(Mbytes)

Install Time
nilLeaves almost all AnswerBook files on the CD. Saves disk space but requires that the AnswerBook CD remain in the CD-ROM drive, dedicated to AnswerBook use. (This is not an option when installing the Solaris User AnswerBook.)< 1< 5 min.
heavyStores 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.

AnswerBook Parent Installation Directory

AnswerBook software typically resides in /opt. Unless there's not enough disk space in /opt for the AnswerBook or your site installs AnswerBook software in another directory, choose /opt as the parent installation directory when prompted by the AnswerBook installation script.
If you're concerned about available disk space for the installation, you can check the available disk space and determine the approximate size of the contents of the CD before you install the AnswerBook package(s).

· How to Check Required Disk Space for AnswerBook Packages

  1. Determine whether or not there is sufficient disk space in the AnswerBook installation directory.

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


  # df -kl /opt
  1. 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/c0t0d0s531966      10837    17939 38%         /opt

· How to Check the Size of AnswerBook Packages

  1. Change directory to directory where the AnswerBook package resides.

    This AnswerBook package can be on a mounted AnswerBook CD or a spool directory.


  # cd AB-path
  1. Determine the approximate amount of space required by the AnswerBook by using the du -s command.

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


  # du -s

Installing Any AnswerBook From an AnswerBook or Product CD

AnswerBook software packages are generally distributed on their own CDs. For example, the System Administration AnswerBook is on its own CD. AnswerBook software packages may also be part of another product CD. For example, the Online Disksuite(TM) product includes its own AnswerBook package. (The exception is the User AnswerBook, which is distributed as part of the Solaris software CD.) The following section describes how to install AnswerBook from an AnswerBook or product CD.
These instructions generically refer to installing from a CD. However, if an AnswerBook software package has been copied from a CD to a spool directory, you can also install the package from the spool directory.

· How to Install an AnswerBook From an AnswerBook or Product CD

  1. Log in as root.

  2. If you are installing an AnswerBook package from a spool directory, skip to Step 3. If you are installing an AnswerBook package from a CD, insert the CD into the CD-ROM drive.

1 Note - The Volume Management software automatically mounts CDs on 2 /cdrom/cdrom0 .
  1. Use the pkgadd command to add the AnswerBook software package to the system.

    After you initiate the installation with the pkgadd command, an interactive AnswerBook installation script will control the rest of the installation.


  # pkgadd -d AB-path pkgid...
In this command,
-d AB-path· Mounted AnswerBook or other product CD (/cdrom/cdrom0).Specifies the absolute path to AnswerBook software packages. This path is a path to one of the following:
pkgidIs the name of one or more packages to be installed.

1. If you have disabled volume management, mount the CD using the mount(1M) command.
2. Volume management mounts SPARC Solaris CDs on /cdrom/cdrom0/s0 and x86 Solaris CDs on /cdrom/cdrom0/s2.
Note - All CD paths in this table assume the Volume Management software is running. If you have disabled the Volume Management software, mount the CD by using the mount(1M) command and use the mount path as the AB-path.
  1. If you do not specify a pkgid on the command line, the pkgadd command presents a numbered list of all the packages available in AB-path. 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.

  2. You are prompted to choose an AnswerBook installation option. Type 1 for nil, 2 for heavy.

    (If you're concerned about the ramifications of this decision, see "AnswerBook Installation Options" on page 348.)


  Enter the number of an installation option from the list above  
  (1 or 2).  
  2
  1. You are prompted for the name of the parent directory for the package.

    AnswerBook packages are typically installed in /opt.


  Specify the parent of the AnswerBook home directory:  
  /opt
  1. You are prompted to complete the installation. 


  Do you want to continue with the installation of this package?  
  [y, n,?]  
  y
When the installation completes, you see this message:

  Installation was successful.
If you used the pkgadd command without giving it a pkgid argument, and there are other AnswerBook packages that can be installed, you also see this prompt:

  Select package(s) you wish to process (or 'all' to process all  
  packages). (default: all) [?,??,q]:
Type q to quit the installation or specify another AnswerBook package and continue installing.
When you are done installing AnswerBooks, verify that the installation completed successfully.

Verification--Installing an AnswerBook From an AnswerBook or Product CD

To verify that the AnswerBook package or packages have been installed successfully, use the pkginfo and pkgchk commands.

  # pkginfo | egrep pkgid ...  
       .  
       .  
       .  
  # pkgchk pkgid ...
If pkgchk determines there are no errors, it returns the system prompt. Otherwise, it reports the error.

Example--Installing an AnswerBook From an AnswerBook or Product CD

This example shows use of pkgadd on an AnswerBook CD with multiple AnswerBook packages on it. Assume the AnswerBook CD is mounted on a local CD-ROM drive. The default volume management mount point is /cdrom/cdrom0. Because no pkgid is specified on the command line, the pkgadd command list all packages on the CD. In this example, the AnswerBook package is installed in /opt, which is the typical AnswerBook installation directory.

  # pkgadd -d /cdrom/cdrom0  
  1   SUNWabc      An AnswerBook  
           (pltfrm) 1.2.1  
  2   SUNWcde      Another AnswerBook  
           (pltfrm) 40.5.2  
  3   SUNWefg      Yet Another AnswerBook  
           (pltfrm) 78.9.3  
  
  Select package(s) you wish to process (or 'all' to process all packages). (default: all)  
  [?,??,q]:  
  3  
  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.  
  
  Enter the number of an installation option from the list above (1 or 2).  
  2  
  Specify the parent of the AnswerBook home directory:  
  /opt  
  Do you want to continue with the installation of this package? [y, n,?]  
  y  
       .  
       .  
       .  
  Installation was successful.  
       .  
       .  
       .  
  Select package(s) you wish to process (or 'all' to process all packages). (default: all)  
  [?,??,q]:  
  q

Where to Go Next

If you are planning to run the 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 you want to make this AnswerBook available to users on other systems, follow the procedures in Chapter 22, "Setting Up AnswerBook on the Network."

Installing the End User AnswerBook From the Solaris CD

The Solaris User AnswerBook is a package of online documentation written for users of the Solaris desktop. It is included on the Solaris CD 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.

    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 the Solaris User AnswerBook after Solaris installation, using pkgadd, as shown in the following section. Many sites prefer to install the Solaris User AnswerBook this way, installing a single copy in the same place as other AnswerBook packages on their network.
Note - There is no nil installation option for the Solaris User AnswerBook.

· How to Install the User AnswerBook From the Solaris CD

Because the Solaris User AnswerBook package is part of the Solaris CD, installation steps are slightly different from those of other AnswerBook packages.
  1. Determine your first step based on which directory you want to install AnswerBook in.

You Want to Install AnswerBook In ...Then ...
/opt (the default installation directory)Go to Step 2.
A directory of your choiceGo to Step 4.
  1. Use the pkgadd command to install the User AnswerBook package (SUNWabe) into the /opt directory. 


  # pkgadd -d AB-path SUNWabe
In this command,
AB-path.......Specifies the absolute path to the User AnswerBook on a Solaris CD image. This path is a path to one of the following:
  • · Mounted SPARC Solaris CD
(/cdrom/cdrom0/s0/Solaris_2.5)
· Mounted x86 Solaris CD
(/cdrom/cdrom0/s2/Solaris_2.5)
· Copy of either a SPARC or x86 Solaris CD on a
hard disk
Note - All CD paths in this table assume the Volume Management software is running. If you have disabled the Volume Management software, mount the CD by using the mount(1M) command and use the mount path as the AB-path.
  1. Go to "Verification--Installing the User AnswerBook From the Solaris CD" on page 359.

    Step 4 is required only if you want to install the AnswerBook in a directory other than /opt.

  2. Use the pkgadd command to install the SUNWabe (AnswerBook) package into the directory of your choice. 


  # pkgadd -d AB-path -a none SUNWabe  
  Enter the path to the package base directory [?,q] AB-installpath
In this command,
AB-path· Mounted SPARC Solaris CDSpecifies the absolute path to the User AnswerBook on a Solaris CD. This path is a path to one of the following:
(/cdrom/cdrom0/s0/Solaris_2.5)
AB-installpathSpecifies the path where the AnswerBook will be installed.
Note - All CD paths in this table assume the Volume Management software is running. If you have disabled the Volume Management software, mount the CD by using the mount(1M) command and use the mount path as the AB-path.
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.
When you are done installing the User AnswerBook, verify that the installation was completed successfully.

Verification--Installing the User AnswerBook From the Solaris CD

To verify that the AnswerBook package has been installed successfully, use the pkginfo and pkgchk commands.

  # pkginfo | egrep SUNWabe  
  application SUNWabe       Solaris 2.5 User AnswerBook  
  # pkgchk SUNWabe  
  #
The pkgchk command will return a shell prompt if the SUNWabe files have been installed correctly. Otherwise, it will report errors.
To verify the locally installed AnswerBook can be accessed, verify the installation with a trial run.
To start the AnswerBook application, either double-click on its icon in File Manager or enter:

  $ /usr/openwin/bin/answerbook &
If OpenWindows has been installed somewhere other than /usr/openwin (which is the default installation directory), then use the command:

  $ /openwin-install-path/openwin/bin/answerbook &
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.

Where to Go Next

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 you want to make the User AnswerBook available to users on other systems, follow the procedures in Chapter 22, "Setting Up AnswerBook on the Network."

Removing an AnswerBook Package

You may decide you want to remove an AnswerBook package. For example, during the installation you may have chosen the nil option, but now you want to install the complete heavy AnswerBook package.
To remove an AnswerBook software package, follow the instructions for removing software packages on Chapter 18, "Adding and Removing Packages."
CAUTION Caution - Always use the pkgrm command to remove installed AnswerBook packages. Do not use the rm(1) command, which will corrupt the system's record-keeping of installed packages.