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

14.  About Releasing

15.  Configuring the Stager

16.  Configuring the Recycler

About Recycling

Recycle Process

Planning for Recycling

Recycling Methods

Controlling Recycling

Starting the Recycler

Configuring Recycling on Removable Media Cartridges

Creating a recycler.cmd File

logfile Directive: Specifying a Log File

no_recycle Directive: Preventing Recycling

library Directive: Specifying Recycling for an Automated Library

-hwm Parameter

-mingain Parameter

-ignore Parameter

-mail Parameter

Creating a recycler.sh File

Configuring Recycling for Disk Archive Volumes

Editing the archiver.cmd File

Recycler Logging for Disk Archives

Recycling for Archive Copy Retention

17.  Advanced SAM-QFS Topics

18.  Using the Sun SAM-Remote Software

Configuring Recycling for Disk Archive Volumes

If you are archiving to disk, you must edit the archiver.cmd file to recycle.

If you are recycling by archive set, you must add archive set recycling directives between the params and endparams directives.

If you are recycling by library, this step is optional.

Editing the archiver.cmd File

To edit the archiver.cmd file, follow the steps described in About the archiver.cmd File.

As an alternative, you can edit the archiver.cmd file by using the File System Manager. For more information, see the File System Manager online help.

The following table shows the archive set recycling directives that you can use.

Table 16-3 Archive Set Recycling Directives

Directive
Function
-recycle_dataquantity size
Limits the amount of data the recycler schedules for re-archiving to clear a disk volume of useful data. By default, a limit is ignored for disk archive recycling.
-recycle_ignore
Prevents the archive set from being recycled.
-recycle_mailaddr mail-address
Sends recycler messages to the specified email address.
-recycle_mingain percent
Limits recycling of volumes in the archive set by setting the mingain mark for a disk volume. The mingain is expressed as a percentage of the expired data associated with the volume. When the expired data of the volume exceeds the mingain percentage, the recycler begins to recycle the volume. The default is 50%.
-recycle_minobs percent
Limits the recycler's selection of tar files in volume by setting a threshold for the recycler's rearchiving process of disk archive volumes. When the percentage of expired files within an archived tar file on the disk reaches this threshold, the recycler begins moving the current files from the archive into a new tar file. Once all the current files have been moved, the original tar file is marked as a candidate to be removed from the disk archive. The default is 50%.
-rearch_stage_copy copy-number
Sets staging for re-archiving to take place from selected (faster) copies.

For more information about archiver directives, see Chapter 10, Configuring the Archiver or the archiver.cmd(4) man page.

Recycler Logging for Disk Archives

Example 16-5 Recycler Log File for Disk Archive Files

---Archives---   -----Percent-----
 ----Status-----    Count    Bytes   Use Obsolete Free   Library:Type:VSN
new candidate          0      0        0    41     59  none:dk:disk01
677 files recycled from VSN disk01 (mars:/sam4/copy1)
0 directories recycled from VSN disk01 (mars:/sam4/copy1)