Sun Logo


Sun StorEdge SAM-FS Storage and Archive Management Guide

Release 4.1

817-4093-10



Contents

Preface

How This Book Is Organized

Using UNIX Commands

Shell Prompts

Typographic Conventions

Related Documentation

Accessing Sun Documentation Online

Third-Party Web Sites

Contacting Sun Technical Support

Licensing

Diagnostics

Installation Assistance

Sun Welcomes Your Comments

1. Overview

Capabilities

Archiving

Releasing

Staging

Recycling

Storage Devices

Commands

User Commands

General System Administrator Commands

File System Commands

Automated Library Commands

Archiver Commands

Specialized Maintenance Commands

Site-Customizable Scripts

Application Programming Interface

Operational Utilities

2. Using Automated Libraries and Manually Loaded Drives in a Sun StorEdge SAM-FS Environment

Conventions

Command Arguments

Terminology

Automated Library Operations

procedure iconsmall spaceTo Stop Removable Media Operations

procedure iconsmall spaceTo Start Removable Media Operations

procedure iconsmall spaceTo Turn On an Automated Library

procedure iconsmall spaceTo Turn Off an Automated Library

procedure iconsmall spaceTo Load a Cartridge Into an Automated Library

procedure iconsmall spaceTo Unload a Cartridge From a Drive

Labeling a Cartridge

procedure iconsmall spaceTo Label or Relabel a Tape

procedure iconsmall spaceTo Label or Relabel an Optical Disk

procedure iconsmall spaceTo Audit a Volume

procedure iconsmall spaceTo Audit an Automated Library (Direct-Attached Only)

Using a Cleaning Cartridge

procedure iconsmall spaceTo Reset the Number of Cleaning Cycles

procedure iconsmall spaceTo Use a Cleaning Cartridge With a Barcode

procedure iconsmall spaceTo Use a Cleaning Cartridge Without a Barcode

procedure iconsmall spaceTo Clean a Tape Drive

procedure iconsmall spaceTo Clear Media Errors

procedure iconsmall spaceTo Remove a Stuck Cartridge From a Drive

Catalog Operations, Importing Cartridges, and Exporting Cartridges

Tracking Exported Media -- The Historian

Importing and Exporting from an Automated Library

procedure iconsmall spaceTo Import a Cartridge from a Library With a Mailbox

procedure iconsmall spaceTo Export a Cartridge from a Library With a Mailbox

procedure iconsmall spaceTo Import a Cartridge from a Library Without a Mailbox

procedure iconsmall spaceTo Export a Cartridge from a Library Without a Mailbox

procedure iconsmall spaceTo Enable Load Notification

Manually Loaded Drive Operations

procedure iconsmall spaceTo Load a Cartridge

procedure iconsmall spaceTo Unload a Cartridge

procedure iconsmall spaceTo View a Library Catalog

3. Basic Operations for Libraries With Vendor-Specific Operational Procedures

ADIC/Grau Automated Libraries

procedure iconsmall spaceTo Import a Cartridge

procedure iconsmall spaceTo Export a Cartridge

Fujitsu LMF Automated Libraries

procedure iconsmall spaceTo Import a Cartridge

procedure iconsmall spaceTo Export a Cartridge

IBM 3584 UltraScalable Tape Libraries

Importing Cartridges

Cleaning Drives

Partitioning

procedure iconsmall spaceTo Remove a Cartridge

IBM 3494 Libraries

procedure iconsmall spaceTo Import a Cartridge

procedure iconsmall spaceTo Export a Cartridge

Sony Direct-Attached 8400 PetaSite Automated Libraries

procedure iconsmall spaceTo Import Tapes

Exporting Tapes

procedure iconsmall spaceTo Export a Tape Without Using the Mailbox Slots as Storage Slots

procedure iconsmall spaceTo Export a Tape Using Mailbox Slots as Storage Slots

procedure iconsmall spaceHow to Move a Cartridge to a Different Slot

Sony Network-Attached Automated Libraries

procedure iconsmall spaceTo Import a Cartridge

procedure iconsmall spaceTo Export a Cartridge

StorageTek ACSLS-Attached Automated Libraries

procedure iconsmall spaceTo Import Tapes

procedure iconsmall spaceTo Export Tapes Using a Mailbox

4. Archiving

Archiver - Theory of Operations

Archive Sets

Archiving Operations

Step 1: Identifying Files to Archive

Step 2: Composing Archive Requests

Step 3: Scheduling Archive Requests

Step 4: Archiving the Files in an Archive Request

Sample Default Output

Archiver Daemons

Archive Log Files and Event Logging

The archiver.cmd File

procedure iconsmall spaceTo Create or Modify an archiver.cmd File and Propagate Your Changes

The archiver.cmd File

An archiver.cmd File Example

The archiver.cmd Directives

Global Archiving Directives

The archivemeta Directive: Controlling Whether Metadata is Archived

The archmax Directive: Controlling the Size of Archive Files

The bufsize Directive: Setting the Archiver Buffer Size

The drives Directive: Controlling the Number of Drives Used for Archiving

The examine Directive: Controlling Archive Scans

The interval Directive: Specifying an Archive Interval

The logfile Directive: Specifying An Archiver Log File

procedure iconsmall spaceTo Back Up an Archiver Log File

The notify Directive: Renaming the Event Notification Script

The ovflmin Directive: Controlling Volume Overflow

The wait Directive: Delaying Archiver Startup

File System Directives

The fs Directive: Specifying the File System

Other File System Directives

Archive Set Assignment Directive

Assigning Archive Sets

File Size search_criteria: -access

File Size search_criteria: -minsize and -maxsize

Owner and Group search_criteria: -user and -group

File Name search_criteria Using Pattern Matching: -name regex

Release and Stage file_attributes: -release and -stage

Archive Set Membership Conflicts

Archive Copy Directives

Releasing Disk Space After Archiving: -release

Delaying Disk Space Release: -norelease

Setting the Archive Age

Unarchiving Automatically

Specifying More Than One Copy for Metadata

Archive Set Copy Parameters

Controlling the Size of Archive Files: -archmax

Setting the Archiver Buffer Size: -bufsize

Specifying the Number of Drives for an Archive Request: -drivemax, -drivemin, and -drives

Maximizing Space on a Volume: -fillvsns

Specifying Archive Buffer Locks: -lock

Making Archive Copies of Offline Files: -offline_copy

Specifying Recycling

Associative Archiving: -join

Controlling Unarchiving

Controlling How Archive Files are Written: -tapenonstop

Reserving Volumes: -reserve

Setting Archive Priorities: -priority

Scheduling Archiving: -startage, -startcount, and -startsize

VSN Association Directives

VSN Pools Directives

Disk Archiving

Configuration Guidelines

Directives for Disk Archiving

procedure iconsmall spaceTo Enable Disk Archiving

Disk Archiving Examples

Example 1

Example 2

Example 3

Archiver Examples

Example 1

Example 2

Example 3

Example 4

Archiver Guidelines

Troubleshooting the Archiver

Why Files Are Not Archiving

Additional Archiver Diagnostics

Why Files Are Not Releasing

5. Releasing

Releaser Overview

Theory of Operation

Definitions

Age

Candidate

Priority

Weight

Partial release

Partial Release and Partial Stage

System Administrator Option Summary

User Option Summary

The releaser.cmd File

Specifying Age-Related and Size-Related Release Priority Directives: weight_age, weight_age_access, weight_age_modification, and weight_age_residence

File Age

File Size

Specifying Directives for Individual File Systems: fs

Specifying Debugging Directives: no_release and display_all_candidates

Specifying a Minimum Residence Time: min_residence_age

Specifying a Log File: logfile

Inhibiting Releasing for Rearchived Files: rearch_no_release

Adjusting the size of the Releaser Candidate List: list_size

The archiver.cmd File's Role in Releasing

Configuring the Releaser

Running the Releaser Manually

Troubleshooting the Releaser

6. Staging

The stager.cmd File

procedure iconsmall spaceTo Create or Modify a stager.cmd File and Propagate Your Changes

Specifying the Number of Drives

Setting the Stage Buffer Size

Specifying a Log File

Specifying the Number of Stage Requests

Example stager.cmd File

The archiver.cmd File's Role in Staging

Prioritizing Preview Requests Using the preview.cmd File

VSN and Age Directives (Global)

Watermark Directives (Global or File System Specific)

Calculating Total Preview Request Priority

How to Set Up a Preview Request Priority Scheme

Example 1: Enforcing Stage Requests

Example 2: Enforcing Archive Requests

Example 3: Prioritizing Requests by Media

Example 4: Complex Prioritization

7. Recycling

Recycler Overview

Recycling Directives

Specifying a Log File: the logfile Directive

Preventing Recycling: the no_recycle Directive

Specifying Recycling for an Entire Automated Library: the Library Directive

Configuring the Recycler

procedure iconsmall spaceStep 1: Creating a recycler.cmd File (Optional)

Example recycler.cmd File

procedure iconsmall spaceStep 2: Editing the archiver.cmd File (Optional)

procedure iconsmall spaceStep 3: Running the Recycler

procedure iconsmall spaceStep 4: Creating a crontab File for the Recycler (Optional)

procedure iconsmall spaceStep 5: Removing -recycle_ignore and ignore Parameters

procedure iconsmall spaceStep 6: Creating a recycler.sh File (Optional)

Troubleshooting the Recycler

8. Upgrading the Hardware in Your Environment

Adding Slots in an Automated Library

procedure iconsmall spaceTo Add Slots In a Library

Upgrading or Replacing a Library

procedure iconsmall spaceTo Replace or Upgrade a Library

Upgrading DLT Tape Drives

procedure iconsmall spaceTo Upgrade Tape Drives

9. Advanced Topics

Device Logging

When to Use the Device Log

Enabling the Device Log

procedure iconsmall spaceTo Enable the Device Log By Using the samset(1M) Command

procedure iconsmall spaceTo Enable the Device Log by Editing the defaults.conf File

Removable Media Files

procedure iconsmall spaceTo Create a Removable Media or Volume Overflow File

Segmented Files

Archiving

Disaster Recovery

System Error Facility Reporting

procedure iconsmall spaceTo Enable SEF Reporting

SEF Report Output

procedure iconsmall spaceTo Generate SEF Output

Managing the SEF Log File

Glossary