Sun Microsystems Fire 6800 User manual

Sun Microsystems, Inc.
4150 Network Circle
Santa Clara, CA 95054 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. 816-4852-10
October 2002, Revision A

Please
Recycle
Copyright 2002 Sun Microsystems, Inc., 4150 Network Circle,Santa Clara, California 95054, U.S.A. All rights reserved.
Sun Microsystems, Inc. has intellectual property rights relating to technology embodied in the product that is described in this document. In
particular, and without limitation, these intellectual property rights may include one or more of the U.S. patents listed at
http://www.sun.com/patents and one or more additional patents or pending patent applications in the U.S. and in other countries.
This document and the product to which it pertains are distributed under licenses restricting their use, copying, distribution, and
decompilation. No part of the product or of this 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 in other countries, exclusively licensed through X/Open Company, Ltd.
Sun, Sun Microsystems, the Sun logo , docs.sun.com, OpenBoot, Sun Fire, and Solaris are trademarks or registered trademarks of Sun
Microsystems, Inc. in the U.S. and in other countries.
All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. in the U.S. and in other
countries. Products bearing SPARC trademarks are based upon an architecture developed 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.
Use, duplication, or disclosure by the U.S. Government is subject to restrictions set forth in the Sun Microsystems, Inc. license agreements and as
provided in DFARS 227.7202-1(a) and 227.7202-3(a) (1995), DFARS 252.227-7013(c)(1)(ii) (Oct. 1998), FAR 12.212(a) (1995), FAR 52.227-19, or
FAR 52.227-14 (ALT III), as applicable.
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 2002 Sun Microsystems, Inc., 4150 Network Circle, Santa Clara, California 95054, Etats-Unis. Tous droits réservés.
Sun Microsystems, Inc. a les droits de propriété intellectuels relatants à la technologie incorporée dans le produit qui est décrit dans ce
document. En particulier, et sans la limitation, ces droits de propriété intellectuels peuvent inclure un ou plus des brevets américains énumérés
à http://www.sun.com/patents et un ou les brevets plus supplémentaires ou les applications de brevet en attente dans les Etats-Unis et dans
les autres pays.
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 ena.
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, docs.sun.com, OpenBoot, Sun Fire, et Solaris sont des marques de fabrique ou des marques déposées 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 protant les marques SPARC sont basés sur une architecture développée par Sun
Microsystems, Inc.
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éveloppment du concept des interfaces d’utilisation visuelle ou graphique
pour l’industrie de l’informatique. Sun détient une license non exclusive do Xerox sur l’interface d’utilisation graphique Xerox, cette licence
couvrant également les licenciées de Sun qui mettent en place l’interface d ’utilisation graphique OPEN LOOK et qui en outre se conforment
aux licences écrites de Sun.
LA DOCUMENTATION EST FOURNIE "EN L’ÉTAT" ET TOUTES AUTRES CONDITIONS, DECLARATIONS ET GARANTIES EXPRESSES
OU TACITES SONT FORMELLEMENT EXCLUES, DANS LA MESURE AUTORISEE PAR LA LOI APPLICABLE, Y COMPRIS NOTAMMENT
TOUTE GARANTIE IMPLICITE RELATIVE A LA QUALITE MARCHANDE, A L’APTITUDE A UNE UTILISATION PARTICULIERE OU A
L’ABSENCE DE CONTREFAÇON.

i
Contents
Preface xi
1. Introduction to the System Controller 1
Platform and Domain Administration 1
Connecting to the System Controller 2
System Controller Navigation 2
Terminating Sessions 2
2. System Controller Syntax, Arguments, and Device Names 3
Command Syntax and Arguments 3
Command Names 4
Component Names 4
Board States for CPU/Memory Boards and I/O Assemblies 6
Board Test Status 6
Domain Status 7
Using FTP URLs 8
Interactive Commands 9
Context-Sensitive Commands 9
Command Line Editing 10
Command Line History 11

ii Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2002
Command Completion 12
3. System Controller Alphabetical Command Reference 13
Command Summary 13
Alphabetical Listing of System Controller Commands 16
addboard 16
addcodlicense 19
break 21
connections 23
console 25
deleteboard 27
deletecodlicense 29
disablecomponent 31
disconnect 35
dumpconfig 37
enablecomponent 39
flashupdate 42
help 47
history 49
password 50
poweroff 52
poweron 55
reboot 58
reset 60
restoreconfig 62
resume 65
setdate 67
setdefaults 72
setfailover 75

Contents iii
setkeyswitch 77
setupdomain 82
setupplatform 88
showboards 96
showcodlicense 102
showcodusage 104
showcomponent 108
showdate 111
showdomain 113
showenvironment 117
showerrorbuffer 122
showfailover 125
showkeyswitch 128
showlogs 130
showplatform 132
showresetstate 138
showsc 140
testboard 142
Glossary 159
Index 161

iv Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2002

v
Tables
TABLE 2-1 Components That Are Accessible From the Platform 5
TABLE 2-2 Components That Are Accessible From a Domain 5
TABLE 2-3 Board States 6
TABLE 2-4 Status Field of the showboards Command 6
TABLE 2-5 Values for the Domain Status Column in showplatform and showdomain Command
Output 7
TABLE 2-6 Command Line Editing Capabilities 10
TABLE 2-7 Keystrokes that Recall Previously Typed Command Lines 11
TABLE 2-8 Keystrokes Used to Complete System Controller Commands 12
TABLE 3-1 System Controller Command Summary 13
TABLE 3-2 Header Description for the connections Command 24
TABLE 3-3 component_name Descriptions for the CPU/Memory Board Used in the
disablecomponent Command 32
TABLE 3-4 component_name Descriptions for the I/O Assembly Used in the disablecomponent
Command 32
TABLE 3-5 component_name Descriptions for the CPU/Memory Board Used in the enablecomponent
Command 39
TABLE 3-6 component_name Descriptions for the I/O Assembly Used in the enablecomponent
Command 40
TABLE 3-7 Time Zone Abbreviations, Time Zone Name, and Offsets From Greenwich Mean Time 68
TABLE 3-8 Description of the setkeyswitch Transition 78
TABLE 3-9 Results of Changing the Keyswitch From the Current Setting to a New Setting 78

vi Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2002
TABLE 3-10 Parameter Values for the setupdomain Command 82
TABLE 3-11 setupplatform Parameter Values 89
TABLE 3-12 Output Header Definitions for the showboards and the showboards -v Command 98
TABLE 3-13 COD License Information 102
TABLE 3-14 showcodusage Resource Information 105
TABLE 3-15 showcodusage Domain Information 106
TABLE 3-16 Parts for showenvironment -p part 118
TABLE 3-17 showenvironment Output Header Description 118

vii
Code Samples
CODE EXAMPLE 3-1 addboard Example in the Platform Shell 18
CODE EXAMPLE 3-2 addboard Example in the Domain Shell 18
CODE EXAMPLE 3-3 addcodlicense Command Example 20
CODE EXAMPLE 3-4 break Command Example 22
CODE EXAMPLE 3-5 connections Command for the Platform Shell 24
CODE EXAMPLE 3-6 console Example and No Password Set Accessing Domain B 26
CODE EXAMPLE 3-7 console Example and A Password Set Accessing Domain A 26
CODE EXAMPLE 3-8 deleteboard Example Showing Deleting I/O Assembly 7 28
CODE EXAMPLE 3-9 deleteboard Example Showing Deleting CPU/Memory Board 3 28
CODE EXAMPLE 3-10 deletecodlicense Command Example 30
CODE EXAMPLE 3-11 disablecomponent Command Example Adding sb4 to the Blacklists 34
CODE EXAMPLE 3-12 disablecomponent Command Example Adding sb0 CPU Port 3 to the Blacklist 34
CODE EXAMPLE 3-13 disablecomponent Command Example Adding sb2, CPU Port 3, and Physical Bank 0
to the Blacklists 34
CODE EXAMPLE 3-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 34
CODE EXAMPLE 3-15 Disconnecting a Session From the System Controller Platform Shell 36
CODE EXAMPLE 3-16 Disconnecting a Session From the System Controller Platform Console 36
CODE EXAMPLE 3-17 disconnect Example Showing Disconnecting a Session From the Domain A Shell 36
CODE EXAMPLE 3-18 dumpconfig Example 38
CODE EXAMPLE 3-19 enablecomponent Command Example Enabling CPU/Memory Board 4 41

viii Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2002
CODE EXAMPLE 3-20 enablecomponent Command Example Enabling I/O Assembly 6 and Port 1 41
CODE EXAMPLE 3-21 flashupdate Example Updating the Active System Controller Board and the System
Controller Real Time Operating System 46
CODE EXAMPLE 3-22 flashupdate Example Updating Replacement CPU/Memory Board sb4 46
CODE EXAMPLE 3-23 help Command Example Displaying Information on the addboard Command 48
CODE EXAMPLE 3-24 help Command Example Displaying Commands Beginning With the Word show 48
CODE EXAMPLE 3-25 help Command Example Displaying Commands Beginning With the Letter A 48
CODE EXAMPLE 3-26 history Command 49
CODE EXAMPLE 3-27 password Command Example With a Password Already Set 51
CODE EXAMPLE 3-28 password Command Example With No Password Set 51
CODE EXAMPLE 3-29 poweroff Command Example Showing Powering Off sb2 54
CODE EXAMPLE 3-30 poweroff Command Example Showing Powering Off All Power Supplies, Fan Trays, and
System Boards in the Platform Shell 54
CODE EXAMPLE 3-31 poweron Example Powering On sb2 56
CODE EXAMPLE 3-32 poweron Example Showing Powering On All CPU/Memory Boards and I/O Assemblies in
Domain A 57
CODE EXAMPLE 3-33 reboot Command Example 59
CODE EXAMPLE 3-34 reset Command Example From Domain A 61
CODE EXAMPLE 3-35 reset -a Command Example From Domain A 61
CODE EXAMPLE 3-36 restoreconfig Example 63
CODE EXAMPLE 3-37 resume Command Example in Active Domain A 66
CODE EXAMPLE 3-38 setdate Command Example in the Platform Shell 70
CODE EXAMPLE 3-39 setdate -r Command Example Setting the Date From a Date Host 70
CODE EXAMPLE 3-40 setdate -t Command Example Setting the Time Zone to Pacific Standard Time Using
the Offset From Greenwich Mean Time 70
CODE EXAMPLE 3-41 setdate -t Command Example Setting the Date and Time Zone to Eastern Standard
Time Using Time Zone Abbreviations 70
CODE EXAMPLE 3-42 setdate -t Command Example Setting the Time Zone to Japan Standard Time Using
the Offset From Greenwich Mean Time 71
CODE EXAMPLE 3-43 setdate -t Command Example Setting the Time Zone to Eastern Central Time Using
Time Zone Abbreviations 71
CODE EXAMPLE 3-44 setdefaults Example 74
CODE EXAMPLE 3-45 setfailover Command Example (run on the Spare SC) of Manual Failover 76

Code Samples ix
CODE EXAMPLE 3-46 setfailover Command Example Disabling Failover 76
CODE EXAMPLE 3-47 setfailover Command Example Re-enabling Failover 76
CODE EXAMPLE 3-48 setkeyswitch on Example 80
CODE EXAMPLE 3-49 setkeyswitch off Example 81
CODE EXAMPLE 3-50 setkeyswitch off Example Shutting Down Domain B From the Platform Shell 81
CODE EXAMPLE 3-51 Variables for the setupdomain Command 87
CODE EXAMPLE 3-52 setupplatform Output 94
CODE EXAMPLE 3-53 showboards Command for the Platform Shell 97
CODE EXAMPLE 3-54 showboards Command with the -p version Option 98
CODE EXAMPLE 3-55 showboards -a Command for the Domain Shell 101
CODE EXAMPLE 3-56 showcodlicense Example Output – Formatted COD RTU License Data 103
CODE EXAMPLE 3-57 showcodlicense -r Example Output – COD RTU License Keys 103
CODE EXAMPLE 3-58 showcodlicense -v Example Output – Formatted and Raw COD RTU License
Data 103
CODE EXAMPLE 3-59 showcodusage Example Output by Resource 105
CODE EXAMPLE 3-60 showcodusage Example Output by Domain 106
CODE EXAMPLE 3-61 showcodusage Example Output by Both Resource and Domain 107
CODE EXAMPLE 3-62 showcomponent sb4 Sample Output 109
CODE EXAMPLE 3-63 showcomponent ib6 Sample Output 110
CODE EXAMPLE 3-64 showdate Command for the Platform Shell 112
CODE EXAMPLE 3-65 showdomain Command Example 114
CODE EXAMPLE 3-66 showdomain -v Command Example 115
CODE EXAMPLE 3-67 showdomain -p bootparams Example Displaying Boot Parameter Information 116
CODE EXAMPLE 3-68 showenvironment Platform Shell and Domain Shell Example 120
CODE EXAMPLE 3-69 showerrorbuffer Example Output for an Interconnect Test 123
CODE EXAMPLE 3-70 showerrorbuffer Example Output for a Hardware Error 123
CODE EXAMPLE 3-71 showfailover Command Indicating Failover is Functioning Normally 126
CODE EXAMPLE 3-72 showfailover Command Indicating Failover Has Been Disabled 126
CODE EXAMPLE 3-73 showfailover Command in Verbose Mode 126
CODE EXAMPLE 3-74 showfailover Command Indicating SC Failover is Inactive 127

xSun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2002
CODE EXAMPLE 3-75 showkeyswitch Example Showing the Keyswitch Set to On 129
CODE EXAMPLE 3-76 showkeyswitch Example Showing the Keyswitch Set to Off 129
CODE EXAMPLE 3-77 showkeyswitch Example Showing the Keyswitch Set to Standby 129
CODE EXAMPLE 3-78 Sample Output of the showlogs Command Run After Rebooting the System 131
CODE EXAMPLE 3-79 showplatform Output for a Sun Fire 6800 System 134
CODE EXAMPLE 3-80 showplatform -v Output for a Sun Fire 6800 System 135
CODE EXAMPLE 3-81 showsc Command 140
CODE EXAMPLE 3-82 testboard Example Testing CPU/Memory Board sb0 143

xi
Preface
This book describes the Sun FireTM 6800/4810/4800/3800 system controller
command line interface. The system controller is responsible for controlling system
functions, environmental monitoring, domain control, and hardware control of the
server. Using the command line interface, you can configure the platform and
domains, power on and off domains, power supplies, fans, and other components.
Access to the Solaris domain console is also possible using the command line
interface.
Before You Read This Book
This book is written for system administrators or people 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
document collections and consider UNIX®system administration training. For the
documentation URLs, see “Accessing Sun Documentation Online” on page xiii.
How This Book Is Organized
This book contains the following chapters:
Chapter 1 introduces you to the system controller and briefly describes platform
administration and domain administration.
Chapter 2 explains system controller command syntax, command names, and
command arguments.

xii Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • September 2002
Chapter 3 provides a summary in tabular form of all of the system controller
commands and describes each 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, such as
board_name.
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 xiii
Related Documentation
Accessing Sun Documentation Online
You can view, print, or purchase a broad selection of Sun documentation, including
localized versions, at:
http://www.sun.com/documentation
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 (816-4852-10) of your document in the subject line of
your email.
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 816-4851-10
System Administration Sun Fire 6800/4810/4800/3800 Systems
Firmware 5.14.0 Release Notes 816-4853-10

xiv Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • September 2002

1
CHAPTER 1
Introduction to the System
Controller
The system controller consists of the System Controller board and the system
controller software.
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
■Provides system monitoring and control using SNMP for use with the Sun
Management Center 3.0 software.
For more information on the system controller, refer to the “Overview” chapter of
the Sun Fire 6800/4810/4800/3800 Systems Platform Administration Manual and also the
Sun Fire 6800/4810/4800/3810 Systems Overview Manual.
Platform and Domain Administration
The platform administration function manages resources and services that are
shared among the domains. With this function, you can configure how resources and
services are configured and shared.
The domain administration function manages resources and services for a specific
domain. With this function you can configure the domain, control the keyswitch
position, and access the domain console.

2Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • September 2002
For more information on the platform administration and domain administration
functions, refer to the “Overview” chapter of the Sun Fire 6800/4810/4800/3800
Systems Platform Administration Manual.
Connecting to the System Controller
To connect to the system controller, refer to the “System Controller Navigation
Procedures” chapter in the Sun Fire 6800/4810/4800/3800 Systems Platform
Administration Manual.
System Controller Navigation
To navigate within the system controller, refer to the “System Controller Navigation
Procedures” chapter in the Sun Fire 6800/4810/4800/3800 Systems Platform
Administration Manual.
Terminating Sessions
To terminate system controller sessions, refer to the “System Controller Navigation
Procedures” chapter in the Sun Fire 6800/4810/4800/3800 Systems Platform
Administration Manual.

3
CHAPTER 2
System Controller Syntax,
Arguments, and Device Names
This chapter describes the following topics:
■“Command Syntax and Arguments” on page 3
■“Command Names” on page 4
■“Component Names” on page 4
■“Board States for CPU/Memory Boards and I/O Assemblies” on page 6
■“Board Test Status” on page 6
■“Domain Status” on page 7
■“Using FTP URLs” on page 8
■“Interactive Commands” on page 9
■“Context-Sensitive Commands” on page 9
■“Command Line Editing” on page 10
■“Command Line History” on page 11
■“Command Completion” on page 12
Command Syntax and Arguments
The general syntax of system controller commands is:
command_name [flags][arguments]

4Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2002
Arguments are the words that follow the command name and are divided into two
categories:
■Required arguments
■Optional arguments
Optional arguments always follow the option flags on the command line. In the
following example, the optional domainID argument, a, follows the option flag, -d.
The boardname argument, which is sb2 in this example, is a required argument and
is the board name for a CPU/Memory board.
Command Names
Most system controller commands are in the form of verbnoun. Command names are
in the English language. System controller commands names are case insensitive, but
options for commands are not. However, items such as board names can be specified
in upper case characters.
Note – When typing system controller commands, you can type the complete
command name or type just enough of the command name to uniquely identify it.
Component Names
TABLE 2-1 shows the component names that are accessible from the platform.
TABLE 2-2 shows the component names that are accessible from the domain. In both
tables, you can type the component names in either upper case or lower case.
schostname:SC> addboard -d a sb2