unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

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



 download(1M)							download(1M)




 NAME
      download - download new controller or disk firmware.

 SYNOPSIS
      download -D slot [-?] codefilename array-id

      download -C [-?] codefilename array-id

      download -M [-?] array-id

      download -i [-?]

 DESCRIPTION
      download copies new firmware code to the controller or disks in the
      disk array identified by array-id.  The new code is stored in the file
      identified by codefilename.  Firmware can also be copied from a
      primary controller to a secondary controller.

      The array-id used to address the disk array can be the disk array
      serial number, the character device file name of any LUN on the array
      (LUN 0 if no LUNs are created), or the alias text string assigned to
      the disk array.

      When downloading new firmware code, the arraymond disk monitor and
      ARMServer can be turned off to avoid error messages generated while
      the disk array is not accessible. To turn off arraymond and ARMServer
      use the following command line:

	   /sbin/init.d/hparray stop

      To restart arraymond and ARMServer use the following command line:

	   /sbin/init.d/hparray start

    Options
      download supports the following options:

	   -C		  Download new controller firmware. If there are two
			  controllers installed in the disk array, new
			  firmware will be downloaded to both.

	   -D slot	  Download firmware to the disk installed in the
			  cabinet slot identified by slot.  Slot numbers
			  must be of the form An or Bn, where A or B
			  correspond to a cabinet column, and n corresponds
			  to a shelf position (1-6).

	   -i		  Display the serial number and firmware revisions
			  for all disk arrays currently connected to and
			  recognized by the server. Because this option is
			  device-independent, it does not use array-id .



				    - 1 -	  Formatted:  August 2, 2006






 download(1M)							download(1M)




	   -M		  Copy the controller firmware from the primary
			  controller to the secondary controller.

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

 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
      download 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  Timeout in communication to server. May indicate ARMServer is
	      not running.

 DIAGNOSTICS
      The following messages can be generated by download:

      Usage: download -D slot | -C | -M [-?] codefilename array-id
	   An error in command syntax has occurred. Re-enter the command
	   with all necessary arguments.

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

      download: Unknown argument
	   An invalid argument was specified. Check command usage.

      download: No such file or directory
	   The specified array-id does not exist or does not identify a disk
	   array that is communicating with the system. Verify the correct
	   array-id with ioscan(1M) or arraydsp(1M).

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

      download: Array was just powered-on or reset.
	   The command failed because the disk array has been powered-on or
	   reset.  Reissue the command and it should succeed.




				    - 2 -	  Formatted:  August 2, 2006






 download(1M)							download(1M)




 EXAMPLES
      Download new firmware from file coderev2.1 to the controllers on the
      disk array identified by device file /dev/rdsk/c2t0d0:

	   download -C coderev2.1 /dev/rdsk/c2t0d0

      Download new firmware from file diskrev3.2 to the disk installed in
      slot B2 of disk array serial number 00786b5c0000:

	   download -D B2 diskrev3.2 00786b5c0000

      Copy the current firmware from the primary controller to the secondary
      controller on disk array identified by alias AUTORAID4:

	   download -M AUTORAID4

 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.





				    - 3 -	  Formatted:  August 2, 2006






 download(1M)							download(1M)




 AUTHOR
      download was developed by HP.

 SEE ALSO
      ARMServer(1M), arraycfg(1M), arraydsp(1M), arrayfmt(1M), arraylog(1M),
      arraymgr(1M), arrayrbld(1M), arrayrecover(1M), drivetest(1M),
      dteststat(1M), logprint(1M).















































				    - 4 -	  Formatted:  August 2, 2006