Sun Logo


Sun StorEdge SAM-FS Storage and Archive Management Guide

Version 4, Update 4

819-2755-10



Contents

Tables

Preface

1. Overview

Capabilities

Storage Devices

File System Manager

procedure iconsmall spaceTo Invoke the File System Manager

Creating Additional Administrator and User Accounts

procedure iconsmall spaceTo Create Additional Administrator Accounts

procedure iconsmall spaceTo Create Additional Guest Accounts

Managing Additional Servers from the File System Manager

2. Using Automated Libraries and Manually Loaded Drives

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

Tape Drive Auto-Cleaning

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. Archiving

Archiving Process Overview

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

About 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

Using Archiver 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 and -nftv

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

Using -release and -norelease Together

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 path

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

About Disk Archiving

Configuration Guidelines

Directives for Disk Archiving

procedure iconsmall spaceTo Enable Disk Archiving

Disk Archiving Examples

Example 1

Example 2

Example 3

Planning Archiving Operations

The Preview Queue

Archiver Examples

Example 1

Example 2

Example 3

Example 4

4. Releasing

Releasing Process Overview

Theory of Operation

Definitions

Age

Candidate

Priority

Weight

Partial release

About Partial Releasing and Partial Staging

System Administrator Option Summary

User Option Summary

About the releaser.cmd File

Specifying Age-Related and Size-Related Release Priority Directives

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

Planning Releaser Operations

Running the Releaser Manually

5. Staging

About 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

Global VSN and Age Directives

Global or File System Specific Watermark Directives

Calculating Total Preview Request Priority

Setting 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

6. Recycling

Recycling Process Overview

Using 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

Planning Recycling Operations

procedure iconsmall spaceStep 1: Creating a recycler.cmd File

Example recycler.cmd File

procedure iconsmall spaceStep 2: Editing the archiver.cmd File

procedure iconsmall spaceStep 3: Running the Recycler

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

procedure iconsmall spaceStep 5: Removing -recycle_ignore and ignore Parameters

procedure iconsmall spaceStep 6: Creating a recycler.sh File

7. Using the Sun SAM-Remote Software

Sun SAM-Remote Software Overview

Features

Requirements

Limitations

Technical Overview

Sun SAM-Remote Server Overview

Sun SAM-Remote Client Overview

Interaction Between the Sun SAM-Remote Server and the Sun SAM-Remote Client

Library Catalogs

Archiving

Configuring the Sun SAM-Remote Software

Example Configuration

Configuring the Software

procedure iconsmall spaceTo Log In to the Potential Server and Client Hosts

procedure iconsmall spaceTo Verify Client and Server Configurations

procedure iconsmall spaceTo Edit the mcf Files

procedure iconsmall spaceTo Define a Sun SAM-Remote Client

procedure iconsmall spaceTo Define a Sun SAM-Remote Server in the Server's mcf File

procedure iconsmall spaceTo Create the Sun SAM-Remote Server Configuration File

procedure iconsmall spaceTo Enable Archiving

Recycling with the Sun SAM-Remote Software

Recycling in a Sun SAM-Remote Environment--Method 1

Configuration Files for Server sky

Configuration Files for Client zeke

procedure iconsmall spaceTo Configure Recycling--Method 1

procedure iconsmall spaceTo Recycle no-data VSNs

procedure iconsmall spaceTo Recycle partially full VSNs

Recycling in a Sun SAM-Remote Environment--Method 2

procedure iconsmall spaceTo Configure Recycling--Method 2

8. Advanced Topics

Using 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

Using Removable Media Files

procedure iconsmall spaceTo Create a Removable Media or Volume Overflow File

Using Segmented Files

Archiving

Disaster Recovery

Using System Error Facility Reporting

procedure iconsmall spaceTo Enable SEF Reporting

SEF Report Output

procedure iconsmall spaceTo Generate SEF Output

Managing the SEF Log File

SEF sysevent Functionality

procedure iconsmall spaceTo Create a SEF sysevent Handler

A. 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

Glossary

Index