amdload(1M) amdload(1M)
NAME [Toc] [Back]
amdload - downloads new firmware to the disk array controllers, the
disk system BCC controllers, and disks
SYNOPSIS [Toc] [Back]
amdload -D { all | channel:ID,channel:ID,...} codefile ArrayID
amdload -C { all | cntrlrID} codefile ArrayID
amdload -S { all | channel,channel, ...} [-force] codefile ArrayID
amdload -i ArrayID
amdload -?
Remarks [Toc] [Back]
Downloading firmware should only be performed by service-trained
personnel. If firmware is not downloaded properly, it may cause the
disk array or some its components to become inoperative.
DESCRIPTION [Toc] [Back]
amdload copies new firmware code to the disk array controllers, the
disk system BCC controllers, or the disks in the disk array identified
by ArrayID. The new code is stored in the file identified by
codefile.
The ArrayID used to address the disk array can be the disk array
serial number or name, if one has been assigned to the disk array.
Identifying Disk Modules [Toc] [Back]
Disk modules are identified within Array Manager 60 using a numbered
pair of the form n:n. The first number identifies the SCSI channel
(or bus) connecting the array controller to the enclosure containing
the disk module. The channel number is indicated on the back of the
array controller enclosure. The second number is the disk module SCSI
ID. The SCSI ID is determined by the slot in which the disk module is
installed, but is not the same as the physical slot number (0-9).
For example, the numbered pair 2:1 identifies the disk module on
channel 2 with a SCSI ID of 1. Refer to the Disk Array FC/60 User's
Guide for more information on disk module addressing.
Options [Toc] [Back]
amdload supports the following options:
-C Download new firmware to the disk array controllers.
The new code is stored in the file identified by
codefile.
If the all option is included, download firmware to
both disk array controllers.
Hewlett-Packard Company - 1 - HP-UX 11i Version 2: August 2003
amdload(1M) amdload(1M)
If the cntrlrID option is included, download firmware
to the specified controller (A or B).
There are three controller firmware files: bootware,
firmware, and NVSRAM. The files must be downloaded in
the proper sequence. When upgrading firmware, download
the bootware code file first, followed by the firmware
code file, and finally the NVSRAM file. When
converting to an earlier version of firmware
(downgrading), the correct sequence is firmware first,
then bootware, followed by NVSRAM.
NOTE: On firmware version HP07 and higher, the
bootware and firmware files are available in a single
"packaged" file. The packaged file should be
downloaded first, followed by the NVSRAM file. This
order applies for both upgrades and downgrades.
Typical code filename extensions are as follows:
*.bwd bootware
*.apd firmware (or "appware")
*.dlp packaged bootware and firmware
*.dl or *.dlp NVSRAM
-D Download new firmware to the disks. The new code is
stored in the file identified by codefile.
If the all option is included, download firmware to all
disks on the disk array.
If the channel:ID option is included, download firmware
only to the specified disks. Disk are identified by
channel (1-6) and SCSI ID (0-4, 8-12).
-i Display the firmware revisions for all hardware
components of the specified disk array.
-S Download new firmware to the disk system BCC
controllers. The new code is stored in the file
identified by codefile.
If the all option is included, download firmware to all
disk system BCC controllers on the disk array.
If the channel option is included, download firmware
only to the specified disk systems. Disk systems are
identified by channel (1-6). Firmware will be
downloaded to both BCC controllers on the disk system.
Hewlett-Packard Company - 2 - HP-UX 11i Version 2: August 2003
amdload(1M) amdload(1M)
If the -force option is included, non-optimal disk
states will be ignored.
-? Display expanded usage message. This option overrides
all others.
SECURITY CONFIGURATION [Toc] [Back]
This command is modified for all security configurations.
Security Behavior/Restrictions
Use of this command is restricted to authorized users only.
Command Authorizations [Toc] [Back]
This command requires the sysadmin authorization to successfully
execute.
Privileges [Toc] [Back]
The command has been modified to support least privilege. The
potential privileges possessed by the command and their uses include:
allowdacread This privilege is raised to provide discretionary
read access to the devices.
allowdacwrite This privilege is raised to provide discretionary
write access to the devices.
allowmacread This privilege is raised to provide mandatory read
access to the devices.
allowmacwrite This privilege is raised to provide mandatory
write access to the devices.
filesysops This privilege is raised to allow the mknod(2)
system call to succeed.
writeaudit The command generates its own audit records and
submits these directly to the system audit trail.
This privilege is raised whenever the command
needs to write an audit record.
EXTERNAL INFLUENCES [Toc] [Back]
Environment Variables
LC_MESSAGES determines the language in which messages are displayed.
The current language settings can be checked with locale(1).
RETURN VALUE [Toc] [Back]
amdload returns the following values:
0 Successful completion.
1 An error in execution (I/O, subsystem, security, etc.)
occurred.
Hewlett-Packard Company - 3 - HP-UX 11i Version 2: August 2003
amdload(1M) amdload(1M)
2 An error in command syntax occurred: for example, an unknown
command-line option was passed.
3 Timeout in communication to server. May indicate AM60Srvr
is not running.
DIAGNOSTICS [Toc] [Back]
The following messages can be generated by amdload:
Usage: amdload -D {all | Chan:ID,Chan:ID,...} <codefile> <ArrayID>
amdload -C { all | <cntrlrID> } codefile <ArrayID>
amdload -S { all | <Chan>,<Chan>,...} [-force] <codefile> <ArrayID>
amdload -i <ArrayID>
Extended help: amdload -?
amdload -?
An error in command syntax has occurred. Re-enter the command
with all necessary arguments.
amdload: Arg out of range
One of the arguments has exceeded its maximum or minimum size, or
is incorrect in form. Check the size and form of each argument.
amdload: The <ArrayID> entered does not identify a known, supported
array
The specified ArrayID does not exist or does not identify a
device that is communicating with the system. Verify the array
exists and is operational.
amdload: Firmware download has been aborted.
Disk <disk> does not exist in the subsystem.
The specified disk does not exist in the subsystem. Re-enter the
list of disks, making sure all disks are physically present. A
similar message will appear for channels that do not exist.
amdload: Firmware download has been aborted.
There is more than one type of disk mechanism among
the disks selected for update.
Any particular firmware file is only valid for one type of disk
mechanism. This message will appear if the disks specified for
update are of more than one mechanism type. Re-enter the list of
disks, only including disks of one mechanism type.
amdload: The disk <disk> was repeated in your list.
Re-enter the command, listing each item once.
This message will appear if a disk or channel is repeated in the
input list. Be sure to list each item once.
Hewlett-Packard Company - 4 - HP-UX 11i Version 2: August 2003
amdload(1M) amdload(1M)
amdload: Firmware download has been aborted.
LUN <lun> is not in an Optimal state. Wait until all LUNs are in
an Optimal state before attempting further firmware downloads.
LUNs must be in an Optimal state before attempting disk or array
controller downloads. This message will appear if any LUNs are
not Optimal prior to a download, or if a LUN enters a non-Optimal
state between disk downloads.
amdload: Error in command execution, <Additional Error Info>:
<Error Info Decode>
The command failed due to a device error, an internal error, or a
system error. The Additional Error Info and Error Info Decode
fields will hold specifics about the failure and its cause.
EXAMPLES [Toc] [Back]
Download new firmware from file coderev2.1 to both disk array
controllers on disk array RACK_51:
amdload -C all coderev2.1 RACK_51
Download new firmware from file diskrev3.2 to the specified disks
(channel 6, SCSI ID 2 and channel 6, SCSI ID 4) in disk array RACK_51:
amdload -D 6:2,6:4 diskrev3.2 RACK_51
Download new firmware from file bccrev14 to the BCC controllers on all
the disk systems on disk array RACK_51:
amdload -S all bccrev14 RACK_51
DEPENDENCIES [Toc] [Back]
AM60Srvr must be running to execute this command. See AM60Srvr(1M).
AUTHOR [Toc] [Back]
amdload was developed by HP.
SEE ALSO [Toc] [Back]
amdsp(1M), amcfg(1M), amutil(1M), amlog(1M), ammgr(1M), AM60Srvr(1M).
Hewlett-Packard Company - 5 - HP-UX 11i Version 2: August 2003 [ Back ] |
