Sun Microsystems Fire 4810 Installation manual

Sun Microsystems, Inc.
901 San Antonio Road
Palo Alto, CA 94303 U.S.A.
650-960-1300
Send comments about this document to: [email protected]
Sun Fire™6800/4810/4800/3800
System Controller
Command Reference Manual
Part No. 805-7372-11
April 2001, Revision A

Please
Recycle
Copyright 2001 Sun Microsystems, Inc., 901 San Antonio Road • Palo Alto, CA 94303 USA. All rights reserved.
This product or document is protected by copyright and distributed under licenses restricting its use, copying, distribution, and
decompilation. No part of this product or document may be reproduced in any form by any means without prior written authorization
of Sun and 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 registered trademark in
the U.S. and other countries, exclusively licensed through X/Open Company, Ltd.
Sun, Sun Microsystems, the Sun logo, AnswerBook2, docs.sun.com, OpenBoot, Sun Fire, and Solaris are trademarks, registered trademarks, or
service marks of Sun Microsystems, Inc. in the U.S. and other countries. All SPARC trademarks are used under license and are trademarks or
registered trademarks of SPARC International, Inc. in the U.S. and other countries. Products bearing SPARC trademarks are based upon an
architecture developed by Sun Microsystems, Inc.UNIX is a registered trademark in the United States and other countries, exclusively licensed
through X/Open Company, Ltd.
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.
Federal Acquisitions: Commercial Software—Government Users Subject to Standard License Terms and Conditions.
DOCUMENTATION IS PROVIDED “AS IS” AND ALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES,
INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NON-
INFRINGEMENT, ARE DISCLAIMED, EXCEPT TO THE EXTENT THAT SUCH DISCLAIMERS ARE HELD TO BE LEGALLY INVALID.
Copyright 2001 Sun Microsystems, Inc., 901 San Antonio Road • Palo Alto, CA 94303 Etats-Unis. Tous droits réservés.
Ce produit ou document est protégé par un copyright et distribué avec des licences qui en restreignent l’utilisation, la copie, la distribution, et la
décompilation. Aucune partie de ce produit ou document ne peut être reproduite sous aucune forme, parquelque 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
relative aux 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.
Sun, Sun Microsystems, le logo Sun, AnswerBook2, docs.sun.com, OpenBoot, Sun Fire, ,et Solaris 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. Toutes les marques SPARC sont utilisées sous
licence et sont des marques de fabrique ou des marques déposées de SPARC International, Inc. aux Etats-Unis et dans d’autres pays. Les
produits portant les marques SPARC sont basés sur une architecture développée par Sun Microsystems, Inc. UNIX est une marque enregistree
aux Etats-Unis et dans d’autres pays et licenciée exclusivement par X/Open Company Ltd.
L’interface d’utilisation graphique OPEN LOOK et Sun™ a été développée par Sun Microsystems, Inc. pour ses utilisateurs et licenciés. Sun
reconnaît les efforts de pionniers de Xerox pour la recherche et 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 VALEUR MARCHANDE, L’APTITUDE DE LA PUBLICATION A REPONDRE A UNE
UTILISATION PARTICULIERE, OU LE FAIT QU’ELLE NE SOIT PAS CONTREFAISANTE DE PRODUIT DE TIERS. CE DENI DE
GARANTIE NE S’APPLIQUERAIT PAS, DANS LA MESURE OU IL SERAIT TENU JURIDIQUEMENT NUL ET NON AVENU.

iii
Contents
Preface xv
1. Introduction to the System Controller 1
Platform Administration 2
Platform Shell 2
Platform Console 2
Domain Administration 3
Domain Shell and Domain Console 3
Accessing the System Controller Main Menu 5
Accessing the System Controller Main Menu Using telnet 5
▼To Access the System Controller Main Menu and Enter the Platform Shell
Using telnet 5
▼To Access the System Controller Main Menu and Enter a Domain Shell Using
telnet 6
Accessing the System Controller Main Menu Using the Serial Port 9
▼To Access the System Controller Main Menu if You Connected the System
Controller Serial Port to an ASCII Terminal 9
▼To Access the System Controller Main Menu if You Connected the Serial Port
to a Network Terminal Server (NTS) 9
▼To Obtain the Domain Shell Prompt From the Domain Console Prompt 10

iv Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • April 2001
System Controller Navigation 10
▼To Enter the Domain Console From the Domain Shell If the Domain Is
Inactive 13
▼To Enter the Domain Shell From the Domain Console 14
▼To Get Back to the Domain Console From the Domain Shell 14
▼To Enter a Domain From the Platform Shell 15
▼To Terminate a Session With telnet If You Are Connected to the Ethernet
Port 15
▼To Terminate a Session With tip If You Are Connected to the Serial Port 16
2. System Controller Alphabetical Command Reference 17
System Controller Syntax, Command Names, Command Arguments, and
Comments 17
Command Syntax 17
Command Names 18
Command Arguments 18
Device Names 18
Board States 19
Status 20
Comments 20
Clearing an Entry 21
System Controller Command Summary 21
Status 23
Domain States 24

Contents v
Alphabetical Listing of System Controller Commands 25
addboard 25
break 28
connections 30
console 32
deleteboard 35
disablecomponent 37
disconnect 41
dumpconfig 43
enablecomponent 46
flashupdate 49
help 56
history 58
password 59
poweroff 61
poweron 64
reboot 67
reset 69
restoreconfig 72
resume 74
setdate 75
setdefaults 79
setkeyswitch 81
setupdomain 85
setupplatform 90
showboards 94
showcomponent 98

vi Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • April 2001
showdate 101
showdomain 103
showenvironment 107
showkeyswitch 111
showlogs 113
showplatform 115
showsc 120
testboard 121
Glossary 123
Index 125

vii
Figures
FIGURE 1-1 Navigating Between the Platform Shell and the Domain Shell 11
FIGURE 1-2 Navigating Between the Domain Shell, the OpenBoot PROM, and the Solaris Operating
Environment 12
FIGURE 1-3 Navigating Between the OpenBoot PROM and the Domain Shell 13

viii Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • April 2001

ix
Tables
TABLE 1-1 Maximum Number of Active Domains by System Type and Partition Mode 4
TABLE 2-1 Devices That Can Be Managed in the Platform Shell 18
TABLE 2-2 Devices That Can Be Managed in a Domain 19
TABLE 2-3 Board States 19
TABLE 2-4 Status Field Displayed in the showboards Command 20
TABLE 2-5 System Controller Command Summary 21
TABLE 2-6 Status Field Displayed in the showboards Command 23
TABLE 2-7 Header Description for CODE EXAMPLE 2-4 31
TABLE 2-8 component_name Descriptions for the CPU/Memory Board Used in the
disablecomponent Command 38
TABLE 2-9 component_name Descriptions for the I/O Assembly Used in the disablecomponent
Command 38
TABLE 2-10 dumpconfig Example 45
TABLE 2-11 component_name Descriptions for the CPU/Memory Board Used in the enablecomponent
Command 46
TABLE 2-12 component_name Descriptions for the I/O Assembly Used in the enablecomponent
Command 47
TABLE 2-13 enablecomponent Command Example Enabling CPU/Memory Board 4 48
TABLE 2-14 poweron Command Example Showing Powering On CPU/Memory Board 2 66
TABLE 2-15 poweron Command Example Showing Powering On I/O Assembly 7 66

xSun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • April 2001
TABLE 2-16 poweron Command Example Showing Powering On All CPU/Memory Boards and I/O
Assemblies in Domain A 66
TABLE 2-17 Time Zone Abbreviations, Time Zone Name, and Offsets From Greenwich Mean Time 76
TABLE 2-18 setdate Command Example in the Platform Shell 77
TABLE 2-19 setkeyswitch Values and Description 82
TABLE 2-20 Results of Changing the Keyswitch From the Current Setting to a New Setting 82
TABLE 2-21 setkeyswitch on Example 84
TABLE 2-22 setkeyswitch off Example 84
TABLE 2-23 setkeyswitch off Example Shutting Down Domain B From the Platform Shell 84
TABLE 2-24 Parameter Values for the setupdomain Command 87
TABLE 2-25 setupplatform Parameter Values 91
TABLE 2-26 Output Header Definitions for the showboards -v Command 96
TABLE 2-27 showenvironment -p part Descriptions 108
TABLE 2-28 showenvironment Output Header Description 108
TABLE 2-29 Definitions of Headings for Status of All Domains in CODE EXAMPLE 2-62 119
TABLE 2-30 testboard Example Testing CPU/Memory Board 0 122

xi
Code Samples
CODE EXAMPLE 1-1 Accessing the System Controller With telnet and Entering the Platform Shell 6
CODE EXAMPLE 1-2 Accessing a Domain Shell Using the telnet Command 7
CODE EXAMPLE 1-3 Accessing a Domain Shell From the Domain Console 8
CODE EXAMPLE 1-4 Accessing a Domain Shell From the Domain Console 10
CODE EXAMPLE 1-5 Obtaining a Domain Shell From the Domain Console 14
CODE EXAMPLE 2-1 addboard Example in the Platform Shell 26
CODE EXAMPLE 2-2 addboard Example in the Domain Shell 27
CODE EXAMPLE 2-3 break Command Example in the Domain Shell 29
CODE EXAMPLE 2-4 connections Command for the Platform Shell 31
CODE EXAMPLE 2-5 console Example With the -d Option and No Password Assigned Accessing Domain
B33
CODE EXAMPLE 2-6 console Example Without the -d Option and No Password Assigned Accessing Domain
B33
CODE EXAMPLE 2-7 console Example With the -d Option and A Password Assigned Accessing Domain A 33
CODE EXAMPLE 2-8 console Example Without the -d Option and A Password Assigned Accessing Domain
A34
CODE EXAMPLE 2-9 deleteboard Example Showing Deleting I/O Assembly 7 36
CODE EXAMPLE 2-10 deleteboard Example Showing Deleting CPU/Memory Board 3 36
CODE EXAMPLE 2-11 disablecomponent Command Example Adding sb4 to the Blacklists 40
CODE EXAMPLE 2-12 disablecomponent Command Example Adding sb0 CPU Port 3 to the Blacklist 40
CODE EXAMPLE 2-13 disablecomponent Command Example Adding sb2, CPU Port 3, and Physical Bank 0
to the Blacklists 40

xii Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • April 2001
CODE EXAMPLE 2-14 disablecomponent Command Example Adding I/O Assembly 9, Port 0 and Bus 1 and
Also I/O Assembly 8, I/O Card 2 to the Blacklists 40
CODE EXAMPLE 2-15 Disconnecting a Session From the System Controller Platform Shell 42
CODE EXAMPLE 2-16 Disconnecting a Session From the System Controller Platform Console 42
CODE EXAMPLE 2-17 disconnect Example Showing Disconnecting a Session From the Domain A Shell 42
CODE EXAMPLE 2-18 enablecomponent Command Example Enabling I/O Assembly 6 and Port 1 48
CODE EXAMPLE 2-19 Example of the flashupdate Command Entering Single-User Mode 52
CODE EXAMPLE 2-20 flashupdate Example Updating the Active System Controller Board and the System
Controller Real Time Operating System 54
CODE EXAMPLE 2-21 flashupdate Example Updating System Boards (CPU/Memory Boards and I/O
Assemblies) 54
CODE EXAMPLE 2-22 flashupdate Example Updating CPU/Memory Board 4 54
CODE EXAMPLE 2-23 flashupdate Example Updating I/O Assembly 8 54
CODE EXAMPLE 2-24 flashupdate Example Updating the System Controller Real Time Operating System 55
CODE EXAMPLE 2-25 help Command Example Displaying Information on the addboard Command 57
CODE EXAMPLE 2-26 help Command Example Displaying Commands Beginning With the Word show 57
CODE EXAMPLE 2-27 help Command Example Displaying Commands Beginning With the Letter A 57
CODE EXAMPLE 2-28 history Command 58
CODE EXAMPLE 2-29 password Command Example With No Password Set 60
CODE EXAMPLE 2-30 password Command Example With a Password Already Set 60
CODE EXAMPLE 2-31 poweroff Command Example Showing Powering Off CPU/Memory Board 2 63
CODE EXAMPLE 2-32 poweroff Command Example Showing Powering Off All Power Supplies and Currently
Controllable Boards in the Platform Shell 63
CODE EXAMPLE 2-33 poweroff Command Example Showing Powering Off All CPU/Memory Boards and I/O
Assemblies in Domain A 63
CODE EXAMPLE 2-34 poweroff Command Example Showing Powering Off
I/O Assembly 7 63
CODE EXAMPLE 2-35 reset Command Example From Domain A 71
CODE EXAMPLE 2-36 reset -a Command Example From Domain A 71
CODE EXAMPLE 2-37 reset Command Example Resetting ssc0 From ssc1 in the Platform Shell 71
CODE EXAMPLE 2-38 restoreconfig Example 73
CODE EXAMPLE 2-39 resume Command Example in Domain A 74

Code Samples xiii
CODE EXAMPLE 2-40 setdate -r Command Example Setting the Date From a Date Host 78
CODE EXAMPLE 2-41 setdate -t Command Example Setting the Time Zone to Pacific Standard Time Using
the Offset From Greenwich Mean Time 78
CODE EXAMPLE 2-42 setdate -t Command Example Setting the Time Zone to Eastern Standard Time Using
Time Zone Abbreviations and Also Setting the Date 78
CODE EXAMPLE 2-43 setdate -t Command Example Setting the Time Zone to Japan Standard Time Using
the Offset From Greenwich Mean Time 78
CODE EXAMPLE 2-44 setdate -t Command Example Setting the Time Zone to Eastern Central Time Using
Time Zone Abbreviations 78
CODE EXAMPLE 2-45 setdefaults Example 80
CODE EXAMPLE 2-46 Variables for the setupdomain Command 86
CODE EXAMPLE 2-47 Output From setupplatform Command 93
CODE EXAMPLE 2-48 showboards Command for the Platform Shell 95
CODE EXAMPLE 2-49 showboards -v Command for the Platform Shell 95
CODE EXAMPLE 2-50 showboards Command for the Domain Shell 97
CODE EXAMPLE 2-51 showcomponent sb4 Sample Output 99
CODE EXAMPLE 2-52 showcomponent ib6 Sample Output 100
CODE EXAMPLE 2-53 showdate Command for the Platform Shell 102
CODE EXAMPLE 2-54 showdate Command for the Domain Shell 102
CODE EXAMPLE 2-55 showdomain Command Example 104
CODE EXAMPLE 2-56 showdomain -v Command Example 105
CODE EXAMPLE 2-57 showdomain -p bootparams Example Displaying Boot Parameter Information 106
CODE EXAMPLE 2-58 showenvironment Platform Shell and Domain Shell Example 110
CODE EXAMPLE 2-59 showkeyswitch Example Showing the Keyswitch Set to On 112
CODE EXAMPLE 2-60 showkeyswitch Example Showing the Keyswitch Set to Off 112
CODE EXAMPLE 2-61 showkeyswitch Example Showing the Keyswitch Set to Standby 112
CODE EXAMPLE 2-62 showplatform Output for a Sun Fire 6800 System 116
CODE EXAMPLE 2-63 showplatform -v Output for a Sun Fire 6800 System 117
CODE EXAMPLE 2-64 showsc Command 120

xiv Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • April 2001

xv
Preface
This book describes how to use the system controller command line interface, which
controls the system functions and provides environmental monitoring plus domain
and hardware control. With the system controller software, you can configure the
platform and domains, as well as power on and off domains, power supplies, fans,
and other components. The system controller also provides a platform console and a
domain console.
Before You Read This Book
This book is for system administrators, who have a working knowledge of the
Solaris™operating environment. If you do not have such knowledge, you should
first read the Solaris User and System Administrator AnswerBooks and consider
UNIX®system administration training.
How This Book Is Organized
This book contains the following chapters:
Chapter 1 introduces you to the system controller. It explains the platform shell and
the domain shell. It also describes the responsibilities of the platform administrator
and the domain administrator. It provides step-by-step procedures on how to enter
the platform shell and the domain shell of the system controller, how to navigate
within the system controller, between the system controller and the Solaris operating
environment, and between the OpenBoot™PROM and the system controller. It also
explains how to terminate a system controller session.

xvi Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • April 2001
Chapter 2 explains system controller command syntax, command names, and
command arguments. It also provides in tabular form a summary of all of the system
controller commands and provides complete descriptions, with syntax, and
examples for each system controller command.
Typographic Conventions
Shell Prompts
Typeface Meaning Examples
AaBbCc123 The names of commands, files,
and directories; on-screen
computer output
Edit your .login file.
Use ls -a to list all files.
AaBbCc123 What you type, when
contrasted with on-screen
computer output
%su
Password:
AaBbCc123 Book titles, new words or terms,
words to be emphasized
Command-line variable; replace
with a real name or value
Read Chapter 6 in the User’s Guide.
These are called class options.
You must be superuser to do this.
To delete a file, type rm filename.
Shell Prompt
C shell machine_name%
C shell superuser machine_name#
Bourne shell and Korn shell $
Bourne shell and Korn shell superuser #
Platform shell schostname:SC>
Domain shell schostname:A> or B>,C>,D>

Preface xvii
Related Documentation
Accessing Sun Documentation Online
The docs.sun.comsm web site enables you to access a select group of 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
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://www.fatbrain.com/documentation/sun
Application Title Part Number
Service Sun Fire 6800/4810/4800/3800 Systems
Service Manual 805-7363
Service Sun Fire 4810/4800/3800 System Cabinet
Mounting Guide 806-6781
System Administration Sun Fire 6800/4810/4800/3800 Systems
Platform Administration Manual 805-7373

xviii Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • April 2001
Sun Welcomes Your Comments
Sun is interested in improving its documentation and welcomes your comments and
suggestions. You can email your comments to Sun at:
[email protected]
Please include the part number of your document, which is on the title page, in the
subject line of your email.

1
CHAPTER 1
Introduction to the System
Controller
This chapter introduces you to the system controller. It explains the platform shell
and the domain shell. It describes the responsibilities of the platform administrator
and the domain administrator . It provides step-by-step procedures and illustrations
on how to navigate with the system controller and between the system controller
and the Solaris operating environment and the OpenBoot PROM. It also explains
how to terminate a system controller session.
The system controller consists of the System Controller board and the system
controller software. The system controller provides communication pathways
between the system controller and domains.
The system controller software does the following:
■Monitors and controls the system
■Manages hardware
■Configures domains
■Provides the date and time to the Solaris operating environment
■Provides the clock signal used on all system boards
■Provides a platform console and a domain console
The following topics are covered in this chapter:
■“Platform Administration” on page 2
■“Domain Administration” on page 3
■“Accessing the System Controller Main Menu” on page 5
■“System Controller Navigation” on page 10

2Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • April 2001
Platform Administration
The platform administration function provides services for the domain and provides
access to hardware available within the platform. With this function, you can
manage hardware resources across domains.
Some of the functions include:
■Logically grouping hardware to create domains with the addboard and
deleteboard commands
■Setting passwords with the password command
■Monitoring and controlling power to the components within a platform.
■Configuring the system controller, the network, loghosts, and SNMP
■Defining the maximum number of domains a system can support
■Defining access control for CPU/Memory boards and I/O assemblies
Platform Shell
With the platform shell, you can use commands that pertain to the platform.
Specifically, the platform shell is the operating environment for the platform
administrator, and is the shell where platform tasks can be performed.
You can access the platform shell with a telnet session (if your system controller is
networked) and/or a serial connection. Log messages go to the platform shell’s
serial (RS-232) connection (console). The prompt is schostname:SC>.
Platform Console
A platform console is a platform shell that is connected through the serial
(RS-232) port.
The platform console provides messages specific to the platform. However, the
platform console does not show the Solaris operating environment messages. These
messages are displayed in the domain console.