A P P E N D I X D - System Controller Commands

A P P E N D I X D

System Controller Commands

This appendix lists the commands available from the System Controller's sc> prompt.

This appendix contains the following sections:

Section D.1, Power Commands for the Entire Chassis

Section D.2, Power Commands for the System Controllers

Section D.3, Power Commands for the Server Blades

Section D.4, Reset Commands for the System Controllers, Switches, and Blades

Section D.5, Monitoring Commands

Section D.6, System Controller Configuration Commands

Section D.7, Commands Relating to the Switches and Blades

Section D.8, Commands for Administering User Accounts

D.1 Power Commands for the Entire Chassis

Note - You can power off (or power down to a ready-to-remove or standby) state all components at once except the active System Controller. The blade system chassis is designed so that you cannot power off or down the active System Controller in a single command. For information about powering down the active System Controller, refer to the Sun Fire B1600 Blade System Chassis Administration Guide.


Command and Option (if any)	Effect of the Command
`sc> poweron ch`	Powers on all components. Use this command to recover all components at once from a powered down, ready-to-remove, or standby power state.
`sc> poweroff ch`	Powers off all components on the chassis except the active System Controller.
`sc> poweroff -f ch`	Powers off all components (except the active System Controller) even if an orderly shutdown of the operating system on a component has failed.
`sc> poweroff -F ch`	Powers off all components (except the active System Controller) even if there are commands (from other users) involving some components that have not finished executing.
`sc> poweroff -y ch`	Powers off all compononents (except the active System Controller) without displaying the confirmation prompt.
`sc> poweroff -s ch`	Powers down all components (except the active System Controller) to standby mode (equivalent of `standbyfru ch` command).
`sc> poweroff -r ch`	Powers down all components (except the active System Controller) to a state in which it is safe for them to be removed. The `-r` option also turns on the "ok to remove" LED for each component (equivalent of the `removefru ch` command).
`sc> standbyfru ch`	Powers down all components (except the active System Controller) to standby mode (equivalent of the `poweroff -s ch` command).
`sc> standbyfru -f ch`	Powers down all components (except the active System Controller) to standby mode even if an orderly shutdown of the operating system on a component has failed.
`sc> standbyfru -F ch`	Powers down all components (except the active System Controller) to standby mode even if there are commands (from other users) involving some components that have not finished executing.
`sc> standbyfru -y ch`	Powers down all components (except the active System Controller) to standby mode without displaying the confirmation prompt.
`sc> removefru ch`	Powers down all components (except the active System Controller) to a state in which it is safe for them to be removed; this command also turns on the "ok to remove" LED for each component (equivalent of the `poweroff -r ch` command).
`sc> removefru -f ch`	Powers down all components (except the active System Controller) to a state in which it is safe for them to be removed even if an orderly shutdown of the System Controller's operating system has failed. This command also turns on the "ok to remove" LED for each component.
`sc> removefru -F ch`	Powers down all components (except the active System Controller) to a state in which it is safe for them to be removed even if there are commands (from other users) involving some components that have not finished executing.
`sc> removefru -y ch`	Powers down all components (except the active System Controller) to a state in which it is safe for them to be removed but does not display the confirmation prompt before doing so. This command also turns on the "ok to remove" LED on for each component.

D.2 Power Commands for the System Controllers

Note - You can only power off or down the standby System Controller. For information about powering down the active System Controller, refer to the Sun Fire B1600 Blade System Chassis Administration Guide.


Command and Option (if any)	Effect of the Command
`sc> poweron [-F] ssc`n	Powers on SSC n (where n designates the standby SSC and is either 0 or 1 depending on whether the standby System Controller is in SSC0 or SSC1). Use this command to recover the standby SSC from a powered down, ready-to-remove, or standby power state. The `-F` option powers on the standby SSC even if there are commands (from other users logged on to the active System Controller) that involved the standby SSC in its non-powered state and that have not yet finished executing.
`sc> poweroff ssc`n	Powers off SSC n (where n is 0 or 1 depending on whether the standby System Controller is in SSC0 or SSC1).
`sc> poweroff -f ssc`n	Powers off the standby System Controller (SSC0 or SSC1) even if an orderly shutdown of the System Controller's operating system has failed.
`sc> poweroff -F ssc`n	Powers off the standby System Controller (SSC0 or SSC1) even if the active System Controller has not finished executing commands (from another user) involving the standby System Controller.
`sc> poweroff -y ssc`n	Powers off the standby System Controller (SSC0 or SSC1) without displaying the confirmation prompt.
`sc> poweroff -s ssc`n	Powers the standby System Controller (SSC0 or SSC1) down to standby-power mode (equivalent of `standbyfru` command).
`sc> poweroff -r ssc`n	Powers the standby System Controller down to a state in which it is safe for it to be removed; the `-r` option also turns on the "ok to remove" LED (equivalent of the `removefru` command).
`sc> standbyfru ssc`n	Powers the standby System Controller down to standby-power mode (equivalent of the `poweroff -s` command).
`sc> standbyfru -f ssc`n	Powers the standby System Controller down to standby-power mode even if an orderly shutdown of its operating system has failed.
`sc> standbyfru -F ssc`n	Powers the standby System Controller down to standby-power mode even if the active System Controller has not finished executing commands (from another user) involving the standby System Controller.
`sc> standbyfru -y ssc`n	Powers the standby System Controller down to standby-power mode without displaying the confirmation prompt.
`sc> removefru ssc`n	Powers the standby System Controller down to a state in which it is safe for it to be removed; this command also turns on the "ok to remove" LED on the SSC's rear panel (equivalent of the `poweroff -r` command).
`sc> removefru -f ssc`n	Powers the standby System Controller down to a state in which it is safe for it to be removed even if an orderly shutdown of the System Controller's operating system has failed. This command also turns on the "ok to remove" LED on the SSC's rear panel.
`sc> removefru -F ssc`n	Powers the standby System Controller down to a state in which it is safe for it to be removed even if the active System Controller has not finished executing commands (from another user) involving the standby System Controller.
`sc> removefru -y ssc`n	Powers the standby System Controller down to a state in which it is safe for it to be removed but does not display the confirmation prompt before doing so. This command also turns on the "ok to remove" LED on the SSC's rear panel.

D.3 Power Commands for the Server Blades


Command and Option (if any)	Effect of the Command
`sc> poweron s`n	Powers on the blade in slot n. Use this command to recover the blade from a powered down, ready-to-remove, or standby power state.
`sc> poweroff s`n	Powers off the blade in slot n.
`sc> poweroff -f s`n	Powers off the blade in slot n even if an orderly shut down of the System Controller's operating system has failed.
`sc> poweroff -F s`n	Powers off the blade in slot n even if the active System Controller has not finished executing commands (from another user) involving the specified blade.
`sc> poweroff -y s`n	Powers off the blade in slot n without displaying the confirmation prompt.
`sc> poweroff -s s`n	Powers the blade in slot n down to standby mode (equivalent of `standbyfru` command).
`sc> poweroff -r s`n	Powers the blade in slot n down to a state in which it is safe for it to be removed; the `-r` option also turns on the blue "ok to remove" LED on the front of the blade (equivalent of the `removefru` command).
`sc> standbyfru s`n	Powers the blade in slot n down to standby mode (equivalent of the `poweroff -s` command).
`sc> standbyfru -f s`n	Powers the blade in slot n down to standby mode even if an orderly shut down of the blade's operating system has failed.
`sc> standbyfru -F s`n	Powers the blade in slot n down to standby mode even if the active System Controller has not finished executing commands (from another user) involving the specified blade.
`sc> standbyfru -y s`n	Powers the blade in slot n down to standby mode without displaying the confirmation prompt.
`sc> removefru s`n	Powers the blade in slot n down to a state in which it is safe for it to be removed; this command also turns on the blue "ok to remove" LED on the front of the blade (equivalent of the `poweroff -r` command).
`sc> removefru -f s`n	Powers the blade in slot n down to a state in which it is safe for it to be removed. This command performs power down even if an orderly shutdown of the blade's operating system has failed. Thecommand also turns on the blue "ok to remove" LED on the front of the blade.
`sc> removefru -F s`n	Powers the blade in slot n down to a state in which it is safe for it to be removed. This command performs power down even if the active System Controller has not finished executing commands (from another user) involving the specified blade.
`sc> removefru -y s`n	Powers the blade in slot n down to a state in which it is safe for it to be removed but does not display the confirmation prompt before doing so. This command also turns on the blue "ok to remove" LED on the front of the blade.

D.4 Reset Commands for the System Controllers, Switches, and Blades


Command and Option (if any)	Effect of the Command
`sc> reset s`n	Resets the server blade in slot n.
`sc> reset s`n sy	Resets the server blades in slots n and y. (Specify the blades you want to reset in a space-separated list.)
`sc> reset -y s`n	Resets the blade in slot n without displaying the confirmation prompt.
`sc> reset -x s`n	Performs an externally-initiated reset on the blade in slot n.
`sc> reset -F s`n	Forces the specified blade to reset even if the active System Controller has not finished executing commands (for another user) involving that blade.
`sc> reset ssc`n/`swt`	Resets the switch in SSCn (where n is 0 or 1).
`sc> reset -y ssc`n/`swt`	Resets the switch in SSCn without displaying the confirmation prompt.
`sc> reset -F ssc`n/`swt`	Resets the switch in SSCn even if the active System Controller has not finished executing commands (for another user) involving that switch.
`sc> reset -x ssc`n/`swt`	Performs an externally-initiated reset on the switch in SSCn.
`sc> reset ssc`n/`sc`	Resets the standby System Controller (where n is 0 or 1 depending whether the standby System Controller is in SSC0 or SSC1).
`sc> reset -F ssc`n/`sc`	Forces the standby System Controller to reset even if the active System Controller has not finished executing commands (from another user) involving the standby System Controller.
`sc> resetsc`	Resets the active System Controller. Neither of the switches is affected by this reset. You will lose your user session when you reset the System Controller using this command.
`sc> resetsc -y`	Resets the active System Controller without displaying the confirmation prompt.
`sc> resetsc -F`	Resets the active System Controller without waiting for any outstanding `flashupdate` or `setupsc` commands (from another user) to finish executing. By default, the System Controller will not initiate the reset of itself until it has finished executing these commands for another user.
`sc> reset ssc`n	Resets the standby System Controller (n cannot be the active System Controller), both switches, and all server blades installed in the chassis.
sc> break sn	If Solaris is running (and it is configured to handle breaks in this way), the `break` command causes a Solaris blade to drop from Solaris into either kadb or OBP, depending on the mode in which Solaris was booted.
sc> break -y sn	As above, but the -y option means that you are not prompted to confirm the `break` command that you have initiated.
sc> break sn sy sx	As above, but this command applies the break to blades n, y, and x.

D.5 Monitoring Commands


Command and Option (if any)	Effect of the Command
`showsc [-v]`	Displays a summary of the configuration of the active System Controller.
`showplatform [-v]\|[-p]`{[sscn][sscn/swt][psn][sn][ch]}	Displays the status (Ok, Faulty, Not Present) of each component. It also displays the status of the Operating System in all domains on the chassis (that is, in the System Controllers, switches, and blades). If you use the -p option, the status of the Operating System in all the domains is not displayed. If you use the -v option, the primary MAC address and serial number of components are displayed.
showenvironment [-v] {[sscn][psn][sn]}	Displays the status of the environmental sensors in the various components of the chassis. For example, this command tells you the internal temperatures of the components, the speeds of their fans, and the level of current on their supply rails.
showfru {sscn\|sn\|ch\|psn}	Displays the contents of a specified component's (or of all components') FRUID database. Each component maintains extensive information about itself. This includes static data (for example, hardware version information) and dynamic data (for example, recent event messages generated by the component).
showdate	Displays the current date and time (in UTC format) according to the System Controller.
`showlogs [-b]\|[-e] [-g] [-v] {ssc`n\|`s`n}	Displays the events that have been logged for a specified blade, switch, or System Controller. Specify `-b` to view the first n events, `-e` to view the last n events, `-g` to specify the number of lines of output you want to view before a pause in the display, and `-v` to view all events in the log.
`showlocator`	Tells you whether the locator LED is on or off.
`consolehistory` [-b]\|[-e] [-g] [boot\|run] sscn/swt\|sn	Displays the contents of the switch or blade console's boot- or run-time buffer. Specify `-b` to view the first n lines of information, `-e` to view the last n lines, `-g` to specify the number of lines of output you want to view before a pause in the display.
`showusers`	Shows the users currently logged into the System Controller.
`usershow` [username]	Shows details of the specified user's login account. If no user is specified, the command shows details of all user accounts. The output indicates users' permissions and whether they have a password assigned or not.

D.6 System Controller Configuration Commands


Command and Option (if any)	Effect of the Command
`setupsc`	Enables you to configure the active System Controller interactively. (There is no non-interactive method available.) The standby System Controller automatically uses the same configuration as the active.
`flashupdate [-v] [-F] -s` IP address `-f` path `ssc`n`\|s`n	Enables you to upgrade new firmware to a System Controller or to a server blade. IP address is the IP address of the TFTP server on which the firmware is stored. Path is the location of the firmware on the TFTP server. The `-v` option displays information about the upgrade process as it takes place. By default, the System Controller waits until outstanding commands (for example from different telnet sessions) involving a specified blade have finished executing before it initiates a flashupdate. However, the `-F` option forces the flashupdate to proceed even if there are System Controller commands involving the specified blade that have not finished executing.
`setfailover [-F]`	Tells you which System Controller is the active and which the standby System Controller. It also prompts you to confirm that you want to force the current standby System Controller to take over from the active one. If you have only used the command to find out which System Controller is active, just answer no. The `-F` option causes the failover process to be initiated even if there are commands from other users that have not finished executing (by default, the System Controller waits until there are no outstanding commands before it initiates a failover).
`setdefaults [-y]`	Returns the active System Controller (but not its switch) to the factory default settings. The -y option causes the the SSC to revert to the factory default settings without issuing a confirmation prompt.
`setdate` [mmdd]HHMM[.SS]\| mmddHHMM[cc]yy[.SS]	Enables you to set the time of day on the System Controller, switches, and any currently inserted server blades. When you set the date and time, you must use Co-ordinated Universal Time (UTC). The Solaris server blades will work out the local time for your time-zone by using an offset from UTC. And the blades discover UTC from the System Controller. The variables are as follows: mm is the month (two digits) dd is the day (two digits) HH is the hour (two digits) MM is the minutes (two digits) SS is seconds (two digits)
`setlocator on\|off`	Turns the chassis locator LED on and off.

D.7 Commands Relating to the Switches and Blades

Note - Whenever you are at a switch or blade console, type #. to return to the active System Controller's sc> prompt.


Command and Option (if any)	Effect of the Command
`console [-f]\|[[-r] ssc`n`/swt\|s`n	Access the console of a switch or blade. Use the `-f` command to force into "read-only" mode any other user who is currently logged in. Use the `-r` command to log in yourself using "read-only" mode.
`consolehistory` [-b]\|[-e] [-g] [boot\|run] sscn/sc\|sscn/swt\|sn	Displays the contents of the specified System Controller, switch, or blade console's boot- or run-time buffer. Specify `-b` to view the first n lines of information, `-e` to view the last n lines, `-g` to view a specified number of lines of information before a pause in the display.
`bootmode reset_nvram\|diag\|skip_diag\| normal\|bootscript="string" s`n `{s`n`}`	This command allows you to specify a boot mode for a blade. You need to use it to boot Linux or Solaris x86 blades for the first time from a PXE environment (see Chapter 4). For more information, refer to the Sun Fire B1600 Chassis Administration Guide.
`flashupdate -s` IP address `-f` path `[-v] ssc`n`/sc\|s`n	Enables you to upgrade new firmware to the active System Controller or to a server blade. IP address is the IP address of the TFTP server on which the firmware is stored. Path is the location of the firmware on the TFTP server. The `-v` option displays information about the upgrade process as it takes place.

D.8 Commands for Administering User Accounts


Command and Option (if any)	Effect of the Command
`useradd` username	Adds a named user to the list of permitted System Controller users.
`userdel` username	Deletes a user from the list of permitted System Controller users.
`userpassword` username	This command allows a user with `a`-level permissions to alter another user's password.
`password`	This command allows a user to change his or her own password (in other words, to change the password of the user that he or she is currently logged in as).
`userperm` username [a][u][c][r]	This command specifies the named user's permission levels. `c` gives console access to blades and switches: `a` gives administration privileges (enabling the named user to change the configuration of the System Controller), `u` gives user administration privileges (enabling the named user to administer user accounts), and `r` gives reset permissions (enabling the named user to reset components of the chassis or to power them on and off).
usershow [username]	Shows details of the specified user's login account. If no user is specified, the command shows details of all user accounts. The output indicates users' permissions and whether they have a password assigned or not.
`showusers`	Lists all users currently logged into the System Controller.