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

d
drivetest(1M) drivetest(1M)
NAME
drivetest - test a disk in the array.
SYNOPSIS
drivetest -D slot { -w percent | -r
percent | -s }[-?] array-id
DESCRIPTION
drivetest initiates testing of disks in the disk array identified by array-id. Three different types of test-
ing can be performed to verify disk operation and integrity. The amount of the disk surface tested can be
controlled depending on how thorough a test is desired. Results of the testing are retrieved using the
dteststat command.
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
drivetest supports the following options:
-D slot Identifies which disk to test. The disk installed in the cabinet slot identified by slot
will be tested. Slot numbers must be of the form An or Bn, where A or B correspond
to a cabinet column, and n corresponds to a shelf position (1-6).
-r percent Perform a read/verify test on the percentage of the disk media indicated by percent
(0-100). This is a nondestructive test that will not alter any data on the disk being
tested. It is not necessary to down the disk before performing a read/verify test.
-s Initiate a selftest of the disk. An internal selftest will check the operation of the disk.
Results of the testing are retrieved using the
dteststat command.
-w percent Perform a write/read/verify test on the percentage of the disk media indicated by per-
cent (0-100). This is a destructive test that will destroy data on the disk being tested.
The
arraycfg utility must be used to down the disk before beginning the test.
-? 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
drivetest 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
ARMServer is not running.
DIAGNOSTICS
The following messages can be generated by
drivetest:
Usage: drivetest -D slot -w percent | -r percent | -s [-?] array-id
An error in command syntax has occurred. Re-enter the command with all necessary arguments.
drivetest: 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.
drivetest: Unknown argument
An invalid argument was specified. Check command usage.
drivetest: 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) or arraydsp(1M).
drivetest: Error in command execution, <Additional Error Info>:
<Error Info Decode>
Section 1M−−188 Hewlett-Packard Company − 1 − HP-UX 11i Version 1: September 2005