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:
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.
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, <Additional Error Info>:
<Error Info Decode>
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.
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:
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.
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).
Printable version
