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.
-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] [-?]<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.

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.

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