unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



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




				    - 1 -	  Formatted:  August 2, 2006






 drivetest(1M)						       drivetest(1M)




    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, <&lt&lt&lt;Additional Error Info>&gt&gt&gt;:
      <&lt&lt&lt;Error Info Decode>&gt&gt&gt;
	   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.



				    - 2 -	  Formatted:  August 2, 2006






 drivetest(1M)						       drivetest(1M)




 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.




				    - 3 -	  Formatted:  August 2, 2006






 drivetest(1M)						       drivetest(1M)




      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.

 SEE ALSO
      ARMServer(1M), arraycfg(1M), arraydsp(1M), arrayfmt(1M), arraylog(1M),
      arraymgr(1M), arrayrbld(1M), arrayrecover(1M), dteststat(1M),
      download(1M), logprint(1M).










































				    - 4 -	  Formatted:  August 2, 2006