Sun Microsystems Welding System 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: [email protected]  
 
Preface xiii  
1. Introduction to the System Controller  
Platform and Domain Administration  
1
1
2. System Controller Syntax, Arguments, and Device Names  
Command Syntax and Arguments  
3
3
Command Names  
Component Names  
4
4
Board States for CPU/ Memory Boards and I/ O Assemblies  
Board Test Status  
Domain Status  
6
6
7
Interactive Commands  
Command Line Editing  
8
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  
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-2  
TABLE 2-3  
TABLE 2-4  
TABLE 2-5  
Components That Are Accessible From the Platform  
5
Components That Are Accessible From a Domain  
Board States  
Status Field of the showboardsCommand  
Values for the Domain Status Column in showplatformand showdomain Command  
5
6
6
Output  
7
TABLE 2-8  
TABLE 3-1  
TABLE 3-2  
TABLE 3-3  
Command Line Editing Capabilities  
9
Keystrokes that Recall Previously Typed Command Lines 10  
Keystrokes Used to Complete System Controller Commands 11  
System Controller Command Summary 13  
Header Description for the connections Command 22  
component_name Descriptions for the CPU/Memory Board Used in the  
disablecomponentCommand 28  
TABLE 3-4  
TABLE 3-5  
TABLE 3-6  
component_name Descriptions for the I/O Assembly Used in the disablecomponent  
Command 28  
component_name Descriptions for the CPU/Memory Board Used in the enablecomponent  
Command 35  
component_name Descriptions for the I/O Assembly Used in the enablecomponent  
Command 36  
TABLE 3-7  
TABLE 3-8  
Time Zone Abbreviations, Time Zone Name, and Offsets From Greenwich Mean Time 65  
Description of the setkeyswitchTransition 72  
vii  
 
TABLE 3-11  
TABLE 3-12  
TABLE 3-13  
TABLE 3-14  
Results of Changing the Keyswitch From the Current Setting to a New Setting  
Parameter Values for the setupdomainCommand 76  
setupplatformParameter Values 82  
72  
Output Header Definitions for the showboardsand the showboards -vCommand 88  
Parts for showenvironment -ppart 100  
showenvironmentOutput Header Description 100  
viii  
Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001  
 
Code Samples  
CODE EXAMPLE 3-1 addboardExample in the Platform Shell 18  
CODE EXAMPLE 3-2 addboardExample in the Domain Shell 18  
CODE EXAMPLE 3-3 breakCommand Example 20  
CODE EXAMPLE 3-4 connectionsCommand for the Platform Shell 22  
CODE EXAMPLE 3-5 consoleExample and No Password Set Accessing Domain B 24  
CODE EXAMPLE 3-6 consoleExample 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 disablecomponentCommand Example Adding sb4to the Blacklists 30  
CODE EXAMPLE 3-10 disablecomponentCommand Example Adding sb0CPU Port 3 to the Blacklist 30  
CODE EXAMPLE 3-11 disablecomponentCommand Example Adding sb2,CPU Port 3, and Physical Bank 0  
to the Blacklists 30  
CODE EXAMPLE 3-12 disablecomponentCommand 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 disconnectExample Showing Disconnecting a Session From the Domain A Shell 32  
CODE EXAMPLE 3-16 dumpconfigExample 34  
CODE EXAMPLE 3-17 enablecomponentCommand Example Enabling CPU/Memory Board 4 37  
CODE EXAMPLE 3-18 enablecomponentCommand Example Enabling I/O Assembly 6 and Port 1 37  
CODE EXAMPLE 3-19 flashupdateExample Updating the Active System Controller Board and the System  
Controller Real Time Operating System 42  
ix  
 
CODE EXAMPLE 3-20 flashupdateExample Updating Replacement CPU/Memory Board sb4 42  
CODE EXAMPLE 3-21 helpCommand Example Displaying Information on the addboardCommand 44  
CODE EXAMPLE 3-22 helpCommand Example Displaying Commands Beginning With the Word show 44  
CODE EXAMPLE 3-23 helpCommand Example Displaying Commands Beginning With the Letter A 45  
CODE EXAMPLE 3-24 historyCommand 46  
CODE EXAMPLE 3-25 passwordCommand Example With a Password Already Set 48  
CODE EXAMPLE 3-26 passwordCommand Example With No Password Set 48  
CODE EXAMPLE 3-27 poweroffCommand Example Showing Powering Off sb2 51  
CODE EXAMPLE 3-28 poweroffCommand Example Showing Powering Off All Power Supplies, Fan Trays, and  
System Boards in the Platform Shell 51  
CODE EXAMPLE 3-29 poweronExample Powering On sb2 53  
CODE EXAMPLE 3-30 poweronExample Showing Powering On All CPU/Memory Boards and I/O Assemblies in  
Domain A 54  
CODE EXAMPLE 3-31 rebootCommand Example 56  
CODE EXAMPLE 3-32 resetCommand Example From Domain A 58  
CODE EXAMPLE 3-33 reset-a Command Example From Domain A 58  
CODE EXAMPLE 3-34 restoreconfigExample 60  
CODE EXAMPLE 3-35 resumeCommand Example in Active Domain A 63  
CODE EXAMPLE 3-36 setdateCommand Example in the Platform Shell 67  
CODE EXAMPLE 3-37 setdate -rCommand Example Setting the Date From a Date Host 67  
CODE EXAMPLE 3-38 setdate -tCommand Example Setting the Time Zone to Pacific Standard Time Using  
the Offset From Greenwich Mean Time 67  
CODE EXAMPLE 3-39 setdate -tCommand Example Setting the Date and Time Zone to Eastern Standard  
Time Using Time Zone Abbreviations 67  
CODE EXAMPLE 3-40 setdate -tCommand Example Setting the Time Zone to Japan Standard Time Using  
the Offset From Greenwich Mean Time 68  
CODE EXAMPLE 3-41 setdate -tCommand Example Setting the Time Zone to Eastern Central Time Using  
Time Zone Abbreviations 68  
CODE EXAMPLE 3-42 setdefaultsExample 70  
CODE EXAMPLE 3-43 setkeyswitch onExample 74  
CODE EXAMPLE 3-44 setkeyswitch offExample 75  
CODE EXAMPLE 3-45 setkeyswitch offExample 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 setupdomainCommand 80  
CODE EXAMPLE 3-47 setupplatformOutput 84  
CODE EXAMPLE 3-48 showboardsCommand for the Platform Shell 87  
CODE EXAMPLE 3-49 showboards -aCommand 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 showdateCommand 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 bootparamsExample Displaying Boot Parameter Information 98  
CODE EXAMPLE 3-56 showenvironmentPlatform Shell and Domain Shell Example 102  
CODE EXAMPLE 3-57 showkeyswitchExample Showing the Keyswitch Set to On 105  
CODE EXAMPLE 3-58 showkeyswitchExample Showing the Keyswitch Set to Off 105  
CODE EXAMPLE 3-59 showkeyswitchExample Showing the Keyswitch Set to Standby 105  
CODE EXAMPLE 3-60 Sample Output of the showlogsCommand 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 showscCommand 115  
CODE EXAMPLE 3-64 testboardExample 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 Solarisoperating 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. For the  
documentation URLs, see “Accessing Sun Documentation Online” on page xv.  
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  
Edit your .loginfile.  
Use ls -ato list all files.  
What you type, when  
contrasted with on-screen  
computer output  
% su  
Password:  
AaBbCc123  
AaBbCc123  
Book titles, new words or terms, Read Chapter 6 in the Users Guide.  
words to be emphasized  
These are called class options.  
You must be superuser to do this.  
Command-line variable, such as To delete a file, type rmfilename.  
board_name.  
Shell Prompts  
Shell  
Prompt  
C shell  
machine_name%  
C shell superuser  
Bourne shell and Korn shell  
Bourne shell and Korn shell superuser  
Platform shell  
machine_name#  
$
#
schostname:SC>  
Domain shell  
schostname:A> or B>, C>, D>  
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  
805-7363  
Service  
806-6781  
805-7373  
Sun Fire 4810/4800/3800 System Cabinet  
Mounting Guide  
System Administration  
Sun Fire 6800/4810/4800/3800 Systems  
Platform Administration Manual  
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.comat:  
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:  
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,  
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 sb2in 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.  
TABLE 2-1  
Components That Are Accessible From the Platform  
Device Description  
Power grids*  
Device Name  
GRID0, GRID1  
Power supplies  
CPU/ Memory boards  
I/ O assemblies  
Repeater boards  
ID/ Source board  
Fan trays  
PS0, PS1, PS2, PS3, PS4, PS5  
SB0, SB1, SB2, SB3, SB4, SB5  
IB6, IB7, IB8, IB9  
RP0, RP1, RP2, RP3  
ID0  
FT0, FT1, FT2, FT3  
SSC0, SSC1  
System controller  
* 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.  
TABLE 2-2  
Components That Are Accessible From a Domain  
Device Description  
CPU/ Memory boards  
I/ O Assemblies  
Device Name  
SB0, SB1, SB2, SB3, SB4, SB5  
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 showboardscommand and look under the  
Stateheader.  
TABLE 2-3  
Board States  
Board States  
Available  
Assigned  
Description  
The board is not assigned to any domain.  
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 showboardscommand.  
TABLE 2-4  
Status Field of the showboardsCommand  
Test Status  
Passed  
Description  
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 setkeyswitchcommand, the testboard  
command, or an SNMP operation.  
6
Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001  
 
                   
TABLE 2-4  
Status Field of the showboardsCommand (Continued)  
Test Status  
Not Tested  
Degraded  
Description  
The board has not been tested.  
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 showplatformand showdomaincommands, one of the fields in the  
command output is domain status. The main values of domain status are (TABLE 2-5):  
TABLE 2-5  
Values for the Domain Status Column in showplatformand showdomain  
Command Output  
Domain State  
Powered Off  
Standby  
Description  
The domain is not active and the keyswitch is in the off position.  
The domain is not active and the keyswitch is in the standby  
position.  
Running POST  
Active  
The domain is active and is running POST (power-on self-test).  
The domain is active.  
Active - OpenBoot  
PROM  
The domain is active and is running the OpenBoot PROM.  
Active - Booting  
The domain is active and is booting the Solaris operating  
environment.  
Active - Solaris  
The domain is active and is running the Solaris operating  
environment.  
Active - Halted  
Active - Reset  
The Solaris operating environment is halted in the domain.  
The domain has had an XIR reset and had not be rebooted.  
The domain is active and is panicking. It is creating the core file.  
The domain is active and the debugger is presently running.  
The domain is not responding.  
Active - Panicking  
Active - Debugger  
Not Responding  
Paused due to an error The domain is paused due to a hardware error.  
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 addboardand deleteboardcommands.  
schostname:A> addboard sb2;deleteboard sb3  
A pound sign ( # ) signifies the start of a comment on the current line. The following  
example executes the addboardcommand. 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 -yor -nflags, which answer yes or no to  
any prompted question.  
Some commands, such as setupplatformand 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 (TABLE 2-6).  
To use Escape key sequences, press and release the Escape key. Then press and  
release the following character (TABLE 2-6).  
TABLE 2-6  
Keystroke  
Command Line Editing Capabilities  
Description  
Backspace  
(Control-h)  
Erases the character before the cursor.  
Delete  
Erases the character before the cursor.  
Erases the entire line.  
Control-U  
Control-C  
Return  
Cancels editing the command line. The command is not executed.  
Finishes editing the line.  
Control-b  
Esc-b  
Moves backward one character.  
Moves backward one word.  
Control-f  
Esc-f  
Moves forward one character.  
Moves forward one word.  
Control-a  
Control-e  
Esc-h  
Moves backward to the beginning of the line.  
Moves forward to the end of the line.  
Erases from the beginning of the word to just before the cursor.  
Stores erased characters in a save buffer.  
Control-w  
Erases from the beginning of the word to just before the cursor.  
Stores erased characters in a save buffer.  
Control-d  
Esc-d  
Erases next character.  
Erases from the cursor to the end of the word. Stores erased  
characters in a save buffer.  
Control-k  
Control-u  
Erases from the cursor to the end of the line. Stores erased characters  
in a save buffer.  
Erases the entire line. Stores erased characters in a save buffer.  
Chapter 2 System Controller Syntax, Arguments, and Device Names  
9
 
     
TABLE 2-6  
Command Line Editing Capabilities (Continued)  
Keystroke  
Control-r  
Control-q  
Control-y  
Description  
Retypes the line.  
Quotes the next character. Allows you to insert Control characters.  
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 historycommand. 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.  
TABLE 2-7  
Keystrokes that Recall Previously Typed Command Lines  
Keystroke  
Control-p  
Control-n  
Control-l  
Description  
Selects and displays the previous line for subsequent editing.  
Selects and displays the next line for subsequent editing.  
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.  
TABLE 2-8  
Keystrokes Used to Complete System Controller Commands  
Key Sequence  
Description  
Control-space  
Control-?  
Complete this command.  
Shows all possible matches.  
Shows all possible matches.  
Control-/  
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.  
TABLE 3-1  
System Controller Command Summary  
Command  
Description  
Platform Shell  
Domain Shell  
addboard  
break  
Assigns a board to a domain.  
x
x
x
x
Sends a Break signal to the domain console.  
connections  
Displays connections to the system controller to  
a domain.  
x
console  
Connects to a domain from the platform.  
Unassigns a board from a domain.  
x
x
x
x
deleteboard  
x
x
x
disablecomponent Adds a component to the blacklist.  
disconnect Disconnects the current or specified connection.  
13  
 
           
TABLE 3-1  
System Controller Command Summary (Continued)  
Command  
Description  
Platform Shell  
Domain Shell  
dumpconfig  
Saves the system controller configuration to a  
x
server.  
enablecomponent  
flashupdate  
help  
Deletes a component from the blacklist.  
Updates the firmware.  
x
x
x
x
x
Provides basic help information for commands.  
x
x
history  
Shows the command history with date and time  
stamps.  
password  
poweron  
Sets the shell password.  
x
x
x
x
x
x
x
x
x
Powers off components.  
Powers on components.  
reboot  
Reboots the system controller.  
Resets the domain in the domain shell.  
reset  
x
x
Restores the system controller configuration  
from a server.  
resume  
Exits the domain shell and resumes access to the  
domain console.  
setdate  
Sets the date and time.  
x
x
x
x
x
x
x
setdefaults  
setupdomain  
showboards  
showcomponent  
showdate  
Sets the configuration to default values.  
Sets the keyswitch position.  
Configures the domain.  
Configures the platform.  
x
x
x
x
Shows board information.  
Shows state of a component.  
Shows the date and time.  
x
x
x
x
showdomain  
Displays the configuration and status of the  
showenvironment  
showkeyswitch  
showlogs  
Shows environmental information.  
Displays the virtual keyswitch setting.  
Displays the logs.  
x
x
x
x
x
x
x
showplatform  
Displays the configuration and information for  
the platform and status of the domains.  
14  
Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001  
 
TABLE 3-1  
System Controller Command Summary (Continued)  
Command  
Description  
Platform Shell  
Domain Shell  
showresetstate  
showsc  
Shows CPUs after a reset or a RED MODE trap.  
x
Shows the system controller version and uptime.  
Tests the CPU/ Memory board.  
x
x
testboard  
x
Chapter 3 System Controller Alphabetical Command Reference  
 
15  
Alphabetical Listing of System  
Controller Commands  
The following sections describe the system controller commands.  
addboard  
Assigns a board to a domain.  
Scope  
platform shell, domain shell  
Syntax for the Platform Shell  
addboard -d domainID system_board_name [system_board_name . . .]  
addboard -h  
Syntax for the Domain Shell  
addboard system_board_name [system_board_name . . .]  
addboard -h  
Options/ Parameters  
-dspecifies a domainID as an option (platform shell only).  
domainID is a, b, c, or d.  
-hdisplays help for this command.  
system_board_name is the board to be added. Possible values for system_board_name  
are sb0sb5(CPU/ Memory board) or ib6- ib9(I/ O assembly).  
16  
Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001  
 
   
Description  
Assigns system_board_name to the specified domain within the platform shell or to  
the current domain. The board state must be Available. To display the board state, use  
the showboardscommand. For more information on board states, see “Board States  
for CPU/ Memory Boards and I/ O Assemblies” on page 6.  
To assign a board to a domain using a domain shell, the board name must be listed  
in the Access Control List (ACL) for the current domain. When a board is listed in  
the ACL, the system controller software is allowed to process addboardrequests on  
that board. The platform shell does not use the ACL and can always add boards to a  
domain. The platform shell can also delete boards from a domain and either ignores  
the ACL or overrides the ACL. You configure the ACLs and also restrict the domains  
a board has access to using the setupplatformcommand.  
If a board is assigned to an active domain, the board will not be used. To unassign a  
board from a domain, you must halt the Solaris operating environment in the  
domain. For an overview of steps to perform, see the section “Assigning and  
Unassigning Boards” in the “Maintenance” chapter of the Sun Fire  
6800/4810/4800/3800 Systems Platform Administration Manual.  
domain.  
See Also  
deleteboard, setkeyswitch, showboards, showdomain, showplatform,  
“Assigning and Unassigning Boards” in the “Maintenance” chapter of the Sun Fire  
6800/4810/4800/3800 Systems Platform Administration Manual (for a step-by-step  
procedure on assigning boards to a domain)  
Chapter 3 System Controller Alphabetical Command Reference  
 
17  
   
Example—Platform Shell  
From the platform shell to add board name sb2to domain A (CODE EXAMPLE 3-1),  
type:  
CODE EXAMPLE 3-1 addboardExample in the Platform Shell  
schostname:SC> addboard -d a sb2  
Example—Domain Shell  
To assign board name sb2to the current domain (CODE EXAMPLE 3-2), type:  
CODE EXAMPLE 3-2 addboardExample in the Domain Shell  
schostname:A> addboard sb2  
18  
Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001  
 
   
break  
Sends a Break signal to the domain console.  
Scope  
domain shell  
Syntax  
break [-y|-n]  
break -h  
Options/ Parameters  
-hdisplays help for this command.  
-yanswers yes to the warning message. Does not prompt for confirmation.  
-nanswers no to the warning message. Does not execute this command if  
confirmation is requested.  
Description  
Sends a Break signal to the domain console. Resumes the domain console.  
Note – This command pauses the Solaris operating environment.  
When the Solaris operating environment is running in the domain, the usual effect of  
the breaksignal is to force entry into OpenBoot PROM or the debugger. The Solaris  
to secure.  
See Also  
resume, setkeyswitch, showkeyswitch  
Chapter 3 System Controller Alphabetical Command Reference  
 
19  
   
Example  
CODE EXAMPLE 3-3 shows using the breakcommand to pause the Solaris operating  
environment and enter the OpenBoot PROM.  
CODE EXAMPLE 3-3 breakCommand Example  
schostname:A> break  
This will suspend Solaris in domain A.  
Do you want to continue? [no] yes  
Type ‘go’ to resume.  
debugger entered.  
{1} ok  
20  
Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001  
 
 
connections  
Displays connections to the system controller or a domain.  
Scope  
platform shell, domain shell  
Syntax for the Platform Shell  
connections [-d domainID]  
connections -h  
Syntax for the Domain Shell  
connections [-h]  
Options/ Parameters  
-h displays help for this command.  
-ddomainID shows connections to the specified domain (a, b, c, or d).  
Description  
Displays hosts currently connected to the system controller. When run from the  
platform shell, this command shows the connections to the platform and to each  
domain.  
When run from the domain shell, this command will only show the connection to  
the domain. There can only be one connection to each domain.  
See Also  
disconnect  
Chapter 3 System Controller Alphabetical Command Reference  
21  
 
 
Example—Platform Shell  
CODE EXAMPLE 3-4 connectionsCommand for the Platform Shell  
schostname:SC>connections  
ID  
--  
1
Hostname  
--------  
XXX  
Idle Time  
---------  
-
-
Connected On  
------------  
May 02 00:21  
Connected To  
------------  
4
Platform  
schostname:SC  
TABLE 3-2 describes the headers in the output for CODE EXAMPLE 3-4.  
TABLE 3-2  
Header Description for the connections Command  
Header Column in the  
Description  
connectionsCommand  
ID  
Connection ID. This is a unique number.  
Hostname  
Source of the connection for this session. If the value is  
localhost, the connection was established through the platform  
or through the serial port.  
Idle Time  
Amount of time the session is sitting without any activity.  
Displays a dash ( - ) if there has been any activity during the last  
30 seconds.  
Connected On  
Connected To  
Date and time the connection was initiated. The format is  
Mon dd hh:mm.  
Shell or console this session is connected to. Possible values are  
Platformor domainIDs A, B, C, or D.  
22  
Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001  
 
   
console  
Connects to a domain from the platform.  
Scope  
platform shell  
Syntax  
console [-d] domainID  
console -h  
Options/ Parameters  
-ddomainID is the domain to connect to and is a, b, c, or d. The -dparameter is  
optional and does not need to precede the domainID.  
-hdisplays help for this command.  
Description  
Connect to a domain. You use the consolecommand to navigate from the platform  
to a domain. If a password was created for connecting to this domain, you must  
enter the password.  
If the domain is active (the domain is running the Solaris operating environment,  
OpenBoot PROM, or POST), you are connected to the domain console. Otherwise,  
you are connected to the domain shell. To obtain the domain shell from the domain  
console, see the chapter “System Controller Navigation Procedures” in the Sun Fire  
6800/4810/4800/3800 Systems Platform Administration Manual.  
See Also  
disconnect  
Chapter 3 System Controller Alphabetical Command Reference  
 
23  
 
Examples—Platform Shell  
When the domain is not active and there is no password initialized for this domain:  
CODE EXAMPLE 3-5 consoleExample and No Password Set Accessing Domain B  
schostname:SC>console b  
Connected to Domain B  
Domain Shell for Domain B  
schostname:B>  
When a domain is not active and a password is initialized for this domain:  
CODE EXAMPLE 3-6 consoleExample and A Password Set Accessing Domain A  
schostname:SC>console a  
Enter Password:  
Connected to Domain A  
Domain Shell for Domain A  
schostname:A>  
When a domain is active and a password is not set for this domain:  
schostname:SC>console a  
Connected to Domain A  
Note that no other output is seen. If the OpenBoot PROM is at the ok prompt or the  
Solaris operating environment is at the login: prompt, you must press the Enter  
key in order to see the prompt. Otherwise, you will need to wait for output to be  
generated by POST, the OpenBoot PROM, or the Solaris operating environment.  
If the domain is hung, there will be no output. However, when a domain displays no  
output, this does not necessarily mean that the domain is hung.  
24  
Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001  
 
   
deleteboard  
Unassigns a board from the domain where it is currently assigned.  
Scope  
platform shell, domain shell  
Syntax for the Platform Shell and the Domain Shell  
deleteboard system_board_name [system_board_name . . .]  
deleteboard [-h]  
Options/ Parameters  
-hdisplays help for this command.  
system_board_name is the board to be deleted. Values are sb0to sb5(CPU/ Memory  
board) and ib6to ib9(I/ O assembly).  
Description  
Unassigns a board from the domain where it is currently assigned. When you use  
this command from your current domain, you can only unassign boards that are  
assigned to the current domain. The CPU/ Memory board or the I/ O assembly board  
status must be in the Assigned state and the board must not be part of an active  
domain. To display the board states, use the showboardscommand. For more  
information on board states, see “Board States for CPU/ Memory Boards and I/ O  
Assemblies” on page 6. The board does not have to be in the Access Control List  
(ACL) to be unassigned from the domain.  
To unassign a board from a domain, you must halt the Solaris operating  
environment in the domain. For an overview of steps to perform, see the section  
“Assigning and Unassigning Boards” in the “Maintenance” chapter of the Sun Fire  
6800/4810/4800/3800 Systems Platform Administration Manual.  
If a board is not present, the command unassigns ownership of the slot from the  
specified domain.  
Chapter 3 System Controller Alphabetical Command Reference  
 
25  
   
See Also  
addboard,showboards, “Assigning and Unassigning Boards” in the  
“Maintenance” chapter of the Sun Fire 6800/4810/4800/3800 Systems Platform  
Administration Manual (for a step-by-step procedure on unassigning boards from a  
domain)  
Example—Platform Shell  
To delete I/ O assembly ib7, type:  
CODE EXAMPLE 3-7 deleteboard Example Showing Deleting I/ O Assembly 7  
schostname:SC> deleteboard ib7  
Example—Domain Shell  
To delete CPU/ Memory board sb3from the current domain, domain A, type:  
CODE EXAMPLE 3-8 deleteboard Example Showing Deleting CPU/ Memory Board 3  
schostname:A> deleteboard sb3  
26  
Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001  
 
   
disablecomponent  
Adds a component to the blacklist.  
Scope  
platform shell, domain shell  
Syntax  
disablecomponent component_name [component_name . . .]  
disablecomponent -h  
Options/ Parameters  
-hdisplays help for this command.  
component_name is (see TABLE 3-3 and TABLE 3-4):  
system_board_name/ port/ physical_bank/ logical_bank for the CPU/ Memory board  
system_board_name/ port/ bus for an I/ O assembly  
system_board_name/ card for an I/ O assembly  
Note – You can use partial component names.  
Chapter 3 System Controller Alphabetical Command Reference  
27  
 
 
TABLE 3-3  
component_name Descriptions for the CPU/ Memory Board Used in the  
disablecomponentCommand  
Board or Device  
Component Name  
CPU system  
board_name/ port/ physical_bank/ logical_bank  
SB0, SB1, SB2, SB3, SB4, SB5  
CPU/ Memory  
boards  
(system_board_name)  
Ports on the  
CPU/ Memory board  
P0, P1, P2, P3  
B0, B1  
Physical memory  
banks on  
CPU/ Memory  
boards  
Logical banks on  
CPU/ Memory  
boards  
L0, L1, L2, L3  
TABLE 3-4  
component_name Descriptions for the I/ O Assembly Used in the  
disablecomponentCommand  
Board or Device  
Component Name  
I/ O assembly  
system  
board_name/ port/ bus or board_name/ card  
I/ O assemblies  
(system_board_name)  
IB6, IB7, IB8, IB9  
P0, P1  
Ports on the I/ O  
assembly  
Buses on the I/ O  
assembly  
B0, B1  
I/ O cards in the I/ O  
assembly  
C0, C1, C2, C3, C4, C5, C6, C7—the number of cards varies with the  
I/ O assembly  
28  
Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001  
 
   
Description  
This command adds a component to the blacklist. Blacklisting provides a list of  
components that will not be tested and will not be configured into the domain when  
you change the domains keyswitch from an inactive state to an active state or reboot  
the domain.  
Blacklist a component or device if you believe it may be failing intermittently.  
When you disable any component, the subcomponents are also disabled. For  
example, if you disable a CPU, the Ecache and memory that are also controlled by  
the CPU is automatically disabled.  
Devices can be the following (see TABLE 3-3 and TABLE 3-4):  
Ports (CPU on a CPU/ Memory board and I/ O controller on an I/ O assembly)  
Physical and logical memory banks  
I/ O buses  
I/ O cards  
Blacklisting is done on a per domain basis. When you run the disablecomponent  
command in a domain shell, the component is blacklisted for the current domain.  
When you run the disablecomponentcommand from the platform shell, the  
component is disabled in all of the domains.  
Using this command, the platform shell blacklists supersede the domain shell  
blacklists. For example, if a component is disabled in the platform shell, it will be  
disabled in all domains.  
See Also  
enablecomponent,showcomponent, and the “Disabling Components” section in  
the Troubleshooting” chapter of the Sun Fire 6800/4810/4800/3800 Systems Platform  
Administration Manual for step-by-step procedure on adding a component to the  
blacklist.  
Chapter 3 System Controller Alphabetical Command Reference  
 
29  
Examples  
CODE EXAMPLE 3-9 adds system_board_name sb4to the blacklist.  
CODE EXAMPLE 3-9 disablecomponentCommand Example Adding sb4to the  
Blacklists  
schostname:A> disablecomponent sb4  
CODE EXAMPLE 3-10 adds system_board_name sb0and CPU port 3 to the blacklists.  
Note that any memory banks on this CPU port are unreachable and are implicitly  
disabled.  
CODE EXAMPLE 3-10 disablecomponentCommand Example Adding sb0CPU Port 3 to  
the Blacklist  
schostname:A> disablecomponent sb0/p3  
CODE EXAMPLE 3-11 adds system_board_name sb2,CPU port 3, physical bank 0 to the  
blacklists. Note that any logical banks belonging to this physical bank are disabled.  
CODE EXAMPLE 3-11 disablecomponentCommand Example Adding sb2,CPU Port 3,  
and Physical Bank 0 to the Blacklists  
schostname:A> disablecomponent sb2/p3/b0  
CODE EXAMPLE 3-12 adds system_board_name ib9,port 0, bus 1 and board_name ib8,  
I/ O card 2 to the blacklists. Disabling I/ O card 2 shuts down the power to that I/ O  
card.  
CODE EXAMPLE 3-12 disablecomponentCommand Example Adding I/ O Assembly 9,  
Port 0 and Bus 1 and Also I/ O Assembly 8, I/ O Card 2 to the  
Blacklists  
schostname:A> disablecomponent ib9/p0/b1 ib8/c2  
30  
Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001  
 
       
disconnect  
Disconnects the current or specified connection.  
Scope  
platform shell, domain shell  
Syntax for the Platform Shell  
disconnect [ID]  
disconnect -h  
Syntax for the Domain Shell  
disconnect [-h]  
Options/ Parameters  
-hdisplays help for this command.  
ID (platform shell only) is the connection to be terminated. ID is the number  
displayed under the heading ID for the connectionscommand.  
Description  
Terminates a connection to the system controller. If this command is used with no  
arguments, it disconnects the current session. For illustrations of the disconnect  
command, see the chapter “System Controller Navigation Procedures” in the Sun  
Fire 6800/4810/4800/3800 Systems Platform Administration Manual.  
If the connection was initiated from another system, you will be returned to the  
remote host. If the session was initiated from the platform shell, you will see  
nothing. To obtain the prompt, press the Return key. If you are connected from the  
serial port, then you will return to the main menu.  
See Also  
connections  
Chapter 3 System Controller Alphabetical Command Reference  
 
31  
 
Examples  
To disconnect a session from the system controller platform shell with a telnet  
connection (CODE EXAMPLE 3-13), type:  
CODE EXAMPLE 3-13 Disconnecting a Session From the System Controller Platform Shell  
Connection closed by foreign host.  
If you are connected to the system controller platform console with the serial  
connection, you will see the following after typing disconnect  
(CODE EXAMPLE 3-14):  
CODE EXAMPLE 3-14 Disconnecting a Session From the System Controller Platform  
Console  
schostname:SC> disconnect  
Type 0 for Platform Shell  
Type 1 for domain A  
Type 2 for domain B  
Type 3 for domain C  
Type 4 for domain D  
Input:  
To disconnect a session from a system controller domain shell (CODE EXAMPLE 3-15),  
type:  
CODE EXAMPLE 3-15 disconnectExample Showing Disconnecting a Session From the  
Domain A Shell  
schostname:A> disconnect  
Connection closed by foreign host.  
CODE EXAMPLE 3-15 displays a direct connection to the domain and is not a  
connection to the domain made from the platform.  
Note – When you disconnect from a domain shell, you will see nothing. Press the  
Return key to obtain the prompt.  
32  
Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001  
 
     
dumpconfig  
Saves the platform and domain configurations to a server.  
Scope  
platform shell  
Syntax  
dumpconfig-furl  
dumpconfig -h  
Options/ Parameters  
-hdisplays help for this command.  
-fspecifies the URL, which must use the ftpprotocol. The URL must point to a  
directory and not a file. Examples are:  
ftp://userid:password@host/path  
ftp://host/path  
Note – The hostname you enter can be the hostname or a hostname with a fully  
qualified domain name. You cannot use a partial domain name. For example:  
schostname, schostname.eng.sun.comcan be a valid hostname.  
Note – The directory specified in the URL path must have write permission for the  
specified user. If a user was not specified, then anonymous ftp is used.  
Chapter 3 System Controller Alphabetical Command Reference  
 
33  
 
Description  
Saves the platform and domain configurations to a server for recovery in case of a  
system controller failure. This command creates two data files at the specified URL:  
schostname.nvciand schostname.tod.  
Use this command when you complete setting up the initial configuration of the  
platform and the domains, each time you modify the configuration, or change the  
hardware configuration. For example, when you type one of the following  
commands: setupplatform, setupdomain, setdate, addboard, deleteboard,  
enablecomponent, disablecomponent, and password. The data files include  
schostname.nvciand schostname.tod. By running this command again, the new  
platform and domain configurations are saved to a server.  
Caution – This command should be run any time you change the platform or  
domain configuration (see the list of commands in the first paragraph). Invoking this  
command is very important because if the System Controller board fails and you did  
not use this command to save the platform and domain configurations, you will  
have to manually reconfigure the platform and the domains.  
This command is intended to be used as part of the procedure in replacing a failed  
System Controller board. You should not use this command to revert to an old  
configuration. The showplatform, showdomain, showcomponent, and  
showboardssystem controller commands display all of the configuration and can  
be used as a reference.  
If you need to replace the System Controller board, this configuration information  
can be used to restore the platform and domain configurations to the replacement  
System Controller board.  
See Also  
restoreconfig  
Example  
CODE EXAMPLE 3-16 dumpconfigExample  
schostname:SC> dumpconfig -f ftp://hostname/path  
Created: ftp://hostname/path/schostname.nvci  
Created: ftp://hostname/path/schostname.tod  
34  
Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001  
 
 
enablecomponent  
Deletes a component from the blacklist.  
Scope  
platform shell, domain shell  
Syntax  
enablecomponent component_name [component_name . . .]  
enablecomponent -h  
Options/ Parameters  
-hdisplays help for this command.  
component_name is (TABLE 3-5 and TABLE 3-6)  
system_board_name/ port/ physical_bank/ logical_bank for CPU/ Memory boards  
system_board_name/ port/ bus for an I/ O assembly  
system_board_name/ card for an I/ O assembly  
TABLE 3-5  
component_name Descriptions for the CPU/ Memory Board Used in the  
enablecomponentCommand  
Board or Device  
Component Name  
CPU system  
board_name/ port/ physical_bank/ logical_bank  
SB0, SB1, SB2, SB3, SB4, SB5  
CPU/ Memory  
boards  
(system_board_name)  
Ports on the  
CPU/ Memory board  
P0, P1 ,P2, P3  
B0, B1  
Physical memory  
banks on  
CPU/ Memory  
boards  
Logical banks on  
CPU/ Memory  
boards  
L0, L1, L2, L3  
Chapter 3 System Controller Alphabetical Command Reference  
35  
 
   
TABLE 3-6  
component_name Descriptions for the I/ O Assembly Used in the  
enablecomponentCommand  
Board or Device  
Component Name  
I/ O assembly  
system  
board_name/ port/ bus or board_name/ card  
I/ O assemblies  
(system_board_name)  
IB6, IB7, IB8, IB9  
P0, P1  
Ports on the I/ O  
assembly  
Buses on the I/ O  
assembly  
B0, B1  
I/ O cards in the I/ O  
assembly  
C0, C1, C2, C3, C4, C5, C6, C7—the number of cards varies with the  
I/ O assembly  
Description  
Removes a component from the blacklist. Blacklisting provides a list of components  
that will not be tested and will not be configured into the domain when you change  
the keyswitch setting from an inactive state to an active state or when the domain is  
rebooted.  
Components can be the following:  
Ports (CPU on the CPU/ Memory board or I/ O controller on the I/ O assembly)  
Physical and logical memory banks  
I/ O buses  
I/ O cards  
Blacklisting is done on a per domain basis. When you run the enablecomponent  
command from the domain, the component is removed from the blacklist for the  
current domain. When the enablecomponentcommand is run from the platform  
shell, the component is removed from the blacklist for all domains.  
Using this command, the platform shell blacklists supersede the domain shell  
blacklists. For example, if a component is enabled in the platform shell, it will be  
enabled in all domains.  
36  
Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001  
 
 
See Also  
disablecomponent,showcomponent, and the Sun Fire 6800/4810/4800/3800  
Systems Platform Administration Manual for step-by-step procedure on removing a  
component from the blacklist. This information is in the Troubleshooting” chapter  
in the section “Disabling Components.”  
Examples  
CODE EXAMPLE 3-17 enables CPU/ Memory board sb4. This removes CPU/ Memory  
board sb4from the blacklist.  
CODE EXAMPLE 3-17 enablecomponentCommand Example Enabling CPU/ Memory  
Board 4  
schostname:A> enablecomponent sb4  
CODE EXAMPLE 3-18 enables I/ O assembly 6, port 1. This removes port 1 of I/ O  
assembly 6 from the blacklist.  
CODE EXAMPLE 3-18 enablecomponentCommand Example Enabling I/ O Assembly 6  
and Port 1  
schostname:A> enablecomponent ib6/p1  
Chapter 3 System Controller Alphabetical Command Reference  
 
37  
   
flashupdate  
Updates the firmware on the system controller and the system boards  
(CPU/ Memory boards and I/ O assemblies). The source flash image can be on a  
server or another board of the same type.  
Scope  
platform shell  
Syntax  
flashupdate [-y|-n] -f url all|systemboards|scapp|rtos|domainID  
flashupdate [-y|-n] -f url systemboards|scapp|rtos|domainID  
flashupdate [-y|-n] -f url board [board . . . ]  
flashupdate [-y|-n] -u  
flashupdate [-y|-n] -csource_board destination_board [destination_board . . .]  
flashupdate -h  
Options/ Parameters  
-hdisplays help for this command.  
-ydoes not prompt for confirmation.  
-ndoes not execute this command if confirmation is required.  
-fspecifies a URL as the source of the flash images  
url is the URL to the directory containing the flash images.  
where:  
ftp://hostname/path  
ftp://userid:password@hostname/path  
http://hostname/path  
38  
Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001  
 
 
Note – The hostname you enter must be a host name or a host name with a fully  
qualified domain name. You cannot use a partial domain name. Some examples  
include: schostname, schostname.eng.sun.com.  
board is the board name.  
-cspecifies that the image should be copied from another board.  
source_board is the source board for the flash images.  
destination_board is the destination board for the flash images.  
-uautomatically updates all of the boards from the board with the highest revision.  
allupdates the system controller, all system boards (CPU/ Memory boards and I/ O  
assemblies), and the system controller real time operating system (rtos).  
system_boardsare all CPU/ Memory boards and I/ O assemblies.  
scappupdates the current system controller. Updating the system controller reboots  
the system controller and disconnects all the current connections. To update the  
other system controller, you must run the flashupdatecommand from the other  
system controller. Use showscto determine which system controller you are  
currently using so you know the system controller you must go to next to update it.  
rtosupdates the real time operating system for the system controller. If you have a  
second System Controller board installed, when you update the real time operating  
system also update the rtoson the second System Controller board. To update the  
rtoson the second system controller, run the flashupdatecommand from the  
second System Controller board.  
domainID (a, b, c, or d) upgrades all boards that are assigned to this domain.  
Description  
Updates the firmware on the system controller, CPU/ Memory boards, and I/ O  
assemblies. There is no firmware on Repeater boards. Boards must be powered on in  
order to be updated with flashupdate. If a board does not have power, the  
flashupdatecommand will do nothing and stop with an error message. Boards  
that are in a secure domain cannot be updated.  
Caution – When you update the firmware on the system controller, update only one  
system controller. DO NOT update both system controllers at the same time.  
Chapter 3 System Controller Alphabetical Command Reference  
 
39  
 
Note – Any time the firmware is upgraded, check the Install.infofile for the  
firmware upgrade procedure. This file is provided with your latest software release.  
Also refer to the Release Notes for any notes or special procedures.  
If you install a replacement board into the system:  
1. Check if the firmware level of the replacement board is the same as the board you  
replaced. Incompatible boards are noted by the Failedboard state in the output  
of the showboardscommand.  
2. If the board level is not the same as the board you replaced, perform the  
flashupdateprocedure on the board.  
3. If a board was noted by the Failedstate in showboards, after you  
flashupdatea compatible version, power off the board to clear the Failed  
state.  
Before you update the flash images, make sure the firmware on the replacement  
board is compatible with the firmware of the board you are replacing for scapp,  
CPU/ Memory board, and I/ O assembly PROMs. New firmware is loaded if you  
reboot the domain or turn the domain keyswitch off with setkeyswitch offand  
then turn it on with setkeyswitch on.  
To determine the version number of the current firmware:  
1. Use the showboards -p promscommand.  
2. Compare the x.y.z number format. If x and y are the same, then the flash images  
are compatible.  
The new firmware may also contain a new rtosimage. If the rtosimage that is  
currently installed is different than the rtossupplied with the software, you  
must upgrade the rtosimage.  
To determine the version number of the current rtos:  
1. Use showsc. The READMEfile contains the version number of the new rtos  
image.  
There is currently no method to determine that the scappand rtosversions are  
compatible.  
Note – If you fail to check all versions, the domains can crash or the system  
controller would fail to reboot normally.  
40  
Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001  
 
Caution – While upgrading the firmware, heed the following precautions:  
- Read the READMEand Install.infofiles before you upgrade the firmware.  
- Do not change the keyswitch position of any domain.  
- Do not use DR.  
- Do not power off any boards.  
- Do not reboot the system controller.  
If you upgrade the scappor rtosimages for status:  
1. It is important to watch the console during the flashupdateprocedure.  
2. Monitor the console if errors are reported.  
If the images that are already installed are incompatible with the new images:  
1. Shut down the domains before performing the firmware upgrade.  
2. After you perform the firmware upgrade, reboot the domains.  
If the images that are already installed are compatible with the new images:  
1. Reboot the domains after performing the flashupdateprocedure. Even though  
the firmware is compatible with the older firmware version, you must upgrade  
the firmware to obtain new features and bug fixes.  
If you install a replacement board into the system:  
1. Check if the firmware level of the replacement board is the same as the board you  
replaced.  
2. If is it not, perform the flashupdateprocedure on the board.  
Caution – Under normal circumstances, the flashupdatecommand will complete  
successfully. However, if the flashupdatecommand is terminated abnormally  
(such as a power failure, a failed network connection, and so on), the system  
controller goes into maintenance mode.  
To bring the system controller out of maintenance mode and back into its normal  
operating mode, type the flashupdatecommand with a valid URL or use the  
rebootcommand to boot the system controller with an older firmware version.  
See Also  
Sun Fire 6800/4810/4800/3800 Systems Platform Administration Manual  
Chapter 3 System Controller Alphabetical Command Reference  
 
41  
flashupdateCommand Platform Shell—Examples  
Note – In the following examples, since the output is very long, only the command  
you type is listed in the code box.  
Note – The flashupdate all, flashupdate rtos,and flashupdate  
scappcommands cause the system controller to reboot once.  
To update the active System Controller board and the system controller real time  
operating system (rtos), perform this procedure from the platform console and  
watch the console output. This command reboots the system controller. Type:  
CODE EXAMPLE 3-19 flashupdateExample Updating the Active System Controller  
Board and the System Controller Real Time Operating System  
schostname:SC> flashupdate -f ftp://host/path scapp rtos  
To upgrade the firmware on a replacement CPU/ Memory board, sb4  
(destination_board), which is a replacement CPU/ Memory board for  
CPU/ Memory board, sb0(source_board). Type:  
CODE EXAMPLE 3-20 flashupdateExample Updating Replacement CPU/ Memory Board  
sb4  
schostname:SC> flashupdate -c sb0 sb4  
42  
Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001  
 
   
help  
Provides basic help information for commands.  
Scope  
platform shell, domain shell  
Syntax  
help [command_name] | [partial_command_name]  
help -h  
Options/ Parameters  
-hdisplays help for this command.  
command_name is the name of the command.  
partial_command_name can be one letter of the command or a portion of the  
command name, such as show.  
Description  
The helpcommand, without arguments, lists currently available commands. When  
an argument is supplied, the helpcommand displays a list of commands that begin  
with the specified argument. If only one command is found, full help is displayed.  
Otherwise, a short description is displayed for each command, beginning with the  
specified argument.  
You can also type a partial command name and basic help information will be  
returned for all commands matching the partial name. The partial command name  
must contain enough of the command name in order for the command to be  
recognized by help. The helpcommand returns help information for all commands  
beginning with the characters you typed.  
The helpcommand is shell sensitive. It displays help information for the current  
shell only.  
Chapter 3 System Controller Alphabetical Command Reference  
 
43  
   
Examples  
CODE EXAMPLE 3-21 displays help information on the addboardcommand.  
CODE EXAMPLE 3-21 helpCommand Example Displaying Information on the addboard  
Command  
schostname:SC> help addboard  
addboard -- assign a board to a domain  
addboard -h  
-d -- the domain to assign the board to  
-h -- display this help message  
CODE EXAMPLE 3-22 displays all commands in the platform shell beginning with  
show.  
CODE EXAMPLE 3-22 helpCommand Example Displaying Commands Beginning With the  
Word show  
schostname:SC> help show  
showboards  
showcomponent  
showdate  
-- show board information  
-- show state of a component  
-- show the current date and time for the platform  
showenvironment -- show environmental information  
showkeyswitch  
showlogs  
-- show the keyswitch positions  
-- show the logs  
showplatform  
showsc  
-- show platform configuration, information and domain status  
-- show system controller version and uptime  
44  
Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001  
 
   
CODE EXAMPLE 3-23 displays all commands in the platform shell beginning with the  
letter a.  
CODE EXAMPLE 3-23 helpCommand Example Displaying Commands Beginning With the  
Letter A  
schostname:SC> help a  
addboard -- assign a board to a domain  
Usage: addboard -d <domain> <board> ...  
addboard -h  
-d -- the domain to assign the board to  
-h -- display this help message  
Chapter 3 System Controller Alphabetical Command Reference  
 
45  
 
history  
Shows the command history with date and time stamps.  
Scope  
platform shell, domain shell  
Syntax  
history [-h]  
Options/ Parameters  
-hdisplays help for this command.  
Description  
Shows the command history with date and time stamps for when the commands  
were executed. This command is shown for your shell and displays the last twenty  
commands only.  
See Also  
Command line editing can be used to edit the command history. For more  
information on how to use command line editing, see “Command Line Editing” on  
page 9.  
Example  
CODE EXAMPLE 3-24 historyCommand  
schostname:SC>history  
May 07 16:29:21 : showboards  
May 07 16:29:24 : showdate  
May 07 16:29:29 : history  
46  
Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001  
 
     
password  
Sets the password for the platform or the domain.  
Scope  
platform shell, domain shell  
Syntax—Platform Shell  
password [-d domainID]  
password -h  
Syntax—Domain Shell  
password  
password [-h]  
Options/ Parameters  
-d domainID is domain a, b, c, or d.  
-hdisplays help for this command.  
Description  
Sets the password for the platform or the domain. There are separate passwords for  
each domain and for the platform. If you set a password, entering the password is  
required for access to the shell or console.  
It is very important to set the password for the platform and each domain even if a  
domain is not being used. This prevents people from creating and activating  
unauthorized domains.  
Prior to allowing the password to be changed, the current password will be  
authenticated. Changed passwords take effect immediately. The old password will  
no longer be accepted.  
You can remove the password by pressing Return at the Enter new passwordand  
Enter new password againprompts.  
Chapter 3 System Controller Alphabetical Command Reference  
 
47  
   
OpenBoot PROM passwords are different from the platform and domain passwords.  
The OpenBoot PROM in each domain supports the OpenBoot PROM security mode,  
which is a standard feature of the OpenBoot PROM software. For more information  
on the OpenBoot PROM security mode password, see your OpenBoot PROM  
documentation.  
See Also  
“Security” chapter of the Sun Fire 6800/4810/4800/3800 Systems Platform  
Administration Manual  
Examples  
You will see the following prompt (CODE EXAMPLE 3-25), when a password is already  
set and you type the passwordcommand at either the platform shell or the domain  
shell.  
CODE EXAMPLE 3-25 passwordCommand Example With a Password Already Set  
schostname:SC> password  
Enter current password:  
Enter new password:  
Enter new password again:  
schostname:SC>  
If currently there is not a password assigned to the shell you are entering, you will  
not be prompted for the current password (CODE EXAMPLE 3-26).  
CODE EXAMPLE 3-26 passwordCommand Example With No Password Set  
schostname:SC> password  
Enter new password:  
Enter new password again:  
schostname:SC>  
48  
Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001  
 
   
poweroff  
Powers off components.  
Scope  
platform shell, domain shell  
Syntax for the Platform Shell  
poweroff [-y|-n] all|grid#|component_name [component_name . . . ]  
poweroff -h  
Syntax for the Domain Shell  
poweroff [-y|-n] all|component_name [component_name . . . ]  
poweroff -h  
Options/ Parameters  
-hdisplays help for this command.  
-ywill answer yes to any question. This option is potentially hazardous. You can  
forcefully power off a component with the -yoption.  
-nanswers no to any question. You cannot forcefully power off a component with  
the -noption.  
component_name is the component name.  
Platform shell component_name(s):  
allturns off all currently controllable components.  
Power grid (grid0, grid1). The Sun Fire 6800 system has two power grids: grid0  
and grid1. Grid 1 controls power supplies ps3, ps4, and ps5. All other mid-range  
systems have one power grid, grid0. This grid controls power supplies ps0, ps1,  
and ps2.  
Power supply (ps0 - ps5)  
CPU/ Memory board (sb0 - sb5)  
I/ O assembly (ib6 - ib9)  
Repeater board (rp0 - rp3)  
Fan tray (ft0 - ft3)  
Chapter 3 System Controller Alphabetical Command Reference  
 
49  
   
Domain shell component_name(s):  
CPU/ Memory board (sb0 - sb5)  
I/ O assembly (ib6 - ib9)  
Note – The specified board must be in the current domain.  
Description  
Powers off a component or a list of components.  
For the domain shell, the specified board must be in the current domain.  
All slots listed by showboardscan be powered off except for system controllers  
(SSC0 and SSC1) and the ID board (ID0). A powered-off component will not be  
monitored. Use the showboardscommand to display the power status of each  
board.  
You can power off any component except when the board is in the Activestate (see  
the showboardscommand to display the board state). When a component is in the  
Activestate, a warning is displayed on the console that tells you the entire domain  
will go down. You are asked to confirm with a warning of the consequences.  
If a board is active in a domain and you forcefully power off a device (board), the  
keyswitch for the domain will be set to standby. To change the keyswitch setting, use  
the setkeyswitchcommand.  
Repeater boards do not have an Activestate. You cannot power off a Repeater  
board if it is being used by a domain.  
You can turn off power supplies if turning off the power supply would leave  
sufficient power in the power grid to support the current load of the power grid.  
This varies with the configuration. It you attempt to power off a power supply that  
is required to support the current load, the power supply will not be powered off  
and a message stating why is displayed. You can power off redundant power  
supplies.  
If powering off a fan would result in insufficient cooling, it cannot be powered off.  
See Also  
poweron,setkeyswitch,showboards  
50  
Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001  
 
 
Examples  
To power off CPU/ Memory board, sb2,from the platform shell  
(CODE EXAMPLE 3-27), type:  
CODE EXAMPLE 3-27 poweroffCommand Example Showing Powering Off sb2  
schostname:SC> poweroff sb2  
To power off all power supplies, fan trays, and system boards (CODE EXAMPLE 3-28),  
type:  
CODE EXAMPLE 3-28 poweroffCommand Example Showing Powering Off All Power  
Supplies, Fan Trays, and System Boards in the Platform Shell  
schostname:SC> poweroff all  
Note – From the domain shell, you cannot power off power supplies, fan trays,  
Repeater boards, or power grids. To power off these components, connect to the  
platform shell.  
Chapter 3 System Controller Alphabetical Command Reference  
 
51  
   
poweron  
Powers on components.  
Scope  
platform shell, domain shell  
Syntax for the Platform Shell  
poweron all|grid#|component_name [component_name . . . ]  
poweron -h  
Syntax for the Domain Shell  
poweron all|component_name [component_name . . . ]  
poweron -h  
Options/ Parameters  
-hdisplays help for this command.  
Platform shell component_name(s):  
allis all power supplies and boards.  
Power grid (grid0, grid1). The Sun Fire 6800 system has two power grids: grid0  
and grid1. Grid 1 controls power supplies ps3, ps4, and ps5. All of the other mid-  
range systems have one power grid, grid0. This grid controls power supplies  
ps0, ps1, and ps2.  
Power supply (ps0 - ps5)  
CPU/ Memory board (sb0 - sb5)  
I/ O assembly (ib6 - ib9)  
Repeater board (rp0 - rp3)  
Fan tray (ft0 - ft3)  
Domain shell component_names:  
allpowers on all CPU/ Memory boards and I/ O assemblies in the domain  
CPU/ Memory board (sb0 - sb5)  
I/ O assembly (ib6 - ib9)  
The specified board must be in the current domain.  
52  
Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001  
 
   
Description  
Powers on a component or a list of components You must specify component_name(s).  
You can power on any component that is not already powered on if there is  
sufficient power to support the component when it is powered on. From the domain,  
only components that are assigned to the domain can be powered on. To power on a  
component, the power grid power must also be on.  
Fan trays are automatically powered on when a power supply is powered on. Fan  
trays obtain power from the power grid(s).  
The System Controller boards obtain their power from a secondary power output on  
the power supplies. The System Controller boards power on automatically when the  
system is supplied with power. For example, the System Controller boards will  
power on automatically on a Sun Fire 6800 system if the power cords are connected,  
the system has power, and the circuit breaker(s) are on. The System Controller board  
will automatically power on the Sun Fire 4810/ 4800/ 3800 systems if the power cords  
are connected to the power source, the system has power, and the power supply  
switches are turned on (Sun Fire 3800 system only).  
The fan trays power on automatically if any power supply is on.  
See Also  
poweroff, setkeyswitch,showboards  
Examples  
To power on CPU/ Memory board, sb2from the platform shell (CODE EXAMPLE 3-29),  
type:  
CODE EXAMPLE 3-29 poweronExample Powering On sb2  
schostname:SC> poweron sb2  
Chapter 3 System Controller Alphabetical Command Reference  
 
53  
   
To power on CPU/ Memory boards and I/ O assemblies in the domain  
(CODE EXAMPLE 3-30), type:  
CODE EXAMPLE 3-30 poweronExample Showing Powering On All CPU/ Memory Boards  
and I/ O Assemblies in Domain A  
schostname:A> poweron all  
Note – From the domain shell, you cannot power on power supplies, Repeater  
boards, fan trays, or power grids. To power on these components, use the platform  
shell.  
54  
Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001  
 
 
reboot  
Reboots the system controller.  
Scope  
platform shell  
Syntax  
reboot [-y|-n]  
reboot -h  
Options/ Parameters  
-ydoes not prompt for confirmation.  
-ndoes not execute this command. Confirmation is requested.  
-hdisplays help for this command.  
Description  
Reboots the system controller. The rebootcommand will not change any  
configuration settings. Active domains will continue to run.  
The keyswitch may be set to off if the system controller reboots while a keyswitch  
operations is in progress.  
Caution – Rebooting interrupts any current operation. This includes keyswitch  
operations, rebooting the Solaris operating environment, testing boards, SNMP, and  
so on.  
Chapter 3 System Controller Alphabetical Command Reference  
 
55  
 
Examples  
To reboot the system controller (CODE EXAMPLE 3-31), type:  
CODE EXAMPLE 3-31 rebootCommand Example  
schostname:SC> reboot  
Are you sure you want to reboot the System Controller now? [no]  
56  
Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001  
 
 
reset  
Resets the domain.  
Scope  
domain shell  
Syntax  
reset [-y|-n][-x|-a]  
reset -h  
Options/ Parameters  
-yanswers yes to the question asked (executes the command).  
-nanswers no to the question asked (does not execute the command).  
-hdisplays help for this command.  
Options/ Parameters  
With no arguments, typing resetis the same as typing reset -x.  
-xresets via XIR (externally initiated reset). Use XIR to try to obtain diagnostic data  
(default).  
-areset is equivalent to the OpenBoot PROM reset-allcommand.  
Description  
This command also resumes the domain console. Resetting the domain is not  
allowed if the keyswitch is in the secure position. Before you can reset the domain,  
change the keyswitch position to on. Resetting the domain is not possible if the  
keyswitch is configured in either the off or standby position.  
By default, resetuses XIR (externally initiated reset) to reset the CPUs in the  
domain. The externally initiated reset forces control of the domain into the  
OpenBoot PROM and begins the OpenBoot PROM error reset recovery actions. The  
error reset recovery actions preserve most domain states to allow collecting data  
needed for debugging the hardware and software, including a Solaris operating  
environment core file. The OpenBoot PROM error reset recovery actions are  
Chapter 3 System Controller Alphabetical Command Reference  
 
57  
   
controlled by setting the OpenBoot PROM error-reset-recoveryconfiguration  
variable. For the definition of this variable and the various settings, see TABLE 3-10 in  
setupdomain” on page 76.  
Note that the OpenBoot PROM resetcommand does not generate a core file as this  
command does.  
You cannot reset a domain that has been paused. The domain is paused  
automatically when hardware detects an error. Messages on the domain console  
indicate that the domain is paused.  
To take a domain out of the paused state:  
1. Turn the keyswitch off with setkeyswitch off.  
See Also  
resume, setkeyswitch,setupdomain, showdomain, showkeyswitch,  
showresetstate, “Domain Not Responding” section in the “Troubleshooting”  
chapter in the Sun Fire 6800/4810/4800/3800 Systems Platform Administration Manual.  
This section describes how to recover from a hung or paused domain.  
Examples  
To reset the domain (from a domain shell), type the following (CODE EXAMPLE 3-32).  
This command uses XIR (externally initiated reset) to try to obtain diagnostic data.  
CODE EXAMPLE 3-32 resetCommand Example From Domain A  
schostname:A> reset  
To perform the equivalent operation as the OpenBoot PROM reset-allcommand  
(CODE EXAMPLE 3-33), type:  
CODE EXAMPLE 3-33 reset-a Command Example From Domain A  
schostname:A> reset -a  
58  
Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001  
 
   
restoreconfig  
Restores the platform and domain configurations from a server.  
Scope  
platform shell  
Syntax  
restoreconfig [-y|-n] -furl  
restoreconfig -h  
Options/ Parameters  
-hdisplays help for this command.  
-ydoes not prompt for confirmation.  
-ndoes not execute this command if confirmation is required.  
-f specifies a URL, which must use the ftp protocol.  
url is the directory containing the data files. The URL must point to a directory  
and not a file. Examples are:  
ftp://userid:password@hostname/path  
ftp://hostname/path  
Note – The hostname you enter can be the host name or the host name with a fully  
qualified domain name, such as schostname or schostname.eng.sun.com. You cannot  
use a partial domain name.  
Description  
Restores the platform and domain configurations from a server if a system controller  
board has failed and has been replaced. This is based on the two data files created by  
the dumpconfigcommand, schostanme.nvciand schostname.tod,at the specified  
URL, which must point to a directory and use the ftp protocol. This command  
prompts you for a new platform password.  
Chapter 3 System Controller Alphabetical Command Reference  
 
59  
 
Caution – The dumpconfigcommand is intended to be used as part of replacing a  
failed system controller. For instructions on how to use dumpconfig, see “To Use  
the dumpconfigCommand to Save the Current Platform and Domain  
Configurations to a Server” in the chapter “System Power On and Setup” in the Sun  
Fire 6800/4810/4800/3800 Systems Platform Administration Manual. This command  
should have been executed when you set up the system.  
This command requires that all domains be powered off with the setkeyswitch  
offcommand. The system controller automatically reboots when the configuration  
is restored. The date and time need to be set after the configuration has been  
restored and the system controller has been rebooted. You also need to activate all  
domains with setkeyswitch on, since this command restores all domains in the  
off keyswitch position.  
Note – Check the configuration of the platform and the domains before activating  
any domains to ensure that the desired configuration has been restored. In the  
platform shell use showplatform, showboards, and showdate. In each domain  
shell use showdomain, showboards, and showdate.  
See Also  
dumpconfig, setkeyswitch, setdate, showboards, showdate,  
showdomain, showplatform  
Example  
CODE EXAMPLE 3-34 shows an example of the restoreconfigcommand with the  
required -foption.  
CODE EXAMPLE 3-34 restoreconfigExample  
schostname:SC> restoreconfig -f ftp://hostname/path  
The system controller will be rebooted when the restore is complete. The date  
will need to be set in the platform and each domain.  
Do you want to restore the system controller configuration now [no] yes  
Retrieving: ftp://hostname/path/schostname.nvci  
Retrieving: ftp://hostname/path/schostname.tod  
Verifying data  
60  
Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001  
 
 
CODE EXAMPLE 3-34 restoreconfigExample (Continued)  
NVCI has been restored  
TOD has been restored  
Restore complete. The system controller is being rebooted.  
The date will need to be set in the platform and each domain.  
Software Reset . . .  
Chapter 3 System Controller Alphabetical Command Reference  
 
61  
resume  
Exits the domain shell and resumes access to the domain console.  
Scope  
domain shell  
Syntax  
resume [-h]  
Options/ Parameters  
-hdisplays help for this command.  
Description  
Exits the domain shell and resumes access to the domain console. This command  
requires an active domain. If the domain is not active, there is no domain console  
and there is nothing to resume. When you connect to the domain console, there may  
not be any output displayed. If either the OpenBoot PROM or the Solaris operating  
environment is running in the domain, press the Return key to get the prompt.  
Otherwise, POST output is displayed (may be a delay in displaying POST output).  
Other system controller commands that also resume the domain console are listed in  
the following section.  
See Also  
break, reset, setkeyswitch  
62  
Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001  
 
   
Example  
CODE EXAMPLE 3-35 resumeCommand Example in Active Domain A  
schostname:A> resume  
Note that no other output is seen. If the OpenBoot PROM is at the ok prompt or the  
Solaris operating environment is at the login: prompt, you must press the Enter  
key in order to see the prompt. Otherwise, you will need to wait for output to be  
generated by POST, the OpenBoot PROM, or the Solaris operating environment.  
If the domain is hung, there will be no output. However, when a domain displays no  
output, this does not necessarily mean that the domain is hung.  
Chapter 3 System Controller Alphabetical Command Reference  
 
63  
 
setdate  
Sets the date and time.  
Scope  
platform shell, domain shell  
Syntax  
setdate [-v] [-t time zone][mmdd]HHMM  
setdate [-v] [-t time zone]mmddHHMM [[cc]yy][.SS]  
setdate [-v] [-r datehost]  
setdate [-v] -t time zone  
setdate [-v] -t GMT<+| -> offset from GMT (TABLE 3-7)  
setdate -h  
Options/ Parameters  
-ttime zone sets the time zone using the time zone abbreviation (TABLE 3-7). Only  
non-daylight savings time zones can be specified. If you are in an area with daylight  
time or summer time, the time and time zone are adjusted automatically for daylight  
time or summer time.  
-t GMT<+| ->offset from Greenwich Mean Time—GMT (TABLE 3-7).  
mm is the month number.  
dd day is the number in the month.  
HH is the hour number (24-hour clock).  
MM is the minute number.  
cc is the century minus 1.  
yy is the last two digits of the year number.  
SS is the second number. For the century minus 1 value, use 21 (Twenty first  
century) minus 1, which yields 20.  
64  
Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001  
 
   
-rdatehost sets the current time using rdate.The host must be a valid system  
name and the system must support rdate requests. The hostname you enter can be  
the host name or the host name with a fully qualified domain name, such as  
schostname or schostname.eng.sun.com. You cannot use a partial domain name.  
-vis verbose mode. Displays detailed information about the time zone that is set.  
-hdisplays help for this command.  
TABLE 3-7  
Time Zone Abbreviations, Time Zone Name, and Offsets From Greenwich  
Mean Time  
Offset From Greenwich Mean Time  
Time Zone Abbreviation  
Time Zone Name  
(GMT)  
ACT  
AET  
AGT  
ART  
AST  
BET  
BST  
CAT  
CNT  
CST  
CTT  
EAT  
ECT  
EET  
EST  
HST  
IET  
Australian central time  
Australian eastern time  
Argentina standard time  
Arabic (Egypt) standard time  
Alaska standard time  
Brazil eastern time  
GMT+9.5  
GMT+10  
GMT-3  
GMT+2  
GMT-9  
GMT-3  
Bangladesh standard time  
Central African time  
Canada Newfoundland time  
Central standard time  
China Taiwan time  
GMT+6  
GMT+2  
GMT-3.5  
GMT-6  
GMT+8  
GMT+3  
GMT+1  
GMT+2  
GMT-5  
Eastern African time  
European central time  
Eastern European time  
Eastern standard time  
Hawaii standard time  
Indiana eastern standard time  
India standard time  
GMT-10  
GMT-5  
IST  
GMT+5.5  
GMT+9  
GMT+3.5  
GMT-11  
GMT-7  
JST  
Japan standard time  
Middle East time  
MET  
MIT  
MST  
NET  
Midway Islands time  
Mountain standard time  
Near East time  
GMT+4  
Chapter 3 System Controller Alphabetical Command Reference  
 
65  
 
TABLE 3-7  
Time Zone Abbreviations, Time Zone Name, and Offsets From Greenwich  
Mean Time (Continued)  
Offset From Greenwich Mean Time  
Time Zone Abbreviation  
Time Zone Name  
(GMT)  
NST  
PLT  
PNT  
PRT  
PST  
SST  
New Zealand standard time  
Pakistan Lahore time  
GMT+12  
GMT+5  
GMT-7  
GMT-4  
GMT-8  
GMT+11  
GMT+0  
GMT+7  
Phoenix standard time  
Puerto Rico and U S. Virgin Islands time  
Pacific standard time  
Solomon standard time  
Universal Time Coordinated  
Vietnam standard time  
UTC  
VST  
Description  
Sets the date and time for the platform and domains. This command, when invoked  
from the platform, will have no effect on the date and time in each domain and vice  
versa. You can set up to five different times and time zones; one time and time zone  
for the platform and different times and time zones for each of the four domains.  
If your time zone area is using daylight or summer time, this is set automatically.  
Note – You cannot set the date from the system controller in a domain while the  
Solaris operating environment is running. To set the date while the Solaris operating  
environment is running, use the Solaris operating environment datecommand.  
See Also  
showdate  
66  
Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001  
 
 
Examples  
When you type the setdatecommand from the platform, this sets the date and  
time for the platform. When you type the setdatecommand from the domain, this  
sets the date and time for the domain.  
To set the date and time on the platform to Thursday, April 20, 2001, at 18 hours 15  
minutes and 10 seconds, type:  
CODE EXAMPLE 3-36 setdateCommand Example in the Platform Shell  
schostname:SC>setdate 042018152001.10  
Thu Apr 20 18:15:10 PST 2001  
To set the date from a date host:  
CODE EXAMPLE 3-37 setdate -rCommand Example Setting the Date From a Date Host  
schostname:SC>setdate -r datehost  
Thu Apr 20 18:15:10 PST 2001  
To set the time zone to Pacific Standard Time (PST), using the offset from Greenwich  
mean time—GMT, and the date and time on the platform to Thursday, April 20,  
2001, at 18 hours 15 minutes and 10 seconds (TABLE 3-7), type:  
CODE EXAMPLE 3-38 setdate -tCommand Example Setting the Time Zone to Pacific  
Standard Time Using the Offset From Greenwich Mean Time  
schostname:SC>setdate -t GMT-8 042018152001.10  
Thu Apr 20 18:15:10 PST 2001  
To set the time zone to Eastern Standard Time (EST), using the time zone  
abbreviations, and the date and time on the platform to Thursday, April 20, 2001, at  
18 hours 15 minutes and 10 seconds (TABLE 3-7), type:  
CODE EXAMPLE 3-39 setdate -tCommand Example Setting the Date and Time Zone to  
Eastern Standard Time Using Time Zone Abbreviations  
schostname:SC>setdate -t EST 042018152001.10  
Thu Apr 20 18:15:10 EST 2001  
Chapter 3 System Controller Alphabetical Command Reference  
 
67  
       
To set just the time zone for Japan Standard Time using offsets from Greenwich  
Mean Time—GMT (TABLE 3-7) and not the date and time, type:  
CODE EXAMPLE 3-40 setdate -tCommand Example Setting the Time Zone to Japan  
Standard Time Using the Offset From Greenwich Mean Time  
schostname:SC>setdate -t GMT+9  
Thu Apr 20 18:15:10 GMP+9 2001  
To set just the time zone for European Central Time using the time zone  
abbreviations (TABLE 3-7) and not the date and time, type:  
CODE EXAMPLE 3-41 setdate -tCommand Example Setting the Time Zone to Eastern  
Central Time Using Time Zone Abbreviations  
schostname:SC>setdate -t ECT  
Thu Apr 20 18:15:10 ECT 2001  
68  
Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001  
 
   
setdefaults  
Sets the default configuration values.  
Caution – This is a destructive command. Use with caution and care.  
Scope  
platform shell, domain shell  
Syntax  
setdefaults [-y|-n] [-c][-p platform]  
setdefaults -h  
Options/ Parameters—Platform Shell  
-ydoes not prompt for confirmation. The option sets the defaults for the platform  
shell and each domain shell.  
-ndoes not execute the command if confirmation is requested.  
-ckeeps Capacity on Demand (COD) licenses.  
-hdisplays help for this command.  
-pplatformresets the defaults for the platform only.  
Options/ Parameters—Domain Shell  
-ydoes not prompt for confirmation.  
-ndoes not execute the command if confirmation is requested.  
-hdisplays help for this command.  
Chapter 3 System Controller Alphabetical Command Reference  
69  
 
 
Description  
Caution – This command requires that all domains are inactive (not running the  
OpenBoot PROM, POST, or the Solaris operating environment) and the keyswitch be  
set to off.  
When you run this command from the platform shell without options, the platform  
and domain values are set to the default values. When you run this command from  
the domain shell without options, only the current domain values are reset to the  
default values.  
If a password is set, you will need to type the password in order to set the default  
values. When you run this command from the platform shell, the password for the  
platform shell is required. When you run this command from a domain shell, the  
password for the domain shell is required. There are separate passwords for the  
platform shell and each domain shell. In addition, this command also does the  
following:  
Sets the system controller to the default values. This command only resets the  
system controller setting. It does not affect the domains configuration in the  
OpenBoot PROM.  
Erases all platform and domain configurations (platform).  
Removes passwords (domain and platform).  
Example  
CODE EXAMPLE 3-42 setdefaultsExample  
schostname:SC> setdefaults  
You are about to reset all configuration data to default values.  
All domain configurations, ACLs, passwords and data buffers will  
be lost.  
The system controller will be REBOOTED after the defaults are set.  
Do you want to restore the default values and reboot now? [no]  
If you answer yes, the system controller is rebooted after the defaults are set.  
If you answer no, the default values are not restored.  
If a password is set for the platform shell, the password will be required.  
70  
Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001  
 
 
setkeyswitch  
Changes the position of the virtual keyswitch to the specified value.  
Scope  
platform shell, domain shell  
Syntax for the Platform Shell  
setkeyswitch [-y|-n] -d domainID off  
setkeyswitch -h  
Syntax for the Domain Shell  
setkeyswitch [-y|-n] [off|standby| on| diag| secure]  
setkeyswitch -h  
Options/ Parameters  
-hdisplays help for this command.  
-ydoes not prompt for confirmation.  
-ndoes not execute this command is confirmation is requested.  
-ddomainID (platform shell only) is the domain ID of the domain you want power  
off ( a, b, c, or d).  
Chapter 3 System Controller Alphabetical Command Reference  
 
71  
 
For setkeyswitch parameters and descriptions, see TABLE 3-8.  
TABLE 3-8  
Description of the setkeyswitchTransition  
Value  
Description  
off  
Changes the board state of all the boards belonging to a domain to the  
Assigned board status, and places the boards in low-power mode, which  
allows you to remove the boards from the system. The domain will not be  
initialized at system power on.  
standby  
on  
Changes the board state of all the boards belonging to a domain to the  
Assigned board state and turns on the boards. The domain will not be  
initialized at system power on, but the boards that comprise the domain will  
be powered on.  
Powers on and initializes the domain. The system controller brings the  
domain into OpenBoot PROM through POST. If the OpenBoot PROM has  
auto-boot?set to true, then the Solaris operating environment boots  
automatically.  
diag  
Similar to the setkeyswitch oncommand except the POST verbose mode  
is set to on and the POST diagnostic level is set to maximum.  
secure  
Similar to the setkeyswitch oncommand except that the breakcommand  
and the resetcommands are ignored. CPU/ Memory board and  
I/ O assembly flash PROM updates are not allowed.  
TABLE 3-9 shows the results when you change a keyswitch setting.  
TABLE 3-9  
Results of Changing the Keyswitch From the Current Setting to a New Setting  
Current Setting  
New Setting  
Result  
off  
off  
off  
Keyswitch position not changed.  
standby  
Powers on all of the boards. The boards belonging to a domain  
should already be in the Assigned state. The domain will not  
be initialized at system power on.  
off  
on  
Powers on and initializes the domain. The domain will go  
through POST and the OpenBoot PROM. The Solaris  
operating environment boots automatically unless you have  
set the OpenBoot PROM auto-boot?set to false.  
off  
off  
diag  
Similar to on, except POST verbose and diagnostic level is to  
set to maximum. The domain will boot from the  
diag-device.  
secure  
Similar to on, except the resetand breakcommands are  
ignored by the domain shell.  
72  
Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001  
 
   
TABLE 3-9  
Results of Changing the Keyswitch From the Current Setting to a New Setting  
(Continued)  
Current Setting  
New Setting  
Result  
standby  
off  
All boards will be powered off (set to low -power mode and  
all monitoring of the boards will stop). The domain is shut  
down.  
standby  
on  
on  
Similar to setting the virtual keyswitch from off to on except  
that you do not have to wait for the system controller to turn  
on the boards and prepare them.  
off  
All boards will be powered off (set to low -power mode and  
all monitoring of the boards will stop). The domain is shut  
down.  
on  
standby  
The domain becomes inactive. All of the boards remain  
powered on.  
on  
on  
on  
Keyswitch position not changed.  
diag  
Similar to the setkeyswitch oncommand except the POST  
verbose mode is set to on and the POST diagnostic level is set  
to maximum. This change is setting has no effect on a running  
domain.  
on  
secure  
off  
breakand resetare ignored.  
diag  
All boards will be powered off (set to low -power mode and  
all monitoring of the boards will stop). The domain is shut  
down.  
diag  
diag  
standby  
on  
The domain becomes inactive. All of the boards remain  
powered on.  
Has no effect on a running domain. This operation only  
changes the keyswitch position and does not perform any  
other function since the domain is already running.  
diag  
diag  
secure  
off  
Keyswitch position not changed.  
diag  
breakand resetare ignored.  
secure  
All boards will be powered off (set to low -power mode and  
all monitoring of the boards will stop). The domain is shut  
down.  
secure  
standby  
The domain becomes inactive. All of the boards remain  
powered on. The breakand resetcommands are no longer  
ignored.  
secure  
secure  
secure  
on  
breakand resetare not ignored.  
diag  
secure  
This change is setting has no effect on a running domain.  
Keyswitch position not changed.  
Chapter 3 System Controller Alphabetical Command Reference  
73  
 
Description  
Each domain has a virtual keyswitch with five positions: off, standby, on, diag, and  
secure. The setkeyswitchcommand changes the position of the virtual keyswitch  
to the specified value. The virtual keyswitch replaces the need for a physical  
keyswitch for each domain.  
If it is not possible to access the domain shell, set the keyswitch position for the  
domain to off from the platform shell. Setting the keyswitch position to off for a  
domain without first halting the Solaris operating environment may cause problems.  
If the domain is running the Solaris operating environment, the setkeyswitch  
command parameters offand standbyrequire confirmation.  
If the domain is already powered on, the setkeyswitchon, setkeyswitchdiag,  
and setkeyswitchsecurecommands will change only the position of the virtual  
keyswitch. If components making up a domain such as a I/ O assembly or  
CPU/ Memory board need to be powered on, the system attempts to power on these  
boards or devices also.  
When the keyswitch position changes to on, secure, or diag from any keyswitch  
position, the domain console is resumed.  
If a failure occurred during keyswitch transition, the keyswitch position is reset to  
offor standbyafter recovering from the failure.  
The system controller maintains the position of each keyswitch even during power  
failures or physical power cycles. When you power on the system after either a  
power failure or system power off, the system controller activates any domains that  
were active when the power went off.  
See Also  
resume, showkeyswitch  
Examples  
To turn the virtual keyswitch on and power on the domain (CODE EXAMPLE 3-43),  
type:  
CODE EXAMPLE 3-43 setkeyswitch onExample  
schostname:A> setkeyswitch on  
74  
Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001  
 
   
To shut down the domain by turning the virtual keyswitch off (CODE EXAMPLE 3-44),  
type:  
CODE EXAMPLE 3-44 setkeyswitch offExample  
schostname:A>setkeyswitch off  
To shut down domain B from the platform shell (CODE EXAMPLE 3-45), type:  
CODE EXAMPLE 3-45 setkeyswitch offExample Shutting Down Domain B From the  
Platform Shell  
schostname:SC>setkeyswitch -d b off  
Caution – CODE EXAMPLE 3-45 does not properly shut down the Solaris operating  
environment in the domain before turning the keyswitch in domain B to the off  
position.  
Chapter 3 System Controller Alphabetical Command Reference  
 
75  
   
setupdomain  
Configures the domain.  
Scope  
domain shell  
Syntax  
setupdomain [-p part]. . .  
setupdomain -h  
Options/ Parameters  
-hdisplays help for this command.  
-ppart configures the specified information and has the following options:  
bootparamsconfigures the boot parameter information.  
loghostconfigures the log hosts  
snmpconfigures SNMP information.  
TABLE 3-10 lists the parameter values for setupdomain. Note that for diag-level  
definition and function of defaultand maxare the same. Because the tests for mem1  
and mem2take a long time to run, use the defaultor maxvalues. However, if you  
suspect memory problems, then use the mem1or mem2values.  
TABLE 3-10 Parameter Values for the setupdomainCommand  
Parameter  
Value  
Description  
diag-level  
init  
Only system board initialization code is run. No  
testing is done. This is a very fast pass through  
POST.  
quick  
All system board components are tested using few  
tests with few test patterns.  
default(default value)  
All system board components are tested with all tests  
and test patterns, except for memory and Ecache  
modules. For memory and Ecache modules, all  
locations are tested with multiple patterns. More  
extensive, time-consuming algorithms are not run at  
this level. This is the same as max.  
76  
Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001  
 
   
TABLE 3-10 Parameter Values for the setupdomainCommand (Continued)  
Parameter  
Value  
Description  
max  
All system board components are tested with all tests  
and test patterns. This is the same as default.  
mem1  
mem2  
off  
Runs all tests at the default level plus more  
exhaustive DRAM and SRAM test algorithms. These  
tests take a long time to run.  
This is the same as mem1with the addition of a  
DRAM test that does explicit compare operations of  
the DRAM data. These tests take a long time to run.  
verbosity-level  
No status messages are displayed. POST output is  
always displayed. However, with the value set to  
off, there is very little POST output displayed and  
there may be a long time between output displays.  
This depends on your hardware configuration and  
the setting of diag-level.  
min(default value)  
Test names status messages, and error messages are  
displayed.  
max  
Subtest trace messages are displayed.  
No error messages are displayed.  
The failing test name is displayed.  
All relevant error status is displayed.  
error-level  
off  
min  
max(default value)  
within-cpu  
interleave-scope  
The memory banks on a CPU will be interleaved  
with each other. Each CPU may have up to four  
logical memory banks.  
within-board (default  
value)  
The memory banks on a system board will be  
interleaved with each other.  
across-boards  
The memory will be interleaved on all memory  
banks across all of the boards in the domain.  
With this value, you cannot remove a CPU/ Memory  
board from the system using DR.  
interleave-mode  
reboot-on-error  
optimal(default value)  
The memory is mixed-size interleaving in order to  
gain optimal performance.  
fixed  
The memory is fixed-size interleaving.  
There is no memory interleaving.  
off  
false(default value)  
The domain will be paused when the system  
controller detects a hardware error.  
Chapter 3 System Controller Alphabetical Command Reference  
 
77  
TABLE 3-10 Parameter Values for the setupdomainCommand (Continued)  
Parameter  
Value  
Description  
true  
The domain is rebooted when a hardware error is  
detected. If OBP.auto-boot?is set to true, the  
Solaris operating environment is booted.  
OBP.use-nvramrc?  
This parameter is the same as the OpenBoot PROM  
nvramrc?parameter. This parameter uses aliases  
that are stored in nvramrc.  
true  
The OpenBoot PROM executes the script stored in  
nvramrc if this parameter is set to true.  
false(default value)  
The OpenBoot PROM does not evaluate the script  
stored in nvramrc if this parameter is set to false.  
OBP.auto-boot?  
Controls booting of the Solaris operating  
environment.  
true(default value)  
If this value is true, the domain boots automatically  
after POST has run.  
false  
If this parameter value is set to false, you will obtain  
the OpenBoot PROM okprompt after POST runs,  
from which you must type a bootcommand to boot  
the Solaris operating environment.  
OBP.error-reset-  
recovery  
Controls the behavior of the domain after an  
externally initiated reset (XIR) as well as a red mode  
trap.  
sync(default value)  
The OpenBoot PROM invokes sync. A core file is  
generated. If the invocation returns, the OpenBoot  
PROM performs a reboot.  
none  
The OpenBoot PROM prints a message describing  
the reset trap that triggered the error reset and passes  
control to the OpenBoot PROM okprompt. The  
message describing the reset trap type is platform  
specific.  
boot  
The OpenBoot PROM firmware reboots the domain.  
A core file is not generated. Rebooting a domain  
occurs using the OpenBoot PROM settings for  
diag-deviceor boot-device, depending on the  
value of the OpenBoot PROM configuration variable  
diag-switch?  
If diag-switch?is set to true, the device names in  
diag-devicewill be the default for boot. If  
diag-switch?is set to false, the device names in  
boot-devicewill be the default for boot.  
78  
Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001  
 
TABLE 3-10 Parameter Values for the setupdomainCommand (Continued)  
Parameter  
Value  
Description  
Loghost  
The name or the IP address of the loghost for this  
domain (SNMP).  
Log Facility  
The log facility is defined by the Solaris operating  
environment syslogdin /etc/syslog.conf.  
The default is local0.  
Domain Description  
Enter a brief description for this domain. For  
example, its function.  
Enter the name of the primary domain administrator.  
Trap Hosts  
Enter the name or the IP address of the trap hosts for  
this domain. You can define multiple trap hosts.  
Public Community  
String  
Community string for SNMP readers. The default  
value is A-public, B-public, and so on.  
Note—For SNMP clients such as the Sun  
Management Center 3.0 software to access the  
system controller using SNMP, their community  
strings should be set to the same value as the value  
entered here.  
Private Community  
String  
Community string for readers and writers. The  
default value is A-private, B-private, and so on.  
Note—For SNMP clients such as the Sun  
Management Center 3.0 software to access the  
system controller using SNMP, their community  
strings should be set to the same value as the value  
entered here.  
Description  
Configures domain specific values. Configures the domain. You can configure each  
You are prompted for parameters to configure.  
See Also  
password, setdate, showdate, showdomain, and the section “To Configure  
Domain-Specific Parameters” in the “System Power On and Setup” chapter of the Sun  
Fire 6800/4810/4800/3800 Systems Platform Administration Manual.  
Chapter 3 System Controller Alphabetical Command Reference  
 
79  
 
Example  
CODE EXAMPLE 3-46 Variables for the setupdomainCommand  
schostname:A> setupdomain  
Domain Boot Parameters  
----------------  
diag-level [default]:  
verbosity-level [min]:  
error-level [max]:  
interleave-scope [within-board]:  
interleave-mode [optimal]:  
reboot-on-error [false]:  
OBP.use-nvramrc? [<OBP default>]:  
OBP.auto-boot? [<OBP default>]:  
OBP.error-reset-recovery [<OBP default>]:  
Log hosts  
---------  
Loghost [ ]:The hostname or the IP address of the loghost for this domain.  
Log Facility [local0]: Defined by the Solaris operating environment syslogd in /etc/syslog.conf.  
SNMP  
-----  
Domain Description[]: A brief description for this domain (its function).  
Domain Contact[ ]: The name of the primary domain administrator.  
Trap Hosts [ ]: The IP address of the loghost for this domain.  
Public Community String [ ]:The community string for SNMP readers.  
Private Community String [ ]: The community string for readers and writers.  
schostname:A>  
Note – The default value displayed by the software for the OBP.*parameters is  
<OBP default>.  
If you enter an invalid value, the system controller displays “invalid entry” and  
prompts you to enter a proper value (TABLE 3-10). If a value is not specified, it retains  
its current value. When an invalid entry is entered, it also lists the valid responses.  
Typing a dash ( - ), clears the entry.  
Current values are displayed in [ ]. TABLE 3-10 lists the setupdomainparameter  
values.  
80  
Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001  
 
 
setupplatform  
Configures the platform specific variables.  
Scope  
platform shell  
Syntax  
setupplatform [-ppart]. . .  
setupplatform -h  
Options/ Parameters  
-hdisplays help for this command.  
-ppart configures the specified part and has the following options:  
aclsis ACLs (Access Control List)  
-clears the boards from the ACL  
+adds all boards to the ACL  
-aboard adds a board  
-dboard deletes a board  
loghostconfigures loghost and facility with the default of local0. The loghost  
is the IP address or host name of the syslog loghost. The host name you enter  
must be a complete host name (not a partial one ).  
networkis the network settings.  
partitionsets the partition mode.  
scconfigures system controller behavior.  
snmpis SNMP configuration  
Chapter 3 System Controller Alphabetical Command Reference  
 
81  
 
Description  
Configures parameters for the platform. This command is an interactive command.  
You are prompted for parameters to configure. For parameters to configure, see  
TABLE 3-11.  
TABLE 3-11 setupplatformParameter Values  
Parameter  
Description  
Is the System Controller on a  
Network?  
If the answer is no, leave all network parameters as  
unconfigured. You will be prompted to enter the hostname. If  
the answer if yes, you are prompted to configure the network  
settings.  
Use DHCP or static network  
settings?  
DHCP means the system controller network configuration  
is retrieved from a DHCP server.  
Static means the network settings will be manually  
configured. If you select the static setting, you will be asked  
for the following network parameters.  
Hostname (Network parameter)  
The human readable network identity for this system  
controller.  
IP address (Network parameter)  
The network identity used by computers.  
Netmask (Network parameter)  
For this value, specify how much of the address should be  
reserved for subdividing networks into subnetworks. Must  
be specified in dot-notation address. For example  
255.255.255.0.  
Gateway (Network parameter)  
IP address of the gateway.  
DNS Domain (Network parameter)  
Domain name. For example, xxx.xxx.com.  
IP address of your primary DNS server.  
Primary DNS Server (Network  
parameter)  
Secondary DNS Server (Network  
IP address of your secondary DNS server.  
parameter)  
Loghost  
The name or the IP address of the loghost for this domain  
(SNMP).  
Log Facility  
The log facility. Facility is defined by the Solaris operating  
environment syslogdin /etc/syslog.conf.The default  
is local0.  
SNMP Agent?  
The SNMP agent enables or disables SNMP. The default is  
SNMP disabled.  
Platform Description  
Default value is the platform model name.  
82  
Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001  
 
 
TABLE 3-11 setupplatformParameter Values (Continued)  
Parameter  
Description  
Platform Contact  
Platform Location  
The name of the person who is responsible for this system.  
This name will be used by SNMP. Note that if SNMP is not  
going to be enabled, this field is informational only.  
Location of the system (such as a room and/ or the location  
inside of the room). This information will be used by SNMP.  
Note that if SNMP is not going to be enabled, this field is  
informational only.  
Trap Hosts  
IP address or name of the trap hosts (SNMP). You can define  
multiple trap hosts.  
Public Community String  
Community string for SNMP readers. The default is  
P-public.  
Note—For SNMP clients such as the Sun Management Center  
3.0 software to access the system controller using SNMP, their  
community strings should be set to the same value as the  
value entered here.  
Private Community String  
Community string for readers and writers. The default is  
P-private.  
Note—For SNMP clients such as the Sun Management Center  
3.0 software to access the system controller using SNMP, their  
community strings should be set to the same value as the  
value entered here.  
ACL for Domain A  
Access Control List (ACL). If the board name is listed in the  
ACL for the specific domain, then you have permission to  
perform addboardor deleteboardrequests on that board.  
Default value is to have all slots assigned to all domains.  
• Typing the prefix-ddeletes the slot from ACLs of this  
domain.  
• Typing a prefix of -a(add) adds a slot.  
• Typing a dash ( -) clears the entire list.  
• Typing a + (plus sign) adds all.  
• Pressing the Return key does not change the value  
displayed inside [ ].  
ACL for Domain B  
ACL for Domain C  
ACL for Domain D  
SC POST diag level  
See the description for ACL for Domain A.  
See the description for ACL for Domain A.  
See the description for ACL for Domain A.  
The system controller boot parameters (diag level) can be set  
to: off, min, or max.  
Only system board initialization code is run. No testing is  
done. POST is not run.  
off  
Chapter 3 System Controller Alphabetical Command Reference  
83  
 
TABLE 3-11 setupplatformParameter Values (Continued)  
Parameter  
Description  
All System Controller board components are tested using few  
locations with few test patterns.  
min  
max  
All System Controller board components are tested with all  
tests and test patterns.  
Configure platform for single or  
dual partition mode  
The two options are single or dual. The default is single. For  
a description of single and dual partition mode, refer to the  
Systems Platform Administration Manual.  
password, setdate, setupdomain, showdate, showdomain, showplatform, and  
the section “Setting Up the Platform” in the “System Power On and Setup” chapter  
of the Sun Fire 6800/4810/4800/3800 Systems Platform Administration Manual. This  
chapter describes a step-by-step procedure on setting up the platform using  
setupplatform.  
Example  
CODE EXAMPLE 3-47 setupplatformOutput  
schostname:SC> setupplatform  
Network Configuration  
---------------------  
Use DHCP or static network settings? [DHCP]:  
Network settings? [static]:  
Hostname []:  
IP Address []:  
Netmask []:  
Gateway []:  
DNS Domain []:  
Primary DNS Server []:  
Secondary DNS Server []:  
Loghosts  
--------  
Loghost [ ]:  
Log Facility [local0]:  
84  
Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001  
 
 
CODE EXAMPLE 3-47 setupplatformOutput (Continued)  
SNMP  
----  
Platform Description [Sun Fire 6800]:System type  
Platform Contact [ ]: Platform administrator’s name  
Platform Location [ ]: Geographic system location  
Enable SNMP Agent? [yes]:  
Trap Hosts []: SNMP trap host IP address or name  
Public Community String [P-public]:Community string for SNMP readers  
Private Community String [P-private]: Community string for readers and writers  
ACLs  
----  
ACL for domain A [SB0 SB1 SB2 SB3 SB4 SB5 IB6 IB7 IB8 IB9 ]:  
ACL for domain B [SB0 SB1 SB2 SB3 SB4 SB5 IB6 IB7 IB8 IB9 ]:  
ACL for domain C [SB0 SB1 SB2 SB3 SB4 SB5 IB6 IB7 IB8 IB9 ]:  
ACL for domain D [SB0 SB1 SB2 SB3 SB4 SB5 IB6 IB7 IB8 IB9 ]:  
SC POST  
-------  
SC POST diag Level [min]:  
Partition Mode  
--------------  
Configure platform for single or dual partition mode? [single]:  
schostname:SC>  
Chapter 3 System Controller Alphabetical Command Reference  
85  
 
showboards  
Displays the assignment information and status for all of components in the system.  
Scope  
platform shell, domain shell  
Syntax for the Platform Shell  
showboards [-ev] [-y| -n][ -ddomainID] [-ppart]  
showboards -h  
Syntax for the Domain Shell  
showboards [-aev] [-y|-n] [-ppart]  
showboards -h  
Options/ Parameters  
-ainclude available boards (domain only).  
-eincludes empty slots in the output.  
-vverbose mode.  
-ddomainID specify a domain to display (platform only).  
-ppart shows only a specific part and can be:  
boardshows the board status.  
clockshows the system clock status.  
cpushows CPU type, speed, and Ecache size.  
ioshows I/ O information.  
memoryshows memory information for each board.  
powershows grid information.  
versionshows version information.  
-yanswers yes to all questions.  
-nanswers no to all questions.  
-hdisplays help for this command.  
86  
Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001  
 
 
Description  
Displays the assignment information and status for all of the components in the  
system. For example, CPU/ Memory boards, I/ O assemblies, fan trays, and so on.  
For the domain shell, the display shows components assigned to the domain and can  
also include boards that are included in the ACL, and not assigned to any other  
domain.  
See Also  
addboard, deleteboard  
Examples—Platform Shell  
CODE EXAMPLE 3-48 showboardsCommand for the Platform Shell  
schostname:SC> showboards  
Slot  
----  
Pwr  
---  
Component Type  
--------------  
State  
-----  
Status  
------  
Domain  
------  
SSC0  
SSC1  
ID0  
PS0  
PS1  
PS2  
FT0  
FT1  
FT2  
FT3  
RP0  
RP2  
On  
-
System Controller  
Empty Slot  
Sun Fire 3800 Centerplane -  
A145 Power Supply  
A145 Power Supply  
A145 Power Supply  
Fan Tray  
Fan Tray  
Fan Tray  
Fan Tray  
Repeater Board (F3800)  
Repeater Board (F3800)  
CPU Board  
CPU Board  
CPCI I/O board (F3800)  
CPCI I/O board (F3800)  
-
-
Passed  
-
OK  
OK  
OK  
-
-
-
-
-
-
-
-
-
-
-
-
A
On  
On  
On  
On  
On  
On  
On  
On  
On  
On  
-
-
-
OK  
Low Speed OK  
Low Speed OK  
Low Speed OK  
Low Speed OK  
-
-
Active  
Assigned  
Active  
Assigned  
OK  
OK  
Passed  
Not tested C  
Passed  
Not tested C  
/N0/SB0 On  
/N0/SB2 Off  
/N0/IB6 On  
/N0/IB8 Off  
A
The showboards command with the -voption displays the verbose option.  
Chapter 3 System Controller Alphabetical Command Reference  
87  
 
   
TABLE 3-12 Output Header Definitions for the showboardsand the showboards -v  
Command  
Header  
Description  
Slot  
Slot designator. The Nx in the slot descriptor is the node number.  
Indicates if the power status of the device is off or on.  
Component description.  
Pwr  
Component type  
State  
Describes board state. Possible values are: Active, Assigned,  
Available and – (dash). The - board state means that the board state  
does not apply to this slot. For more information on board states,  
see “Board States for CPU/ Memory Boards and I/ O Assemblies”  
on page 6.  
Status  
Current board status. For more information on board status, see  
Board Test Status” on page 6.  
Domain  
Indicates which domain the board belongs to. For more information  
on domains, refer to the “Overview” chapter of the Sun Fire  
6800/4810/4800/3800 Systems Platform Administration Manual.  
Memory Information  
Component  
J-No  
Component, such as a board, CPU, or memory DIMM.  
Component label on the board.  
Size  
Lists the size of the DIMM.  
Reason  
Describes information why the value is not reported.  
Firmware Versions  
Component  
Device  
Board.  
Lists the specific flashPROM on the board.  
Type  
Provides the image type for the device. Describes what the image is  
used for. Each device can have multiple types.  
Version  
Date  
System controller version number.  
Date.  
Time  
Time of day.  
Clock Status  
Component  
SSCX Signal  
Signal Used  
Failover  
Board.  
Lists the status of the SSC0 or SS1 clock on the board.  
Defines which clock is used by the board.  
Describes if the board will respond to clock failover.  
88  
Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001  
 
 
TABLE 3-12 Output Header Definitions for the showboardsand the showboards -v  
Command (Continued)  
Header  
Description  
I/O Status  
Slot  
I/ O slot.  
Populated  
Defines if a card is installed in the slot.  
I/O Status (continued)  
Slot Description  
Describes the slot. The card type cannot be determined by the  
system controller. The card is determined by the Solaris operating  
environment.  
CPU Information  
CPU.  
Component  
Cpu Mask  
Description  
Lists the CPU version.  
Describes the CPU type, speed, and Ecache size.  
Power Grids  
Component  
Pwr  
Board.  
Describes if the board is on or off.  
Describes which power grid the board is in.  
Grid  
Example—Domain Shell  
CODE EXAMPLE 3-49 showboards -aCommand for the Domain Shell  
schostname:A> showboards -a  
Slot  
----  
Pwr Component Type  
--- --------------  
State  
------  
Active  
Available Not tested  
Passed  
Status  
------  
Passed  
Domain  
------  
A
Isolated  
A
/N0/SB0 On  
SB2 Off CPU Board  
/N0/IB6 On CPCI I/O Board (F3800)Active  
IB8 Off CPCI I/O Board (F3800)Available Not tested  
CPU Board  
Isolated  
Chapter 3 System Controller Alphabetical Command Reference  
 
89  
 
showcomponent  
Shows the state of a component.  
Scope  
platform shell, domain shell  
Syntax for the Platform Shell  
showcomponent [-v] [component] ...  
showcomponent [-v] [-ddomainID] ...  
showcomponent -h  
Syntax for the Domain Shell  
showcomponent [-v] [component] ...  
showcomponent -h  
Options/ Parameters  
-hdisplays help for this command. Includes component_name syntax.  
boardname for CPU/ Memory boards is SB0 - SB5 and for I/ O assemblies is IB6 - IB9.  
-d domainID is a, b, c, or d. Shows components assigned to the domain (platform  
only).  
Description  
Without options, this command shows the state of all components on a board. With  
one or more options described in the “Syntax” section, the output shows the state of  
one or more components on a board.  
Displays the components that have been blacklisted by the disablecomponent  
command or components that have been marked as failed when testing using the  
testboardcommand. For CPU/ Memory boards, this command provides  
information about CPUs, memory modules (DIMMs), and Ecache. This command  
displays logical memory bank size.  
90  
Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001  
 
 
See Also  
enablecomponent, disablecomponent, and the “Disable Component” section  
of the “Troubleshooting” chapter in the Sun Fire 6800/4810/4800/3800 Systems  
Platform Administration Manual for a step-by-step procedure on displaying a  
component.  
Examples  
CODE EXAMPLE 3-50 shows sample output for the showcomponentsb4command.  
The abbreviations for the Componentfield are:  
Nx  
Node name  
SBx CPU/ Memory board, where x is 0 – 5  
Px  
Bx  
Lx  
Port, where x is 0 – 3  
Physical memory bank, where x is 0 – 1  
Logical memory bank, where x is 0 – 3. There are two DIMMs per  
logical memory bank.  
CODE EXAMPLE 3-50 showcomponent sb4 Sample Output  
schostname:SC> showcomponent sb4  
Component  
--------  
Status  
------  
Pending POST  
------- ----  
Description  
-----------  
/NO/SB4/P0  
/NO/SB4/P1  
/NO/SB4/P2  
/NO/SB4/P3  
enabled -  
enabled -  
enabled -  
enabled -  
pass  
pass  
pass  
pass  
pass  
pass  
pass  
pass  
pass  
pass  
pass  
pass  
pass  
pass  
pass  
pass  
pass  
pass  
UltraSPARC III+,750Mhz, 8M ECache  
UltraSPARC III+,750Mhz, 8M ECache  
UltraSPARC III+,750Mhz, 8M ECache  
UltraSPARC III+,750Mhz, 8M ECache  
256M DRAM  
256M DRAM  
256M DRAM  
256M DRAM  
256M DRAM  
256M DRAM  
256M DRAM  
256M DRAM  
256M DRAM  
256M DRAM  
256M DRAM  
256M DRAM  
256M DRAM  
/NO/SB4/P0/B0/L0 enabled -  
/NO/SB4/P0/B0/L2 enabled -  
/NO/SB4/P0/B1/L1 enabled -  
/NO/SB4/P0/B1/L3 enabled -  
/NO/SB4/P1/B0/L0 enabled -  
/NO/SB4/P1/B0/L2 enabled -  
/NO/SB4/P1/B1/L1 enabled -  
/NO/SB4/P1/B1/L3 enabled -  
/NO/SB4/P2/B0/L0 enabled -  
/NO/SB4/P2/B0/L2 enabled -  
/NO/SB4/P2/B1/L1 enabled -  
/NO/SB4/P2/B1/L3 enabled -  
/NO/SB4/P3/B0/L0 enabled -  
/NO/SB4/P3/B0/L2 enabled -  
256M DRAM  
Chapter 3 System Controller Alphabetical Command Reference  
 
91  
 
CODE EXAMPLE 3-50 showcomponent sb4 Sample Output (Continued)  
/NO/SB4/P3/B1/L1 enabled -  
/NO/SB4/P3/B1/L3 enabled -  
pass  
pass  
256M DRAM  
256M DRAM  
Definitions of the headings in CODE EXAMPLE 3-50 and CODE EXAMPLE 3-51 follow:  
Componentis the name of the board and its components.  
Statusis the status of the board or component.  
Pendingmeans that the component will change to the indicated status  
(enabled or disabled) at the next reboot.  
POSTis the status of POST (passed or failed).  
Descriptionis a description of the board or component.  
CODE EXAMPLE 3-51 shows sample output for the showcomponent ib6 command.  
The abbreviations for the Component field are:  
Nx  
Node name  
IBx I/ O assembly, where x is 6 – 9  
Px  
Bx  
Cx  
Port, where x is 0 – 1  
Bus, where x is 0 – 1  
Card in the I/ O assembly, where x is 0 – 7.  
CODE EXAMPLE 3-51 showcomponent ib6 Sample Output  
schostname:SC> showcomponent ib6  
Component  
Status  
Pending POST  
Description  
---------  
------- ------- ----  
-----------  
/N0/IB6/P0  
/N0/IB6/P1  
/N0/IB6/P0/B1  
/N0/IB6/P0/B0  
/N0/IB6/P0/B1/C0 enabled -  
/N0/IB6/P0/B1/C1 enabled -  
/N0/IB6/P0/B1/C2 enabled -  
/N0/IB6/P0/B1/C3 enabled -  
enabled -  
enabled -  
enabled -  
enabled -  
pass  
pass  
IO controller 0  
IO controller 1  
66/33MHz PCI Bus  
33MHz PCI Bus  
33MHz 5V Short PCI card  
33MHz 5V Short PCI card  
33MHz 5V Long/Short PCI card  
33MHz 5V Long/Short PCI card  
untest  
untest  
untest  
untest  
untest  
untest  
92  
Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001  
 
 
showdate  
Displays the date and time.  
Scope  
platform shell, domain shell  
Syntax for the Platform Shell  
showdate [-tv]  
showdate -h  
showdate [-v] [-d domainID]  
Syntax for the Domain Shell  
showdate [-tv]  
showdate -h  
Options/ Parameters  
-hdisplays help for this command.  
-tlists available time zones.  
-vis verbose mode.  
-d domainID is a, b, c, or d. Shows the date for the domain from the platform.  
Description  
Displays the current date and time for the platform and for each domain. You can  
obtain the date for the platform shell and each domain shell from the platform shell.  
If you type the command from one of the domain shells, the date and time for the  
current domain is returned.  
Chapter 3 System Controller Alphabetical Command Reference  
 
93  
 
See Also  
setdate  
Example—Platform Shell  
CODE EXAMPLE 3-52 showdateCommand for the Platform Shell  
schostname:SC>showdate  
Mon Apr 03 12:31:40 EDT 2001  
94  
Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001  
 
 
showdomain  
Displays the configuration and status of the domain.  
Scope  
domain shell  
Syntax  
showdomain[-v] [-ppart]. . .  
showdomain -h  
Options/ Parameters  
-v is verbose mode.  
-ppart is a parameter for the information to display:  
acls shows the ACLs (Access Control List)  
bootparamsshows boot parameter information  
loghostsshows the log hosts  
macshows MAC addresses  
snmpshows SNMP configuration  
statusshows domain status  
-hdisplays help for this command.  
Description  
Displays the configuration and status of the domain. Some of the information is not  
configurable, such as the MAC address and hostID, or is configurable in the  
platform, such as the Access Control List (ACL), and SNMP enabled. This command  
without any arguments displays all the parameter values configured by the  
setupdomaincommand.  
See Also  
setupdomain, showdate, setupplatform, showplatform  
Chapter 3 System Controller Alphabetical Command Reference  
 
95  
 
Examples  
To display parameters assigned by the setupdomaincommand, type showdomain  
(CODE EXAMPLE 3-53).  
CODE EXAMPLE 3-53 showdomain Command Example  
schostname:A> showdomain  
Domain Solaris Nodename Domain Status Keyswitch  
------ ---------------- ------------- ---------  
A
-
Powered Off  
off  
diag-level = default  
verbosity-level = min  
error-level = max  
interleave-scope = within-board  
interleave-mode = optimal  
reboot-on-error = true  
OBP.use-nvramrc? = <OBP default>  
OBP.auto-boot? = <OBP default>  
OBP.error-reset-recovery = <OBP default>  
Loghost for Domain A:  
Log Facility for Domain A: local0  
SNMP Agent: enabled  
Domain Description:  
Domain Contact:  
Trap Hosts:  
Public Community String:  
Private Community String:  
ACL for Domain A: SB0 SB1 SB2 SB3 SB4 SB5 IB6 IB7 IB8 IB9  
schostname:A>  
96  
Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001  
 
 
To display the verbose output of parameters assigned by the setupdomain  
command, type showdomain-v(CODE EXAMPLE 3-54).  
CODE EXAMPLE 3-54 showdomain -v Command Example  
schostname:A> showdomain -v  
Domain Solaris Nodename Domain Status Keyswitch  
------ ---------------- ------------- ---------  
A
-
Powered Off  
off  
Domain Boot Parameters  
----------------------  
diag-level = default  
verbosity-level = min  
error-level = max  
interleave-scope = within-board  
interleave-mode = optimal  
reboot-on-error = false  
OBP.use-nvramrc? = <OBP default>  
OBP.auto-boot? = <OBP default>  
OBP.error-reset-recovery = <OBP default>  
MAC Address  
----------  
xx:xx:xx:xx:xx:xx  
HostID  
-----  
xxxxxxxx  
Domain A  
Loghosts  
--------  
Loghost for Domain A:  
Log Facility for Domain A: local0  
SNMP  
----  
SNMP Agent: enabled  
Domain Description:  
Domain Contact:  
Trap Hosts:  
Public Community String:  
Private Community String:  
SNMP packets received: 0  
SNMP packets sent: 0  
SNMP traps sent: 0  
Chapter 3 System Controller Alphabetical Command Reference  
 
97  
 
CODE EXAMPLE 3-54 showdomain -v Command Example (Continued)  
ACLs  
----  
ACL for Domain A: SB0 SB1 SB2 SB3 SB4 SB5 IB6 IB7 IB8 IB9  
schostname:A>  
To display boot parameter information (CODE EXAMPLE 3-55), type:  
CODE EXAMPLE 3-55 showdomain -p bootparamsExample Displaying Boot Parameter  
Information  
schostname:A> showdomain -p bootparams  
diag-level = default  
verbosity-level = min  
error-level = max  
interleave-scope = within-board  
interleave-mode = optimal  
reboot-on-error = false  
OBP.use-nvramrc? =<OBP default>  
OBP.auto-boot? = <OBP default>  
OBP.error-reset-recovery = <OBP default>  
schostname:A>  
98  
Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001  
 
 
showenvironment  
Displays the current environmental status, temperatures, currents, voltages, and fan  
status, for the system (platform shell) or the current domain (domain shell).  
Scope  
platform shell, domain shell  
Syntax for the Platform Shell  
showenvironment [-ltvuw] [-d domainID] [-ppart]  
showenvironment [-ltvuw] board_name  
showenvironment -h  
Syntax for the Domain Shell  
showenvironment [-ltvuw] [-ppart]  
showenvironment [-ltvuw] board_name [board_name . . . ]  
showenvironment -h  
Options/ Parameters  
board_name is the name of the board. Displays information for this board. You can  
type multiple board names.  
-d domainID is a, b, c, or d. Displays information for boards assigned to that  
domain.  
-hdisplays help for this command.  
-ldisplays the limits that apply to each selected measurement. These values are the  
threshold for each measurement. Exceeding the threshold causes the status to  
display Maxor Min.  
Chapter 3 System Controller Alphabetical Command Reference  
 
99  
   
-ppart shows a specific part (TABLE 3-13):  
TABLE 3-13 Parts for showenvironment -ppart  
Report  
currents  
fans  
Description  
Displays currents (power supplies only)  
Displays fan states.  
faults  
Displays values that are suspected to be invalid.  
Displays temperatures only.  
Displays voltages only.  
temps  
voltage  
-tprints header titles.  
-uupdates data now. Polls all sensors for new values.  
-vis verbose mode. This is the equivalent of the options -land -w.  
-wshows warning thresholds.  
Description  
Displays the current environmental status, temperatures, currents, voltages, and fan  
status for the system (platform shell) or the current domain (domain shell). In a  
domain shell, the domain can only display boards that have been assigned to the  
domain, such as CPU/ Memory boards and I/ O assemblies. The board(s) must be  
powered on. Boards that are not powered on are not monitored and have no  
This command displays the minimum and maximum values. If these values are  
exceeded, the component (and the domain using the component) will be shut down.  
It also shows the warning levels when the system controllers warns you that you are  
approaching the limits.  
TABLE 3-14 describes the showenvironmentoutput headers and values.  
TABLE 3-14 showenvironmentOutput Header Description  
Header  
Slot  
Value  
Description  
Slot ID  
Device  
Sensor  
Device being monitored by the sensor.  
Component that measures the environmental  
data of the device.  
100 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001  
 
     
TABLE 3-14 showenvironmentOutput Header Description (Continued)  
Header  
Value  
Units  
Value  
Description  
Value returned by the sensor.  
Applicable unit for the sensor.  
Degrees C  
Volts DC  
Amps  
Celsius  
Volts  
Amps  
Age  
Age in seconds of the reading being displayed.  
Status  
Values for Status. See the Value column. When  
the values listed in the Value column are  
exceeded, a warning message will be logged.  
WARNING LOW  
NOTICE Low  
OK  
NOTICE High  
WARNING HIGH  
error  
failed  
ignored  
unavailable  
LoWarn  
HiWarn  
Min  
Displayed only with the -vand -woptions.  
Lists values that when exceeded a warning  
message will be logged.  
Displayed only with the -vand -woptions.  
Lists values that when exceeded a warning  
message will be logged  
Displayed with the -vand -loptions. This is  
not a warning message. Min is when the  
component will be powered off (including any  
domains using it) to protect it.  
Max  
Displayed with the -vand -loptions. This is  
not a fault condition. Max is when the  
component will be powered off (including any  
domains using it) to protect it.  
Chapter 3 System Controller Alphabetical Command Reference  
 
101  
Example  
The showenvironmentcommand display for the platform shell returns information  
on the slot number, device, sensor, value, units, age, and status, as shown in  
CODE EXAMPLE 3-56.  
CODE EXAMPLE 3-56 showenvironmentPlatform Shell and Domain Shell Example  
md6-sc0:SC> showenvironment  
Slot  
----  
SSC0  
SSC0  
SSC0  
SSC0  
SSC0  
SSC0  
SSC0  
SSC0  
RP0  
RP0  
RP0  
RP0  
RP0  
RP0  
RP2  
RP2  
RP2  
RP2  
RP2  
RP2  
PS0  
PS0  
PS0  
PS0  
PS0  
PS1  
PS1  
PS1  
PS1  
PS1  
PS2  
PS2  
PS2  
PS2  
PS2  
FT0  
Device  
---------  
SBBC 0  
Sensor  
---------  
Temp. 0  
Temp. 0  
Temp. 0  
Value  
------  
38  
48  
27  
Units  
------  
Age  
---  
Status  
------  
Degrees C 2 sec OK  
Degrees C 2 sec OK  
Degrees C 2 sec OK  
Degrees C 2 sec OK  
Degrees C 2 sec OK  
Volts DC  
Volts DC  
Volts DC  
Volts DC  
3Volts DC 5 sec OK  
Degrees C 5 sec OK  
Degrees C 5 sec OK  
Degrees C 5 sec OK  
Degrees C 5sec  
Volts DC  
Volts DC  
Degrees C 5 sec OK  
Degrees C 5 sec OK  
Degrees C 5sec  
Degrees C 5 sec OK  
Amps 2 sec OK  
Degrees C 2 sec OK  
CBH 0  
Board 0  
Board 0  
Board 0  
Board 0  
Board 0  
Board 0  
Board 0  
Board 0  
Board 0  
Board 0  
SDC 0  
Temp. 1  
Temp. 2  
27  
27  
1.5 VDC 0  
3.3 VDC 0  
5 VDC 0  
1.5 VDC 0  
3.3 VDC 0  
Temp. 0  
Temp. 1  
Temp. 0  
Temp. 0  
1.5 VDC 0  
3.3 VDC 0  
Temp. 0  
Temp. 1  
Temp. 0  
Temp. 0  
Current 0  
Temp. 0  
Current 0  
48 VDC 0  
48 VDC 0  
Current 0  
Temp. 0  
Current 0  
48 VDC 0  
48 VDC 0  
Current 0  
Temp. 0  
1.49  
3.35  
5.01  
1.49  
3.37  
23  
22  
56  
49  
1.49  
3.37  
22  
23  
61  
49  
3.94  
25  
0.18  
55.28  
56.59  
4.05  
25  
0.16  
55.28  
56.33  
4.88  
27  
2 sec OK  
2 sec OK  
2 sec OK  
5 sec OK  
AR 0  
OK  
Board 0  
Board 0  
Board 0  
Board 0  
SDC 0  
5 sec OK  
5 sec OK  
OK  
AR 0  
48 VDC 0  
48 VDC 0  
48 VDC 1  
48 VDC 1  
48 VDC 0  
48 VDC 0  
48 VDC 0  
48 VDC 1  
48 VDC 1  
48 VDC 0  
48 VDC 0  
48 VDC 0  
48 VDC 1  
48 VDC 1  
48 VDC 0  
Fan 0  
Amps  
2 sec OK  
2 sec OK  
2 sec OK  
2 sec OK  
Volts DC  
Volts DC  
Amps  
Degrees C 2 sec OK  
Amps  
Volts DC  
Volts DC  
Amps  
Degrees C 1 sec OK  
Amps  
2 sec OK  
2 sec OK  
2 sec OK  
1 sec OK  
Current 0  
48 VDC 0  
48 VDC 0  
Cooling 0  
0.88  
55.0  
56.07  
1 sec OK  
2 sec OK  
2 sec OK  
1 sec OK  
Volts DC  
Volts DC  
Low  
102 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001  
 
 
CODE EXAMPLE 3-56 showenvironmentPlatform Shell and Domain Shell Example (Continued)  
FT1  
FT2  
IB8  
IB8  
IB8  
IB8  
IB8  
IB8  
IB8  
IB8  
IB8  
IB8  
IB8  
SB0  
SB0  
SB0  
SB0  
SB0  
SB0  
SB0  
SB0  
SB0  
SB0  
SB0  
SB0  
SB0  
SB0  
SB0  
SB0  
SB0  
SB0  
IB6  
IB6  
IB6  
IB6  
IB6  
IB6  
IB6  
IB6  
IB6  
IB6  
IB6  
Fan 0  
Fan 0  
Cooling 0  
Cooling 0  
1.5 VDC 0  
3.3 VDC 0  
5 VDC 0  
12 VDC 0  
Temp. 0  
Temp. 1  
Temp. 0  
Temp. 0  
Temp. 0  
Temp. 0  
Temp. 1  
1.5 VDC 0  
3.3 VDC 0  
Temp. 0  
Temp. 0  
Temp. 0  
Temp. 0  
Temp. 1  
Temp. 0  
1.8 VDC 0  
Temp. 0  
1.8 VDC 1  
Temp. 0  
Temp. 2  
Temp. 3  
Temp. 0  
1.8 VDC 0  
Temp. 0  
1.8 VDC 1  
1.5 VDC 0  
3.3 VDC 0  
5 VDC 0  
12 VDC 0  
Temp. 0  
Temp. 1  
Temp. 0  
Temp. 0  
Temp. 0  
Temp. 0  
Temp. 1  
Low  
Low  
1 sec OK  
7 sec OK  
4 sec OK  
5 sec OK  
5 sec OK  
5 sec  
Board 0  
Board 0  
Board 0  
Board 0  
Board 0  
Board 0  
SDC 0  
1.51  
3.35  
4.98  
12.11  
30  
24  
53  
43  
41  
41  
37  
1.50  
3.33  
52  
43  
44  
22  
22  
35  
1.71  
34  
1.72  
39  
23  
23  
34  
1.72  
36  
1.72  
1.51  
3.35  
4.95  
12.11  
28  
23  
49  
45  
41  
Volts DC  
Volts DC  
Volts DC  
Volts DC  
Degrees C 5 sec OK  
Degrees C 5 sec OK  
Degrees C 5 sec OK  
Degrees C 5 sec OK  
Degrees C 5 sec OK  
Degrees C 5sec  
Degrees C 5 sec OK  
Volts DC  
Volts DC  
Degrees C 6 sec OK  
Degrees C 6 sec OK  
Degrees C 6 sec OK  
Degrees C 6 sec OK  
Degrees C 6 sec OK  
Degrees C 7 sec OK  
Volts DC  
Degrees C 7 sec OK  
Volts DC 7 sec OK  
Degrees C 7 sec OK  
Degrees C 7 sec OK  
Degrees C 7 sec OK  
Degrees C 7 sec OK  
AR 0  
SBBC 0  
IOASIC 0  
IOASIC 1  
Board 0  
Board 0  
SDC 0  
OK  
6 sec OK  
6 sec OK  
AR 0  
SBBC 0  
Board 1  
Board 1  
Cheetah 0  
Cheetah 0  
Cheetah 1  
Cheetah 1  
SBBC 1  
Board 1  
Board 1  
Cheetah 2  
Cheetah 2  
Cheetah 3  
Cheetah 3  
Board 0  
Board 0  
Board 0  
Board 0  
Board 0  
Board 0  
SDC 0  
7 sec OK  
Volts DC  
Degrees C 7 sec OK  
7 sec OK  
Volts DC  
Volts DC  
Volts DC  
Volts DC  
Volts DC  
Degrees C 7 sec OK  
Degrees C 7 sec OK  
Degrees C 7 sec OK  
Degrees C 7 sec OK  
Degrees C 7 sec OK  
Degrees C 7 sec OK  
Degrees C 7 sec OK  
7 sec OK  
7 sec OK  
7 sec OK  
7 sec OK  
7 sec OK  
AR 0  
SBBC 0  
IOASIC 0  
IOASIC 1  
39  
34  
Chapter 3 System Controller Alphabetical Command Reference  
 
103  
showkeyswitch  
Displays the keyswitch setting.  
Scope  
platform shell, domain shell  
Syntax for the Platform Shell  
showkeyswitch [-v] -ddomainID  
showkeyswitch -h  
Syntax for the Domain Shell  
showkeyswitch [-v]  
showkeyswitch -h  
Options/ Parameters  
-hdisplays help for this command.  
-vis verbose mode.  
-ddomainID (platform shell only) is a, b, c, or d.  
See Also  
setkeyswitch, showdomain, showplatform  
Description  
Displays the keyswitch setting.  
104 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001  
 
 
Examples  
CODE EXAMPLE 3-57 showkeyswitchExample Showing the Keyswitch Set to On  
schostname:A> showkeyswitch  
keyswitch is: on  
CODE EXAMPLE 3-58 showkeyswitchExample Showing the Keyswitch Set to Off  
schostname:A> showkeyswitch  
keyswitch is: off  
CODE EXAMPLE 3-59 showkeyswitchExample Showing the Keyswitch Set to Standby  
schostname:A> showkeyswitch  
keyswitch is: standby  
Chapter 3 System Controller Alphabetical Command Reference  
105  
 
     
showlogs  
Displays the system controller logged events stored in the system controller message  
buffer.  
Scope  
platform shell, domain shell  
Syntax for the Platform Shell  
showlogs [-ddomain ID] [-v]  
showlogs -h  
Syntax for the Domain Shell  
showlogs [-v]  
showlogs -h  
Options/ Parameters  
-h displays help for this command.  
-ddomainID (platform shell only) specifies a domain (a, b, c, or d).  
-v is verbose.  
Description  
Displays the messages that are stored in the message buffer. Each domain and the  
platform have separate and independent buffers. Once a buffer is filled, the old  
messages are overwritten. These are messages from the system controller (not the  
Solaris operating environment) that are logged to the consoles. This is a small buffer  
and it is cleared when you reboot the system controller or when it loses power.  
There is a separate log for the platform and for each domain. If the loghost has been  
configured (the platform and each domain are configured separately—using  
setupplatformfor the platform loghost and setupdomainfor each domain  
106 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001  
 
   
loghost), then the messages will also be logged to the loghost for storage. Note that  
storing the messages is only temporary and will not survive a system reboot or a  
loss in power.  
See Also  
setupdomain, setupplatform, showdomain, showplatform  
Example  
CODE EXAMPLE 3-60 displays the output of the showlogscommand, run at the  
platform shell after rebooting the system.  
CODE EXAMPLE 3-60 Sample Output of the showlogsCommand Run After Rebooting the System  
schostname:SC> showlogs  
May 09 13:36:21 sp4-sc0 Platform.SC: [ID 506094 local0.notice] Boot: ScApp  
5.12.5, RTOS 17  
May 09 13:36:37 sp4-sc0 Platform.SC: [ID 595276 local0.notice] Clock Source:  
75MHz  
May 09 13:36:50 sp4-sc0 Platform.SC: [ID 223289 local0.notice] Master System  
Controller  
May 09 13:38:30 sp4-sc0 Platform.SC: [ID 588369 local0.notice] Starting SNMP  
agent.  
Chapter 3 System Controller Alphabetical Command Reference  
 
107  
 
showplatform  
Displays the configuration and information for the platform and domain status.  
Scope  
platform shell  
Syntax  
showplatform [-v] [-d domainID] [-p part]  
showplatform [-p part]  
showplatform -h  
Options/ Parameters  
-h displays help for this command.  
-ddomainID specifies a domain to show (a, b, c, or d).  
-ppart domainID displays information on a specific part. Use the options in this list  
when you specify a domain with the -doption. These options are the same as the  
-ppart options to showdomain.  
where:  
acls shows the Access Control List (ACL).  
bootparamsshows boot parameter information.  
loghostsshows the log hosts for the domain.  
macshows MAC addresses for the domain.  
snmpshows SNMP configuration for the domain.  
statusshows domain status.  
-ppart displays information on a specific part. Use the options to -ppart when you  
do not specify a domain with the -doption.  
where:  
aclsshows the Access Control List (ACL).  
frameshows FrameManager information.  
logshows log hosts for the platform.  
macshows the mac addresses, hostID, and the platform a serial number for the  
domain and the system controllers.  
networkdisplays the network settings.  
partitionshows the partition mode.  
108 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001  
 
 
scshows the system controller configuration.  
snmpshows snmp information for the platform.  
statusshows domain status for all domains.  
-vis verbose mode.  
Description  
This command displays all configuration variables for this platform, including:  
Network attributes of the platform  
ACLs for each domain  
Domain status  
SNMP status  
Loghosts  
Partition configuration  
Other values that are used but are not configurable such as the MAC address,  
host ID, and system serial number  
See Also  
setupplatform, showdate  
Example  
CODE EXAMPLE 3-61 showplatform Output for a Sun Fire 6800 System  
schostname:SC> showplatform  
Domain Solaris Nodename Domain Status Keyswitch  
------ ---------------- ------------- ---------  
A
B
C
D
-
-
-
-
Powered Off  
Powered Off  
Powered Off  
Powered Off  
off  
standby  
off  
off  
The system controller is configured to be on a network.  
Network settings: DHCP  
Hostname: schostname  
IP Address: xxx.xxx.xxx.xx  
Netmask: xxx.xxx.xxx.x  
Gateway: xxx.xxx.xxx.xxx  
Chapter 3 System Controller Alphabetical Command Reference  
109  
 
 
CODE EXAMPLE 3-61 showplatform Output for a Sun Fire 6800 System (Continued)  
DNS Domain: domainname  
Primary DNS Server: xxx.xxx.x.xxx  
Secondary DNS Server: xxx.xxx.x.xxx  
Loghost for Platform:  
Log Facility for Platform:local0  
SNMP Agent: enabled  
Chassis Description: Sun Fire 6800  
Chassis Contact:  
Chassis Location:  
Trap Hosts:  
Public Community String: P-public  
Private Community String: P-private  
ACL for Domain A: SB0 SB1 SB2 SB3 SB4 SB5 IB6 IB7 IB8 IB9  
ACL for Domain B: SB0 SB1 SB2 SB3 SB4 SB5 IB6 IB7 IB8 IB9  
ACL for Domain C: SB0 SB1 SB2 SB3 SB4 SB5 IB6 IB7 IB8 IB9  
ACL for Domain D: SB0 SB1 SB2 SB3 SB4 SB5 IB6 IB7 IB8 IB9  
SC POST diag Level: off  
Chassis is in dual partition mode.  
schostname:SC>  
CODE EXAMPLE 3-62 shows the showplatform -vcommand output.  
CODE EXAMPLE 3-62 showplatform -v Output for a Sun Fire 6800 System  
schostname:SC> showplatform -v  
Domain Solaris Nodename Domain Status Keyswitch  
------ ---------------- ------------- ---------  
A
B
C
D
-
-
-
-
Powered Off  
Powered Off  
Powered Off  
Powered Off  
off  
off  
off  
off  
Network  
-------  
The system controller is configured to be on a network.  
Network settings: DHCP  
Hostname: schostname  
IP Address: xxx.xxx.xxx.xx  
110 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001  
 
 
CODE EXAMPLE 3-62 showplatform -v Output for a Sun Fire 6800 System (Continued)  
Netmask: xxx.xxx.xxx.x  
Gateway: xxx.xxx.xxx.xxx  
DNS Domain: domainname  
Primary DNS Server: xxx.xxx.x.xxx  
Secondary DNS Server: xxx.xxx.x.xxx  
MAC Address  
-----------  
xx:xx:xx:xx:xx:xx  
xx:xx:xx:xx:xx:xx  
xx:xx:xx:xx:xx:xx  
xx:xx:xx:xx:xx:xx  
xx:xx:xx:xx:xx:xx  
xx:xx:xx:xx:xx:xx  
HostID  
------  
xxxxxxxx  
xxxxxxxx  
xxxxxxxx  
xxxxxxxx  
xxxxxxxx  
xxxxxxxx  
Domain A  
Domain B  
Domain C  
Domain D  
SSC0  
SSC1  
System Serial Number: xxxxxxxx  
Loghosts  
--------  
Loghost for Platform:  
Log Facility for Platform: local0  
SNMP  
----  
SNMP Agent: enabled  
Chassis Description: Sun Fire 6800  
Chassis Contact:  
Chassis Location:  
Trap Hosts:  
Public Community String: P-public  
Private Community String: P-private  
SNMP packets received:x  
SNMP packets sent:xxx  
SNMP traps sent: xxx  
ACLs  
----  
ACL for Domain A: SB0 SB1 SB2 SB3 SB4 SB5 IB6 IB7 IB8 IB9  
ACL for Domain B: SB0 SB1 SB2 SB3 SB4 SB5 IB6 IB7 IB8 IB9  
ACL for Domain C: SB0 SB1 SB2 SB3 SB4 SB5 IB6 IB7 IB8 IB9  
ACL for Domain D: SB0 SB1 SB2 SB3 SB4 SB5 IB6 IB7 IB8 IB9  
SC POST  
-----  
SC POST diag Level: min  
Chapter 3 System Controller Alphabetical Command Reference  
111  
 
CODE EXAMPLE 3-62 showplatform -v Output for a Sun Fire 6800 System (Continued)  
Partition Mode  
--------------  
Chassis is in dual partition mode.  
Frame information is not available.  
schostname:SC>  
In CODE EXAMPLE 3-61 and CODE EXAMPLE 3-62, the Domain Status header has the  
following possible states:  
Powered Off  
Standby  
Running POST  
Active  
Active - OpenBoot PROM  
Active - Booting  
Active - Solaris  
Active - Halted  
Active - Reset  
Active - Panicking  
Active - Debugger  
Not Responding  
Paused due to an error  
For a description of these states, see “Domain Status” on page 7.  
112 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001  
 
showresetstate  
Shows that state of CPUs after a reset or a RED MODE trap.  
Scope  
domain shell  
Syntax  
showresetstate [-w | -s | -v]  
Options/ Parameters  
-wdisplays the contents of register windows. The first windows displayed in the  
output are the stack trace for the failing CPU. The windows that are not part of the  
stack trace follow in the same order.  
-sdisplays the contents of the secondary save area. Normally, the command  
displays the contents of the primary save area that holds the registers from the time  
of the first failure. If more than one failure occurs on a CPU, the secondary save area  
holds the selected registers from the time of the last failure.  
-vdisplays a summary of all available registers. Includes the registers available  
with:  
-sand -woptions  
Default display (no options)  
Description  
Prints a summary report of the contents of registers from the save areas of every  
CPU in the domain that has a valid saved state. By specifying certain options, the  
format and content of the printed report can be controlled.  
With no options, the command displays the following registers:  
Register window (globals, outs, locals, ins) that was current at the time of the  
failure.  
CANSAVE, CANRESTORE, OTHERWIN, and other selected privileged registers.  
AFARand AFSR.  
TICKand some related CPU-specific registers.  
Chapter 3 System Controller Alphabetical Command Reference  
 
113  
 
Since a CPU that does not have a saved state does not produce output, there is no  
output when CPUs are reset or have not failed. After a failure, the saved state is  
available until the domain restarts the OpenBoot PROM, either by rebooting the  
Solaris operating environment or by turning the virtual keyswitch from off to on.  
See Also  
reset  
114 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001  
 
showsc  
Shows the system controller version and uptime.  
Scope  
platform shell  
Syntax  
showsc [-v]  
showsc -h  
Options/ Parameters  
-h displays help for this command.  
-vis verbose mode.  
Description  
Shows the system controller version and uptime.  
Example  
CODE EXAMPLE 3-63 showscCommand  
schostname:SC> showsc  
SC: SSC0  
SC date: Wed May 09 15:06:22 PDT 2001  
SC uptime: 1 hour 30 minutes 11 seconds  
ScApp version: 5.12.5  
RTOS version: 17  
RTOSis the Real Time Operating System for the system controller and ScAppis the  
system controller application.  
Chapter 3 System Controller Alphabetical Command Reference  
 
115  
     
testboard  
Tests the CPU/ Memory board.  
Scope  
platform shell, domain shell  
Syntax  
testboard board_name  
testboard -h  
Options/ Parameters  
-h displays help for this command.  
board_name is sb0-sb5 for CPU/ Memory boards.  
Description  
Tests the CPU/ Memory board name specified on the command line. This board  
cannot be used in an active domain and must be powered on. If running from a  
domain, the board must be assigned to the domain. The Repeater boards required to  
run the domain must also be powered on.  
The testboardcommand runs tests at the levels set in the domain. Testing a  
CPU/ Memory board is most accurately done when it is part of a domain. It is best if  
the CPU/ Memory board can be tested by POST. However, if that is not possible,  
testing in the domain is the next best test.  
Caution – When testing a CPU/ Memory board that is assigned to a domain and the  
domain is active, there is a very slight possibility that problems can occur with the  
active domain. To prevent this from being a problem, unassign the board from the  
domain and test the board from the platform shell.  
116 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001  
 
   
See Also  
showcomponent, showboards  
Example  
To test CPU/ Memory board, sb0in the domain A shell (CODE EXAMPLE 3-64), type:  
CODE EXAMPLE 3-64 testboardExample Testing CPU/ Memory Board sb0  
schostname:A>testboard sb0  
<Command output not shown.>  
Chapter 3 System Controller Alphabetical Command Reference  
 
117  
 
118 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001  
 
Glossary  
domain shell With the domain shell, you have access to system controller commands that  
you need to perform on a domain. There are up to four domain shells  
(A through D). The domain shell prompt is schostname:A>(or B>, C>,  
or D>).  
domain A set of one or more system boards that is capable of booting the operating  
system and running independently of other domains. Domains do not depend  
on each other and do not interact with each other.  
domain console If the Solaris operating environment or the OpenBoot PROM is running, you  
can access the domain console. With the domain console, you can have the ok,  
login, #, or %prompts.  
environmental  
monitoring All systems have a large number of sensors that monitor temperature, voltage,  
and current. The system controller polls devices in a timely manner and makes  
the environmental data available. The system controller will shut down  
various components to prevent damage.  
keyswitch See virtual domain keyswitch.  
partition A group of Repeater boards that are used together to provide communications  
between CPU/ Memory boards and I/ O assemblies in the same domain.  
platform shell The platform shell enables access to the entire system and provides:  
configuration control, environmental status, ability to rearrange domains,  
ability to power on and off power grids, ability to change the system controller  
password, and other generic system controller functions.  
POST Power-on self-test. This is the program that takes uninitialized system  
hardware and probes and tests its components, configures what seems  
worthwhile into a coherent initialized system, and hands it off to the OpenBoot  
PROM.  
SRAM Static Random Access Memory. A type of high-speed memory device used for  
Ecache modules.  
Glossary  
119  
 
 
system controller The system controller consists of the System Controller board and the system  
controller software. The system controller software manages platform and  
domain resources, monitors and controls the platform and domains, configures  
domains and the platform, provides access to domain consoles, provides the  
date and time to the Solaris operating environment, provides the reference  
clock signal used throughout the system, provides console security, performs  
domain initialization, provides a mechanism for updating the firmware on the  
boards installed in the system, and provides an external management interface  
using SNMP.  
System Controller  
board A board containing a CPU (central processing unit), which oversees operation  
of the system and provides clocks and the console bus. These systems support  
two System Controller boards.  
TOD See virtual time of day (TOD).  
virtual domain  
keyswitch The system controller provides a virtual keyswitch for each domain. The  
setkeyswitchcommand controls the position of the virtual keyswitch for  
each domain.  
virtual time of day  
(TOD) The TOD/ NVRAM chip is located on the System Controller board. The system  
controller provides TOD services for each domain and for the system  
controller.  
120  
Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001  
 
Index  
A
active board state, 6  
addboard command, 17  
command summary, 13  
adding  
console port  
board to a domain, 17  
commands, 13  
assigned board state, 6  
CPU/ Memory board  
testing, 116  
B
D
board state  
current logging configuration, 106  
boards  
resuming access to, 62  
powering off, 49, 50, 53  
setting up, 79  
resetting, 57  
unassigning, 25  
Break character, 19  
break command, 19  
E
break shell  
environmental status  
displaying, 99, 100  
commands, 13  
exiting, 62  
Index 121  
 
 
F
R
reset command, 57  
flashupdate command, 39  
domains, 57  
H
help command, 43  
setupdomain command, 79  
showenvironment command, 99, 100  
K
showsc command, 115  
status, boards, 87  
L
status, environmental  
displaying, 99, 100  
listing board information, 87  
system controller software  
command summary, 13  
P
parameters  
domain, setting up, 79  
testboard command, 116  
CPU/ Memory board, 116  
time  
power grids  
powering on, 52, 53  
powering off, 49, 50  
powering on, 52, 53  
unassigning a board from the domain, 25  
powering off  
power grids, power supplies, or boards, 50  
powering on  
power grids, power supplies, or boards, 53  
poweroff command, 49, 50  
poweron command, 52, 53  
V
version and uptime information, displaying, 115  
virtual keyswitch, 74  
Index 122  
Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001  
 

Sennheiser Microphone 009894 User Manual
Sennheiser Microphone E912S User Manual
Sharp Computer Hardware XE A207 User Manual
Sharp Switch PW E350 User Manual
Shure Microphone EZO W User Manual
Sony Headphones MDR IF230 User Manual
Sony Stereo Receiver 3 289 450 441 User Manual
Sterling Plumbing Hot Tub 71041112 User Manual
Sunbeam Coffeemaker 3335 33 User Manual
SUPER MICRO Computer Server SBA 7142G T4 User Manual