JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
Sun Storage Archive Manager 5.3 Configuration and Administration Guide     Sun QFS and Sun Storage Archive Manager 5.3 Information Library
search filter icon
search icon

Document Information

Preface

1.  About SAM-QFS

2.  Configuring Storage Devices for Archiving

3.  Performing Additional SAM-QFS Configuration

4.  Creating Parameters Files for Network-Attached Automated Libraries

5.  Checking the Drive Order in Libraries

6.  Populating the Catalog

7.  Managing Automated Libraries and Manually Loaded Drives

8.  Managing Vendor-Specific Libraries

9.  About Archiving

10.  Configuring the Archiver

11.  Archive Directives (archiver.cmd)

12.  Archive Set Directives (archiver.cmd)

13.  Data Integrity Validation in SAM-QFS

About DIV

Minimum Hardware and Software Requirements for Using DIV in SAM-QFS

Configuring DIV in SAM-QFS

How to Configure DIV in SAM-QFS

Examples of Using DIV

Tape Verify (tpverify) Command

Tape Verify (tpverify) Command Return Values

14.  About Releasing

15.  Configuring the Stager

16.  Configuring the Recycler

17.  Advanced SAM-QFS Topics

18.  Using the Sun SAM-Remote Software

Tape Verify (tpverify) Command

The tpverify command uses the SCSI Verify command with the DIV/DADP feature of the StorageTek T10000C tape drive to verify media.

The tpverify command loads the specified volume into a tape drive and verifies it. If the device is not specified, then the volume is loaded into an available drive in the media changer. The SAM-QFS file system chooses the drive into which the volume is loaded. You can cancel a verify operation if the resource is needed. If the tpverify command is canceled, then the last verified position (LVPos) is saved in the catalog as the starting position for the next verify operation.


Note - A verify operation on a tape drive that is in the “on” state can be cancelled by the SAM-QFS archiver or stager if the resource is needed. Use a drive in the “unavail” state to avoid the verify operation cancellation by SAM-QFS.


The tpverify command can be used with a non-DIV tape drive as long as the tape drive supports the SCSI Verify command in fixed block with a block count of either 0x1000, 0x100, or 0xff. For example, the HP LTO-4 tape drives support the SCSI Verify command and a block count of 0xff. The SCSI Verify errors for the non-DIV tape drives are handled the same way as the DIV media errors, in that the tpverify command sets bad media and terminates the verify run. Check the /var/opt/SUNWsamfs/devlog/eqord file for failure details.

The following table shows the options that are available for the tpverify command.

Options
Description
-a
Overrides the last verified position saved in the catalog to start the verify operation from the first archive file on media.
-c
Cancels a running tpverify command operation.
-w
Waits for the operation to complete before terminating it.

For more information about the tape verify command, see the tpverify(1M) man page.

Tape Verify (tpverify) Command Return Values

The following table shows the return values for the tpverify command.

Return Values
Description
0
Success
249
Media error
250
Drive set to down
251
DIV error; bad media set
252
Drive needs cleaning
253
SAM-QFS canceled the verify operation
254
User canceled the verify operation
255
Verify failed

Example 13-4 Examples of Using the tpverify Command

The following examples show how to apply the tpverify command.

To load VSN CET050 into an available drive:

# tpverify ti.CET050

To load VSN CET048 into drive 31 and wait for the results:

# tpverify -w -a ti.CET048 31; echo $?

To cancel a verify run on VSN CET048 and wait for the results:

# tpverify -w -c ti.CET048 31; echo $?