unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

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



 arrayrbld(1M)						       arrayrbld(1M)




 NAME
      arrayrbld - controls rebuilding of the disk array.

 SYNOPSIS
      arrayrbld -r | -c | -p | -a  { on | off }	 | -P { high | low }
	   [-V] [-?] array-id

 DESCRIPTION
      arrayrbld manages the rebuild process on the disk array identified by
      array-id.	 A rebuild can be started, canceled, prioritized, and
      monitored using arrayrbld.

      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.

    Options
      arrayrbld supports the following options:

      -a { on | off }	  Set Auto Rebuild. On allows the disk array to
			  automatically begin a rebuild in the event of a
			  disk failure. Off requires a rebuild to be started
			  manually.

      -c		  Cancel a rebuild currently in progress. A rebuild
			  started by Auto Rebuild cannot be canceled.

      -p		  Display rebuild status and control settings. The
			  following information is displayed:

			  +  Vendor and product ID.
			  +  Rebuild progress in percent complete, or a
			     message indicating that no rebuild is currently
			     in progress.
			  +  Current setting of Auto Rebuild (on or off).
			  +  Current setting of Rebuild Priority (high or
			     low).
			  +  Current rebuild status indicating if a rebuild
			     is in progress, or if a rebuild failed.

      -P { high | low }	  Set Rebuild Priority. High sets the rebuild to the
			  same priority as host I/Os. This allows the
			  rebuild to complete as quickly as possible, but
			  slows down the servicing of I/Os. Low sets the
			  rebuild priority lower than host I/Os. This
			  ensures that host I/Os are serviced first, but it
			  delays the completion of the rebuild.

      -r		  Start a rebuild on the disk array.




				    - 1 -	  Formatted:  August 2, 2006






 arrayrbld(1M)						       arrayrbld(1M)




      -V		  Verbose mode displays additional command
			  execution, state, and/or status messages.

      -?		  Display extended 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
      arrayrbld 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 arrayrbld:

      Usage: arrayrbld {[-r | -c] | [-p] | [-a on|off] [-P high|low]}
      [-V] [-?] <&lt&lt&lt;array-id>&gt&gt&gt;
	   An error in command syntax has occurred. Re-enter the command
	   with all necessary arguments.

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

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

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

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

      arrayrbld: The array does not need to be rebuilt, rebuild not started.
	   An attempt was made to start a rebuild when it was not required.




				    - 2 -	  Formatted:  August 2, 2006






 arrayrbld(1M)						       arrayrbld(1M)




      arrayrbld: The array is already rebuilding.
	   An attempt was made to start a rebuild with one already in
	   progress.

      arrayrbld: Cannot cancel because the array is not rebuilding.
	   An attempt was made to cancel a rebuild, but none was in
	   progress.

      arrayrbld: Cannot cancel a rebuild when array has Auto Rebuild
      enabled.
	   An attempt was made to cancel a rebuild that was started
	   automatically by Auto Rebuild. A rebuild started in this way
	   cannot be canceled unless Auto Rebuild is first disabled.

      arrayrbld: Device 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.

 EXAMPLES
      Rebuild disk array serial number 00786b5c0000:

	   arrayrbld -r 00786b5c0000

      Cancel a rebuild currently in progress on the disk array identified by
      device file /dev/rdsk/c2t0d0:

	   arrayrbld -c /dev/rdsk/c2t0d0

      Display the rebuild status on disk array identified by alias
      AUTORAID3:

	   arrayrbld -p AUTORAID3

      Set Auto Rebuild on and Rebuild Priority low on the disk array
      identified by device file /dev/rdsk/c2t0d0:

	   arrayrbld -a on -P low /dev/rdsk/c2t0d0

 DEPENDENCIES
      ARMServer must be running to execute this command. See ARMServer(1M).

 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.




				    - 3 -	  Formatted:  August 2, 2006






 arrayrbld(1M)						       arrayrbld(1M)




    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.

 AUTHOR
      arrayrbld was developed by HP.

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























				    - 4 -	  Formatted:  August 2, 2006