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]

Contents

Preface xiii

1. Introduction to the System Controller

Platform and Domain Administration

Connecting to the System Controller

System Controller Navigation

Terminating Sessions

2. System Controller Syntax, Arguments, and Device Names

Command Syntax and Arguments

Command Names

Component Names

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

Board Test Status

Domain Status

Interactive Commands

Command Line Editing

Command Line History 10

Command Completion 11

iii

3. System Controller Alphabetical Command Reference 13

Command Summary 13

Alphabetical Listing of System Controller Commands 16

addboard 16

break 19

connections 21

console 23

deleteboard 25

disablecomponent 27

disconnect 31

dumpconfig 33

enablecomponent 35

flashupdate 38

help 43

history 46

password 47

poweroff 49

poweron 52

reboot 55

reset 57

restoreconfig 59

resume 62

setdate 64

setdefaults 69

setkeyswitch 71

setupdomain 76

setupplatform 81

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

showboards 86

showcomponent 90

showdate 93

showdomain 95

showenvironment 99

showkeyswitch 104

showlogs 106

showplatform 108

showresetstate 113

showsc 115

testboard 116

Glossary 119

Index 121

Contents

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

Tables

TABLE 2-1

TABLE 2-2

TABLE 2-3

TABLE 2-4

TABLE 2-5

Components That Are Accessible From the Platform

Components That Are Accessible From a Domain

Board States

Status Field of the showboardsCommand

Values for the Domain Status Column in showplatformand showdomain Command

Output

TABLE 2-6

TABLE 2-7

TABLE 2-8

TABLE 3-1

TABLE 3-2

TABLE 3-3

Command Line Editing Capabilities

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-9

TABLE 3-10

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

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

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

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

xii

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

Preface

This book describes the Sun Fire 6800/ 4810/ 4800/ 3800 system controller command

line interface. The system controller is responsible for controlling system functions,

environmental monitoring, domain control, and hardware control of the server.

Using the command line interface, you can configure the platform and domains,

power on and off domains, power supplies, fans, and other components. Access to

the Solaris domain console is also possible using the command line interface.

Before You Read This Book

This book is written for system administrators or people who have a working

knowledge of the Solaris^™operating environment. If you do not have such

knowledge, you should first read the Solaris User and System Administrator

AnswerBooks and consider UNIX system administration training. 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

Book titles, new words or terms, Read Chapter 6 in the User’s 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

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

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

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

operating envir onment will ignore the break signal if the keyswitch is set

to secure.

See Also

resume, setkeyswitch, showkeyswitch

Chapter 3 System Controller Alphabetical Command Reference

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

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 ru n f rom 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

Example—Platform Shell

CODE EXAMPLE 3-4 connectionsCommand for the Platform Shell

schostname:SC>connections

Hostname

--------

XXXXXXX

XXX

Idle Time

---------

Connected On

------------

May 02 00:00

May 02 00:21

Connected To

------------

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

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.

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

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.

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

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

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

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

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 domain’s 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

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

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 o btain 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

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

schostname :SC> disconnect

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 disconnec tExample 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.

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

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

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

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.

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

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 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.

-fspeciﬁes a URL as the source of the ﬂash images

url is the URL to the directory containing the flash images.

where:

ftp://hostname/path

ftp://userid:password@hostname/path

http://hostname/path

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

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.

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

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

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

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

Usage: addboard -d <domain> <board> ...

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

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

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

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

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>

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

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

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

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.

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

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.

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

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]

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

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.

2. T u rn the keyswitch on with setkeyswitch on.

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

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

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. Y o u also n eed 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

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

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 contr oller commands that also resume the domain console are listed in

the following section.

See Also

break, reset, setkeyswitch

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

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.

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

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

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

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 T i m e 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

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

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 domain’s 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.

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 -h

Options/ Parameters

-hdisplays help for this command.

-ydoes not prompt for conﬁrmation.

-ndoes not execute this command is conﬁrmation 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

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

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

Si m i lar 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

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

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

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.

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

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.

standby

The domain becomes inactive. All of the boards remain

powered 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.

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

standby

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

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

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

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

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 of fExample 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

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.

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

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.

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

domain differently and independently This command is an interactive command.

You are prompted for parameters to configure.

See Also

password, setdate, showdate, showdomain, and the section “To Conﬁgure

Domain-Speciﬁc 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

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.

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

■

loghostconﬁgures 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.

scconﬁgures system controller behavior.

■

snmpis SNMP conﬁguration

Chapter 3 System Controller Alphabetical Command Reference

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.

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.

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

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

“Overview” chapter in the Sun Fir e 6800/4810/4800/3800

Systems Platform Administration Manual.

See Also

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]:

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

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.

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

System Controller

Empty Slot

Sun Fire 3800 Centerplane -

A145 Power Supply

Fan Tray

Repeater Board (F3800)

CPU Board

CPCI I/O board (F3800)

Passed

Low Speed OK

Active

Assigned

Active

Assigned

Passed

Not tested C

Passed

Not tested C

/N0/SB0 On

/N0/SB2 Off

/N0/IB6 On

/N0/IB8 Off

The showboards command with the -voption displays the verbose option.

Chapter 3 System Controller Alphabetical Command Reference

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.

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

------

Isolated

/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

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.

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:

■

Node name

SBx CPU/ Memory board, where x is 0 – 5

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 -

pass

UltraSPARC III+,750Mhz, 8M ECache

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

CODE EXAMPLE 3-50 showcomponent sb4 Sample Output (Continued)

/NO/SB4/P3/B1/L1 enabled -

/NO/SB4/P3/B1/L3 enabled -

pass

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.

Statu s is 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:

■

Node name

IBx I/ O assembly, where x is 6 – 9

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 -

pass

IO controller 0

IO controller 1

66/33MHz PCI Bus

33MHz PCI Bus

33MHz 5V Short PCI card

33MHz 5V Long/Short PCI card

untest

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

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

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 d i splays all the parameter values configured by the

setupdomaincommand.

See Also

setupdomain, showdate, setupplatform, showplatform

Chapter 3 System Controller Alphabetical Command Reference

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

------ ---------------- ------------- ---------

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>

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

------ ---------------- ------------- ---------

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

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>

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

-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

environmental data.

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

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

RP0

RP2

PS0

PS1

PS2

FT0

Device

---------

SBBC 0

Sensor

---------

Temp. 0

Value

------

Units

------

Age

---

Status

------

Degrees C 2 sec OK

Volts DC

3Volts DC 5 sec OK

Degrees C 5 sec OK

Degrees C 5sec

Volts DC

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

SDC 0

Temp. 1

Temp. 2

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

1.5 VDC 0

3.3 VDC 0

Temp. 0

Temp. 1

Temp. 0

Current 0

Temp. 0

Current 0

48 VDC 0

Current 0

Temp. 0

Current 0

48 VDC 0

Current 0

Temp. 0

1.49

3.35

5.01

1.49

3.37

1.49

3.37

3.94

0.18

55.28

56.59

4.05

0.16

55.28

56.33

4.88

2 sec OK

5 sec OK

AR 0

Board 0

SDC 0

5 sec OK

AR 0

48 VDC 0

48 VDC 1

48 VDC 0

48 VDC 1

48 VDC 0

48 VDC 1

48 VDC 0

Fan 0

Amps

2 sec OK

Volts DC

Amps

Degrees C 2 sec OK

Amps

Volts DC

Amps

Degrees C 1 sec OK

Amps

2 sec OK

1 sec OK

Current 0

48 VDC 0

Cooling 0

0.88

55.0

56.07

1 sec OK

2 sec OK

1 sec OK

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

SB0

IB6

Fan 0

Cooling 0

1.5 VDC 0

3.3 VDC 0

5 VDC 0

12 VDC 0

Temp. 0

Temp. 1

Temp. 0

Temp. 1

1.5 VDC 0

3.3 VDC 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. 1

Low

1 sec OK

7 sec OK

4 sec OK

5 sec OK

5 sec

Board 0

SDC 0

1.51

3.35

4.98

12.11

1.50

3.33

1.71

1.72

1.51

3.35

4.95

12.11

Volts DC

Degrees C 5 sec OK

Degrees C 5sec

Degrees C 5 sec OK

Volts DC

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

AR 0

SBBC 0

IOASIC 0

IOASIC 1

Board 0

SDC 0

6 sec OK

AR 0

SBBC 0

Board 1

Cheetah 0

Cheetah 1

SBBC 1

Board 1

Cheetah 2

Cheetah 3

Board 0

SDC 0

7 sec OK

Volts DC

Degrees C 7 sec OK

7 sec OK

Volts DC

Degrees C 7 sec OK

7 sec OK

AR 0

SBBC 0

IOASIC 0

IOASIC 1

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 speciﬁc 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 speciﬁc 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

------ ---------------- ------------- ---------

Powered Off

off

standby

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

------ ---------------- ------------- ---------

Powered 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

HostID

------

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

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,

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

active board state, 6

command history, 46

addboard command, 17

command summary, 13

adding

console port

board to a domain, 17

commands, 13

assigned board state, 6

available board state, 6

CPU/ Memory board

testing, 116

c u rr ent logging configuration, displaying, 106

board state

Active, 6

deleteboard command, 25

Assigned, 6

Available, 6

d i splaying, 106

current environmental status, 99, 100

current logging conﬁguration, 106

version and uptime information, 1 15

board states, 6

boards

CPU/ Memory

domain console

testing, 116

resuming access to, 62

listing assignment information and status, 87

powering off, 49, 50, 53

setting up, 79

resetting, 57

unassigning, 25

Break character, 19

break command, 19

break shell

environmental status

displaying, 99, 100

commands, 13

exiting, 62

Index 121

flash PROMs, updating, 39

reset command, 57

flashupdate command, 39

resetting

domains, 57

resume command, 62

help command, 43

history command, 46

setdate command, 64, 66

setting, time, 64, 66

setupdomain command, 79

showboards command, 87

showenvironment command, 99, 100

showlogs , 106

keyswitch command, 74

keyswitch positions, virtual, 74

showsc command, 115

status, boards, 87

status, environmental

displaying, 99, 100

listing board information, 87

logging configuration, current, 106

system controller software

command summary, 13

parameters

domain, setting up, 79

testboard command, 116

password command, 47

testing

CPU/ Memory board, 116

password , setting, 47

time

power grids

setting, 64, 66

powering off, 49, 50

powering on, 52, 53

power supplies

powering off, 49, 50

powering on, 52, 53

unassigning a board from the domain, 25

updating the flash PROM, 39

uptime and version information, displaying, 1 15

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

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