Page 3 - Contents; Preface
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 Name...
Page 4 - System Controller Alphabetical Command Reference; Command Summary
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 ...
Page 5 - Glossary
Contents v 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
Page 7 - Tables
vii Tables TABLE 2-1 Components That Are Accessible From the Platform 5 TABLE 2-2 Components That Are Accessible From a Domain 5 TABLE 2-3 Board States 6 TABLE 2-4 Status Field of the showboards Command 6 TABLE 2-5 Values for the Domain Status Column in showplatform and showdomain Command Output 7 T...
Page 8 - setupdomain
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 Outp...
Page 9 - Code Samples
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 ...
Page 13 - Before You Read This Book; operating environment. If you do not have such; How This Book Is Organized; This book contains the following chapters:
xiii Preface This book describes the Sun Fire 6800/4810/4800/3800 system controller commandline 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 conf...
Page 14 - Typographic Conventions; su; schostname
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 controllercommands and describes each command. Typographic Conventions Shell Prompts Typeface Meaning Examples AaBbCc123 The names of commands,...
Page 15 - Related Documentation; A broad selection of Sun system documentation is located at:; Ordering Sun Documentation; , an Internet professional bookstore, stocks select product
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 Ordering Sun Docume...
Page 16 - Sun Welcomes Your Comments
xvi Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 Sun Welcomes Your Comments Sun is interested in improving its documentation and welcomes your comments andsuggestions. You can email your comments to Sun at: [email protected] Please include the part number ...
Page 17 - Platform and Domain Administration
1 C H A P T E R 1 Introduction to the SystemController The system controller consists of the System Controller board and the systemcontroller software. The system controller software does the following: ■ Monitors and controls the system ■ Manages hardware ■ Configures domains ■ Provides the date an...
Page 19 - Command Syntax and Arguments; flags
3 C H A P T E R 2 System Controller Syntax,Arguments, and Device Names This chapter describes the following topics: ■ “Command Syntax and Arguments” on page 3 ■ “Command Names” on page 4 ■ “Component Names” on page 4 ■ “Board States for CPU/Memory Boards and I/O Assemblies” on page 6 ■ “Board Test S...
Page 20 - Command Names; Note –; Component Names
4 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 Arguments are the words that follow the command name and are divided into twocategories: ■ Required arguments ■ Optional arguments Optional arguments always follow the option flags on the command line. In thefol...
Page 21 - The components in; Components That Are Accessible From the Platform; Components That Are Accessible From a Domain
Chapter 2 System Controller Syntax, Arguments, and Device Names 5 Note – The components in TABLE 2-1 and TABLE 2-2 depend on the system you have. For example, only the Sun Fire 6800 system can have six power supplies and sixCPU/Memory boards. TABLE 2-2 shows the components that are accessible from a...
Page 22 - Board Test Status; describes the Status field of the; Status Field of the
6 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 Board States for CPU/Memory Boardsand I/O Assemblies TABLE 2-3 lists the board states for the CPU/Memory boards and I/O assemblies. To determine the board state, use the showboards command and look under the Sta...
Page 23 - Domain Status; In the; Values for the Domain Status Column in
Chapter 2 System Controller Syntax, Arguments, and Device 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 ( TABLE 2-5 ): Not Tested The board has not been tested. Degraded Certain compon...
Page 24 - Special Characters; addboard; Interactive Commands; setupplatform; When an interactive command prompts for input, do the following:
8 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 Special Characters To execute multiple commands on the same line, separate them with a semicolon (;).The following example executes both the addboard and deleteboard commands. A pound sign ( # ) signifies the st...
Page 25 - Command Line Editing; lists the keystrokes used to perform basic command line editing.; Command Line Editing Capabilities
Chapter 2 System Controller Syntax, Arguments, and Device Names 9 Command Line Editing The system controller has a basic command line editor that allows you to edit thecommand line. The keys you press are not echoed on the screen. TABLE 2-6 lists the keystrokes used to perform basic command line edi...
Page 26 - Command Line History; history; Keystrokes that Recall Previously Typed Command Lines; Command Line Editing Capabilities (Continued)
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. To display the commandline history, use the history command. After recalling the commands, you can either edit them or execute them...
Page 27 - Command Completion; ). This action searches the list of available commands for commands; Keystrokes Used to Complete System Controller Commands
Chapter 2 System Controller Syntax, Arguments, and Device Names 11 Command Completion Using the command completion function makes it easier for you to enter longcommands. After typing part of the command, use the completion keystroke( TABLE 2-8 ). This action searches the list of available commands ...
Page 29 - System Controller Command Summary
13 C H A P T E R 3 System Controller AlphabeticalCommand Reference This chapter lists a summary of the system controller commands designed for anend-user on the Sun Fire 6800/4810/4800/3800 systems, describes the systemcontroller command line interface, and provides descriptions and examples for eac...
Page 30 - System Controller Command Summary (Continued)
14 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 dumpconfig Saves the system controller configuration to aserver. x enablecomponent Deletes a component from the blacklist. x x flashupdate Updates the firmware. x help Provides basic help information for comman...
Page 32 - The following sections describe the system controller commands.; Assigns a board to a domain.; Scope; platform shell, domain shell; Syntax for the Platform Shell
16 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 Alphabetical Listing of SystemController 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...
Page 33 - Description; showboards; See Also; showdomain
Chapter 3 System Controller Alphabetical Command Reference 17 Description Assigns system_board_name to the specified domain within the platform shell or tothe current domain. The board state must be Available. To display the board state, usethe showboards command. For more information on board state...
Page 34 - Example—Platform Shell; From the platform shell to add board name; Example—Domain Shell; To assign board name
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 To assign board name sb2 to the current domain ( CODE EXAMPLE 3-2 ), type: CODE ...
Page 35 - break
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 n...
Page 36 - Example; shows using the; This will suspend Solaris in domain A.
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 S...
Page 37 - connections; Displays connections to the system controller or a domain.; domainID; Syntax for the Domain Shell; displays help for this command; disconnect
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/Paramet...
Page 38 - describes the headers in the output for; Command for the Platform Shell; Header Description for the connections Command
22 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 Example—Platform Shell TABLE 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 Conn...
Page 39 - console
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 , or d . The - d parameter is optional and does not n...
Page 40 - Examples—Platform Shell; When a domain is active and a password is not; set; Note that no other output is seen. If the OpenBoot PROM is at the; Example and No Password Set Accessing Domain B; Example and A Password Set Accessing Domain A
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...
Page 41 - Unassigns a board from the domain where it is currently assigned.; Syntax for the Platform Shell and the Domain Shell; deleteboard
Chapter 3 System Controller Alphabetical Command Reference 25 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] ...
Page 42 - , “Assigning and Unassigning Boards” in the; To delete I/O assembly; To delete CPU/Memory board; deleteboar
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 PlatformAdministration Manual (for a step-by-step procedure on unassign...
Page 43 - Adds a component to the blacklist.; Syntax; disablecomponent; You can use partial component names.
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_nam...
Page 44 - component_name Descriptions for the I/O Assembly Used in the
28 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 TABLE 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/Memoryboards( system...
Page 45 - enablecomponent,showcomponent
Chapter 3 System Controller Alphabetical Command Reference 29 Description This command adds a component to the blacklist. Blacklisting provides a list ofcomponents that will not be tested and will not be configured into the domain whenyou change the domain’s keyswitch from an inactive state to an ac...
Page 46 - Examples; and CPU port 3 to the blacklists.; A> disablecomponent sb4
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 unreachable ...
Page 47 - Disconnects the current or specified connection.; displays help for this command.
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 f...
Page 48 - telnet; Return key to obtain the prompt.; Example Showing Disconnecting a Session From the
32 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 Examples To 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 controller platform console with the serialcon...
Page 49 - dumpconfig; ftp
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. ...
Page 50 - and schostname; Caution –; This command should be run any time you change the platform or; nvci; hostname; tod
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 asystem controller failure. This command creates two data files at the specified URL:schostname. nvci and schostname ...
Page 51 - Deletes a component from the blacklist.; enablecomponent; component_name Descriptions for the CPU/Memory Board Used in the
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_n...
Page 52 - Components can be the following:
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 componentsthat will not be tested and will not be configured into the domain when you changethe keyswitch setting from an inac...
Page 53 - disablecomponent, showcomponent; enables CPU/Memory board; A> enablecomponent sb4
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 removing acomponent from the blacklist. This information is in the ‘Troubleshooting” chap...
Page 54 - flashupdate; platform shell
38 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 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 aserver or another board of the same type. Scope platform ...
Page 55 - board is the board name.
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. You cannot use a partial domain name. Some examplesinclude: schostname, schostname .eng.sun.com. board is the board name. -c specifies th...
Page 58 - host; scapp rtos
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, an...
Page 59 - help
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 comman...
Page 60 - displays help information on the; Command Example Displaying Information on the; Command Example Displaying Commands Beginning With 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 Displayin...
Page 61 - displays all commands in the platform shell beginning with the
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 With the Letter A schostname : SC> help a addboard -- assign a board to a d...
Page 62 - Shows the command history with date and time stamps.
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 wi...
Page 63 - Sets the password for the platform or the domain.; Syntax—Platform Shell; Syntax—Domain Shell; password; You can remove the password by pressing Return at the
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,...
Page 64 - You will see the following prompt (; Enter current password:; Enter new password again:
48 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 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. ...
Page 65 - poweroff; all
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...
Page 67 - from the platform shell
Chapter 3 System Controller Alphabetical Command Reference 51 Examples To power off CPU/Memory board, sb2, from the platform shell ( CODE EXAMPLE 3-27 ), type: To power off all power supplies, fan trays, and system boards ( CODE EXAMPLE 3-28 ), type: Note – From the domain shell, you cannot power of...
Page 68 - poweron
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| co...
Page 69 - The fan trays power on automatically if any power supply is on.; from the platform shell (
Chapter 3 System Controller Alphabetical Command Reference 53 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 issufficient power to support the component when it is powered on. From t...
Page 70 - From the domain shell, you cannot power on power supplies, Repeater
54 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 To 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. To power ...
Page 71 - reboot
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 confirmation. -n does not execute this command. Confirmation is requested. -h displays help for this comm...
Page 72 - To reboot the system controller (; Are you sure you want to reboot the System Controller now? [no]
56 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 Examples To 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]
Page 73 - reset; reset
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 displa...
Page 75 - restoreconfig
Chapter 3 System Controller Alphabetical Command Reference 59 restoreconfig Restores the platform and domain configurations 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 confirmati...
Page 76 - path
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 “To Use the dumpconfig Command to Save the Current Platfo...
Page 77 - NVCI has been restored
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)
Page 78 - resume; Exits the domain shell and resumes access to the domain console.; domain shell
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...
Page 80 - setdate; Sets the date and time.
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 ...
Page 81 - datehost sets the current time using
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 asschost...
Page 82 - date; showdate
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 invokedfrom the platform, will have no effect on the date and time in each domain and viceversa. You can set up to five differ...
Page 83 - datehost
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. To set the date and time on the pla...
Page 84 - Command Example Setting the Time Zone to Eastern
68 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 To set just the time zone for Japan Standard Time using offsets from GreenwichMean Time—GMT ( TABLE 3-7 ) and not the date and time, type: To set just the time zone for European Central Time using the time zone...
Page 85 - setdefaults; platform; Options/Parameters—Domain Shell
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—Platf...
Page 86 - If you answer no, the default values are not restored.; You are about to reset all configuration data to default values.
70 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 Description Caution – This command requires that all domains are inactive (not running the OpenBoot PROM, POST, or the Solaris operating environment) and the keyswitch beset to off. When you run this command fr...
Page 87 - on
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 setkeyswi...
Page 88 - Description of the
72 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 For setkeyswitch parameters and descriptions, see TABLE 3-8 . TABLE 3-9 shows the results when you change a keyswitch setting. TABLE 3-8 Description of the setkeyswitch Transition Value Description off Changes ...
Page 90 - setkeyswitch on
74 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 Description Each domain has a virtual keyswitch with five positions: off, standby, on, diag, andsecure. The setkeyswitch command changes the position of the virtual keyswitch to the specified value. The virtual...
Page 91 - To shut down the domain by turning the virtual keyswitch off (; does not properly shut down the Solaris operating; setkeyswitch off
Chapter 3 System Controller Alphabetical Command Reference 75 To shut down the domain by turning the virtual keyswitch off ( CODE EXAMPLE 3-44 ), type: To 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 opera...
Page 92 - part; Parameter Values for the
76 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 setupdomain Configures the domain. Scope domain shell Syntax setupdomain [-p part ] . . . setupdomain -h Options/Parameters -h displays help for this command. -p part configures the specified information and ha...
Page 95 - and the section “To Configure
Chapter 3 System Controller Alphabetical Command Reference 79 Description Configures domain specific values. Configures the domain. You can configure eachdomain differently and independently This command is an interactive command.You are prompted for parameters to configure. See Also password, setda...
Page 96 - The default value displayed by the software for the; Variables for the; Domain Boot Parameters
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” andprompts you to enter...
Page 97 - part configures the specified part and has the following options:
Chapter 3 System Controller Alphabetical Command Reference 81 setupplatform Configures the platform specific variables. Scope platform shell Syntax setupplatform [-p part ]. . . setupplatform -h Options/Parameters -h displays help for this command. -p part configures the specified part and has the f...
Page 98 - syslogd
82 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 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 setupplatform Pa...
Page 99 - off
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 notgoing to be enabled, this field is informational only. Platform Location Location of the system (such as a ...
Page 100 - Network Configuration
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” chapterof the Sun Fire 6800/4810/4800/3800 Systems...
Page 101 - System type
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 P...
Page 103 - addboard, deleteboard; The
Chapter 3 System Controller Alphabetical Command Reference 87 Description Displays the assignment information and status for all of the components in thesystem. For example, CPU/Memory boards, I/O assemblies, fan trays, and so on.For the domain shell, the display shows components assigned to the dom...
Page 105 - Command for the Domain Shell; Output Header Definitions for the
Chapter 3 System Controller Alphabetical Command Reference 89 Example—Domain Shell 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 thesystem controller. The card is deter...
Page 106 - showcomponent; Shows the state of a component.; component; Displays the components that have been blacklisted by the
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 ...
Page 107 - enablecomponent, disablecomponent; showcomponent sb4; Sample Output
Chapter 3 System Controller Alphabetical Command Reference 91 See Also enablecomponent, disablecomponent , and the “Disable Component” section of the “Troubleshooting” chapter in the Sun Fire 6800/4810/4800/3800 SystemsPlatform Administration Manual for a step-by-step procedure on displaying acompon...
Page 109 - Displays the date and time.
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 dis...
Page 112 - To display parameters assigned by the; Command Example
96 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 Examples To 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 Doma...
Page 113 - To display the verbose output of parameters assigned by the; xxxxxxxx
Chapter 3 System Controller Alphabetical Command Reference 97 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 St...
Page 114 - To display boot parameter information (; ACLs; showdomain -p bootparams
98 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 To 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 Displ...
Page 115 - showenvironment; board; type multiple board names.
Chapter 3 System Controller Alphabetical Command Reference 99 showenvironment Displays the current environmental status, temperatures, currents, voltages, and fanstatus, for the system (platform shell) or the current domain (domain shell). Scope platform shell, domain shell Syntax for the Platform S...
Page 116 - part shows a specific part (; Parts for
100 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 -p part shows a specific part ( TABLE 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 w...
Page 118 - Platform Shell and Domain Shell Example
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 showe...
Page 119 - Platform Shell and Domain Shell Example (Continued)
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 ...
Page 120 - showkeyswitch; Displays the keyswitch setting.
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] sho...
Page 121 - howkeyswitch; howkeyswitch; keyswitch is: standby
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> showkeyswitc...
Page 122 - showlogs; domain ID
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 controller messagebuffer. Scope platform shell, domain shell Syntax for the Platform Shell showlogs [-d domain ID ] [-v] showlogs -h S...
Page 123 - displays the output of the; Sample Output of the; Controller
Chapter 3 System Controller Alphabetical Command Reference 107 loghost), then the messages will also be logged to the loghost for storage. Note thatstoring the messages is only temporary and will not survive a system reboot or aloss in power. See Also setupdomain, setupplatform, showdomain, showplat...
Page 124 - showplatform; domainID specifies a domain to show (
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 Optio...
Page 125 - sc; Output for a Sun Fire 6800 System
Chapter 3 System Controller Alphabetical Command Reference 109 ■ sc shows the system controller configuration. ■ 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 pla...
Page 126 - shows the; domainname
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 S...
Page 127 - Output for a Sun Fire 6800 System (Continued)
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:x...
Page 129 - CANSAVE
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 first windows displayed in the output ...
Page 131 - RTOS; showsc; SC uptime: 1 hour 30 minutes 11 seconds
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...
Page 132 - testboard; When testing a CPU/Memory board that is assigned to a domain and the
116 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001 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 boar...
Page 133 - showcomponent, showboards; in the domain A shell (; Command output not shown.
Chapter 3 System Controller Alphabetical Command Reference 117 See Also showcomponent, showboards Example To test CPU/Memory board, sb0 in the domain A shell ( CODE EXAMPLE 3-64 ), type: CODE EXAMPLE 3-64 testboard Example Testing CPU/Memory Board sb0 schostname : A> testboard sb0 < Command ou...
Page 135 - or
Glossary 119 Glossary domain shell With the domain shell, you have access to system controller commands thatyou 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 syste...
Page 137 - Index
Index 121 Index A active board state, 6 addboard command, 17 adding board to a domain, 17 assigned board state, 6available board state, 6 B board state Active, 6Assigned, 6Available, 6 board states, 6boards CPU/Memory testing, 116 listing assignment information and status, 87powering off, 49, 50, 53...