test

SunVTS 5.0 Test Reference Manual

Chapter 57 Tape Drive Test (tapetest)

The tapetest synchronous I/O test writes a pattern to a specified number of blocks (or, for a SCSI tape, writes to the end of the tape). The tapetest then rewinds the tape and reads and compares the data just written. The tapetest asynchronous I/O test sends a series of up to five asynchronous read/write requests to the tape drive, writing to the tape and then reading and comparing the data. The terms asynchronous and synchronous referred to here, and in the "method" field are not related to the scsi messaging terms of the same name. The tapetest file test writes four files to the tape and then reads them back, comparing the data. For tape library testing, the pass count is incremented only after all tapes in the library have been tested. The read/write algorithms fare enhanced for DLT tape by using a random data pattern (1.5:1 compression) and a more robust read compare algorithm. Some default parameters have also changed.

tapetest Test Requirements

If you have a tape drive in your system, load a blank writable tape (scratch tape) before you start SunVTS. If you fail to do this, the tapetest option may display drive type:unknown on the option menu for the tapetest.

tapetest Options

To reach the dialog box below, right-click on the test name in the System Map and select Test Parameter Options. If you do not see this test in the System Map, you might need to expand the collapsed groups, or your system may not include the device appropriate to this test. Refer to the SunVTS User's Guide for more details.

tapetest supports 4-mm, 8-mm, DLT, 1/4-inch cartridge, and 1/2-inch front-load tape drive testing. The options available for each of the tape devices differ slightly. An example of the Options dialog box for a device is shown in Figure 57-1.

The Async I/O subtest uses the asynchronous read and write feature of the Solaris tape driver to exercise tape drives. In read-only mode the test sends a maximum of four asynchronous read packets, each with a random size and a random offset, to the tape drive. The test then waits for all outstanding I/O activity to complete before issuing another round of packets. This process continues until the whole area being tested has been covered. In read-write mode, one write packet is issued for every four read packets to ensure a spot check of the write operation. The area of the tape to be tested is written to first in order for the test to work correctly. This test is only supported under the Solaris 2.6, Solaris 7, and Solaris 8 operating environments and compatible releases.

Figure 57-1 tapetet Test Parameter Options Dialog Box (4-mm Tape Drive)

Graphic

Note -

This test does not immediately stop after being disabled.

Note -

Selecting non-default options can significantly increase the run time for the test.

Note -

The Options dialog box for the 1/4-inch, 1/2-inch, DLT, and 8-mm tape drives differ slightly from Figure 57-1.

Table 57-1 tapetest Options

tapetest Options

Description 

Type 

Normal tape drive or tape library (stacker). 

# of Tapes 

The number of tapes in the tape library. tapetest registers a single tape library pass only after all tapes in the library pass.

Density 

The following settings are available for most tape drives: 

  • Low--Tests the l tape device.

  • Medium--Tests the m tape device.

  • Compression--Tests the c tape device.

  • All--Tests the l, m, and c tape devices.

 

For half-inch tape drives, the available settings are 800, 1600, and 6250 BPI (blocks per inch). 

 

For certain QIC drives, select QIC-11 (1-byte block ID) mode, QIC-24 (4-byte block ID) mode, or Both.

 

Note: On a DLT drive, the l and m settings both use no compression. tapetest does not support changing DLT capacity settings indicated on the front panel. 

Mode 

If you enable Write/Read mode, the test first writes to the tape and then reads it back to compare. If you enable Read_Only mode, the test assumes the tape has been properly written and merely reads and compares. This mode is useful to check proper head alignment. 

 

Note: If a read only pass is attempted and the tape was not previously written by tapetest, using the same test parameters currently set, a "Big Read Failure" will occur.  

Length 

The amount of the tape to be tested. The choices are: 

  • EOT: The default; tests to the entire tape.

  • Long: The SCSI tape tests 70,000 blocks of the tape.

  • Short: Only the first 1000 blocks are tested.

  • Specified: You must type the number of blocks to be tested in the # of blocks field.

# of Blocks 

If you select Specified under the Length option, you must type the number of blocks you want to test. 

Blocksize 

Block size specification. This option is only available for Tandberg QIC tape drives. There are two possible values. 512-bytes is for use with older tape media that have transfer size restrictions, while 64-kbytes is for use with current, high-capacity tape media. 

 

Note1: This option is only available in command line interface mode. 

 

Note2: With patches 110278-01 or 110211-01 applied, DLT writes either a 512 byte or 65536 byte block depending on how this parameter is set. 

File Test 

The tape file test sequence is as follows: 

  1. Writes three files.

  2. Rewinds.

  3. Reads part of the first file.

  4. Forward spaces to the start of the second file.

  5. Reads the second file.

  6. Forward spaces to the start of the third file.

  7. Tries to read to the end of that file for SCSI tapes only. The tape file test tries to backspace to the start of the second file and read it.

Retension 

When enable is selected, the program retensions the tape. 

Media Test Method 

  • Sync I/O--tapetest reads and or writes the number of blocks selected in Length.

  • Async I/O--tapetest makes four asynchronous read requests to the tape drive. If read and write testing is selected, one asynchronous write request is also sent. The test continues after completing the requests.

 

Note - When testing Tandberg QIC drives, Async I/O testing is restricted to read-only due to asynchronous behavior differences with other tape drives. 

 

Note: This option is not associated with the synchronous data transfer request SCSI message. It is only synchronous or asynchronous in nature because the numbers of reads and writes are not synchronous to each other.The SDTR message is not invoked. 

tapetest Test Modes

The tapetest supports all three modes. It performs different test schemes on the tape device, according to the mode you select.

Table 57-2 tapetest Test Modes

Test Mode 

Supported? 

Description 

Connection 

Yes 

tapetest verifies that the drive can be opened and that the drive type can be determined. If both checks are successful, or if the drive is currently busy, then the test passes. The tapetest fails if the open operation is unsuccessful for any reason other than the drive is busy.

Functional 

(Offline) 

Yes 

tapetest checks the status, rewinds the tape, erases and retensions it. If the device is a cartridge tape, tapetest writes a pattern to nblks or eot (default), rewinds the tape, and then reads and compares of the pattern. On the other hand, if the device is busy or if no tape cartridge can be found in the drive, the test cannot run and fails.

tapetest Command-Line Syntax

/opt/SUNWvts/bin/tapetest standard_arguments -o dev=device_name, s=block_count,d=density,m=mode,l=length,method=method,ft=enables|disables, ret=enables|disables,dat=dat_type,8mm=8mm_type,num=magazine_size, blocksize=block_size

Table 57-3 tapetest Command-Line Syntax

Argument 

Explanation 

dev=device_name

Specifies the device_name of the tape drive (required).

s=block_count

Specifies the number of blocks to be tested. 

d=density

Specifies the density of the tape to open. 

m=mode

Enables either the Write_Read or Read_Only tests. 

l=length

Specifies the length of the test (EOT, Specified, Long, or Short). 

method=method

Specifies the media test method (SyncI/O and or AsyncI/O) used. 

 

Note: This option does not invoke the SCSI message "synchronous data transfer request. It is only asynchronous or synchronous in nature. 

ft=enables|disables

Enables or disables the File test. 

ret=enables|disables

Enable or disables tape retension. 

dat=dat_type

If you are testing a digital audio tape drive, specify whether it is a regular DAT drive or a DAT stacker. The choices are DAT and DAT_Stacker.

8mm=8mm_type

If you are testing an 8-mm tape drive, specify whether it is a regular 8-mm tape drive or a tape library. The command line choices are 8mm and 8mm_Library.

num=magazine_size

If you are testing a tape library, specify the magazine size. 

blocksize= block_size

This option is only available on a Tandberg QIC drive and DLT drives. Specify whether to use a 64 kbyte block transfer or a 512 byte block transfer. Use 512 bytes when testing older media in the drive. DLT supports 512 byte and 65536 byte modes 

Note -

64-bit tests are located in the sparcv9 subdirectory: /opt/SUNWvts/bin/sparcv9/testname. If a test is not present in this directory, then it may only be available as a 32-bit test. For more information refer to "32-Bit and 64-Bit Tests".