Sun Microsystems 6800/4810/4800/3800 manual

Sun Microsystems, Inc. 901 San Antonio Road P alo Alto , CA 94303 U .S.A. 650-960-1300 Send comments about this document to: docfeedback@sun.com Sun Fire ™ 6800/4810/4800/3800 System Controller Command Ref erence Manual P ar t No . 805-7372-13 October 2001 , Revision A[...]

Please Recycle Copyright 2001 Sun Microsystems, Inc., 901 San Antonio Road • Palo Alto, CA 94303 USA. All rights reserved. This product or document is pr otected by copyright and distributed under licenses r estricting its use, copying, distribution, and decompilation. No part of this product or document may be repr oduced in any form by any mean[...]

iii Contents Preface xiii 1. Introduction to the System Controller 1 Platform and Domain Administration 1 Connecting to the System Controller 2 System Controller Navigation 2 Terminating Sessions 2 2. System Controller Syntax, Arguments, and Device Names 3 Command Syntax and Arguments 3 Command Names 4 Component Names 4 Board States for CPU/Memory [...]

iv Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 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 f[...]

Contents v showboards 86 showcomponent 90 showdate 93 showdomain 95 showenvironment 99 showkeyswitch 104 showlogs 106 showplatform 108 showresetstate 11 3 showsc 11 5 testboard 11 6 Glossary 1 19 Index 121[...]

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

vii T ables TABLE 2-1 Components That Are Accessible From the Platform 5 TABLE 2-2 Components That Are Accessible From a Domain 5 TABLE 2-3 Board States 6 TABLE 2-4 Status Field of the showboards Command 6 TABLE 2-5 Values for the Domain Status Column in showplatform and showdomain Command Output 7 TABLE 2-6 Command Line Editing Capabilities 9 TABL[...]

viii 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 72 TABLE 3-10 Parameter Values for the setupdomain Command 76 TABLE 3-11 setupplatform Parameter Values 82 TABLE 3-12 Output Header Definitions for the showboards and the[...]

ix Code Samples CODE EXAMPLE 3-1 addboard Example in the Platform Shell 18 CODE EXAMPLE 3-2 addboard Example in the Domain Shell 18 CODE EXAMPLE 3-3 break Command Example 20 CODE EXAMPLE 3-4 connections Command for the Platform Shell 22 CODE EXAMPLE 3-5 console Example and No Password Set Accessing Domain B 24 CODE EXAMPLE 3-6 console Example and A[...]

x Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 CODE EXAMPLE 3-20 flashupdate Example Updating Replacement CPU/Memory Board sb4 42 CODE EXAMPLE 3-21 help Command Example Displaying Information on the addboard Command 44 CODE EXAMPLE 3-22 help Command Example Displaying Commands Beginning With the Word show[...]

Code Samples xi CODE EXAMPLE 3-46 Variables for the setupdomain Command 80 CODE EXAMPLE 3-47 setupplatform Output 84 CODE EXAMPLE 3-48 showboards Command for the Platform Shell 87 CODE EXAMPLE 3-49 showboards -a Command for the Domain Shell 89 CODE EXAMPLE 3-50 showcomponent sb4 Sample Output 91 CODE EXAMPLE 3-51 showcomponent ib6 Sample Output 92 [...]

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

xiii Pr eface This book describes the Sun Fire 6800/4810/4800/3800 system controller command line interface. The system controller is responsible for contr olling system functions, environmental monitoring, domain control, and har dware contr ol of the server . Using the command line interface, you can configur e the platform and domains, power on [...]

xiv Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 Chapter 3 provides in tabular form a summary of all of the system controller commands and describes each command. T ypographic Conventions Shell Pr ompts T ypeface Meaning Examples AaBbCc123 The names of commands, files, and directories; on-scr een computer[...]

Preface xv Related Documentation Accessing Sun Documentation Online A broad selection of Sun system documentation is located at: http://www.sun.com/products-n-solutions/hardware/docs A complete set of Solaris documentation and many other titles are located at: http://docs.sun.com Or dering Sun Documentation fatbrain.com , an Internet professional b[...]

xvi Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 Sun W elcomes Y our Comments Sun is interested in impr oving its documentation and welcomes your comments and suggestions. Y ou can email your comments to Sun at: docfeedback@sun.com Please include the part number (805-7372-13) of your document in the subje[...]

1 CHAPTER 1 Intr oduction to the System Contr oller The system controller consists of the System Contr oller board and the system controller softwar e. The system controller software does the following: ■ Monitors and controls the system ■ Manages hardwar e ■ Configur es domains ■ Provides the date and time to the Solaris operating envir on[...]

2 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 For more information on the platform administration and domain administration functions, refer to the “Overview” chapter of the Sun Fire 6800/4810/4800/3800 Systems Platform Administration Manual . Connecting to the System Contr oller T o connect to the s[...]

3 CHAPTER 2 System Contr oller Syntax, Ar guments, and Device Names This chapter describes the following topics: ■ “Command Syntax and Arguments” on page 3 ■ “Command Names” on page 4 ■ “Component Names” on page 4 ■ “Board States for CPU/Memory Boards and I/O Assemblies” on page 6 ■ “Board T est Status” on page 6 ■ ?[...]

4 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 Arguments ar e the words that follow the command name and ar e divided into two categories: ■ Required ar guments ■ Optional arguments Optional arguments always follow the option flags on the command line. In the following example, the optional domainID a[...]

Chapter 2 System Controller Syntax, Arguments, and De vice Names 5 Note – The components in T ABLE 2-1 and T ABLE 2-2 depend on the system you have. For example, only the Sun Fire 6800 system can have six power supplies and six CPU/Memory boards. T ABLE 2-2 shows the components that are accessible from a domain. T ABLE 2-1 Components That Are Acc[...]

6 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 Boar d States for CPU/Memory Boar ds and I/O Assemblies T ABLE 2-3 lists the board states for the CPU/Memory boards and I/O assemblies. T o determine the board state, use the showboards command and look under the State header . The System Controller board, ID[...]

Chapter 2 System Controller Syntax, Arguments, and De vice Names 7 Domain Status In the showplatform and showdomain commands, one of the fields in the command output is domain status. The main values of domain status are ( T ABLE 2-5 ): Not T ested The board has not been tested. Degraded Certain components on the board have failed or ar e disabled.[...]

8 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 Special Characters T o execute multiple commands on the same line, separate them with a semicolon (;). The following example executes both the addboard and deleteboard commands. A pound sign ( # ) signifies the start of a comment on the current line. The foll[...]

Chapter 2 System Controller Syntax, Arguments, and De vice Names 9 Command Line Editing The system controller has a basic command line editor that allows you to edit the command line. The keys you press ar e not echoed on the screen. T ABLE 2-6 lists the keystrokes used to perform basic command line editing. ■ T o use the Control key sequences, h[...]

10 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 Command Line History Each shell keeps a short history of all entered commands. T o display the command line history , use the history command. After recalling the commands, you can either edit them or execute them by pressing the Return key . A history of at[...]

Chapter 2 System Controller Syntax, Arguments, and De vice Names 11 Command Completion Using the command completion function makes it easier for you to enter long commands. After typing part of the command, use the completion keystroke ( T ABLE 2-8 ). This action searches the list of available commands for commands beginning with the characters you[...]

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

13 CHAPTER 3 System Contr oller Alphabetical Command Refer ence This chapter lists a summary of the system controller commands designed for an end-user on the Sun Fire 6800/4810/4800/3800 systems, describes the system controller command line interface, and provides descriptions and examples for each command. Command Summary T ABLE 3-1 lists and des[...]

14 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 dumpconfig Saves the system controller conf iguration to a server . x enablecomponent Deletes a component from the blacklist. x x flashupdate Updates the firmware. x help Provides basic help information for commands. x x history Shows the command history wi[...]

Chapter 3 System Controller Alphabetical Command Reference 15 showresetstate Shows CPUs after a reset or a RED MODE trap. x showsc Shows the system controller version and uptime. x testboard T ests the CPU/Memory board. x x T ABLE 3-1 System Controller Command Summary (Continued) Command Description Platform Shell Domain Shell[...]

16 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 Alphabetical Listing of System Contr oller Commands The following sections describe the system controller commands. addboard Assigns a board to a domain. Scope platform shell, domain shell Syntax for the Platform Shell addboard -d domainID system_board_name [...]

Chapter 3 System Controller Alphabetical Command Reference 17 Description Assigns system_board_name to the specified domain within the platform shell or to the current domain. The boar d state must be Available . T o display the board state, use the showboards command. For more information on board states, see “Boar d States for CPU/Memory Boards[...]

18 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 Example—Platform Shell From the platform shell to add board name sb2 to domain A ( CODE EXAMPLE 3-1 ), type: Example—Domain Shell T o assign board name sb2 to the current domain ( CODE EXAMPLE 3-2 ), type: CODE EXAMPLE 3-1 addboard Example in the Platfor[...]

Chapter 3 System Controller Alphabetical Command Reference 19 break Sends a Break signal to the domain console. Scope domain shell Syntax break [-y|-n] break -h Options/Parameters -h displays help for this command. -y answers yes to the warning message. Does not prompt for confirmation. -n answers no to the warning message. Does not execute this co[...]

20 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 Example CODE EXAMPLE 3-3 shows using the break command to pause the Solaris operating environment and enter the OpenBoot PROM. CODE EXAMPLE 3-3 break Command Example schostname : A> break This will suspend Solaris in domain A. Do you want to continue? [no[...]

Chapter 3 System Controller Alphabetical Command Reference 21 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 . -d domainI[...]

22 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 Example—Platform Shell T ABLE 3-2 describes the headers in the output for CODE EXAMPLE 3-4 . CODE EXAMPLE 3-4 connections Command for the Platform Shell schostname : SC> connections ID Hostname Idle Time Connected On Connected To -- -------- --------- -[...]

Chapter 3 System Controller Alphabetical Command Reference 23 console Connects to a domain from the platform. Scope platform shell Syntax console [-d] domainID console -h Options/Parameters -d domainID is the domain to connect to and is a , b , c ,o r d . The - d parameter is optional and does not need to precede the domainID . -h displays help for[...]

24 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 Examples—Platform Shell When the domain is not active and there is no password initialized for this domain: When a domain is not active and a password is initialized for this domain: When a domain is active and a password is not set for this domain: Note t[...]

Chapter 3 System Controller Alphabetical Command Reference 25 deleteboard Unassigns a board fr om 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 -h displays help for this comma[...]

26 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 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 boar ds from a domain) Example—Pl[...]

Chapter 3 System Controller Alphabetical Command Reference 27 disablecomponent Adds a component to the blacklist. Scope platform shell, domain shell Syntax disablecomponent component_name [ component_name . . . ] disablecomponent -h Options/Parameters -h displays help for this command. component_name is (see T ABLE 3-3 and T ABLE 3-4 ): ■ system_[...]

28 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 T ABLE 3-3 component_name Descriptions for the CPU/Memory Board Used in the disablecomponent Command Board or Device Component Name CPU system board_name / port / p hysical_bank / logical_bank CPU/Memory boards ( system_ board_name ) SB0, SB1, SB2, SB3, SB4,[...]

Chapter 3 System Controller Alphabetical Command Reference 29 Description This command adds a component to the blacklist. Blacklisting provides a list of components that will not be tested and will not be configur ed into the domain when you change the domain’s keyswitch from an inactive state to an active state or reboot the domain. Blacklist a [...]

30 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 Examples CODE EXAMPLE 3-9 adds system_board_name sb4 to the blacklist. CODE EXAMPLE 3-10 adds system_board_name sb0 and CPU port 3 to the blacklists. Note that any memory banks on this CPU port are unr eachable and are implicitly disabled. CODE EXAMPLE 3-1 1[...]

Chapter 3 System Controller Alphabetical Command Reference 31 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 -h displays help for this command. ID (platform shell only) is the c[...]

32 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 Examples T o disconnect a session from the system controller platform shell with a telnet connection ( CODE EXAMPLE 3-13 ), type: If you are connected to the system contr oller platform console with the serial connection, you will see the following after typ[...]

Chapter 3 System Controller Alphabetical Command Reference 33 dumpconfig Saves the platform and domain configurations to a server . Scope platform shell Syntax dumpconfig -f url dumpconfig -h Options/Parameters -h displays help for this command. -f specifies the URL, which must use the ftp protocol. The URL must point to a directory and not a f ile[...]

34 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 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 . nvci and schostname .tod . Use this command when you complete set[...]

Chapter 3 System Controller Alphabetical Command Reference 35 enablecomponent Deletes a component from the blacklist. Scope platform shell, domain shell Syntax enablecomponent component_name [ component_name . . . ] enablecomponent -h Options/Parameters -h displays help for this command. component_name is ( T ABLE 3-5 and T ABLE 3-6 ) ■ system_bo[...]

36 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 Description Removes a component from the blacklist. Blacklisting provides a list of components that will not be tested and will not be configur ed into the domain when you change the keyswitch setting from an inactive state to an active state or when the dom[...]

Chapter 3 System Controller Alphabetical Command Reference 37 See Also disablecomponent, showcomponent , and the Sun Fire 6800/4810/4800/3800 Systems Platform Administration Manual for step-by-step procedure on r emoving a component from the blacklist. This information is in the ‘T roubleshooting” chapter in the section “Disabling Components.[...]

38 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 flashupdate Updates the firmwar e on the system controller and the system boar ds (CPU/Memory boards and I/O assemblies). The source f lash image can be on a server or another board of the same type. Scope platform shell Syntax flashupdate [-y|-n] -f url all[...]

Chapter 3 System Controller Alphabetical Command Reference 39 Note – The hostname you enter must be a host name or a host name with a fully qualified domain name. Y ou cannot use a partial domain name. Some examples include: schostname , schostname .eng.sun.com. board is the board name. -c specifies that the image should be copied from another bo[...]

40 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 Note – Any time the firmwar e is upgraded, check the Install.info file for the firmwar e upgrade procedure. This f ile is provided with your latest software r elease. Also refer to the Release Notes for any notes or special procedur es. If you install a re[...]

Chapter 3 System Controller Alphabetical Command Reference 41 Caution – While upgrading the firmwar e, heed the following precautions: - Read the README and Install.info files befor e you upgrade the firmware. - Do not change the keyswitch position of any domain. - Do not use DR. - Do not power off any boar ds. - Do not reboot the system contr ol[...]

42 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 flashupdate Command 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 scapp commands cause the sys[...]

Chapter 3 System Controller Alphabetical Command Reference 43 help Provides basic help information for commands. Scope platform shell, domain shell Syntax help [ command_name ]|[ partial_command_name ] help -h Options/Parameters -h displays help for this command. command_name is the name of the command. partial_command_name can be one letter of the[...]

44 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 Examples CODE EXAMPLE 3-21 displays help information on the addboard command. CODE EXAMPLE 3-22 displays all commands in the platform shell beginning with show . CODE EXAMPLE 3-21 help Command Example Displaying Information on the addboard Command schostname[...]

Chapter 3 System Controller Alphabetical Command Reference 45 CODE EXAMPLE 3-23 displays all commands in the platform shell beginning with the letter a. CODE EXAMPLE 3-23 help Command Example Displaying Commands Beginning W ith the Letter A schostname : SC> help a addboard -- assign a board to a domain Usage: addboard -d <domain> <board[...]

46 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 history Shows the command history with date and time stamps. Scope platform shell, domain shell Syntax history [-h] Options/Parameters -h displays help for this command. Description Shows the command history with date and time stamps for when the commands we[...]

Chapter 3 System Controller Alphabetical Command Reference 47 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. -h displays help for this command[...]

48 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 OpenBoot PROM passwords ar e different fr om the platform and domain passwords. The OpenBoot PROM in each domain supports the OpenBoot PROM security mode, which is a standard featur e of the OpenBoot PROM software. For more information on the OpenBoot PROM s[...]

Chapter 3 System Controller Alphabetical Command Reference 49 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[...]

50 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 Domain shell component_name(s) : ■ CPU/Memory board (sb0 - sb5 ) ■ I/O assembly (ib6 - ib9 ) Note – The specified boar d must be in the current domain. Description Powers off a component or a list of components. For the domain shell, the specified boar[...]

Chapter 3 System Controller Alphabetical Command Reference 51 Examples T o power off CPU/Memory board, sb2, from the platform shell ( CODE EXAMPLE 3-27 ), type: T o power off all power supplies, fan trays, and system boards ( CODE EXAMPLE 3-28 ), type: Note – From the domain shell, you cannot power of f power supplies, fan trays, Repeater boards,[...]

52 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 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[...]

Chapter 3 System Controller Alphabetical Command Reference 53 Description Powers on a component or a list of components Y ou must specify component_name (s). Y ou can power on any component that is not already powered on if there is suff icient power to support the component when it is powered on. From the domain, only components that are assigned [...]

54 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 T o power on CPU/Memory boards and I/O assemblies in the domain ( CODE EXAMPLE 3-30 ), type: Note – From the domain shell, you cannot power on power supplies, Repeater boards, fan trays, or power grids. T o power on these components, use the platform shell[...]

Chapter 3 System Controller Alphabetical Command Reference 55 reboot Reboots the system controller . Scope platform shell Syntax reboot [-y|-n] reboot -h Options/Parameters -y does not prompt for conf irmation. -n does not execute this command. Confirmation is requested. -h displays help for this command. Description Reboots the system controller .[...]

56 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 Examples T o reboot the system controller ( CODE EXAMPLE 3-31 ), type: CODE EXAMPLE 3-31 reboot Command Example schostname : SC> reboot Are you sure you want to reboot the System Controller now? [no][...]

Chapter 3 System Controller Alphabetical Command Reference 57 reset Resets the domain. Scope domain shell Syntax reset [-y|-n][-x|-a] reset -h Options/Parameters -y answers yes to the question asked (executes the command). -n answers no to the question asked (does not execute the command). -h displays help for this command. Options/Parameters W ith[...]

58 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 controlled by setting the OpenBoot PROM error-reset-recovery configuration variable. For the definition of this variable and the various settings, see T ABLE 3-10 in “ setupdomain ” on page 76. Note that the OpenBoot PROM reset command does not generate [...]

Chapter 3 System Controller Alphabetical Command Reference 59 restoreconfig Restores the platform and domain conf igurations from a server . Scope platform shell Syntax restoreconfig [-y|-n] -f url restoreconfig -h Options/Parameters -h displays help for this command. -y does not prompt for conf irmation. -n does not execute this command if confirm[...]

60 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 Caution – The dumpconfig command is intended to be used as part of replacing a failed system controller . For instructions on how to use dumpconfig , see “T o Use the dumpconfig Command to Save the Current Platform and Domain Configurations to a Server?[...]

Chapter 3 System Controller Alphabetical Command Reference 61 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 . . . CODE EXAMPLE 3-34 restoreconfig Example (Continued)[...]

62 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 resume Exits the domain shell and resumes access to the domain console. Scope domain shell Syntax resume [-h] Options/Parameters -h displays help for this command. Description Exits the domain shell and resumes access to the domain console. This command requ[...]

Chapter 3 System Controller Alphabetical Command Reference 63 Example 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 pr ess the Enter key in order to see the pr ompt. Otherwise, you will need to wait for output to be generated by POST , the OpenBoot [...]

64 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 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 <+|-[...]

Chapter 3 System Controller Alphabetical Command Reference 65 -r datehost 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 .Y o u cannot us[...]

66 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 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. Y ou can set up to five differ ent times and time zones; one time and time [...]

Chapter 3 System Controller Alphabetical Command Reference 67 Examples When you type the setdate command from the platform, this sets the date and time for the platform. When you type the setdate command from the domain, this sets the date and time for the domain. T o set the date and time on the platform to Thursday , April 20, 2001, at 18 hours 1[...]

68 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 T o set just the time zone for Japan Standard T ime using offsets from Gr eenwich Mean T ime—GMT ( T ABLE 3-7 ) and not the date and time, type: T o set just the time zone for European Central T ime using the time zone abbreviations ( T ABLE 3-7 ) and not [...]

Chapter 3 System Controller Alphabetical Command Reference 69 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 -y does not prompt for conf irmation[...]

70 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 Description Caution – This command requir es that all domains are inactive (not r unning 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[...]

Chapter 3 System Controller Alphabetical Command Reference 71 setkeyswitch Changes the position of the virtual keyswitch to the specified value. Scope platform shell, domain shell Syntax for the Platform Shell setkeyswitch [-y|-n] -d domainID off setkeyswitch -h Syntax for the Domain Shell setkeyswitch [-y|-n] [ off|standby | on | diag | secure ] s[...]

72 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 For setkeyswitch parameters and descriptions, see T ABLE 3-8 . T ABLE 3-9 shows the results when you change a keyswitch setting. T ABLE 3-8 Description of the setkeyswitch T ransition V alue Description off Changes the board state of all the boar ds belongin[...]

Chapter 3 System Controller Alphabetical Command Reference 73 standby of f All boards will be power ed off (set to low -power mode and all monitoring of the boards will stop). The domain is shut down. standby on Similar to setting the virtual keyswitch fr om off to on except that you do not have to wait for the system controller to turn on the boar[...]

74 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 Description Each domain has a virtual keyswitch with five positions: of f, standby , on, diag, and secure. The setkeyswitch command changes the position of the virtual keyswitch to the specified value. The virtual keyswitch replaces the need for a physical k[...]

Chapter 3 System Controller Alphabetical Command Reference 75 T o shut down the domain by turning the virtual keyswitch off ( CODE EXAMPLE 3-44 ), type: T o shut down domain B from the platform shell ( CODE EXAMPLE 3-45 ), type: Caution – CODE EXAMPLE 3-45 does not properly shut down the Solaris operating environment in the domain befor e turning[...]

76 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 setupdomain Configur es the domain. Scope domain shell Syntax setupdomain [-p part ] ... setupdomain -h Options/Parameters -h displays help for this command. -p part configur es the specified information and has the following options: ■ bootparams configur[...]

Chapter 3 System Controller Alphabetical Command Reference 77 max All system board components ar e tested with all tests and test patterns. This is the same as default . mem1 Runs all tests at the default level plus more exhaustive DRAM and SRAM test algorithms. These tests take a long time to run. mem2 This is the same as mem1 with the addition of[...]

78 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 true The domain is rebooted when a har dware err or 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 [...]

Chapter 3 System Controller Alphabetical Command Reference 79 Description Configur es domain specific values. Configur es the domain. Y ou can configur e each domain differ ently and independently This command is an interactive command. Y ou are prompted for parameters to conf igure. See Also password, setdate, showdate, showdomain, and the section[...]

80 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 Example 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 pr oper value ( T ABLE 3-10 ). If a va[...]

Chapter 3 System Controller Alphabetical Command Reference 81 setupplatform Configur es the platform specific variables. Scope platform shell Syntax setupplatform [-p part ] ... setupplatform -h Options/Parameters -h displays help for this command. -p part configur es the specified part and has the following options: ■ acls is ACLs (Access Contro[...]

82 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 Description Configur es parameters for the platform. This command is an interactive command. Y ou are prompted for parameters to conf igure. For parameters to configur e, see T ABLE 3-1 1 . T ABLE 3-11 setupplatform Parameter V alues Parameter Description Is[...]

Chapter 3 System Controller Alphabetical Command Reference 83 Platform Contact 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 . Platform Location Location of the system (such as a r oom and/or the location inside of the room).[...]

84 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 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 3 System Controller Alphabetical Command Reference 85 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 str[...]

86 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 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 ][ -d domainID ][ -p part ] showboards -h Syntax for the Domain Shell [...]

Chapter 3 System Controller Alphabetical Command Reference 87 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 ar e includ[...]

88 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 T ABLE 3-12 Output Header Definitions for the showboards and the showboards -v Command Header Description Slot Slot designator . The N x in the slot descriptor is the node number . Pwr Indicates if the power status of the device is off or on. Component type [...]

Chapter 3 System Controller Alphabetical Command Reference 89 Example—Domain Shell I/O Status Slot I/O slot. Populated Def ines 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. C[...]

90 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 showcomponent Shows the state of a component. Scope platform shell, domain shell Syntax for the Platform Shell showcomponent [-v] [ component ] ... showcomponent [-v] [-d domainID ] ... showcomponent -h Syntax for the Domain Shell showcomponent [-v] [ compon[...]

Chapter 3 System Controller Alphabetical Command Reference 91 See Also enablecomponent, disablecomponent , and the “Disable Component” section of the “T roubleshooting” 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 s[...]

92 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 Definitions of the headings in CODE EXAMPLE 3-50 and CODE EXAMPLE 3-51 follow: ■ Component is the name of the board and its components. ■ Status is the status of the board or component. ■ Pending means that the component will change to the indicated st[...]

Chapter 3 System Controller Alphabetical Command Reference 93 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 -h displays help for this command. -t lists available ti[...]

94 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 See Also setdate Example—Platform Shell CODE EXAMPLE 3-52 showdate Command for the Platform Shell schostname : SC> showdate Mon Apr 03 12:31:40 EDT 2001[...]

Chapter 3 System Controller Alphabetical Command Reference 95 showdomain Displays the configuration and status of the domain. Scope domain shell Syntax showdomain [-v] [-p part ] ... showdomain -h Options/Parameters -v is verbose mode. -p part is a parameter for the information to display: ■ acls shows the ACLs (Access Control List) ■ bootparam[...]

96 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 Examples T o display parameters assigned by the setupdomain command, type showdomain ( CODE EXAMPLE 3-53 ). CODE EXAMPLE 3-53 showdomain Command Example schostname : A> showdomain Domain Solaris Nodename Domain Status Keyswitch ------ ---------------- ---[...]

Chapter 3 System Controller Alphabetical Command Reference 97 T o 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 ------ ---------------- ----------[...]

98 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 T o display boot parameter information ( CODE EXAMPLE 3-55 ), type: ACLs ---- ACL for Domain A: SB0 SB1 SB2 SB3 SB4 SB5 IB6 IB7 IB8 IB9 schostname : A> CODE EXAMPLE 3-55 showdomain -p bootparams Example Displaying Boot Parameter Information schostname : A[...]

Chapter 3 System Controller Alphabetical Command Reference 99 showenvironment Displays the current environmental status, temperatur es, 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 ] [-p[...]

100 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 -p part shows a specific part ( T ABLE 3-13 ): - t prints header titles. -u updates data now . Polls all sensors for new values. - v is verbose mode. This is the equivalent of the options -l and - w . -w shows warning thresholds. Description Displays the cu[...]

Chapter 3 System Controller Alphabetical Command Reference 101 V alue V alue returned by the sensor . Units Applicable unit for the sensor . Degrees C Celsius V olts DC V olts Amps Amps Age Age in seconds of the reading being displayed. Status V alues for Status. See the V alue column. When the values listed in the V alue column are exceeded, a war[...]

102 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 Example The showenvironment command 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 showenvironment Platform Shell and Domain Shell Exa[...]

Chapter 3 System Controller Alphabetical Command Reference 103 FT1 Fan 0 Cooling 0 Low 1 sec OK FT2 Fan 0 Cooling 0 Low 7 sec OK IB8 Board 0 1.5 VDC 0 1.51 Volts DC 4 sec OK IB8 Board 0 3.3 VDC 0 3.35 Volts DC 5 sec OK IB8 Board 0 5 VDC 0 4.98 Volts DC 5 sec OK IB8 Board 0 12 VDC 0 12.11 Volts DC 5 sec IB8 Board 0 Temp. 0 30 Degrees C 5 sec OK IB8 [...]

104 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 showkeyswitch Displays the keyswitch setting. Scope platform shell, domain shell Syntax for the Platform Shell showkeyswitch [-v] -d domainID showkeyswitch -h Syntax for the Domain Shell showkeyswitch [-v] showkeyswitch -h Options/Parameters -h displays hel[...]

Chapter 3 System Controller Alphabetical Command Reference 105 Examples CODE EXAMPLE 3-57 s howkeyswitch Example Showing the Keyswitch Set to On schostname : A> showkeyswitch keyswitch is: on CODE EXAMPLE 3-58 s howkeyswitch Example Showing the Keyswitch Set to Off schostname : A> showkeyswitch keyswitch is: off CODE EXAMPLE 3-59 s howkeyswit[...]

106 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 showlogs Displays the system controller logged events stored in the system contr oller message buffer . Scope platform shell, domain shell Syntax for the Platform Shell showlogs [-d domain ID ] [-v] showlogs -h Syntax for the Domain Shell showlogs [-v] show[...]

Chapter 3 System Controller Alphabetical Command Reference 107 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 out[...]

108 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 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.[...]

Chapter 3 System Controller Alphabetical Command Reference 109 ■ sc shows the system controller conf iguration. ■ snmp shows snmp information for the platform. ■ status shows domain status for all domains. - v is verbose mode. Description This command displays all configuration variables for this platform, including: ■ Network attributes of[...]

110 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 CODE EXAMPLE 3-62 shows the showplatform -v command output. 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[...]

Chapter 3 System Controller Alphabetical Command Reference 111 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 HostID ----------- ------ Domain A xx:xx:xx:xx:xx:xx xxxxxxxx Domain B xx:xx:xx:xx:xx:xx xxxxxxxx Domain C xx:xx:xx:xx:xx:xx xxxxxxxx [...]

112 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 In CODE EXAMPLE 3-61 and CODE EXAMPLE 3-62 , the Domain Status header has the following possible states: ■ Powered Of f ■ Standby ■ Running POST ■ Active ■ Active - OpenBoot PROM ■ Active - Booting ■ Active - Solaris ■ Active - Halted ■ Ac[...]

Chapter 3 System Controller Alphabetical Command Reference 113 showresetstate Shows that state of CPUs after a reset or a RED MODE trap. Scope domain shell Syntax showresetstate [-w | -s | -v] Options/Parameters -w displays the contents of register windows. The f irst windows displayed in the output are the stack trace for the failing CPU. The wind[...]

114 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 Since a CPU that does not have a saved state does not produce output, there is no output when CPUs are r eset or have not failed. After a failure, the saved state is available until the domain restarts the OpenBoot PROM, either by r ebooting the Solaris ope[...]

Chapter 3 System Controller Alphabetical Command Reference 115 showsc Shows the system controller version and uptime. Scope platform shell Syntax showsc [-v] showsc -h Options/Parameters -h displays help for this command. -v is verbose mode. Description Shows the system controller version and uptime. Example RTOS is the Real T ime Operating System [...]

116 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 testboard T ests 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 T ests the CPU/Memory board nam[...]

Chapter 3 System Controller Alphabetical Command Reference 117 See Also showcomponent, showboards Example T o test CPU/Memory board, sb0 in the domain A shell ( CODE EXAMPLE 3-64 ), type: CODE EXAMPLE 3-64 testboard Example T esting CPU/Memory Board sb0 schostname : A> testboard sb0 < Command output not shown. >[...]

118 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001[...]

Glossary 119 Glossary domain shell W ith the domain shell, you have access to system controller commands that you need to perform on a domain. There ar e up to four domain shells (A through D). The domain shell pr ompt is schostname :A> (or B> , C> , or D>) . domain A set of one or more system boar ds that is capable of booting the oper[...]

120 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Man ual • October 2001 system controller The system controller consists of the System Contr oller board and the system controller softwar e. The system controller softwar e manages platform and domain resour ces, monitors and controls the platform and domains, configur es domain[...]

Index 12 1 Index A active board state, 6 addboard command, 17 adding board to a domain, 17 assigned board state, 6 available board state, 6 B board state Active, 6 Assigned, 6 A vailable, 6 board states, 6 boards CPU/Memory testing, 1 16 listing assignment information and status, 8 7 powering off, 49, 50, 53 powering on, 52 status, 87 unassigning, [...]

Index 122 Sun Fire 6800/4810/4800/3800 System Controller Command Ref erence Manual • October 2001 F flash PROMs, updating, 39 flashupdate command, 39 H help command, 43 history command, 46 K keyswitch command, 74 keyswitch positions, virtual, 74 L listing board information, 87 logging configuration, curr ent, 106 P parameters domain, setting up, [...]