HP-UX Reference (11i v1 05/09) - 1M System Administration Commands A-M (vol 3)

a
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.
-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] [-?] <array-id>
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.
Section 1M−−68 Hewlett-Packard Company − 1 − HP-UX 11i Version 1: September 2005