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 testing 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 percent (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> 

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.

drivetest: Disk did not start up following reset.

The disk did not start up following a reset. Check the status of the disk.

drivetest: A diagnostic is currently running on this disk.

A diagnostic test is already running on the specified disk.

drivetest: Array 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

Perform a read/verify test on the disk installed in slot B3 of the disk array identified by device file /dev/rdsk/c2t0d0. Perform the test over 50 percent of the disk surface.

drivetest -D B3 -r 50 /dev/rdsk/c2t0d0 

Perform a write/read/verify test on the disk installed in slot A5 of disk array serial number 00786b5c0000. Perform the test over 100 percent of the disk surface. Note that before issuing this command the disk must be downed (destructively) using the arraycfg utility.

drivetest -D A5 -w 100 00786b5c0000 

Initiate a selftest on the disk installed in slot A1 of the disk array identified by alias AUTORAID1.

drivetest -D A1 -s AUTORAID1 

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

drivetest was developed by HP.