HSM (SAM-QFS): How To Verify That Tapes Marked for Recycling Are Draining (Doc ID 1010050.1)

Last updated on AUGUST 02, 2023

Applies to:

Goal

The sam-recycler(1M) command invokes the recycler. The recycler marks all the current (valid) archive images that are present on a volume with the rearchive attribute.
The recycler also marks the selected archive volume with the recycle attribute. This prevents the archiver from writing any more archive images to the volume.

The archiver moves all the marked images to another volume. This operation is called "rearchiving" or for the recycler, it's called "draining".

After the archiver moved the current archives to other volumes, the sam-recycler(1M) can be run again, at which point it will find the old volume empty (i.e. it only contains obsolete archives) and will activate the script configured in /etc/opt/SUNWsamfs/scripts/recycler.sh  This script can be configured to issue a tplabel command to relabel the cartridge with its existing label. Relabeling has the effect of clearing all the expired archive images from the cartridges, thus enabling the archiver to re-use the cartridge. Labeling also clears the recycle bit in the VSN's catalog entry.

For more information on the recycler process, reference the 6.1 HSM and StorageTek QFS Software Maintenance and Administration Guide.

Solution