Home

Sun Microsystems Sun Fire 6800/4810/4800/3800 User's Manual

Contents

1. ay 09 agent 13 38 30 sp4 scO Platform SC ID 588369 local0 notice Starting SNMP Chapter 3 System Controller Alphabetical Command Reference 107 showplatform Displays the configuration and information for the platform and domain status Scope platform shell Syntax showplatform v d domainID p part showplatform p part showplatform h Options Parameters h displays help for this command d domainID specifies a domain to show a b c or d p part domainID displays information on a specific part Use the options in this list when you specify a domain with the d option These options are the same as the p part options to showdomain where acls shows the Access Control List ACL bootparams shows boot parameter information loghosts shows the log hosts for the domain mac shows MAC addresses for the domain snmp shows SNMP configuration for the domain status shows domain status p part displays information on a specific part Use the options to p part when you do not specify a domain with the ad option where acls shows the Access Control List ACL frame shows FrameManager information log shows log hosts for the platform mac shows the mac addresses hostID and the platform a serial number for the domain and the system controllers network displays the network settings a partition shows the partition mode 108 Sun Fire 6800 4810 4800 3800 Sys
2. Example CODE EXAMPLE 3 47 setupplatform Output schostname SC gt setupplatform etwork Configuration Use DHCP or static network settings DHCP etwork settings static Hostname IP Address etmask Gateway DNS Domain Primary DNS Server Secondary DNS Server Loghosts Loghost Log Facility local0 84 Sun Fire 6800 4810 4800 3800 System Controller Command Reference Manual October 2001 CODE EXAMPLE 3 47 setupplatform Output Continued Platform Description Sun Fire 6800 System type Platform Contact Platform administrator s name Platform Location Geographic system location Enable SNMP Agent yes Trap Hosts SNMP trap host IP address or name Public Community String P public Community string for SNMP readers Private Community String P private Community string for readers and writers SBO SB1 SB2 SB3 SB4 SB5 IB6 SBO SB1 SB2 SB3 SB4 SB5 IB6 SBO SB1 SB2 SB3 SB4 SB5 IB6 SBO SB1 SB2 SB3 SB4 SB5 IB6 ACL for domain A ACL for domain B ACL for domain C ACL for domain D SC POST diag Level min Partition Mode Configure platform for single or dual partition mode schostname SC gt IB7 IB7 IB7 IB7 IB8 IB9 IB8 IB9 IB8 IB9 IB8 IB9 single Chapter 3 System Controller Alphabetical Command Reference 85 showboards Displays the assignment information and status for all of components in th
3. CODE EXAMPLE 3 19 flashupdate Example Updating the Active System Controller Board and the System Controller Real Time Operating System schostname SC gt flashupdate f ftp host path scapp rtos a To upgrade the firmware on a replacement CPU Memory board sb4 destination_board which is a replacement CPU Memory board for CPU Memory board sb0 source_board Type CODE EXAMPLE 3 20 flashupdate Example Updating Replacement CPU Memory Board sb4 schostname SC gt flashupdate c sb0 sb4 Sun Fire 6800 4810 4800 3800 System Controller Command Reference Manual October 2001 help Provides basic help information for commands Scope platform shell domain shell Syntax help command_name partial_command_name help h Options Parameters h displays help for this command command_name is the name of the command partial_command_name can be one letter of the command or a portion of the command name such as show Description The help command without arguments lists currently available commands When an argument is supplied the help command displays a list of commands that begin with the specified argument If only one command is found full help is displayed Otherwise a short description is displayed for each command beginning with the specified argument You can also type a partial command name and basic help information will be returned for all commands matching the partial name The partial
4. Syntax for the Platform Shell addboard d domainID system_board_name system_board_name addboard h Syntax for the Domain Shell addboard system_board_name system_board_name addboard h Options Parameters qd specifies a domainID as an option platform shell only domainID is a b c or d h displays help for this command system_board_name is the board to be added Possible values for system_board_name are sb0 sb5 CPU Memory board or ib6 ib9 I O assembly 16 Sun Fire 6800 4810 4800 3800 System Controller Command Reference Manual October 2001 Description Assigns system_board_name to the specified domain within the platform shell or to the current domain The board state must be Available To display the board state use the showboards command For more information on board states see Board States for CPU Memory Boards and I O Assemblies on page 6 To assign a board to a domain using a domain shell the board name must be listed in the Access Control List ACL for the current domain When a board is listed in the ACL the system controller software is allowed to process addboard requests on that board The platform shell does not use the ACL and can always add boards to a domain The platform shell can also delete boards from a domain and either ignores the ACL or overrides the ACL You configure the ACLs and also restrict the domains a board has access to using the setupplat form command If
5. I O cards in the I O assembly Component Name board_name port bus or board_name card IB6 IB7 IB8 IB9 PO P1 BO B1 C0 C1 C2 C3 C4 C5 C6 C7 the number of cards varies with the 1 0 assembly Sun Fire 6800 4810 4800 3800 System Controller Command Reference Manual October 2001 Description This command adds a component to the blacklist Blacklisting provides a list of components that will not be tested and will not be configured into the domain when you change the domain s keyswitch from an inactive state to an active state or reboot the domain Blacklist a component or device if you believe it may be failing intermittently When you disable any component the subcomponents are also disabled For example if you disable a CPU the Ecache and memory that are also controlled by the CPU is automatically disabled Devices can be the following see TABLE 3 3 and TABLE 3 4 Ports CPU on a CPU Memory board and I O controller on an I O assembly Physical and logical memory banks 1 0 buses 1 0 cards Blacklisting is done on a per domain basis When you run the disablecomponent command in a domain shell the component is blacklisted for the current domain When you run the disablecomponent command from the platform shell the component is disabled in all of the domains Using this command the platform shell blacklists supersede the domain shell blacklists For example if a component is disabled in the platf
6. If the domain is hung there will be no output However when a domain displays no output this does not necessarily mean that the domain is hung Chapter 3 System Controller Alphabetical Command Reference 63 setdate Sets the date and time Scope platform shell domain shell Syntax setdat v t time zone mmdd HHMM setdat v t time zone mmddHHMM cclyy SS setdat v r datehost setdat v t time zone setdat v t GMT lt gt offset from GMT TABLE 3 7 setdate h Options Parameters t time zone sets the time zone using the time zone abbreviation TABLE 3 7 Only non daylight savings time zones can be specified If you are in an area with daylight time or summer time the time and time zone are adjusted automatically for daylight time or summer time t GMT lt gt offset from Greenwich Mean Time GMT TABLE 3 7 mm is the month number dd day is the number in the month HH is the hour number 24 hour clock MM is the minute number cc is the century minus 1 yy is the last two digits of the year number SS is the second number For the century minus 1 value use 21 Twenty first century minus 1 which yields 20 64 Sun Fire 6800 4810 4800 3800 System Controller Command Reference Manual October 2001 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
7. Port 0 and Bus 1 and Also I O Assembly 8 I O Card 2 to the Blacklists schostname A gt disablecomponent ib9 p0 b1 ib8 c2 30 Sun Fire 6800 4810 4800 3800 System Controller Command Reference Manual October 2001 disconnect Disconnects the current or specified connection Scope platform shell domain shell Syntax for the Platform Shell disconnect ID disconnect h Syntax for the Domain Shell disconnect h Options Parameters 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 Description Terminates a connection to the system controller If this command is used with no arguments it disconnects the current session For illustrations of the disconnect command see the chapter System Controller Navigation Procedures in the Sun Fire 6800 4810 4800 3800 Systems Platform Administration Manual If the connection was initiated from another system you will be returned to the remote host If the session was initiated from the platform shell you will see nothing To obtain the prompt press the Return key If you are connected from the serial port then you will return to the main menu See Also connections Chapter 3 System Controller Alphabetical Command Reference 31 Examples To disconnect a session from the system controller platform shell with a telnet connection CODE EXAMPLE 3 13
8. type CODE EXAMPLE 3 13 Disconnecting a Session From the System Controller Platform Shell schostname SC gt disconnect Connection closed by foreign host If you are connected to the system controller platform console with the serial connection you will see the following after typing disconnect CODE EXAMPLE 3 14 CODE EXAMPLE 3 14 Disconnecting a Session From the System Controller Platform Console schostname SC gt disconnect Type 0 for Platform Shell Type 1 for domain A Type 2 for domain B Type 3 for domain C Type 4 for domain D Input To disconnect a session from a system controller domain shell CODE EXAMPLE 3 15 type CODE EXAMPLE 3 15 disconnect Example Showing Disconnecting a Session From the Domain A Shell schostname A gt disconnect Connection closed by foreign host CODE EXAMPLE 3 15 displays a direct connection to the domain and is not a connection to the domain made from the platform Note When you disconnect from a domain shell you will see nothing Press the Return key to obtain the prompt 32 Sun Fire 6800 4810 4800 3800 System Controller Command Reference Manual October 2001 dumpconfig Saves the platform and domain configurations to a server Scope platform shell Syntax dumpconfig f url dumpconfig h Options Parameters h displays help for this command f specifies the URL which must use the ftp protocol The URL must point to a directory and no
9. A gt setupdomain Domain Boot Parameters diag level default verbosity level min error level max interleave scope within board interleave mode optimal reboot on error false OBP use nvramrc lt OBP default gt OBP auto boot lt OBP default gt OBP error reset recovery lt OBP default gt Log hosts Loghost The hostname or the IP address of the loghost for this domain Log Facility local0 Defined by the Solaris operating environment syslogd in etc syslog conf Domain Description A brief description for this domain its function Domain Contact The name of the primary domain administrator Trap Hosts The IP address of the loghost for this domain Public Community String The community string for SNMP readers Private Community String The community string for readers and writers schostname A gt Note The default value displayed by the software for the OBP parameters is lt OBP default gt If you enter an invalid value the system controller displays invalid entry and prompts you to enter a proper value TABLE 3 10 If a value is not specified it retains its current value When an invalid entry is entered it also lists the valid responses Typing a dash clears the entry Current values are displayed in TABLE 3 10 lists the setupdomain parameter values 80 Sun Fire 6800 4810 4800 3800 System Controller Command Reference Manual Oct
10. Inc UNIX is a registered trademark in the United States and other countries exclusively licensed through X Open Company Ltd The OPEN LOOK and Sun Graphical User Interface was developed by Sun Microsystems Inc for its users and licensees Sun acknowledges the pioneering efforts of Xerox in researching and developing the concept of visual or graphical user interfaces for the computer industry Sun holds a non exclusive license from Xerox to the Xerox Graphical User Interface which license also covers Sun s licensees who implement OPEN LOOK GUIs and otherwise comply with Sun s written license agreements Federal Acquisitions Commercial Software Government Users Subject to Standard License Terms and Conditions DOCUMENTATION IS PROVIDED AS IS AND ALL EXPRESS OR IMPLIED CONDITIONS REPRESENTATIONS AND WARRANTIES INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY FITNESS FOR A PARTICULAR PURPOSE OR NON INFRINGEMENT ARE DISCLAIMED EXCEPT TO THE EXTENT THAT SUCH DISCLAIMERS ARE HELD TO BE LEGALLY INVALID Copyright 2001 Sun Microsystems Inc 901 San Antonio Road Palo Alto CA 94303 Etats Unis Tous droits r serv s Ce produit ou document est prot g par un copyright et distribu avec des licences qui en restreignent l utilisation la copie la distribution et la d compilation Aucune partie de ce produit ou document ne peut tre reproduite sous aucune forme par quelque moyen que ce soit sans l autorisation pr alab
11. Public Community String Private Community String ACL for Domain A AG AC AC SC L for L for L for POST Domain B Domain C Domain D diag level off The name of the person who is responsible for this system This name will be used by SNMP Note that if SNMP is not going to be enabled this field is informational only Location of the system such as a room and or the location inside of the room This information will be used by SNMP Note that if SNMP is not going to be enabled this field is informational only IP address or name of the trap hosts SNMP You can define multiple trap hosts Community string for SNMP readers The default is P public Note For SNMP clients such as the Sun Management Center 3 0 software to access the system controller using SNMP their community strings should be set to the same value as the value entered here Community string for readers and writers The default is P private Note For SNMP clients such as the Sun Management Center 3 0 software to access the system controller using SNMP their community strings should be set to the same value as the value entered here Access Control List ACL If the board name is listed in the ACL for the specific domain then you have permission to perform addboard or deleteboard requests on that board Default value is to have all slots assigned to all domains e Typing the prefix d deletes the slot from ACLs of this
12. etc syslog conf The default is local0 Enter a brief description for this domain For example its function Enter the name of the primary domain administrator Enter the name or the IP address of the trap hosts for this domain You can define multiple trap hosts Community string for SNMP readers The default value is A public B public and so on Note For SNMP clients such as the Sun Management Center 3 0 software to access the system controller using SNMP their community strings should be set to the same value as the value entered here Community string for readers and writers The default value is A private B private and so on Note For SNMP clients such as the Sun Management Center 3 0 software to access the system controller using SNMP their community strings should be set to the same value as the value entered here Description Configures domain specific values Configures the domain You can configure each domain differently and independently This command is an interactive command You are prompted for parameters to configure See Also password setdate showdate showdomain and the section To Configure Domain Specific Parameters in the System Power On and Setup chapter of the Sun Fire 6800 4810 4800 3800 Systems Platform Administration Manual Chapter 3 System Controller Alphabetical Command Reference 79 Example CODE EXAMPLE 3 46 Variables for the setupdomain Command schostname
13. is restored The date and time need to be set after the configuration has been restored and the system controller has been rebooted You also need to activate all domains with setkeyswitch on since this command restores all domains in the off keyswitch position Note Check the configuration of the platform and the domains before activating any domains to ensure that the desired configuration has been restored In the platform shell use showplat form showboards and showdate In each domain shell use showdomain showboards and showdate See Also dumpconfig setkeyswitch setdate showboards showdate showdomain showplatform Example CODE EXAMPLE 3 34 shows an example of the restoreconfig command with the required f option CODE EXAMPLE 3 34 restoreconfig Example schostname SC gt restoreconfig f ftp hostname path The system controller will be rebooted when the restore is complete The date will need to be set in the platform and each domain Do you want to restore the system controller configuration now no yes Retrieving ftp hostname path schostname nvci Retrieving ftp hostname path schostname tod Verifying data 60 Sun Fire 6800 4810 4800 3800 System Controller Command Reference Manual October 2001 CODE EXAMPLE 3 34 restoreconfig Example Continued NVCI has been restored TOD has been restored Restore complete The system controller is being rebooted The date will need to be se
14. 64 66 setting time 64 66 setupdomain command 79 showboards command 87 showenvironment command 99 100 showlogs 106 showsc command 115 status boards 87 status environmental displaying 99 100 system controller software command summary 13 T testboard command 116 testing CPU Memory board 116 time setting 64 66 U unassigning a board from the domain 25 updating the flash PROM 39 uptime and version information displaying 115 V version and uptime information displaying 115 virtual keyswitch 74 Index 122 Sun Fire 6800 4810 4800 3800 System Controller Command Reference Manual October 2001
15. CPU Memory board need to be powered on the system attempts to power on these boards or devices also When the keyswitch position changes to on secure or diag from any keyswitch position the domain console is resumed If a failure occurred during keyswitch transition the keyswitch position is reset to off or standby after recovering from the failure The system controller maintains the position of each keyswitch even during power failures or physical power cycles When you power on the system after either a power failure or system power off the system controller activates any domains that were active when the power went off See Also resume showkeyswitch Examples To turn the virtual keyswitch on and power on the domain CODE EXAMPLE 3 43 type CODE EXAMPLE 3 43 setkeyswitch on Example schostname A gt setkeyswitch on 74 Sun Fire 6800 4810 4800 3800 System Controller Command Reference Manual October 2001 To shut down the domain by turning the virtual keyswitch off CODE EXAMPLE 3 44 type CODE EXAMPLE 3 44 setkeyswitch off Example schostname A gt setkeyswitch off To shut down domain B from the platform shell CODE EXAMPLE 3 45 type CODE EXAMPLE 3 45 setkeyswitch off Example Shutting Down Domain B From the Platform Shell schostname SC gt setkeyswitch d b off Caution CODE EXAMPLE 3 45 does not properly shut down the Solaris operating environment in the domain before turning the
16. Domain Shell password password h Options Parameters d domainID is domain a b c or d h displays help for this command Description Sets the password for the platform or the domain There are separate passwords for each domain and for the platform If you set a password entering the password is required for access to the shell or console It is very important to set the password for the platform and each domain even if a domain is not being used This prevents people from creating and activating unauthorized domains Prior to allowing the password to be changed the current password will be authenticated Changed passwords take effect immediately The old password will no longer be accepted You can remove the password by pressing Return at the Enter new password and Enter new password again prompts Chapter 3 System Controller Alphabetical Command Reference 47 OpenBoot PROM passwords are different from the platform and domain passwords The OpenBoot PROM in each domain supports the OpenBoot PROM security mode which is a standard feature of the OpenBoot PROM software For more information on the OpenBoot PROM security mode password see your OpenBoot PROM documentation See Also Security chapter of the Sun Fire 6800 4810 4800 3800 Systems Platform Administration Manual Examples You will see the following prompt CODE EXAMPLE 3 25 when a password is already set and you type the password c
17. Power supplies ps0 ps1 and ps2 comprise power grid 0 Power supplies ps3 ps4 and ps5 comprise power grid 1 TABLE 2 2 shows the components that are accessible from a domain TABLE 2 2 Components That Are Accessible From a Domain Device Description Device Name CPU Memory boards SBO SBl SB2 SB3 SB4 SB5 I O Assemblies IB6 IB7 IB8 IB9 Chapter 2 System Controller Syntax Arguments and Device Names 5 Board States for CPU Memory Boards and I O Assemblies TABLE 2 3 lists the board states for the CPU Memory boards and I O assemblies To determine the board state use the showboards command and look under the State header TABLE 2 3 Board States Board States Description Available The board is not assigned to any domain Assigned The board belongs to a domain but the hardware has not been configured or it is not in use Active The board is being actively used by the domain to which it has been assigned You cannot reassign an active board The System Controller board ID board power supplies and Repeater boards do not have a State A dash is displayed In the Board Status field for these boards and components see TABLE 2 4 Fan trays have a state of off low speed and high speed Board Test Status TABLE 2 4 describes the Status field of the showboards command TABLE 2 4 Status Field of the showboards Command Test Status Description Passed All board components passed testing Failed The board failed
18. This command displays the minimum and maximum values If these values are exceeded the component and the domain using the component will be shut down It also shows the warning levels when the system controllers warns you that you are approaching the limits TABLE 3 14 describes the showenvironment output headers and values TABLE 3 14 showenvironment Output Header Description Header Value Description Slot Slot ID Device Device being monitored by the sensor Sensor Component that measures the environmental data of the device Sun Fire 6800 4810 4800 3800 System Controller Command Reference Manual October 2001 TABLE 3 14 showenvironment Output Header Description Continued Header Value Description Value Value returned by the sensor Units Applicable unit for the sensor Degrees C Celsius Volts DC Volts Amps Amps Age Age in seconds of the reading being displayed Status Values for Status See the Value column When the values listed in the Value column are exceeded a warning message will be logged WARNING LOW NOTICE Low OK NOTICE High WARNING HIGH error failed ignored unavailable LoWarn Displayed only with the v and w options Lists values that when exceeded a warning message will be logged HiWarn Displayed only with the v and w options Lists values that when exceeded a warning message will be logged Min Displayed with the v and 1 options This is not a warning message Min is when the co
19. a URL which must use the ftp protocol url is the directory containing the data files The URL must point to a directory and not a file Examples are ftp userid password hostname path ftp hostname path Note The hostname you enter can be the host name or the host name with a fully qualified domain name such as schostname or schostname eng sun com You cannot use a partial domain name Description Restores the platform and domain configurations from a server if a system controller board has failed and has been replaced This is based on the two data files created by the dumpconfig command schostanme nvci and schostname tod at the specified URL which must point to a directory and use the ftp protocol This command prompts you for a new platform password Chapter 3 System Controller Alphabetical Command Reference 59 Caution The 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 Platform and Domain Configurations to a Server in the chapter System Power On and Setup in the Sun Fire 6800 4810 4800 3800 Systems Platform Administration Manual This command should have been executed when you set up the system This command requires that all domains be powered off with the setkeyswitch off command The system controller automatically reboots when the configuration
20. a board is assigned to an active domain the board will not be used To unassign a board from a domain you must halt the Solaris operating environment in the domain For an overview of steps to perform see the section Assigning and Unassigning Boards in the Maintenance chapter of the Sun Fire 6800 4810 4800 3800 Systems Platform Administration Manual If a board is not present the command assigns ownership of the slot to the specified domain See Also deleteboard setkeyswitch showboards showdomain showplatform Assigning and Unassigning Boards in the Maintenance chapter of the Sun Fire 6800 4810 4800 3800 Systems Platform Administration Manual for a step by step procedure on assigning boards to a domain Chapter 3 System Controller Alphabetical Command Reference 17 Example Platform Shell From the platform shell to add board name sb2 to domain A CODE EXAMPLE 3 1 type CODE EXAMPLE 3 1 addboard Example in the Platform Shell schostname SC gt addboard d a sb2 Example Domain Shell To assign board name sb2 to the current domain CODE EXAMPLE 3 2 type CODE EXAMPLE 3 2 addboard Example in the Domain Shell schostname A gt addboard sb2 18 Sun Fire 6800 4810 4800 3800 System Controller Command Reference Manual October 2001 break Sends a Break signal to the domain console Scope domain shell Syntax break y n break h Options Parameters h displays help fo
21. and time for the platform and domains This command when invoked from the platform will have no effect on the date and time in each domain and vice versa You can set up to five different times and time zones one time and time zone Offset From Greenwich Mean Time GMT G MT MT for the platform and different times and time zones for each of the four domains If your time zone area is using daylight or summer time this is set automatically Note You cannot set the date from the system controller in a domain while the Solaris operating environment is running To set the date while the Solaris operating environment is running use the Solaris operating environment date command Time Zone Abbreviation Time Zone Name NST New Zealand standard time PLT Pakistan Lahore time PNT Phoenix standard time PRT Puerto Rico and U S Virgin Islands time PST Pacific standard time SST Solomon standard time UTC Universal Time Coordinated VST Vietnam standard time Description See Also showdate 66 Sun Fire 6800 4810 4800 3800 System Controller Command Reference Manual October 2001 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 platform to Thursday April 20 2001 at 18 hours 15 minutes and 10 seconds type CODE EXAMPLE 3 36 setd
22. available until the domain restarts the OpenBoot PROM either by rebooting the Solaris operating environment or by turning the virtual keyswitch from off to on See Also reset 114 Sun Fire 6800 4810 4800 3800 System Controller Command Reference Manual October 2001 showsc Shows the system controller version and uptime Scope platform shell Syntax showsc v showsc h Options Parameters h displays help for this command v is verbose mode Description Shows the system controller version and uptime Example CODE EXAMPLE 3 63 showsc Command schostname SC gt showsc SC SSCO SC date Wed May 09 15 06 22 PDT 2001 ScApp version 5 12 5 RTOS version 17 SC uptime 1 hour 30 minutes 11 seconds RTOS is the Real Time Operating System for the system controller and ScApp is the system controller application Chapter 3 System Controller Alphabetical Command Reference 115 A testboard Tests the CPU Memory board Scope platform shell domain shell Syntax testboard board_name testboard h Options Parameters h displays help for this command board_name is sb0 sb5 for CPU Memory boards Description Tests the CPU Memory board name specified on the command line This board cannot be used in an active domain and must be powered on If running from a domain the board must be assigned to the domain The Repeater boards required to run the domain must also be powered on
23. commands are ignored by the domain shell 72 Sun Fire 6800 4810 4800 3800 System Controller Command Reference Manual October 2001 TABLE 3 9 Results of Changing the Keyswitch From the Current Setting to a New Setting Continued Current Setting New Setting Result standby off All boards will be powered off set to low power mode and all monitoring of the boards will stop The domain is shut down standby on 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 on off All boards will be powered off set to low power mode and all monitoring of the boards will stop The domain is shut down on standby The domain becomes inactive All of the boards remain powered on on on Keyswitch position not changed on diag Similar to the setkeyswitch on command except the POST verbose mode is set to on and the POST diagnostic level is set to maximum This change is setting has no effect on a running domain on secure break and reset are ignored diag off All boards will be powered off set to low power mode and all monitoring of the boards will stop The domain is shut down diag standby The domain becomes inactive All of the boards remain powered on diag on Has no effect on a running domain This operation only changes the keyswitch position and does not perform any other function since the domain is already running diag dia
24. connections to the specified domain a b c or d Description Displays hosts currently connected to the system controller When run from the platform shell this command shows the connections to the platform and to each domain When run from the domain shell this command will only show the connection to the domain There can only be one connection to each domain See Also disconnect Chapter 3 System Controller Alphabetical Command Reference 21 22 Example Platform Shell CODE EXAMPLE 3 4 connections Command for the Platform Shell schostname SC gt connections schostname SC ID Hostname Idle Time Connected On Connected To 1 XXXXXXX May 02 00 00 Platform 4 XXX May 02 00 21 Platform TABLE 3 2 describes the headers in the output for CODE EXAMPLE 3 4 TABLE 3 2 Header Description for the connections Command Header Column in the Description connections Command ID Connection ID This is a unique number Hostname Source of the connection for this session If the value is localhost the connection was established through the platform or through the serial port Idle Time Amount of time the session is sitting without any activity Displays a dash if there has been any activity during the last 30 seconds Connected On Mon dd hh mm Connected To Date and time the connection was initiated The format is Shell or console this session is connected to Possible values are Pla
25. domain e Typing a prefix of a add adds a slot e Typing a dash clears the entire list e Typing a plus sign adds all e Pressing the Return key does not change the value displayed inside See the description for ACL for Domain A See the description for ACL for Domain A See the description for ACL for Domain A The system controller boot parameters diag level can be set to of f min or max Only system board initialization code is run No testing is done POST is not run Chapter 3 System Controller Alphabetical Command Reference 83 TABLE 3 11 setupplatform Parameter Values Continued Parameter Description min All System Controller board components are tested using few locations with few test patterns max All System Controller board components are tested with all tests and test patterns Configure platform for single or The two options are single or dual The default is single For dual partition mode a description of single and dual partition mode refer to the Overview chapter in the Sun Fire 6800 4810 4800 3800 Systems Platform Administration Manual See Also password setdate setupdomain showdate showdomain showplat form and the section Setting Up the Platform in the System Power On and Setup chapter of the Sun Fire 6800 4810 4800 3800 Systems Platform Administration Manual This chapter describes a step by step procedure on setting up the platform using setupplatform
26. domain you can only unassign boards that are assigned to the current domain The CPU Memory board or the I O assembly board status must be in the Assigned state and the board must not be part of an active domain To display the board states use the showboards command For more information on board states see Board States for CPU Memory Boards and I O Assemblies on page 6 The board does not have to be in the Access Control List ACL to be unassigned from the domain To unassign a board from a domain you must halt the Solaris operating environment in the domain For an overview of steps to perform see the section Assigning and Unassigning Boards in the Maintenance chapter of the Sun Fire 6800 4810 4800 3800 Systems Platform Administration Manual If a board is not present the command unassigns ownership of the slot from the specified domain Chapter 3 System Controller Alphabetical Command Reference 25 See Also addboard showboards Assigning and Unassigning Boards in the Maintenance chapter of the Sun Fire 6800 4810 4800 3800 Systems Platform Administration Manual for a step by step procedure on unassigning boards from a domain Example Platform Shell To delete I O assembly ib7 type CODE EXAMPLE 3 7 deleteboard Example Showing Deleting I O Assembly 7 schostname SC gt deleteboard ib7 Example Domain Shell To delete CPU Memory board sb3 from the current domain domain A type CODE EXAM
27. domain is active The domain is active and is running the OpenBoot PROM The domain is active and is booting the Solaris operating environment The domain is active and is running the Solaris operating environment The Solaris operating environment is halted in the domain The domain has had an XIR reset and had not be rebooted The domain is active and is panicking It is creating the core file The domain is active and the debugger is presently running The domain is not responding The domain is paused due to a hardware error Chapter 2 System Controller Syntax Arguments and Device Names 7 Special Characters To execute multiple commands on the same line separate them with a semicolon The following example executes both the addboard and deleteboard commands schostname A gt addboard sb2 deleteboard sb3 A pound sign signifies the start of a comment on the current line The following example executes the addboard command Everything you type after the and before pressing the Return key is ignored schostname A gt addboard sb2 this text is ignored Interactive Commands Some commands may prompt for confirmation before executing the command You can disable prompting by specifying the y or n flags which answer yes or no to any prompted question Some commands such as setupplat form and setupdomain are always interactive When an interactive command prompts for input do t
28. keyswitch in domain B to the off position Chapter 3 System Controller Alphabetical Command Reference 75 setupdomain Configures the domain Scope domain shell Syntax setupdomain p part setupdomain h Options Parameters h displays help for this command p part configures the specified information and has the following options bootparams configures the boot parameter information loghost configures the log hosts snmp configures SNMP information TABLE 3 10 lists the parameter values for setupdomain Note that for diag level definition and function of default and max are the same Because the tests for mem1 and mem2 take a long time to run use the default or max values However if you suspect memory problems then use the mem1 or mem2 values TABLE 3 10 Parameter Values for the setupdomain Command Parameter diag level Value init quick default default value Description Only system board initialization code is run No testing is done This is a very fast pass through POST All system board components are tested using few tests with few test patterns All system board components are tested with all tests and test patterns except for memory and Ecache modules For memory and Ecache modules all locations are tested with multiple patterns More extensive time consuming algorithms are not run at this level This is the same as max 76 Sun Fire 6800 4810 4800 3800 Sy
29. or D gt A set of one or more system boards that is capable of booting the operating system and running independently of other domains Domains do not depend on each other and do not interact with each other If the Solaris operating environment or the OpenBoot PROM is running you can access the domain console With the domain console you can have the ok login or prompts All systems have a large number of sensors that monitor temperature voltage and current The system controller polls devices in a timely manner and makes the environmental data available The system controller will shut down various components to prevent damage See virtual domain keyswitch A group of Repeater boards that are used together to provide communications between CPU Memory boards and I O assemblies in the same domain The platform shell enables access to the entire system and provides configuration control environmental status ability to rearrange domains ability to power on and off power grids ability to change the system controller password and other generic system controller functions Power on self test This is the program that takes uninitialized system hardware and probes and tests its components configures what seems worthwhile into a coherent initialized system and hands it off to the OpenBoot PROM Static Random Access Memory A type of high speed memory device used for Ecache modules Glossary 119 120 system controll
30. une licence non exclusive de Xerox sur l interface d utilisation graphique Xerox cette licence couvrant galement les licenci s de Sun qui mettent en place l interface d utilisation graphique OPEN LOOK et qui en outre se conforment aux licences crites de Sun CETTE PUBLICATION EST FOURNIE EN L ETAT ET AUCUNE GARANTIE EXPRESSE OU IMPLICITE N EST ACCORDEE Y COMPRIS DES GARANTIES CONCERNANT LA VALEUR MARCHANDE L APTITUDE DE LA PUBLICATION A REPONDRE A UNE UTILISATION PARTICULIERE OU LE FAIT QU ELLE NE SOIT PAS CONTREFAISANTE DE PRODUIT DE TIERS CE DENI DE GARANTIE NE S APPLIQUERAIT PAS DANS LA MESURE OU IL SERAIT TENU JURIDIQUEMENT NUL ET NON AVENU Eb eos 4 Adobe PostScript Contents Preface xiii Introduction to the System Controller 1 Platform and Domain Administration 1 Connecting to the System Controller 2 System Controller Navigation 2 Terminating Sessions 2 System Controller Syntax Arguments and Device Names Command Syntax and Arguments 3 Command Names 4 Component Names 4 Board States for CPU Memory Boards and I O Assemblies Board Test Status 6 Domain Status 7 Interactive Commands 8 Command Line Editing 9 Command Line History 10 Command Completion 11 3 6 3 System Controller Alphabetical Command Reference 13 Command Summary 13 Alphabetical Listing of System Controller Commands 16 addboard 16 break 19 connections 21 console 23 deleteboard 25 disablecomponent 27 disconnect 31 dumpco
31. 93 See Also setdate Example Platform Shell CODE EXAMPLE 3 52 showdate Command for the Platform Shell schostname SC gt showdate Mon Apr 03 12 31 40 EDT 2001 94 Sun Fire 6800 4810 4800 3800 System Controller Command Reference Manual October 2001 showdomain Displays the configuration and status of the domain Scope domain shell Syntax showdomain v p part showdomain h Options Parameters v_ is verbose mode p part is a parameter for the information to display acls shows the ACLs Access Control List bootparams shows boot parameter information loghosts shows the log hosts mac shows MAC addresses snmp shows SNMP configuration status shows domain status h displays help for this command Description Displays the configuration and status of the domain Some of the information is not configurable such as the MAC address and hostID or is configurable in the platform such as the Access Control List ACL and SNMP enabled This command without any arguments displays all the parameter values configured by the setupdomain command See Also setupdomain showdate setupplatform showplatform Chapter 3 System Controller Alphabetical Command Reference 95 Examples To display parameters assigned by the setupdomain command type showdomain CODE EXAMPLE 3 53 CODE EXAMPLE 3 53 showdomain Command Example schostname A gt showdomain Domain Solaris Nodename Domain Status K
32. CODE EXAMP CODE EXAMP CODE EXAMP LE 3 20 LE 3 21 LE 3 22 LE 3 23 LE 3 24 LE 3 25 LE 3 26 LE 3 27 LE 3 28 LE 3 29 LE 3 30 LE 3 31 LE 3 32 LE 3 33 LE 3 34 LE 3 35 LE 3 36 LE 3 37 LE 3 38 LE 3 39 LE 3 40 LE 3 41 LE 3 42 LE 3 43 LE 3 44 LE 3 45 flashupdate Example Updating Replacement CPU Memory Board sb4 42 help Command Example Displaying Information on the addboard Command 44 help Command Example Displaying Commands Beginning With the Word show 44 help Command Example Displaying Commands Beginning With the Letter A 45 history Command 46 password Command Example With a Password Already Set 48 password Command Example With No Password Set 48 poweroff Command Example Showing Powering Off sb2 51 poweroff Command Example Showing Powering Off All Power Supplies Fan Trays and System Boards in the Platform Shell 51 poweron Example Powering On sb2 53 poweron Example Showing Powering On All CPU Memory Boards and I O Assemblies in Domain A 54 reboot Command Example 56 reset Command Example From Domain A 58 reset a Command Example From Domain A 58 restoreconfig Example 60 resume Command Example in Active DomainA 63 setdate Command Example in the Platform Shell 67 setdate r Command Example Setting the Date From a Date Host 67 setdate t Command Example Setting the Time Zone to Pacific Standard Time Using the Offset From Greenwich Mean Time 67 setdate t C
33. Indicates which domain the board belongs to For more information on domains refer to the Overview chapter of the Sun Fire 6800 4810 4800 3800 Systems Platform Administration Manual Memory Information Component Component such as a board CPU or memory DIMM J No Component label on the board Size Lists the size of the DIMM Reason Describes information why the value is not reported Firmware Versions Component Board Device Lists the specific flashPROM on the board Type Provides the image type for the device Describes what the image is used for Each device can have multiple types Version System controller version number Date Date Time Time of day Clock Status Component Board SSCX Signal Lists the status of the SSCO or SS1 clock on the board Signal Used Failover Defines which clock is used by the board Describes if the board will respond to clock failover Sun Fire 6800 4810 4800 3800 System Controller Command Reference Manual October 2001 TABLE 3 12 Output Header Definitions for the showboards and the showboards v Command Continued Header Description 1 0 Status Slot 1 0 slot Populated Defines if a card is installed in the slot V O Status continued Slot Description Describes the slot The card type cannot be determined by the system controller The card is determined by the Solaris operating environment CPU Information Component CPU Cpu Mask Lists the CPU version De
34. PLE 3 8 deleteboard Example Showing Deleting CPU Memory Board 3 schostname A gt deleteboard sb3 26 Sun Fire 6800 4810 4800 3800 System Controller Command Reference Manual October 2001 disablecomponent Adds a component to the blacklist Scope platform shell domain shell Syntax disablecomponent component_name component_name disablecomponent h Options Parameters h displays help for this command component_name is see TABLE 3 3 and TABLE 3 4 m system_board_name port physical_bank logical_bank for the CPU Memory board m system_board_name port bus for an I O assembly m system_board_name card for an I O assembly Note You can use partial component names Chapter 3 System Controller Alphabetical Command Reference 27 TABLE 3 3 component_name Descriptions for the CPU Memory Board Used in the disablecomponent Command Board or Device Component Name CPU system CPU Memory boards system _board_name Ports on the CPU Memory board Physical memory banks on CPU Memory boards Logical banks on board_name port physical_bank logical_bank SBO SB1 SB2 SB3 SB4 SB5 PO P1 P2 P3 BO B1 LO L1 L2 L3 CPU Memory boards TABLE 3 4 component_name Descriptions for the I O Assembly Used in the disablecomponent Command Board or Device I O assembly system I O assemblies system_board_name Ports on the I O assembly Buses on the I O assembly
35. Platform local0 SNMP Agent enabled Chassis Description Sun Fire 6800 Chassis Contact Chassis Location Trap Hosts Public Community String P public Private Community String P private SNMP packets received x SNMP packets sent xxx SNMP traps sent xxx SBO SBI SB2 SB3 SB4 SB5 IB6 IB7 IB8 IB9 SBO SB1 SB2 SB3 SB4 SB5 IB6 IB7 IB8 IB9 SBO SB1 SB2 SB3 SB4 SB5 IB6 IB7 IB8 IB9 SBO SB1 SB2 SB3 SB4 SB5 IB6 IB7 IB8 IB9 ACL for Domain ACL for Domain ACL for Domain ACL for Domain vawr SC POST SC POST diag Level min Chapter 3 System Controller Alphabetical Command Reference 111 CODE EXAMPLE 3 62 showplatform v Output for a Sun Fire 6800 System Continued Partition Mode Chassis is in dual partition mode Frame information is not available schostname SC gt In CODE EXAMPLE 3 61 and CODE EXAMPLE 3 62 the Domain Status header has the following possible states Powered Off Standby Running POST Active Active OpenBoot PROM Active Booting Active Solaris Active Halted Active Reset Active Panicking Active Debugger Not Responding Paused due to an error For a description of these states see Domain Status on page 7 112 Sun Fire 6800 4810 4800 3800 System Controller Command Reference Manual October 2001 showresetstate Shows that state of CPUs after a reset or a RED MODE trap Scope domain shell Syntax showresetstate w s v Op
36. Qe Sun microsystems Sun Fire 6800 4810 4800 3800 system Controller Command Reference Manual Sun Microsystems Inc 901 San Antonio Road Palo Alto CA 94303 U S A 650 960 1300 Part No 805 7372 13 October 2001 Revision A Send comments about this document to docfeedback sun com Copyright 2001 Sun Microsystems Inc 901 San Antonio Road Palo Alto CA 94303 USA All rights reserved This product or document is protected by copyright and distributed under licenses restricting its use copying distribution and decompilation No part of this product or document may be reproduced in any form by any means without prior written authorization of Sun and its licensors if any Third party software including font technology is copyrighted and licensed from Sun suppliers Parts of the product may be derived from Berkeley BSD systems licensed from the University of California UNIX is a registered trademark in the U S and other countries exclusively licensed through X Open Company Ltd 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 in the U S and other countries Products bearing SPARC trademarks are based upon an architecture developed by Sun Microsystems
37. The testboard command runs tests at the levels set in the domain Testing a CPU Memory board is most accurately done when it is part of a domain It is best if the CPU Memory board can be tested by POST However if that is not possible testing in the domain is the next best test Caution When testing a CPU Memory board that is assigned to a domain and the domain is active there is a very slight possibility that problems can occur with the active domain To prevent this from being a problem unassign the board from the domain and test the board from the platform shell 116 Sun Fire 6800 4810 4800 3800 System Controller Command Reference Manual October 2001 See Also showcomponent showboards Example To test CPU Memory board sb0 in the domain A shell CODE EXAMPLE 3 64 type CODE EXAMPLE 3 64 testboard Example Testing CPU Memory Board sb0 schostname A gt testboard sb0 lt Command output not shown gt Chapter 3 System Controller Alphabetical Command Reference 117 118 Sun Fire 6800 4810 4800 3800 System Controller Command Reference Manual October 2001 Glossary domain shell domain domain console environmental monitoring keyswitch partition platform shell POST SRAM 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 gt or B gt C gt
38. alized for this domain CODE EXAMPLE 3 6 console Example and A Password Set Accessing Domain A schostname SC gt console a Enter Password Connected to Domain A Domain Shell for Domain A schostname A gt When a domain is active and a password is not set for this domain schostname SC gt console a Connected to Domain A Note that no other output is seen If the OpenBoot PROM is at the ok prompt or the Solaris operating environment is at the login prompt you must press the Enter key in order to see the prompt Otherwise you will need to wait for output to be generated by POST the OpenBoot PROM or the Solaris operating environment If the domain is hung there will be no output However when a domain displays no output this does not necessarily mean that the domain is hung 24 Sun Fire 6800 4810 4800 3800 System Controller Command Reference Manual October 2001 deleteboard Unassigns a board from the domain where it is currently assigned Scope platform shell domain shell Syntax for the Platform Shell and the Domain Shell deleteboard system_board_name system_board_name deleteboard h Options Parameters h displays help for this command system_board_name is the board to be deleted Values are sb0 to sb5 CPU Memory board and ib6 to ib9 I O assembly Description Unassigns a board from the domain where it is currently assigned When you use this command from your current
39. ard in the I O assembly where x is 0 7 CODE EXAMPLE 3 51 showcomponent ib6 Sample Output schostname SC gt showcomponent ib6 Component Status Pending POST Description NO IB6 P0 enabled pass IO controller 0 NO IB6 P1 enabled pass IO controller 1 NO IB6 P0 B1 enabled untest 66 33MHz PCI Bus NO IB6 P0 B0 enabled untest 33MHz PCI Bus N0 IB6 P0 B1 C0 enabled untest 33MHz 5V Short PCI card N0 IB6 P0 B1 C1 enabled untest 33MHz 5V Short PCI card NO IB6 P0 B1 C2 enabled untest 33MHz 5V Long Short PCI card NO IB6 P0 B1 C3 enabled untest 33MHz 5V Long Short PCI card 92 Sun Fire 6800 4810 4800 3800 System Controller Command Reference Manual October 2001 showdate Displays the date and time Scope platform shell domain shell Syntax for the Platform Shell showdate tv showdate h showdate v d domainlD Syntax for the Domain Shell showdate tv showdate h Options Parameters h displays help for this command t lists available time zones v is verbose mode d domainID is a b c or d Shows the date for the domain from the platform Description Displays the current date and time for the platform and for each domain You can obtain the date for the platform shell and each domain shell from the platform shell If you type the command from one of the domain shells the date and time for the current domain is returned Chapter 3 System Controller Alphabetical Command Reference
40. ard will be interleaved with each other The memory will be interleaved on all memory banks across all of the boards in the domain With this value you cannot remove a CPU Memory board from the system using DR The memory is mixed size interleaving in order to gain optimal performance The memory is fixed size interleaving There is no memory interleaving The domain will be paused when the system controller detects a hardware error Chapter 3 System Controller Alphabetical Command Reference 77 TABLE 3 10 Parameter Values for the setupdomain Command Continued Parameter Value Description true OBP use nvramrc true false default value OBP auto boot true default value false OBP error reset recovery sync default value none boot The domain is rebooted when a hardware error is detected If OBP auto boot is set to true the Solaris operating environment is booted 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 nvramrc if this parameter is set to true The OpenBoot PROM does not evaluate the script stored in nvramrc if this parameter is set to false Controls booting of the Solaris operating environment If this value is true the domain boots automatically after POST has run If this parameter value is set to false you will obtain the OpenBo
41. ate Command Example in the Platform Shell schostname SC gt setdate 042018152001 10 Thu Apr 20 18 15 10 PST 2001 To set the date from a date host CODE EXAMPLE 3 37 setdate r Command Example Setting the Date From a Date Host schostname SC gt setdate r datehost Thu Apr 20 18 15 10 PST 2001 To set the time zone to Pacific Standard Time PST using the offset from Greenwich mean time GMT and the date and time on the platform to Thursday April 20 2001 at 18 hours 15 minutes and 10 seconds TABLE 3 7 type CODE EXAMPLE 3 38 setdate t Command Example Setting the Time Zone to Pacific Standard Time Using the Offset From Greenwich Mean Time schostname SC gt setdate t GMT 8 042018152001 10 Thu Apr 20 18 15 10 PST 2001 To set the time zone to Eastern Standard Time EST using the time zone abbreviations and the date and time on the platform to Thursday April 20 2001 at 18 hours 15 minutes and 10 seconds TABLE 3 7 type CODE EXAMPLE 3 39 setdate t Command Example Setting the Date and Time Zone to Eastern Standard Time Using Time Zone Abbreviations schostname SC gt setdate t EST 042018152001 10 Thu Apr 20 18 15 10 EST 2001 Chapter 3 System Controller Alphabetical Command Reference 67 To set just the time zone for Japan Standard Time using offsets from Greenwich Mean Time GMT TABLE 3 7 and not the date and time type CODE EXAMPLE 3 40 setdate t Command Example Sett
42. ation Service Service System Administration Title Sun Fire 6800 4810 4800 3800 Systems Service Manual Sun Fire 4810 4800 3800 System Cabinet Mounting Guide Sun Fire 6800 4810 4800 3800 Systems Platform Administration Manual Part Number 805 7363 806 6781 805 7373 Accessing Sun Documentation Online A broad selection of Sun system documentation is located at http www sun com products n solutions hardware docs A complete set of Solaris documentation and many other titles are located at http docs sun com Ordering Sun Documentation fatbrain com an Internet professional bookstore stocks select product documentation from Sun Microsystems Inc For a list of documents and how to order them visit the Sun Documentation Center on fatbrain comat http www fatbrain com documentation sun Preface xv Sun Welcomes Your Comments Sun is interested in improving its documentation and welcomes your comments and suggestions You can email your comments to Sun at docfeedback sun com Please include the part number 805 7372 13 of your document in the subject line of your email xvi Sun Fire 6800 4810 4800 3800 System Controller Command Reference Manual October 2001 CHAPTER 1 Introduction to the System Controller The system controller consists of the System Controller board and the system controller software The system controller software does the following Monitors an
43. ays are automatically powered on when a power supply is powered on Fan trays obtain power from the power grid s The System Controller boards obtain their power from a secondary power output on the power supplies The System Controller boards power on automatically when the system is supplied with power For example the System Controller boards will power on automatically on a Sun Fire 6800 system if the power cords are connected the system has power and the circuit breaker s are on The System Controller board will automatically power on the Sun Fire 4810 4800 3800 systems if the power cords are connected to the power source the system has power and the power supply switches are turned on Sun Fire 3800 system only The fan trays power on automatically if any power supply is on See Also poweroff setkeyswitch showboards Examples To power on CPU Memory board sb2 from the platform shell CODE EXAMPLE 3 29 type CODE EXAMPLE 3 29 poweron Example Powering On sb2 schostname SC gt poweron sb2 Chapter 3 System Controller Alphabetical Command Reference 53 To power on CPU Memory boards and I O assemblies in the domain CODE EXAMPLE 3 30 type CODE EXAMPLE 3 30 poweron Example Showing Powering On All CPU Memory Boards and I O Assemblies in Domain A schostname A gt poweron all Note From the domain shell you cannot power on power supplies Repeater boards fan trays or power grids To power on these c
44. be on a server or another board of the same type Scope platform shell Syntax flashupdate y n f url all systemboards scapp rtos domainID flashupdate y n f url systemboards scapp rtos domainID flashupdate y n f url board board flashupdate y n u flashupdate y n csource_ board destination_board destination_board flashupdate h Options Parameters h displays help for this command y does not prompt for confirmation n does not execute this command if confirmation is required f specifies a URL as the source of the flash images url is the URL to the directory containing the flash images where ftp hostname path ftp userid password hostname path http hostname path 38 Sun Fire 6800 4810 4800 3800 System Controller Command Reference Manual October 2001 Note The hostname you enter must be a host name or a host name with a fully qualified domain name You cannot use a partial domain name Some examples include schostname schostname eng sun com board is the board name c specifies that the image should be copied from another board a source_board is the source board for the flash images a 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 all system boards CPU Memory boards and I O assemblies a
45. command name must contain enough of the command name in order for the command to be recognized by help The help command returns help information for all commands beginning with the characters you typed The help command is shell sensitive It displays help information for the current shell only Chapter 3 System Controller Alphabetical Command Reference 43 ANNONA U U UN U Examples CODE EXAMPLE 3 21 displays help information on the addboard command CODE EXAMPLE 3 21 help Command Example Displaying Information on the addboard Command schostname SC gt help addboard addboard assign a board to a domain Usage addboard d lt domain gt lt board gt addboard h d the domain to assign the board to h display this help message CODE EXAMPLE 3 22 displays all commands in the platform shell beginning with show CODE EXAMPLE 3 22 help Command Example Displaying Commands Beginning With the Word show schostname SC gt help show howboards show board information howcomponent show state of a component howdate show the current date and time for the platform howenvironment show environmental information howkeyswitch show the keyswitch positions howlogs show the logs howplatform show platform configuration information and domain status howsc show system controller version and uptime 44 Sun Fire 6800 4810 4800 3800 System Controller Command Reference Manual O
46. component command or components that have been marked as failed when testing using the testboard command For CPU Memory boards this command provides information about CPUs memory modules DIMMs and Ecache This command displays logical memory bank size 90 Sun Fire 6800 4810 4800 3800 System Controller Command Reference Manual October 2001 CODE EXAMPLE 3 50 schostname SC gt showcomponent sb4 See Also enablecomponent disablecomponent and the Disable Component section of the Troubleshooting chapter in the Sun Fire 6800 4810 4800 3800 Systems Platform Administration Manual for a step by step procedure on displaying a component Examples CODE EXAMPLE 3 50 shows sample output for the showcomponent sb4 command The abbreviations for the Component field are Component O SB4 O SB4 O SB4 O SB4 O SB4 O SB4 O SB4 O SB4 O SB4 O SB4 O SB4 O SB4 O SB4 O SB4 O SB4 O SB4 O SB4 Ma TS ES RS EE PS PR RO SS O SB4 PO P1 P2 P3 P0 B0 1 P0 BO 1 P0 B1 1 P0 B1 1 P1 B0 1 P1 B0 1 P1 B1 1 P1 B1 1 P2 B0 1 P2 B0 1 P2 B1 1 P2 B1 1 P3 B0 1 P3 B0 1 LO L2 L1 L3 LO L2 L1 L3 LO L2 L1 L3 LO L2 Nx Node name SBx CPU Memory board where x is 0 5 Px Port where x is 0 3 Bx Physical memory bank where x is 0 1 Lx Logical memory bank where x is 0 3 There are two DIMMs per logical memory bank showcomponent sb4 Sample Output Status Pe
47. component_name Descriptions for the CPU Memory Board Used in the enablecomponent Command Board or Device CPU system CPU Memory boards system_board_name Ports on the CPU Memory board Physical memory banks on CPU Memory boards Logical banks on CPU Memory boards Component Name board_name port physical_bank logical_bank SBO SB1 SB2 SB3 SB4 SB5 PO P1 P2 P3 BO B1 LO L1 L2 L3 Chapter 3 System Controller Alphabetical Command Reference 35 TABLE 3 6 component_name Descriptions for the I O Assembly Used in the 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 PO P1 assembly Buses on the I O BO B1 assembly I O cards in the I O CO C1 C2 C3 C4 C5 C6 C7 the number of cards varies with the assembly 1 0 assembly Description Removes a component from the blacklist Blacklisting provides a list of components that will not be tested and will not be configured into the domain when you change the keyswitch setting from an inactive state to an active state or when the domain is rebooted Components can be the following m Ports CPU on the CPU Memory board or I O controller on the I O assembly m Physical and logical memory banks a I O buses m I O cards Blacklisting is done on a per domain basis When you run the enablecomponent command f
48. ctober 2001 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 gt help a addboard assign a board to a domain Usage addboard d lt domain gt lt board gt addboard h d the domain to assign the board to h display this help message Chapter 3 System Controller Alphabetical Command Reference 45 history Shows the command history with date and time stamps Scope platform shell domain shell Syntax history h Options Parameters 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 See Also Command line editing can be used to edit the command history For more information on how to use command line editing see Command Line Editing on page 9 Example CODE EXAMPLE 3 24 history Command schostname SC gt history May 07 16 29 21 showboards May 07 16 29 24 showdate May 07 16 29 29 history 46 Sun Fire 6800 4810 4800 3800 System Controller Command Reference Manual October 2001 password Sets the password for the platform or the domain Scope platform shell domain shell Syntax Platform Shell password d domainID password h Syntax
49. cumentation URLs see Accessing Sun Documentation Online on page xv How This Book Is Organized This book contains the following chapters Chapter 1 introduces you to the system controller and briefly describes platform administration and domain administration Chapter 2 explains system controller command syntax command names and command arguments xiii Chapter 3 provides in tabular form a summary of all of the system controller commands and describes each command Typographic Conventions Typeface Meaning Examples AaBbCc123 The names of commands files and directories on screen computer output AaBbCc123 What you type when contrasted with on screen computer output AaBbCc123 Book titles new words or terms words to be emphasized Command line variable such as board_name Edit your login file Use 1s a to list all files 2 3 su Password Read Chapter 6 in the User s Guide These are called class options You must be superuser to do this To delete a file type rm filename Shell Prompts Shell C shell C shell superuser Bourne shell and Korn shell Bourne shell and Korn shell superuser Platform shell Domain shell Prompt machine_name machine_name schostname SC gt schostname A gt or B gt C gt D gt xiv Sun Fire 6800 4810 4800 3800 System Controller Command Reference Manual October 2001 Related Documentation Applic
50. d controls the system Manages hardware Configures domains Provides the date and time to the Solaris operating environment Provides the clock signal used on all system boards Provides a platform console and a domain console Provides system monitoring and control using SNMP for use with the Sun Management Center 3 0 software For more information on the system controller refer to the Overview chapter of the Sun Fire 6800 4810 4800 3800 Systems Platform Administration Manual and also the Sun Fire 6800 4810 4800 3810 Systems Overview Manual Platform and Domain Administration The platform administration function manages resources and services that are shared among the domains With this function you can configure how resources and services are configured and shared The domain administration function manages resources and services for a specific domain With this function you can configure the domain control the keyswitch position and access the domain console For more information on the platform administration and domain administration functions refer to the Overview chapter of the Sun Fire 6800 4810 4800 3800 Systems Platform Administration Manual Connecting to the System Controller To connect to the system controller refer to the System Controller Navigation Procedures chapter in the Sun Fire 6800 4810 4800 3800 Systems Platform Administration Manual System Controller Navigation To navigate w
51. e SSCO On System Controller SSCL Empty Slot IDO On Sun Fire 3800 Centerplane PSO On A145 Power Supply PS1 On A145 Power Supply PS2 On A145 Power Supply FTO On Fan Tray FT1 On Fan Tray FT2 On Fan Tray FT3 On Fan Tray RPO On Repeater Board F3800 RP2 On Repeater Board F3800 NO SBO On CPU Board NO SB2 Off CPU Board NO IB6 On CPCI I O board F3800 NO IB8 Off CPCI I O board F3800 Low Speed Low Speed Low Speed Low Speed Active Assigned Active Assigned Status Domain Passed O NNN OOOCOO0O0O 0 NNNAN AN AN K Passed Not tested Passed Not tested A Cc A C The showboards command with the v option displays the verbose option Chapter 3 System Controller Alphabetical Command Reference 87 88 TABLE 3 12 Output Header Definitions for the showboards and the showboards v Command Header Description Slot Slot designator The Nx in the slot descriptor is the node number Pwr Indicates if the power status of the device is off or on Component type Component description State Describes board state Possible values are Active Assigned Available and dash The board state means that the board state does not apply to this slot For more information on board states see Board States for CPU Memory Boards and I O Assemblies on page 6 Status Current board status For more information on board status see Board Test Status on page 6 Domain
52. e system Scope platform shell domain shell Syntax for the Platform Shell showboards ev yl n a domainID p part showboards h Syntax for the Domain Shell showboards aev y n p part showboards h Options Parameters a include available boards domain only e includes empty slots in the output v verbose mode d domainID specify a domain to display platform only p part shows only a specific part and can be board shows the board status clock shows the system clock status cpu shows CPU type speed and Ecache size io shows I O information memory shows memory information for each board power shows grid information version shows version information y answers yes to all questions n answers no to all questions h displays help for this command 86 Sun Fire 6800 4810 4800 3800 System Controller Command Reference Manual October 2001 Description Displays the assignment information and status for all of the components in the system For example CPU Memory boards I O assemblies fan trays and so on For the domain shell the display shows components assigned to the domain and can also include boards that are included in the ACL and not assigned to any other domain See Also addboard deleteboard Examples Platform Shell CODE EXAMPLE 3 48 showboards Command for the Platform Shell schostname SC gt showboards Slot Pwr Component Typ
53. ed is different than the rtos supplied with the software you must upgrade the rtos image m To determine the version number of the current rtos 1 Use showsc The README file contains the version number of the new rtos image There is currently no method to determine that the scapp and rtos versions are compatible Note If you fail to check all versions the domains can crash or the system controller would fail to reboot normally 40 Sun Fire 6800 4810 4800 3800 System Controller Command Reference Manual October 2001 Caution While upgrading the firmware heed the following precautions Read the README and Install info files before you upgrade the firmware Do not change the keyswitch position of any domain Do not use DR Do not power off any boards Do not reboot the system controller If you upgrade the scapp or rtos images for status 1 It is important to watch the console during the flashupdate procedure 2 Monitor the console if errors are reported If the images that are already installed are incompatible with the new images 1 Shut down the domains before performing the firmware upgrade 2 After you perform the firmware upgrade reboot the domains If the images that are already installed are compatible with the new images 1 Reboot the domains after performing the flashupdate procedure Even though the firmware is compatible with the older firmware version you must
54. er System Controller board TOD virtual domain keyswitch virtual time of day TOD The system controller consists of the System Controller board and the system controller software The system controller software manages platform and domain resources monitors and controls the platform and domains configures domains and the platform provides access to domain consoles provides the date and time to the Solaris operating environment provides the reference clock signal used throughout the system provides console security performs domain initialization provides a mechanism for updating the firmware on the boards installed in the system and provides an external management interface using SNMP A board containing a CPU central processing unit which oversees operation of the system and provides clocks and the console bus These systems support two System Controller boards See virtual time of day TOD The system controller provides a virtual keyswitch for each domain The setkeyswitch command controls the position of the virtual keyswitch for each domain The TOD NVRAM chip is located on the System Controller board The system controller provides TOD services for each domain and for the system controller Sun Fire 6800 4810 4800 3800 System Controller Command Reference Manual October 2001 Index A active board state 6 addboard command 17 adding board to a domain 17 assigned board state 6 available board sta
55. eyswitch A Powered Off off diag level default verbosity level min error level max interleave scope within board interleave mode optimal reboot on error tru OBP use nvramrc lt OBP default gt OBP auto boot lt OBP default gt OBP error reset recovery lt OBP default gt Loghost for Domain A Log Facility for Domain A local0 SNMP Agent enabled Domain Description Domain Contact Trap Hosts Public Community String Private Community String ACL for Domain A SBO SB1 SB2 SB3 SB4 SB5 IB6 IB7 IB8 IB9 schostname A gt 96 Sun Fire 6800 4810 4800 3800 System Controller Command Reference Manual October 2001 To display the verbose output of parameters assigned by the setupdomain command type showdomain v CODE EXAMPLE 3 54 CODE EXAMPLE 3 54 showdomain v Command Example schostname A gt showdomain v Domain Solaris Nodename Domain Status Keyswitch A Powered Off off Domain Boot Parameters diag level default verbosity level min error level max interleave scop within board interleave mod optimal reboot on error fals OBP use nvramrc lt OBP default gt OBP auto boot lt OBP default gt OBP error reset recovery lt OBP default gt MAC Address HostID Domain A XXEXXIXXIXXIXXIXX XXXXXXXX Loghosts Loghost for Domain A Log Facility for Domain A local0 SNMP SNMP Agent enabled Domain Description Do
56. fails and you did not use this command to save the platform and domain configurations you will have to manually reconfigure the platform and the domains This command is intended to be used as part of the procedure in replacing a failed System Controller board You should not use this command to revert to an old configuration The showplatform showdomain showcomponent and showboards system controller commands display all of the configuration and can be used as a reference If you need to replace the System Controller board this configuration information can be used to restore the platform and domain configurations to the replacement System Controller board See Also restoreconfig Example CODE EXAMPLE 3 16 dumpconfig Example schostname SC gt dumpconfig f ftp hostname path Created ftp hostname path schostname nvci Created ftp hostname path schostname tod 34 Sun Fire 6800 4810 4800 3800 System Controller Command Reference Manual October 2001 enablecomponent Deletes a component from the blacklist Scope platform shell domain shell Syntax enablecomponent component_name component_name enablecomponent h Options Parameters h displays help for this command component_name is TABLE 3 5 and TABLE 3 6 m system_board_name port physical_bank logical_bank for CPU Memory boards m system_board_name port bus for an I O assembly m system_board_name card for an I O assembly TABLE 3 5
57. for this command Options Parameters With no arguments typing reset is the same as typing reset x x resets via XIR externally initiated reset Use XIR to try to obtain diagnostic data default a reset is equivalent to the OpenBoot PROM reset all command Description This command also resumes the domain console Resetting the domain is not allowed if the keyswitch is in the secure position Before you can reset the domain change the keyswitch position to on Resetting the domain is not possible if the keyswitch is configured in either the off or standby position By default reset uses XIR externally initiated reset to reset the CPUs in the domain The externally initiated reset forces control of the domain into the OpenBoot PROM and begins the OpenBoot PROM error reset recovery actions The error reset recovery actions preserve most domain states to allow collecting data needed for debugging the hardware and software including a Solaris operating environment core file The OpenBoot PROM error reset recovery actions are Chapter 3 System Controller Alphabetical Command Reference 57 controlled by setting the OpenBoot PROM error reset recovery configuration variable For the definition of this variable and the various settings see TABLE 3 10 in setupdomain on page 76 Note that the OpenBoot PROM reset command does not generate a core file as this command does You cannot reset a domain that has been paused The doma
58. g Keyswitch position not changed diag secure break and reset are ignored secure off All boards will be powered off set to low power mode and all monitoring of the boards will stop The domain is shut down secure standby The domain becomes inactive All of the boards remain powered on The break and reset commands are no longer ignored secure on break and reset are not ignored secure diag This change is setting has no effect on a running domain secure secure Keyswitch position not changed Chapter 3 System Controller Alphabetical Command Reference 73 Description Each domain has a virtual keyswitch with five positions off standby on diag and secure The setkeyswitch command changes the position of the virtual keyswitch to the specified value The virtual keyswitch replaces the need for a physical keyswitch for each domain If it is not possible to access the domain shell set the keyswitch position for the domain to off from the platform shell Setting the keyswitch position to off for a domain without first halting the Solaris operating environment may cause problems If the domain is running the Solaris operating environment the setkeyswitch command parameters off and standby require confirmation If the domain is already powered on the setkeyswitch on setkeyswitch diag and setkeyswitch secure commands will change only the position of the virtual keyswitch If components making up a domain such as a I O assembly or
59. grees C 5 sec OK IB8 IOASIC 1 Temp 1 31 Degrees C 5 sec OK SBO Board 0 1 5 VDC 0 1 50 Volts DC 6 sec OK SBO Board 0 3 3 VDC 0 3 33 Volts DC 6 sec OK SBO SDC 0 Temp 0 52 Degrees C 6 sec OK SBO AR 0 Temp 0 43 Degrees C 6 sec OK SBO SBBC 0 Temp 0 44 Degrees C 6 sec OK SBO Board 1 Temp 0 22 Degrees C 6 sec OK SBO Board 1 Temp 1 22 Degrees C 6 sec OK SBO Cheetah 0 Temp 0 35 Degrees C 7 sec OK SBO Cheetah 0 1 8 VDC 0 1 41 Volts DC 7 sec OK SBO Cheetah 1 Temp 0 34 Degrees C 7 sec OK SBO Cheetah 1 1 8 VDC 1 Te 72 Volts DC 7 sec OK SBO SBBC 1 Temp 0 39 Degrees C 7 sec OK SBO Board 1 Temp 2 23 Degrees C 7 sec OK SBO Board 1 Temp 3 23 Degrees C 7 sec OK SBO Cheetah 2 Temp 0 34 Degrees C 7 sec OK SBO Cheetah 2 1 8 VDC 0 1 52 Volts DC 7 sec OK SBO Cheetah 3 Temp 0 36 Degrees C 7 sec OK SBO Cheetah 3 1 8 VDC 1 1 72 Volts DC 7 sec OK IB6 Board 0 1 5 VDC 0 1 51 Volts DC 7 sec OK IB6 Board 0 3 3 VDC 0 3 35 Volts DC 7 sec OK IB6 Board 0 5 VDC 0 4 95 Volts DC 7 sec OK IB6 Board 0 12 VDC 0 12 11 Volts DC 7 sec OK IB6 Board 0 Temp 0 28 Degrees C 7 sec OK IB6 Board 0 Temp 1 23 Degrees C 7 sec OK IB6 SDC 0 Temp 0 49 Degrees C 7 sec OK IB6 AR 0 Temp 0 45 Degrees C 7 sec OK IB6 SBBC 0 Temp 0 41 Degrees C 7 sec OK IB6 IOASIC 0 Temp 0 39 Degrees C 7 sec OK IB6 IOASIC 1 Temp 1 34 Degrees C 7 sec OK Chapter 3 System Controller Alphabetical Command Reference 103 showkeyswitch Displays the keyswitch setting Scope platform shell d
60. he following a Press the Return key to keep the current setting displayed in braces Type a dash to change the current setting to an empty string if the input type is used to define a string Sun Fire 6800 4810 4800 3800 System Controller Command Reference Manual October 2001 Command Line Editing The system controller has a basic command line editor that allows you to edit the command line The keys you press are not echoed on the screen TABLE 2 6 lists the keystrokes used to perform basic command line editing m To use the Control key sequences hold down the Control key while typing the following character TABLE 2 6 m To use Escape key sequences press and release the Escape key Then press and release the following character TABLE 2 6 TABLE 2 6 Command Line Editing Capabilities Keystroke Description Backspace Erases the character before the cursor Control h Delete Erases the character before the cursor Control U Erases the entire line Control C Cancels editing the command line The command is not executed Return Finishes editing the line Control b Moves backward one character Esc b Moves backward one word Control f Moves forward one character Esc f Moves forward one word Control a Moves backward to the beginning of the line Control e Moves forward to the end of the line Esc h Erases from the beginning of the word to just before the cursor Stores erased characters in a
61. host name or the host name with a fully qualified domain name such as schostname or schostname eng sun com You cannot use a partial domain name v is verbose mode Displays detailed information about the time zone that is set h displays help for this command TABLE 3 7 Time Zone Abbreviation Time Zone Abbreviations Time Zone Name and Offsets From Greenwich Mean Time Time Zone Name Offset From Greenwich Mean Time GMT ACT AET AGT ART AST BET BST CAT CNT CST CTT EAT ECT EET EST HST IET IST JST MET MIT MST NET Australian central time Australian eastern time Argentina standard time Arabic Egypt standard time Alaska standard time Brazil eastern time Bangladesh standard time Central African time Canada Newfoundland time Central standard time China Taiwan time Eastern African time European central time Eastern European time Eastern standard time Hawaii standard time Indiana eastern standard time India standard time Japan standard time Middle East time Midway Islands time Mountain standard time Near East time GMT 9 5 10 3 a3 lt 7 2 Se ic aaa a vw eee ao SN ND z T DR RE oe ea ete 78 O1 22902222222222222222222 a oo Chapter 3 System Controller Alphabetical Command Reference 65 TABLE 3 7 Time Zone Abbreviations Time Zone Name and Offsets From Greenwich Mean Time Continued Sets the date
62. in is paused automatically when hardware detects an error Messages on the domain console indicate that the domain is paused To take a domain out of the paused state 1 Turn the keyswitch off with setkeyswitch off 2 Turn the keyswitch on with setkeyswitch on See Also resume setkeyswitch setupdomain showdomain showkeyswitch showreset state Domain Not Responding section in the Troubleshooting chapter in the Sun Fire 6800 4810 4800 3800 Systems Platform Administration Manual This section describes how to recover from a hung or paused domain Examples To reset the domain from a domain shell type the following CODE EXAMPLE 3 32 This command uses XIR externally initiated reset to try to obtain diagnostic data CODE EXAMPLE 3 32 reset Command Example From Domain A schostname A gt reset To perform the equivalent operation as the OpenBoot PROM reset all command CODE EXAMPLE 3 33 type CODE EXAMPLE 3 33 reset a Command Example From Domain A schostname A gt reset a 58 Sun Fire 6800 4810 4800 3800 System Controller Command Reference Manual October 2001 restoreconfig Restores the platform and domain configurations from a server Scope platform shell Syntax restoreconfig y n f url restoreconfig h Options Parameters h displays help for this command y does not prompt for confirmation n does not execute this command if confirmation is required f specifies
63. ing Boot Parameter Information 98 showenvironment Platform Shell and Domain Shell Example 102 Showkeyswitch Example Showing the Keyswitch Set to On 105 Showkeyswitch Example Showing the Keyswitch Set to Off 105 Showkeyswitch Example Showing the Keyswitch Set to Standby 105 Sample Output of the showlogs Command Run After Rebooting the System 107 showplatform Output for a Sun Fire 6800 System 109 showplatform v Output for a Sun Fire 6800 System 110 showsc Command 115 testboard Example Testing CPU Memory Board sbo 117 Code Samples xi xii Sun Fire 6800 4810 4800 3800 System Controller Command Reference Manual October 2001 Preface This book describes the Sun Fire 6800 4810 4800 3800 system controller command line interface The system controller is responsible for controlling system functions environmental monitoring domain control and hardware control of the server Using the command line interface you can configure the platform and domains power on and off domains power supplies fans and other components Access to the Solaris domain console is also possible using the command line interface Before You Read This Book This book is written for system administrators or people who have a working knowledge of the Solaris operating environment If you do not have such knowledge you should first read the Solaris User and System Administrator AnswerBooks and consider UNIX system administration training For the do
64. ing the Time Zone to Japan Standard Time Using the Offset From Greenwich Mean Time schostname SC gt setdate t GMT 9 Thu Apr 20 18 15 10 GMP 9 2001 To set just the time zone for European Central Time using the time zone abbreviations TABLE 3 7 and not the date and time type CODE EXAMPLE 3 41 setdate t Command Example Setting the Time Zone to Eastern Central Time Using Time Zone Abbreviations schostname SC gt setdate t ECT Thu Apr 20 18 15 10 ECT 2001 68 Sun Fire 6800 4810 4800 3800 System Controller Command Reference Manual October 2001 setdefaults Sets the default configuration values Caution This is a destructive command Use with caution and care Scope platform shell domain shell Syntax setdefaults yl n c p platform setdefaults h Options Parameters Platform Shell y does not prompt for confirmation The option sets the defaults for the platform shell and each domain shell n does not execute the command if confirmation is requested c keeps Capacity on Demand COD licenses h displays help for this command p platform resets the defaults for the platform only Options Parameters Domain Shell y does not prompt for confirmation n does not execute the command if confirmation is requested h displays help for this command Chapter 3 System Controller Alphabetical Command Reference 69 Description Caution This command requires that all domains are i
65. ithin the system controller refer to the System Controller Navigation Procedures chapter in the Sun Fire 6800 4810 4800 3800 Systems Platform Administration Manual Terminating Sessions To terminate system controller sessions refer to the System Controller Navigation Procedures chapter in the Sun Fire 6800 4810 4800 3800 Systems Platform Administration Manual 2 Sun Fire 6800 4810 4800 3800 System Controller Command Reference Manual October 2001 CHAPTER 2 System Controller Syntax 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 Status on page 6 Domain Status on page 7 Interactive Commands on page 8 Command Line Editing on page 9 Command Line History on page 10 Command Completion on page 11 Command Syntax and Arguments The general syntax of system controller commands is command_name flags arguments Arguments are the words that follow the command name and are divided into two categories m Required arguments Optional arguments Optional arguments always follow the option flags on the command line In the following example the optional domainID argument a follows the option flag d The boardname argument which is sb2 in this e
66. le et crite de Sun et de ses bailleurs de licence s il y en a Le logiciel d tenu par des tiers et qui comprend la technologie relative aux polices de caract res est prot g par un copyright et licenci par des fournisseurs de Sun Des parties de ce produit pourront tre d riv es des syst mes Berkeley BSD licenci s par l Universit de Californie UNIX est une marque d pos e aux Etats Unis et dans d autres pays et licenci e exclusivement par X Open Company Ltd Sun Sun Microsystems le logo Sun AnswerBook2 docs sun com OpenBoot Sun Fire et Solaris des marques de fabrique ou des marques d pos es ou marques de service de Sun Microsystems Inc aux Etats Unis et dans d autres pays Toutes les marques SPARC sont utilis es sous licence et sont des marques de fabrique ou des marques d pos es de SPARC International Inc aux Etats Unis et dans d autres pays Les produits portant les marques SPARC sont bas s sur une architecture d velopp e par Sun Microsystems Inc UNIX est une marque enregistree aux Etats Unis et dans d autres pays et licenci e exclusivement par X Open Company Ltd L interface d utilisation graphique OPEN LOOK et Sun a t d velopp e par Sun Microsystems Inc pour ses utilisateurs et licenci s Sun reconna t les efforts de pionniers de Xerox pour la recherche et le d veloppement du concept des interfaces d utilisation visuelle ou graphique pour l industrie de l informatique Sun d tient
67. main Contact Trap Hosts Public Community String Private Community String SNMP packets received 0 SNMP packets sent 0 SNMP traps sent 0 Chapter 3 System Controller Alphabetical Command Reference 97 98 CODE EXAMPLE 3 54 showdomain v Command Example Continued Ls ACL for Domain A SBO SB1 SB2 SB3 SB4 SB5 IB6 IB7 IB8 IB9 schostname A gt To display boot parameter information CODE EXAMPLE 3 55 type CODE EXAMPLE 3 55 showdomain p bootparams Example Displaying Boot Parameter Information schostname A gt showdomain p bootparams diag level default verbosity level min error level max interleave scope within board interleave mode optimal reboot on error fals OBP use nvramrc lt OBP default gt OBP auto boot lt OBP default gt OBP error reset recovery lt OBP default gt schostname A gt Sun Fire 6800 4810 4800 3800 System Controller Command Reference Manual October 2001 showenvironment Displays the current environmental status temperatures currents voltages and fan status for the system platform shell or the current domain domain shell Scope platform shell domain shell Syntax for the Platform Shell showenvironment ltvuw d domainID p part showenvironment ltvuw board_name showenvironment h Syntax for the Domain Shell showenvironment ltvuw p part showenvironment ltvuw board_name board_ name
68. mponent will be powered off including any domains using it to protect it Max Displayed with the v and 1 options This is not a fault condition Max is when the component will be powered off including any domains using it to protect it Chapter 3 System Controller Alphabetical Command Reference 101 Example The showenvironment command display for the platform shell returns information on the slot number device sensor value units age and status as shown in CODE EXAMPLE 3 56 CODE EXAMPLE 3 56 showenvironment Platform Shell and Domain Shell Example md6 sc0 SC gt showenvironment Slot Device Sensor Value Units Age Status SSCO SBBC 0 Temp 0 38 Degrees C 2 sec OK Ssco CBH 0 Temp 0 48 Degrees C 2 sec OK SSsco Board 0 Temp 0 27 Degrees C 2 sec OK Ssco Board 0 Temp 1 27 Degrees C 2 sec OK Ssco Board 0 Temp 2 21 Degrees C 2 sec OK SSCO Board 0 1 5 VDC 0 1 49 Volts DC 2 sec OK SSCO Board 0 3 3 VDC 0 3 35 Volts DC 2 sec OK SSCO Board 0 5 VDC 0 5 01 Volts DC 2 sec OK RPO Board 0 1 5 VDC 0 1 49 Volts DC 5 sec OK RPO Board 0 3 43 VDE 0 3434 3Volts DC 5 sec OK RPO Board 0 Temp 0 23 Degrees C 5 sec OK RPO Board 0 Temp 1 22 Degrees C 5 sec OK RPO SDC 0 Temp 0 56 Degrees C 5 sec OK RPO AR 0 Temp 0 49 Degrees C 5 sec OK RP2 Board 0 1 5 VDC 0 1 49 Volts DC 5 sec OK RP2 Board 0 3 3 VDC 0 33 7 Volts DC 5 sec OK RP2 Board 0 Temp 0 22 Degrees C 5 sec OK RP2 Board 0 Temp 1 23 Deg
69. n in the domain shell x x restoreconfig Restores the system controller configuration x from a server resume Exits the domain shell and resumes access to the x domain console setdate Sets the date and time x x setdefaults Sets the configuration to default values x x setkeyswitch Sets the keyswitch position x x setupdomain Configures the domain x setupplatform Configures the platform x showboards Shows board information x x showcomponent Shows state of a component x x showdate Shows the date and time x x showdomain Displays the configuration and status of the x domain showenvironment Shows environmental information x x showkeyswitch Displays the virtual keyswitch setting x x showlogs Displays the logs x x showplatform Displays the configuration and information for x 14 Sun Fire 6800 4810 4800 3800 System Controller Command Reference Manual October 2001 the platform and status of the domains TABLE 3 1 System Controller Command Summary Continued Command Description Platform Shell Domain Shell showresetstate Shows CPUs after a reset or a RED MODE trap x showsc Shows the system controller version and uptime x testboard Tests the CPU Memory board x x Chapter 3 System Controller Alphabetical Command Reference 15 Alphabetical Listing of System Controller Commands The following sections describe the system controller commands addboard Assigns a board to a domain Scope platform shell domain shell
70. nactive not running the OpenBoot PROM POST or the Solaris operating environment and the keyswitch be set to off When you run this command from the platform shell without options the platform and domain values are set to the default values When you run this command from the domain shell without options only the current domain values are reset to the default values If a password is set you will need to type the password in order to set the default values When you run this command from the platform shell the password for the platform shell is required When you run this command from a domain shell the password for the domain shell is required There are separate passwords for the platform shell and each domain shell In addition this command also does the following m Sets the system controller to the default values This command only resets the system controller setting It does not affect the domain s configuration in the OpenBoot PROM m Erases all platform and domain configurations platform m Removes passwords domain and platform Example CODE EXAMPLE 3 42 setdefaults Example schostname SC gt setdefaults You are about to reset all configuration data to default values All domain configurations ACLs passwords and data buffers will be lost The system controller will be REBOOTED after the defaults are set Do you want to restore the default values and reboot now no If you answe
71. nd the system controller real time operating system rtos system_boards are all CPU Memory boards and I O assemblies scapp updates the current system controller Updating the system controller reboots the system controller and disconnects all the current connections To update the other system controller you must run the flashupdate command from the other system controller Use showsc to determine which system controller you are currently using so you know the system controller you must go to next to update it rtos updates the real time operating system for the system controller If you have a second System Controller board installed when you update the real time operating system also update the rtos on the second System Controller board To update the rtos on the second system controller run the flashupdate command from the second System Controller board domainID a b c or d upgrades all boards that are assigned to this domain Description Updates the firmware on the system controller CPU Memory boards and 1 0 assemblies There is no firmware on Repeater boards Boards must be powered on in order to be updated with flashupdate If a board does not have power the flashupdate command will do nothing and stop with an error message Boards that are in a secure domain cannot be updated Caution When you update the firmware on the system controller update only one system controller DO NOT update both system controllers at the
72. nding POST Description enabled pass UltraSPARC enabled pass UltraSPARC enabled pass UltraSPARC enabled pass UltraSPARC enabled pass 256M DRA enabled pass 256M DRA enabled pass 256M DRA enabled pass 256M DRA enabled pass 256M DRA enabled pass 256M DRA enabled pass 256M DRA enabled pass 256M DRA enabled pass 256M DRA enabled pass 256M DRA enabled pass 256M DRA enabled pass 256M DRA enabled pass 256M DRA enabled pass 256M DRA CUT LITA III III 750Mhz 750Mhz 750Mhz 750Mhz 8M 8M 8M 8M ECache ECache ECache ECache Chapter 3 System Controller Alphabetical Command Reference 91 CODE EXAMPLE 3 50 showcomponent sb4 Sample Output Continued NO SB4 P3 B1 L1 enabled NO SB4 P3 B1 L3 enabled pass 256M DRAM pass 256M DRAM Definitions of the headings in CODE EXAMPLE 3 50 and CODE EXAMPLE 3 51 follow Component is the name of the board and its components Status is the status of the board or component Pending means that the component will change to the indicated status enabled or disabled at the next reboot POST is the status of POST passed or failed a Description is a description of the board or component CODE EXAMPLE 3 51 shows sample output for the showcomponent ib6 command The abbreviations for the Component field are Nx Node name IBx I O assembly where x is 6 9 Px Port where x is 0 1 Bx Bus where x is 0 1 cx C
73. nents Scope platform shell domain shell Syntax for the Platform Shell poweron all grid component_name component_name poweron h Syntax for the Domain Shell poweron all component_name component_name poweron h Options Parameters h displays help for this command Platform shell component_name s m all is all power supplies and boards Power grid grid0 grid1 The Sun Fire 6800 system has two power grids grid0 and grid1 Grid 1 controls power supplies ps3 ps4 and ps5 All of the other mid range systems have one power grid grid0 This grid controls power supplies ps0 ps1 and ps2 Power supply ps0 ps5 CPU Memory board sb0 sb5 I O assembly ib6 ib9 Repeater board rp0 rp3 Fan tray ft0 ft3 Domain shell component_names all powers on all CPU Memory boards and I O assemblies in the domain CPU Memory board sb0 sb5 I O assembly ib6 ib9 The specified board must be in the current domain 52 Sun Fire 6800 4810 4800 3800 System Controller Command Reference Manual October 2001 Description Powers on a component or a list of components You must specify component_name s You can power on any component that is not already powered on if there is sufficient power to support the component when it is powered on From the domain only components that are assigned to the domain can be powered on To power on a component the power grid power must also be on Fan tr
74. nfig 33 enablecomponent 35 flashupdate 38 help 43 history 46 password 47 poweroff 49 poweron 52 reboot 55 reset 57 restoreconfig 59 resume 62 setdate 64 setdefaults 69 setkeyswitch 71 setupdomain 76 setupplatform 81 iv Sun Fire 6800 4810 4800 3800 System Controller Command Reference Manual October 2001 showboards 86 showcomponent 90 showdate 93 showdomain 95 showenvironment 99 showkeyswitch 104 showlogs 106 showplatform 108 showresetstate 113 showsc 115 testboard 116 Glossary 119 Index 121 Contents v vi Sun Fire 6800 4810 4800 3800 System Controller Command Reference Manual October 2001 TABLE 2 1 TABLE 2 2 TABLE 2 3 TABLE 2 4 TABLE 2 5 TABLE 2 6 TABLE 2 7 TABLE 2 8 TABLE 3 1 TABLE 3 2 TABLE 3 3 TABLE 3 4 TABLE 3 5 TABLE 3 6 TABLE 3 7 TABLE 3 8 Tables Components That Are Accessible From the Platform 5 Components That Are Accessible From a Domain 5 Board States 6 Status Field of the showboards Command 6 Values for the Domain Status Column in showplat form and showdomain Command Output 7 Command Line Editing Capabilities 9 Keystrokes that Recall Previously Typed Command Lines 10 Keystrokes Used to Complete System Controller Commands 11 System Controller Command Summary 13 Header Description for the connections Command 22 component_name Descriptions for the CPU Memory Board Used in the disablecomponent Command 28 component_name Descriptions f
75. ober 2001 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 adds a board d board deletes a board loghost configures loghost and facility with the default of local0 The loghost is the IP address or host name of the syslog loghost The host name you enter must be a complete host name not a partial one network is the network settings partition sets the partition mode sc configures system controller behavior snmp is SNMP configuration Chapter 3 System Controller Alphabetical Command Reference 81 Description Configures parameters for the platform This command is an interactive command You are prompted for parameters to configure For parameters to configure see TABLE 3 11 TABLE 3 11 setupplatform Parameter Values Parameter Description Is the System Controller on a Network Use DHCP or static network settings Hostname Network parameter IP address Network parameter Netmask Network parameter Gateway Network parameter DNS Domain Network parameter Primary DNS Server Network parameter Secondary DNS Server Network parameter Loghost Log Facilit
76. omain shell Syntax for the Platform Shell showkeyswitch v dqa 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 See Also setkeyswitch showdomain showplatform Description Displays the keyswitch setting 104 Sun Fire 6800 4810 4800 3800 System Controller Command Reference Manual October 2001 Examples CODE EXAMPLE 3 57 showkeyswitch Example Showing the Keyswitch Set to On schostname A gt showkeyswitch keyswitch is on CODE EXAMPLE 3 58 showkeyswitch Example Showing the Keyswitch Set to Off schostname A gt showkeyswitch keyswitch is off CODE EXAMPLE 3 59 showkeyswitch Example Showing the Keyswitch Set to Standby schostname A gt showkeyswitch keyswitch is standby Chapter 3 System Controller Alphabetical Command Reference 105 showlogs Displays the system controller logged events stored in the system controller message buffer Scope platform shell domain shell Syntax for the Platform Shell showlogs da domain ID v showlogs h Syntax for the Domain Shell showlogs v showlogs h Options Parameters h displays help for this command d domainID platform shell only specifies a domain a b c or d v is verbose Description Displays the messages that are stored in the me
77. ommand Example Setting the Date and Time Zone to Eastern Standard Time Using Time Zone Abbreviations 67 setdate t Command Example Setting the Time Zone to Japan Standard Time Using the Offset From Greenwich Mean Time 68 setdate t Command Example Setting the Time Zone to Eastern Central Time Using Time Zone Abbreviations 68 setdefaults Example 70 setkeyswitch on Example 74 setkeyswitch off Example 75 setkeyswitch off Example Shutting Down Domain B From the Platform Shell 75 x Sun Fire 6800 4810 4800 3800 System Controller Command Reference Manual October 2001 CODE EXAMP CODE EXAMP CODE EXAMP CODE EXAMP CODE EXAMP CODE EXAMP CODE EXAMP CODE EXAMP CODE EXAMP CODE EXAMP CODE EXAMP CODE EXAMP CODE EXAMP CODE EXAMP CODE EXAMP CODE EXAMP CODE EXAMP CODE EXAMP CODE EXAMP LE 3 46 LE 3 47 LE 3 48 LE 3 49 LE 3 50 LE 3 51 LE 3 52 LE 3 53 LE 3 54 LE 3 55 LE 3 56 LE 3 57 LE 3 58 LE 3 59 LE 3 60 LE 3 61 LE 3 62 LE 3 63 LE 3 64 Variables for the setupdomain Command 80 setupplatform Output 84 howboards Command for the Platform Shell 87 u howboards a Command for the Domain Shell 89 u u howcomponent sb4 Sample Output 91 howcomponent ib6 Sample Output 92 u howdate Command for the Platform Shell 94 n n howdomain Command Example 96 howdomain v Command Example 97 n showdomain p bootparams Example Display
78. ommand at either the platform shell or the domain shell CODE EXAMPLE 3 25 password Command Example With a Password Already Set schostname SC gt password Enter current password Enter new password Enter new password again schostname SC gt If currently there is not a password assigned to the shell you are entering you will not be prompted for the current password CODE EXAMPLE 3 26 CODE EXAMPLE 3 26 password Command Example With No Password Set schostname SC gt password Enter new password Enter new password again schostname SC gt 48 Sun Fire 6800 4810 4800 3800 System Controller Command Reference Manual October 2001 poweroff Powers off components Scope platform shell domain shell Syntax for the Platform Shell poweroff y n all grid component_name component_name poweroff h Syntax for the Domain Shell poweroff y n all component_ name component_ name poweroff h Options Parameters h displays help for this command y will answer yes to any question This option is potentially hazardous You can forcefully power off a component with the y option n answers no to any question You cannot forcefully power off a component with the n option component_name is the component name Platform shell component_name s m all turns off all currently controllable components m Power grid grid0 grid1 The Sun Fire 6800 system has two power g
79. omponents use the platform shell 54 Sun Fire 6800 4810 4800 3800 System Controller Command Reference Manual October 2001 reboot Reboots the system controller Scope platform shell Syntax reboot y n reboot h Options Parameters 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 Active domains will continue to run The keyswitch may be set to off if the system controller reboots while a keyswitch operations is in progress Caution Rebooting interrupts any current operation This includes keyswitch operations rebooting the Solaris operating environment testing boards SNMP and so on Chapter 3 System Controller Alphabetical Command Reference 55 Examples To reboot the system controller CODE EXAMPLE 3 31 type CODE EXAMPLE 3 31 reboot Command Example schostname SC gt reboot Are you sure you want to reboot the System Controller now no 56 Sun Fire 6800 4810 4800 3800 System Controller Command Reference Manual October 2001 reset Resets the domain Scope domain shell Syntax reset y n x a reset h Options Parameters y answers yes to the question asked executes the command n answers no to the question asked does not execute the command h displays help
80. or the I O Assembly Used in the disablecomponent Command 28 component_name Descriptions for the CPU Memory Board Used in the enablecomponent Command 35 component_name Descriptions for the I O Assembly Used in the enablecomponent Command 36 Time Zone Abbreviations Time Zone Name and Offsets From Greenwich Mean Time 65 Description of the setkeyswitch Transition 72 vii viii TABLE 3 9 TABLE 3 10 TABLE 3 11 TABLE 3 12 TABLE 3 13 TABLE 3 14 Results of Changing the Keyswitch From the Current Setting to a New Setting 72 Parameter Values for the setupdomain Command 76 setupplatform Parameter Values 82 Output Header Definitions for the showboards and the showboards v Command 88 Parts for showenvironment p part 100 showenvironment Output Header Description 100 Sun Fire 6800 4810 4800 3800 System Controller Command Reference Manual October 2001 CODE EXAMP CODE EXAMP CODE EXAMP CODE EXAMP CODE EXAMP CODE EXAMP CODE EXAMP CODE EXAMP CODE EXAMP CODE EXAMP CODE EXAMP CODE EXAMP CODE EXAMP CODE EXAMP CODE EXAMP CODE EXAMP CODE EXAMP CODE EXAMP CODE EXAMP LE 3 1 LE 3 2 LE 3 3 LE 3 4 LE 3 5 LE 3 6 LE 3 7 LE 3 8 LE 3 9 LE 3 10 LE 3 11 LE 3 12 LE 3 13 LE 3 14 LE 3 15 LE 3 16 LE 3 17 LE 3 18 LE 3 19 Code Samples addboard Example in the Platform Shell 18 addboard Example in the Domain Shell 18 break Command Exam
81. orm shell it will be disabled in all domains See Also enablecomponent showcomponent and the Disabling Components section in the Troubleshooting chapter of the Sun Fire 6800 4810 4800 3800 Systems Platform Administration Manual for step by step procedure on adding a component to the blacklist Chapter 3 System Controller Alphabetical Command Reference 29 Examples CODE EXAMPLE 3 9 adds system_board_name sb4 to the blacklist CODE EXAMPLE 3 9 disablecomponent Command Example Adding sb4 to the Blacklists schostname A gt disablecomponent sb4 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 and are implicitly disabled CODE EXAMPLE 3 10 disablecomponent Command Example Adding sb0 CPU Port 3 to the Blacklist schostname A gt disablecomponent sb0 p3 CODE EXAMPLE 3 11 adds system_board_name sb2 CPU port 3 physical bank 0 to the blacklists Note that any logical banks belonging to this physical bank are disabled CODE EXAMPLE 3 11 disablecomponent Command Example Adding sb2 CPU Port 3 and Physical Bank 0 to the Blacklists schostname A gt disablecomponent sb2 p3 b0 CODE EXAMPLE 3 12 adds system_board_name ib9 port 0 bus 1 and board_name ib8 I O card 2 to the blacklists Disabling 1 0 card 2 shuts down the power to that I O card CODE EXAMPLE 3 12 disablecomponent Command Example Adding I O Assembly 9
82. ot PROM ok prompt after POST runs from which you must type a boot command to boot the Solaris operating environment Controls the behavior of the domain after an externally initiated reset XIR as well as a red mode trap The OpenBoot PROM invokes sync A core file is generated If the invocation returns the OpenBoot PROM performs a reboot The OpenBoot PROM prints a message describing the reset trap that triggered the error reset and passes control to the OpenBoot PROM ok prompt The message describing the reset trap type is platform specific The OpenBoot PROM firmware reboots the domain A core file is not generated Rebooting a domain occurs using the OpenBoot PROM settings for diag device or boot device depending on the value of the OpenBoot PROM configuration variable diag switch If diag switch is set to true the device names in diag device will be the default for boot If diag switch is set to false the device names in boot device will be the default for boot 78 Sun Fire 6800 4810 4800 3800 System Controller Command Reference Manual October 2001 TABLE 3 10 Parameter Values for the setupdomain Command Continued Parameter Value Description Loghost Log Facility Domain Description Trap Hosts Public Community String Private Community String The name or the IP address of the loghost for this domain SNMP The log facility is defined by the Solaris operating environment syslogd in
83. ple 20 connections Command for the Platform Shell 22 console Example and No Password Set Accessing DomainB 24 console Example and A Password Set Accessing Domain A 24 deleteboard Example Showing Deleting I O Assembly 7 26 deleteboard Example Showing Deleting CPU Memory Board3 26 disablecomponent Command Example Adding sb4 to the Blacklists 30 disablecomponent Command Example Adding sbo CPU Port 3 to the Blacklist 30 disablecomponent Command Example Adding sb2 CPU Port 3 and Physical Bank 0 to the Blacklists 30 disablecomponent Command Example Adding I O Assembly 9 Port 0 and Bus 1 and Also I O Assembly 8 I O Card 2 to the Blacklists 30 Disconnecting a Session From the System Controller Platform Shell 32 Disconnecting a Session From the System Controller Platform Console 32 disconnect Example Showing Disconnecting a Session From the Domain A Shell 32 dumpconfig Example 34 enablecomponent Command Example Enabling CPU Memory Board 4 37 enablecomponent Command Example Enabling I O Assembly 6 and Port 1 37 flashupdate Example Updating the Active System Controller Board and the System Controller Real Time Operating System 42 CODE EXAMP CODE EXAMP CODE EXAMP CODE EXAMP CODE EXAMP CODE EXAMP CODE EXAMP CODE EXAMP CODE EXAMP CODE EXAMP CODE EXAMP CODE EXAMP CODE EXAMP CODE EXAMP CODE EXAMP CODE EXAMP CODE EXAMP CODE EXAMP CODE EXAMP CODE EXAMP CODE EXAMP CODE EXAMP CODE EXAMP
84. provides descriptions and examples for each command Command Summary TABLE 3 1 lists and describes the system controller commands and how you can access them Many commands are accessible from both the platform shell and the domain shell The system controller commands may differ in how they are used the effect of the command and the scope of the command between the platform and domain shells TABLE 3 1 System Controller Command Summary Command Description Platform Shell Domain Shell addboard Assigns a board to a domain x x break Sends a Break signal to the domain console x connections Displays connections to the system controller to x x a domain console Connects to a domain from the platform x deleteboard Unassigns a board from a domain x x disablecomponent Adds a component to the blacklist x x disconnect Disconnects the current or specified connection x x 13 TABLE 3 1 System Controller Command Summary Continued Command Description Platform Shell Domain Shell dumpconfig Saves the system controller configuration to a x server enablecomponent Deletes a component from the blacklist x x flashupdate Updates the firmware x help Provides basic help information for commands x x history Shows the command history with date and time x x stamps password Sets the shell password x x poweroff Powers off components x x poweron Powers on components x x reboot Reboots the system controller x reset Resets the domai
85. r 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 Description Sends a Break signal to the domain console Resumes the domain console Note This command pauses the Solaris operating environment When the Solaris operating environment is running in the domain the usual effect of the break signal is to force entry into OpenBoot PROM or the debugger The Solaris operating environment will ignore the break signal if the keyswitch is set to secure See Also resume setkeyswitch showkeyswitch Chapter 3 System Controller Alphabetical Command Reference 19 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 gt break This will suspend Solaris in domain A Do you want to continue no yes Type go to resume debugger entered 1 ok 20 Sun Fire 6800 4810 4800 3800 System Controller Command Reference Manual October 2001 connections Displays connections to the system controller or a domain Scope platform shell domain shell Syntax for the Platform Shell connections d domainID connections h Syntax for the Domain Shell connections h Options Parameters h displays help for this command d domainID shows
86. r yes the system controller is rebooted after the defaults are set If you answer no the default values are not restored If a password is set for the platform shell the password will be required 70 Sun Fire 6800 4810 4800 3800 System Controller Command Reference Manual October 2001 setkeyswitch Changes the position of the virtual keyswitch to the specified value Scope platform shell domain shell Syntax for the Platform Shell setkeyswitch y n d domainID off setkeyswitch h Syntax for the Domain Shell setkeyswitch y n off standbylonldiaglsecurel setkeyswitch h Options Parameters h displays help for this command y does not prompt for confirmation n does not execute this command is confirmation is requested d domainID platform shell only is the domain ID of the domain you want power off a b c or d Chapter 3 System Controller Alphabetical Command Reference 71 For setkeyswitch parameters and descriptions see TABLE 3 8 TABLE 3 8 Description of the setkeyswitch Transition Value off standby on diag secure 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 The domain will not be initialized at system power on Changes the board state of all the boards belonging to a domain to the Assigned board state and turn
87. re 6800 4810 4800 3800 System Controller Command Reference Manual October 2001 Command Completion Using the command completion function makes it easier for you to enter long commands After typing part of the command use the completion keystroke TABLE 2 8 This action searches the list of available commands for commands beginning with the characters you typed thus far m If there is only one possible command the remainder of the characters are entered for you automatically m If there are several possibilities any characters that are common to all of the possible selections are filled in m If there are no defined commands starting with the given characters the characters are erased until there is a minimum of one selection for the remaining characters TABLE 2 8 lists the keystrokes to complete a command TABLE 2 8 Keystrokes Used to Complete System Controller Commands Key Sequence Description Control space Complete this command Control Shows all possible matches Control Shows all possible matches Chapter 2 System Controller Syntax Arguments and Device Names 11 12 Sun Fire 6800 4810 4800 3800 System Controller Command Reference Manual October 2001 CHAPTER 3 System Controller Alphabetical Command Reference This chapter lists a summary of the system controller commands designed for an end user on the Sun Fire 6800 4810 4800 3800 systems describes the system controller command line interface and
88. rees C 5 sec OK RP2 SDC 0 Temp 0 61 Degrees C 5 sec OK RP2 AR 0 Temp 0 49 Degrees C 5 sec OK PSO 48 VDC 0 Current 0 3 94 Amps 2 sec OK PSO 48 VDC 0 Temp 0 25 Degrees C 2 sec OK PSO 48 VDC 1 Current 0 0 18 Amps 2 sec OK PSO 48 VDC 1 48 VDC 0 55 28 Volts DC 2 sec OK PSO 48 VDC 0 48 VDC 0 56 59 Volts DC 2 sec OK PS1 48 VDC 0 Current 0 4 05 Amps 2 sec OK PS1 48 VDC 0 Temp 0 25 Degrees C 2 sec OK PS1 48 VDC 1 Current 0 0 16 Amps 2 sec OK PS1 48 VDC 1 48 VDC 0 55 28 Volts DC 2 sec OK PS1 48 VDC 0 48 VDC 0 56 33 Volts DC 2 sec OK PS2 48 VDC 0 Current 0 4 88 Amps 1 sec OK PS2 48 VDC 0 Temp 0 27 Degrees C 1 sec OK PS2 48 VDC 1 Current 0 0 88 Amps 1 sec OK PS2 48 VDC 1 48 VDC 0 55 0 Volts DC 2 sec OK PS2 48 VDC 0 48 VDC 0 56 07 Volts DC 2 sec OK FTO Fan 0 Cooling 0 Low 1 sec OK 102 Sun Fire 6800 4810 4800 3800 System Controller Command Reference Manual October 2001 CODE EXAMPLE 3 56 showenvironment Platform Shell and Domain Shell Example Continued ETL Fan 0 Cooling 0 Low 1 sec OK FT2 Fan 0 Cooling 0 Low 7 sec OK IB8 Board 0 1 5 VDC 0 1351 Volts DC 4 sec OK IB8 Board 0 3 3 VDC 0 3 435 Volts DC 5 sec OK IB8 Board 0 5 VDC 0 4 98 Volts DC 5 sec OK IB8 Board 0 12 VDC 0 T2311 Volts DC 5 sec IB8 Board 0 Temp 0 30 Degrees C 5 sec OK IB8 Board 0 Temp 1 24 Degrees C 5 sec OK IB8 SDC 0 Temp 0 53 Degrees C 5 sec OK IB8 AR 0 Temp 0 43 Degrees C 5 sec OK IB8 SBBC 0 Temp 0 41 Degrees C 5 sec OK IB8 IOASIC 0 Temp 0 41 De
89. rids grido and grid1 Grid 1 controls power supplies ps3 ps4 and ps5 All other mid range systems have one power grid grid0 This grid controls power supplies ps0 ps1 and ps2 Power supply ps0 ps5 CPU Memory board sb0 sb5 I O assembly ib6 ib9 Repeater board rp0 rp3 Fan tray ft0 ft3 Chapter 3 System Controller Alphabetical Command Reference 50 Domain shell component_name s a CPU Memory board sb0 sb5 a I O assembly ib6 ib9 Note The specified board must be in the current domain Description Powers off a component or a list of components For the domain shell the specified board must be in the current domain All slots listed by snowboards can be powered off except for system controllers SSCO and SSC1 and the ID board IDO A powered off component will not be monitored Use the showboards command to display the power status of each board You can power off any component except when the board is in the Active state see the showboards command to display the board state When a component is in the Active state a warning is displayed on the console that tells you the entire domain will go down You are asked to confirm with a warning of the consequences If a board is active in a domain and you forcefully power off a device board the keyswitch for the domain will be set to standby To change the keyswitch setting use the setkeyswitch command Repeater boards do not have an Active s
90. rom the domain the component is removed from the blacklist for the current domain When the enablecomponent command is run from the platform shell the component is removed from the blacklist for all domains Using this command the platform shell blacklists supersede the domain shell blacklists For example if a component is enabled in the platform shell it will be enabled in all domains 36 Sun Fire 6800 4810 4800 3800 System Controller Command Reference Manual October 2001 See Also disablecomponent showcomponent and the Sun Fire 6800 4810 4800 3800 Systems Platform Administration Manual for step by step procedure on removing a component from the blacklist This information is in the Troubleshooting chapter in the section Disabling Components Examples CODE EXAMPLE 3 17 enables CPU Memory board sb4 This removes CPU Memory board sb4 from the blacklist CODE EXAMPLE 3 17 enablecomponent Command Example Enabling CPU Memory Board 4 schostname A gt enablecomponent sb4 CODE EXAMPLE 3 18 enables I O assembly 6 port 1 This removes port 1 of I O assembly 6 from the blacklist CODE EXAMPLE 3 18 enablecomponent Command Example Enabling I O Assembly 6 and Port 1 schostname A gt enablecomponent ib6 p1 Chapter 3 System Controller Alphabetical Command Reference 37 flashupdate Updates the firmware on the system controller and the system boards CPU Memory boards and I O assemblies The source flash image can
91. s on the boards The domain will not be initialized at system power on but the boards that comprise the domain will be powered on Powers on and initializes the domain The system controller brings the domain into OpenBoot PROM through POST If the OpenBoot PROM has auto boot set to true then the Solaris operating environment boots automatically Similar to the setkeyswitch on command except the POST verbose mode is set to on and the POST diagnostic level is set to maximum Similar to the setkeyswitch on command except that the break command and the reset commands are ignored CPU Memory board and I O assembly flash PROM updates are not allowed TABLE 3 9 shows the results when you change a keyswitch setting TABLE 3 9 Results of Changing the Keyswitch From the Current Setting to a New Setting Current Setting New Setting Result off off Keyswitch position not changed off standby Powers on all of the boards The boards belonging to a domain should already be in the Assigned state The domain will not be initialized at system power on off on Powers on and initializes the domain The domain will go through POST and the OpenBoot PROM The Solaris operating environment boots automatically unless you have set the OpenBoot PROM auto boot set to false off diag Similar to on except POST verbose and diagnostic level is to set to maximum The domain will boot from the diag device off secure Similar to on except the reset and break
92. same time Chapter 3 System Controller Alphabetical Command Reference 39 Note Any time the firmware is upgraded check the Install in o file for the firmware upgrade procedure This file is provided with your latest software release Also refer to the Release Notes for any notes or special procedures If you install a replacement board into the system 1 Check if the firmware level of the replacement board is the same as the board you replaced Incompatible boards are noted by the Failed board state in the output of the showboards command 2 If the board level is not the same as the board you replaced perform the flashupdate procedure on the board 3 If a board was noted by the Failed state in showboards after you flashupdate a compatible version power off the board to clear the Failed state Before you update the flash images make sure the firmware on the replacement board is compatible with the firmware of the board you are replacing for scapp CPU Memory board and I O assembly PROMs New firmware is loaded if you reboot the domain or turn the domain keyswitch off with setkeyswitch off and then turn it on with setkeyswitch on m To determine the version number of the current firmware 1 Use the showboards p proms command 2 Compare the x y z number format If x and y are the same then the flash images are compatible The new firmware may also contain a new rtos image If the rtos image that is currently install
93. save buffer Control w Erases from the beginning of the word to just before the cursor Stores erased characters in a save buffer Control d Erases next character Esc d Erases from the cursor to the end of the word Stores erased characters in a save buffer Control k Erases from the cursor to the end of the line Stores erased characters in a save buffer Control u Erases the entire line Stores erased characters in a save buffer Chapter 2 System Controller Syntax Arguments and Device Names 9 TABLE 2 6 Command Line Editing Capabilities Continued Keystroke Description Control r Retypes the line Control q Quotes the next character Allows you to insert Control characters Control y Inserts the contents of the save buffer before the cursor Command Line History Each shell keeps a short history of all entered commands To display the command line history use the history command After recalling the commands you can either edit them or execute them by pressing the Return key A history of at least eight previously typed command lines are saved TABLE 2 7 lists keystrokes you type to recall previously typed commands TABLE 2 7 Keystrokes that Recall Previously Typed Command Lines Keystroke Description Control p Selects and displays the previous line for subsequent editing Control n Selects and displays the next line for subsequent editing Control l Displays the entire command history list 10 Sun Fi
94. scription Describes the CPU type speed and Ecache size Power Grids Component Board Pwr Describes if the board is on or off Grid Describes which power grid the board is in Example Domain Shell CODE EXAMPLE 3 49 showboards a Command for the Domain Shell schostname A gt showboards a Slot Pwr Component Type State Status Domain NO SBO On CPU Board Active Passed A SB2 Off CPU Board Available Not tested Isolated NO IB6 On CPCI I O Board F3800 Active Passed A IB8 Off CPCI I O Board F3800 Available Not tested Isolated Chapter 3 System Controller Alphabetical Command Reference 89 showcomponent Shows the state of a component Scope platform shell domain shell Syntax for the Platform Shell showcomponent v component showcomponent v d domainID showcomponent h Syntax for the Domain Shell showcomponent v component showcomponent h Options Parameters h displays help for this command Includes component_name syntax boardname for CPU Memory boards is SBO SB5 and for I O assemblies is IB6 IB9 d domainID is a b c or d Shows components assigned to the domain platform only Description Without options this command shows the state of all components on a board With one or more options described in the Syntax section the output shows the state of one or more components on a board Displays the components that have been blacklisted by the disable
95. showenvironment h Options Parameters board_name is the name of the board Displays information for this board You can type multiple board names da domainID is a b c or d Displays information for boards assigned to that domain h displays help for this command 1 displays the limits that apply to each selected measurement These values are the threshold for each measurement Exceeding the threshold causes the status to display Max or Min Chapter 3 System Controller Alphabetical Command Reference 99 100 p part shows a specific part TABLE 3 13 TABLE 3 13 Parts for showenvironment p part Report Description currents Displays currents power supplies only fans Displays fan states faults Displays values that are suspected to be invalid temps Displays temperatures only voltage Displays voltages only 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 1 and w w shows warning thresholds Description Displays the current environmental status temperatures currents voltages and fan status for the system platform shell or the current domain domain shell In a domain shell the domain can only display boards that have been assigned to the domain such as CPU Memory boards and I O assemblies The board s must be powered on Boards that are not powered on are not monitored and have no environmental data
96. ssage buffer Each domain and the platform have separate and independent buffers Once a buffer is filled the old messages are overwritten These are messages from the system controller not the Solaris operating environment that are logged to the consoles This is a small buffer and it is cleared when you reboot the system controller or when it loses power There is a separate log for the platform and for each domain If the loghost has been configured the platform and each domain are configured separately using setupplatform for the platform loghost and setupdomain for each domain 106 Sun Fire 6800 4810 4800 3800 System Controller Command Reference Manual October 2001 loghost then the messages will also be logged to the loghost for storage Note that storing the messages is only temporary and will not survive a system reboot or a loss in power See Also setupdomain setupplatform showdomain showplatform Example CODE EXAMPLE 3 60 displays the output of the showlogs command run at the platform shell after rebooting the system CODE EXAMPLE 3 60 Sample Output of the showlogs Command Run After Rebooting the System schostname ay 09 SE L2a Sy ay 09 75MHz ay 09 SC gt showlogs 13 36 21 sp4 scO Platform SC ID 506094 local0 notice Boot ScApp RTOS 17 13 36 37 sp4 scO Platform SC ID 595276 local0 notice Clock Source 13 36 50 sp4 scO Platform SC ID 223289 local0 notic Master System Controll er
97. stem Controller Command Reference Manual October 2001 TABLE 3 10 Parameter Values for the setupdomain Command Continued Parameter Value Description max All system board components are tested with all tests and test patterns This is the same as default mem1 Runs all tests at the default level plus more exhaustive DRAM and SRAM test algorithms These tests take a long time to run mem2 This is the same as mem1 with the addition of a DRAM test that does explicit compare operations of the DRAM data These tests take a long time to run verbosity level off No status messages are displayed POST output is error level interleave scope interleave mode reboot on error min default value max off min max default value within cpu within board default value across boards optimal default value fixed off false default value always displayed However with the value set to off there is very little POST output displayed and there may be a long time between output displays This depends on your hardware configuration and the setting of diag level Test names status messages and error messages are displayed Subtest trace messages are displayed No error messages are displayed The failing test name is displayed All relevant error status is displayed The memory banks on a CPU will be interleaved With each other Each CPU may have up to four logical memory banks The memory banks on a system bo
98. t a file Examples are ftp userid password Ghost path tp host path Note The hostname you enter can be the hostname or a hostname with a fully qualified domain name You cannot use a partial domain name For example schostname schostname eng sun com can be a valid hostname Note The directory specified in the URL path must have write permission for the specified user If a user was not specified then anonymous ftp is used Chapter 3 System Controller Alphabetical Command Reference 33 Description Saves the platform and domain configurations to a server for recovery in case of a system controller failure This command creates two data files at the specified URL schostname nvci and schostname tod Use this command when you complete setting up the initial configuration of the platform and the domains each time you modify the configuration or change the hardware configuration For example when you type one of the following commands setupplatform setupdomain setdate addboard deleteboard enablecomponent disablecomponent and password The data files include schostname nvci and schostname tod By running this command again the new platform and domain configurations are saved to a server Caution This command should be run any time you change the platform or domain configuration see the list of commands in the first paragraph Invoking this command is very important because if the System Controller board
99. t in the platform and each domain Software Reset Chapter 3 System Controller Alphabetical Command Reference 61 resume Exits the domain shell and resumes access to the domain console Scope domain shell Syntax resume h Options Parameters h displays help for this command Description Exits the domain shell and resumes access to the domain console This command requires an active domain If the domain is not active there is no domain console and there is nothing to resume When you connect to the domain console there may not be any output displayed If either the OpenBoot PROM or the Solaris operating environment is running in the domain press the Return key to get the prompt Otherwise POST output is displayed may be a delay in displaying POST output Other system controller commands that also resume the domain console are listed in the following section See Also break reset setkeyswitch 62 Sun Fire 6800 4810 4800 3800 System Controller Command Reference Manual October 2001 Example CODE EXAMPLE 3 35 resume Command Example in Active Domain A schostname A gt resume Note that no other output is seen If the OpenBoot PROM is at the ok prompt or the Solaris operating environment is atthe login prompt you must press the Enter key in order to see the prompt Otherwise you will need to wait for output to be generated by POST the OpenBoot PROM or the Solaris operating environment
100. tate You cannot power off a Repeater board if it is being used by a domain You can turn off power supplies if turning off the power supply would leave sufficient power in the power grid to support the current load of the power grid This varies with the configuration It you attempt to power off a power supply that is required to support the current load the power supply will not be powered off and a message stating why is displayed You can power off redundant power supplies If powering off a fan would result in insufficient cooling it cannot be powered off See Also poweron setkeyswitch showboards Sun Fire 6800 4810 4800 3800 System Controller Command Reference Manual October 2001 Examples To power off CPU Memory board sb2 from the platform shell CODE EXAMPLE 3 27 type CODE EXAMPLE 3 27 poweroff Command Example Showing Powering Off sb2 schostname SC gt poweroff sb2 To power off all power supplies fan trays and system boards CODE EXAMPLE 3 28 type CODE EXAMPLE 3 28 poweroff Command Example Showing Powering Off All Power Supplies Fan Trays and System Boards in the Platform Shell schostname SC gt poweroff all Note From the domain shell you cannot power off power supplies fan trays Repeater boards or power grids To power off these components connect to the platform shell Chapter 3 System Controller Alphabetical Command Reference 51 poweron Powers on compo
101. te 6 B board state Active 6 Assigned 6 Available 6 board states 6 boards CPU Memory testing 116 listing assignment information and status 87 powering off 49 50 53 powering on 52 status 87 unassigning 25 Break character 19 break command 19 break shell commands 13 exiting 62 C command history 46 command summary 13 console port commands 13 CPU Memory board testing 116 current logging configuration displaying 106 D deleteboard command 25 displaying 106 current environmental status 99 100 current logging configuration 106 version and uptime information 115 domain console resuming access to 62 domain parameters setting up 79 domains resetting 57 E environmental status displaying 99 100 Index 121 F flash PROMs updating 39 flashupdate command 39 H help command 43 history command 46 K keyswitch command 74 keyswitch positions virtual 74 L listing board information 87 logging configuration current 106 P parameters domain setting up 79 password command 47 password setting 47 power grids powering off 49 50 powering on 52 53 power supplies powering off 49 50 powering on 52 53 powering off power grids power supplies or boards 50 powering on power grids power supplies or boards 53 poweroff command 49 50 poweron command 52 53 R reset command 57 resetting domains 57 resume command 62 S setdate command
102. tem Controller Command Reference Manual October 2001 a 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 platform including Network attributes of the platform ACLs for each domain Domain status SNMP status Loghosts Partition configuration Other values that are used but are not configurable such as the MAC address host ID and system serial number See Also setupplatform showdate Example CODE EXAMPLE 3 61 showplatform Output for a Sun Fire 6800 System schostname SC gt showplatform Domain Solaris Nodename Domain Status Keyswitch Powered Off off Powered Off standby Powered Off off Powered Off off OO WwW The system controller is configured to be on a network Network settings DHCP Hostname schostname IP Address XXX XXX XXX XX Netmask XXX XXX XXX X Gateway XXX XXX XXX XXX Chapter 3 System Controller Alphabetical Command Reference 109 CODE EXAMPLE 3 61 showplatform Output for a Sun Fire 6800 System Continued DNS Domain domainname Primary DNS Server XXX XXX X XXX Secondary DNS Server XXX XXX X XXX Loghost for Platform Log Facility for Platform local0 SNMP Agent enabled Chassis Description Sun Fire 6800 Chassis Contact Chassis Location Trap Hosts Public Communi
103. testing and is not usable This could also indicate corrupt or incompatible firmware OK The component is functioning properly Under Test The domain is running POST power on self test testing has been initiated using the setkeyswitch command the testboard command or an SNMP operation 6 Sun Fire 6800 4810 4800 3800 System Controller Command Reference Manual October 2001 TABLE 2 4 Status Field of the showboards Command Continued Test Status Description Not Tested Degraded The board has not been tested Certain components on the board have failed or are disabled A board is degraded when there are still usable parts on the board The slot is empty or not applicable for this device Domain Status In the showplat form and showdomain commands one of the fields in the command output is domain status The main values of domain status are TABLE 2 5 TABLE 2 5 Values for the Domain Status Column in showplat form and showdomain Command Output Domain State Description Powered Off Standby Running POST Active Active OpenBoot PROM Active Booting Active Solaris Active Halted Active Reset Active Panicking Active Debugger Not Responding Paused due to an error The domain is not active and the keyswitch is in the off position The domain is not active and the keyswitch is in the standby position The domain is active and is running POST power on self test The
104. tform or domainIDs A B C or D Sun Fire 6800 4810 4800 3800 System Controller Command Reference Manual October 2001 console Connects to a domain from the platform Scope platform shell Syntax console d domainID console h Options Parameters 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 h displays help for this command Description Connect to a domain You use the console command to navigate from the platform to a domain If a password was created for connecting to this domain you must enter the password If the domain is active the domain is running the Solaris operating environment OpenBoot PROM or POST you are connected to the domain console Otherwise you are connected to the domain shell To obtain the domain shell from the domain console see the chapter System Controller Navigation Procedures in the Sun Fire 6800 4810 4800 3800 Systems Platform Administration Manual See Also disconnect Chapter 3 System Controller Alphabetical Command Reference 23 Examples Platform Shell When the domain is not active and there is no password initialized for this domain CODE EXAMPLE 3 5 console Example and No Password Set Accessing Domain B schostname SC gt console b Connected to Domain B Domain Shell for Domain B schostname B gt When a domain is not active and a password is initi
105. tions Parameters w displays the contents of register windows The first windows displayed in the output are the stack trace for the failing CPU The windows that are not part of the stack trace follow in the same order s displays the contents of the secondary save area Normally the command displays the contents of the primary save area that holds the registers from the time of the first failure If more than one failure occurs on a CPU the secondary save area holds the selected registers from the time of the last failure v displays a summary of all available registers Includes the registers available with s and w options a Default display no options Description Prints a summary report of the contents of registers from the save areas of every CPU in the domain that has a valid saved state By specifying certain options the format and content of the printed report can be controlled With no options the command displays the following registers a Register window globals outs locals ins that was current at the time of the failure m CANSAVE CANRESTORE OTHERWIN and other selected privileged registers m AFAR and AFSR m TICK and some related CPU specific registers Chapter 3 System Controller Alphabetical Command Reference 113 Since a CPU that does not have a saved state does not produce output there is no output when CPUs are reset or have not failed After a failure the saved state is
106. ty String P public Private Community String P private SBO SB1 SB2 SB3 SB4 SB5 IB6 IB7 IB8 IB9 SBO SB1 SB2 SB3 SB4 SB5 IB6 IB7 IB8 IB9 SBO SB1 SB2 SB3 SB4 SB5 IB6 IB7 IB8 IB9 SBO SB1 SB2 SB3 SB4 SB5 IB6 IB7 IB8 IB9 ACL for Domain ACL for Domain ACL for Domain ACL for Domain O Aa uw Pt SC POST diag Level off Chassis is in dual partition mode schostname SC gt CODE EXAMPLE 3 62 shows the showplatform v command output CODE EXAMPLE 3 62 showplatform v Output for a Sun Fire 6800 System schostname SC gt showplatform v Domain Solaris Nodename Domain Status Keyswitch A bm Powered Off OLE B Powered Off off C 2 Powered Off off D Powered Off off The system controller is configured to be on a network Network settings DHCP Hostname schostname IP Address XXX XXX XXX XX 110 Sun Fire 6800 4810 4800 3800 System Controller Command Reference Manual October 2001 CODE EXAMPLE 3 62 showplatform v Output for a Sun Fire 6800 System Continued Netmask XXX XXX XXX X Gateway XXX XXX XXX XXX DNS Domain domainname Primary DNS Server XXX XXX X XXX Secondary DNS Server XXX XXX X XXxX MAC Address HostID Domain A XXIXXIXXIXXIXXIXX XXXXXXXX Domain B XXIXXIXXIXXIXXIXX XXXXXXXX Domain C XXIXXIXXIXXIXXIXX XXXXXXXX Domain D XXIXXIXXIXXIXXIXX XXXXXXXX SSCO XXEXXEXXXX XX XX XXXXXXXX SSCI XXIXXIXXIXXIXXIXX XXXXXXXX System Serial Number XXXXXXXX Loghost for Platform Log Facility for
107. upgrade the firmware to obtain new features and bug fixes If you install a replacement board into the system 1 Check if the firmware level of the replacement board is the same as the board you replaced 2 If is it not perform the flashupdate procedure on the board Caution Under normal circumstances the flashupdate command will complete successfully However if the flashupdate command is terminated abnormally such as a power failure a failed network connection and so on the system controller goes into maintenance mode To bring the system controller out of maintenance mode and back into its normal operating mode type the flashupdate command with a valid URL or use the reboot command to boot the system controller with an older firmware version See Also Sun Fire 6800 4810 4800 3800 Systems Platform Administration Manual Chapter 3 System Controller Alphabetical Command Reference 41 42 flashupdate Command Platform Shell Examples Note In the following examples since the output is very long only the command you type is listed in the code box Note The flashupdate all flashupdate rtos and flashupdate scapp commands cause the system controller to reboot once a To update the active System Controller board and the system controller real time operating system rtos perform this procedure from the platform console and watch the console output This command reboots the system controller Type
108. xample is a required argument and is the board name for a CPU Memory board schostname SC gt addboard d a sb2 Command Names Most system controller commands are in the form of verbnoun Command names are in the English language System controller commands are case insensitive Note When typing system controller commands you can type the complete command name or type just enough of the command name to uniquely identify it Component Names TABLE 2 1 shows the component names that are accessible from the platform TABLE 2 2 shows the component names that are accessible from the domain In both tables you can type the component names in either upper case or lower case 4 Sun Fire 6800 4810 4800 3800 System Controller Command Reference Manual October 2001 Note The components in TABLE 2 1 and TABLE 2 2 depend on the system you have For example only the Sun Fire 6800 system can have six power supplies and six CPU Memory boards TABLE 2 1 Components That Are Accessible From the Platform Device Description Device Name Power grids GRIDO GRIDI Power supplies PSO PS1 PS2 PS3 PS4 PS5 CPU Memory boards SBO SBl SB2 SB3 SB4 SB5 1 0 assemblies IB6 IB7 IB8 IB9 Repeater boards RPO RP1 RP2 RP3 ID Source board IDO Fan trays FTO FT1 FI2 FT3 System controller SscO SSC1 Power grids are not a component but a division of the Sun Fire 6800 system into two distinct halves of the system
109. y SNMP Agent Platform Description If the answer is no leave all network parameters as unconfigured You will be prompted to enter the hostname If the answer if yes you are prompted to configure the network settings DHCP means the system controller network configuration is retrieved from a DHCP server e Static means the network settings will be manually configured If you select the static setting you will be asked for the following network parameters The human readable network identity for this system controller The network identity used by computers For this value specify how much of the address should be reserved for subdividing networks into subnetworks Must be specified in dot notation address For example 255 255 255 0 IP address of the gateway Domain name For example xxx xxx com IP address of your primary DNS server IP address of your secondary DNS server The name or the IP address of the loghost for this domain SNMP The log facility Facility is defined by the Solaris operating environment syslogdin etc syslog conf The default is localo The SNMP agent enables or disables SNMP The default is SNMP disabled Default value is the platform model name 82 Sun Fire 6800 4810 4800 3800 System Controller Command Reference Manual October 2001 Parameter TABLE 3 11 setupplatform Parameter Values Continued Description Platform Contact Platform Location Trap Hosts

Download Pdf Manuals

Related Search

Related Contents

RAPPORT ANNUEL 2013 DE l`ECES Sommaire  manual usuario minestim  Andis HD-3L    le nouveau outlandermc l performant fiable accessible chaque quad  "取扱説明書"  manual de instrucciones certificado de garantia    Zebra T50 Walkie Talkie  Samsung RE-F70 User Manual  

Copyright © All rights reserved. Failed to retrieve file