Skip Navigation Links
Sun Storage Archive Manager 5.3 Configuration and Administration Guide
Sun QFS and Sun Storage Archive Manager 5.3 Information Library
Search Scope:
This Document
Entire Library
Sun Storage Archive Manager 5.3 Configuration and Administration Guide
June 2012
Sun Storage Archive Manager 5.3 Configuration and Administration Guide
Document Information
Preface
1. About SAM-QFS
Components of SAM-QFS
Archiving
Releasing
Staging
Recycling
Supported Storage Devices
SAM-Remote Software
2. Configuring Storage Devices for Archiving
Task Map: Configuring Storage Devices for Archiving
Adding Tape Devices for Archiving
Files that Contain Configuration Information
How to Add Tape Devices for Archiving (Command Line)
How to Add Tape Drive Interface Target IDs and LUNs for Archiving (Command Line)
How to Add Tape Devices for Archiving (SAM-QFS Manager)
Adding Libraries or Magneto-Optical Drives for Archiving
How to Configure Device Support in SCSI or FC Environments Using SAM-QFS Manager
How to Configure Device Support for a Direct-Attached Library
Recovering After a Direct-Attached Library Fails to Initialize
Verifying and Implementing Configurations
How to Verify That All Devices Are Configured and Implement the Changes
Handling Errors in the
st.conf
File
3. Performing Additional SAM-QFS Configuration
Sharing the File System With NFS Client Systems
How to NFS Share the File System
How to Mount the File System on Clients
Editing the
defaults.conf
File
Features You Can Control From
defaults.conf
Barcodes
Drive Timing Values
How to Customize Default Values
Configuring the Remote Notification Facility
How to Enable Remote Notification
How to Disable Remote Notification
Adding the Administrator Group
How to Add the Administrator Group
How to Enable System Logging
Configuring Other Sun Storage Products
4. Creating Parameters Files for Network-Attached Automated Libraries
Creating Parameters Files for Network-Attached Automated Libraries
How to Create a Parameters File for Network-Attached Automated Libraries
Configuring a StorageTek ACSLS-Attached Automated Library Parameters File
Configuring an ADIC/Grau Automated Library Parameters File
Configuring an IBM 3494 Automated Library Parameters File
Configuring a Sony Network-Attached Automated Library Parameters File
About Shared Drives
5. Checking the Drive Order in Libraries
Checking the Drive Order in Libraries
How to Check the Drive Order of Libraries With a Front Panel
How to Check the Drive Order of a Tape Library Without a Front Panel
How to Check the Drive Order of Magneto-Optical Libraries Without a Front Panel
How to Check the Drive Order of Network-Attached Libraries
6. Populating the Catalog
Populating the Catalog
How to Populate an Automated Library With Many Volumes
How to Populate an Automated Library With a Small Number of Volumes
How to Populate an IBM 3494 Automated Library
How to Populate a StorageTek ACSLS-Attached Library Quickly
StorageTek ACSLS-Attached Automated Libraries: Common Problems and Error Messages
StorageTek ACSLS Parameters File Errors
StorageTek ACSLS Library Errors
VSN Import Errors
7. Managing Automated Libraries and Manually Loaded Drives
Vendor-Specific Library Operational Procedures
How to Start Removable Media Operations
How to Stop Removable Media Operations
How to Turn On an Automated Library
How to Turn Off an Automated Library
How to Load a Cartridge Manually
How to Unload a Cartridge Manually
Labeling and Unlabeling Cartridges
How to Label or Relabel a Tape
How to Label or Relabel an Optical Disc
How to Audit a Volume
How to Audit a Direct Attached Automated Library
Using a Cleaning Cartridge
How to Use a Cleaning Cartridge With a Barcode
How to Use a Cleaning Cartridge Without a Barcode
How to Reset the Number of Cleaning Cycles
How to Limit the Number of Cleaning Cycles
How to Clean a Tape Drive Automatically
How to Clean a Tape Drive Manually
How to Clear Media Errors
How to Remove a Stuck Cartridge From a Drive
Catalog Operations, Importing Cartridges, and Exporting Cartridges
Tracking Exported Media - The Historian
About Importing and Exporting From an Automated Library
How to Import a Cartridge From a Library With a Mailbox
How to Export a Cartridge From a Library With a Mailbox
How to Import a Cartridge From a Library Without a Mailbox
How to Export a Cartridge From a Library Without a Mailbox
How to Enable Load Notification
Using Drives With Encryption Capability
Manually Loaded Drive Operations
How to Load a Cartridge Into a Manually Loaded Device
How to Unload a Cartridge
How To View a Library Catalog
8. Managing Vendor-Specific Libraries
StorageTek ACSLS-Attached Automated Libraries
How to Import Tapes
How to Export Tapes Using a Mailbox
ADIC/Grau Automated Libraries
How to Import a Cartridge
How to Export a Cartridge
IBM 3584 UltraScalable Tape Libraries
Importing Cartridges
Cleaning Drives
Partitioning
How To Remove a Cartridge From a Logical Library
IBM 3494 Libraries
How to Import a Cartridge
How to Export a Cartridge
Sony Direct-Attached 8400 PetaSite Automated Libraries
How to Import Tapes
How to Export a Tape Without Using Mailbox Slots as Storage Slots
How to Export a Tape Using Mailbox Slots as Storage Slots
How to Move a Cartridge to a Different Slot
Sony Network-Attached Automated Libraries
How to Import a Cartridge
How to Export a Cartridge
9. About Archiving
Planning Archiving Operations
Preview Queue
Archiver Daemons
Archiving Operations
Step 1: Identifying Files to Archive
Continuous Archiving
Scanned Archiving
Step 2: Composing Archive Requests
Step 3: Scheduling Archive Requests
Drive Usage
Volume Usage
Step 4: Archiving the Files in an Archive Request
Sample Default Output From the
archiver -l
Command
Log Files and Event Logging for Archive Operations
Data Verification
10. Configuring the Archiver
About the
archiver.cmd
File
Archive Directives
Archive Set Directives
How to Create an
archiver.cmd
File Using the Command Line
How to Create an
archiver.cmd
File Using SAM-QFS Manager
Examples of
archiver.cmd
Files
About Disk Archiving
About the
diskvols.conf
File
Disk Archiving Directives
Archive Set Copy Parameters Exceptions
Archive Directives Exceptions
Recycling Directives Exceptions
vsn
Directives
clients
and
endclients
Directives
-
recycle minobs
Recycler Directive
How to Enable Disk Archiving on the Client Host
How to Configure Disk Archiving on the Server Host
How to Enable Disk Archiving
Disk Archiving Examples
Example 1
Example 2
Example 3
11. Archive Directives (
archiver.cmd
)
Global Archiving Directives
archivemeta
Directive: Controlling Whether Metadata Is Archived
archmax
Directive: Controlling the Size of Archive Files
bufsize
Directive: Setting the Archiver Buffer Size
drives
Directive: Controlling the Number of Drives Used for Archiving
examine
Directive: Controlling Archive Scans
interval
Directive: Specifying an Archive Interval
logfile
Directive: Specifying an Archiver Log File
notify
Directive: Renaming the Event Notification Script
ovflmin
Directive: Controlling Volume Overflow
Examples of Volume Overflow
scanlist_squash
Directive: Controlling Scanlist Consolidation
setarchdone
Directive: Controlling the Setting of the
archdone
Flag
wait
Directive: Delaying Archiver Startup
File System Directives
fs
Directive: Specifying the File System
Global Directives as File System Directives
Archive Copy Directives
-release
Directive: Releasing Disk Space After Archiving
-norelease
Directive: Delaying Disk Space Release
Using
-release
and
-norelease
Together
Setting the Archive Age
Unarchiving Automatically
Specifying More Than One Copy for Metadata
12. Archive Set Directives (archiver.cmd)
About Archive Set Directives
Archive Set Assignment Directive
File Age
search-criterion
Arguments:
-access
and
-nftv
File Age
search-criterion
Arguments:
-after
File Size
search-criterion
Arguments:
-minsize
and
-maxsize
Owner and Group
search-criterion
Arguments:
-user
and
-group
File Name
search-criterion
Arguments Using Pattern Matching:
-name
regex
Release and Stage
file-attributes
Argument:
-release
and
-stage
Membership Conflicts in Archive Sets
Archive Set Copy Parameters
Controlling the Size of Archive Files:
-archmax
Parameter
Setting the Archiver Buffer Size:
-bufsize
Parameter
Specifying the Number of Drives for an Archive Request:
-drivemax
,
-drivemin
, and
-drives
Maximizing Space on a Volume:
-fillvsns
Parameter
Specifying Archive Buffer Locks:
-lock
Parameter
Making Archive Copies of Offline Files:
-offline_copy
Parameter
Specifying Recycling
Sorting Archive Files:
-sort
and
-rsort
Parameters
Controlling Unarchiving
Controlling How Archive Files Are Written:
-tapenonstop
Parameter
Reserving Volumes:
-reserve
Parameter
Setting Archive Priorities:
-priority
Parameter
Scheduling Archiving: -
startage
,
-startcount
, and
-startsize
Parameters
VSN Association Directives
VSN Pools Directives
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
Releaser Process
Releaser Concepts
Age
Candidate
Priority
Weight
Partial Release
About Partial Releasing and Partial Staging
Summary of System Administrator Options
Summary of User Options
15. Configuring the Stager
About Staging
About the
stager.cmd
File
How to Create a
stager.cmd
File
drives
Directive: Specifying the Number of Drives for Staging
bufsize
Directive: Setting the Stage Buffer Size
logfile
Directive: Specifying a Log File
maxactive
Directive: Specifying the Number of Stage Requests
Archive Set Assignment Directive: Specifying Stage Attributes for All Files in an Archive Set
copysel
Directive: Specifying the Copy Sequence for Staging
Prioritizing Preview Requests
About the
preview.cmd
File
How to Set the Global VSN and Age Priority Directives
How to Set Global or File System-Specific Water Mark Directives
Setting Up a Preview Request Priority Scheme
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
Using Device Logging
When to Use the Device Log
How to Enable the Device Log by Using the
samset
Command
How to Enable the Device Log by Editing the
defaults.conf
File
Using Removable Media Files
Creating a Removable Media or Volume Overflow File
Using Segmented Files
Archiving Segmented File
Using System Error Facility Reporting
How to Enable SEF Reporting
How to Generate SEF Report Output
Managing the SEF Log File
SEF
sysevent
Functionality
How to Create the SEF
sysevent
Handler
18. Using the Sun SAM-Remote Software
Sun SAM-Remote Software Overview
System Requirements
Software Limitations
Client and Server Interactions
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
Data Integrity Validation in Sun SAM-Remote Software
Configuring the Sun SAM-Remote Software
Step 1: Log In to the Potential Server and Client Hosts
Step 2: Verify Client and Server Software
Step 3: Edit the
mcf
Files on Each Client
Step 4: Create a Sun SAM-Remote Client Configuration File
Step 5: Edit the Server's
mcf
File
Step 6: Create the Server's Configuration File
Step 7: Enable Archiving
Recycling With the Sun SAM-Remote Software
Recycling in a Sun SAM-Remote Environment (Method 1)
Configuration Files for the Server
Configuration Files for Clients
How to Configure Recycling (Method 1)
Examples for How to Configure Recycling (Method 1)
How to Recycle
no-data
VSNs
How to Recycle
partially full
VSNs
Recycling in a Sun SAM-Remote Environment (Method 2)
How To Configure Recycling (Method 2)