arrayrecover - reconstructs data mapping and array configuration in
the event of the loss of NVRAM contents.
arrayrecover [ [-s] | [-l[c]] | [-p] | [-v volume-set-id] ]
[-c] [-override] [-?] array-id
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.
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
-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
-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
- 1 - Formatted: August 2, 2006
-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
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
-? Display expanded usage message. This option
overrides all others.
LC_MESSAGES determines the language in which messages are displayed.
The current language settings can be checked with locale(1).
arrayrecover returns the following values:
0 Successful completion.
1 An error in execution (I/O, subsystem, security, etc.)
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
The following messages can be generated by arrayrecover:
Usage: arrayrecover [[-s] | [-l[c]] | [-p] | [-v volume-set-id]]
[-c] [override] [-?]<<<<array-id>>>>
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: 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, <<<<Additional Error Info>>>>:
<<<<Error Info Decode>>>>
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.
Perform a recovery on the default volume set on disk array serial
arrayrecover -p 00786b5c0000
Retrieve status for the recovery in progress on the disk array serial
number 00786b5c0000. Also have the status continually updated until
arrayrecover -s -c 00786b5c0000
arrayscan must be installed and ARMServer must be running to execute
this command. See ARMServer(1M).
This command is modified for all security configurations.
Use of this command is restricted to authorized users only.
This command requires the sysadmin authorization to successfully
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
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.
arrayrecover was developed by HP.
ARMServer(1M), arraycfg(1M), arraydsp(1M), arrayfmt(1M), arraylog(1M),
arraymgr(1M), arrayrbld(1M), download(1M), drivetest(1M),
- 4 - Formatted: August 2, 2006