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 README file in the presto directory.

    Table 3-1 Space Requirements Solaris 2.x Driver

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

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

3.2 Installing with the Software Manager

The Prestoserver software and installation script on the CD is accessed using the Software Manager utility. Refer to the Solaris 2.0 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 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 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.

    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 Solaris 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 drive.

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 <SUNWprnv package instance on host <.... '>

Processing package instance <SUNWprnv from </cdrom'>

Sbus Solaris Prestoserve Driver

(sparc) 11.3.5

(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.

The product described in this manual may be protected by one or more U.S. patents, foreign patents, or pending applications.

TRADEMARKS
Sun, Sun Microsystems, the Sun logo, SMCC, the SMCC logo, SunSoft, the SunSoft logo, Solaris, SunOS, OpenWindows, DeskSet, ONC, and NFS are trademarks or registered trademarks of Sun Microsystems, Inc. UNIX and OPEN LOOK are registered trademarks of UNIX System Laboratories, 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. XDBus is a trademark of Xerox Corporation licensed to Sun Microsystems, Inc.

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.

This product incorporates technology used under license from Fulcrum Technology.Using </opt as the package base directory.

## Processing package information.

## Processing system information.

## 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 Sbus Solaris Prestoserve Driver as <SUNWprnv'>

## Installing part 1 of 1.

/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
[ 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 [yes]? RETURN

* * * Installing Prestoserve man pages

cp -p presto.1m /usr/man/man1m/presto.1m

cp -p prestoctl_svc.1m /usr/man/man1m/prestoctl_svc.1m

cp -p presto_chango.1m /usr/man/man1m/presto_chango.1m

cp -p prestoctl.3r /usr/man/man3r/prestoctl.3r

cp -p prestoserve.7 /usr/man/man7/prestoserve.7

* * * Installing Prestoserve device driver

cp -p pr /kernel/drv/pr

cp -p pr.conf /kernel/drv/pr.conf

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

echo "type=ddi_pseudo;name=MMI,prestoserve pr0" > /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

* * * Enabling Prestoserve

presto -u

prestoctl_svc /dev/console 2&1

Prestoserve successfully installed on .... !

Installation of <SUNWprsto was successful.

Re-initializing list of installed software

3.4 Removing the Prestoserve Software

The Prestoserve software can be removed at any time using the swm utility in much the same way as you would install software. You can also remove the Prestoserve software 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 <SUNWprnv package instance from host < .....'>

The following package is currently installed:
SUNWprnv Sbus Solaris Prestoserve Driver
(sparc) 11.3.5

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

## Removing installed package instance <SUNWprnv'>

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 [yes]? y

* * * Removing Prestoserve man pages

rm -f /usr/man/man1m/presto.1m

rm -f /usr/man/man1m/prestoctl_svc.1m

rm -f /usr/man/man1m/presto_chango.1m

rm -f /usr/man/man3r/prestoctl.3r

rm -f /usr/man/man7/prestoserve.7

* * * Disabling Prestoserve

presto -r

* * * Killing Prestoserve daemon process

kill 9316

* * * Removing Prestoserve device driver

rem_drv pr

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

rm -f /dev/pr0

rm -f /kernel/drv/pr

rm -f /kernel/drv/pr.conf

* * * 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

/opt/SUNWprsto/prestoserve/2.4/dist/prio.h

/opt/SUNWprsto/prestoserve/2.4/dist/prestoserve.7

/opt/SUNWprsto/prestoserve/2.4/dist/prestoserve

/opt/SUNWprsto/prestoserve/2.4/dist/prestoctl_svc.1m

/opt/SUNWprsto/prestoserve/2.4/dist/prestoctl_svc

/opt/SUNWprsto/prestoserve/2.4/dist/prestoctl.x

/opt/SUNWprsto/prestoserve/2.4/dist/prestoctl.h

/opt/SUNWprsto/prestoserve/2.4/dist/prestoctl.3r

/opt/SUNWprsto/prestoserve/2.4/dist/presto_chango.1m

/opt/SUNWprsto/prestoserve/2.4/dist/presto_chango

/opt/SUNWprsto/prestoserve/2.4/dist/presto.1m

/opt/SUNWprsto/prestoserve/2.4/dist/presto

/opt/SUNWprsto/prestoserve/2.4/dist/pr

/opt/SUNWprsto/prestoserve/2.4/dist/README

/opt/SUNWprsto/prestoserve/2.4/dist

## Updating system information.

Removal of <SUNWprsto was successful.

Re-initializing list of installed software

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 file.

    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        Information about the 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 protocal 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
                                  
pstest            executable      Sun Prestoserve diag test
                                  
.usertest         data base file  Sun Prestoserve diag script

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