Template Version: @(#)onepager.txt 1.35 07/11/07 SMI
Copyright 2007 Sun Microsystems

1. Introduction
   1.1. Project/Component Working Name:
	Thunder Platform Software Support
	Starcat System Management Services (SMS) Command Line Interface (CLI)
	Serengeti System Controller App (SCapp) Command Line Interface (CLI)

   1.2. Name of Document Author/Supplier:
	David Nielsen

   1.3. Date of This Document:
	12/19/2007

   1.4 Name of Major Document Customer(s)/Consumer(s) :

	1.4.2. The ARC(s) you expect to review your project:
			   FWARC

	1.4.3. The Director/VP who is "Sponsoring" this project:
                           - Ravi.Subbarao@Sun.COM
                             Director: Enterprise Systems Software
                           - Mark.Turnland@Sun.COM 
                             Director: Enterprise Systems Hardware

	1.4.4. The name of your business unit:
                           Enterprise Systems 

   1.5. Email Aliases:
    	1.5.1. Responsible Manager: 	florentino.calip@sun.com
    	1.5.2. Responsible Engineer: 	david.nielsen@sun.com
    	1.5.3. Marketing Manager: 	Martin.Shepherd@Sun.COM
	1.5.4. Interest List:		tl_sw@sun.com

3. Business Summary
   3.1. Problem Area:
	The ability to reset a Thunder board in a Starcat/Serengeti chassis is
	a highly desireable feature. The existing reset(1M) and resetsc(1M) 
	commands provided in SMS/ScApp are a poor fit for resetting a Thunder 
	board. A new cli called resetboardsc(1M) is proposed.

	The existing SMS and ScApp reset(1M) command issues an xir or poweron
	reset to all the processors in a domain. The management model for a
	Thunder board prevents SMS or ScApp from directly managing the 
	processors on a Thunder board. In addition, Thunder boards are not 
	allowed in domains. Domain management is handled by ILOM on a service
	processor on the Thunder board itself. The reset(1M) command is not
	visible in the ScApp platform shell so it is inappropriate for a 
	Thunder board.

	The resetsc(1M) command is used to reset the other service processor.
	Using this command to reset a Thunder board in a slot is viewed as
	confusing. In addition, the resetsc command is not available in ScApp
	except in engineering mode so it is invisible to customers.

	The proposed resetboardsc(1M) command will be used to reset ILOM on the
	Thunder board identified by the slot it occupies.

   3.3. Business Justification:
	The ability to reset a Thunder board remotely using the resetboardsc 
	command is a feature not available in standalone Victoria Falls based
	systems. It is an added selling point for putting such a system into
	a Starcat or Serengeti chassis.  

   3.6. How will you know when you are done?:
	The proposed resetboardsc command will effectively reset ILOM running
	on a Thunder board in a Starcat or Serengeti chassis.

4. Technical Description:
    4.1. Details:

	The proposed synopsis for the SMS resetboardsc command is below.
		resetboardsc [-q] [-y|-n] location
		resetboardsc  -h
	The synopsis for the ScApp resetboardsc command is below. It does not
	include the -q because none of the ScApp commands use the -q option.
		resetboardsc [-y|-n] location
		resetboardsc  -h

	A more detailed description of the user interface is in the sample
	SMS man page and ScApp on line help for the resetboardsc command.

	The command will be implementation to check arguments, privileges,
	a valid location, and then write to an i2c address to reset the
	Thunder board.

    4.2. Bug/RFE Number(s):
	This work is being performed as part of the RFE below.

	6514961 Add basic SMS support for Thunder compute node
	6514965 Add basic SCApp support for Thunder compute node

    4.6. Doc Impact:
	resetboardsc(1M) man page
	System Management Services (SMS) Reference Manual
	System Management Services (SMS) Administrator Guide
	Sun Fire Midrange System Controller Command Reference Manual
	Sun Fire Midrange System Controller Platform Administration Manual

	Note resetboardsc changes to any SMS or ScApp documentation will be
	done as part of the overall Thunder project.

5. Reference Documents:

	Thunder SW I-Team:
        http://spider.west/thunder_lightning/index.php/Thunder_Software_I-team

	The man pages for the reset(1M) and resetsc(1M) commands are found in
	the Reference manuals for SMS and ScApp.

	System Management Services (SMS) 1.6 Reference Manual
	http://dlc.sun.com/pdf/819-4662-11/819-4662-11.pdf

	Sun Fire Midrange System Controller Command Reference Manual (5.20.0) 
	April 2006
	http://dlc.sun.com/pdf/819-5089-10/819-5089-10.pdf