Follow the instructions in this chapter to install the Prestoserve driver for systems running the Solaris 1.x (SunOS 4.x) operating system.
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 2-1. For exact space requirements for your operating system, look at the README file in the presto directory. Overhead refers to space that is used for saving the contents of files that are modified.
--------------------------------------------------
Directory Kbytes Used Overhead --------------------------------------------------
presto 400 0
/usr 300 0
/ 10 10
/vmunix.sysname.presto varies 0
sys 50 1200/70
man 50/100/200 0
--------------------------------------------------
The sizes shown in Table 2-1 for man correspond (from left to right) to installing:
The software required to operate the Prestoserve product is shipped to you on a compact disk. Before you can install the software you must first mount the SunCD.
Place the Prestoserve CD-ROM in the CD drive and mount the local or remote CD-ROM using the commands appropriate to your operating system and hardware. See the Preface, "When You Need Help with UNIX Commands," for references to documentation that contain the correct procedures.
The Sun Prestoserve installation script is accessed using the CDmanager, which is available in /cdrom as two programs: cdm and cdmanager. cdm is the command line interface to CDmanager. cdmanager is the graphical user interface version of CDmanager which can be run only under OpenWindows. You can use either program to install the Prestoserve software.
Table 2-2 CD-ROM Tools
------------------------------------------------
If you are installing from: Use this program: ------------------------------------------------
OpenWindows(TM) cdmanager or cdm
SunView(TM) (SunOS 4.x only) cdm
Terminal cdm
------------------------------------------------
If you are running OpenWindows, you may find it more convenient to use the interactive cdmanager program, as shown next. If you are not running OpenWindows, you must use the menu-driven cdm program, as shown in "Installing with cdm" on page 2-4.
Note - This procedure works only with the SunOS 4.x operating system. If you are running Solaris 2.x follow the procedures in Chapter 3 or see your operating system documentation for the software installation tools available on your system.
The actual installation is performed by the Sun Prestoserve installation script. The sections that follow describe accessing the installation script using both cdmanager and cdm, refer to the appropriate section.
cdmanager is the graphical user interface version of CDmanager and runs only under OpenWindows. Follow these steps to run cdmanager:
The operating system release should be SunOS 4.1.1 or later.
The cdmanager utility now runs the installation script found on the CD-ROM. The installation script is described in detail in "Using the Installation Script" on page 2-6.
Follow these steps to run the command line interface version of CDmanager:
Once cdm initializes, the application menu is displayed.
The cdm utility now runs the installation script found on the CD-ROM. The installation script is described in detail in the following section.
To install the Prestoserve software using a CD-ROM device attached to a remote machine, refer to the User's Guide that came with your system for instructions about remote CD installations.
The installation script copies files from the CD-ROM into other parts of the file system, installs the Prestoserve driver in the system directory, and builds a kernel that contains the driver. The kernel is installed in the root directory and is named: /vmunix.sysname.presto, where sysname is the configuration name of your system.
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. Once the Prestoserve software files are loaded on your system they require about 400 Kilobytes of disk space.
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.
The Prestoserve installation script has created a new kernel with the name displayed at the end of the installation procedure. You must now make the Prestoserve kernel the standard auto-boot kernel. To do this, you must boot first in the single-user mode and save the old kernel, then reboot your system.
To start your server in single-user mode, follow these steps:
Depending on how your system is set up, you should see either a monitor prompt () or the OpenBoot prompt (ok).
If your system console is a Sun monitor, stop the system by typing L1-A.
If you are using a terminal console, stop the system by pressing the BREAK
key.
If your system displays the () prompt, use the b (boot) command. For example:
If your system displays the (ok) prompt, use the boot command. For example:
Note - The name of the kernel varies depending on your operating system. Ensure that you boot the kernel generated by the Prestoserve installation script.
Note - N depends on which SBus slot is used for the Prestoserve card. H depends on the SBus card configuration.
In addition, the driver prints initialization data. The data displayed is dependent on the state and the memory size of the Prestoserve hardware.
Note - If you do not see the boot time driver message, halt and power down the server and verify that the Prestoserve hardware is fully seated. In addition, make sure that you are booting the kernel that was configured for the device driver.
Once the server is running in single-user mode you can link the kernel as follows.
The system comes up in multi-user mode.
Caution -
If you change /vmunix but don't reboot, some UNIX commands (such as ps and pstat) will stop functioning. However, as soon as you reboot, these commands will function normally.If you have a floppy drive on your system you may see this message at boot time:
You may ignore this message. When the software starts, it attempts to accelerate each file system defined in the /etc/fstab file. Since Prestoserve does not support floppy drives, it displays the error message above.
To avoid this message, you can edit /etc/fstab and delete or comment out the floppy drive entry. Look for the line:
Table 2-3 identifies the contents of each file in the Sun Prestoserve directory. This information is also contained in the README file.
--------------------------------------------------------------------------------
File Name Type Contents --------------------------------------------------------------------------------
README ASCII Information about the other files in
this directory
/usr/etc/presto_chango sh script Software installation and removal
shell script
man/man/presto_chango. man page Information about the installation
8 and removal script
/usr/etc/presto executable Sun Prestoserve control program
man/man1/presto.1 man page Information about the Sun
Prestoserve control program
/usr/bin/prestotool executable Sun Windows based Sun
Prestoserve monitoring program
man/man1/prestotool.1 man page Information about the Sun
Prestoserve monitoring program
/usr/etc/prestoctl_svc executable RPC server (started by inetd(8c))
that supplies Sun Prestoserve
status and statistics to the network
man/man8/prestoctl_svc.8 man page Information about the prestoctl_svc
server
/usr/include/rpcsvc/pres rpcgen input Rpcgen(1) description of the
toctl.x prestoctl protocol
man/man3/prestoctl.3r man page Information about the prestoctl
protocol
sys/sun4c/OBJ/pr.o object module Kernel Sun Prestoserve device
driver
sys/sundev/prestoioctl.h C source Include file for the kernel Sun
Prestoserve device driver
man/man4/presto.4 man page Information about the kernel
device driver
/usr/etc/pstest executable Sun Prestoserve diag test
.usertest data base file Sun Prestoserve diag script
--------------------------------------------------------------------------------
The files listed in Table 2-4 are modified during the Prestoserve installation.
Table 2-4 Modified Files
--------------------------
File Name
sys/sun/conf.c sys/os/init_sysent.c sys/*/conf/files sys/sun4c/conf/sysname sys/sun4c/conf/GENERIC /etc/inetc.conf /etc/rc.local /etc/rpc --------------------------
The hardware and software installation is now complete for the SunOS 4.x operating system. Additional information about the Prestoserve driver, the options available, and diagnostics is available in the appendices.
You can remove all of the installed Prestoserve files and changes with the -r command, using the this syntax.
# presto_chango -r
During the installation of Prestoserve, the installation script saved a copy of every file it modified in a file with .prepresto" appended to the original name. As the Prestoserve removal proceeds, the script strips all Sun Prestoserve changes from each file, and if the result is identical to the original, then the original is replaced. If differences are found, Sun Prestoserve asks for verification. If confirmed, it replaces the current version of the file with the stripped one.
The Prestoserve directory created during the original installation, referred to here as prestodir, is not removed. If you want to remove it type:
# rm -r prestodir