System Management Services 1.2 man pages


	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 Administration

flashupdate(1m)

DESCRIPTION
OPTIONS
OPERANDS
EXTENDED DESCRIPTION
EXAMPLES
EXIT STATUS
FILES
ATTRIBUTES
SEE ALSO

NAME

flashupdate - update the Flash PROMs located on the CPU boards, MaxCPU boards and system controllers (SC)

SYNOPSIS

flashupdate -d domain_id | domain_tag -f path [-q ] [-y|-n]

flashupdate -f path [-q ] [-y|-n ] location [location ...]

flashupdate -h

DESCRIPTION

flashupdate(1M) updates the Flash PROM in the system controller (SC), and the Flash PROMs in a domain's CPU and MaxCPU boards, given the board location.

In order to update the Flash PROMs in the system controller, log in to the SC you wish to update and specify the Flash PROM to be updated. Each Flash PROM has a specific image file associated with it. Once you have finished updating the SC Flash PROMs you must shutdown and reset the SC. See example 7 below. You do not need to reset the SC after updating CPU Flash PROMs.

To update the CPU FPROMs, SMS must be running and the specified board must be powered on. This is not required to update the SC FPROMs. If any of the domain's CPU or MaxCPU boards have the virtual keyswitch setting in the secure position, the Flash PROM(s) will not be updated.

flashupdate displays both the current Flash PROM and the flash image file information prior to any updates.

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

Name assigned to a domain using addtag(1M).

-f path

Name of the flash image file.

The path argument specifies the name of the image file used to update the Flash PROM given in the location argument.

-h

Help. Displays usage descriptions. Note – Use alone. Any option specified in addition to -h is ignored.

-n

Automatically answers "no" to all prompts. Prompts are displayed unless used with the -q option.

-q

Quiet. Suppresses all messages to stdout including prompts.

When used alone, -q defaults to the -n option for all prompts.

When used with either the -y or the -n option, -q suppresses all user prompts and automatically answers with either 'y' or 'n' based on the option chosen.

-y

Automatically answers "yes" to all prompts. Prompts are displayed unless used with the -q option.

OPERANDS

The following operands are supported:

location

Flash PROM location.

The Flash PROM location consists of the board_loc/FlashPROM_id separated by a forward slash.

The FlashPROM_id is specified only when you want to update a particular Flash PROM (FP0 or FP1) on a CPU board and the system controller (SC).

For example, the location, SB4/FP0, indicates the Flash PROM 0 on the CPU board in slot 4.

The following board_loc forms are accepted:

Sun Fire 15K, Sun Fire 12K

SB(0...17), SB(0...8)

IO(0...17), IO(0...8)

SC(0|1), SC(0|1)

The following FlashPROM_id forms are accepted:

FP(0|1)

EXTENDED DESCRIPTION

Group Privileges Required

You must have platform administrator or domain administrator privileges to run this command. If you have platform administrator privileges, all boards can be updated. For domain administrators, only boards that are active in the administrator's domain or available to the administrator's domain can be updated.

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. Updating Flash PROM 0 in the System Controller 0

You must reset the SC after running this command.

sc0:sms-user:> flashupdate -f /opt/SUNWSMS/firmware/SCOBPimg.di SC0/FP0

Example 2. Updating Flash PROM 1 in the System Controller 0

You must reset the SC after running this command.

sc0:sms-user:> flashupdate -f /opt/SUNWSMS/firmware/SSCPOST.di SC0/FP1

Example 3. Updating Flash PROM 0 in the System Controller 1

You must reset the SC after running this command.

sc1:sms-user:> flashupdate -f /opt/SUNWSMS/firmware/SCOBPimg.di SC1/FP0

Example 4. Updating Flash PROM 0 in the slot0 Board

SMS must be running and the SB0/FP0 board must be powered on.

sc0:sms-user:> flashupdate -f /opt/SUNWSMS/hostobjs/sgcpu.flash SB0/FP0

Example 5. Updating Both Flash PROMs on CPU Board 17

SMS must be running and the SB17 board must be powered on.

sc0:sms-user:> flashupdate -f /opt/SUNWSMS/hostobjs/sgcpu.flash SB17

Example 6. Updating Flash PROMs in Domain A

SMS must be running and the CPU boards in domain A must be powered on.

sc0:sms-user:> flashupdate -d A -f /opt/SUNWSMS/hostobjs/sgcpu.flash

Example 7. Resetting the SC After Updating the SC PROMs.

Switch to superuser and shutdown the SC

sc0:sms-user:> su -

sc0:#  shutdown -y -g0 -i0
 ...[system messages]ok

In order for the new firmware to be enabled on your SC you must now perform a reset of the SC. Type:

ok reset-all

If this does not reset the SC then you must perform a hard reset.

Physically locate your System Controller within your Sun Fire 15K cabinet and depress the Abort and then Reset buttons on the SC board. Once the SC has been reset you should see OpenBoot PROM messages indicating that the new version of the firmware is loading. After the system successfully returns to the ok prompt, verify that the flashupdate worked, type:

ok show-dropins

Dropins for Flash device: /pci@1f,0/pci@1,1/ebus@1/flashprom@10,400000 ------------------------------------------------------------------------ Dropin name Size Checksum Date Date Version Vendor created flashed ------------------------------------------------------------------------ SSCOBP-dropins 90 c84e 11/13/2001 11/13/2001 1.2 SUNW,sscobp .... ....

Note the version number of the Dropins (1.2)

You can then boot your new installation of the Solaris software. Type:

ok boot new disk

Login in as a platform administrator and type:

sc1:sms-user:> flashupdate -f /opt/SUNWSMS/firmware SCOBPimg.di SC0/FP0 Current SC FPROM Information ============================ SC at SC0, FPROM 0: Name: SSCOBP-dropins, Version: 1.2 Size: 144, Check Sum: 51278 Date Flashed: 11/13/01 Date Created: 11/13/01 Do you wish to update the SC User FPROM (yes/no)? n sc1:sms-user:>

Compare version numbers. If they are the same, flashupdate was successful.

EXIT STATUS

The following exit values are returned:

0: Successful completion
>0: An error occurred.

FILES

The following files are used by this command:

/opt/SUNWSMS/firmware/SCOBPimg.di: Used to update the Flash PROM 0 on the SC.
/opt/SUNWSMS/firmware/SSCPOST.di: Used to update the Flash PROM 1 on the SC.
/opt/SUNWSMS/hostobjs/sgcpu.flash: Used to update the Flash PROMs on the CPU and MaxCPU boards.

ATTRIBUTES

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

Attribute Types	Attribute Values
Availability	SUNWSMSop