Sun Microsystems, Inc.
   www.sun.com docs.sun.com | | |  
   
A   B   C   D   E   F   G   H   I   J   K   L   M   N   O   P   Q   R   S   T   U   V   W   X   Y   Z
    
 
System Administrationshowplatform(1m)


NAME

 showplatform - display the board available component list and domain state for each of the domains

SYNOPSIS

 showplatform [-d domain_id|domain_tag] [-p domains|available|ethernet ] [-v ]
 showplatform -h

DESCRIPTION

 

Show the available component list, domain state and Ethernet address for domains. If a domain_id|domain_tag is specified, only the information for that domain is displayed. If no domain and -p are specified, the available component list, domain states and ethernet addresses for all domains for which you have privileges are displayed.

OPTIONS

 

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
Domain 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.
-p
Display specific reports.

Valid arguments for -p are:

domains -- List output is grouped by domain state.

available -- List output is grouped by domain available component list.

ethernet -- List output is grouped by domain Ethernet addresses.

-v
Verbose. Displays all available command information.

EXTENDED DESCRIPTION

 

The domain status is one of the following:

  • Unknown -- The domain state could not be determined or for Ethernet addresses, it indicates the domain idprom image file does not exist. You need to contact your Sun service representative.
  • Powered Off -- The domain is powered off.
  • Keyswitch Standby -- The keyswitch for the domain is in STANDBY position.
  • Running Domain POST -- The domain power-on self-test is running.
  • Loading OBP -- The OpenBoot PROM for the domain is being loaded.
  • Booting OBP -- The OpenBoot PROM for the domain is booting.
  • Running OBP -- The OpenBoot PROM for the domain is running.
  • In OBP Callback -- The domain has been halted and has returned to the OpenBoot PROM.
  • Loading Solaris -- The OpenBoot PROM is loading the Solaris software.
  • Booting Solaris -- The domain is booting the Solaris software.
  • Domain Exited OBP -- The domain OpenBoot PROM exited.
  • OBP Failed -- The domain OpenBoot PROM failed.
  • OBP in sync Callback to OS -- The OpenBoot PROM is in sync callback to the Solaris software.
  • Exited OBP -- The OpenBoot PROM has exited.
  • In OBP Error Reset -- The domain is in OpenBoot PROM due to an error reset condition.
  • Solaris Halted, in OBP -- Solaris software is halted and the domain is in OpenBoot PROM.
  • OBP Debugging -- The OpenBoot PROM is being used as a debugger.
  • Environmental Domain Halt -- The domain was shut down due to an environmental emergency.
  • Booting Solaris Failed -- OpenBoot PROM running, boot attempt failed.
  • Loading Solaris Failed-- OpenBoot PROM running, loading attempt failed.
  • Running Solaris -- Solaris software is running on the domain.
  • Solaris Quiesce In-progress -- A Solaris software quiesce is in progress.
  • Solaris Quiesced -- Solaris software has quiesced.
  • Solaris Resume In-progress -- A Solaris software resume is in progress.
  • Solaris Panic -- Solaris software has panicked, panic flow has started.
  • Solaris Panic Debug -- Solaris software panicked, and is entering debugger mode.
  • Solaris Panic Continue -- Exited debugger mode and continuing panic flow.
  • Solaris Panic Dump -- Panic dump has started.
  • Solaris Halt -- Solaris software is halted.
  • Solaris Panic Exit -- Solaris software exited as a result of a panic.
  • Environmental Emergency -- An environmental emergency has been detected.
  • Debugging Solaris -- Debugging Solaris software; this is not a hung condition.
  • Solaris Exited -- Solaris software has exited.
  • Domain Down -- The domain is down and setkeyswitch is in the ON, DIAG or SECURE position.
  • In Recovery -- The domain is in the midst of an automatic system recovery.

Group Privileges Required

 

If you have platform administrator, operator, or service privileges, showplatform displays available component list and board state information on all domains. Otherwise, only information for domains, for which you have domain administrator or configurator privileges, is displayed.

Refer to Chapter 2 in the System Management Services (SMS) 1.2 Administrator Guide for the Sun Fire 15K/12K Systems for more information.

EXAMPLES

 Example 1. Show the Available Component List and Domain State Information for All Domains on a Sun Fire 15K System.
 

An UNKNOWN state for an ethernet address as shown in the following example indicates a missing idprom image file for the domain. Contact your Sun service representative.

 
sc0:sms-user:>  showplatform

Available Component List for Domains:
=====================================
Available for domain newA:
          SB0 SB1 SB2 SB7
          IO1 IO3 IO6
Available for domain engB:
          No System boards
          No IO boards
Available  for domain domainC:
          No System boards
          IO0 IO1 IO2 IO3 IO4
Available  for domain eng1:
          No System boards
          No IO boards
Available  for domain E:
          No System boards
          No IO boards
Available  for domain domainF:
          No System boards
          No IO boards
Available  for domain dmnG:
          No System boards
          No IO boards
Available  for domain domain H:
          No System boards
          No IO boards
Available  for domain I:
          No System boards
          No IO boards
Available  for domain dmnJ:
          No System boards
          No IO boards
Available  for domain K:
          No System boards
          No IO boards
Available  for domain L:
          No System boards
          No IO boards
Available  for domain M:
          No System boards
          No IO boards
Available  for domain N:
          No System boards
          No IO boards
Available  for domain O:
          No System boards
          No IO boards
Available  for domain P:
          No System boards
          No IO boards
Available  for domain Q:
          No System boards
          No IO boards
Available  for domain dmnR:
          No System boards
          No IO boards

Domain Configurations:
======================
DomainID    Domain Tag     Solaris Nodename     Domain Status
A           newA           -                    Powered Off
B           engB           sun15-b              Keyswitch Standby
C           domainC        sun15-c              Running OBP
D           -              sun15-d              Running Solaris
E           eng1           sun15-e              Running Solaris
F           domainF        sun15-f              Running Solaris
G           dmnG           sun15-g              Running Solaris
H           -              sun15-g              Solaris Quiesced
I           -              -                    Powered Off
J           dmnJ           -                    Powered Off
K           -              sun15-k              Booting Solaris
L           -              -                    Powered Off
M           -              -                    Powered Off
N           -              sun15-n              Keyswitch Standby
O           -              -                    Powered Off
P           -              sun15-p              Running Solaris
Q           -              sun15-q              Running Solaris
R           dnmR           sun15-r              Running Solaris

Domain Ethernet Addresses:
=============================
Domain ID   Domain Tag        Ethernet Address
A           newA              8:0:20:b8:79:e4
B           engB              8:0:20:b4:30:8c
C           domainC           8:0:20:b7:30:b0
D               -             8:0:20:b8:2d:b0
E           eng1              8:0:20:f1:b7:0
F           domainF           8:0:20:be:f8:a4
G           dmnG              8:0:20:b8:29:c8
H               -             8:0:20:f3:5f:14
I               -             8:0:20:be:f5:d0
J           dmnJ              UNKNOWN
K               -             8:0:20:f1:ae:88
L               -             8:0:20:b7:5d:30
M               -             8:0:20:f1:b8:8
N               -             8:0:20:f3:5f:74
O               -             8:0:20:f1:b8:8
P               -             8:0:20:b8:58:64
Q               -             8:0:20:f1:b7:ec
R           dmnR              8:0:20:f1:b7:10
Example 2. Show Available Component List and Domain State for Domain engB
 
 
sc0:sms-user:>  showplatform -d engB 
Available Component List for Domains:

=====================================
Available  for domain engB:
          SB4 SB5 SB6
          IO4 IO5

Domain Configurations:
======================
DomainID  Domain Tag    Solaris Nodename    Domain Status
B          engB          sun15-b            Keyswitch Standby

Domain Ethernet Addresses:
=============================
Domain ID   Domain Tag        Ethernet Address
B           engB              8:0:20:b4:30:8c
Example 3. Showplatform for Domain Administrators
 

The following example shows domain available component list and state information for all domains for which you have domain administrator or configurator privileges, in this case, domains engB, C, E and dmnJ.

 
sc0:sms-user:> showplatform  
Available Component List for Domains:



====================================
Available  for domain engB:
          SB1 SB2 SB3 SB4 SB5 SB6
          IO1 IO2 IO3 IO4 IO5 IO6 IO7
Available  for domain C:
          SB1 SB2 SB3 SB4 SB5 SB6
          IO1 IO2 IO3 IO4 IO5 IO6 IO7
Available  for domain E:

          SB1 SB2 SB3 SB4 SB5 SB6
          IO1 IO2 IO3 IO4 IO5 IO6 IO7

Domain Configurations:
======================
DomainID   Domain Tag    Solaris Nodename     Domain Status
B          engB           sun15-b             Keyswitch Standby
C          domainC        sun15-c             Running OBP
E          eng1           sun15-e             Running Solaris

Domain Ethernet Addresses:
=============================
Domain ID   Domain Tag        Ethernet Address
B           engB              8:0:20:b4:30:8c
C           domainC           8:0:20:b7:30:b0
E           eng1              8:0:20:f1:b7:0
Example 4. Show Available Component List for Domain engB
 
 
sc0:sms-user:>  showplatform -d engB -p available 
Available Component List for Domains:
====================================
Available  for domain engB:
    SB4 SB5 SB6
    IO4 IO5
Example 5. Show Domain Status for Domain engB
 
 
sc0:sms-user:>  showplatform -d engB -p domains 
Domain Configurations:
======================
DomainID   Domain Tag    Solaris Nodename     Domain Status
B          engB           sun15-b             Keyswitch Standby

EXIT STATUS

 

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 error occurred communicating with the platform configuration daemon (pcd(1M)).
6
An error occurred communicating with the hardware access daemon (hwad(1M)).
7
An error occurred communicating with the task management daemon (tmd(1M)).
8
An internal error occurred.

ATTRIBUTES

 

See attributes(5) for descriptions of the following attributes:

Attribute TypesAttribute Values
AvailabilitySUNWSMSop

SEE ALSO

 

addtag(1m), hwad(1m), pcd(1m), setupplatform(1m), tmd(1m)


SMS 1.2Go To TopLast Changed 22 April 2002

 
      
      
Copyright 2002 Sun Microsystems, Inc., 4150 Network Circle, Santa Clara, CA 95054 USA. All rights reserved.