| |
| System Administration | showboards(1m) |
| | showboards - show the assignment information
and status of the boards |
SYNOPSIS
| | showboards [-d domain_id|domain_tag] [-v ] |
| |
showboards(1M) displays board assignments. If domain_id| domain_tag is specified, this command displays which boards are assigned or available to the given domain. If the -v option is used, showboards displays all components, including domain configuration units (DCUs) such as cpus, dpus, iobds, csbs and exbs, as well as the system controller (SC) are not DCUs.
|
| |
The following options are supported.
- -d domain_id
- ID for a domain. Valid domain_ids are 'A'...'R' and are case insensitive.
- -d domain_tag
- Name assigned to a domain using addtag(1M).
- -h
- Help. Displays usage descriptions. Note – Use alone. Any option specified in addition to -h is ignored.
- -v
- Verbose. Displays all components including DCUs.
|
| |
Group Privileges Required
| |
You must have platform administrator, platform operator, platform service privileges or domain administrator, or domain configurator privileges for the specified domain to run this command.
Refer to Chapter 2 in the System Management Services (SMS) 1.2 Administrator Guide for the Sun Fire 15K/12K Systems for more information.
Platform administrator privileges:
- If no options are specified, showboards displays all components including those DCUs that are assigned or available.
- If domain_id|domain_tag is specified, showboards displays information on DCUs that are assigned and available to that domain. DCUs assigned to other domains are not displayed.
- If the -v option is provided, showboards displays information on all assigned or available DCUs. In addition, showboards displays information on all other components.
- If domain_id|domain_tag and the -a option are specified, showboards displays information on DCUs that are assigned or available to that domain. In addition, showboards displays information on all other components. DCUs assigned to other domains are not displayed.
Domain administrator/configurator privileges:
- If no options are specified, showboards displays all boards for all domains for which you have privileges, including those DCUs that are assigned or available.
- If domain_id|domain_tag is specified, showboards displays information on DCUs that are assigned or available to that domain. DCUs assigned to other domains are not displayed. Available DCUs are those boards which are in the domain's available component list See setupplatform(1M) and showplatform(1M). You must have domain administrator or configurator privileges for the specified domain.
- The -v option is not available to this user.
|
States in the Pwr Field
| |
The Pwr field contains one of three measurements:
| On | = Full voltage detected |
| Off | = No voltage detected |
| Min | = Some voltage detected |
| Unk | = Unknown. Unable to determine board power on state |
| -- | = The slot is empty so power state is not applicable |
Min does not imply that the board may be used at this point only that some power was detected on the board. It should not be used until it has been powered on. Conversely, it should not be removed from the system before being powered off.
The Board Status field contains one of four values:
| Active | = The board is assigned to a domain and has passed POST |
| Assigned | = The board is assigned to a domain |
| Available | = The board is available to be assigned to a domain |
| -- | = Domain assignment or activity is not applicable for this board |
The Test Status field contains one of six values:
| Passed | = The board passed POST |
| Degraded | = The board is in a degraded mode |
| Failed | = The board failed POST |
| iPOST | = The board is in POST |
| Unknown | = The board has not been tested |
| -- | = The test status for this board is unavailable |
The Domain field contains one of four values:
| domain_id | = ID for a domain |
| domain_tag | = Name assigned to a domain using addtag(1M) |
| Isolated | = The board is not assigned to any domain |
| -- | = Domain assignment is not applicable for this board |
|
|
| | Example 1. Showboards for Platform Administrators on a Sun Fire 15K System.
| |
| |
sc0:sms-user:> showboards
Location Pwr Type of Board Board Status Test Status Domain
---- --- ------------- ------------ ----------- ------
SB0 On CPU Active Passed domainC
SB1 On CPU Active Passed A
SB2 On CPU Active Passed A
SB3 On CPU Active Passed engB
SB4 On CPU Active Passed engB
SB5 On CPU Active Passed engB
SB6 - Empty Slot Available - Isolated
SB7 On CPU Active Passed domainC
SB8 Off CPU Available Unknown Isolated
SB9 On CPU Active Passed dmnJ
SB10 Off CPU Available Unknown Isolated
SB11 Off CPU Available Unknown Isolated
SB12 - Empty Slot Available - Isolated
SB13 - Empty Slot Available - Isolated
SB14 Off CPU Assigned Failed domainC
SB15 On CPU Active Passed P
SB16 On CPU Active Passed Q
SB17 - Empty Slot Assigned - dmnR
IO0 - Empty Slot Available - Isolated
IO1 On HPCI Active Passed A
IO2 On HPCI Active Passed engB
IO3 On HPCI Active Passed domainC
IO4 On HPCI Available Degraded domainC
IO5 Off HPCI Available Unknown Isolated
IO6 - Empty Slot Available - Isolated
IO7 On HPCI Active Passed dmnJ
IO8 On WPCI Active Passed Q
IO9 On HPCI Active Passed dmnJ
IO10 Off HPCI Assigned Unknown engB
IO11 Off HPCI Assigned Failed engB
IO12 - Empty Slot Available - Isolated
IO13 - Empty Slot Available - Isolated
IO14 Off HPCI Available Unknown Isolated
IO15 On HPCI Active Passed P
IO16 On HPCI Active Passed Q
IO17 - Empty Slot Assigned - dmnR
|
|
The following example illustrates showboards output if you have platform administrator privileges and specify a domain on a Sun Fire 15K System. The output does not include boards which are assigned to other domains.
Example 2. Showboards for Platform Administrators for Domain B
| |
| |
sc0:sms-user:> showboards -d b
Location Pwr Type of Board Board Status Test Status Domain
---- --- ------------- ------------ ----------- ------
SB3 On CPU Active Passed engB
SB4 On CPU Active Passed engB
SB5 On CPU Active Passed engB
SB6 - Empty Slot Available - Isolated
SB8 Off CPU Available Unknown Isolated
SB10 Off CPU Available Unknown Isolated
SB11 Off CPU Available Unknown Isolated
SB12 - Empty Slot Available - Isolated
SB13 - Empty Slot Available - Isolated
IO0 - Empty Slot Available - Isolated
IO2 On HPCI Active Passed engB
IO5 Off HPCI Available Unknown Isolated
IO6 - Empty Slot Available - Isolated
IO10 Off HPCI Assigned Unknown engB
IO11 Off HPCI Assigned Failed engB
IO12 - Empty Slot Available - Isolated
IO13 - Empty Slot Available - Isolated
IO14 Off HPCI Available Unknown Isolated
|
|
The following example illustrates showboards output if you have platform administrator privileges and use the -v option on a Sun Fire 15K System. The command shows all components.
Example 3. Showboards for Platform Administrators Using the v Option
| |
| |
sc0:sms-user:> showboards -v
Location Pwr Type of Board Board Status Test Status Domain
---- --- ------------- ------------ ----------- ------
SC0 On SC Slave - -
SC1 On SC Master - -
PS0 On PS - - -
PS1 On PS - - -
PS2 On PS - - -
PS3 - Empty Slot - - -
PS4 Off PS - - -
PS5 On PS - - -
FT0 On FT - - -
FT1 On FT - - -
FT2 On FT - - -
FT3 On FT - - -
FT4 On FT - - -
FT5 - Empty Slot - - -
FT6 Off FT - - -
FT7 On FT - - -
CS0 On CSB - - -
CS1 On CSB - - -
EX0 On EXB - - -
EX1 On EXB - - -
EX2 On EXB - - -
EX3 On EXB - - -
EX4 On EXB - - -
EX5 On EXB - - -
EX6 - Empty Slot - - -
EX7 On EXB - - -
EX8 On EXB - - -
EX9 On EXB - - -
EX10 On EXB - - -
EX11 On EXB - - -
EX12 - Empty Slot - - -
EX13 - Empty Slot - - -
EX14 Off EXB - - -
EX15 On EXB - - -
EX16 On EXB - - -
EX17 On EXB - - -
IO1/C3V0 On C3V - - A
IO1/C5V0 On C5V - - A
IO1/C3V1 On C3V - - A
IO1/C5V1 On C5V - - A
IO2/C3V0 On C3V - - engB
IO2/C5V0 On C5V - - engB
IO2/C3V1 On C3V - - engB
IO2/C5V1 On C5V - - engB
IO3/C3V0 On C3V - - domainC
IO3/C5V0 On C5V - - domainC
IO3/C3V1 - Empty Slot - - domainC
IO3/C5V1 - Empty Slot - - domainC
IO4/C3V0 On C3V - - domainC
IO4/C5V0 On C5V - - domainC
IO4/C3V1 On C3V - - domainC
IO4/C5V1 On C5V - - domainC
IO5/C3V0 On C3V - - Isolated
IO5/C5V0 On C5V - - Isolated
IO5/C3V1 On C3V - - Isolated
IO5/C5V1 On C5V - - Isolated
IO7/C3V0 On C3V - - dmnJ
IO7/C5V0 On C5V - - dmnJ
IO7/C3V1 On C3V - - dmnJ
IO7/C5V1 On C5V - - dmnJ
IO8/C3V0 On C3V - - A
IO8/C5V0 On C5V - - A
IO8/C3V1 On C3V - - A
IO8/C5V1 On C5V - - A
IO9/C3V0 On C3V - - dmnJ
IO9/C5V0 On C5V - - dmnJ
IO9/C3V1 On C3V - - dmnJ
IO9/C5V1 On C5V - - dmnJ
IO10/C3V0 On C3V - - engB
IO10/C5V0 On C5V - - engB
IO10/C3V1 On C3V - - engB
IO10/C5V1 On C5V - - engB
IO11/C3V0 On C3V - - engB
IO11/C5V0 On C5V - - engB
IO11/C3V1 On C3V - - engB
IO11/C5V1 On C5V - - engB
IO14/C3V0 On C3V - - Isolated
IO14/C5V0 On C5V - - Isolated
IO14/C3V1 On C3V - - Isolated
IO14/C5V1 On C5V - - Isolated
IO15/C3V0 On C3V - - P
IO15/C5V0 On C5V - - P
IO15/C3V1 On C3V - - P
IO15/C5V1 On C5V - - P
IO16/C3V0 On C3V - - Q
IO16/C5V0 On C5V - - Q
IO16/C3V1 On C3V - - Q
IO16/C5V1 On C5V - - Q
SB0 On CPU Active Passed domainC
SB1 On CPU Active Passed A
SB2 On CPU Active Passed A
SB3 On CPU Active Passed engB
SB4 On CPU Active Passed engB
SB5 On CPU Active Passed engB
SB6 - Empty Slot Available - Isolated
SB7 On CPU Active Passed domainC
SB8 Off CPU Available Unknown Isolated
SB9 On CPU Active Passed dmnJ
SB10 Off CPU Available Unknown Isolated
SB11 Off CPU Available Unknown Isolated
SB12 - Empty Slot Available - Isolated
SB13 - Empty Slot Available - Isolated
SB14 Off CPU Assigned Failed domainC
SB15 On CPU Active Passed P
SB16 On CPU Active Passed Q
SB17 - Empty Slot Assigned - dmnR
IO0 - Empty Slot Available - Isolated
IO1 On HPCI Active Passed A
IO2 On HPCI Active Passed engB
IO3 On HPCI Active Passed domainC
IO4 On HPCI Available Degraded domainC
IO5 Off HPCI Available Unknown Isolated
IO6 - Empty Slot Available - Isolated
IO7 On HPCI Active Passed dmnJ
IO8 Off HPCI Assigned Unknown A
IO9 On HPCI Assigned iPOST dmnJ
IO10 Off HPCI Assigned Unknown engB
IO11 Off HPCI Assigned Failed engB
IO12 - Empty Slot Available - Isolated
IO13 - Empty Slot Available - Isolated
IO14 Off HPCI Available Unknown Isolated
IO15 On HPCI Active Passed P
IO16 On HPCI Active Passed Q
IO17 - Empty Slot Assigned - dmnR
|
|
The following example illustrates showboards output if you have domain privileges for domains B, J, and R on a Sun Fire 15K System. showboards displays information for those boards which are assigned or available to domains B, J, and R. Boards which are assigned to other domains or do not appear in the available component list for domains B, J, or R are not displayed.
Example 4. Showboards for Domain Admins With Privileges on Domains B, J, and R
| |
| |
sc0:sms-user:> showboards
Location Pwr Type of Board Board Status Test Status Domain
---- --- ------------- ------------ ----------- ------
SB3 On CPU Active Passed engB
SB4 On CPU Active Passed engB
SB5 On CPU Active Passed engB
SB6 - Empty Slot Available - Isolated
SB8 Off CPU Available Unknown Isolated
SB9 On CPU Active Passed dmnJ
SB10 Off CPU Available Unknown Isolated
SB11 Off CPU Available Unknown Isolated
SB12 - Empty Slot Available - Isolated
SB13 - Empty Slot Available - Isolated
SB17 - Empty Slot Assigned - dmnR
IO0 - Empty Slot Available - Isolated
IO2 On HPCI Active Passed engB
IO5 Off HPCI Available Unknown Isolated
IO6 - Empty Slot Available - Isolated
IO7 On HPCI Active Passed dmnJ
IO9 On HPCI Assigned iPOST dmnJ
IO10 Off HPCI Assigned Unknown engB
IO11 Off HPCI Assigned Failed engB
IO17 - Empty Slot Assigned - dmnR
|
|
In the following example, showboards displays output if you have domain privileges on domains B, J and R on a Sun Fire 15K System. The command shows board information for those DCUs which are assigned or available to the specified domain. DCUs which are assigned to other domains or do not appear in the specified domain's available component list are not displayed.
Example 5. Showboards for Domain Administrators for Domain B
| |
| |
sc0:sms-user:> showboards -d b
Location Pwr Type of Board Board Status Test Status Domain
---- --- ------------- ------------ ----------- ------
SB3 On CPU Active Passed engB
SB4 On CPU Active Passed engB
SB5 On CPU Active Passed engB
SB6 - Empty Slot Available - Isolated
SB8 Off CPU Available Unknown Isolated
SB10 Off CPU Available Unknown Isolated
SB11 Off CPU Available Unknown Isolated
SB12 - Empty Slot Available - Isolated
SB13 - Empty Slot Available - Isolated
IO0 - Empty Slot Available - Isolated
IO2 On HPCI Active Passed engB
IO5 Off HPCI Available Unknown Isolated
IO6 - Empty Slot Available - Isolated
IO10 Off HPCI Assigned Unknown engB
IO11 Off HPCI Assigned Failed engB
|
|
|
| |
The following exit values are returned:
-
0
- Successful completion
-
1
- An invalid domain was specified.
-
2
- An invalid command-line option was specified.
-
3
- An incorrect number of domains was specified.
-
4
- The user does not have valid privileges.
-
5
- An internal error occurred.
-
6
- An error occurred getting board information.
|
| |
See attributes(5) for descriptions of the following attributes:
| Attribute Types | Attribute Values |
| Availability | SUNWSMSop |
|
| |
addtag(1m), setupplatform(1m), showplatform(1m)
|
| |
