Page 1 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-11 April 2001, Revision A Send comments about this document to: docfeedback@sun.com...
Page 2 Sun, Sun Microsystems, the Sun logo, AnswerBook2, docs.sun.com, OpenBoot, Sun Fire, and Solaris are trademarks, registered trademarks, or service marks of Sun Microsystems, Inc. in the U.S. and other countries. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc.
Page 3: Table Of Contents
Contents Preface xv Introduction to the System Controller 1 Platform Administration 2 Platform Shell 2 Platform Console 2 Domain Administration 3 Domain Shell and Domain Console 3 Accessing the System Controller Main Menu 5 Accessing the System Controller Main Menu Using telnet 5 To Access the System Controller Main Menu and Enter the Platform Shell Using telnet 5 To Access the System Controller Main Menu and Enter a Domain Shell Using...
Page 4 System Controller Navigation 10 To Enter the Domain Console From the Domain Shell If the Domain Is Inactive 13 To Enter the Domain Shell From the Domain Console 14 To Get Back to the Domain Console From the Domain Shell 14 To Enter a Domain From the Platform Shell 15 To Terminate a Session With telnet If You Are Connected to the Ethernet Port 15...
Page 5 Alphabetical Listing of System Controller Commands 25 addboard 25 break 28 connections 30 console 32 deleteboard 35 disablecomponent 37 disconnect 41 dumpconfig 43 enablecomponent 46 flashupdate 49 help 56 history 58 password 59 poweroff 61 poweron 64 reboot 67 reset 69 restoreconfig 72 resume 74 setdate 75...
Page 6 showdate 101 showdomain 103 showenvironment 107 showkeyswitch 111 showlogs 113 showplatform 115 showsc 120 testboard 121 Glossary 123 Index 125 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • April 2001...
Page 7 Figures Navigating Between the Platform Shell and the Domain Shell 11 FIGURE 1-1 Navigating Between the Domain Shell, the OpenBoot PROM, and the Solaris Operating FIGURE 1-2 Environment 12 Navigating Between the OpenBoot PROM and the Domain Shell 13 FIGURE 1-3...
Page 8 viii Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • April 2001...
Page 9 Tables Maximum Number of Active Domains by System Type and Partition Mode 4 TABLE 1-1 Devices That Can Be Managed in the Platform Shell 18 TABLE 2-1 Devices That Can Be Managed in a Domain 19 TABLE 2-2 Board States 19 TABLE 2-3 Status Field Displayed in the showboards Command 20 TABLE 2-4...
Page 10 poweron Command Example Showing Powering On All CPU/Memory Boards and I/O TABLE 2-16 Assemblies in Domain A 66 Time Zone Abbreviations, Time Zone Name, and Offsets From Greenwich Mean Time 76 TABLE 2-17 setdate Command Example in the Platform Shell 77 TABLE 2-18 setkeyswitch Values and Description 82 TABLE 2-19...
Page 11 Code Samples Accessing the System Controller With telnet and Entering the Platform Shell 6 CODE EXAMPLE 1-1 Accessing a Domain Shell Using the telnet Command 7 CODE EXAMPLE 1-2 Accessing a Domain Shell From the Domain Console 8 CODE EXAMPLE 1-3 Accessing a Domain Shell From the Domain Console 10 CODE EXAMPLE 1-4 Obtaining a Domain Shell From the Domain Console 14...
Page 12 disablecomponent Command Example Adding I/O Assembly 9, Port 0 and Bus 1 and CODE EXAMPLE 2-14 Also I/O Assembly 8, I/O Card 2 to the Blacklists 40 Disconnecting a Session From the System Controller Platform Shell 42 CODE EXAMPLE 2-15 Disconnecting a Session From the System Controller Platform Console 42 CODE EXAMPLE 2-16 disconnect Example Showing Disconnecting a Session From the Domain A Shell 42...
Page 13 setdate -r Command Example Setting the Date From a Date Host 78 CODE EXAMPLE 2-40 setdate -t Command Example Setting the Time Zone to Pacific Standard Time Using CODE EXAMPLE 2-41 the Offset From Greenwich Mean Time 78 setdate -t Command Example Setting the Time Zone to Eastern Standard Time Using CODE EXAMPLE 2-42 Time Zone Abbreviations and Also Setting the Date 78 setdate -t Command Example Setting the Time Zone to Japan Standard Time Using...
Page 14 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • April 2001...
Page 15: Preface
Preface This book describes how to use the system controller command line interface, which controls the system functions and provides environmental monitoring plus domain and hardware control. With the system controller software, you can configure the platform and domains, as well as power on and off domains, power supplies, fans, and other components.
Page 16 Chapter 2 explains system controller command syntax, command names, and command arguments. It also provides in tabular form a summary of all of the system controller commands and provides complete descriptions, with syntax, and examples for each system controller command. Typographic Conventions Typeface Meaning...
Page 17 Title Part Number Service Sun Fire 6800/4810/4800/3800 Systems 805-7363 Service Manual Service 806-6781 Sun Fire 4810/4800/3800 System Cabinet Mounting Guide System Administration Sun Fire 6800/4810/4800/3800 Systems 805-7373 Platform Administration Manual Accessing Sun Documentation Online The docs.sun.com web site enables you to access a select group of Sun technical documentation on the Web.
Page 18 Sun Welcomes Your Comments Sun is interested in improving its documentation and welcomes your comments and suggestions. You can email your comments to Sun at: docfeedback@sun.com Please include the part number of your document, which is on the title page, in the subject line of your email.
Page 19: Introduction To The System Controller
C H A P T E R Introduction to the System Controller This chapter introduces you to the system controller. It explains the platform shell and the domain shell. It describes the responsibilities of the platform administrator and the domain administrator . It provides step-by-step procedures and illustrations on how to navigate with the system controller and between the system controller and the Solaris operating environment and the OpenBoot PROM.
Page 20: Platform Administration
Platform Administration The platform administration function provides services for the domain and provides access to hardware available within the platform. With this function, you can manage hardware resources across domains. Some of the functions include: Logically grouping hardware to create domains with the addboard and deleteboard commands Setting passwords with the password command Monitoring and controlling power to the components within a platform.
Page 21: Domain Administration
Domain Administration Some of the he domain administrator’s responsibilities include: Controlling the virtual domain keyswitch. A domain administrator can put the keyswitch in on, off, diag, standby, or secure keyswitch positions. Managing the domain using the Sun ™ Management Center software for the Sun Fire 6800/4810/4800/3800 systems.
Page 22: Table 1-1 Maximum Number Of Active Domains By System Type And Partition Mode
With the Sun Fire 6800 system, domains A and B are in partition 0 and domains C and D are in partition 1. With the Sun Fire 4810/4800/3800 systems, domain A is in partition 0 and domain C is in partition 1.
Page 23: Accessing The System Controller Main Menu
Accessing the System Controller Main Menu This section describes the following: “Accessing the System Controller Main Menu Using telnet” on page 5 “Accessing the System Controller Main Menu Using the Serial Port” on page 9 Accessing the System Controller Main Menu Using telnet This section describes: “To Access the System Controller Main Menu and Enter the Platform Shell Using...
Page 24: To Access The System Controller Main Menu And Enter A Domain Shell Using Telnet
Accessing the System Controller With telnet and Entering the CODE EXAMPLE 1-1 Platform Shell % telnet schostname Trying xxx.xxx.xxx.xxx Connected to schostname-sc0. Escape character is ’^]’. System Controller schostname-sc0 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: 0...
Page 25 Accessing a Domain Shell Using the telnet Command CODE EXAMPLE 1-2 % telnet schostname Trying xxx.xxx.xxx.xxx Connected to schostname-sc0. Escape character is ’^]’. System Controller schostname-sc0: 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: 1...
Page 26 b. At the telnet> prompt type send break (see CODE EXAMPLE 1-3 Accessing a Domain Shell From the Domain Console CODE EXAMPLE 1-3 ok Ctrl-] telnet> send break schostname:A > Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • April 2001...
Page 27: Accessing The System Controller Main Menu Using The Serial Port
Accessing the System Controller Main Menu Using the Serial Port With the serial port, you can connect to one of three types of devices: ASCII terminal Network terminal server (NTS) Workstation The procedure is different for each type of device. To Access the System Controller Main Menu if You Connected the System Controller Serial Port to an ASCII Terminal...
Page 28: To Obtain The Domain Shell Prompt From The Domain Console Prompt
To Obtain the Domain Shell Prompt From the Domain Console Prompt If the domain is active and the domain keyswitch is set to on, diag, or secure (you are running the Solaris operating environment, are in the OpenBoot PROM, or are running POST), perform the following steps: 1.
Page 29 Domain shell Type: telnet schostname 500x Type: disconnect Type: disconnect Type: disconnect Type: console domainID Type: telnet schostname 5000 Platform shell Navigating Between the Platform Shell and the Domain Shell FIGURE 1-1 where: In the telnet command in , 5000 is the platform shell. FIGURE 1-1 x is: 1 for domain A...
Page 30 Solaris Press: CTRL ] At the telnet> operating prompt type: environment send break login: OpenBoot PROM Type: resume Type: break Domain shell schostname:domainID Navigating Between the Domain Shell, the OpenBoot PROM, and the Solaris FIGURE 1-2 Operating Environment Note – Note that in typing the break command suspends the Solaris FIGURE 1-2 operating environment.
Page 31: To Enter The Domain Console From The Domain Shell If The Domain Is Inactive
OpenBoot PROM Press: CTRL ] At the telnet> prompt type: send break Domain shell schostname:domainID Type: resume Navigating Between the OpenBoot PROM and the Domain Shell FIGURE 1-3 When you enter a domain console, you will be connected with the Solaris operating environment console.
Page 32: To Enter The Domain Shell From The Domain Console
To Enter the Domain Shell From the Domain Console 1. Press and hold the CTRL key while pressing the ] key to get to the telnet> prompt ( CODE EXAMPLE 1-5 2. Type send break at the telnet prompt. The schostname:A> (or B>, C>, D>) prompt is displayed. Obtaining a Domain Shell From the Domain Console CODE EXAMPLE 1-5 ok Ctrl-]...
Page 33: To Enter A Domain From The Platform Shell
To Enter a Domain From the Platform Shell Note – This example shows entering an inactive domain. Type: schostname: SC> console -d a Connected to Domain A Domain Shell for Domain A schostname:A > If the OpenBoot PROM is running, you are returned to the domain A console. If the keyswitch is set to off or standby, you are returned to the domain A shell.
Page 34: To Terminate A Session With Tip If You Are Connected To The Serial Port
To Terminate a Session With tip If You Are Connected to the Serial Port If you are connected to the System Controller board with the serial port, use the disconnect command to terminate the system controller session then use a tip (Transfer Internet Protocol) command to terminate your tip session.
Page 35: System Controller Alphabetical Command Reference
C H A P T E R System Controller Alphabetical Command Reference This chapter describes system controller command line interface, command syntax, and command arguments. It provides, in tabular form, a summary of all of the system controller commands. It also provides complete descriptions and examples for each system controller command.
Page 36: Command Names
Command Names Most system controller commands are in the form of verbnoun. Command names are in the English language. System controller commands are case insensitive. Command Arguments Some system controller commands have arguments and some system controller commands do not have arguments. Depending on the command, some arguments are followed by flags and others are not.
Page 37: Board States
shows the devices that can be managed in a domain. TABLE 2-2 Devices That Can Be Managed in a Domain TABLE 2-2 Device Description Device Name CPU/Memory boards SB0, SB1, SB2, SB3, SB4, SB5 I/O Assemblies IB6, IB7, IB8, IB9 Board States lists the board states.
Page 38: Status
Status describes the Status field displayed in the showboards command. TABLE 2-4 Status Field Displayed in the showboards Command TABLE 2-4 Test Status Description Passed All board components passed testing. Failed The board failed testing and is not usable. This could also indicate corrupt or incompatible firmware.
Page 39: Clearing An Entry
If you type the following line, board sb2 is added to domain A and the deleteboard command is not executed. schostname: SC> addboard -d a sb2 # deleteboard sb2 Another example of the pound sign (#) signifying the start of a comment at the beginning of a command line is: schostname: SC>...
Page 40 System Controller Command Summary (Continued) TABLE 2-5 Command Description Platform Shell Domain Shell Saves the system controller configuration to dumpconfig a server. Deletes a component from the blacklist. enablecomponent Updates the ﬂash PROMs on CPU/Memory flashupdate boards, I/O assemblies, and the System Controller boards.
Page 41: Status
System Controller Command Summary (Continued) TABLE 2-5 Command Description Platform Shell Domain Shell Displays the conﬁguration and status of the showdomain domain. Displays the current environmental status, showenvironment temperatures, currents, and voltages. Displays the virtual keyswitch setting. showkeyswitch Displays the logs. showlogs Displays the conﬁguration of the platform, showplatform...
Page 42: Domain States
Domain States In the showplatform and showdomain commands, one of the fields in the command output is domain status. The major values of domain status are: Active-Solaris Active-OpenBoot PROM Active-Booting Running POST Standby Powered off Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • April 2001...
Page 43: Alphabetical Listing Of System Controller Commands
Alphabetical Listing of System Controller Commands The following sections describe the system controller commands. addboard Assigns a board or a slot to a domain. Scope platform shell, domain shell Syntax addboard -d domainID system_board_name [system_board_name . . .] addboard -h Options/Parameters -h displays help for this command.
Page 44 Description Assigns system_board_name to the specified domain within the platform shell or to the current domain. The board state must be Available. To display the board states, use the showboards command. For more information on board states, see “Board States” on page 19. In order to assign a board to a domain, the board name must be listed in the Access Control List (ACL) for domain shells.
Page 45 Example—Domain Shell To add board name sb2 to the current domain, type: addboard Example in the Domain Shell CODE EXAMPLE 2-2 schostname: A> addboard sb2 If you cannot assign a board to a domain in the domain shell, this is most likely because the board is not listed in the ACL.
Page 46: Break
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 command if confirmation is requested.
Page 47 Example shows using the break command to pause the Solaris operating CODE EXAMPLE 2-3 environment and enter the OpenBoot PROM. break Command Example in the Domain Shell CODE EXAMPLE 2-3 schostname: A> break Chapter 2 System Controller Alphabetical Command Reference...
Page 48: Connections
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 domainID shows connections to the specified domain (a, b, c, or d). Description Displays hosts currently connected to the system controller.
Page 49 Example—Platform Shell connections Command for the Platform Shell CODE EXAMPLE 2-4 schostname: SC> connections Hostname Idle Connected on Connected to -------- ---- ------------ ------------ XXXXXXX Jan 01 00:00 Platform Jan 01 00:21 describes the headers in the output for TABLE 2-7 CODE EXAMPLE 2-4 Header Description for CODE EXAMPLE 2-4...
Page 50: Console
console Connects to a domain from the platform. Scope platform shell Syntax console [-d] domainID console -h Options/Parameters -h displays help for this command. [-d] domainID is the domain to connect to and is a, b, c, or d. The -d parameter is optional and does not need to precede the domainID.
Page 51 Examples—Platform Shell When there is no password initialized for this domain: console Example With the -d Option and No Password Assigned CODE EXAMPLE 2-5 Accessing Domain B schostname: SC> console -d b Connected to Domain B Domain Shell for Domain B schostname: B>...
Page 52 When a password is set for this domain, you could also type: console Example Without the -d Option and A Password Assigned CODE EXAMPLE 2-8 Accessing Domain A schostname: SC> console a Password: Permission Granted Connected to Domain A schostname: A>...
Page 53: Deleteboard
deleteboard Unassigns a board or a slot 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 -h displays help for this command. system_board_name is the board to be deleted.
Page 54 Example—Platform Shell To delete I/O assembly ib7, type: deleteboard Example Showing Deleting I/O Assembly 7 CODE EXAMPLE 2-9 schostname: SC> deleteboard ib7 The platform shell always has permission to add or delete boards. Example—Domain Shell To delete CPU/Memory board sb3 from the current domain, domain A, type: deleteboard Example Showing Deleting CPU/Memory Board 3 CODE EXAMPLE 2-10 schostname:...
Page 55: Disablecomponent
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 TABLE 2-8 TABLE 2-9 system_ /port/physical_bank/logical_bank for the CPU/Memory board board_name system_ /port/bus for an I/O assembly...
Page 56: Table 2-8 Component_Name Descriptions For The Cpu/Memory Board Used In The Disablecomponent Command
component_name Descriptions for the CPU/Memory Board Used in the TABLE 2-8 disablecomponent Command Board or Device Component Name hysical_bank/logical_bank CPU system board_name/port/p CPU/Memory SB0, SB1, SB2, SB3, SB4, SB5 boards system_ board_name) Ports on the P0, P1, P2, P3 CPU/Memory board Physical memory B0, B1 banks on...
Page 57 Description This command adds a component to the blacklist. Blacklisting provides a list of system board 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 when the domain is rebooted.
Page 58 Examples This example of the disablecomponent command adds system_board_name sb4 to the blacklist. disablecomponent Command Example Adding sb4 to the CODE EXAMPLE 2-11 Blacklists schostname: A> disablecomponent sb4 This example of the disablecomponent command adds system_board_name sb0 and CPU port 3 to the blacklist. Note that any memory banks on this CPU processor port are unreachable and are implicitly disabled.
Page 59: Disconnect
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 connection to be terminated. ID is the number displayed under the heading ID for the connections command.
Page 60 Examples To disconnect a session from the system controller platform shell with a telnet connection ( ), type: CODE EXAMPLE 2-15 Disconnecting a Session From the System Controller Platform Shell CODE EXAMPLE 2-15 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: Disconnecting a Session From the System Controller Platform...
Page 61: Dumpconfig
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 can only be ftp. For example: ftp://userid:password@host/path ftp://host/path Note – The hostname you enter must be a complete host name (not a partial one). Note –...
Page 62 Description Use this command after you complete the initial configuration of the platform and the domains. This command saves the system controller configuration to a server. The data files include schostname.nvci and schostname.tod. Caution – Run this command when you change platform or domain configurations. For more information, see the following bulleted list of system controller commands that change the configuration.
Page 63: Table 2-10 Dumpconfig Example
Example dumpconfig Example TABLE 2-10 hostname path_name schostname: SC> dumpconfig -f ftp:// host path_name/schostname. Created: ftp:// nvci host path_name/schostname. Created: ftp:// Chapter 2 System Controller Alphabetical Command Reference...
Page 64: Enablecomponent
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 ( TABLE 2-11 TABLE 2-12 system_board_name/port/physical_bank/logical_bank for CPU/Memory boards system_board_name/port/bus for an I/O assembly system_ /card for an I/O assembly board_name...
Page 65 component_name Descriptions for the I/O Assembly Used in the TABLE 2-12 enablecomponent Command Board or Device Component Name I/O assembly board_name/port/bus or board_name/card system I/O assemblies IB6, IB7, IB8, IB9 system_ board_name) Ports on the I/O P0, P1 assembly Buses on the I/O B0, B1 assembly I/O cards in the I/O...
Page 66: Table 2-13 Enablecomponent Command Example Enabling Cpu/Memory Board 4
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). Examples This example of the enablecomponent command enables CPU/Memory board sb4. This removes CPU/Memory board sb4 from the blacklist. enablecomponent Command Example Enabling CPU/Memory Board 4 TABLE 2-13 schostname:...
Page 67: Flashupdate
flashupdate Updates the flash PROMs in the system controller and the system boards (CPU/Memory boards and I/O assemblies). The source flash image can be on a server or another board of the same type. Scope platform shell Syntax flashupdate [-y|-n] -f url all|systemboards|scapp|rtos|domainID flashupdate [-y|-n] -f url board [board .
Page 68 -c specifies a board as the source of flash images. source_board is the source board for the flash images. destination_board is the destination board for the flash images. -u automatically updates all of the boards from the board with the highest revision. all updates the system controller and all system boards (CPU/Memory boards and I/O assemblies).
Page 69 All boards that are specified must be powered on and must be capable of being updating with the flashupdate command. Otherwise, the flashupdate command will not execute. Boards that are in a secure domain will not be updated. Any time boards, the scapp, or rtos images are upgraded, check the Release Notes for any notes or special procedures.
Page 70 Example of the flashupdate Command Entering Single-User Mode CODE EXAMPLE 2-19 RTOS version: 17 ScApp version: 5.11.3 SC POST diag level: min Auto Flashupdate S_errno_ECONNREFUSED hostname http:// /5.11.1/sgrtos.flash: cannot open file hostname Retrieving: http:/ /5.11.1/sgrtos.flash Flashupdate failed. Single User Mode The date is Thursday, February 15, 2001, 9:22:00 AM PST.
Page 71 See Also Sun Fire 6800/4810/4800/3800 Systems Platform Administration Manual (for step-by- step procedures on how to update the firmware using flashupdate). flashupdate Command Platform Shell—Examples Note – In the following examples, since the output is very long, only the command syntax you type is in the code box.
Page 72 To update the active System Controller board and the system controller real time operating system (rtos), perform this procedure from the platform console or watch the console output. Type: flashupdate Example Updating the Active System Controller CODE EXAMPLE 2-20 Board and the System Controller Real Time Operating System schostname: SC>...
Page 73 To update the system controller real time operating system (rtos), perform this procedure from the platform console or watch the console output. Type: flashupdate Example Updating the System Controller Real Time CODE EXAMPLE 2-24 Operating System schostname: SC> flashupdate -f ftp://host/path rtos This reboots the system controller.
Page 74: Help
help Without arguments, lists currently available system controller commands. When an argument is supplied, displays command usage of what you specified and a short description. 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 system controller command.
Page 75 Examples To display help information on the addboard command:: help Command Example Displaying Information on the addboard CODE EXAMPLE 2-25 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 To display all commands in the platform shell beginning with show:...
Page 76: History
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 were executed. This command is shown for your shell and displays the last twenty commands only.
Page 77: Password
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 -h displays help for this command. domainID is domain a, b, c, or d. Description Sets the password for the platform or the domain.
Page 78 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.
Page 79: Poweroff
poweroff Powers off a component (power grid, power supply, board, fan tray), or a list of components. Scope platform shell, domain shell Syntax for the Platform Shell poweroff [-y|-n] all|grid#|device_name [device_names . . . ] poweroff -h Syntax for the Domain Shell poweroff [-y|-n] all|device_name [device_names .
Page 80 Description Powers off a component or a list of components. You must specify device_name(s). The components that can be powered off in the platform shell are: all turns off all currently controllable boards. Power grid (grid0, grid1). The Sun Fire 6800 system has two power grids: grid0 and grid1.
Page 81 See Also poweron, setkeyswitch, showboards Examples To power off CPU/Memory board, sb2 from the platform shell, type: poweroff Command Example Showing Powering Off CODE EXAMPLE 2-31 CPU/Memory Board 2 schostname: SC> poweroff sb2 To power off all power supplies and currently controllable boards, type: poweroff Command Example Showing Powering Off All Power CODE EXAMPLE 2-32 Supplies and Currently Controllable Boards in the Platform Shell...
Page 82: Poweron
poweron Powers on a component (power grid, power supply, board, fan tray, or a list of components). Scope platform shell, domain shell Syntax for the Platform Shell poweron all|grid#|device_name [device_names . . . ] poweron -h Syntax for the Domain Shell poweron all|device_name [device_names .
Page 83 Description Powers on a device or a list of devices You must specify device_name(s). The components that can be powered on in the platform shell are: all is all power supplies and boards. Power grid (grid0, grid1). The Sun Fire 6800 system has two power grids: grid0 and grid1.
Page 84: Table 2-14 Poweron Command Example Showing Powering On Cpu/Memory Board 2
Examples To power on CPU/Memory board, sb2 from the platform shell, type: poweron Command Example Showing Powering On CPU/Memory Board 2 TABLE 2-14 schostname: SC> poweron sb2 To power on I/O assembly, ib7, type: poweron Command Example Showing Powering On I/O Assembly 7 TABLE 2-15 schostname: SC>...
Page 85: Reboot
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 command. Description Reboots the system controller. The reboot command will not change any configuration settings.
Page 86 Example To reboot the system controller, type: schostname: SC> reboot To reboot the system controller with the -n option, type: schostname: SC> reboot -n Are you sure you want to reboot the System Controller now? no (-n) The -n option prompts you with the Are you sure . . . prompt to answer. Type y if you are sure you want to reboot the system controller.
Page 87: Reset
reset Resets the domain (in a domain shell) or the other system controller (in the platform shell). Scope platform shell, domain shell Syntax for the Platform Shell reset [-y|-n] sscx reset -h Syntax for the Domain Shell Note – In the domain shell, typing reset, without options, is the same as typing reset -x.
Page 88 Options/Parameter—Domain Shell -h displays help for this command. -x resets via XIR (externally initiated reset). Uses XIR to try to obtain diagnostic data (default). -a reset is equivalent to the OpenBoot PROM reset-all command. -y resets even if the domain is active. -n does not reset if the domain is active.
Page 89 Examples To reset the domain (from a domain shell), type:: reset Command Example From Domain A CODE EXAMPLE 2-35 schostname: A> reset This command uses XIR (externally initiated reset) to try to obtain diagnostic data. To perform the equivalent operation as the OpenBoot PROM reset-all command, type: reset -a Command Example From Domain A CODE EXAMPLE 2-36...
Page 90: Restoreconfig
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 confirmation. -n does not execute this command is confirmation is required. -f specifies a URL to restore from.
Page 91 Use this command when the System Controller board failed and after a working System Controller board is installed. You can also use this command when you want to restore the previous system controller configuration. When the system controller configuration is restored, the system controller is rebooted.
Page 92: Resume
resume Exits the domain shell and resumes access to the domain console. Scope domain shell Syntax resume resume -h Options/Parameters -h displays help for this command. Description Exits the domain shell and resumes access to the domain console. See Also Example resume Command Example in Domain A CODE EXAMPLE 2-39...
Page 93: Setdate
setdate Sets the date, time, and time zone for the platform and for domains. Scope platform shell, domain shell Syntax setdate [-v] [-t tz] [mmdd]HHMM[[cc]yy[.SS] setdate [-v] [-r datehost] setdate [-v] -t tz setdate [-v] -t GMT<+|->offset from GMT ( TABLE 2-17 setdate -h Options/Parameters...
Page 94: Table 2-17 Time Zone Abbreviations, Time Zone Name, And Offsets From Greenwich Mean Time
Time Zone Abbreviations, Time Zone Name, and Offsets From Greenwich TABLE 2-17 Mean Time Offset From Greenwich Mean Time Time Zone Abbreviation Time Zone Name (GMT) Australian central time GMT+9.5 Australian eastern time GMT+10 Argentina standard time GMT-3 Arabic (Egypt) standard time GMT+2 Alaska standard time GMT-9...
Page 95: Table 2-18 Setdate Command Example In The Platform Shell
Time Zone Abbreviations, Time Zone Name, and Offsets From Greenwich TABLE 2-17 Mean Time (Continued) Offset From Greenwich Mean Time Time Zone Abbreviation Time Zone Name (GMT) Pacific standard time GMT-8 Solomon standard time GMT+11 Universal Time Coordinated GMT+0 Vietnam standard time GMT+7 Description Sets the date and time for the platform and domains.
Page 96 To set the date from a date host: setdate -r Command Example Setting the Date From a Date Host CODE EXAMPLE 2-40 schostname: SC> setdate -r datehost 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 ( ), type:...
Page 97: Setdefaults
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] [-a] setdefaults -h Options/Parameters -y does not prompt for confirmation. The option reboots the system and sets the defaults.
Page 98 Description This command does the following: Sets the system controller to the default values. When invoked for a domain, this command sets the defaults for that domain only. When invoked from the platform, this command sets the defaults for all domains and the platform. Erases all platform and domain configurations (platform).
Page 99: Setkeyswitch
setkeyswitch Changes the position of the virtual keyswitch to the specified value. Scope platform shell, domain shell Syntax for the Platform Shell setkeyswitch [-y|-n] -d domainID off setkeyswitch -h Syntax for the Domain Shell setkeyswitch [-y|-n] [off|standby|on|diag|secure] setkeyswitch -h Options/Parameters -h displays help for this command.
Page 100: Table 2-19 Setkeyswitch Values And Description
For setkeyswitch parameters and descriptions, see TABLE 2-19 setkeyswitch Values and Description TABLE 2-19 Value Description 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.
Page 101 Results of Changing the Keyswitch From the Current Setting to a New Setting TABLE 2-20 (Continued) Current Keyswitch New Keyswitch Setting Result secure break and reset are not ignored. 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.
Page 102: Table 2-21 Setkeyswitch On Example
See Also showkeyswitch Examples To turn the virtual keyswitch on and power on the domain, type: setkeyswitch on Example TABLE 2-21 schostname: A> setkeyswitch on To shut down the domain by turning the virtual keyswitch off, type: setkeyswitch off Example TABLE 2-22 schostname: A>...
Page 103: Setupdomain
setupdomain Sets up domain specific parameter values and 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 has the following options: bootparams configures the boot parameter information.
Page 104 Example Variables for the setupdomain Command CODE EXAMPLE 2-46 schostname: A> setupdomain Domain Boot Parameters ---------------- diag-level [off]: 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 name or the IP address of the loghost for this domain.
Page 105: Table 2-24 Parameter Values For The Setupdomain Command
Parameter Values for the setupdomain Command TABLE 2-24 Parameter Value Description diag-level 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.
Page 106 Parameter Values for the setupdomain Command (Continued) TABLE 2-24 Parameter Value Description OBP.use-nvramrc? This parameter is the same as the OpenBoot PROM nvramrc? parameter. This parameter uses aliases that are stored in nvramrc. The OpenBoot PROM executes the script stored in true nvramrc if this parameter is set to true.
Page 107 Parameter Values for the setupdomain Command (Continued) TABLE 2-24 Parameter Value Description 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 host for this domain.
Page 108: Setupplatform
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 following options: acls is ACLs (Access Control List) - clears the boards from the ACL + adds all boards to the ACL -a board .
Page 109: Table 2-25 Setupplatform Parameter Values
setupplatform Parameter Values TABLE 2-25 Parameter Description If the answer is no, leave all network parameters as Is the System Controller on a unconfigured Network? • DHCP means the system controller network configuration Use DHCP or static network is retrieved from a DHCP server. settings? •...
Page 110 setupplatform Parameter Values (Continued) TABLE 2-25 Parameter Description Authentication string for SNMP readers. The default is Public Community String P-public. Authentication string for readers and writers. The default is Private Community String P-private. Default value is to have all slots assigned to all domains. ACL for Domain A •...
Page 111 Example Output From setupplatform Command CODE EXAMPLE 2-47 schostname: SC> setupplatform Network Configuration --------------------- Is the System Controller on a network? [yes] Network settings? [static]: Hostname []: IP Address []: Netmask []: Gateway []: DNS Domain []: Primary DNS Server []: Secondary DNS Server []: Loghost [ ]: SNMP...
Page 112: Showboards
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 showboards [-ev] [-y|-n] -d domainID] [-p part] . . . showboards -h Options/Parameters -e includes empty slots in the output.
Page 113 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, but not assigned to any other domain.
Page 114: Table 2-26 Output Header Definitions For The Showboards -V Command
showboards -v Command for the Platform Shell (Continued) CODE EXAMPLE 2-49 A152 Power Supply A152 Power Supply A152 Power Supply Fan Tray Low Speed Fan Tray Low Speed Fan Tray Low Speed Fan Tray Low Speed Repeater Board Repeater Board Repeater Board Repeater Board /N0/SB0...
Page 115 Output Header Definitions for the showboards -v Command (Continued) TABLE 2-26 Header Description Domain Indicates which domain the board belongs to: Possible values are: • A-D—The Sun Fire 6800 systems can have up to four active domains (A – D). The other mid-range systems can have up to four domains, but only two domains can be active domains.
Page 116: Showcomponent
showcomponent Shows the state of a component. Scope platform shell, domain shell Syntax showcomponent board_name showcomponent -h Options/Parameters -h displays help for this command. Includes component_name syntax. boardname for CPU/Memory boards is SB0 - SB5 boardname for I/O assemblies is IB6 - IB9 Description Shows the state of a component and details about the components on a board.
Page 117 Examples shows sample output for the showcomponent sb4 command. CODE EXAMPLE 2-51 The abbreviations for the Component field are: Node name 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 –...
Page 118 where: Component is the name of the board and its components. Status is the status of the board or component. Pending POST is the status of POST (passed or failed). Description is a description of the board or component. shows sample output for the showcomponent ib6 command. CODE EXAMPLE 2-52 The abbreviations for the Component field are: Node name...
Page 119 showdate Displays the current date and time for the platform or domain. Scope platform shell, domain shell Syntax showdate [-t] [-v] showdate -h Options/Parameters -h displays help for this command. -t lists available time zones. -v is verbose mode. Description Displays the current date and time for the platform.
Page 120 Example—Platform Shell showdate Command for the Platform Shell CODE EXAMPLE 2-53 schostname: SC> showdate Mon Apr 03 12:31:40 EDT 2001 Example—Domain Shell showdate Command for the Domain Shell CODE EXAMPLE 2-54 schostname: A> showdate Mon Apr 03 12:31:40 EDT 2001 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual •...
Page 121 showdomain Displays the domain parameter settings, which is the status and non-configurable information for the current domain. Scope domain shell Syntax showdomain [-v] [-p part]. . . showdomain -h Options/Parameters This command without any arguments displays all the parameter values configured by the setupdomain command.
Page 122 Example To display parameters assigned by the setupdomain command, type showdomain. showdomain Command Example CODE EXAMPLE 2-55 schostname: A> showdomain Domain Solaris Nodename Domain Status Keyswitch ------ ---------------- ------------- --------- Powered Off Domain Boot Parameters ---------------------- diag-level = off verbosity-level = min error-level = max interleave-scope = within-board interleave-mode = optimal...
Page 123 showdomain -v Command Example CODE EXAMPLE 2-56 schostname: A> showdomain -v Domain Solaris Nodename Domain Status Keyswitch ------ ---------------- ------------- --------- Powered Off Domain Boot Parameters ---------------------- diag-level = off verbosity-level = min error-level = max interleave-scope = within-board interleave-mode = optimal reboot-on-error = true OBP.use-nvramrc? = true OBP.auto-boot? = false...
Page 124 To display boot parameter information, type: showdomain -p bootparams Example Displaying Boot Parameter CODE EXAMPLE 2-57 Information schostname: A> showdomain -p bootparams diag-level = off verbosity-level = min error-level = max interleave-scope = within-board interleave-mode = optimal reboot-on-error = false OBP.use-nvramrc? = true OBP.auto-boot? = false OBP.error-reset-recovery = sync...
Page 125 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 [-p part] showenvironment [-ltvuw] [-d domainID] showenvironment [-ltvuw] device_name showenvironment -h Syntax for the Domain Shell [-p part]...
Page 126: Table 2-27 Showenvironment -P Part Descriptions
device_name is the name of the board. Displays information for this board only. showenvironment -p part Descriptions TABLE 2-27 Report Description currents Currents (power supplies only) faults Displays only measurements that are above High or below Low temps Shows temperatures only. voltage Shows voltages only.
Page 127 showenvironment Output Header Description (Continued) TABLE 2-28 Header Value Description Amps Age of the reading being displayed (seconds) Status Values for Status. See the Value column Value exceeded Max threshold (fault condition) high Value below High threshold (fault condition) Value exceeded Low threshold (warning condition) Value below Min threshold (warning condition) Value is within range (within Low and High)
Page 128 showenvironment Platform Shell and Domain Shell Example CODE EXAMPLE 2-58 schostname: SC> showenvironment Slot Device Sensor Value Units Status ---- ------ ------ ----- ----- ------ SSC0 SBBC 0 Temp. 0 Degrees C 7 sec Board 0 1.5 VDC 1.51 Volts DC 1 sec /NO/SB2 Board 0 3.3 VDC...
Page 129 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 help for this command. -v is verbose mode. -d domainID (platform shell only) is a, b, c, or d.
Page 130 Examples showkeyswitch Example Showing the Keyswitch Set to On CODE EXAMPLE 2-59 schostname: A> showkeyswitch key switch is: on showkeyswitch Example Showing the Keyswitch Set to Off CODE EXAMPLE 2-60 schostname: A> showkeyswitch key switch is: off showkeyswitch Example Showing the Keyswitch Set to Standby CODE EXAMPLE 2-61 schostname: A>...
Page 131 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 [-d domain ID] [-v] showlogs -h Syntax for the Domain Shell showlogs [-v] showlogs -h Options/Parameters -h displays help for this command.
Page 132 See Also setupdomain Examples The examples for this command are very verbose and difficult to incorporate. Therefore, examples are not included. Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • April 2001...
Page 133 showplatform This command displays all configuration variables for this platform. Scope platform shell Syntax showplatform [-v] [-d domainID] [-p part] showplatform -h Options/Parameters -h displays help for this command. -d domainID specifies a domain to show (a, b, c, or d). -p part displays information on a speciﬁc part.
Page 134 Description This command displays all configuration variables for this platform, including: Network attributes of the platform ACLs for each domain Domain status SNMP information Loghosts Partition configuration Mac address, host ID, and newly added system serial number See Also setupplatform, showdate Example showplatform Output for a Sun Fire 6800 System CODE EXAMPLE 2-62...
Page 135 showplatform Output for a Sun Fire 6800 System (Continued) CODE EXAMPLE 2-62 Loghost for Domain B: Loghost for Domain C: Loghost for Domain D: 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...
Page 136 showplatform -v Output for a Sun Fire 6800 System (Continued) CODE EXAMPLE 2-63 Gateway: xxx.xxx.xxx.xx0 DNS Domain: Primary DNS Server: xxx.xxx.x.xxx Secondary DNS Server: xxx.xxx.x.xxx MAC Address HostID ----------- ------ xx:xx:xx:xx:xx:xx xxxxxxxx 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...
Page 137 showplatform -v Output for a Sun Fire 6800 System (Continued) CODE EXAMPLE 2-63 ----- SC POST diag Level: off Partition Mode -------------- Chassis is in dual partition mode. schostname: SC> Definitions of Headings for Status of All Domains in CODE EXAMPLE 2-62 TABLE 2-29 Headers for CODE EXAMPLE 2-62...
Page 138 showsc Displays the uptime and version information about the system controller. Scope platform shell Syntax showsc [-h][-v] Options/Parameters -h displays help for this command. -v is verbose mode. Description Displays the version and uptime information for the system controller. See Also Example showsc Command CODE EXAMPLE 2-64...
Page 139 testboard Tests the CPU/Memory board name you specify at the command line. Scope platform shell, domain shell Syntax testboard board_name testboard -h Options/Parameters -h displays help for this command. board_name for the CPU/Memory board is SB0 – SB5. Description Tests the CPU/Memory board name you specify at the command line. The board status must be either Available or Assigned and the board must be powered on.
Page 140: Table 2-30 Testboard Example Testing Cpu/Memory Board 0
Example To test CPU/Memory board, sb0 in the domain A shell, type: testboard Example Testing CPU/Memory Board 0 TABLE 2-30 schostname: A> testboard sb0 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • April 2001...
Page 141 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>.
Page 142 system controller The system controller consists of the System Controller board and the system controller software. The system controller provides communication pathways for console traffic and other data that needs to be passed between the system controller and the system. The system controller software monitors and controls the system, manages hardware, provides clock failover, manages domain consoles, and configures domains.
Page 143 Index active board state, 19 command history, 58 addboard command, 26 command summary, 21 adding console port board to a domain, 26 commands, 21 assigned board state, 19 CPU/Memory board testing, 121 available board state, 19 current logging configuration, displaying, 113 board state Active, 19 deleteboard command, 35...
Page 144 domains password, setting, 59 resetting, 70 platform shell entering domain A, 15 power grids powering off, 61, 62 powering on, 64, 65 environmental status power supplies displaying, 107, 108 powering off, 61, 62 powering on, 64, 65 powering off power grids, power supplies, or boards, 62 powering on flash PROMs, updating, 50 power grids, power supplies, or boards, 65...
Page 145 testboard command, 121 testing CPU/Memory board, 121 time setting, 75, 77 unassigning a board from the domain, 35 updating the flash PROM, 50 uptime and version information, displaying, 120 version and uptime information, displaying, 120 virtual keyswitch, 83 Index 127...
Page 146 Index 128 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • April 2001...

This manual is also suitable for:

Sun fire 3800 Sun fire 6800 Sun fire 4800

Sun Microsystems Sun Fire 4810 Command Reference Manual

Preface

1 Introduction to the System Controller

2 System Controller Alphabetical Command Reference

Quick Links

Related Manuals for Sun Microsystems Sun Fire 4810

Summary of Contents for Sun Microsystems Sun Fire 4810

This manual is also suitable for:

Table of Contents