3 Installing the Prestoserve Solaris 2.x Software





Follow the instructions in this chapter to install the Prestoserve driver for systems running the Solaris 2.x operating system.

Unlike SunOS 4.x it is not necessary to mount the CD using a command. When the system boots, all of the devices available are identified. With the Solaris 2.x operating system, software installation is performed using the Software Manager utility. If the CD is connected, the software manager displays a message identifying the address of the CD. If the CD is not connected, the software manager displays an error message when you try to access the CD.

3.1 Space Requirements

Before you begin the installation, ensure that you have enough space available on your target system. The approximate amount of space required to install Sun Prestoserve is shown in Table 3-1. The total space required is 446 Kbytes. For exact space requirements for your operating system, look at the space file in the install directory under the root directory of your CD.

    Table 3-1 Space Requirements Solaris 2.x Driver

--------------------------
Directory Kbytes Used --------------------------
              
Prestoserve   
              
/usr          178
              
/kernel       138
              
/man          76
              
/man (nroff)  152
              
/man (troff)  224

--------------------------

3.2 Installing with the Software Manager

The Prestoserve software and installation script on the CD is accessed using the Software Manager utility. Refer to the Solaris 2.x System Configuration and Installation Guide for the specific commands used with the swm utility. The utility is only discussed briefly in this section.

Note - You also have the option of using the swmtool and the pkgadd utility to add the software to your system. Refer to the documents that came with your system for information about the pkgadd utility.

    1. Invoke the software manager tool by typing:

    The following menu is displayed.

    2. Select [c], to load the software distribution media.

    Another menu appears, which allows you to specify a mount point that is different from the default of /opt.

    3. Choose the default by typing [l] to mount and load software from the specified CD-ROM.

    You are then prompted to insert the CD-ROM disk into the CD drive. You may see a message that states "hsfs: unknown CDROM structure format". This doesn't affect the system operation and the cdrom does get mounted.

    4. Press y to continue, then Return.

    The swm utility returns to the main menu.

    5. Choose d to select the software products for installation.

    Another menu appears with a list of software products available for installation.

    6. Choose the letter that represents the Prestoserve Driver and type Return.

    The swm utility returns to the main menu.

    7. Choose e to install the software.

    The software manager now runs the Prestoserve installation script on the CD.

3.3 Using the Installation Script

The installation script copies files from the CD-ROM into a Prestoserve directory and then enables the driver.

As the script runs, it queries you for information. In most cases, use the defaults supplied with the script. Press the Return key to select the defaults. You can interrupt or stop this script at anytime.

Note - If the installation script is interrupted, the installation script must be rerun, from the beginning, in order to install the Prestoserve driver.

3.3.1 A Typical Installation

This section provides a step-by-step description of the functions performed by the installation script. The margin notes call your attention to lines requiring a response.

Installing <SUNWprsto package instance on host <.... '>

Processing package instance <SUNWprsto from </cdrom'>

Prestoserve Driver Rev 2.4

(sparc) Dev Release 03/18/93

(C) 1993 Sun Microsystems, Inc.

Printed in the United States of America.

2550 Garcia Avenue, Mountain View, California, 94043-1100 U.S.A.

All rights reserved. This product and related documentation is protected by copyright and distributed under licenses restricting its use, copying, distribution and decompilation. No part of this product or related documentation may be reproduced in any form by any means without prior written authorization of Sun and its licensors, if any.

Portions of this product may be derived from the UNIX(R) and Berkeley 4.3 BSD systems, licensed from UNIX Systems Laboratories, Inc. and the University of California, respectively. Third party font software in this product is protected by copyright and licensed from Sun's Font Suppliers.

RESTRICTED RIGHTS LEGEND: Use, duplication, or disclosure by the government is subject to restrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and Computer Software clause at DFARS 252.227-7013 and FAR 52.227-19.

Sun, Sun Microsystems, the Sun Logo, Solaris, SunOS, ONC, NFS, OpenWindows, DeskSet, AnswerBook, SunLink, SunView, SunDiag, NetISAM, NeWS, OpenBoot, OpenFonts, SunInstall, SunNet, ToolTalk, X11/NeWS and XView are trademarks or registered trademarks of Sun Microsystems, Inc. UNIX and OPEN LOOK are registered trademarks of UNIX System Laboratories, Inc. PostScript is a registered trademark of Adobe Systems, Inc. All other product names mentioned herein are the trademarks of their respective owners.

All SPARC trademarks, including the SCD Compliant Logo, are trademarks or registered trademarks of SPARC International, Inc. SPARCstation, SPARCserver, SPARCengine, SPARCworks, and SPARCompiler are licensed exclusively to Sun Microsystems, Inc. Products bearing SPARC trademarks are based upon an architecture developed by Sun Microsystems, Inc. SuperSPARC is a trademark of SPARC International, used under license by Texas Instruments, Inc.

The OPEN LOOKŪ and Sun(TM) Graphical User Interfaces were developed by Sun Microsystems, Inc. for its users and licensees. Sun acknowledges the pioneering efforts of Xerox in researching and developing the concept of visual or graphical user interfaces for the computer industry. Sun holds a non-exclusive license from Xerox to the Xerox Graphical User Interface, which license also covers Sun's licensees who implement OPEN LOOK GUIs and otherwise comply with Sun's written license agreements.

X Window System is a trademark and product of the Massachusetts Institute of Technology.

Prestoserve is a trademark of Legato Systems, Inc. Sun Prestoserve (SBus and VME versions) is derived from Prestoserve, developed by Legato Systems, Inc.

Using </opt as the package base directory.

## Processing package information.

## Processing system information.

## Verifying package dependencies.

## Verifying disk space requirements.

## Checking for conflicts with packages already installed.

## Checking for setuid/setgid programs.

This package contains scripts which will be executed with super-user permission during the process of installing this package.

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

Installing Prestoserve Driver 2.4 as <SUNWprsto'>

## Installing part 1 of 1.

/opt/SUNWprsto/prestoserve/2.4/dist/.usertest
/opt/SUNWprsto/prestoserve/2.4/dist/README
/opt/SUNWprsto/prestoserve/2.4/dist/pr
/opt/SUNWprsto/prestoserve/2.4/dist/presto
/opt/SUNWprsto/prestoserve/2.4/dist/presto.1m
/opt/SUNWprsto/prestoserve/2.4/dist/presto_chango
/opt/SUNWprsto/prestoserve/2.4/dist/presto_chango.1m
/opt/SUNWprsto/prestoserve/2.4/dist/prestoctl.3r
/opt/SUNWprsto/prestoserve/2.4/dist/prestoctl.h
/opt/SUNWprsto/prestoserve/2.4/dist/prestoctl.x
/opt/SUNWprsto/prestoserve/2.4/dist/prestoctl_svc
/opt/SUNWprsto/prestoserve/2.4/dist/prestoctl_svc.1m
/opt/SUNWprsto/prestoserve/2.4/dist/prestoserve
/opt/SUNWprsto/prestoserve/2.4/dist/prestoserve.7
/opt/SUNWprsto/prestoserve/2.4/dist/prio.h
/opt/SUNWprsto/prestoserve/2.4/dist/pstest
[verifying class <none]

## Executing postinstall script.

Prestoserve(TM) - SPARC Release 2.4

Copyright (c) 1989-1992 by Legato Systems, Inc. All rights reserved.

Ok to install Prestoserve on machine `.... `[yes]? y

Install Prestoserve man pages [no]? RETURN

cp -p pr /kernel/drv/pr

cp -p /etc/devlink.tab /etc/devlink.tab.prepresto

echo "type=ddi_pseudo;name=MMI,prestoserve pr\M0" > /etc/devlink.tab

add_drv -m `* 0644 root sys' -i `MMI, prestoserve' pr

* * * Adding Prestoserve changes to system files

cp -p /etc/system /etc/system.prepresto

echo "forceload: drv/pr" > /etc/system

cp -p /etc/rpc /etc/rpc.prepresto

echo "prestoctl_svc 390100 prestoserve presto" > /etc/rpc

* * * Installing Prestoserve files

cp -p prestoserve /etc/init.d/prestoserve

ln /etc/init.d/prestoserve /etc/rc0.d/K00prestoserve

ln /etc/init.d/prestoserve /etc/rc2.d/S92prestoserve

cp -p presto /usr/sbin/presto

cp -p prestoctl_svc /usr/sbin/prestoctl_svc

cp -p prestoctl.h /usr/include/rpcsvc/prestoctl.h

cp -p prestoctl.x /usr/include/rpcsvc/prestoctl.x

cp -p prio.h /usr/include/sys/prio.h

cp -p presto_chango /usr/sbin/presto_chango

Prestoserve successfully installed on .... !

Type carriage return to continue.

3.4 Removing the Prestoserve Software

The Prestoserve software can be removed at any time by running the presto_chango script with the -r option.

3.4.1 A Typical Removal

To remove the Prestoserve software:

    1. Invoke the software manager utility.
    2. Choose f to select the software products for removal.

    Another menu appears with a list of software products available for removal.

    3. Choose the letter that represents the Solaris Prestoserve Driver and type Return.

    The swm utility returns to the main menu.

    4. Choose g to remove the software.

    The software manager now removes all of the Prestoserve files written during the installation process. The following shows the screen display during the removal process. The margin notes call your attention to lines requiring a response.

Removing <SUNWprsto package instance from host < .....'>

The following package is currently installed:
SUNWprsto Prestoserve Driver Rev 2.4
(sparc) Dev Release 3/18/93

Do you want to remove this package [y,n,?,q] y

## Removing installed package instance <SUNWprsto'>

This package contains scripts which will be executed with super-user permission during the process of removing this package.

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

## Verifying package dependencies.

## Processing package information.

## Executing preremove script.

Prestoserve(TM) - SPARC Release 2.4

Copyright (c) 1989-1992 by Legato Systems, Inc. All rights reserved.

Ok to remove Prestoserve from machine `..... ` [yes]? y

Remove Prestoserve man pages [no]?

* * * Removing Prestoserve device driver

rem_drv pr

mv -f /etc/devlink.tab.prepresto /etc/devlink.tab

rm -f /kernel/drv/pr

* * * Removing Prestoserve changes from system files

mv -f /etc/system.prepresto /etc/system

mv -f /etc/rpc.prepresto /etc/rpc

* * * Removing Prestoserve files

rm -f /etc/init.d/prestoserve

rm -f /etc/rc0.d/K00prestoserve

rm -f /etc/rc2.d/S92prestoserve

rm -f /usr/sbin/presto

rm -f /usr/sbin/prestoctl_svc

rm -f /usr/include/rpcsvc/prestoctl.h

rm -f /usr/include/rpcsvc/prestoctl.x

rm -f /usr/include/sys/prio.h

rm -f /usr/sbin/presto_chango

Prestoserve successfully removed from .....

## Removing pathnames in <none class

## Updating system information.

Removal of <SUNWprsto was successful.

3.5 Files Created During Installation

Table 3-2 identifies the contents of each file in the Sun Prestoserve directory. This information is also contained in the README files.

    Table 3-2 Contents of Files in the Sun Prestoserve Directory

----------------------------------------------------------------------
File Name Type Contents ----------------------------------------------------------------------
                                 
README            ASCII          Information about the other files in 
                                 this directory
                                 
presto_chango     sh script      Software installation and removal 
                                 shell script
                                 
prestoserve       sh script      Shell script run by init (1M)
                                 
presto_chango.1m  man page       Installation and removal script
                                 
presto            executable     Sun Prestoserve control program
                                 
presto.1m         man page       Prestoserve control program man 
                                 pages
                                 
prestoserve.7     man page       Loadable kernel device man page
                                 
prestoctl_svc     executable     RPC server (started by inetd(1M)) 
                                 that supplies Sun Prestoserve 
                                 status and statistics to the network
                                 
prestoctl_svc.1m  man page       Information about the prestoctl_svc 
                                 server
                                 
prestoctl.x       rpcgen input   Rpcgen(1) description of the 
                                 prestoctl protocol
                                 
prestoctl.3r      man page       Prestoctl protocol man page
                                 
pr                object module  Kernel Sun Prestoserve device 
                                 driver
                                 
prestoctl.h       C source       C include file generated from 
                                 prestoctl.x
                                 
prio.h            C source       Include file for the kernel 
                                 Prestoserve driver

----------------------------------------------------------------------