Sun Microsystems, Inc.  Sun System Handbook - ISO 3.4 June 2011 Internal/Partner Edition
   Home | Current Systems | Former STK Products | EOL Systems | Components | General Info | Search | Feedback

Asset ID: 1-71-1011930.1
Update Date:2011-02-21
Keywords:

Solution Type  Technical Instruction Sure

Solution  1011930.1 :   Sun Fire[TM] 3800, 4800, 4810, 6800, E4900, and E6900 System Controller Application (ScApp) How To's.  


Related Items
  • Sun Fire E6900 Server
  •  
  • Sun Fire 6800 Server
  •  
  • Sun Fire 3800 Server
  •  
  • Sun Netra 1280 Server
  •  
  • Sun Fire E4900 Server
  •  
  • Sun Fire 4800 Server
  •  
  • Sun Fire E2900 Server
  •  
  • Sun Fire V1280 Server
  •  
  • Sun Fire 4810 Server
  •  
  • Sun Netra 1290 Server
  •  
Related Categories
  • GCS>Sun Microsystems>Servers>Midrange V and Netra Servers
  •  
  • GCS>Sun Microsystems>Servers>Entry-Level Servers
  •  
  • GCS>Sun Microsystems>Servers>Midrange Servers
  •  

PreviouslyPublishedAs
216328


Applies to:

Sun Fire 6800 Server
Sun Fire E2900 Server
Sun Netra 1280 Server
Sun Netra 1290 Server
Sun Fire V1280 Server
All Platforms

Goal

Description
This document attempts to provide syntax and examples for common commands.

If more information is required please see the Sun Fire Midrange System Controller Command Reference Manual, for ScApp 5.20.x.

Commands used from the System Controller Application (ScApp) and their outputs

- How to access the ScApp shell?
- How to access a Domain Console?
- How to access an SC from a secure SSH shell?
- How to use commands?
- How to get help?
- How to get the ScApp version and SC uptime?
- How to get Processor Module info?
- How to get firmware version info?
- How to get the MAC address of the platform?
- How to get the image of all boards installed on your platform?
- How to get the image of all domains configured on your platform?
- How to get the partition configuration?
- How to get the memory configuration on all domains configured?
- How to get info of your boards environment (temperature, voltage, current)?
- How to list or disconnect the connections on the SC?
- How to access and quit 'service' mode?

Solution

How to access the ScApp shell via telnet?

Once the SC is booted, telnet to the SC. If s12sca is the hostname of the System Controller on a Sun Fire[TM] 4800 server:
tempete:lboschet> telnet s12sca
Trying 129.157.218.173...
Connected to s12sca.
Escape character is '^]'.
System Controller 's12sca':
    Type  0  for Platform Shell
    Type  1  for domain A console
Type 2 for domain B console
Type 3 for domain C console
Type 4 for domain D console
    Input: 0
Platform Shell
s12sca:SC> 

How to access a Domain Console?

console domain_name

s12sca:SC> console a
Connected to Domain A
s12d1 console login:

disconnect from the domain console:
s12d1 console login: <=== CTRL + ] if connected by network
telnet> send brk or ~. if connected by serial line.
Domain Shell for Domain A - s12d1

s12sca:A> disconnect
Connection closed.
s12sca:SC>

For more information see Technical Instruction Sun Fire[TM] (3800-6900): Navigating Between Shells on Sun Fire Mid-Range Servers 

How to access an SC from a secure SSH shell?

If console security is important, SSH provides a more data secure alternative for a network connection to the System Console. DOC# 817-7314-10 provides complete information on SSH.

Solaris 9 supports an SSH connection to a local SC. If a Solaris 9 instance is used to connect through SSH the nearly the same as a telnet session:
If s12sca is the hostname of the System Controller on a Sun Fire 4800 server:

  tempete:lboschet> ssh s12sca
Trying 129.157.218.173...
Connected to s12sca.
Escape character is '^]'.

Commands to utilize SSH are:

  >>> restartssh
Restarts the SSH server.
Syntax
restartssh [-h] Options/Parameters
-h displays help for this command.
-y answers yes to the informational message. Does not prompt for
confirmation. -n answers no to the informational message. Does not execute
the command if confirmation is required.
  >>> ssh-keygen
ssh-keygen Generates Secure Shell (SSH) host keys or displays the SSH host
key fingerprint.
schostname:SC> ssh-keygen -l
d1:c1:30:22:5d:6c:11:09:de:38:40:9e:20:a5:b3:10

How to use SC commands?

All commands can be abbreviated if they are not ambiguous with another one.

Example:
s12sca:SC> showboards -- Command
s12sca:SC> showb -- Abbreviated command

If command is ambiguous you'll get the following message:

s12sca:SC> show
show: Command is ambiguous, type "help" for a list of commands.
s12sca:SC>

How to get help?

s12sca:SC> help                 -- Display the commands
s12sca:SC> ? -- Display the commands
s12sca:SC> help [command] -- Displays the help of a specific command

How to get the ScApp version and SC uptime?

showsc -v

SC: SSC0
Main System Controller
SC Failover: disabled
Clock failover enabled.
SC date: Fri Feb 11 15:42:11 MST 2005
MST GMT-7 Mountain Standard Time
SC uptime: 6 days 9 hours 26 minutes 33 seconds
ScApp version: 5.14.3
Version build: 2.0
Version String: 5.14.3
RTOS version: 26
SC POST diag level: min
Clock source is: 75MHz

How to get Processor Module info?

showboards

s12sca:SC> showboards -p cpu
CPUs
----
Component Description
--------- -----------
/N0/SB0/P0 UltraSPARC-III, 750MHz, 8M ECache
/N0/SB0/P1 UltraSPARC-III, 750MHz, 8M ECache
/N0/SB0/P2 UltraSPARC-III, 750MHz, 8M ECache
/N0/SB0/P3 UltraSPARC-III, 750MHz, 8M ECache
SB2/P2 UltraSPARC-III, 750MHz, 8M ECache
SB2/P3 UltraSPARC-III, 750MHz, 8M ECache

How to get firmware version info?

showboards

s12sca:SC> showboards -p proms
Proms
-----
/SSC0/javaosflash:
ScApp 5.14.4 03/13/2001 16:54
Info 5.14.4 03/13/2001 16:54
/IB8/bbcGroup0/sysbdflash:
iPOST 5.14.4 03/13/2001 16:49
Info 5.14.4 03/13/2001 16:50
/partition0/domain0/IB6/bbcGroup0/sysbdflash:
iPOST 5.14.4 03/13/2001 16:49
Info 5.14.4 03/13/2001 16:50
/partition0/domain0/SB0/bbcGroup0/sysbdflash:
POST 5.14.4 03/13/2001 16:49
OBP 5.14.4 03/13/2001 16:49
Info 5.14.4 03/13/2001 16:49
/partition0/domain0/SB0/bbcGroup1/sysbdflash:
POST 5.14.4 03/13/2001 16:49
OBP 5.14.4 03/13/2001 16:49
Info 5.14.4 03/13/2001 16:49
/partition0/domain0/SB2/bbcGroup0/sysbdflash:
POST 5.14.4 03/13/2001 16:49
OBP 5.14.4 03/13/2001 16:49
Info 5.14.4 03/13/2001 16:49
/partition0/domain0/SB2/bbcGroup1/sysbdflash:
POST 5.14.4 03/13/2001 16:49
OBP 5.14.4 03/13/2001 16:49
Info 5.14.4 03/13/2001 16:49
s12sca:SC> 

How to get the MAC address of the platform?

s12sca:SC> showplatform -p mac
  MAC Address          HostID
----------------- --------
Domain A 00:03:ba:02:68:50 83026850
Domain B 00:03:ba:02:68:51 83026851
Domain C ff:ff:ff:ff:ff:ff ffffffff
Domain D ff:ff:ff:ff:ff:ff ffffffff
SSC0 00:03:ba:02:68:52 83026852
SSC1 00:03:ba:02:68:53 83026853
System Serial Number: 115H3EF3
Chassis HostID: 83026850

How to get the image of all boards installed on your platform?

s12sca:SC> showboards
Slot     Pwr Component Type                 State      Status     Domain
---- -- ------------- ---- ----- -----
/N0/SB0 On CPU Board Active Passed A
/N0/SB2 On CPU Board Active Passed A
/N0/IB6 On PCI I/O Board Active Passed A
IB8 On PCI I/O Board Available Not tested Isolated
s12sca:SC> 

How to get the image of all domains configured on your platform?

showplatform

s12sca:SC> showp
Domain    Solaris Nodename    Domain Status            Keyswitch
-------- ------------------ ----------------------- -------------
A s12d1 Active - Solaris on
B - Powered Off off
C - Powered Off off
D - Powered Off off
The system controller is configured to be on a network.
Network settings: static
Hostname: s12sca
IP Address: 129.157.218.173
Netmask: 255.255.255.0
Gateway: 129.157.218.1
DNS Domain:
Primary DNS Server:
Secondary DNS Server:
Loghost for Platform:
Loghost for Domain A:
Loghost for Domain B:
Loghost for Domain C:
Loghost for Domain D:
SNMP Agent: disabled
Chassis Description: Serengeti Control Room
Chassis Contact: Equipe EMEA Technical Center
Chassis Location: Velizy - SaintEx 2
ACL for Domain A: SB0 SB2 SB4 IB6 IB8
ACL for Domain B: SB0 SB2 SB4 IB6 IB8
ACL for Domain C: SB0 SB2 SB4 IB6 IB8
ACL for Domain D: SB0 SB2 SB4 IB6 IB8
SC POST diag Level: quick
Chassis is in single partition mode.
s12sca:SC> 

How to get the partition configuration?

showplatform

s12sca:SC> showplatform -p partition 
Chassis is in single partition mode.
s12sca:SC> 

How to get the memory configuration on all domains configured?

showboards

s12sca:SC> showboards -p memory
Component         Size      Reason
--------- ---- ------
/N0/SB0 4096 MB
SB2 2048 MB
s12sca:SC> 

How to get info of your boards environment (temperature, voltage, current)?

showenvironment

s12sca:SC> showenvironment               
Slot Device    Sensor    Value  Units     Age     Status
---- --------- --------- ------ --------- ------- ------
SSC0 SBBC 0 Temp. 0 44 Degrees C 3 sec OK
SSC0 CBH 0 Temp. 0 51 Degrees C 3 sec OK
SSC0 Board 0 Temp. 0 31 Degrees C 4 sec OK
SSC0 Board 0 Temp. 1 31 Degrees C 4 sec OK
SSC0 Board 0 Temp. 2 31 Degrees C 4 sec OK
SSC0 Board 0 1.5 VDC 0 1.50 Volts DC 4 sec OK
SSC0 Board 0 3.3 VDC 0 3.37 Volts DC 4 sec OK
SSC0 Board 0 5 VDC 0 5.01 Volts DC 4 sec OK
/N0/SB0 Board 0 1.5 VDC 0 1.50 Volts DC 1 sec OK
/N0/SB0 Board 0 3.3 VDC 0 3.33 Volts DC 1 sec OK
/N0/SB0 SDC 0 Temp. 0 69 Degrees C 1 sec OK
/N0/SB0 AR 0 Temp. 0 54 Degrees C 1 sec OK
/N0/SB0 DX 0 Temp. 0 64 Degrees C 1 sec OK
/N0/SB0 DX 1 Temp. 0 68 Degrees C 1 sec OK
/N0/SB0 DX 2 Temp. 0 65 Degrees C 1 sec OK
/N0/SB0 DX 3 Temp. 0 67 Degrees C 1 sec OK
/N0/SB0 SBBC 0 Temp. 0 56 Degrees C 1 sec OK
/N0/SB0 Board 1 Temp. 0 22 Degrees C 1 sec OK
/N0/SB0 Board 1 Temp. 1 21 Degrees C 1 sec OK
/N0/SB0 SBBC 1 Temp. 0 59 Degrees C 1 sec OK
/N0/SB0 Board 1 Temp. 2 28 Degrees C 1 sec OK
/N0/SB0 Board 1 Temp. 3 28 Degrees C 1 sec OK
/N0/SB0 Cheetah 2 Temp. 0 62 Degrees C 1 sec OK
/N0/SB0 Cheetah 2 1.8 VDC 0 1.71 Volts DC 2 sec OK
/N0/SB0 Cheetah 3 Temp. 0 56 Degrees C 2 sec OK
/N0/SB0 Cheetah 3 1.8 VDC 1 1.71 Volts DC 2 sec OK
/N0/IB6 Board 0 1.5 VDC 0 1.51 Volts DC 7 sec OK
/N0/IB6 Board 0 3.3 VDC 0 3.35 Volts DC 7 sec OK
/N0/IB6 Board 0 5 VDC 0 4.95 Volts DC 7 sec OK
/N0/IB6 Board 0 12 VDC 0 12.11 Volts DC 7 sec OK
/N0/IB6 Board 0 Temp. 0 31 Degrees C 7 sec OK
/N0/IB6 Board 0 Temp. 1 31 Degrees C 7 sec OK
/N0/IB6 SDC 0 Temp. 0 73 Degrees C 7 sec OK
/N0/IB6 AR 0 Temp. 0 45 Degrees C 7 sec OK
/N0/IB6 DX 0 Temp. 0 54 Degrees C 7 sec OK
/N0/IB6 DX 1 Temp. 0 51 Degrees C 7 sec OK
/N0/IB6 SBBC 0 Temp. 0 52 Degrees C 7 sec OK
/N0/IB6 IOASIC 0 Temp. 0 58 Degrees C 7 sec OK
/N0/IB6 IOASIC 1 Temp. 1 44 Degrees C 7 sec OK
/N0/SB2 Board 0 1.5 VDC 0 1.51 Volts DC 2 sec OK
/N0/SB2 Board 0 3.3 VDC 0 3.31 Volts DC 2 sec OK
/N0/SB2 SDC 0 Temp. 0 72 Degrees C 2 sec OK
/N0/SB2 AR 0 Temp. 0 64 Degrees C 2 sec OK
/N0/SB2 DX 0 Temp. 0 65 Degrees C 2 sec OK
/N0/SB2 DX 1 Temp. 0 66 Degrees C 2 sec OK
/N0/SB2 DX 2 Temp. 0 68 Degrees C 2 sec OK
/N0/SB2 DX 3 Temp. 0 64 Degrees C 2 sec OK
/N0/SB2 SBBC 0 Temp. 0 56 Degrees C 2 sec OK
/N0/SB2 Board 1 Temp. 0 21 Degrees C 2 sec OK
/N0/SB2 Board 1 Temp. 1 21 Degrees C 2 sec OK
/N0/SB2 SBBC 1 Temp. 0 51 Degrees C 2 sec OK
/N0/SB2 Board 1 Temp. 2 26 Degrees C 2 sec OK
/N0/SB2 Board 1 Temp. 3 26 Degrees C 2 sec OK
/N0/SB2 Cheetah 2 Temp. 0 57 Degrees C 2 sec OK
/N0/SB2 Cheetah 2 1.8 VDC 0 1.71 Volts DC 2 sec OK
/N0/SB2 Cheetah 3 Temp. 0 55 Degrees C 2 sec OK
/N0/SB2 Cheetah 3 1.8 VDC 1 1.72 Volts DC 2 sec OK
RP0 Board 0 1.5 VDC 0 1.49 Volts DC 5 sec OK
RP0 Board 0 3.3 VDC 0 3.35 Volts DC 5 sec OK
RP0 Board 0 Temp. 0 29 Degrees C 5 sec OK
RP0 Board 0 Temp. 1 29 Degrees C 5 sec OK
RP0 SDC 0 Temp. 0 65 Degrees C 6 sec OK
RP0 AR 0 Temp. 0 62 Degrees C 6 sec OK
RP0 DX 0 Temp. 0 57 Degrees C 6 sec OK
RP0 DX 1 Temp. 0 49 Degrees C 6 sec OK
RP2 Board 0 1.5 VDC 0 1.50 Volts DC 6 sec OK
RP2 Board 0 3.3 VDC 0 3.39 Volts DC 6 sec OK
RP2 Board 0 Temp. 0 29 Degrees C 6 sec OK
RP2 Board 0 Temp. 1 29 Degrees C 6 sec OK
RP2 SDC 0 Temp. 0 70 Degrees C 6 sec OK
RP2 AR 0 Temp. 0 60 Degrees C 6 sec OK
RP2 DX 0 Temp. 0 60 Degrees C 6 sec OK
RP2 DX 1 Temp. 0 53 Degrees C 6 sec OK
PS0 48 VDC 0 Current 0 5.87 Amps 1 sec OK
PS0 48 VDC 0 Temp. 0 27 Degrees C 1 sec OK
PS0 48 VDC 1 Current 0 0.20 Amps 1 sec OK
PS0 48 VDC 1 48 VDC 0 55.02 Volts DC 1 sec OK
PS0 48 VDC 0 48 VDC 0 56.07 Volts DC 1 sec OK
PS1 48 VDC 0 Current 0 0.00 Amps 8 sec OK
PS1 48 VDC 0 Temp. 0 28 Degrees C 8 sec OK
PS1 48 VDC 1 Current 0 0.74 Amps 8 sec OK
PS1 48 VDC 1 48 VDC 0 55.02 Volts DC 8 sec OK
PS1 48 VDC 0 48 VDC 0 56.33 Volts DC 8 sec OK
PS2 48 VDC 0 Current 0 5.32 Amps 8 sec OK
PS2 48 VDC 0 Temp. 0 30 Degrees C 8 sec OK
PS2 48 VDC 1 Current 0 0.22 Amps 8 sec OK
PS2 48 VDC 1 48 VDC 0 55.02 Volts DC 8 sec OK
PS2 48 VDC 0 48 VDC 0 56.33 Volts DC 8 sec OK
IB8 Board 0 1.5 VDC 0 1.51 Volts DC 3 sec OK
IB8 Board 0 3.3 VDC 0 3.35 Volts DC 3 sec OK
IB8 Board 0 5 VDC 0 4.98 Volts DC 3 sec OK
IB8 Board 0 12 VDC 0 12.11 Volts DC 3 sec OK
IB8 Board 0 Temp. 0 29 Degrees C 3 sec OK
IB8 Board 0 Temp. 1 31 Degrees C 3 sec OK
IB8 SDC 0 Temp. 0 62 Degrees C 3 sec OK
IB8 AR 0 Temp. 0 51 Degrees C 3 sec OK
IB8 DX 0 Temp. 0 58 Degrees C 3 sec OK
IB8 DX 1 Temp. 0 53 Degrees C 3 sec OK
IB8 SBBC 0 Temp. 0 56 Degrees C 3 sec OK
IB8 IOASIC 0 Temp. 0 55 Degrees C 4 sec OK
IB8 IOASIC 1 Temp. 1 49 Degrees C 4 sec OK
s12sca:SC>

How to list or disconnect the connections on the SC?

connections

s12sca:SC> connections

ID Hostname Idle Time Connected On Connected To
--- ------------------------ --------- -------------- --------------
1 localhost 01:46 Mar 23 15:44 Platform
4 129.157.218.24 00:14 Mar 23 17:19 Platform
6 129.157.178.163 - Mar 23 17:22 Platform

s12sca:SC> disco 6 <<<< disconnects this user from the platform

 

How to access and quit 'service' mode?

To generate a service mode password, access https://sfservicepass.us.oracle.com/ (you will need the ScApp level, RTOS level, and hostid of the system controller).


Then access service mode using the "service" command from the platform shell:

 v4u-6800a-sc0:SC> service
The use of engineering commands can be destructive and destabilize the
  system.  Use of engineering mode is authorized only by personnel trained in
  its use.
Enter Password:        <<< If you type an invalid password the system will
                            provide the neccesary information that is needed
                            to generate a password.
 Invalid password.
HostID: 83026852       <<< Information needed for password creation
  ScApp version: 5.14.3 <<< This is an easy method to list necessary
  RTOS version: 26      <<< information to generate a password.
Enter Password: xxxxxxxxx  <<< enter password here.
v4u-6800a-sc0:SC[service]>

To exit service mode, type the "service" command again:

 v4u-6800a-sc0:SC[service]> service
v4u-6800a-sc0:SC>

 NOTE: Make sure the SC date is correct, IF NOT you will not be able to log onto service mode.

Internal Only Topic
How to get to 'engineering' mode?

Engineering mode is only executed under the direct supervision of Senior Level Technical
Resources and the Senior Level Engineer should have an escalation for the issue that is needing
this mode.  Never enter this mode without first engaging a Senior Resource on the issue.

If s12sca is the hostname of the System Controller on a Sun Fire 4800 server, the following
example shows how one enters eng mode:

  lboschet> telnet s12sca
   Trying 129.157.218.173...
   Connected to s12sca.
   Escape character is '^]'.
  System Controller 's12sca':
      Type  0  for Platform Shell
      Type  1  for domain A console
       Type  2  for domain B console
       Type  3  for domain C console
       Type  4  for domain D console
      Input: 0
  Platform Shell
  s12sca:SC>  eng
  The use of engineering commands can be destructive and destabilize the
   system.  Use of engineering mode is authorized only by personnel trained in
   its use.
  Enter Password:        <<< If you type an invalid password the system will
  provide the necessary information that is needed to generate a password.
   Invalid password.
  HostID: 83026852           <<< Information needed for password creation
   ScApp version: 5.14.3    <<<
   RTOS version: 26           <<<
  Enter Password: xxxxxxxxx    <<< enter password provided by Senior Engineers.
  s12sca:SC:SC[engineering]> eng    <<< the eng commands disconnects the session.


Previously Published As 27428

Attachments
This solution has no attachment
  Copyright © 2011 Sun Microsystems, Inc.  All rights reserved.
 Feedback