unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

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



 arrayrecover(1M)					    arrayrecover(1M)




 NAME
      arrayrecover - reconstructs data mapping and array configuration in
      the event of the loss of NVRAM contents.

 SYNOPSIS
      arrayrecover [ [-s] | [-l[c]] | [-p] | [-v volume-set-id] ]
	   [-c] [-override] [-?] array-id

 DESCRIPTION
      arrayrecover reconstructs data mapping and array configuration in the
      event of the loss of NVRAM contents. The data maps are reconstructed
      using the latest copy of mapping information stored on the disk
      drives. Part of the recovery operation includes performing a parity
      scan on the contents of the entire disk array to validate the accuracy
      of the maps and to correct any drive parity inconsistencies. This
      process can take up to several hours depending on the amount of data
      on the disk array.

      The array-id used to address the disk array can be either 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
      arrayrecover supports the following options:

	   none		  Begin the recovery in interactive mode. The
			  utility will display all recoverable volume sets,
			  then prompt for the number of the volume set to
			  recover.

	   -c		  Used with other options, this will cause
			  continuous polling during the recovery. The
			  recovery is monitored and the current progress is
			  displayed at regular intervals.

	   -l		  Displays the array controller logs on standard
			  output.

	   -lc		  Displays the array controller logs on standard
			  output, and then clears the logs.

	   -p		  Begin the recovery in non-interactive mode. If
			  there are multiple volume sets on the disk array,
			  a list of the volume set numbers will be
			  displayed. If there is only one volume set on the
			  disk array, the recovery will be done on it. This
			  option provides a mechanism to pass volume set
			  information to a script designed to perform a
			  recovery.




				    - 1 -	  Formatted:  August 2, 2006






 arrayrecover(1M)					    arrayrecover(1M)




	   -s		  Returns the recoverability status of the disk
			  array, as well as the status of a recovery in
			  progress. The status indicates if recovery is
			  needed, and what percentage of the entire recovery
			  has been completed.  When used with the -c option,
			  status will be returned at regular intervals
			  allowing continuous monitoring of the recovery
			  progress.

	   -v volume-set-id
			  Starts a recovery on the volume set indicated by
			  volume-set-id.  This option is intended for use
			  only in environments where there are multiple
			  volume sets on the disk array.

	   -override	  When specified with other options this will bypass
			  checks on warning states and allow a recovery
			  command to be issued. This option should be used
			  with caution.

	   -?		  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
      arrayrecover 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 the server is
	      not running.

 DIAGNOSTICS
      The following messages can be generated by arrayrecover:

      Usage: arrayrecover [[-s] | [-l[c]] | [-p] | [-v volume-set-id]]
      [-c] [override] [-?]<&lt&lt&lt;array-id>&gt&gt&gt;
	   An error in command syntax has occurred. Re-enter the command
	   with all necessary arguments.

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




				    - 2 -	  Formatted:  August 2, 2006






 arrayrecover(1M)					    arrayrecover(1M)




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

      arrayrecover: 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).

      arrayrecover: 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
	   ystem error. The Additional Error Info and Error Info Decode
	   fields will hold specifics about the failure and its cause.

 EXAMPLES
      Perform a recovery on the default volume set on disk array serial
      number 00786b5c0000:

	   arrayrecover -p 00786b5c0000

      Retrieve status for the recovery in progress on the disk array serial
      number 00786b5c0000.  Also have the status continually updated until
      completion.

	   arrayrecover -s -c 00786b5c0000

 DEPENDENCIES
      arrayscan must be installed and 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.

    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.





				    - 3 -	  Formatted:  August 2, 2006






 arrayrecover(1M)					    arrayrecover(1M)




      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
      arrayrecover was developed by HP.

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

































				    - 4 -	  Formatted:  August 2, 2006