Sun Microsystems Fire 6800-4810-4800-3800 User Manual

Sun Fire

™

6800/4810/4800/3800

System Controller

Command Reference Manual

Sun Microsystems, Inc.
901 San Antonio Road
Palo Alto, CA 94303 U.S.A.
650-960-1300

Part No. 805-7372-13
October 2001, Revision A

Send comments about this document to: [e-mail]

Copyright 2001Sun Microsystems, Inc.,901 SanAntonio Road• PaloAlto, CA94303 USA.All rightsreserved.

This product or documentis protectedby copyrightand distributed under licenses restrictingits use,copying, distribution, and
decompilation. No part ofthis productor documentmay be reproduced inany form by any meanswithout priorwritten authorization
of Sun and itslicensors, ifany.Third-party software,including fonttechnology,is copyrightedand licensedfrom Sunsuppliers.

Parts of the product maybe derivedfrom BerkeleyBSD systems,licensed fromthe University of California. UNIX is a registered trademarkin
the U.S. and other countries, exclusively licensed through X/OpenCompany, Ltd.

Sun, Sun Microsystems,the Sunlogo, AnswerBook2,docs.sun.com, OpenBoot,Sun Fire,and Solarisare trademarks, registeredtrademarks, or
service marks of Sun Microsystems,Inc. inthe U.S.and othercountries. AllSPARCtrademarks areused under license and aretrademarks or
registeredtrademarks ofSPARCInternational, Inc. in the U.S. and other countries. Productsbearing SPARCtrademarks arebased uponan
architecturedeveloped bySun Microsystems,Inc.UNIX is a registered trademarkin theUnited Statesand othercountries, exclusivelylicensed
throughX/Open Company,Ltd.

The OPEN LOOK and Sun™ Graphical User Interface was developedbySun Microsystems,Inc. forits usersand licensees.Sun acknowledges
the pioneering effortsof Xeroxin researchingand developing the concept of visual orgraphical userinterfaces forthe computerindustry.Sun
holds a non-exclusive license fromXerox tothe XeroxGraphical 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: CommercialSoftware—Government UsersSubject toStandard License TermsandConditions.
DOCUMENTATION IS PROVIDED “AS IS”AND ALL EXPRESS OR IMPLIEDCONDITIONS, REPRESENTATIONSAND 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 SanAntonio Road• PaloAlto, CA94303 Etats-Unis.Tousdroits réservés.
Ce produit oudocument estprotégé par un copyright et distribué avec des licences quien restreignentl’utilisation, la copie, la distribution,et la

décompilation. Aucune partie de ce produit oudocument nepeut êtrereproduitesous aucuneforme, parquelque moyenque cesoit, sans
l’autorisation préalable et écrite de Sun et de ses bailleurs delicence, s’ily ena. Lelogiciel détenupar destiers, etqui comprendla technologie
relativeaux policesde caractères,est protégépar un copyright et licencié par des fournisseurs de Sun.

Des parties de ce produitpourront êtredérivées des systèmes Berkeley BSDlicenciés parl’Université deCalifornie. UNIXest unemarque
déposée aux Etats-Uniset dansd’autres pays et licenciée exclusivement par X/Open Company, Ltd.

Sun, Sun Microsystems,le logoSun, AnswerBook2,docs.sun.com, OpenBoot,Sun Fire,,et Solarisdes marquesde fabrique ou des marques
déposées, ou marquesde service,de SunMicrosystems, Inc.aux Etats-Uniset dansd’autres pays. Touteslesmarques SPARCsont utiliséessous
licence et sont des marquesde fabriqueou desmarques déposées deSPARCInternational, Inc.aux Etats-Uniset dans d’autrespays. Les
produitsportant lesmarques SPARCsont baséssur unearchitecture développée par Sun Microsystems,Inc. UNIXest unemarque enregistree
aux Etats-Unis et dans d’autrespays etlicenciée exclusivementpar X/OpenCompany Ltd.

L’interfaced’utilisation graphique OPEN LOOK et Sun™ a été développéepar SunMicrosystems, Inc.pour sesutilisateurs etlicenciés. Sun
reconnaîtles effortsde pionniersde Xeroxpour la rechercheet ledéveloppement duconcept desinterfaces d’utilisationvisuelle ougraphique
pour l’industrie de l’informatique. Sun détient une licence non exclusive deXerox surl’interface d’utilisationgraphique Xerox,cette licence
couvrant également leslicenciés deSun quimettent enplace l’interfaced’utilisation graphiqueOPEN LOOKet quien outrese conformentaux
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.

Please

Recycle

Contents

Preface xiii

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
Interactive Commands 8
Command Line Editing 9
Command Line History 10
Command Completion 11

iii

3. System Controller Alphabetical Command Reference 13

Command Summary 13
Alphabetical Listing of System Controller Commands 16

addboard 16
break 19
connections 21
console 23
deleteboard 25
disablecomponent 27
disconnect 31
dumpconfig 33
enablecomponent 35
flashupdate 38
help 43
history 46
password 47
poweroff 49
poweron 52
reboot 55
reset 57
restoreconfig 59
resume 62
setdate 64
setdefaults 69
setkeyswitch 71
setupdomain 76
setupplatform 81

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

showboards 86
showcomponent 90
showdate 93
showdomain 95
showenvironment 99
showkeyswitch 104
showlogs 106
showplatform 108
showresetstate 113
showsc 115
testboard 116

Glossary 119

Index 121

Contents v

vi Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001

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 9
TABLE 2-7 Keystrokes that Recall Previously Typed Command Lines 10
TABLE 2-8 Keystrokes Used to Complete System Controller Commands 11
TABLE 3-1 System Controller Command Summary 13
TABLE 3-2 Header Description for the connections Command 22

TABLE 3-3

component_name

Descriptions for the CPU/Memory Board Used in the

disablecomponent Command 28

TABLE 3-4

component_name

Descriptions for the I/O Assembly Used in the disablecomponent

Command 28

TABLE 3-5

component_name

Descriptions for the CPU/Memory Board Used in the enablecomponent

Command 35

TABLE 3-6

component_name

Descriptions for the I/O Assembly Used in the enablecomponent

Command 36

TABLE 3-7 Time Zone Abbreviations, Time Zone Name, and Offsets From Greenwich Mean Time 65
TABLE 3-8 Description of the setkeyswitch Transition 72

vii

TABLE 3-9 Results of Changing the Keyswitch From the Current Setting to a New Setting 72
TABLE 3-10 Parameter Values for the setupdomain Command 76
TABLE 3-11 setupplatform Parameter Values 82
TABLE 3-12 Output Header Definitions for the showboards and the showboards -v Command 88
TABLE 3-13 Parts for showenvironment -p
TABLE 3-14 showenvironment Output Header Description 100

part

100

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

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 break Command Example 20
CODE EXAMPLE 3-4 connections Command for the Platform Shell 22
CODE EXAMPLE 3-5 console Example and No Password Set Accessing Domain B 24
CODE EXAMPLE 3-6 console Example and A Password Set Accessing Domain A 24
CODE EXAMPLE 3-7 deleteboard Example Showing Deleting I/O Assembly 7 26
CODE EXAMPLE 3-8 deleteboard Example Showing Deleting CPU/Memory Board 3 26
CODE EXAMPLE 3-9 disablecomponent Command Example Adding sb4 to the Blacklists 30
CODE EXAMPLE 3-10 disablecomponent Command Example Adding sb0 CPU Port 3 to the Blacklist 30
CODE EXAMPLE 3-11 disablecomponent Command Example Adding sb2, CPU Port 3, and Physical Bank 0

to the Blacklists 30

CODE EXAMPLE 3-12 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 30

CODE EXAMPLE 3-13 Disconnecting a Session From the System Controller Platform Shell 32
CODE EXAMPLE 3-14 Disconnecting a Session From the System Controller Platform Console 32
CODE EXAMPLE 3-15 disconnect Example Showing Disconnecting a Session From the Domain A Shell 32
CODE EXAMPLE 3-16 dumpconfig Example 34
CODE EXAMPLE 3-17 enablecomponent Command Example Enabling CPU/Memory Board 4 37
CODE EXAMPLE 3-18 enablecomponent Command Example Enabling I/O Assembly 6 and Port 1 37
CODE EXAMPLE 3-19 flashupdate Example Updating the Active System Controller Board and the System

Controller Real Time Operating System 42

ix

CODE EXAMPLE 3-20 flashupdate Example Updating Replacement CPU/Memory Board sb4 42
CODE EXAMPLE 3-21 help Command Example Displaying Information on the addboard Command 44
CODE EXAMPLE 3-22 help Command Example Displaying Commands Beginning With the Word show 44
CODE EXAMPLE 3-23 help Command Example Displaying Commands Beginning With the Letter A 45
CODE EXAMPLE 3-24 history Command 46
CODE EXAMPLE 3-25 password Command Example With a Password Already Set 48
CODE EXAMPLE 3-26 password Command Example With No Password Set 48
CODE EXAMPLE 3-27 poweroff Command Example Showing Powering Off sb2 51
CODE EXAMPLE 3-28 poweroff Command Example Showing Powering Off All Power Supplies, Fan Trays, and

System Boards in the Platform Shell 51

CODE EXAMPLE 3-29 poweron Example Powering On sb2 53
CODE EXAMPLE 3-30 poweron Example Showing Powering On All CPU/Memory Boards and I/O Assemblies in

Domain A 54

CODE EXAMPLE 3-31 reboot Command Example 56
CODE EXAMPLE 3-32 reset Command Example From Domain A 58
CODE EXAMPLE 3-33 reset -a Command Example From Domain A 58
CODE EXAMPLE 3-34 restoreconfig Example 60
CODE EXAMPLE 3-35 resume Command Example in Active Domain A 63
CODE EXAMPLE 3-36 setdate Command Example in the Platform Shell 67
CODE EXAMPLE 3-37 setdate -r Command Example Setting the Date From a Date Host 67
CODE EXAMPLE 3-38 setdate -t Command Example Setting the Time Zone to Pacific Standard Time Using

the Offset From Greenwich Mean Time 67

CODE EXAMPLE 3-39 setdate -t Command Example Setting the Date and Time Zone to Eastern Standard

Time Using Time Zone Abbreviations 67

CODE EXAMPLE 3-40 setdate -t Command Example Setting the Time Zone to Japan Standard Time Using

the Offset From Greenwich Mean Time 68

CODE EXAMPLE 3-41 setdate -t Command Example Setting the Time Zone to Eastern Central Time Using

Time Zone Abbreviations 68

CODE EXAMPLE 3-42 setdefaults Example 70
CODE EXAMPLE 3-43 setkeyswitch on Example 74
CODE EXAMPLE 3-44 setkeyswitch off Example 75
CODE EXAMPLE 3-45 setkeyswitch off Example Shutting Down Domain B From the Platform Shell 75

x Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001

CODE EXAMPLE 3-46 Variables for the setupdomain Command 80
CODE EXAMPLE 3-47 setupplatform Output 84
CODE EXAMPLE 3-48 showboards Command for the Platform Shell 87
CODE EXAMPLE 3-49 showboards -a Command for the Domain Shell 89
CODE EXAMPLE 3-50 showcomponent sb4 Sample Output 91
CODE EXAMPLE 3-51 showcomponent ib6 Sample Output 92
CODE EXAMPLE 3-52 showdate Command for the Platform Shell 94
CODE EXAMPLE 3-53 showdomain Command Example 96
CODE EXAMPLE 3-54 showdomain -v Command Example 97
CODE EXAMPLE 3-55 showdomain -p bootparams Example Displaying Boot Parameter Information 98
CODE EXAMPLE 3-56 showenvironment Platform Shell and Domain Shell Example 102
CODE EXAMPLE 3-57 showkeyswitch Example Showing the Keyswitch Set to On 105
CODE EXAMPLE 3-58 showkeyswitch Example Showing the Keyswitch Set to Off 105
CODE EXAMPLE 3-59 showkeyswitch Example Showing the Keyswitch Set to Standby 105
CODE EXAMPLE 3-60 Sample Output of the showlogs Command Run After Rebooting the System 107
CODE EXAMPLE 3-61 showplatform Output for a Sun Fire 6800 System 109
CODE EXAMPLE 3-62 showplatform -v Output for a Sun Fire 6800 System 110
CODE EXAMPLE 3-63 showsc Command 115
CODE EXAMPLE 3-64 testboard Example Testing CPU/Memory Board sb0 117

Code Samples xi

xii Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001

Preface

This book describes the Sun Fire 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
knowledge, you should first read the Solaris User and System Administrator
AnswerBooks and consider UNIX
documentation URLs, see “Accessing Sun Documentation Online” on page xv.

™

operating environment. If you do not have such

®

system administration training. For the

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.

xiii

Chapter 3 provides in tabular form a summary of all of the system controller
commands and describes each command.

Typographic Conventions

Typeface Meaning Examples

AaBbCc123 The names of commands, files,

and directories; on-screen
computer output

AaBbCc123

AaBbCc123 Book titles, new words or terms,

What you type, when
contrasted with on-screen
computer output

words to be emphasized

Edit your .login file.
Use ls -a to list all files.

% su
Password:

Read Chapter 6 in the User’s Guide.
These are called class options.
You must be superuser to do this.

Command-line variable, such as
board_name.

To delete a file, type rm filename.

Shell Prompts

Shell Prompt

C shell machine_name%
C shell superuser machine_name#
Bourne shell and Korn shell $
Bourne shell and Korn shell superuser #
Platform shell
Domain shell schostname:A> or B>, C>, D>

schostname:SC>

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

Related Documentation

Application Title Part Number

Service Sun Fire 6800/4810/4800/3800 Systems

Service Manual

Service

System Administration Sun Fire 6800/4810/4800/3800 Systems

Sun Fire 4810/4800/3800 System Cabinet
Mounting Guide

Platform Administration Manual

805-7363

806-6781

805-7373

Accessing Sun Documentation Online

A broad selection of Sun system documentation is located at:

http://www.sun.com/products-n-solutions/hardware/docs

A complete set of Solaris documentation and many other titles are located 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

Preface xv

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:

[e-mail]

Please include the part number (805-7372-13) of your document in the subject line of
your email.

xvi Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001

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.

1

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.

2 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001

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

■ “Interactive Commands” on page 8

■ “Command Line Editing” on page 9

■ “Command Line History” on page 10

■ “Command Completion” on page 11

Command Syntax and Arguments

The general syntax of system controller commands is:

command_name [flags][arguments]

3

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.

schostname:SC> addboard -d a sb2

Command Names

Most system controller commands are in the form of verbnoun. Command names are
in the English language. System controller commands are case insensitive.

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.

4 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001

Note – The components in TABLE 2-1 and TABLE 2-2 depend on the system you have.

For example, only the Sun Fire 6800 system can have six power supplies and six
CPU/Memory boards.

TABLE2-1 Components That Are Accessible From the Platform

Device Description Device Name

Power grids* GRID0, GRID1
Power supplies PS0, PS1, PS2, PS3, PS4, PS5
CPU/Memory boards SB0, SB1, SB2, SB3, SB4, SB5
I/O assemblies IB6, IB7, IB8, IB9
Repeater boards RP0, RP1, RP2, RP3
ID/Source board ID0
Fan trays FT0, FT1, FT2, FT3
System controller SSC0, SSC1

* Power grids are not a component but a division of the Sun Fire 6800 system into two distinct halves
of the system. Power supplies ps0, ps1, and ps2 comprise power grid 0. Power supplies ps3, ps4, and
ps5 comprise power grid 1.

TABLE 2-2 shows the components that are accessible from a domain.

TABLE2-2 Components That Are Accessible From a Domain

Device Description Device Name

CPU/Memory boards SB0, SB1, SB2, SB3, SB4, SB5
I/O Assemblies IB6, IB7, IB8, IB9

Chapter 2 System Controller Syntax, Arguments, and Device Names 5

Board States for CPU/Memory Boards and I/O Assemblies

TABLE 2-3 lists the board states for the CPU/Memory boards and I/O assemblies. To

determine the board state, use the showboards command and look under the
State header.

TABLE2-3 Board States

Board States Description

Available The board is not assigned to any domain.
Assigned The board belongs to a domain, but the hardware has not been

configured or it is not in use.

Active The board is being actively used by the domain to which it has been

assigned. You cannot reassign an active board.

The System Controller board, ID board, power supplies, and Repeater boards do not
have a State. A dash is displayed In the Board Status field for these boards and
components (see

TABLE 2-4). Fan trays have a state of off, low speed, and high speed.

Board Test Status

TABLE 2-4 describes the Status field of the showboards command.

TABLE2-4 Status Field of the showboards Command

Test Status Description

Passed All board components passed testing.
Failed The board failed testing and is not usable. This could also indicate

corrupt or incompatible firmware.
OK The component is functioning properly.
Under Test The domain is running POST (power-on self-test); testing has been

initiated using the setkeyswitch command, the testboard

command, or an SNMP operation.

6 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001

TABLE2-4 Status Field of the showboards Command (Continued)

Test Status Description

Not Tested The board has not been tested.
Degraded Certain components on the board have failed or are disabled. A

board is degraded when there are still usable parts on the board.

- The slot is empty or not applicable for this device.

Domain Status

In the showplatform and showdomain commands, one of the fields in the
command output is domain status. The main values of domain status are (

TABLE 2-5):

TABLE2-5 Values for the Domain Status Column in showplatform and showdomain

Command Output

Domain State Description

Powered Off The domain is not active and the keyswitch is in the off position.
Standby The domain is not active and the keyswitch is in the standby

position.
Running POST The domain is active and is running POST (power-on self-test).
Active The domain is active.
Active - OpenBoot

PROM
Active - Booting The domain is active and is booting the Solaris operating

Active - Solaris The domain is active and is running the Solaris operating

Active - Halted The Solaris operating environment is halted in the domain.
Active - Reset The domain has had an XIR reset and had not be rebooted.
Active - Panicking The domain is active and is panicking. It is creating the core file.
Active - Debugger The domain is active and the debugger is presently running.
Not Responding The domain is not responding.
Paused due to an error The domain is paused due to a hardware error.

The domain is active and is running the OpenBoot PROM.

environment.

environment.

Chapter 2 System Controller Syntax, Arguments, and Device Names 7

Special Characters

To execute multiple commands on the same line, separate them with a semicolon (;).
The following example executes both the addboard and deleteboard commands.

schostname:A> addboard sb2;deleteboard sb3

A pound sign ( # ) signifies the start of a comment on the current line. The following
example executes the addboard command. Everything you type after the # and
before pressing the Return key is ignored.

schostname:A> addboard sb2 #this text is ignored

Interactive Commands

Some commands may prompt for confirmation before executing the command. You
can disable prompting by specifying the -y or -n flags, which answer yes or no to
any prompted question.

Some commands, such as setupplatform and setupdomain, are always
interactive.

● When an interactive command prompts for input, do the following:

■ Press the Return key to keep the current setting, displayed in braces [ ].

■ Type a dash ( - ) to change the current setting to an empty string (if the input

type is used to define a string).

8 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001

Command Line Editing

The system controller has a basic command line editor that allows you to edit the
command line. The keys you press are not echoed on the screen.

TABLE 2-6 lists the keystrokes used to perform basic command line editing.

■ To use the Control key sequences, hold down the Control key while typing the

following character (

■ To use Escape key sequences, press and release the Escape key. Then press and

release the following character (

TABLE2-6 Command Line Editing Capabilities

Keystroke Description

Backspace
(Control-h)

Delete Erases the character before the cursor.
Control-U Erases the entire line.
Control-C Cancels editing the command line. The command is not executed.
Return Finishes editing the line.
Control-b Moves backward one character.
Esc-b Moves backward one word.
Control-f Moves forward one character.
Esc-f Moves forward one word.
Control-a Moves backward to the beginning of the line.
Control-e Moves forward to the end of the line.
Esc-h Erases from the beginning of the word to just before the cursor.

Control-w Erases from the beginning of the word to just before the cursor.

Control-d Erases next character.
Esc-d Erases from the cursor to the end of the word. Stores erased

Control-k Erases from the cursor to the end of the line. Stores erased characters

Control-u Erases the entire line. Stores erased characters in a save buffer.

TABLE 2-6).

TABLE 2-6).

Erases the character before the cursor.

Stores erased characters in a save buffer.

Stores erased characters in a save buffer.

characters in a save buffer.

in a save buffer.

Chapter 2 System Controller Syntax, Arguments, and Device Names 9

TABLE2-6 Command Line Editing Capabilities (Continued)

Keystroke Description

Control-r Retypes the line.
Control-q Quotes the next character. Allows you to insert Control characters.
Control-y Inserts the contents of the save buffer before the cursor.

Command Line History

Each shell keeps a short history of all entered commands. To display the command
line history, use the history command. After recalling the commands, you can
either edit them or execute them by pressing the Return key. A history of at least
eight previously typed command lines are saved.

TABLE 2-7 lists keystrokes you type to recall previously typed commands.

TABLE2-7 Keystrokes that Recall Previously Typed Command Lines

Keystroke Description

Control-p Selects and displays the previous line for subsequent editing.
Control-n Selects and displays the next line for subsequent editing.
Control-l Displays the entire command history list.

10 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001

Command Completion

Using the command completion function makes it easier for you to enter long
commands. After typing part of the command, use the completion keystroke
(

TABLE 2-8). This action searches the list of available commands for commands

beginning with the characters you typed thus far.

■ If there is only one possible command, the remainder of the characters are entered

for you automatically.

■ If there are several possibilities, any characters that are common to all of the

possible selections are filled in.

■ If there are no defined commands starting with the given characters, the

characters are erased until there is a minimum of one selection for the remaining
characters.

TABLE 2-8 lists the keystrokes to complete a command.

TABLE2-8 Keystrokes Used to Complete System Controller Commands

Key Sequence Description

Control-space Complete this command.
Control-? Shows all possible matches.
Control-/ Shows all possible matches.

Chapter 2 System Controller Syntax, Arguments, and Device Names 11

12 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001

CHAPTER

3

System Controller Alphabetical Command Reference

This chapter lists a summary of the system controller commands designed for an
end-user on the Sun Fire 6800/4810/4800/3800 systems, describes the system
controller command line interface, and provides descriptions and examples for each
command.

Command Summary

TABLE 3-1 lists and describes the system controller commands and how you can

access them. Many commands are accessible from both the platform shell and the
domain shell. The system controller commands may differ in how they are used, the
effect of the command, and the scope of the command between the platform and
domain shells.

TABLE3-1 System Controller Command Summary

Command Description Platform Shell Domain Shell

addboard Assigns a board to a domain. x x
break Sends a Break signal to the domain console. x
connections Displays connections to the system controller to

a domain.

console Connects to a domain from the platform. x
deleteboard Unassigns a board from a domain. x x
disablecomponent Adds a component to the blacklist. x x
disconnect Disconnects the current or specified connection. x x

xx

13

TABLE3-1 System Controller Command Summary (Continued)

Command Description Platform Shell Domain Shell

dumpconfig Saves the system controller configuration to a

x

server.

enablecomponent Deletes a component from the blacklist. x x
flashupdate Updates the firmware. x
help Provides basic help information for commands. x x
history Shows the command history with date and time

xx

stamps.

password Sets the shell password. x x
poweroff Powers off components. x x
poweron Powers on components. x x
reboot Reboots the system controller. x
reset Resets the domain in the domain shell. x x
restoreconfig Restores the system controller configuration

x

from a server.

resume Exits the domain shell and resumes access to the

x

domain console.

setdate Sets the date and time. x x
setdefaults Sets the configuration to default values. x x
setkeyswitch Sets the keyswitch position. x x
setupdomain Configures the domain. x
setupplatform Configures the platform. x
showboards Shows board information. x x
showcomponent Shows state of a component. x x
showdate Shows the date and time. x x
showdomain Displays the configuration and status of the

x

domain.

showenvironment Shows environmental information. x x
showkeyswitch Displays the virtual keyswitch setting. x x
showlogs Displays the logs. x x
showplatform Displays the configuration and information for

x

the platform and status of the domains.

14 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001