Sun Microsystems Solaris 8 Guide

Solaris 8 6/00 Sun™Hardware
Platform Guide
Sun Microsystems, Inc. 901 San Antonio Road Palo Alto, CA 94303-4900 U.S.A. 650-960-1300
Part No. 806-4388-10 June 2000, Revision A
Send comments about this document to: docfeedback@sun.com
Copyright 2000 Sun Microsystems, Inc., 901 San Antonio Road, Palo Alto, California 94303-4900 U.S.A. All rights reserved. This productordocumentisprotectedbycopyrightanddistributedunderlicensesrestrictingitsuse,copying,distribution,anddecompilation.
No part of this productordocumentmaybereproducedinanyformbyanymeanswithoutpriorwrittenauthorizationofSunand its licensors, if any.Third-party software, including font technology,is copyrighted and licensed from Sun suppliers.
Parts of the product may be derived from Berkeley BSD systems, licensed from the University of California. UNIX is a registeredtrademark in the U.S. and other countries, exclusively licensed through X/Open Company,Ltd. For Netscape Communicator™, the following notice applies: Copyright 1995 Netscape Communications Corporation. All rights reserved.
Sun, Sun Microsystems, the Sun logo, AnswerBook, AnswerBook2, Solaris, Sun Enterprise, Sun StorEdge, SPARCstorage,SPARCserver, ShowMe TV,SunFDDI, SunForum, SunVTS, and Ultra are trademarks, registeredtrademarks, or service marks of Sun Microsystems, Inc. in the U.S. and other countries. All SPARCtrademarks are used under license and are trademarks or registeredtrademarks of SPARCInternational, Inc. in the U.S. and other countries. Products bearing SPARCtrademarks are based upon an architecturedeveloped by Sun Microsystems, Inc.
The OPEN LOOK and Sun™ Graphical User Interface was 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.
RESTRICTED RIGHTS: Use, duplication, or disclosure by the U.S. Government is subject to restrictions of FAR52.227-14(g)(2)(6/87) and FAR
52.227-19(6/87), or DFAR 252.227-7015(b)(6/95) and DFAR227.7202-3(a). DOCUMENTATIONIS PROVIDED “AS IS” AND ALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONSAND WARRANTIES,
INCLUDING ANY IMPLIED WARRANTYOF MERCHANTABILITY,FITNESS FOR A PARTICULARPURPOSE OR NON-INFRINGEMENT, ARE DISCLAIMED, EXCEPT TO THE EXTENT THATSUCH DISCLAIMERS ARE HELD TO BE LEGALLYINVALID.
Copyright 2000 Sun Microsystems, Inc., 901 San Antonio Road, Palo Alto, Californie 94303 Etats-Unis. Tousdroits réservés. Ce produit ou document est protégé par un copyright et distribué avec des licences qui en restreignentl’utilisation, la copie, la distribution, et la
décompilation. Aucune partie de ce produit ou document ne peut être reproduite sous aucune forme, par quelque moyen que ce soit, sans l’autorisation préalable et écrite de Sun et de ses bailleurs de licence, s’il y en a. Le logiciel détenu par des tiers, et qui comprend la technologie relativeaux polices de caractères, est protégé par un copyright et licencié par des fournisseurs de Sun.
Des parties de ce produit pourront être dérivées des systèmes Berkeley BSD licenciés par l’Université de Californie. UNIX est une marque déposée aux Etats-Unis et dans d’autres pays et licenciée exclusivement par X/Open Company,Ltd. La notice suivante est applicable à Netscape Communicator™ : Copyright 1995 Netscape Communications Corporation. All rights reserved.
Sun, Sun Microsystems, the Sun logo, AnswerBook, AnswerBook2, Sun Enterprise, Sun StorEdge, SPARCstorage,SPARCserver,ShowMe TV, SunFDDI, SunForum, SunVTS, Ultra, et Solaris sont des marques de fabrique ou des marques déposées, ou marques de service, de Sun Microsystems,Inc. aux Etats-Unis et dans d’autres pays. Toutesles marques SPARCsont utilisées sous licence et sont des marques de fabrique ou des marques déposées de SPARCInternational, Inc. aux Etats-Unis et dans d’autres pays. Les produits portant les marquesSPARCsont basés sur une architecture développée par Sun Microsystems, Inc.
L’interfaced’utilisation graphique OPEN LOOK et Sun™ a été développée par Sun Microsystems, Inc. pour ses utilisateurs et licenciés. Sun reconnaîtles efforts de pionniers de Xerox pour la rechercheet le développement du concept des interfaces d’utilisation visuelle ou graphique pour l’industrie de l’informatique. Sun détient une licence non exclusive de Xerox sur l’interface d’utilisation graphique Xerox, cette licence couvrant également les licenciés de Sun qui mettent en place l’interface d’utilisation graphique OPEN LOOK et qui en outre se conforment aux licences écrites de Sun.
CETTE PUBLICATION EST FOURNIE "EN L’ETAT"ET AUCUNE GARANTIE, EXPRESSE OU IMPLICITE, N’EST ACCORDEE, Y COMPRIS DES GARANTIES CONCERNANT LA VALEURMARCHANDE, L’APTITUDEDE LA PUBLICATIONA REPONDRE A UNE UTILISATION PARTICULIERE,OU LE FAITQU’ELLE NE SOIT PASCONTREFAISANTEDE PRODUIT DE TIERS. CE DENI DE GARANTIE NE S’APPLIQUERAIT PAS, DANS LA MESURE OU IL SERAIT TENU JURIDIQUEMENT NUL ET NON AVENU.
Please
Recycle
Contents
Preface xi
1. Installing Software From the Solaris CD 1
Automatic Installation of Solaris Software 1 Manual Installation of Solaris Software 1
Platform Names and Groups 1 Interactive Installation of Solaris Software 4 Manual Installation of Packages 7
Custom JumpStart Profiles 8 32-bit Kernel the Default on 200MHz or Lower UltraSPARC Systems 9
2. Supported Sun Hardware 11
Supported Platforms 11
3. Installing Software from the Sun Computer Systems Supplement CD 13
Installing Sun Computer Systems Supplement CD Software 14
Before Installing Supplement CD Software 14 Installing Supplement CD Software Using Solaris Web Start 2.0 14 Installing Supplement CD Software on a Standalone System Using
pkgadd 15
iii
Validation Test Suite Software
(SunVTS Software) 18 SunVTS Packages 20
Installing SunVTS 20 Using SunVTS Software 20
OpenGL Software 21
Supported Platforms 21 Removing Old Packages 21 OpenGL Packages 22 Installing OpenGL 23 After Installing the Packages 23 Unexpected Slow Local Rendering 24
PC Launcher 26
Audience 26 What is PC Launcher? 26 PC Launcher Installation Requirements 26 System Requirements 26 PC Launcher Installation 27 Configuring PC Launcher 28 Using PC Launcher 30 Working With Windows Files 30 Other Features 32 Getting Help for PC Launcher 32
PC File Viewer 33
PC File Viewer 33 File Formats Supported 33 PC File Viewer Limitations 34 Installing PC File Viewer 34
iv Solaris 8 6/00 Sun Hardware Platform Guide • June 2000
Adding PC File Viewer to the CDE Front Panel 35
ShowMe TV 1.3 Software 35
ShowMe TV Packages 36 Removing Old Packages 36 Installing ShowMe TV 36 Translated Documentation 37
Sun Remote System Control for Sun Servers 38 SunForum 38
Installing SunForum 39 Online Help 39
Network Adapter Drivers Included on the Supplement CD 39
Installing the Drivers 40 Platform Notes for Network Adapter Drivers 40
Java 3D 1.1.2 API 40
Installation Dependencies 40 Installing Java 3D 1.1.2 API 40
Sun Enterprise 10000 SSP Software 41 Sun Enterprise 10000 Capacity on Demand 1.0 Software 41
4. Documents on the Computer Systems Supplement CD 43
AnswerBook2 Sets 43
Installing Solaris 8 6/00 AnswerBook Sets 43 Solaris 8 6/00 AnswerBook Packages 44 Solaris 8 6/00 on Sun Hardware AnswerBook Set 44 Sun Enterprise 10000 SSP AnswerBook Set 46 Alternate Pathing AnswerBook Set 46 Capacity On Demand AnswerBook Set 46
Sun Computer Systems Manual Page Packages 47
Contents v
Installing Sun Computer Systems Manual Pages 47 Using Sun Computer Systems Manual Pages 47
Other Documents on the Computer Systems Supplement CD 48
5. Updating the Flash PROM on the Ultra 1, Ultra 2, Ultra 450, and Sun Enterprise 450 Systems 49
Related Material 49 Determining If the Flash PROM Needs Updating 50
To Determine If Your System Requires a Flash PROM Update 50
Updating the Flash PROM 51
Capturing Configuration Variable Settings 52 Making the Flash PROM Write-Enabled 53 Before Updating the Flash PROM 57
Recovering From a Power Failure During the Flash PROM Update 61
Sun Ultra 1 and Ultra 2 Systems, Sun Enterprise 450 System, Sun Ultra 450
Workstation 62
Restoring NVRAM Configuration Variables 64 Error Messages 66
Retained Page/mmap Failure 66
Location of Flash PROM Jumpers in Sun Enterprise 450 System and the Ultra 450
Workstation 67
Flash PROM Update Multimedia Collection 69
Running the Video Clips from the CD 69 Running an AnswerBook2 Server from the CD 70
Notes on Running AnswerBook2 from a CD 71
6. Updating the Flash PROM on the Sun Enterprise 3x00, 4x00, 5x00, and 6x00 Systems 73
Determining If the Flash PROM Needs Updating 73
To Determine If Your System Requires a Flash PROM Update 74
vi Solaris 8 6/00 Sun Hardware Platform Guide • June 2000
Updating the Flash PROM 75
Flash PROM Update Process 75 Capturing Configuration Variable Settings 76 Making the Flash PROM Write-Enabled 77 Before Updating the Flash PROM 78
Location of Flash PROM Jumpers in Sun Enterprise Server Systems 87
Installing the P0601 Jumper 88
Recovering From a Power Failure During the Flash PROM Update 90
Sun Enterprise 3x00, 4x00, 5x00, and 6x00 Systems 90
7. Power Management on Sun Hardware 95
Supported Platforms and System Distinctions 95
System Architecture Distinctions
and Default Settings 97
SPARCstation 4 Issues 97
8. Alternate Pathing 2.3 on the Sun Enterprise Servers 99
Preparing to Install or Upgrade 99
To Install or Upgrade From the Web 100 To Install or Upgrade From a CD-ROM 100 To Mount a CD-ROM 101
Performing an Initial Installation of AP 103
Installing AP 2.3 103 Configuring AP 104
Performing an Upgrade of AP 110
Backing Up Your Server 111 Uncommitted AP Database Entries 111 Checking Other Software Documentation 111
Contents vii
Simultaneously Upgrading AP and Solaris Software 111 To Upgrade to AP 2.3 112
9. Installingthe Solaris 8 6/00 Operating Environment onthe Sun Enterprise 10000 Server 117
Knowing Where to Start the Installation 117
What You Need to Start 118
Creating a Domain 118
To Create the eeprom.image File 119 To Create a New Domain on the SSP 120
Performing a Fresh Install 121
To Configure the Domain Network Information 122 To Set Up the SSP 123 To Bring Up the Domain 126 To Set Up the OBP Environment 127 To Install the Solaris 8 6/00 Operating Environment 129 To Configure the OBP Variables 133 To Install the Sun Computer Systems Supplement Packages 134 To Configure the NTP Packages 136 To Finish the Fresh Install 137
Licensing Your Software 138
Performing an Upgrade 138
To Prepare the Domain for the Upgrade 141 To Check the Domain Network Information 143 To Set Up the SSP 143 To Bring Up the Domain 144 To Upgrade the Solaris 8 6/00 Operating Environment 146 To Configure the OBP Variables 150
viii Solaris 8 6/00 Sun Hardware Platform Guide • June 2000
To Install the Sun Computer Systems Supplements Packages 151 To Configure the NTP Packages 153 To Finish the Upgrade 154
A. Localized Packages on the Supplement CD 155
Japanese Localized Packages 155 German Localized Packages 157 Italian Localized Packages 158 French Localized Packages 158 Spanish Localized Packages 159 Swedish Localized Packages 159 Traditional Chinese Localized Packages 160 Simplified Chinese Localized Packages 161 Korean Localized Packages 162
Contents ix
x Solaris 8 6/00 Sun Hardware Platform Guide • June 2000

Preface

The Solaris 8 6/00 Sun Hardware Platform Guide contains important information about the Sun™ hardware supported by the Solaris™ 8 6/00 operating environment.
This manual:
Provides platform-specific installation instructions for the Solaris 8 6/00 software
Describes software provided on the Sun Computer Systems Supplement CD and
explains how to install product software
Describes flash PROM update procedures necessary for some systems to run in
64-bit mode
Describes hardware and software requirements affecting Power
Management™ software
Note – For general Solaris 8 6/00 operating environment installation instructions,
refer to Chapter 1. For information about how to install software contained on the Sun Computer Systems Supplement CD and information about supported hardware, refer to Chapter 3, “Installing Software from the Sun Computer Systems Supplement CD”.
Where to Find Installation Information
The Solaris 8 6/00 software is delivered on three CDs:
Solaris 8 6/00 SPARC Platform Edition CDs (called the Solaris CDs throughout
this manual)
Supplement for Solaris 8 6/00 Operating Environment for Sun Computer Systems
CD (called the Supplement CD throughout this manual).
xi
Before installing the Solaris 8 6/00 software, check TABLE P-1 for listings of manuals with information that may apply to your situation and
TABLE P-2 for specific
installation information.
Note – All Solaris and SPARC documentation can be found on the Documentation
CD. All Sun hardware-specific documentation can be found on the Supplement CD. Some co-packaged products contain documentation on their respective CDs.
TABLEP-1 Related Documentation
Title Description
Solaris 8 SPARC Installation Instructions
Solaris 8 (SPARC Platform Edition) Installation Library
Solaris Advanced Installation Guide Contains additional information about how to
TABLEP-2 Specific Installation Information
Primary installation manual for this release of the Solaris operating environment from the Documentation CD
Supplements the Solaris Start Here card by providing detailed installation information
install the Solaris operating environment on server systems
If you want to Go to
Know more about new products
Chapter 3 in this manual
and peripherals Know about late-breaking news 1. Solaris 8 6/00 Release Notes Supplement for Sun
Hardware
2. Solaris 8 6/00 Release Notes
Begin the installation process from the Solaris CDs
Install software for your
1. Solaris 8 6/00 Sun Hardware Platform Guide
2. Solaris 8 SPARC Installation Instructions
Chapter 3 in this manual platform/peripheral from the Supplement CD
Update your flash PROM for
Chapter 5 and Chapter 6 in this manual 64-bit operation
Install an AnswerBook from the
Chapter 4 in this manual Supplement CD
xii Solaris 8 6/00 Sun Hardware Platform Guide • June 2000
How This Book Is Organized
This book is organized as follows: Chapter 1 supports the Solaris 8 Start Here card by providing additional installation
instructions on how to install or upgrade to the Solaris 8 6/00 software on specific Sun platforms and hardware options.
Chapter 2 lists supported Sun hardware. Chapter 3 describes how to install the software for Sun platforms and hardware
options and describes value-added software provided to users of Sun hardware. Chapter 4 describes the locations and formats for the documentation on the
Computer Systems Supplement CD. Chapter 5 describes the procedure for updating the flash PROMs for 64-bit operation
on Ultra 1, Ultra 2, Ultra 450, and Sun Enterprise 450 systems. Chapter 6 describes the procedure for updating the flash PROMs for 64-bit operation
on Sun Enterprise 3x00, 4x00, 5x00, and 6x00 systems. Chapter 7 describes the hardware and software requirements for running the Power
Management software on Sun hardware. Chapter 8 describes installation of Alternate Pathing software. Chapter 9 describes installation of the Solaris 8 6/00 operating environment on the
Sun Enterprise 10000 server
Preface xiii
Typographic Conventions
TABLEP-3 Typographic Conventions
Typeface or Symbol Meaning Example
AaBbCc123 The names of commands, files,
and directories; on-screen computer output
AaBbCc123
AaBbCc123 Command-line placeholder:
AaBbCc123 Book titles, new words or
What you type, contrasted with on-screen computer output
replace with a real name or value
terms, or words to be emphasized
Edit your .login file. Use ls -a to list all files.
machine_name% You have mail.
machine_name% su Password:
To delete a file, type rm filename.
Read Chapter 6 in User’s Guide. These are called class options. You must be root to do this.
Sun Documentation on the Web
The docs.sun.com web site enables you to access Sun technical documentation on the Web. You can browse the docs.sun.com archive or search for a specific book title or subject at:
http://docs.sun.com
Sun Welcomes Your Comments
We are interested in improving our documentation and welcome your comments and suggestions. You can email your comments to us at:
docfeedback@sun.com
Please include the part number of your document in the subject line of your email.
xiv Solaris 8 6/00 Sun Hardware Platform Guide • June 2000
Ordering Sun Documentation
Fatbrain.com, an Internet professional bookstore, stocks select product documentation from Sun Microsystems, Inc.
For a list of documents and how to order them, visit the Sun Documentation Center on Fatbrain.com at:
http://www1.fatbrain.com/documentation/sun
Preface xv
xvi Solaris 8 6/00 Sun Hardware Platform Guide • June 2000
CHAPTER
1

Installing Software From the Solaris CD

Automatic Installation of Solaris Software

For the Sun™ hardware listed in TABLE 1-1, the Solaris™ 8 release requires no special installation or upgrade instructions. If you plan to perform an automatic installation of the Solaris 8 6/00 operating environment on your Sun hardware, refer to the
Solaris 8 (SPARC Platform Edition) Installation Guide or the Solaris Advanced Installation Guide for all your installation needs.

Manual Installation of Solaris Software

If you are installing the Solaris 8 6/00 operating environment using the manual (or interactive) method, you may need to add some software packages and clusters. This section identifies platform-specific installation needs and lists the required software packages and clusters. The manual installation method is described in the “Planning Your Installation” module of the Solaris 8 (SPARC Platform Edition) Installation Guide.

Platform Names and Groups

You need to know your system architecture (platform group), if you are performing one of the following tasks:
1
Setting up a boot server on a subnet
Adding clients for network installation (standalone, servers, dataless, diskless)
If you are writing a custom JumpStart™ installation rules file, you need to know the platform name.
TABLE 1-1 shows the platform names and platform groups of various Sun hardware
systems.
TABLE1-1 Platform Names for Sun Systems
System Platform Name Platform Group
SPARCclassic SUNW,SPARCclassic sun4m SPARCstation LX SUNW,SPARCstation-LX sun4m SPARCstation LX+ SUNW,SPARCstation-LX+ sun4m SPARCstation 4 SUNW,SPARCstation-4 sun4m SPARCstation 5 SUNW,SPARCstation-5 sun4m SPARCstation 5 Model 170 SUNW,SPARCstation-5 sun4m SPARCstation 10 SUNW,SPARCstation-10 sun4m SPARCstation 10SX SUNW,SPARCstation-10,SX sun4m SPARCstation 20 SUNW,SPARCstation-20 sun4m Ultra 1 Model 140 SUNW,Ultra-1 sun4u Ultra 1 Model 170 SUNW,Ultra-1 sun4u Ultra 1 Creator Model 140E SUNW,Ultra-1 sun4u Ultra 1 Creator3D Model 140E SUNW,Ultra-1 sun4u Ultra 1 Creator Model 170E SUNW,Ultra-1 sun4u Ultra 1 Creator 3D Model 170E SUNW,Ultra-1 sun4u Ultra 1 Creator Model 200E SUNW,Ultra-1 sun4u Ultra 1 Creator3D Model 200E SUNW,Ultra-1 sun4u Sun Enterprise 1 Model 140 SUNW,Ultra-1 sun4u Sun Enterprise 1 Model 170 SUNW,Ultra-1 sun4u Sun Enterprise 1 Model 170E SUNW,Ultra-1 sun4u Ultra 2 Creator Model 1170 SUNW,Ultra-2 sun4u Ultra 2 Creator3D Model 1170 SUNW,Ultra-2 sun4u Ultra 2 Creator Model 2170 SUNW,Ultra-2 sun4u Ultra 2 Creator3D Model 2170 SUNW,Ultra-2 sun4u
2 Solaris 8 6/00 Sun Hardware Platform Guide • June 2000
TABLE1-1 Platform Names for Sun Systems (Continued)
System Platform Name Platform Group
Ultra 2 Creator Model 1200 SUNW,Ultra-2 sun4u Ultra 2 Creator3D Model 1200 SUNW,Ultra-2 sun4u Ultra 2 Creator Model 2200 SUNW,Ultra-2 sun4u Ultra 2 Creator 3D Model 2200 SUNW,Ultra-2 sun4u Ultra 2 Creator Model 1300 SUNW,Ultra-2 sun4u Ultra 2 Creator Model 2300 SUNW,Ultra-2 sun4u Ultra 5 SUNW,Ultra-5_10 sun4u Ultra 10 SUNW,Ultra-5_10 sun4u Ultra 30 SUNW,Ultra-30 sun4u Ultra 60 SUNW,Ultra-60 sun4u Ultra 450 SUNW,Ultra-4 sun4u Sun Enterprise 2 Model 1170 SUNW,Ultra-2 sun4u Sun Enterprise 2 Model 2170 SUNW,Ultra-2 sun4u Sun Enterprise 2 Model 1200 SUNW,Ultra-2 sun4u Sun Enterprise 2 Model 2200 SUNW,Ultra-2 sun4u Sun Enterprise 2 Model 1300 SUNW,Ultra-2 sun4u Sun Enterprise 2 Model 2300 SUNW,Ultra-2 sun4u Sun Enterprise 150 SUNW,Ultra-1 sun4u Sun Enterprise 250 SUNW,Ultra-250 sun4u Sun Enterprise 450 SUNW,Ultra-4 sun4u Sun Enterprise 3000 SUNW,Ultra-Enterprise sun4u Sun Enterprise 4000 SUNW,Ultra-Enterprise sun4u Sun Enterprise 5000 SUNW,Ultra-Enterprise sun4u Sun Enterprise 6000 SUNW,Ultra-Enterprise sun4u Sun Enterprise 3500 SUNW,Ultra-Enterprise sun4u Sun Enterprise 4500 SUNW,Ultra-Enterprise sun4u Sun Enterprise 5500 SUNW,Ultra-Enterprise sun4u Sun Enterprise 6500 SUNW,Ultra-Enterprise sun4u
Chapter 1 Installing Software From the Solaris CD 3
TABLE1-1 Platform Names for Sun Systems (Continued)
System Platform Name Platform Group
Sun Enterprise 10000 SUNW,Ultra-Enterprise sun4u SPARCserver 1000 SUNW,SPARCserver-1000 sun4d SPARCcenter 2000 SUNW,SPARCcenter-2000 sun4d
Refer to the Solaris 8 SPARC (SPARC Platform Edition) Installation Guide manual for further information on platform groups for all other systems.

Interactive Installation of Solaris Software

When you install the Solaris 8 6/00 operating environment from the Solaris CDs, all of the required software clusters and packages for your Sun hardware are automatically loaded. If you choose to customize your Solaris 8 6/00 software configuration using the interactive installation method, refer to
TABLE 1-3 to identify which software packages and clusters are needed.
TABLE1-2 Required Software Clusters and Packages for Sun Hardware
Product Name Cluster or Package Name Description
S24 frame buffer SUNWCtcx TCX API Support SX frame buffer SUNWCsx SX Support Creator and Creator3D SUNWxilvl
SUNWCffb SUNWffbx 64-bit Support
Creator and Creator3D (Series 2)
Elite3D SUNWCafb Elite3D Device Drivers and Pipelines
PGX Graphics Frame Buffer SUNWCm64 M64 Graphics Support
SUNWxilvl Creator Graphics Device Drivers and SUNWCffb SUNWffbx 64-bit Support
SUNWafbmn Elite3D Online Manual Pages SUNWafbx 64-bit Support
SUNWm64x 64-bit Support
Creator Graphics Device Drivers and Pipelines
Pipelines
TABLE 1-2 and
4 Solaris 8 6/00 Sun Hardware Platform Guide • June 2000
TABLE1-2 Required Software Clusters and Packages for Sun Hardware (Continued)
Product Name Cluster or Package Name Description
PGX32 Graphics Frame Buffer TSIpgx.u Device driver for PGX32 (Raptor GFX)
graphics accelerator
TSIpgxmn PGX32 (Raptor GFX) graphics accelerator
manual pages
TSIpgxw X Server loadable module for PGX32
(Raptor GFX) graphics accelerator
TSIpgxx.u Device driver for PGX32 (Raptor GFX)
graphics accelerator (64-bit)
SPARCstorage Array (Models 100 or 200)
SUNWssad SUNWssaop
SPARCstorage Array Support Software
SUNWssdx 64-bit Support
Sun StorEdge A5000 SUNWClux
Sun StorEdge A5000 Support Software
SUNWses SUNWluxdx.u
64-bit Support
SUNWluxlx
SunSwift SBus Adapter SUNWChmd SunSwift SBus Adapter Drivers
SUNWhmdx 64-bit Support
SunSwift PCI Adapter SUNWChmd SunSwift PCI Adapter Drivers
SUNWhmdx 64-bit Support
SPARCstation 4 SUNWCtcx TCX API Support SPARCstation 5 SUNWCtcx TCX API Support SPARCstation 10SX SUNWCsx SX End User SPARCstation 20 SUNWCsx SX End User Ultra 1 Series SUNWxilvl VIS/XIL Support Ultra 1 Creator Series, Ultra 2
Creator Series, and Sun Enterprise X000 Series
SUNWxilvl SUNWCffb
VIS/XIL Support Creator Graphics Device Drivers and Pipelines
SUNWChmd SunSwift SBus Adapter Drivers SUNWffbx
64-bit Support
SUNWhmdx
Chapter 1 Installing Software From the Solaris CD 5
TABLE1-2 Required Software Clusters and Packages for Sun Hardware (Continued)
Product Name Cluster or Package Name Description
Ultra 5, Ultra 10, and Ultra 30 SUNWxilvl VIS/XIL Support
SUNWCffb Creator Graphics Device Drivers and
Pipelines
SUNWCm64 M64 Graphics Support SUNWChmd SunSwift SBus Adapter Drivers SUNWffbx
64-bit Support
SUNWhmdx SUNWm64x
Ultra 60 SUNWxilvl VIS/XIL Support
SUNWCffb Creator Graphics Device Drivers and
Pipelines
SUNWCm64 M64 Graphics Support SUNWChmd SunSwift SBus Adapter Drivers SUNWffbx
64-bit Support
SUNWm64x
Ultra 450 and Sun Enterprise 450
SUNWCpd Drivers for SPARC platforms with PCI bus SUNWpdx 64-bit Support
Sun Enterprise 10000 SUNWC4u1 Sun Enterprise 10000 Support
SUNWcvcx 64-bit Support
6 Solaris 8 6/00 Sun Hardware Platform Guide • June 2000

Manual Installation of Packages

If you are installing at the package level, refer to TABLE 1-3 for the software packages required for specific hardware.
TABLE1-3 Required Packages for Hardware Platforms and Options
Product Name Package Name
SX frame buffer SUNWsxr.m
SUNWsx SUNWsxow SUNWxilcg SUNWsxxgl
S24 or FSV frame buffer SUNWtcx.m
SUNWtcxu SUNWtcxow
Creator and Creator3D (including Series 2) SUNWffb.u
SUNWffbcf SUNWffbw SUNWffbxg SUNWxilvl
Elite3D SUNWafb.u
SUNWafbcf SUNWafbmn SUNWafbr SUNWafbw SUNWafbxg
PGX Graphics Frame Buffer SUNWm64.u
SUNWm64w SUNWm64cf
PGX32 Graphics Frame Buffer TSICpgx.u
TSIpgxmn TSIpgxw TSIpgxx.u
SunSwift SBus Adapter SUNWhmd
SUNWhmdu
SunSwift PCI Adapter SUNWhmd
SUNWhmdu
SPARCstorage Array, model 100/200 SUNWssad
SUNWssaop
Chapter 1 Installing Software From the Solaris CD 7
TABLE1-3 Required Packages for Hardware Platforms and Options (Continued)
Product Name Package Name
Sun StorEdge A5000 SUNWluxal
SUNWluxdv.d SUNWluxdv.u SUNWluxdv.u1 SUNWluxmn SUNWluxop SUNWses
Ultra 1 Series SUNWxilvl Ultra 1 Creator Series, Ultra 2 Creator Series,
Ultra 5, Ultra 10, Ultra 60, or Sun Enterprise X000 Series
Ultra 5, Ultra 10, Ultra 60, Ultra 250, Ultra 450, and Sun Enterprise 450
Sun Enterprise 10000 SUNWcvcr.u
SUNWffb.u SUNWffbcf SUNWffbw SUNWffbxg SUNWxilvl SUNWhmd SUNWhmdu
SUNWpd SUNWpdu

Custom JumpStart Profiles

For information on the availability of the custom JumpStart™ method at your site, consult your system administrator. software options that may require additional entries in custom profiles. These clusters might not be installed with the core distribution software group. Refer to the Solaris 8 (SPARC Platform Edition) Installation Guide manual for more information.
When writing Custom JumpStart profiles, be sure to allow sufficient space in the root partition for software from the Supplement CD, such as software for SunVTS diagnostics.
8 Solaris 8 6/00 Sun Hardware Platform Guide • June 2000
TABLE 1-4 lists platforms and hardware and
Note – For more information about automating Solaris installations, refer to
Automating Solaris Installations: A Custom JumpStart Guide (Kasper/McClellan), a SunSoft Press/Prentice Hall publication.
TABLE1-4 Additional Entries for Custom JumpStart Installations
Product Name Package Name
SX Frame Buffer cluster SUNWCsx S24 or FSV Frame Buffer cluster SUNWCtcx Creator and Creator3D Graphics
(including Series 2) Elite3D cluster SUNWCafb
PGX Graphics Frame Buffer cluster SUNWCm64 PGX32 Graphics Frame Buffer TSIpgx
SunSwift SBus Adapter cluster SUNWChmd SunSwift PCI Adapter cluster SUNWChmd SPARCstation 10SX cluster SUNWCsx SPARCstation 20 cluster SUNWCsx Ultra 5, Ultra 10, Ultra 60, Ultra 250,
Ultra 450 and Sun Enterprise 450 Sun Enterprise 10000 cluster SUNWC4u1
cluster SUNWCffb package SUNWxilvl
package SUNWafbmn
TSIpgxmn TSIpgxx.u
cluster SUNWCpd

32-bit Kernel the Default on 200MHz or Lower UltraSPARC Systems

On UltraSPARC systems with 200MHz or lower processors, it is possible for a user to run a 64-bit program designed to exploit a problem that could cause a processor to stall. Since 64-bit programs cannot run on the Solaris 32-bit kernel, the Solaris 32-bit kernel is booted by default on these systems.
Chapter 1 Installing Software From the Solaris CD 9
The code sequence that exploits the problem is very unusual, and is not likely to be generated by a compiler. Assembler code had to be specifically written to demonstrate the problem. It is highly unlikely that a legitimate handwritten assembler routine would use this code sequence.
Users willing to assume the risk that a user might accidentally or deliberately run a program that was designed to cause a processor to stall may choose to run the Solaris 64-bit kernel on these systems.
You can determine the speed of your processor(s) by typing:
# /usr/sbin/psrinfo -v
You can change the default kernel from 32-bit on a system by modifying the boot policy file. Edit the /platform/platform-name/boot.conf file so that it contains an uncommented line with the variable named ALLOW_64BIT_KERNEL_ON_UltraSPARC_1_CPU set to the value true as shown in the example that follows:
ALLOW_64BIT_KERNEL_ON_UltraSPARC_1_CPU=true
See boot(1M) for more information about changing the default kernel. You may also purchase an upgrade to your system, contact your Sun representative
for details.
10 Solaris 8 6/00 Sun Hardware Platform Guide • June 2000
CHAPTER
2

Supported Sun Hardware

Supported Platforms

Note – Not all platforms and peripheral devices listed in this chapter are
compatible. Contact your authorized Sun support provider for support information.
SPARCclassic™
SPARCstation LX
SPARCstation 4
SPARCstation 5
SPARCstation 5 Model 170
SPARCstation 10
SPARCstation 10SX
SPARCstation 20
SPARCstation 20 Model HS11, HS12, HS14, HS21, HS22, 151, and 152
Ultra™ 1 Model 140, 170
Ultra 1 Creator Model 140E, 170E, 200E
Ultra 1 Creator3D Model 140E, 170E, 200E
Sun Enterprise™ 1 Model 140, 170, 170E
Ultra 2 Creator Model 1170, 2170, 1200, 2200, 1300, 2300
Ultra 2 Creator3D Model 1170, 2170, 1200, 2200
Ultra 5
Ultra 10
Ultra 30
Ultra 60
Ultra 450
11
Sun Enterprise 2 Model 1170, 2170, 1200, 2200, 1300, 2300
Sun Enterprise 150
Sun Enterprise 250
Sun Enterprise 450
Sun Enterprise 3000
Sun Enterprise 4000
Sun Enterprise 5000
Sun Enterprise 6000
Sun Enterprise 3500
Sun Enterprise 4500
Sun Enterprise 5500
Sun Enterprise 6500
Sun Enterprise 10000
SPARCserver™ 1000 and 1000E
SPARCcenter 2000 and 2000E
12 Solaris 8 6/00 Sun Hardware Platform Guide • June 2000
CHAPTER
3

Installing Software from the Sun Computer Systems Supplement CD

This chapter describes the contents and the installation of the Sun Computer Systems Supplement CD, which contains software for these Sun products:
SunVTS™ 4.0 diagnostic software
OpenGL® 1.2.1 software
PC launcher/PC file viewer 1.0.1/1.0.1 software
ShowMe TV™ 1.3 software
Sun hardware manual pages
Solaris 8 6/00 AnswerBook™ Set
SunFDDI™ PCI 3.0 driver
SunFDDI SBus 7.0 driver
SunHSI PCI 3.0 driver
SunHSI SBus 3.0 driver
Sun Gigabit Ethernet 3.0 driver
SunATM 5.0 driver
SunForum™ 3.0 software
Remote System Control (RSC) 1.0 for Sun Enterprise Servers
Java 3D™ 1.1.2 software
Sun Enterprise 10000 System Service Processor (SSP) 3.3 software
Sun Enterprise 10000 System Service Processor (SSP) 3.3 AnswerBook
Sun Enterprise 10000 Capacity on Demand 1.0 software
Sun Enterprise 10000 Capacity on Demand 1.0 AnswerBook
Sun Enterprise Server Alternate Pathing 2.3 (AP) software
13

Installing Sun Computer Systems Supplement CD Software

There are at least two ways to install software from the supplement CD:
Solaris Web Start 2.0
pkgadd

Before Installing Supplement CD Software

If you have installed any of the Supplement CD software from a previous release, you should remove the packages associated with that software before installing the new software.

Installing Supplement CD Software Using Solaris Web Start 2.0

You can use Solaris Web Start 2.0 to install Supplement CD software after you have installed the Solaris operating environment.

To Install Supplement CD Software Using Solaris Web Start 2.0

1. Insert the Supplement CD into your CDROM drive.
2. In a shell, type:
# cd /cdrom/cdrom0 # ./installer
3. When the Solaris Web Start GUI is displayed, select Next.
4. See
14 Solaris 8 6/00 Sun Hardware Platform Guide • June 2000
TABLE 3-1 on page 15. In the Solaris Web Start 2.0 column, software is labeled
“Installed by default” or “Optional”. a. If you want to install all of the default installed software, click Default Install,
then click Next.
b. If you only want to install some of the software products, click Custom Install,
then click Next. Select the software you want to install, then click Next.
TABLE3-1 Supplement Software Installation
Software Solaris Web Start 2.0
SunVTS software Installed by default OpenGL 1.2.1 software Installed by default PC launcher and PC file viewer Installed by default ShowMe TV 1.3 software Installed by default Solaris on Sun Hardware AnswerBook Set Installed by default SunFDDI drivers Installed by default SunHSI drivers Installed by default Sun GigabitEthernet driver Installed by default SunATM driver Installed by default SunForum software Installed by default Java 3D 1.1.2 software Installed by default Remote System Control (RSC) for Sun Enterprise Servers Optional Sun Enterprise 10000 SSP 3.3 software Optional Sun Enterprise 10000 SSP 3.3 AnswerBook set Optional Alternate Pathing 2.3 software Optional Capacity On Demand (COD) 1.0 software Optional Capacity On Demand (COD) 1.0 AnswerBook set Optional

Installing Supplement CD Software on a Standalone System Using pkgadd

To install packages for supported products from the Supplement CD using pkgadd

1. Insert the Supplement CD into your CD-ROM drive.
The File Manager window is displayed.
2. In a shell, become superuser using the su command and the superuser password.
Chapter 3 Installing Software from the Sun Computer Systems Supplement CD 15
3. Type:
# /usr/sbin/pkgadd -d /cdrom/cdrom0/directory/Product package_names
or:
# cd /cdrom/cdrom0/directory/Product # pkdadd -d . package_names
where directory is the software product directory from are the package names from
TABLE 3-2.
TABLE 3-2 and package_names
The argument to the -d option must be a full path name to a device or directory. If you do not specify the device on which the package resides, pkgadd checks the default spool directory (/var/spool/pkg). If the package is not there, installation fails.
To install a particular product, choose the appropriate packages:
TABLE3-2 Software and Packages
Software Version Directory Packages
Validation Test Suite Software (SunVTS) 4.0 SunVTS_4.0/ SUNWvts
SUNWvtsmn SUNWvtsx SUNWodu SUNWeswsa SUNWeswga SUNWsycfd
OpenGL Runtime Libraries Software 1.2.1 OpenGL_1.2.1/ SUNWafbgl
SUNWafbgx SUNWffbgl SUNWffbgx SUNWifbgl SUNWifbgx SUNWglh SUNWglrt SUNWglrtu SUNWglrtx SUNWglsr SUNWglsrx SUNWglsrz
PClauncher/PC file viewer 1.0.1/
1.0.1
PC_launcher_1.0.1_PC_fileviewer_1.0.1/ SUNWdtpcv
SUNWdtpcz SUNWdtpcp
16 Solaris 8 6/00 Sun Hardware Platform Guide • June 2000
TABLE3-2 Software and Packages (Continued)
Software Version Directory Packages
Remote System Control Server Software 1.0 RSC_1.0/ SUNWrsc
SUNWrscj
ShowMe TV 1.3 ShowMeTV_1.3/ SUNWsmtvh
SUNWsmtvr SUNWsmtvt SUNWsmtvu
SunForum 3.0 SunForum_3.0 SUNWdat
SUNWdatu
SunFDDI PCI Driver Software 3.0 SunFDDI_PCI_3.0/ SUNWpfd
SUNWpfh SUNWpfm SUNWpfu
SunFDDI SBus Driver Software 7.0 SunFDDI_SBus_7.0/ SUNWnfd
SUNWnfh SUNWnfm SUNWnfu
Sun GigabitEthernet Software 3.0 Sun_GigabitEthernet_3.0/ SUNWged
SUNWgedm SUNWgedu
SunHSI PCI Driver Software 3.0 SunHSI_PCI_3.0/ SUNWhsip
SUNWhsipm SUNWhsipu
SunHSI SBus Driver Software 3.0 SunHSI_SBus_3.0/ SUNWhsis
SUNWhsism
SUNWhsisu Sun Hardware AnswerBook2 1.0 Sun_Hardware_Answerbook/ SUNWabhdw Java 3D 1.1.2 Java3D_1.1.2/ SUNWj3doc
SUNWj3dem
SUNWj3drt
SUNWj3dut SunATM 5.0 5.0 SunATM_5.0/ SUNWatm
SUNWatma
SUNWatmu Alternate Pathing 2.3 Alternate_Pathing_2.3/ SUNWapdoc
SUNWapdv
SUNWapr
SUNWapu
Chapter 3 Installing Software from the Sun Computer Systems Supplement CD 17
TABLE3-2 Software and Packages (Continued)
Software Version Directory Packages
Sun Enterprise 10000 SSP 3.2 System_Service_Processor_3.3/ SUNWsspdf
SUNWsspdo SUNWsspdr SUNWsspfp SUNWsspid SUNWsspmn SUNWsspob SUNWsspop SUNWssppo SUNWsspr SUNWsspst SUNWsspue
Sun Enterprise 10000 SSP AnswerBook 1.0 System_Service_Processor_3.3_
Answerbook/
Sun Enterprise 10000 Capacity On Demand (COD) software and AnswerBook
1.0 Capacity_on_Demand_1.0/ SUNWcod
SUNWuessp
SUNWcodbk SUNWcodmn
If a problem occurs during package installation, information about the problem is displayed, followed by this prompt:
Do you want to continue with this installation?
Respond with either yes, no,orquit.

Validation Test Suite Software (SunVTS Software)

The SunVTS validation test suite is a diagnostic tool designed to test Sun hardware. By running multiple diagnostic hardware tests, the SunVTS software verifies the connectivity and functionality of most SPARC hardware controllers and devices in a 32-bit or 64-bit Solaris operating environment.
SunVTS provides an infrastructure for programmers to develop their own tests and run them using the SunVTS interface.
You can find the software for the SunVTS application on the Supplement CD. To use the SunVTS software, refer to the SunVTS 4.0 User’s Guide, SunVTS 4.0 Test Reference Manual, and the SunVTS Quick Reference Card.
18 Solaris 8 6/00 Sun Hardware Platform Guide • June 2000
TABLE 3-3 describes the main features of the SunVTS environment.
TABLE3-3 SunVTS Diagnostic Tool Features
Feature Description
SunVTS kernel (vtsk) The SunVTS kernel controls all aspects of the testing. It is
a daemon designed to stay in the background, and to be used when needed. Upon starting, the SunVTS kernel probes the hardware configuration of the system under test and waits for instructions from a user interface. During testing, the SunVTS kernel coordinates the running of individual tests, and manages all the messages (informational and error messages) sent by these tests.
SunVTS CDE user interface (vtsui)
This interface is designed to run on top of the Common Desktop Environment (CDE). It will also run on top of OpenWindows if the CDE package SUNWdtbas is installed. This user interface provides the means to configure, run, and monitor SunVTS test sessions for local and remote hosts.
SunVTS OPEN LOOK user interface (vtsui.o1)
This interface is designed to be run on top of OpenWindows. The SunVTS OPEN LOOK user interface may not support the latest SunVTS features. For full feature support, use the SunVTS CDE or TTY interface. The SunVTS OPEN LOOK user interface will be sustained, but not enhanced, as long as OPEN LOOK is supported in the Solaris environment.
SunVTS TTY user interface (vtstty)
Because not every system has a monitor, SunVTS has a TTY interface. This ASCII menu-based interface accepts various key sequences to control the test options and the test sessions. It can be used from a terminal, a shelltool, or a modem.
Running an individual test from the command line
Besides being run from a SunVTS user interface, each individual hardware test can be run from a UNIX® command line. Running a test alone can be helpful to validate only one piece of hardware.
Custom test support A SunVTS user can run third-party executable test
binaries under the SunVTS environment in the way that the test, rather than the SunVTS kernel, fully controls its input argument list and output log files. A user can simply modify the .customtest file provided by SunVTS to make it loosely coupled to the environment.
Chapter 3 Installing Software from the Sun Computer Systems Supplement CD 19

SunVTS Packages

TABLE 3-4 provides a list of SunVTS packages needed to run the SunVTS diagnostic
tool.
TABLE3-4 SunVTS Packages on the Supplement CD
Includes Packages Name Description
SUNWvts Validation Test Suite SunVTS kernel, User Interface (UI),
tests and tools
SUNWvtsmn Validation Test Suite Manual
Pages
SUNWsycfd Enterprise server
SUNWeswsa Ultra desktop
SUNWeswga Workgroup server
SUNWvtsx SUNWCvts
SUNWodu Online Validation Test Suite
Validation Test Suite 64-Bit Validation Test Suite software
Diagnostics
Manual pages for SunVTS utilities/ binaries
configuration reader
configuration reader
configuration reader
Online diagnostics tool software

Installing SunVTS

See “Installing Sun Computer Systems Supplement CD Software” on page 14.

Using SunVTS Software

To use SunVTS software, refer to the SunVTS 4.0 User’s Guide in the Solaris 8 6/00 on Sun Hardware AnswerBook set. For SunVTS test and quick reference information, refer to the SunVTS 4.0 Test Reference Manual and SunVTS Quick Reference Card.
20 Solaris 8 6/00 Sun Hardware Platform Guide • June 2000

OpenGL Software

The Sun OpenGL software for Solaris is Sun’s native implementation of the OpenGL application programming interface (API). The OpenGL API is an industry-standard, vendor-neutral graphics library. It provides a small set of low-level geometric primitives and many basic and advanced 3D rendering features, such as modeling transformations, shading, lighting, anti-aliasing, texture mapping, fog, and alpha blending.

Supported Platforms

The Sun OpenGL 1.2.1 software for Solaris supports the following devices:
Creator Graphics, Creator3D Graphics, Elite3D Graphics, and Expert3D
Graphics—OpenGL functionality is accelerated in hardware.
SX, GX, GX+, TGX, TGX+, S24—OpenGL functionality is performed in software.
All Sun SPARC
supported on the OpenGL 1.2.1 software: the TCX, SX, GX, Creator, Elite3D, and Expert3D families of frame buffers. This includes Ultra desktop, Sun Enterprise and all the legacy SPARCstation family.

Removing Old Packages

TM
systems equipped with the following frame buffers are
If you have older versions of the Sun OpenGL software for Solaris packages, you must use the pkgrm command to remove them.
Chapter 3 Installing Software from the Sun Computer Systems Supplement CD 21

To Remove Old Packages

1. Check to see whether any older versions of the OpenGL packages are installed using the pkginfo command.
The pkginfo | egrep -i “OpenGL” command lists any existing OpenGL packages that you have installed.
% pkginfo | egrep -i “OpenGL” application SUNWffbgl Creator Graphics (FFB) OpenGL Support application SUNWglrt OpenGL Runtime Libraries application SUNWglrtu OpenGL Platform Specific Runtime Libraries application SUNWglwrt OpenGL Widget Library application SUNWafbgl Loadable pipeline for UPA Bus Elite3D graphics application SUNWgldoc Solaris OpenGL Documentation and Man Pages application SUNWglh Solaris OpenGL Header Files application SUNWglut Solaris OpenGL Utilities and Example Programs application SUNWglwh Solaris OpenGL Widget Header Files
2. To remove the packages, become superuser:
% su Password: superuser password
3. Run pkgrm to remove all existing Sun OpenGL software for Solaris packages.
# pkgrm SUNWglrt SUNWglh...

OpenGL Packages

TABLE 3-5 lists the packages that are provided with the Sun OpenGL software for
Solaris.
TABLE3-5 OpenGL Packages
Package Name Description Default Install Location
SUNWCogl OpenGL software cluster SUNWglh OpenGL header files /usr SUNWglrt OpenGL client-side runtime libraries /usr/openwin/lib
22 Solaris 8 6/00 Sun Hardware Platform Guide • June 2000
TABLE3-5 OpenGL Packages (Continued)
Package Name Description Default Install Location
SUNWglsr OpenGL generic SPARC software
renderer
SUNWglrtu UltraSPARC™-specific OpenGL
libraries
SUNWglsrz OpenGL UltraSPARC software
renderer
SUNWafbgl OpenGL device pipeline for Elite3D
graphics accelerators
SUNWffbgl OpenGL device pipeline for Creator
and Creator3D graphics accelerators
SUNWifbgl OpenGL device pipeline for
Expert3D graphics accelerator
SUNWglrtx Sun OpenGL 64-bit Runtime
Libraries
SUNWglsrx OpenGL64-bit UltraSPARCsoftware
renderer
SUNWafbgx OpenGL 64-bit device pipeline for
Elite3D graphics accelerator
SUNWffbgx OpenGL 64-bit device pipeline for
Creator and Creator3D graphics accelerators
SUNWifbgx OpenGL 64-bit device pipeline for
Expert3D graphics accelerator
/usr/openwin/lib
/usr/openwin/platform/ sun4u/lib/GL
/usr/openwin/platform/ sun4u/lib/GL
/usr/openwin/lib/GL/ devhandlers
/usr/openwin/lib/GL/ devhandlers
/usr/openwin/lib/GL/ devhandlers
/usr/openwin
/usr/ipenwin/platform/ sun4u/lib/sparcv9/GL
/usr/openwin/lib/sparcv9/ GL/devhandlers
/usr/openwin/lib/sparcv9/ GL/devhandlers
/usr/openwin/lib/sparcv9/ GL/devhandlers

Installing OpenGL

See “Installing Sun Computer Systems Supplement CD Software” on page 14.

After Installing the Packages

After installing the packages, do the following:
Chapter 3 Installing Software from the Sun Computer Systems Supplement CD 23

To Verify Package Installation

1. Exit the window system and restart it so that the window system loads the newly installed GLX server extension.
2. To verify that the OpenGL libraries are installed correctly, run ogl_install_check.
The ogl_install_check test program prints the version of the OpenGL library and renderer used, and renders a rotating wheel. The program returns the following output when it is run on an UltraSPARC Creator3D:
OpenGL Vendor: Sun Microsystems, Inc. OpenGL Version: 1.2.1 Sun OpenGL 1.2.1 for Solaris
For diagnostic purposes, the following values should be noted if Solaris OpenGL software problems are seen:
OpenGL Renderer: Creator 3D, VIS OpenGL Extension Support: GL_EXT_texture3D GL_SGI_color_table GL_SUN_geometry_compression GL_EXT_abgr GL_EXT_rescale_normal OpenGL GLX Server: Detail Status Report GLX: Context is direct. GLX: OpenGL Rendering in use GLX: Double Buffering in use GLX: Color Buffer (GLX_BUFFER_SIZE) = 24 bits GLX: Depth Buffer (GLX_DEPTH_SIZE) = 28 bits GLX: Stencil Buffer (GLX_STENCIL_SIZE) = 4 bits GLX: RGBA (True Color/Direct Color) Visual in use OpenGL Library: Detail Status Report Number of color bits (R/G/B/A): 8/8/8/0 Frame Buffer Depth (GL_DEPTH_BITS):28

Unexpected Slow Local Rendering

Whenever possible, Sun OpenGL software for Solaris renders directly to the frame buffer, bypassing the X server. This is enabled by Sun’s DGA mechanism for locking portions of the screen. However, a Solaris security feature only allows the user who originally logged in to the window system to use DGA to lock portions of the screen. Only owners of the window system have access to DGA.
24 Solaris 8 6/00 Sun Hardware Platform Guide • June 2000
If you notice poor performance when rendering locally, the cause may be this Solaris security feature. For example, if you start the window system, and another user at the workstation changes to that user’s own environment using su, the application will not run via DGA even though the second user is running the application locally.
If you notice slow local rendering, run the ogl_install_check diagnostic program (found in /usr/openwin/demo/GL) to determine whether the application is running via DGA. If the OpenGL GLX server status report from the ogl_install_check program says that the GLX context is indirect, edit the login permissions to enable DGA access for all users.
To give all local users access to DGA, follow these steps:

To Give All Local Users Access to DGA

1. Become superuser:
% su Password: superuser password
2. Edit permissions to allow world read/write access to the following devices:
% chmod 666 /dev/mouse /dev/kbd /dev/sound/* /dev/fbs/*
This will enable DGA access for all users for the duration of the current window system session (subject to X authorization, see xhost(1)).
3. Edit the /etc/logindevperm file and change the default permissions of all devices listed in the file to 0666 to allow world read/write access.
For example, in the following lines in logindevperm, change 0600 to 0666 so that the next time you log in and restart your window system, it will still be accessible by all users.
/dev/console 0600 /dev/mouse:/dev/kbd /dev/console 0600 /dev/sound/* # audio devices /dev/console 0600 /dev/fbs/* #frame buffers
Note that your system is no longer secure.
Chapter 3 Installing Software from the Sun Computer Systems Supplement CD 25

PC Launcher

Audience

PC launcher is designed for Solaris users who have access to Windows ‘95 or ‘98 based PC environments

What is PC Launcher?

PC launcher provides you with the capability to view and edit PC files and attachments by launching the associated Windows applications and files in the PC environment. PC launcher enables you to launch attachments and files created in the Windows environment.

PC Launcher Installation Requirements

Software Supplement for the Solaris 8 6/00 Operating Environment for Sun
Computer Systems CD
If you don’t have the Supplement CD, contact your Sun service representative.

System Requirements

Sun Workstation

Solaris 8 6/00 operating environment
CDE 1.3
32 MB RAM

Network PC Environment with one of the following:

SunPCi™ card
Software Environment
PC Hardware with Win 9x (PC -NFS™/Solstice Network Client)
26 Solaris 8 6/00 Sun Hardware Platform Guide • June 2000

PC Launcher Installation

SunPCi Requirements

In order for PC launcher to work, SunPCi and its host workstation must be able to ping each other by ‘name’. To do this, you must have:
IP connectivity between the two.
Name services (whatever you happen to be using) set up on each so that you can
look up the other’s name and get its IP address.
Because of the network architecture of SunPCi and the way it shares Ethernet access with its host, the SunPCI and host cannot see each other on the network.
To work around this, use an IP routing system (a "real" router, another Sun system, an NT system, etc.) on the same subnet to act as a proxy router.
Note – You must have account access to the IP router you have selected, since you
must add two routes to it.
For example, based on following setup:
SunPCi IP = 10.0.0.1
Host workstation IP = 10.0.0.2
Router IP = 10.0.0.3
you need to do the following:
1. On the host workstation:
route add 10.0.0.1 10.0.0.3 1
Note – You can add an /etc/rc script to make this happen at every reboot.
2. On the routing proxy:
route add 10.0.0.2 10.0.0.3 0 route add 10.0.0.1 10.0.0.3 0 (or the equivalent)
Caution – You must add routes to all three systems in this fashion in order for this
to work. Do NOT assume that "standard network default routers" or anything else will provide similar functionality; they will not.
Chapter 3 Installing Software from the Sun Computer Systems Supplement CD 27
After doing this, verify that the SunPCi can ping its host by IP, and vice versa. Once that works, make sure that they can ping each other by name; add entries to the appropriate naming services if they cannot. On UNIX, examples of naming services are DNS or /etc/hosts. Windows can use DNS or the hosts file as well. Consult your System Administrator to add these entries, based on your setup. Once the systems can ping each other by name, PC launcher will install.
For further assistance with installation of SunPCi, refer to the following publications:
SunPCi Installation Guide
SunPCi Release Notes
SunPCi 1.1 Windows NT Installation Guide

Installing PC Launcher Packages

See “Installing Sun Computer Systems Supplement CD Software” on page 14.

Configuring PC Launcher

You configure PC launcher by specifying your setup in the three steps on the PC launcher Configuration window.
Before configuring, you must have the following:
A network host name and network connectivity between your Solaris and
Windows environments.
Your UNIX home directory mapped in your Windows environment.

To Configure PC Launcher for PCi

1. From the CDE Toolbar, start the Application Manager.
2. Click Configure PC launcher under the Desktop controls. The PC launcher Configuration window is displayed. Answer the questions in the following three steps.
a. On-Board PC Emulator and SunPCI (default) b. Enter your Sun PCi’s hostname (default) c. Let PC Emulator handle the file
3. Click OK.
28 Solaris 8 6/00 Sun Hardware Platform Guide • June 2000
Note – PC-type documents can be opened for viewing and editing through the Sun
PCi card whenever you double-click a document. If you want to do “quick” viewing, select “Let Solaris handle the file” and PC file viewer is invoked. For editing, use the right-mouse button and select “Open In Emulator”.
4. From SunPCi run h: \.dt\bin\win9x\intel\sdtpcactiond.exe (assuming h: is mapped to your UNIX home directory).

To Configure PC Launcher for the Software Environment

1. From the CDE Toolbar, start the Application Manager.
2. Click Configure PC launcher under the Desktop controls then select or enter the following:
a. On-Board PC Emulator and SoftWindows. b. <Hostname> c. Let Solaris handle the file
Note – PC-type documents can be opened for viewing and editing with a right-
mouse double-click. If you selected “Let Solaris handle the file” when you configured PC launcher, then double-clicking on a file will launch PC file viewer.
3. Click OK.
4. From Software Environment run:
h: \.dt\bin\win9x\intel\sdtpcactiond.exe
(assuming h: is mapped to your UNIX home directory).

To Configure PC Launcher for a Deskside PC

1. From the CDE Toolbar, start the Application Manager.
2. Click Configure PC launcher under the Desktop Applications then select or enter the following:
a. Standalone PC b. <Hostname> c. Let the Standalone PC handle the file
Chapter 3 Installing Software from the Sun Computer Systems Supplement CD 29
Note – PC-type documents can be opened for viewing and editing with a right-
mouse double-click. If you selected “Let Solaris handle the file” when you configured PC launcher, then double-clicking on a file will launch PC file viewer.
3. Click OK.
4. From Deskside PC run:
h: \.dt\bin\win9x\intel\sdtpcactiond.exe
(assuming h: is mapped to your UNIX home directory).

Using PC Launcher

The CDE front panel and CDE workspace can be populated with an icon representing the PC environment, such as SunPCi. To do this, drag and drop OpenInSunPCi from the Desktop Applications in Application Manager, onto the Front Panel.
If you did not configure PC launcher, then the first time you open PC launcher, the PC launcher Configuration window will display. This is where you will configure PC launcher. You only need to configure PC launcher once.

Working With Windows Files

Windows Files

Identification of many popular PC file formats in CDE allows you to select and launch them in your preferred PC environment, such as SunPCI. A right mouse click on these files gives you the three following choices in the menu:
Open—the double-click action.
OpenInEmulator—launches the file in your preferred hardware, such as SunPCi
(or any software emulator).
OpenInRemotePC—launches the file in a standalone networked PC.
You can drag and drop Windows shortcuts onto the Front Panel. You can also put shortcuts on the CDE workspace by creating a windows short cut in your UNIX home directory and using dtfile to drag and drop. Refer to Windows help on creating shortcuts, and CDE help to get more information on drag and drop.
30 Solaris 8 6/00 Sun Hardware Platform Guide • June 2000

To Open an Application or Datafile

Double-click on the shortcut from the Solaris desktop.
The associated applications must be available to you. This procedure makes the Solaris desktop act like a Windows desktop. You can keep all your relevant applications inside the Solaris CDE front panel and CDE workspace and run them by double-clicking on them.

To Run Windows Binary Files

Double-click on the file (exe) and run inside the PC environment (for example,
SunPCi).

To Copy and Paste Text

1. Highlight the text you want to copy and select Copy from the Edit menu.
2. Click the place you want to paste the text, and select Paste from the Edit menu.

To View a File

Click on the file and select View.

To Search for a File

1. Select Find/Change from the Edit menu.
2. Enter the filename into the Find field and click Find.

To Print Files

Select Print from the File menu
The file will print out on the PC printer.
Chapter 3 Installing Software from the Sun Computer Systems Supplement CD 31

Other Features

To Display the Windows Start Menu in CDE

Using manual steps, you can get to all of the Windows Start Menu choices in the CDE Application Manager.
1. Start Windows Explorer.
2. Copy C: \Window\StartMenu\ to H: \.dt\appmanager.
3. Start Application Manager.
4. Go to the Desktop controls.
5. Click Reload Application.

To Log On to a Different Machine

Reconfigure PC launcher on the Configuration window.

To Reconfigure PC Launcher

Remove the PC’s hostname in Step 2 on the PC launcher Configuration window.

Switch Between Targets

Change your selection in Step 1 on the PC launcher Configuration window.

Getting Help for PC Launcher

Help for PC launcher is available through the Help menu at the bottom of the PC launcher Configuration window.
32 Solaris 8 6/00 Sun Hardware Platform Guide • June 2000

PC File Viewer

PC File Viewer

The PC file viewer software provides you with an application to view popular PC file formats such as Microsoft Word, PowerPoint, Excel, Lotus 1-2-3, and AutoCAD. The viewer allows you to choose a file and to copy and paste information from the viewer to another application, such as a text editor. CDE applications will be able to identify these filetypes and launch this application by double-clicking on the icon in your mail attachment or from File Manager (dtfile).

File Formats Supported

PC file viewer supports 17 different file types: Word Processing Formats
Microsoft Word for Windows versions through 7.0 and Word 97
Microsoft Windows Works versions through 4.0
Word Perfect for Windows versions through 7.0
AMI/AMI Professional versions through 3.1
Spreadsheet Formats
Microsoft Excel Windows versions 2.2 through 7.0 and Excel 97
Microsoft Excel Chart versions 2.x through 7.0
Microsoft Windows Works versions through 4.0
Lotus 1-2-3 Windows versions through 6.x
Lotus 1-2-3 Chart Windows versions through 5.0
QuattroPro for Windows versions through 7.0
Presentation Formats
Microsoft PowerPoint versions through 7.0 and PowerPoint 97
Corel Presentation versions through 7.0
Freelance versions 1.0 and 2.0
Graphics Formats
BMP—Windows
DXF—versions through 13
GEM—Bitmap and vector
Chapter 3 Installing Software from the Sun Computer Systems Supplement CD 33
PIC—Lotus

PC File Viewer Limitations

PC file viewer is limited to the following products and configurations for this Solaris release:
SPARC architecture ONLY
Printing is not supported
The following limitations are related to displaying items in a supported file:
Charts are not supported in QuattroPro.
Text that is designed to be shown vertically is shown horizontally in the viewer.
This vertical text may overlap adjacent cells making reading what is in them difficult.
Figures and footers are aligned with the anchors in the text. If font sizes on the
viewing system are not identical to those on the authoring system, then anchored objects will not be at the appropriate place in the text.
There is limited support for incremental shading in presentation file formats
There is no support for drawing objects in Microsoft Word and Lotus.
Borders in Word Perfect and AmiPro files are not supported
Copy & Paste does not work for Japanese text in Microsoft Office applications.
Note – All of the above limitations also exist in the Microsoft Windows version of
the product from Inso Corporation.
There is no support for OLE objects.
If a font that is used in a document is not on the system, the default system font
will be used and the viewed text may look different than what was seen in the authoring application.
If a special character is used in a document that is not in the available character
set, it will be replaced by an asterisk in the document as shown by the file viewer.

Installing PC File Viewer

See “Installing Sun Computer Systems Supplement CD Software” on page 14.
34 Solaris 8 6/00 Sun Hardware Platform Guide • June 2000

Adding PC File Viewer to the CDE Front Panel

To Add PC File Viewer to the CDE Front Panel

1. Open File Manager (dtfile).
2. Go to the /opt/SUNWdtpcv/bin directory.
You will see the PC file viewer icon there.
3. Open the CDE front panel where you want the icon.
For example, the Application or File sub-folder.
4. Drag and drop the PC file viewer icon from File Manager to InstallIcon in the selected subfolder.
Now the PC file viewer can be launched by just clicking on the icon in the CDE front panel. You can also promote the icon to appear on the front panel by default.

ShowMe TV 1.3 Software

ShowMe TV is a television system for local- and wide-area networks. You can use it to view and broadcast live or prerecorded video programs on your network. Here are some examples of how you can use ShowMe TV:
Broadcast and view training courses
Lectures
Corporate messages
Monitor important news events
ShowMe TV contains the following components:
ShowMe TV Receiver
ShowMe TV Transmitter
ShowMe TV Address Book
Chapter 3 Installing Software from the Sun Computer Systems Supplement CD 35

ShowMe TV Packages

TABLE 3-6 lists the packages that are provided with ShowMe TV.
TABLE3-6 ShowMe TV Packages
Package Name Description Default Install Location
SUNWsmtvh Online help binaries and
documentation
SUNWsmtvr ShowMe TV receiver application
and support files
SUNWsmtvt ShowMe TV transmitter application
and support files
SUNWsmtvu Support utilities /opt/SUNWsmtv 842
/opt/SUNWsmtv 319
/opt/SUNWsmtv 12320
/opt/SUNWsmtv 9329
DiskSpace (Kbytes)

Removing Old Packages

If you have ShowMe TV 1.1, 1.2, or 1.2.1 installed, you need to remove it before installing ShowMe TV 1.3.
To remove ShowMe TV 1.1, type:
# pkgrm SUNWsmUt1 SUNWstv SUNWstvs
If you have an earlier release of ShowMe TV 1.2 installed, you need to remove it before installing any new software packages.
To remove ShowMe TV 1.2 or 1.2.1, type:
# pkgrm SUNWsmtvt SUNWsmtvu SUNWsmtvr SUNWsmtvh

Installing ShowMe TV

See “Installing Sun Computer Systems Supplement CD Software” on page 14.
36 Solaris 8 6/00 Sun Hardware Platform Guide • June 2000

Translated Documentation

The Supplement CD contains the ShowMe TV User’s Guide in the following languages:
French
German
Spanish
Italian
Swedish
Japanese
Korean
Simplified Chinese
Traditional Chinese

Accessing the ShowMe TV User’s Guide

The /cdrom/cdrom0/ShowMeTV1.3/Docs/UserGuide directory on the Supplement CD contains the following files:
TABLE3-7 ShowMe TV Translated Documents
File Name Description
UG_en.ps English PostScript™ file UG_de.ps German PostScript file UG_fr.ps French PostScript file UG_es.ps Spanish PostScript file UG_it.ps Italian PostScript file UG_sv.ps Swedish PostScript file UG_ja.ps Japanese PostScript file UG_ko_dir/ Korean HTML files UG_zh_dir/ Simplified Chinese HTML files UG_zh_TW_dir/ Traditional Chinese HTML files
To view the desired PostScript manual, type the following at the command line:
# imagetool filename
Chapter 3 Installing Software from the Sun Computer Systems Supplement CD 37
To print the manual, either use the File menu in Image Tool or type the following
at the command line:
# lp filename
To view the manuals in HTML format, use a Web browser and type the following
in the address field:
file:/cdrom/cdrom0/ShowMeTV1.3/Docs/UserGuide/directory
If you have copied the HTML files to a different directory, type in the path to that directory. Open the table of contents to determine which file to open.

Sun Remote System Control for Sun Servers

Sun Remote System Control (RSC) is a secure server management tool that lets you monitor and control a Sun Enterprise 250 server over modem lines and over a network, using Solaris operating environment or Microsoft Windows clients. RSC can also notify you when server problems occur. RSC provides remote system administration for geographically distributed or physically inaccessible systems. All hardware functionality required to support RSC is already included with your Sun Enterprise 250 server.
The Sun Remote System Control for Sun Servers software is provided on the Supplement CD. For installation information, see “Installing Sun Computer Systems Supplement CD Software” on page 14. For configuration information for Remote System Control, see Remote System Control (RSC) Installation Guide.

SunForum

SunForum is a data conferencing product for Sun workstations. It is based on the T.120 standard, which enables your Sun system to conference over intranets and the Internet with other T.120 products, such as Microsoft NetMeeting and PictureTel LiveShare Plus, version 4.0.
SunForum includes the features
38 Solaris 8 6/00 Sun Hardware Platform Guide • June 2000
View and control applications shared from other UNIX or PC machines that are
based on the T.120 protocol.
Share local Solaris applications, which can be viewed and controlled by any
conference participant.
Exchange ideas and data using the whiteboard, clipboard, chat, and file transfers.

Installing SunForum

See “Installing Sun Computer Systems Supplement CD Software” on page 14.

Online Help

You can read information about SunForum online. You can access help from the Help menu located on any SunForum menu bar.

Network Adapter Drivers Included on the Supplement CD

The following drivers are provided on the Supplement CD contained in your Solaris 8 6/00 Media Kit:
Sun GigabitEthernet Driver software
SunFDDI PCI Driver software
SunFDDI SBus Driver software
SunHSI PCI Driver software
SunHSI SBus Driver software
SunATM 5.0
Note – SunFDDI supports booting from the 32-bit kernel or the 64-bit kernel.
SunFDDI will attach to whichever you choose to boot from with no special user interaction.
Chapter 3 Installing Software from the Sun Computer Systems Supplement CD 39

Installing the Drivers

Note – Before installing driver software from the supplement CD make sure that
you have already installed the adapter hardware. Refer to the appropriate Platform Notes for more information.
See “Installing Sun Computer Systems Supplement CD Software” on page 14.

Platform Notes for Network Adapter Drivers

Refer to the following platform notes for more information:
Platform Notes: Sun FDDI Adapters
Platform Notes: The Sun GigabitEthernet Device Driver
Platform Notes: The SunHSI/P Device Driver
Platform Notes: The SunHSI/S Device Driver
Platform Notes: SunATM Driver Software

Java 3D 1.1.2 API

The Java 3D™ 1.1.2 API is a set of classes for writing three-dimensional graphics applications and 3D applets. It gives developers high level constructs for creating and manipulating 3D geometry and for constructing the structures used in rendering that geometry. Application developers can describe very large virtual worlds using these constructs, which provides Java 3D with enough information to render these worlds efficiently.

Installation Dependencies

OpenGL 1.1 or later
JDK 1.2 or later

Installing Java 3D 1.1.2 API

See “Installing Sun Computer Systems Supplement CD Software” on page 14.
40 Solaris 8 6/00 Sun Hardware Platform Guide • June 2000

Sun Enterprise 10000 SSP Software

For SSP installation and update procedures, as well as SSP release notes, see the document, Sun Enterprise 10000 SSP Installation and Release Notes , a printed copy of which is included in your server media kit.

Sun Enterprise 10000 Capacity on Demand 1.0 Software

For Capacity on Demand software installation, as well as release notes, see the document, Sun Enterprise 10000 Capacity on Demand 1.0 Installation Guide and Release Notes, a printed copy of which is included in your server media kit.
Chapter 3 Installing Software from the Sun Computer Systems Supplement CD 41
42 Solaris 8 6/00 Sun Hardware Platform Guide • June 2000
CHAPTER
4

Documents on the Computer Systems Supplement CD

Documents on the supplement CD are divided into three formats:
AnswerBook2 collections,
Man pages
Other formats

AnswerBook2 Sets

For customers using Sun hardware, four sets of online manuals in AnswerBook2 format are provided on the Supplement CD.

Installing Solaris 8 6/00 AnswerBook Sets

See “Installing Sun Computer Systems Supplement CD Software” on page 14 for information about installing the Sun Computer Systems AnswerBook2 packages.
Refer to the Solaris 8 (SPARC Platform Edition) Installation Guide for information about installing AnswerBook sets.
Refer to the “Accessing Sun Documentation Online” module in the Solaris 8 Installation Guide for information about how to install document collections on an AnswerBook2 server.
43

Solaris 8 6/00 AnswerBook Packages

The following table lists the packages that are provided for the Solaris 8 6/00 AnswerBook collections.
TABLE4-1 Solaris 8 6/00 AnswerBook Packages on the Supplement CD
AnswerBook Package Location Description
Sun_Hardware_Answerbook/Product/SUNWabhdw Solaris on Sun Hardware
AnswerBook collection
System_Service_Processor_3.3_Answerbook/Product/SUNWuessp SSP AnswerBook collection Alternate_Pathing_2.3/Product/SUNWabap Alternate Pathing
AnswerBook collection
Capacity_on_Demand_1.0/Product/SUNWcodbk Capacity on Demand
AnswerBook collection

Solaris 8 6/00 on Sun Hardware AnswerBook Set

This AnswerBook set includes general manuals as well as Platform Notes, which are manuals that cover use of Solaris 8 6/00 software with specific Sun hardware products.
This AnswerBook set includes:
Title Contents
Solaris on Sun Hardware Reference Manual Supplement
Solaris Handbook for Sun Peripherals Information about installing drives and other peripherals for
Solaris Handbook for Sun Frame Buffers Information on how to use features of the TurboGXPlus, SX,
NFS Server Performance and Tuning Guide Information about the performance and tuning of an NFS
SunVTS 4.0 User’s Guide Basic instructions on using the SunVTS diagnostic software.
44 Solaris 8 6/00 Sun Hardware Platform Guide • June 2000
Information to help you find a compilation of manual pages provided in packages on the Supplement CD. Includes man pages that cover SunVTS software.
use with the Solaris 8 6/00 software environment. Covers issues such as configuring SCSI addresses.
PGX (m64) and Creator Graphics Accelerator frame buffers. Also explains how to configure multiple monitors on a system. (In some past Solaris releases, this manual was titled Platform Notes: SMCC Frame Buffers.)
server.
Title Contents
SunVTS 4.0 Test Reference Manual Information about each test provided with the SunVTS
diagnostic software.
SunVTS Quick Reference Card A quick reference card for the SunVTS diagnostic software. PCI: SBus Comparison Feature differences between SBus and PCI. Platform Notes: The hme FastEthernet Device
Driver
Information on how to configure the hme device driver for use with the Ultra Workstation series platform, Sun Enterprise servers, SunSwift SBus adapter, SunSwift PCI adapter, and PCI SunFastEthernet card.
Platform Notes: SPARCstation 10SX and 20 System Configuration Guide
Platform Notes: Sun Enterprise 6000, 5000, 4000, and 3000 Systems
Information about how to take advantage of graphics memory and acceleration features of these systems.
Sun Enterprise X000-specific OpenBoot™ commands, including those for board hot-plug operations. Also contains board hot­plug procedures, and miscellaneous related information.
Platform Notes: Sun Enterprise 250 Server New OpenBoot commands, configuration variables, and disk
drive hot-plug procedures. Also provides procedures for mapping between logical and physical device names for internal storage devices.
Platform Notes: Sun Ultra 450 Workstation and Sun Enterprise 450 Server
New OpenBoot commands, configuration variables, and disk drive hot-plug procedures. Also provides procedures for mapping between logical and physical device names for internal storage devices.
Platform Notes: Using luxadm Software Instructions on using the luxadm administrative program with
the Sun StorEdge A5000 and the SPARCstorage Array.
Platform Notes: Sun FDDI Adapters Information about how to configure the SunFDDI driver
software and use the SunFDDI network utilities.
Platform Notes: Sun GigabitEthernet Device Driver
Information on how to configure the Sun GigabitEthernet driver software.
Platform Notes: The SunHSI/S Device Driver Describes how to configure the SunHSI SBus driver software. Platform Notes: The SunHSI/P Device Driver Describes how to configure the SunHSI PCI driver software. Platform Notes: The SunATM Driver Software Describes how to configure the SunATM driver software. Dynamic Reconfiguration User ’s Guide for Sun
Enterprise 6x00,5x00,4x00, 3x00 Systems
Information about how to use Dynamic Reconfiguration software features on these Sun Enterprise servers.
Remote System Control (RSC) User’s Guide Information about how to use Remote System Control for the
Enterprise 250 Server.
Remote System Control (RSC) Installation Guide
Sun Enterprise 10000 Domain Configuration Guide
Installation and configuration information for Remote System Control for the Enterprise 250 Server.
Domain configuration information for the Sun Enterprise 10000 server
Sun Enterprise 10000 Domain Error Messages Error message information for the Sun Enterprise 10000 Server
Chapter 4 Documents on the Computer Systems Supplement CD 45

Sun Enterprise 10000 SSP AnswerBook Set

This AnswerBook set includes:
Title Contents
Sun Enterprise 10000 SSP 3.3 User Guide User information for Sun Enterprise 10000 System Service
Processor (SSP) software
Sun Enterprise 10000 SSP 3.3 Reference Manual
Sun Enterprise 10000 Dynamic Reconfiguration User Guide
Sun Enterprise 10000 Dynamic Reconfiguration Reference Manual
Sun Enterprise 10000 InterDomain Networks User Guide
Man pages for Sun Enterprise 10000 System Service Processor (SSP)
User information for Sun Enterprise 10000 Dynamic Reconfiguration software
Man pages for Sun Enterprise 10000 Dynamic Reconfiguration
User information for Sun Enterprise 10000 InterDomain Networks (IDN) software

Alternate Pathing AnswerBook Set

This AnswerBook set includes:
Title Contents
Sun Enterprise Server Alternate Pathing 2.3 User Guide
Sun Enterprise Server Alternate Pathing 2.3 Reference Manual
User information for Alternate Pathing software
Man pages for Alternate Pathing software

Capacity On Demand AnswerBook Set

This AnswerBook set includes:
Title Contents
Sun Enterprise 10000 Capacity on Demand 1.0 Administrator Guide
Sun Enterprise 10000 Capacity on Demand 1.0 Reference Manual
46 Solaris 8 6/00 Sun Hardware Platform Guide • June 2000
System administrator information for Capacity on Demand on the Sun Enterprise 10000 server
Man pages for Capacity on Demand on the Sun Enterprise 10000 server

Sun Computer Systems Manual Page Packages

Manual pages for products you install using Solaris Web Start 2 will be automatically installed. If you want to install a man page for a product but do not want to install the product, you can use pkgadd to install the man page.
TABLE4-2 Sun Computer Systems Manual Page Packages on the Supplement CD
Package Name Description
SUNWvtsmn Online Validation Test Suite Manual Pages Manual pages for SunVTS drivers/binaries SUNWnfm SunFDDI SBus Manual Pages Manual pages for SunFDDI SBus SUNWpfm SunFDDI PCI Manual Pages Manual pages for SunFDDI PCI SUNWgedm Sun GigabitEthernet Manual Pages Manual pages for Sun Gigabit SUNWapdoc Sun Alternate Pathing Manual Pages Manual pages for Sun Alternate Pathing SUNWhsism SunHSI/S Manual Pages Manual pages for SunHSI SBus SUNWhsipm SunHSI/P Manual Pages Manual pages for SunHSI PCI SUNWsspmn SSP Manual Pages Manual pages for SSP SUNWcodmn Capacity on Demand Manual Pages Manual pages for COD

Installing Sun Computer Systems Manual Pages

See “Installing Sun Computer Systems Supplement CD Software” on page 14.

Using Sun Computer Systems Manual Pages

To view the man pages you have installed, use the man command as you would for the man pages installed as part of the Solaris operating environment installation. These additional man pages are also available in the Solaris on Sun Hardware Reference Manual Supplement in the Solaris 8 6/00 on Sun Hardware AnswerBook set.
Chapter 4 Documents on the Computer Systems Supplement CD 47

Other Documents on the Computer Systems Supplement CD

The following table lists the documents on the Computer Systems Supplement CD that are not part of AnswerBook sets and are not man pages. :
TABLE4-3 Other Documents on the Supplement CD
Path Comment
Docs/README_en.html Readme file for Solaris 8 6/00 Sun
Computer Systems Supplement CD
Docs/HWPG/HWPG_en.ps Solaris 8 6/00 Sun Hardware Platform
Guide (also available in hardcopy
AnswerBook form)
ShowMeTV_1.3/Docs/UserGuide/UG_en.ps ShowMe TV™ 1.3 User’s Guide SunForum_3.0/Docs/SunForumUG.ps SunForum™ User’s Guide
Note – The _en indicates an English language document. Other languages may be
indicated, depending on locale.
48 Solaris 8 6/00 Sun Hardware Platform Guide • June 2000
CHAPTER
5

Updating the Flash PROM on the Ultra 1, Ultra 2, Ultra 450, and Sun Enterprise 450 Systems

This chapter describes how to update the flash PROM on the Ultra™ 1, Ultra 2, Ultra 450, and the Sun™ Enterprise™ 450 systems.
Some systems require a higher level of OpenBoot™ firmware in the flash PROM to run the 64-bit mode of the Solaris™ 8 operating environment. The OpenBoot firmware is contained within a single flash PROM for the Ultra 1, Ultra 2, Ultra 450, and the Sun Enterprise 450 systems.
Note – Only those systems identified in this chapter and the following chapter need
the flash PROM upgrade.
The flash PROM devices, which contain OpenBoot, are electrically erasable and writable devices. This means that the firmware can be updated without removing the flash PROM from the system board.

Related Material

You can also use the Flash PROM Update Multimedia Collection containing videos of how to upgrade the flash PROM in the Ultra 1, Ultra 2, Ultra 450, and Sun Enterprise 450 systems. This collection is located on the Flash PROM Update Multimedia AnswerBook CD. For more information, see “Flash PROM Update Multimedia Collection” on page 69.
49

Determining If the Flash PROM Needs Updating

Only sun4u systems that can run the 64-bit mode of the Solaris 8 6/00 operating environment might need the flash PROM update. Systems that can only run the 32­bit mode (such as those in the sun4c, sun4d, and sun4m platform groups) do not require updated firmware to run Solaris 8 6/00 software.
Note – If the Solaris 8 6/00 operating environment notified you that the flash PROM
in your system needs updating, skip the steps in the procedure “To Determine If Your System Requires a Flash PROM Update” on page 50 and go directly to “Updating the Flash PROM” on page 51.
To Determine If Your System Requires a Flash
PROM Update
1. Determine the architecture type of your system.
% uname -m
TABLE5-1 Determining the System Architecture
If your system architecture type is . . . Then . . .
• sun4u Go to Step 2.
• sun4c, sun4d, sun4m You do not need a flash PROM update. Do not proceed further.
2. Determine the system type of your system.
% uname -i
50 Solaris 8 6/00 Sun Hardware Platform Guide • June 2000
TABLE5-2 Determining the System Type
If your system type is one of the following systems. . . Then . . .
SUNW, Ultra-1
Go to Step 3 for each system type. SUNW, Ultra-2 SUNW, Ultra-4 SUNW, Ultra-Enterprise
Not in the above list You do not need a flash PROM update. Do not proceed
further.
3. Determine the version level of the firmware in your system. Type:
% prtconf -V
TABLE5-3 Determining the Firmware Version Level
If your system type is . . .
And you see a number lower than . . . Then . . . Otherwise . . .
SUNW, Ultra-1 3.11.1 Proceed to “Updating the
Flash PROM” on page 51.
SUNW, Ultra-2 3.11.2 Proceed to “Updating the
Flash PROM” on page 51.
SUNW, Ultra-4 3.7.107 Proceed to “Updating the
Flash PROM” on page 51.
SUNW, Ultra-Enterprise 3.2.16 Proceed to “Updating the
Flash PROM” on page 51.
You do not need a flash PROM update. Do not proceed further.
You do not need a flash PROM update. Do not proceed further.
You do not need a flash PROM update. Do not proceed further.
You do not need a flash PROM update. Do not proceed further.

Updating the Flash PROM

This section describes the following:
Capturing configuration variable settings
Installing the Solaris 8 6/00 operating environment
Making the flash PROM write-enabled
Steps to perform before updating the flash PROM
Chapter 5 Updating the Flash PROM on the Ultra 1, Ultra 2, Ultra 450, and Sun Enterprise 450 Systems 51
Updating the flash PROM
Note – For step-by-step instructions, follow the procedures beginning with “To
Capture the Configuration Variable Settings” on page 52.
After installing the Solaris 8 6/00 operating environment on your hardware, set the write-protect/enable flash PROM jumper to the write-enable position (Sun Ultra 1 and Ultra 2 systems) before you attempt to update the firmware in the flash PROM. To change the write protection state of the Sun Enterprise 450 system, turn the external front panel keyswitch.
Refer to the recovery procedure covered later in this chapter if there is a power interruption during the update process.
Return the write-protect/enable jumper (Sun Ultra 1 and Ultra 2 systems) to the write-protect position after updating the firmware in the flash PROM.
When your system has been updated to the proper firmware revision, you can run the Solaris 8 6/00 software in 64-bit mode.

Capturing Configuration Variable Settings

While the Solaris operating environment is still running, capture the NVRAM configuration variable settings before you install the Solaris 8 6/00 operating environment or begin the flash PROM update process. This will enable you to restore customized settings if there is a problem during the flash PROM upgrade.

To Capture the Configuration Variable Settings

1. Using the eeprom utility, capture the system’s configuration variable settings in a file. The filename is any file name you choose.
% eeprom > filename
Note – If you have custom values installed in oem-logo or keymap, those values
cannot be displayed or printed properly by the eeprom utility because the contents contain binary information. If it is necessary to restore these values after a power loss, you should determine the original method by which these values were placed into NVRAM and use that method to restore the values.
52 Solaris 8 6/00 Sun Hardware Platform Guide • June 2000
2. Print out the values captured by the eeprom command. Type the following:
lp filename
You must have a printed copy of the configuration values before you install the Solaris 8 6/00 operating environment and begin to update the flash PROM.

To Install the Solaris 8 6/00 Operating Environment

Install the Solaris 8 6/00 operating environment on your system.
Refer to the Installation Library shipped in your Solaris 8 6/00 media kit. As the Solaris 8 6/00 operating environment is installed, you will be notified whether the flash PROM in your system needs updating. Installing this Solaris release will provide the software that can upgrade your system’s flash PROM to the required level.

Making the Flash PROM Write-Enabled

Before you update the OpenBoot firmware contained in the flash PROM, you must set a jumper to the write-enable position (Sun Ultra 1 and Ultra 2 systems) or set the front panel keyswitch to the proper position (Sun Enterprise 450 system and the Sun Ultra 450 workstation).
The Sun Ultra 1 and Ultra 2 systems, which do not have a front panel keyswitch, are equipped with jumpers on their motherboards that allow the flash PROM to be either write-protected or write-enabled. The default position is for the flash PROM to be write-protected. To update the flash PROM, you must change the jumper to the write-enable position.
Sun Ultra 1 and Ultra 2 Systems: To Change the Jumper to the
Write-Enable Position
1. Shut down the system. Type the following:
% su
Type your superuser password
# init 0
System shutdown messages
2. Power off the system unit.
Refer to the installation guide or service manual for your system.
Chapter 5 Updating the Flash PROM on the Ultra 1, Ultra 2, Ultra 450, and Sun Enterprise 450 Systems 53
3. Remove the system access cover.
Refer to the installation guide or service manual for your system for this procedure.
4. Use proper grounding procedures such as wearing a wrist strap to avoid electrostatically damaging system components.
5. Locate the flash PROM J2003 write-protect/enable jumper on the motherboard in your system:
See FIGURE 5-1 if you have a Sun Ultra 1 system.
See FIGURE 5-2 if you have a Sun Ultra 2 system.
Note – You may have to remove a plug-in card if the card is covering the flash
PROM jumper. Refer to the service manual for your system to remove the card.
J2003 write protect/enable jumper
Back panel
FIGURE 5-1 Sun Ultra 1 Series Write-Protect/Enable Jumper Location on Motherboard
54 Solaris 8 6/00 Sun Hardware Platform Guide • June 2000
Front panel
J2003 write protect/enable jumper
FIGURE 5-2 Sun Ultra 2 System Write-Protect/Enable Jumper Location on Motherboard
Back panel
6. Set the J2003 write-protect/enable jumper to pins 2 and 3 (write enabled) using needlenose pliers (see
FIGURE 5-3). Pin 1 is noted by an asterisk (*).
**
123
Write protected
FIGURE 5-3 Setting the Write-Protect/Enable Jumper to the Write-Enable Position
TABLE5-4 Jumper Setting
Jumper Pins 1 + 2 Jumpered Pins 2 + 3 Jumpered Default Jumper on Pins Name
J2003 Write-protect Write-enable 1 + 2 Write-protect/
1
2
Write enabled
3
enable
7. If you removed a plug-in card from the system before changing the jumper, replace the card now.
Chapter 5 Updating the Flash PROM on the Ultra 1, Ultra 2, Ultra 450, and Sun Enterprise 450 Systems 55
8. Remove your wrist strap and replace the system access cover.
9. Go to “Before Updating the Flash PROM” on page 57.

Sun Enterprise 450 System and the Sun Ultra 450 Workstation: Disabling Write Protection

For the Sun Enterprise 450 system and the Sun Ultra 450 workstation you do not have to change jumper pins. Instead, you move the keyswitch to allow the flash PROM to be write-enabled.
When the switch is set to the Locked position ( protected. When the switch is set to the On or Diagnostics position, the flash PROM is write-enabled.
FIGURE 5-4), the flash PROM is write-
To Write Enable the Flash PROM on the Sun Enterprise 450
System and the Sun Ultra 450 Workstation
Turn the keyswitch to the On or Diagnostics position (FIGURE 5-4) before updating
the flash PROM.
Note – Disabling write-protection the Sun Enterprise 450 system or the Ultra 450
workstation assumes that the write-protect/enable jumper was set in the default position (enabled). If you previously changed the write-protect/enable jumper to be write protected, perform the steps to make the flash PROM write enabled in “Location of Flash PROM Jumpers in Sun Enterprise 450 System and the Ultra 450 Workstation” on page 67. You must change the jumper to be write enabled before continuing with the flash PROM update procedure.
56 Solaris 8 6/00 Sun Hardware Platform Guide • June 2000
On
Standby
FIGURE 5-4 Sun Enterprise 450 and Sun Ultra 450 Keyswitch Location
Diagnostics
Locked

Before Updating the Flash PROM

Before you begin updating the flash PROM, please note the following.
Caution – Do not interrupt power during flash PROM updating. When you are
using the update routine, do not remove or insert system boards.
Note – If power is interrupted during flash PROM updating, follow the power
interruption recovery procedures covered later in this chapter.

To Update the Flash PROM

1. If you shut down your system to set the write-enable jumper (Ultra 1, Ultra 2 systems), turn the system on so it can boot.
Chapter 5 Updating the Flash PROM on the Ultra 1, Ultra 2, Ultra 450, and Sun Enterprise 450 Systems 57
2. Bring the system down to single user mode. Type the following:
% su
Type your superuser password
# init S
3. Execute the flash PROM update script by typing the following:
/bin/sh /usr/platform/sun4u/lib/prom/‘/usr/bin/uname -i‘
4. When the flash update process begins, it displays the current, available OpenBoot firmware revisions.
Type yes to the question about updating the firmware in the system flash PROM.
Note – If the NVRAM configuration variable use-nvramrc? is set to true, the
update script resets use-nvramrc? to false. You will only see the message about the use-nvramrc? variable if use-nvramrc? is set to true. This is rarely the case.
Current System Flash PROM Revision:
----------------------------------­OBP 3.5.2 1997/01/06 17:40
Available System Flash PROM Revision:
------------------------------------­OBP 3.11.1 1997/12/03 15:44
NOTE: The system will be rebooted (reset) after the firmware has been updated.
Do you wish to update the firmware in the system Flash PROM? yes/ no :yes
The NVRAM variable ’use-nvramrc?’ was ’true’. This program will reset it to the default value ’false’. This is being done because the contents of the NVRAM variable ’nvramrc’ may or may not be appropriate for use with the new firmware. Do not change the value of ’use-nvramrc?’ until you evaluate the contents of ’nvramrc’.
58 Solaris 8 6/00 Sun Hardware Platform Guide • June 2000
5. Next, the update script asks you if you want to continue. Type yes.
Are you sure that you wish to continue? yes/no :yes
**IMPORTANT** If the power fails during the firmware update that is about to take place, it is possible that the customized values in the NVRAM configuration variables will revert back to their *default values* once the system power is restored. *If* this event occurs then it could have a significant effect on the behavior of the system after power is restored. Following is a list of the system’s NVRAM configuration variables which have default values and have been customized. You may wish to write this information down so that the values may be restored after recovery from a power loss.
Name: sbus-probe-list Default: 01 Current: 10 Name: nvramrc Default: <null> Current: ." This is a sample message which indicates that nvramrc has been modified." cr
If any of the NVRAM configuration variables have been customized, the update displays both the default value and the current value.
Chapter 5 Updating the Flash PROM on the Ultra 1, Ultra 2, Ultra 450, and Sun Enterprise 450 Systems 59
Note – After the update, you may want to evaluate if the customized values
displayed on the previous screen need to be modified.
The script automatically boots the machine and displays the following message:
Erasing the top half of the Flash PROM. Programming OBP into the top half of the Flash PROM. Verifying OBP in the top half of the Flash PROM.
Erasing the bottom half of the Flash PROM. Programming OBP into the bottom half of Flash PROM. Verifying OBP in the bottom half of the Flash PROM.
Erasing the top half of the Flash PROM. Programming POST into the top half of Flash PROM. Verifying POST in the top half of the Flash PROM.
The system's Flash PROM firmware has been updated.
Please wait while the system is rebooted . . .
The system’s reboot messages are displayed.
........................................................
NOTICE: 64-bit OS installed, but the 32-bit OS is the default for the processor on this system.
See boot(1M) for more information. Booting the 32-bit OS/
6. Become root and change the default kernel from 32-bit to 64-bit by editing the /platform/platform-name/boot.conf file.
# cd /platform/sun4u/ # ls boot.conf cprboot cprbooter kadb kernel ufsboot # vi boot.conf
Uncomment the line ALLOW_64BIT_KERNEL_ON_UltraSPARC_1_CPU=true.
7. If you have a Sun Ultra 1 or Ultra 2 system, change the jumper back to the write­protect position.
a. Allow the system to boot so you can become superuser. b. Halt the system by typing init 0 at the superuser prompt.
60 Solaris 8 6/00 Sun Hardware Platform Guide • June 2000
c. Power off the system. d. Open the system unit (refer to the installation or service manual for your
system).
e. Attach a wrist strap properly (refer to the installation or service manual for
your system).
f. Reset the J2003 write-enable/protect jumper to the write-protect position. In the
write-protect position pins 1 and 2 are jumpered (see
FIGURE 5-5, and TABLE 5-4). You may need to remove a plug-in card from the
system before resetting the jumper if the card is covering the jumper. Pin 1 is noted by an asterisk (*).
FIGURE 5-1, FIGURE 5-2,
*
123123
Write enabled
FIGURE 5-5 Moving the Write-Protect/Enable Jumper Back to the Write-Protect Position
g. If you removed a plug-in card from the system before changing the jumper,
replace the card now. h. Remove your wrist strap and replace the system access cover. i. Turn the power on to the system.
8. If you have a Sun Enterprise 450 system or a Sun Ultra 450 workstation, turn the keyswitch to the Standby position, wait a few seconds, and then power on again.
This power-cycling flushes any old firmware code out of system memory.
*
Write protected

Recovering From a Power Failure During the Flash PROM Update

If the power was lost during the flash PROM update, complete the power interruption recovery procedure for your system.
Chapter 5 Updating the Flash PROM on the Ultra 1, Ultra 2, Ultra 450, and Sun Enterprise 450 Systems 61

Sun Ultra 1 and Ultra 2 Systems, Sun Enterprise 450 System, Sun Ultra 450 Workstation

If power to your system was interrupted during updating of the flash PROM, complete the following steps:
1. Turn the power switch to the Standby position to prevent power surge to the system when power is restored.
2. After power is restored to the system location, return the power switch to the On position.
After power is restored, one of the following two recovery scenarios should happen on your system. Follow the instructions described for the appropriate scenario.

Scenario 1—System Recovers After Power Restoration

If your system attempts to autoboot after power is restored, you must complete the flash PROM updating process.

Scenario 2—System Does Not Recover After Power Restoration

If your system does not boot, run diagnostics, or return to the PROM monitor’s ok prompt after power is restored, complete the following steps:
1. If the update was being run via a serial port and the system also has a frame buffer and keyboard installed, or if the system has a keyboard and more than one frame buffer installed:
a. Connect a monitor to each frame buffer. b. Confirm that output has been redirected to one of the frame buffers.
The NVRAM configuration variables might have been modified because of the
firmware update just before power was lost. If this happened, then the system output was possibly redirected to a device other than the one originally used to display it. This could only have happened if a keyboard was connected to the system.
If there is no keyboard connected to the system and the NVRAM configuration
variables are set to their default values, then system input and output are directed to serial port A.
62 Solaris 8 6/00 Sun Hardware Platform Guide • June 2000
2. If output cannot be found on any of the installed frame buffers or serial port A, set the boot control jumper to boot from the half of the PROM that is not currently selected. See
FIGURE 5-1 on page 54, FIGURE 5-2, FIGURE 5-6, and FIGURE 5-7.
An asterisk (*) on the main logic board notes the location of pin 1.
If the jumper is set for high-half booting, move it to low-half booting (pins 2 and
3 jumpered). See
If the jumper is set for low-half booting, move it to high-half booting (pins 1 and
2 jumpered). See
TABLE5-5 Boot Control Jumper
FIGURE 5-6.
FIGURE 5-6.
System Jumper Pins 1 + 2 Jumpered Pins 2 + 3 Jumpered
Default Jumper on Pins Name
Ultra 1, 2 J2204 High-half booting Low-half booting 2 + 3 Boot control Sun Enterprise
J5501 High-half booting Low-half booting 2 + 3 Boot control 450 or Sun Ultra 450 workstation
*
123
High-half booting
FIGURE 5-6 Setting the Boot Control Jumper to Low-Half Booting or High-Half Booting
*
123
Low-half booting
3. Power on the system unit.
If the system recovers, complete the programming process by rebooting.
If the system does not recover, repeat Step 1 and Step 2 a second time.
4. If the system still does not recover, contact your Sun service provider or local Sun service Authorized Service Provider.
Chapter 5 Updating the Flash PROM on the Ultra 1, Ultra 2, Ultra 450, and Sun Enterprise 450 Systems 63

Restoring NVRAM Configuration Variables

If for any reason, the flash PROM update process did not complete successfully, for example if you lost power, you may have to restore diag-switch? to its default value of false and restore any customized values to the other NVRAM configuration variables.
Note – Use the steps in this section only if for any reason your NVRAM
configuration variables were not reset to their customized values or if diag­switch? was not set to its proper value.
1. Reboot the system by typing reboot at the prompt.
If diag-switch? was set to true and the system is power cycled, diagnostics will be run. Running diagnostics could take several minutes. Also, the system will attempt to boot from the network once the diagnostics have completed running.
Note – Other NVRAM variables may be reset to their default values, which could
affect the system in other ways. For example, if you ran the flash PROM update through the serial port and the system still has its keyboard plugged in, you will no longer get any response from the serial port connection. The firmware will be waiting for input from the keyboard.
2. As the system boots, go to the ok prompt by one of the following methods. a. Press Stop-a from the keyboard. b. If you are running on a terminal and connected to serial port A of the system,
press the Break key.
c. If you are connected to serial port A via telnet connection send a Break
sequence by pressing the Control and ] keys simultaneously. This returns you to the telnet command line. Type send brk at the telnet command line.
d. If you are connected to serial port A via a tip connection, send a Break
sequence by typing the characters ~# in quick succession.
64 Solaris 8 6/00 Sun Hardware Platform Guide • June 2000
3. Reset the configuration variables default value to the current value (see the values you captured with the eeprom command in “To Capture the Configuration Variable Settings” on page 52 and the values you wrote down earlier in this procedure in Step 1). At the ok prompt, type the following for each configuration variable:
ok setenv variablename currentvalue
For example:
ok setenv auto-boot? false
The setenv command resets each configuration variable you entered to the current value.
4. If the OpenBoot diag-switch? variable was set to true (false is the default). and the system is power cycled, diagnostics will run. Also, when you boot the system, the system will attempt to boot from the network. Unless you had diag- switch? set to true before the flash PROM update, set diag-switch? to false, the default value:
ok setenv diag-switch? false
5. If the use-nvramrc? configuration variable was set to true before the flash PROM update, as part of the update the use-nvramrc? variable was set to false because the contents of the NVRAM configuration variable nvramrc may or may not be appropriate for use with the new firmware. If you want to change the use-
nvramrc? variable back to true, evaluate the contents of nvramrc first with printenv nvramrc then change the use-nvramrc? configuration variable back
to true with the setenv use-nvramrc? true command.
6. Make sure that other configuration variables are set properly. a. Use the printenv OpenBoot command to display the NVRAM configuration
variables and their settings.
b. At the PROM monitor’s ok prompt, you can use OpenBoot commands to restore
the values of the configuration variables. Refer to the OpenBoot 3.x Command Reference Manual . You can also use the eeprom utility as superuser in the Solaris operating environment. See the eeprom man page description for more information.
Chapter 5 Updating the Flash PROM on the Ultra 1, Ultra 2, Ultra 450, and Sun Enterprise 450 Systems 65
7. If you have a Sun Enterprise 450 or an Ultra 450, turn the keyswitch to the Standby position, wait a few seconds, and then power on again. If you have an Ultra 1 or Ultra 2 system, type reset-all.
If you set the auto-boot? NVRAM configuration variable to true, and the boot­device variable contains the device or device alias where the Solaris 8 6/00
operating environment was installed, then the system will boot the Solaris 8 6/00 operating environment.

Error Messages

Most of the error messages were documented within the flash PROM update procedure. This section contains error messages that were not part of the flash PROM update procedure.

Retained Page/mmap Failure

If you see an error message similar to the following, just after the flash update program logs on Flash Update 2.0: Program and system
initialization in progress... eeprom:(attach) No retained page found in device tree then the update will fail with the following message if
the Flash PROM Update is attempted:
Do you wish to update the firmware in the system Flash PROM? yes/ no : yes eeprom:(mmap) on retained page failed: no retained page found Flash Update: MMAP call failed. : No such device or address
If this error occurs, issue a reboot command at the superuser prompt and allow the system to return to the Flash PROM Update inquiry WITHOUT INTERRUPTION. Attempt the flash PROM Update once again by completing the steps in the section “To Update the Flash PROM” on page 57. If the reboot was uninterrupted and the flash PROM Update fails a second time for the same reason, contact your Authorized Service Provider.
66 Solaris 8 6/00 Sun Hardware Platform Guide • June 2000

Location of Flash PROM Jumpers in Sun Enterprise 450 System and the Ultra 450 Workstation

The flash PROM update procedure for the Sun Enterprise 450 and the Ultra 450 systems assumes that the write-protect/enable jumper was set in the default position (enabled). In order to update the flash PROM, you must move the write­protect/enable jumper to the write-enable position.
Three jumpers on the main logic board affect flash PROM operation. shows the jumper locations, and TABLE 5-6 describes their functions.
FIGURE 5-7
Chapter 5 Updating the Flash PROM on the Ultra 1, Ultra 2, Ultra 450, and Sun Enterprise 450 Systems 67
Flash PROM jumpers
J3304
J3103
J3303
J2701
J3102
J5501
FIGURE 5-7 Flash PROM Jumpers on the Sun Enterprise 450 System and the Sun Ultra 450
Workstation
TABLE5-6 Sun Enterprose 450 and Ultra 450 Flash PROM Jumper Settings
Jumper Pins 1 + 2 Jumpered Pins 2 + 3 Jumpered
J3102 Flash PROM Not to be used 1 + 2 FLASH PROM SEL J3103 Write-protect Write-enable 2 + 3 FLASH PROM PROG
J5501 High-half booting Low-half booting 2 + 3 XOR LOGIC SET
Make sure that the write-protect/write-enable jumper is set to the write-enable position, pins 2 and 3 jumpered (see
68 Solaris 8 6/00 Sun Hardware Platform Guide • June 2000
Default on Pins Signal Controlled
ENABLE
FIGURE 5-8). Pin 1 is noted by an asterisk (*).
*
1
23 123
Write protected
*
Write enabled
FIGURE 5-8 Setting the J3103 Write Protect/Enable Jumper on the Sun Enterprise 450 or
Ultra 450

Flash PROM Update Multimedia Collection

The video content of the AnswerBook2 collection is very large. You may want to view it directly from the CD rather than installing this software package on a system already running an AnswerBook2 server. You also can view the video clips directly without using AnswerBook software or a browser.

Running the Video Clips from the CD

To run the video clips contained in this AnswerBook collection directly from the CD, perform the following steps:
1. Insert the Flash PROM Update Multimedia AnswerBook CD into your CD-ROM drive.
2. Change directory to, or bring up file manager, and go to the top level of the CD­ROM volume. This should look similar to:
% cd /cdrom/flash_answerbook
where cdrom is the mount-point for the CD-ROM device and flash_answerbook is the name of the CD-ROM volume.
Chapter 5 Updating the Flash PROM on the Ultra 1, Ultra 2, Ultra 450, and Sun Enterprise 450 Systems 69
3. To run the viewing script, type:
% ./watch-videos
4. Select the first video clip you want to see.
5. Before you view another video clip, dismiss the viewer that displayed the previous video clip.

Running an AnswerBook2 Server from the CD

To run the AnswerBook2 server directly from the CD, perform the following steps:
1. Insert the Flash PROM Update Multimedia AnswerBook CD into your CD-ROM drive.
2. Open a command window and become superuser using the su command and superuser password.
3. Change directory to the top level of the CD-ROM volume.
This should look similar to:
# cd /cdrom/flash_answerbook
where cdrom is the mount-point for the CD-ROM device and flash_answerbook is the name of the CD-ROM volume.
Among other things, this directory contains the executable script ab2cd.
4. Run the following command:
# ./ab2cd
5. If you have existing AnswerBook2 documentation collections installed on your server machine and you want the CD-driven server software to recognize those collections, use the following command:
# ./ab2cd -s
This causes the CD-driver server software to scan for other collections installed on this system and add them to its database.
70 Solaris 8 6/00 Sun Hardware Platform Guide • June 2000
6. You can now access the document server using the following URL:
http://server:8888/
Where server is the name of the machine to which the CD is attached.
7. To view video clips that are contained in an AnswerBook document, edit your browser's preferences to specify an MPEG Video application.
For example, to make use of the ShowMe™ TV™ software provided on this CD in a Netscape Communicator browser, perform these steps:
a. In the top bar menu of the browser, select Edit --> Preferences. b. In the Preferences window, select the category Navigator and the subcategory
Applications.
c. In the list of Applications, specify that MPEG Video is handled by the
following: showmetv -nowrap %s.
d. Click OK to apply this change to the Preferences.
8. In the document, click the video clip icon to launch the viewer.
9. Before you view another video clip, dismiss the viewer that displayed the previous video clip.
10. To stop running the AnswerBook server from the CD, run the following command:
# /cdrom/flash_answerbook/ab2cd stop

Notes on Running AnswerBook2 from a CD

The following paragraphs provide important information about running the AnswerBook2 server from the CD.

Default AnswerBook2 Port

The AnswerBook2 server run from the CD always runs on port 8888. If you already have an AnswerBook2 server running on your system using the default port (8888), the ab2cd script will display the following message:
A document server is already running on this system as server:8888.
Chapter 5 Updating the Flash PROM on the Ultra 1, Ultra 2, Ultra 450, and Sun Enterprise 450 Systems 71
Shut down the current server before running the ab2cd command. Use the following command to shut down the existing server:
# /usr/lib/ab2/bin/ab2admin -o stop

Stopping the AnswerBook2 Server Process

Always use ab2cd stop to stop the server running from the CD. Do not use /etc/init.d/ab2mgr stop to stop the CD-based server.
The ab2cd stop command stops the AnswerBook2 server process and cleans up all files in the /tmp/.ab2/ and /tmp/ab2cd_config/ directories. The /etc/init.d/ab2mgr stop command stops all server processes, but does not clean up the files in the /tmp/.ab2/ and /tmp/ab2cd_config/ directories.

Running Two AnswerBooks

To run two AnswerBook2 servers (one on your system, one from the CD), keep these rules in mind:
Startup
The /etc/init.d/ab2mgr start command always starts the server on your
system.
The ab2cd command always starts the server from the CD.
Shutdown
Always use the ab2cd stop command to stop the server running from the CD.
To stop both servers, first use the ab2cd stop command to stop the server
running from the CD, then use either /etc/init.d/ab2mgr stop or /usr/lib/ab2/bin/ab2admin -o stop to stop the server running on your
system.
72 Solaris 8 6/00 Sun Hardware Platform Guide • June 2000
CHAPTER
6

Updating the Flash PROM on the Sun Enterprise 3x00, 4x00, 5x00, and 6x00 Systems

The steps in this chapter describe how to update the flash PROMs in your Sun Enterprise 3x00, 4x00, 5x00, or 6x00 system.
Some systems require higher level of OpenBoot™ firmware in the flash PROM to run the 64-bit mode of the Solaris™ 8 operating environment. The OpenBoot firmware is contained in several PROMs that are located on several different boards.
The flash PROM devices, which contain OpenBoot, are electrically erasable and writable devices. This means that the firmware can be updated without removing the flash PROM from the system board. This Solaris 8 6/00 kit includes the routines and instructions you need to update the flash PROM in your system.

Determining If the Flash PROM Needs Updating

Note – If your system is an Ultra™ Enterprise™ 10000, you do not need to do this
update because the Ultra Enterprise 10000 does not have a flash PROM.
Only sun4u systems that can run the 64-bit mode of the Solaris 8 6/00 operating environment might need the flash PROM update. Systems that can only run the 32­bit mode (such as those in the sun4c, sun4d, and sun4m platform groups) do not require updated firmware to run Solaris 8 6/00 software.
73
Note – If the Solaris 8 6/00 operating environment notified you that the flash PROM
in your system needs updating, skip the steps in the procedure “To Determine If Your System Requires a Flash PROM Update” on page 74 and go directly to “Updating the Flash PROM” on page 75.
To Determine If Your System Requires a Flash
PROM Update
1. Determine the architecture type of your system.
% uname -m
TABLE6-1 Determining the System Architecture
If your system architecture type is . . . Then . . .
• sun4u Go to Step 2.
• sun4c, sun4d, sun4m You do not need a flash PROM update. Do not proceed further.
2. Determine the system type of your system.
% uname -i
TABLE6-2 Determining the System Type
If your system type is one of the following systems. . . Then . . .
SUNW, Ultra-1 SUNW, Ultra-2 SUNW, Ultra-4
SUNW, Ultra-Enterprise Go to Step 3. Not in the above list You do not need a flash PROM update. Do not proceed
74 Solaris 8 6/00 Sun Hardware Platform Guide • June 2000
Go to Chapter 5 “Updating the Flash PROM on the Ultra 1, Ultra 2, Ultra 450, and Sun Enterprise 450 Systems”
further.
3. Determine the version level of the firmware in your system. Type prtconf -V (upper case V).
% prtconf -V
TABLE6-3
If your system type is . . .
SUNW, Ultra-Enterprise 3.2.16 Proceed to “Updating the
SUNW, Ultra-1 3.11.1 Proceed to Chapter 5. You do not need a flash
SUNW, Ultra-2 3.11.2 Proceed to Chapter 5. You do not need a flash
SUNW, Ultra-4 3.7.107 Proceed to Chapter 5. You do not need a flash
And you see a number lower than . . . Then . . . Otherwise . . .
You do not need a flash
Flash PROM” on page 75.
PROM update. Do not proceed further.
PROM update. Do not proceed further.
PROM update. Do not proceed further.
PROM update. Do not proceed further.

Updating the Flash PROM

This section describes the following:
Flash PROM update process
Capturing NVRAM configuration variable settings
Making the flash PROM write-enabled
Steps to perform before updating the flash PROM
Updating the flash PROM

Flash PROM Update Process

Note – For step-by-step instructions, follow the procedures beginning with
“Capturing Configuration Variable Settings” on page 76.
Chapter 6 Updating the Flash PROM on the Sun Enterpr ise 3x00, 4x00, 5x00, and 6x00 Systems 75
After installing the Solaris 8 6/00 operating environment, make sure that the external front panel keyswitch is set to the On or Diagnostics position.
Take note of screen messages, during the flash PROM update, that report configuration variables that may be reset to their default values. When the update is complete and after you either reset the system or power cycle the system, revise the configuration variables as needed to restore your preferences.
Refer to the recovery procedure covered later in this chapter if there is a power interruption during the update process.
When your system has been updated to the proper firmware revision, you can run Solaris 8 6/00 software in 64-bit mode.

Capturing Configuration Variable Settings

While the Solaris operating environment is still running, capture the NVRAM configuration variable settings before you install the Solaris 8 6/00 operating environment or begin the flash PROM update process.
As part of the flash PROM update, your NVRAM configuration variables might change to the default values. To ensure that you can change the default values back to the values you customized, you need to save the current state of the NVRAM configuration variables using the eeprom command.

To Capture the Configuration Variable Settings

1. Using the eeprom utility, capture the system’s configuration variable settings in a file. Type eeprom > filename. The filename is any file name you choose.
% eeprom > filename
Note – If you have custom values installed in oem-logo or keymap, those values
cannot be displayed or printed properly by the eeprom utility because the contents contain binary information. If it is necessary to restore these values after a power loss, you should determine the original method by which these values were placed into NVRAM and use that method to restore the values.
76 Solaris 8 6/00 Sun Hardware Platform Guide • June 2000
2. Print out the values captured by the eeprom command. You must have a printed copy of the configuration values before you install the Solaris 8 6/00 operating environment and begin to update the flash PROM. Type the following:
lp filename

To Install the Solaris 8 6/00 Operating Environment

Install the Solaris 8 6/00 operating environment on your system.
Refer to the Installation Library which is in your Solaris 8 6/00 media kit. As the Solaris 8 6/00 operating environment is installed, you will be notified whether the flash PROM in your system needs updating. Installing this Solaris release will provide the software that can upgrade your system’s flash PROM to the required level.

Making the Flash PROM Write-Enabled

Before you update the OpenBoot firmware, which is contained in the flash PROM, you must set the front panel keyswitch to the proper position to allow the flash PROM to be write-enabled.
When the switch is set to the Locked position ( protected. When the switch is set to the On position or to the Diagnostics position, the flash PROM is write-enabled.
FIGURE 6-1 shows the keyswitch positions on a 16-slot Sun Enterprise 6000 system.
The server systems described in this section have the same keyswitch positions.
FIGURE 6-1), the flash PROM is write-

To Write Enable the Flash PROM

Turn the keyswitch to the On or Diagnostics position (FIGURE 6-1) before updating
the flash PROM.
Note – Disabling write-protection on servers assumes that the system’s write-
protect/enable jumpers were set in the default position (enabled). If you previously removed the write-protect/enable jumper, perform the steps to make the flash PROM write enabled in “Location of Flash PROM Jumpers in Sun Enterprise Server Systems” on page 87.
Chapter 6 Updating the Flash PROM on the Sun Enterpr ise 3x00, 4x00, 5x00, and 6x00 Systems 77
Standby
On
Diagnostics
Locked
Front view
FIGURE 6-1 Sun Enterprise 6x00, 5x00, 4x00, 3x00 Keyswitch Locations

Before Updating the Flash PROM

Before you begin updating the flash PROM, please note the following cautions.
Caution – Do not interrupt power during flash PROM updating. When you are
using the update routine, do not remove or insert system boards.
Caution – The flash update may cause default NVRAM values to overwrite
customized NVRAM variables. Be sure to record the custom and default values displayed so that you can restore them after you perform the flash PROM update.
Note – If power is interrupted during flash PROM updating, follow the power
interruption recovery procedures covered later in this chapter.
78 Solaris 8 6/00 Sun Hardware Platform Guide • June 2000

Running the Flash PROM Update Script Manually

The flash PROM update script is typically run at bootup. You can also run the flash PROM update script manually by doing the following:
1. Bring the system down to single user mode. Type the following:
% su
Type your superuser password
# init S
2. Execute the flash PROM update script by typing the following:
/bin/sh /usr/platform/sun4u/lib/prom/‘/usr/bin/uname -i‘
Follow the step-by-step instructions when running the script in the section “To Update the Flash PROM”. Begin with Step 2 (do not execute the reboot command).

To Update the Flash PROM

1. Reboot your system. Type reboot at the superuser prompt.
# reboot
Chapter 6 Updating the Flash PROM on the Sun Enterpr ise 3x00, 4x00, 5x00, and 6x00 Systems 79
2. If your flash PROM needs to be updated, the flash PROM update script displays the following message:
This system has older firmware. Although the current firmware is fully capable of running the 32-bit packages, you will not be able to run the 64-bit packages installed on this system until you update the system flash PROM.
This system ships with flash PROM write-protect jumpers in the "write enabled" position. Unless the jumpers on this system have been changed, there is no need to change them in order to run the system flash PROM update.
The front panel keyswitch on this system must NOT be in the "SECURE" position while the system flash PROM update is running. Please check the keyswitch position before answering the next question.
See the Hardware Platform Guide for more information.
Please answer the next question within 90 seconds, or press the ENTER key to disable the timer.
Would you like to run the system flash PROM update now? (By default the system flash PROM update will not be run now.) yes or no? [y,n] y Extracting files Loading flashprom driver
80 Solaris 8 6/00 Sun Hardware Platform Guide • June 2000
3. When the flash update process begins, it displays the current and available system board PROM revisions.
Current System Board PROM Revisions:
----------------------------------­Board 0: CPU/Memory OBP 3.2.16 1998/06/08 16:58 POST 3.9.4 1998/06/09 16:25 Board 2: CPU/Memory OBP 3.2.16 1998/06/08 16:58 POST 3.9.4 1998/06/09 16:25 Board 4: CPU/Memory OBP 3.2.16 1998/06/08 16:58 POST 3.9.4 1998/06/09 16:25 Board 6: CPU/Memory OBP 3.2.16 1998/06/08 16:58 POST 3.9.4 1998/06/09 16:25 Board 1: I/O Type 2 FCODE 1.8.3 1997/11/14 12:41 iPOST 3.4.6 1998/04/16 14:22 Board 3: I/O Type 5 FCODE 1.8.7 1997/12/08 15:39 iPOST 3.4.6 1998/04/16 14:22 Board 7: I/O Type 5 FCODE 1.8.7 1997/12/08 15:39 iPOST 3.4.6 1998/04/16 14:22
Available ‘Update’ Revisions:
----------------------------------­CPU/Memory OBP 3.2.16 1998/06/08 16:58 POST 3.9.4 1998/06/09 16:25 I/O Type 1 FCODE 1.8.3 1997/11/14 12:41 iPOST 3.4.6 1998/04/16 14:22 I/O Type 2 FCODE 1.8.3 1997/11/14 12:41 iPOST 3.4.6 1998/04/16 14:22 I/O Type 3 FCODE 1.8.7 1997/05/09 11:18 iPOST 3.0.2 1997/05/01 10:56 I/O Type 4 FCODE 1.8.7 1997/12/08 15:39 iPOST 3.4.6 1998/04/16 14:22 I/O Type 5 FCODE 1.8.7 1997/12/08 15:39 iPOST 3.4.6 1998/04/16 14:22
Chapter 6 Updating the Flash PROM on the Sun Enterpr ise 3x00, 4x00, 5x00, and 6x00 Systems 81
4. If any of the NVRAM configuration variables have been customized, the update displays both the default value and the customized (current) value.
Verifying Checksums: Okay
Do you wish to flash update your firmware? y/[n] : y **IMPORTANT** As a consequence of the firmware upgrade that is about to take place, it is very possible that the customized values in the configuration variables will revert to their *default values* upon the next system power-cycle or soft-reset. If this happens, it could have a significant effect on the behavior of the system after the power-cycle or soft-reset. Following is a list of the system's NVRAM configuration variables which have been customized (i.e. they are different than the default values). You may wish to write down the values of the indicated configuration variables so that they may be restored (if necessary) after the next power-cycle or soft-reset. Name: auto-boot? Default: true Current: false
Name: boot-file Default: <null> Current: kadb -d
5. Take note of the variables and values for current settings.
Either write down the current values or mark up the eeprom output you captured in “To Capture the Configuration Variable Settings” on page 76 so that you know which NVRAM configuration variables will need to be changed from their default values after the flash PROM update.
6. If the keyswitch is set to the locked position, you will see the following error message..
FPROM Write Protected: Check Write Enable Jumper or Front Panel Key Switch.
Make the flash PROM write-enabled by turning the keyswitch to the On or Diagnostics position then type reboot at the # prompt
82 Solaris 8 6/00 Sun Hardware Platform Guide • June 2000
7. The update then prompts you if you want to continue. Make sure that you have turned the keyswitch to the On or Diagnostics position then type y. The flash PROMs are updated.
Are you sure that you wish to continue? y/[n] : y
Updating Board 0: Type ’cpu’ (PromID=1a4)
1 Erasing ................................ Done.
1 Verifying Erase ................................ Done.
1 Programming ................................ Done.
1 Verifying Program ................................ Done.
Updating Board 1: Type ’upa-sbus’ (PromID=1a4)
1 Erasing ................................ Done.
1 Verifying Erase ................................ Done.
1 Programming ................................ Done.
1 Verifying Program ................................ Done.
Updating Board 4: Type ’dual-pci’ (PromID=1a4)
1 Erasing ................................ Done.
1 Verifying Erase ................................ Done.
1 Programming ................................ Done.
1 Verifying Program ................................ Done.
Updating Board 6: Type ’dual-pci’ (PromID=1a4)
1 Erasing ................................ Done.
1 Verifying Erase ................................ Done.
1 Programming ................................ Done.
1 Verifying Program ................................ Done.
Unloading flashprom driver
The new firmware will not take effect until the system is power­cycled.
8. After the flash PROMs are updated, the system asks if you would like to halt the system. Type yes.
Do you wish to halt the system now? yes or no? yes
The system’s shutdown messages are displayed.
Program terminated ok
Chapter 6 Updating the Flash PROM on the Sun Enterpr ise 3x00, 4x00, 5x00, and 6x00 Systems 83
Note – If you answered no to the question on halting the system, the installation
will continue but the updated firmware will not become effective until the next system reboot. The NVRAM configuration variables are changed to default values at the next system reboot. If you customized NVRAM configuration variables you must change the values back to their customized settings.
9. Turn the keyswitch to the Standby position.
10. Turn the power on to the system. As the system boots, diagnostics will be run at boot up because the OpenBoot diag-switch? was set to true in the flash PROM update procedure. Running diagnostics could take several minutes.
Note – Other NVRAM variables may be reset to their default values, which could
affect the system in other ways. For example, if you ran the flash PROM update through the serial port and the system still has its keyboard plugged in, you will no longer get any response from the serial port connection. The firmware will be waiting for input from the keyboard.
TABLE 6-4, which follows, describes the
workarounds for NVRAM settings.
11. As the system boots, go to the ok prompt by one of the following methods. a. Press Stop-a from the keyboard. b. If you are running on a terminal and connected to serial port A of the system,
press the Break key.
c. If you are connected to serial port A via telnet connection send a Break
sequence by pressing the Control and ] keys simultaneously. This returns you to the telnet command line. Type send brk at the telnet command line.
d. If you are connected to serial port A via a tip connection, send a Break
sequence by typing the characters ~# in quick succession.
84 Solaris 8 6/00 Sun Hardware Platform Guide • June 2000
Loading...