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

Asset ID: 1-71-1011930.1
Update Date:2012-08-28
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 Netra 1280 Server
    •  
  • Sun Fire 3800 Server
    •  
  • Sun Fire 6800 Server
    •  
  • Sun Fire E2900 Server
    •  
  • Sun Fire 4810 Server
    •  
  • Sun Fire V1280 Server
    •  
  • Sun Fire 4800 Server
    •  
  • Sun Netra 1290 Server
    •  
  • Sun Fire E4900 Server
    •  
  • Sun Fire E6900 Server
    •  
Related Categories 
    

  • PLA-Support>Sun Systems>SPARC>Enterprise>SN-SPARC: Exx00
    •  
  • .Old GCS Categories>Sun Microsystems>Servers>Entry-Level Servers
    •  
  • .Old GCS Categories>Sun Microsystems>Servers>Midrange Servers
    •  
  • .Old GCS Categories>Sun Microsystems>Servers>Midrange V and Netra Servers
    •  

PreviouslyPublishedAs
216328 


Applies to: 

Sun Fire 4800 Server - Version All Versions and later
Sun Fire 4810 Server - Version All Versions and later
Sun Netra 1280 Server - Version All Versions and later
Sun Netra 1290 Server - Version All Versions and later
Sun Fire V1280 Server - Version All Versions and later
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?


Fix


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 1003150.1 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. Platform Administration Manual for Firmware 5.20.x is available here and 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://modepass.us.oracle.com 

(a backup server is also available from https://modepass-bak.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:              <--- pressing enter here will provide the neccesary information that is needed to generate a password.
 Invalid password.
 HostID: 83026852     
 ScApp version: 5.14.3    
 RTOS version: 26         
 Enter Password: xxxxxxxxx
 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.








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: xxxxxxxxx




Previously Published As 27428





Attachments

This solution has no attachment


















       

Copyright © 2012 Sun Microsystems, Inc.  All rights reserved.

 Feedback