flashpbay(1M)flashpbay(1M)Nameflashpbay - FLASH update utility for SGI Server Power Bays
SYNOPSIS
/usr/sbin/flashpbay [-f] [--l2 hostname|IP]
[--sysname name] [--ssn serial_number] [--interface name]
[--serial host:port] [--dev device_name] image_name
rack.slot|all|local
/usr/sbin/flashpbay -version|-v image_name
Additional IRIX command formats:
/usr/sbin/flashpbay [-f] [--sc] [--scdev device_name] image_name
rack.slot|all|local
DESCRIPTION
The flashpbay utility updates FLASH memory in the power bay. The power
bay flash memory contains the code for communicating status information
to the L1 controller; it does not control the functional operation of the
power bay.
The power bay has two separate flash memories, only one of which is
accessible for updating by the flashpbay utility. The power bay firmware
that supports flashing resides in the inaccessible flash memory, so it is
not possible to corrupt this memory during the flashing procedure. The
accessible memory, however, may be corrupted if the flashing procedure
fails for some reason. In this case, flashpbay will need to be rerun.
flashpbay supports updates via three methods:
- ethernet connection to an L2 controller
- direct USB connection to a L1 controller
- direct serial connection to an L1 controller
Valid command line options are:
-version|-v image_image
Return the version number and build time of the specified image.
-f Forces the power bay flash update even if the power bay already is
running the same firmware version as the image file.
--l2 hostname|IP
Connect to the L2 controller with the specified hostname or IP
address.
Page 1
flashpbay(1M)flashpbay(1M)--ssn serial_number
Search for an L2 with the System Serial Number serial_number, and
connect to the first one found.
--sysname name
Search for an L2 with the System Name name, and connect to the first
one found.
--interface name
When searching for an L2 Controller to connect to, only search on
the specified network interface (i.e. eth0, eth1, etc.) This option
is ignored when --l2, --serial, or --dev is specified.
--serial host:port
Connect to the controller via a serial (SMP) connection to the Annex
box host on network port port (port number of the connection to the
Annex box plus 7000).
--dev device_name
Connect to the controller via a direct serial (SMP) connection to a
serial port on the system where flashpbay is running.
--sc (IRIX only) Connect via the system's own System Controller network.
This option allows the power bay flash memory firmware to be updated
from IRIX. This option selects causes flashpbay to connect to the
L1 Controller of the brick with the lowest numbered rack/slot in the
system. The connection is established by opening one of the
/hw/module/*c*/L1/controller devices.
--scdev device_name
(IRIX only) Connect via the system's own System Controller network
using device_name. This option is identical to --sc, except that it
uses device_name rather than selecting a default device to use.
Valid devices are any of /hw/module/*c*/L1/controller.
image_name
The image name is the file name of the image, which for the power
bay is usually pbay.bin.
rack.slot|all|local
rack is the rack number of the controller(s) that will be updated.
slot is the slot number of the controller(s) that will be updated.
all may be used instead of rack.slot. local means update ONLY the
controller that flashpbay is connected to (i.e. the L1 it is
Page 2
flashpbay(1M)flashpbay(1M)
connected to via a serial connection). NOTE: The all argument is
only valid on systems with one or more L2 Controllers (on systems
without an L2 Controller, L1 Controllers must be updated
individually using the rack.slot or the local argument).
Without any options, flashpbay attempts to connect to an L2 controller (a
"real" L2, or a software L2 running on the L3). When communicating with
the system via the USB connection (in a system where there is no actual
L2), the application /stand/sysco/bin/l2 must be running.
FILES
/usr/sbin/flashpbay power bay firmware update utility
/usr/cpu/firmware/sysco/pbay.bin power bay firmware image
/hw/module/*c*/L1/controller (IRIX only) IRIX System Controller devices
EXAMPLES
Updating all power bays connected to all L1's on a single, standalone
system with one or more hardware L2's:
1) cd /usr/cpu/firmware/sysco
2) /usr/sbin/flashpbay ./pbay.bin all
Updating all power bays connected to all L1's on one system (serial
number L0000010) from an L3 Controller with multiple SN1 systems
connected.
1) cd /usr/cpu/firmware/sysco
2) /usr/sbin/flashpbay --ssn L0000010 ./pbay.bin all
Updating all power bays from IRIX, using the default system controller
path. (Note that this command format is valid only on a system with one
or more L2 Controllers; see the following example for updating systems
without an L2 controller)
1) cd /usr/cpu/firmware/sysco
2) /usr/sbin/flashpbay --sc ./pbay.bin all
Updating all L1's from IRIX, on a system without an L2 Controller, using
the default system controller path. Typically on this type of system,
all bricks in are connected to the same PowerBay, so the command only
needs to be executed once (from any of the attached bricks). In this
example system there are 3 bricks: 001c10, 001c13, and 001i16.
1) cd /usr/cpu/firmware/sysco
2) /usr/sbin/flashsc --sc ./l1.bin 1.10
Page 3
flashpbay(1M)flashpbay(1M)
Updating the power bay connected to the L1 at rack 2, slot 18 via the USB
connection using the L2 emulator running on the L3 (system w/o a hardware
L2):
1) make sure the software L2 is running (/stand/sysco/bin/l2)
2) cd /usr/cpu/firmware/sysco
3) update the power bay flash with the command:
/usr/sbin/flashpbay ./pbay.bin 2.18
Updating the power bay connect to the L1 at rack 3, slot 12 via the
(serial) SMP port connection on the Annex serial port server 'myannex',
port 17:
1) cd /usr/cpu/firmware/sysco
2) update the power bay flash with the command:
/usr/sbin/flashpbay --serial myannex:7017 ./pbay.bin 3.12
Page 4
