C H A P T E R 3 |
System Controller Alphabetical Command Reference |
This chapter provides a summary of the system controller commands designed for an end-user on the Sun Fire 6800/4810/4800/3800 systems, describes the system controller command line interface, and provides descriptions and examples for each command.
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.
The following sections describe the system controller commands.
addboard -d domainID system_board_name [system_board_name . . .]
addboard system_board_name [system_board_name . . .]
-d specifies a domainID as an option (platform shell only).
-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).
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.
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 setupplatform command.
If 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 "General Administration" 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.
deleteboard, setkeyswitch, showboards, showdomain, showplatform, "Assigning and Unassigning Boards" in the "General Administration" 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)
From the platform shell to add board name sb2 to domain A (CODE EXAMPLE 3-1), type:
schostname:SC> addboard -d a sb2 |
To assign board name sb2 to the current domain (CODE EXAMPLE 3-2), type:
schostname:A> addboard sb2 |
Adds a Capacity on Demand (COD) right-to-use (RTU) license key to the COD license database.
addcodlicense license-signature
-h displays help for this command.
license-signature is the COD RTU license key to be added to the COD license database.
Adds the specified COD RTU license key to the COD license database on the system controller.
deletecodlicense, showcodlicense, showcodusage
schostname:SC> addcodlicense 01:80d8a9ed:45135285:0201000000:8:00000000:0000000000000000000000 |
Note - The COD RTU license key listed above is provided as an example and is not a valid license key. |
Sends a Break signal to the domain console.
-h displays help for this command.
-y answers yes to the warning message. Does not prompt for confirmation.
-n answers no to the warning message. Does not execute this command if confirmation is requested.
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.
resume, setkeyswitch, showkeyswitch
CODE EXAMPLE 3-4 shows using the break command to pause the Solaris operating environment and enter the OpenBoot PROM.
schostname:A> break This will suspend Solaris in domain A. Do you want to continue? [no] yes Type `go' to resume. debugger entered. {1} ok |
Displays connections to the system controller or a domain.
-h displays help for this command.
-d domainID shows connections to the specified domain (a, b, c, or d).
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.
TABLE 3-2 describes the headers in the output for CODE EXAMPLE 3-5.
Connects to a domain from the platform.
-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.
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.
When the domain is not active and there is no password initialized for this domain:
schostname:SC> console b Connected to Domain B Domain Shell for Domain B schostname:B> |
When a domain is not active and a password is initialized for this domain:
schostname:SC> console a Enter Password: Connected to Domain A Domain Shell for Domain A schostname:A> |
When a domain is active and a password is not set for this domain:
schostname:SC> 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.
Unassigns a board from the domain where it is currently assigned.
deleteboard system_board_name [system_board_name . . .]
-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).
Unassigns a board from the domain where it is currently assigned. When you use this command from your current 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. The board does not have to be in the access control list (ACL) to be unassigned from the domain.
To unassign an active board from a domain, you must halt the Solaris operating environment in the domain. Or, you can use DR to unassign an active board. For an overview of steps to perform, see the section "Assigning and Unassigning Boards" in the "General Administration" 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.
addboard,showboards, "Assigning and Unassigning Boards" in the "General Administration" 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)
To delete I/O assembly ib7, type:
schostname:SC> deleteboard ib7 |
To delete CPU/Memory board sb3 from the current domain, domain A, type:
schostname:A> deleteboard sb3 |
Removes a Capacity on Demand (COD) right-to-use (RTU) license key from the COD license database.
deletecodlicense [-f] license-signature
-f forces the specified COD RTU license key to be deleted from the COD license database, even if the license removal will result in a license violation.
-h displays help for this command.
license-signature is the COD RTU license key to be removed from the COD license database.
Removes a COD RTU license key from the COD license database on the system controller. For further information on COD RTU license keys, refer to the Sun Fire 6800/4810/4800/3800 Systems Platform Administration Manual.
The system checks the number of licenses against the number of COD CPUs in use. If the license removal will result in an insufficient number of COD RTU licenses for the COD CPUs in use, the system will not delete the license key from the COD license database. If you want to delete the COD RTU license key, you must reduce the number of COD CPUs in use. You can either power off the appropriate number of domains or use dynamic reconfiguration (DR) to disconnect the appropriate number of boards.
addcodlicense, showcodlicense, showcodusage
schostname:SC> deletecodlicense 01:80d8a9ed:45135285:0201000000:8:00000000:0000000000000000000000 |
Note - The COD RTU license key listed above is provided as an example and is not a valid license key. |
The disablecomponent command has been deprecated starting with the 5.15.0 release and has been replaced by the setls command. It is suggested that you use the setls command even though the disablecomponent command is still available. For further information, see the setls command description.
Disconnects the current or specified connection.
-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.
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.
To disconnect a session from the system controller platform shell with a telnet connection (CODE EXAMPLE 3-11), type:
schostname:SC> disconnect Connection closed by foreign host. |
If you are connected to the system controller platform console with the serial connection, you will see the following after typing disconnect (CODE EXAMPLE 3-12):
To disconnect a session from a system controller domain shell (CODE EXAMPLE 3-13), type:
schostname:A> disconnect Connection closed by foreign host. |
CODE EXAMPLE 3-13 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. |
Saves the platform and domain configurations to a server.
-h displays help for this command.
-f specifies the URL, which must use the ftp protocol. The URL must point to a directory and not a file. Examples are:
ftp://userid:password@hostname//path
For details on ftp URLs, see Using FTP URLs.
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. |
Saves the platform and domain configurations to a server for recovery. 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 when you change the hardware configuration. For example, a configuration change occurs when you use any of the following commands: setupplatform, setupdomain, setdate, addboard, deleteboard, setls, and password. By running the dumpconfig command again, the new platform and domain configurations are saved to a server.
If you need to replace the System Controller board in a single SC configuration, the configuration information saved through the dumpconfig command is used to restore the platform and domain configurations to the replacement 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.
schostname:SC> dumpconfig -f ftp://hostname/path Created: ftp://hostname/path/schostname.nvci Created: ftp://hostname/path/schostname.tod |
The enablecomponent command has been deprecated starting with the 5.15.0 release and has been replaced by the setls command. It is suggested that you use the setls command even though the enablecomponent command is still available. For further informaton, see the setls command description.
Updates the firmware on the system controller and the system boards (CPU/Memory boards and I/O assemblies). The source flash image can be on a server or another board of the same type.
flashupdate [-y|-n] -f url all|systemboards|scapp|rtos
flashupdate [-y|-n] -f url board [board . . . ]
flashupdate [-y|-n] -c source_board destination_board [destination_board . . .]
-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.
ftp://userid:password@hostname//path
For details on ftp URLs, see Using FTP URLs.
Note - The hostname you enter must be the 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. |
-c specifies that the image should be copied from another board.
-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), and 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. If you have a second System Controller board installed, when you run scapp, also update scapp on the second System Controller board.
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.
Updates the firmware on the system controller, CPU/Memory boards, and I/O 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.
If you install a replacement board into the system:
1. Check that the firmware level of the replacement board is the same as the board you replaced. Incompatible boards are noted by the Failed board status 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.
Note - If you fail to check all versions for compatibility, the domains can crash or the system controller can fail to reboot normally. |
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 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.
Sun Fire 6800/4810/4800/3800 Systems Platform Administration Manual
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. |
schostname:SC> flashupdate -f ftp://host/path all |
schostname:SC> flashupdate -c sb0 sb4 |
Provides basic help information for commands.
help [command_name] | [partial_command_name]
-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.
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 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.
CODE EXAMPLE 3-17 displays help information on the addboard command.
CODE EXAMPLE 3-18 displays all commands in the platform shell beginning with show.
CODE EXAMPLE 3-19 displays all commands in the platform shell beginning with the letter a.
schostname:SC> help a addboard -- assign a board to a domain addcodlicense -- add a cod license |
Shows the command history with date and time stamps.
-h displays help for this command.
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.
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.
schostname:SC> history May 07 16:29:21 : showboards May 07 16:29:24 : showdate May 07 16:29:29 : history |
Sets the password for the platform or the domain.
-d domainID is domain a, b, c, or d.
-h displays help for this command.
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.
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.
"Security" chapter of the Sun Fire 6800/4810/4800/3800 Systems Platform Administration Manual
You will see the following prompt (CODE EXAMPLE 3-21), when a password is already set and you type the password command at either the platform shell or the domain shell.
schostname:SC> password Enter current password: Enter new password: Enter new password again: schostname:SC> |
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-22).
schostname:SC> password Enter new password: Enter new password again: schostname:SC> |
poweroff [-y|-n] all|grid#|component_name [component_name . . . ]
poweroff [-y|-n] all|component_name [component_name . . . ]
-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):
Domain shell component_name(s):
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 showboards can be powered off except for the main system controller and the ID board (ID0). 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 (use 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.
You can power off the spare SC by running the poweroff command from the main SC. When the spare SC is powered off, the hot-plug LED is illuminated.
Repeater boards do not have an Active state. 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. If 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.
poweron, setkeyswitch, showboards
To power off CPU/Memory board, sb2, from the platform shell (CODE EXAMPLE 3-23), type:
schostname:SC> poweroff sb2 |
To power off all power supplies, fan trays, and system boards (CODE EXAMPLE 3-24), type:
schostname:SC> 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. |
poweron all|grid#|component_name [component_name . . . ]
poweron all|component_name [component_name . . . ]
-h displays help for this command.
Platform shell component_name(s):
The specified board must be in the current domain.
Powers on a component or a list of components. You must specify component_name(s).
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 trays are automatically powered on when a power supply is powered on. Fan trays obtain power from the power grid(s).
If the spare system controller was powered off, you can power on the spare system controller by running the poweron command from the main system controller. The spare system controller will power on automatically when the system is turned on or when the spare system controller is inserted into a system that has power. When the spare system controller is powered on, the hot plug LED is not illuminated.
poweroff,setkeyswitch, showboards
To power on CPU/Memory board, sb2 from the platform shell (CODE EXAMPLE 3-25), type:
schostname:SC> poweron sb2 |
To power on CPU/Memory boards and I/O assemblies in the domain (CODE EXAMPLE 3-26), type:
schostname:A> poweron all |
Note - From the domain shell, you cannot power on power supplies, Repeater boards, fan trays, or power grids. To power on these components, use the platform shell. |
Reboots the system controller.
-y does not prompt for confirmation.
-n does not execute this command. Confirmation is requested.
-h displays help for this command.
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. |
To reboot the system controller (CODE EXAMPLE 3-27), type:
schostname:SC> reboot Are you sure you want to reboot the System Controller now? [no] |
With no arguments, typing reset is the same as typing reset -x.
-y answers yes to the question asked (executes the command).
-n answers no to the question asked (does not execute the command).
-h displays help for this command.
-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.
This command resumes the domain console. Resetting the domain is not allowed if the keyswitch is in the secure position, nor is it possible if the keyswitch is configured in either the off or standby position. Before you can reset the domain, change the keyswitch position to on.
By default, reset uses XIR (externally initiated reset) to reset the CPUs in the domain. The XIR 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 controlled by setting the OpenBoot PROM error-reset-recovery configuration parameter. For the definition of this domain parameter and the various settings, see TABLE 3-8 in in the setupdomain command description.
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 domain 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.
resume, setkeyswitch, setupdomain, showdomain, showkeyswitch, showresetstate, "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.
To reset the domain (from a domain shell), type the following (CODE EXAMPLE 3-28). This command uses XIR (externally initiated reset) to try to obtain diagnostic data.
schostname:A> reset |
To perform the equivalent operation as the OpenBoot PROM reset-all command (CODE EXAMPLE 3-29), type:
schostname:A> reset -a |
Restores the platform and domain configurations from a server.
-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, 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
For details on ftp URLs, see Using FTP URLs.
Note - The hostname you enter can be the host name or a host name with a fully qualified domain name, such as schostname or schostname.eng.sun.com. You cannot use a partial domain name. |
Restores the platform and domain configurations from a server, using the two data files created by the dumpconfig command, schostname.nvci and schostname.tod.The files are located at the specified URL, which must point to a directory and use the ftp protocol. The restoreconfig command prompts you for a new platform password.
Caution - The dumpconfig command should have been executed when you set up the system. It is also used in the procedure for replacing a failed system controller in single SC configurations. For general instructions on how to use dumpconfig, see "To Use dumpconfig to Save Platform and Domain Configurations" in the chapter "System Power On and Setup" in the Sun Fire 6800/4810/4800/3800 Systems Platform Administration Manual. |
This command requires that all domains be powered off with the setkeyswitch off command. The main and spare system controllers are automatically rebooted when the configuration 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 showplatform, showboards, and showdate. In each domain shell use showdomain, showboards, and showdate. |
dumpconfig, setkeyswitch, setdate, showboards, showdate, showdomain, showplatform
CODE EXAMPLE 3-30 shows an example of the restoreconfig command with the required -f option.
Exits the domain shell and resumes access to the domain console.
-h displays help for this command.
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.
schostname:A> resume |
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.
setdate [-v] [-t time zone] [mmdd]HHMM
setdate [-v] [-t time zone] mmddHHMM [[cc]yy][.SS]
setdate [-v] -t GMT<+|-> offset from GMT (TABLE 3-3)
-t time zone sets the time zone using the time zone abbreviation (TABLE 3-3). 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<+|->offset from Greenwich Mean Time--GMT (TABLE 3-3).
dd day is the number in the month.
HH is the hour number (24-hour clock).
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.
-r datehost sets the current time using rdate. The host must be a valid system name and the system must support rdate requests. The hostname you enter can be the host name or the host name with a fully qualified domain name, such as schostname or schostname.eng.sun.com. 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.
Sets the date and time for the platform and domains. This command, when invoked from the platform, will have no effect on the date and time in each domain and vice- versa. You can set up to five different times and time zones; one time and time zone 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.
After you set the date and time, you can use the SNTP server to keep the date and time synchronized. For details, see "To Set the Date and Time for the Platform" in the chapter, "System Power On and Setup" in the Sun Fire 6800/4810/4800/3800 Systems Platform Administration Manual.
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:
schostname:SC> setdate 042018152001.10 Thu Apr 20 18:15:10 PST 2001 |
To set the date from a date host:
schostname:SC> 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-3), type:
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-3), type:
To set just the time zone for Japan Standard Time using offsets from Greenwich Mean Time--GMT (TABLE 3-3) and not the date and time, type:
schostname:SC> 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-3) and not the date and time, type:
schostname:SC> setdate -t ECT Thu Apr 20 18:15:10 ECT 2001 |
Sets the default configuration values.
Caution - This is a destructive command. Use with caution and care. |
setdefaults [-y|-n] [-c] [-p platform]
-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) right-to-use (RTU) license keys stored in the COD license database. This option does not preserve the number of any instant access CPUs (headroom) enabled and COD RTU licenses reserved for domains.
-h displays help for this command.
-p platform resets the defaults for the platform only.
-y does not prompt for confirmation.
-n does not execute the command if confirmation is requested.
-h displays help for this command.
Caution - This command requires that all domains are inactive (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 does the following:
Change the state of system controller (SC) failover.
setfailover [-y|-n] on|off|force
-y does not prompt for confirmation.
-n does not execute the command if confirmation is requested.
on enables failover for systems that previously had failover disabled due to a failover or an operator request.
off disables failover. This option prevents a failover until the failover feature is re-enabled.
force causes a forced failover to the spare SC.
-h displays help for this command.
This command enables you to control automatic or manual SC failover. Be aware that if you force a failover using this command, SC failover is disabled after the manual failover occurs. For further information on SC failover, refer to the "System Controller Failover" chapter in the Sun Fire 6800/4810/4800/3800 Systems Platform Administration Manual.
setupplatform, showfailover, showlogs, showplatform, showsc
To manually failover from the main SC to the spare, type:
schostname:SC> setfailover off SC Failover: disabled |
To re-enable SC failover, type:
schostname:SC> setfailover on SC Failover: enabled and active. |
Changes the position of the virtual keyswitch to the specified value.
setkeyswitch [-y|-n] -d domainID off
setkeyswitch [-y|-n] [off|standby|on|diag|secure]
-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).
For setkeyswitch parameters and descriptions, see TABLE 3-4.
TABLE 3-5 shows the results when you change a keyswitch setting.
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 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.
To turn the virtual keyswitch on and power on the domain (CODE EXAMPLE 3-42), type:
schostname:A> setkeyswitch on |
To shut down the domain by turning the virtual keyswitch off (CODE EXAMPLE 3-43), type:
schostname:A> setkeyswitch off |
To shut down domain B from the platform shell (CODE EXAMPLE 3-44), type:
schostname:SC> setkeyswitch -d b off |
Caution - CODE EXAMPLE 3-44 does not properly shut down the Solaris operating environment in the domain before turning the keyswitch in domain B to the off position. |
Sets the component location status.
setls -s new_status -l location
-h displays help for this command.
-s new_status sets the location status of a component:
-l location specifies the component location:
Use this command to control whether components in a particular location are configured into a system. The location status of a component can be set to one of the following states:
Note - The location status is updated at the next domain reboot, board power cycle, or POST execution. For example, POST runs automatically whenever you perform a setkeyswitch on or off operation. |
When you disable the location of a component, its subcomponent locations are also disabled. For example, if you disable the location of a CPU slot, the memory locations that are controlled by that CPU are also automatically disabled.
Similarly, when you enable the location of a component, its subcomponent locations are also enabled, except when the subcomponent locations were previously disabled on an individual basis by using the setls command. The subcomponent locations cannot be enabled automatically through the parent component location. Each subcomponent location must be enabled individually by using the setls command.
Note the following about the component location status:
Component locations can be the following (see TABLE 3-6 and TABLE 3-7):
C0, C1, C2, C3, C4, C5, C6, C7--the number of cards varies with the I/O assembly |
Note - If you are disabling the port locations of an I/O assembly, leave at least one I/O controller 0 enabled in a domain, so that the domain can communicate with the system controller. |
showcomponent, the Sun Fire 6800/4810/4800/3800 Systems Platform Administration Manual
CODE EXAMPLE 3-45 enables a component located in slot sb4. This means that the CPU/Memory board in slot sb4 is considered for configuration into the system, subject to the component health status. The status change occurs at the next domain reboot, board power cycle, or POST execution.
schostname:A> setls -s enable -l sb4 |
CODE EXAMPLE 3-46 enables an I/O assembly located in port 1 of slot ib6. This means that I/O assembly 6, port 1 is considered for configuration into the system, subject to the component health status. The status change occurs at the next domain reboot, board power cycle, or POST execution.
schostname:A> setls -s enable -l ib6/p1 |
CODE EXAMPLE 3-47 disables a component located in slot sb0 and CPU port 3.This means that the CPU/Memory board in slot sb0 is deconfigured from the system at the next domain reboot, board power cycle, or POST execution. Also, any memory banks on this CPU port are unreachable and are implicitly disabled.
schostname:A> setls -s disable -l sb0/p3 |
CODE EXAMPLE 3-48 disables a component located in slot sb4 and deconfigures the CPU/Memory board in slot sb4 at the next domain reboot, board power cycle, or POST execution.
schostname:A> setls -s disable -l sb4 |
-h displays help for this command.
-p part configures the specified information and has the following options:
TABLE 3-8 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.
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.
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.
Note - The default value displayed by the software for the OBP.* parameters is OBP default. |
If you enter an invalid value, the system controller displays "invalid entry" and prompts you to enter a proper value (TABLE 3-8). 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-8 lists the setupdomain parameter values.
Configures the platform specific variables.
-h displays help for this command.
-p part configures the specified part and has the following options:
- clears the boards from the ACL
Note - The HostID/MAC Address Swap parameter is displayed only when you specify the hostid option. For details, see the "Description" section of this command. |
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-9.
The HostID/MAC Address Swap parameter is displayed only when you specify the -p hostid option with the setupplatform command. This parameter enables you to swap the HostID and MAC address of one domain with another. For example, if you are running host-licensed software associated with a particular domain HostID and MAC address, but you need to run the host-licensed software on another domain, you can swap the domain HostID and MAC address with that of an available domain. You can then run the host-licensed software on the available domain without encountering license restrictions tied to the original domain HostID/MAC address. For details on using the HostID/MAC address swap, refer to the Sun Fire 6800/4810/4800/3800 Systems Platform Administration Manual.
TABLE 3-10 describes the prompts displayed when you specify the
setupplatform -p hostid command. For an example of the output displayed, see CODE EXAMPLE 3-51:
password, setdate, setupdomain, showdate, showdomain, showplatform, and the Sun Fire 6800/4810/4800/3800 Systems Platform Administration Manual, which provides instructions on setting up the platform using setupplatform.
Displays the assignment information and status for all of components in the system.
showboards [-ev] [-y|-n][ -d domainID] [-p part]
showboards [-aev] [-y|-n] [-p part]
-a include available boards (domain only).
-e includes empty slots in the output.
-d domainID specify a domain to display (platform only).
-p part shows only a specific part and can be:
-y answers yes to all questions.
-n answers no to all questions.
-h displays help for this command.
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.
The showboards command with the -v option displays the verbose option.
The showboards command with the -p version option displays firmware version and compatibility information.
Slot designator. The Nx in the slot descriptor is the node number. |
|
Component description, such as System Controller, CPU Board, COD CPU Board, Fan Tray, and so on. |
|
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 system controllers, possible values are: Main or Spare. For more information on board states, see Board States for CPU/Memory Boards and I/O Assemblies. |
|
Current board status. For more information on board status, see Board Test Status. |
|
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. |
|
Software module: ScApp, iPOST, POST, or OBP. The value Ver indicates that all software modules have been joined to form a particular image. |
|
Indicates whether the given component is compatible with the scapp version listed in the Version column. Possible values are Yes, No, and - (dash). The dash - indicates that firmware compatibility does not apply to the given component. For system controllers, the value Reference indicates that the firmware version listed in the Version column is the baseline used to determine firmware compatibility. |
|
The number that identifies the software modules for the firmware. This number is used to determine the compatibility with the firmware. |
|
The month, day, and year that the flash PROM image was created by Sun Microsystems. |
|
The time of day (hour:minutes) that the flash PROM image was created by Sun Microsystems. |
|
A number that identifies the internal build. Used by Sun Microsystems only. |
|
The firmware version compatible with the component, except for System Controllers and boards that are not powered on (No board power). |
|
Describes the slot. The card type cannot be determined by the system controller. The card is determined by the Solaris operating environment. |
|
Displays the current Capacity on Demand (COD) right-to-use (RTU) licenses stored in the COD license database.
-h displays help for this command.
-r displays the license information in the raw license key format, as stored in the COD license database.
-v verbose mode. Displays both the formatted license information and raw license key format.
TABLE 3-12 describes the default COD information displayed by the showcodlicense command.
addcodlicense, deletecodlicense, showcodusage
To show formatted COD RTU license key data, type:
To show COD RTU license keys, type:
schostname:SC> showcodlicense -r 01:80d8a9ed:45135285:0201000000:8:00000000:J0WKZ8vpZ5kOgSJ7e8ZasA |
To show COD RTU license key data in both formatted and raw format, type:
Displays the current usage statistics for Capacity on Demand (COD) resources.
showcodusage [-v] [-p resource|domains|all] ...
-h displays help for this command.
-p resource displays COD usage information according to resource type.
-p domains displays COD usage information according to domain type.
-p all displays COD usage information both by resource type and by domain.
This command shows current information on the COD RTU licenses in use. By default, the command displays a summary of COD RTU licenses used and installed, along with the current state of each resource.
To show information by resource, type:
TABLE 3-13 describes the resource information displayed.
To show information by domain, type:
TABLE 3-14 describes the domain information displayed.
The COD resource (processor) for each domain. An unused processor is a COD CPU that has not yet been assigned to a domain. |
|
To show information by both resource type and domain, type:
Shows the state of a component.
showcomponent [-v] [component] ...
showcomponent [-v] [-d domainID] ...
showcomponent [-v] [component] ...
-h displays help for this command. Includes component_name syntax.
boardname for CPU/Memory boards is SB0 - 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).
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 disabled by the setls commands or components that have been marked as failed when testing (running the testboard command). This command also does the following:
setls, and the Sun Fire 6800/4810/4800/3800 Systems Platform Administration Manual.
CODE EXAMPLE 3-62 shows sample output for the showcomponent sb4 command. The abbreviations for the Component field are:
Logical memory bank, where x is 0 - 3. There are two DIMMs per logical memory bank |
Definitions of the headings in CODE EXAMPLE 3-62 and CODE EXAMPLE 3-63 follow:
CODE EXAMPLE 3-63 shows sample output for the showcomponent ib6 command. The abbreviations for the Component field are:
-h displays help for this command.
-t lists available time zones.
-d domainID is a, b, c, or d. Shows the date for the domain from the platform.
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.
schostname:SC> showdate Fri Mar 07 18:00:56 PST 2003 |
Displays the configuration and status of the domain.
showdomain [-v] [-p part]. . .
-p part is a parameter for the information to display:
-h displays help for this command.
Displays the configuration and status of the domain. Some of the information is not configurable, or is configurable only through the platform, such as the access control list (ACL), SNMP enabled, and COD parameters. This command without any arguments displays all the parameter values configured by the setupdomain command.
setupdomain, showdate, setupplatform, showplatform
To display parameters assigned by the setupdomain command, type showdomain (CODE EXAMPLE 3-65).
To display the verbose output of parameters assigned by the setupdomain command, type showdomain -v (CODE EXAMPLE 3-66).
To display boot parameter information (CODE EXAMPLE 3-67), type:
Displays the current environmental status, temperatures, currents, voltages, and fan status, for the system (platform shell) or the current domain (domain shell).
showenvironment [-ltvuw] [-d domainID] [-p part]
showenvironment [-ltvuw] board_name
showenvironment [-ltvuw] [-p part]
showenvironment [-ltvuw] board_name [board_name . . . ]
board_name is the name of the board. Displays information for this board. You can type multiple board names.
-d domainID is a, b, c, or d. Displays information for boards assigned to that domain.
-h displays help for this command.
-l 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.
-p part shows a specific part (TABLE 3-15):
-u updates data now. Polls all sensors for new values.
-v is verbose mode. This is the equivalent of the options -l and -w.
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.
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-16 describes the showenvironment output headers and values.
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-68.
Shows the contents of the error buffer.
-h displays help for the command.
This command captures error message information detected by the system hardware error registers and stores them in an error buffer. If you set your domains to reboot automatically upon error, the output from the showerrorbuffer command shows error messages that otherwise might be lost when your domains are rebooted. You and your service provider can use the command to obtain information for troubleshooting purposes.
CODE EXAMPLE 3-69 shows the error resulting from an interconnect test.
CODE EXAMPLE 3-70 shows a hardware error.
Displays system controller (SC) and clock failover status.
-v is verbose mode. Displays all available command information, which includes both SC and clock failover status. If the failover status is considered as degraded (explained in the Description section), this option will display any boards that can be controlled by the main SC but not the spare.
-h displays help for the command.
Enables you to monitor the state of the SC and clock failover. The SC failover state can be one of the following:
The clock failover state can be one of the following:
setfailover, setupplatform, showsc, showlogs, showplatform
schostname:SC> showfailover SC Failover: enabled and active. |
schostname:SC> showfailover SC Failover: disabled |
schostname:SC> showfailover -v SC:SSC1 Main System Controller SC Failover: enabled and active. Clock failover enabled. |
schostname:SC> showfailover SC Failover: enabled but not active. |
Displays the keyswitch setting.
showkeyswitch [-v] -d domainID
-h displays help for this command.
-d domainID (platform shell only) is a, b, c, or d.
setkeyswitch, showdomain, showplatform
Displays the keyswitch setting.
schostname:A> showkeyswitch keyswitch is: on |
schostname:A> showkeyswitch keyswitch is: off |
schostname:A> showkeyswitch keyswitch is: standby |
Displays the system controller logged events stored in the system controller message buffer.
-h displays help for this command.
-d domainID (platform shell only) specifies a domain (a, b, c, or d).
Displays the messages that are stored in the message 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 each system controller in 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 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.
setupdomain, setupplatform, showdomain, showplatform
CODE EXAMPLE 3-78 displays the output of the showlogs command, run at the platform shell after rebooting the system.
Displays the configuration and information for the platform and domain status.
showplatform [-v] [-d domainID] [-p part]
-h displays help for this command.
-d domainID specifies a domain to show (a, b, c, or d).
-p part 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.
-p part displays information on a specific part. Use the options to -p part when you
do not specify a domain with the -d option.
Note - The HostID/MAC Adress Swap parameter information is displayed only when you specify the hostid option. See the "Description" section of this command for details. |
This command displays all configuration variables for this platform, including:
CODE EXAMPLE 3-80 shows the showplatform -v command output.
In CODE EXAMPLE 3-79 and CODE EXAMPLE 3-80, the Domain Status header has the following possible states:
For a description of these states, see Domain Status.
CODE EXAMPLE 3-81 shows showplatform -p hostid command output.
CODE EXAMPLE 3-81 shows showplatform -p hostid command output after the HostID/MAC addresses have been restored to their original domains.
Shows that state of CPUs after a reset or a RED MODE trap.
showresetstate [-w | -s | -v] [-f url]
-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:
-f specifies a URL, which must use the ftp protocol.
ftp://userid:password@hostname//path
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:
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 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.
Shows the system controller and clock failover status, version, and uptime.
-h displays help for this command.
Shows the system controller version and uptime.
RTOS is the Real Time Operating System for the system controller and ScApp is the system controller application.
-h displays help for this command.
board_name is sb0-sb5 for CPU/Memory boards.
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.
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.
To test CPU/Memory board, sb0 in the domain A shell (CODE EXAMPLE 3-84), type:
Copyright © 2003, Sun Microsystems, Inc. All rights reserved.