unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



 amdload(1M)							 amdload(1M)




 NAME
      amdload - downloads new firmware to the disk array controllers, the
      disk system BCC controllers, and disks

 SYNOPSIS
      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
      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
      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
      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
      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.



				    - 1 -	  Formatted:  August 2, 2006






 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:
		     bootware  - *.bwd
		     firmware (or "appware") -	*.apd
		     packaged bootware and firmware - *.dlp
		     NVSRAM - *.dl or *.dlp

	   -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.

		     If the -force option is included, non-optimal disk
		     states will be ignored.



				    - 2 -	  Formatted:  August 2, 2006






 amdload(1M)							 amdload(1M)




	   -?	     Display expanded usage message. This option overrides
		     all others.

 SECURITY CONFIGURATION
      This command is modified for all security configurations.

    Security Behavior/Restrictions
      Use of this command is restricted to authorized users only.

    Command Authorizations
      This command requires the sysadmin authorization to successfully
      execute.

    Privileges
      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
    Environment Variables
      LC_MESSAGES determines the language in which messages are displayed.
      The current language settings can be checked with locale(1).

 RETURN VALUE
      amdload returns the following values:

	   0	Successful completion.
	   1	An error in execution (I/O, subsystem, security, etc.)
		occurred.
	   2	An error in command syntax occurred: for example, an unknown
		command-line option was passed.




				    - 3 -	  Formatted:  August 2, 2006






 amdload(1M)							 amdload(1M)




	   3	Timeout in communication to server.  May indicate AM60Srvr
		is not running.

 DIAGNOSTICS
      The following messages can be generated by amdload:

      Usage: amdload -D {all | Chan:ID,Chan:ID,...} <&lt&lt&lt;codefile>&gt&gt&gt; <&lt&lt&lt;ArrayID>&gt&gt&gt;

      amdload -C { all | <&lt&lt&lt;cntrlrID>&gt&gt&gt; } codefile <&lt&lt&lt;ArrayID>&gt&gt&gt;

      amdload -S { all | <&lt&lt&lt;Chan>&gt&gt&gt;,<&lt&lt&lt;Chan>&gt&gt&gt;,...} [-force] <&lt&lt&lt;codefile>&gt&gt&gt; <&lt&lt&lt;ArrayID>&gt&gt&gt;

      amdload -i <&lt&lt&lt;ArrayID>&gt&gt&gt;

      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 <&lt&lt&lt;ArrayID>&gt&gt&gt; 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 <&lt&lt&lt;disk>&gt&gt&gt; 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 <&lt&lt&lt;disk>&gt&gt&gt; 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.

      amdload: Firmware download has been aborted.




				    - 4 -	  Formatted:  August 2, 2006






 amdload(1M)							 amdload(1M)




	   LUN <&lt&lt&lt;lun>&gt&gt&gt; 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, <&lt&lt&lt;Additional Error Info>&gt&gt&gt;:
	   <&lt&lt&lt;Error Info Decode>&gt&gt&gt;
	   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
      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
      AM60Srvr must be running to execute this command. See AM60Srvr(1M).

 AUTHOR
      amdload was developed by HP.

 SEE ALSO
      amdsp(1M), amcfg(1M), amutil(1M), amlog(1M), ammgr(1M), AM60Srvr(1M).

















				    - 5 -	  Formatted:  August 2, 2006