Contents

Title and Copyright Information

Preface

• Documentation Accessibility
• Prerequisites for Using this Document
• Conventions
• Available Documentation

1 Maintaining SAM-QFS Solutions

2 Monitoring File System Operations

• SAM-QFS Manager
• samu
• Log and Trace Files

3 Managing SAM-QFS File Systems

• Managing SAM-QFS File Systems
  • Administering File System Quotas
    • Characterize the Storage Requirements of Users, Groups, and Organizational Units
    • Create Admin Sets for Projects and for Directories Used by Multiple Groups
    • Configure a New File System to Use Quotas
    • Configure an Existing File System to Use Quotas
    • Set Quotas for Groups, Projects, Directories, and Users
    • Repair Inconsistent Quotas
    • Check Quotas
      • Monitor Quotas as the File-System Administrator
      • Monitor Your Own User Quota
    • Temporarily Extend or Cancel Grace Periods
      • Extending a Grace Period by a Specified Amount
      • Restarting the Grace Period
      • End a Grace Period Early
    • Stop New Resource Allocations
    • Remove the Quotas for a File System
  • Controlling Archiving and Staging Operations
    • Idle Archiving and Staging Processes
    • Stop Archiving and Staging Processes
    • Restart Archiving and Staging Processes
  • Renaming File Systems
    • Rename a File System
  • Repairing File Systems
    • Repair a File System
  • Adding Devices to File Systems
    • Add Devices to a Mounted File System
      • Finish Configuring New Devices Added to a Shared File System
    • Add Devices to an Unmounted File System
  • Removing Data Devices from a File System
    • Make Sure that File-System Metadata and Data are Backed Up
      • Run samexplorer
      • Create a Recovery Point File for the File System
    • Remove Devices from a Mounted High-Performance File System
• Managing SAM-QFS Shared File Systems
  • Mounting and Unmounting Shared File Systems
    • Mount a Shared File System
    • Unmount a Shared File System
  • Changing the Host Configuration of a Shared File System
    • Configuring Additional File System Clients
      • Add the Host Information to the Shared File System Configuration
      • Configure the Shared File System on a Solaris Client
      • Mount the Shared File System on a Solaris Host
      • Configure the Shared File System on a Linux Client Host
      • Mount the Shared File System on a Linux Client Host
    • Removing a Host from a Shared File System Configuration
      • Remove the Host from the File System Hosts File
    • Configuring Datamover Clients for Distributed Tape I/O
      • Configure the Datamover Client
    • Connecting Tape Drives Using Persistent Bindings
      • Update Persistent Bindings to Reflect Changes to the Hardware Configuration
      • Persistently Bind a New File System Host to Removable Media Devices
  • Switching from the Active Metadata Server to a Potential Metadata Server
    • Activate a Potential Metadata Server to Replace a Faulty Active Metadata Server
    • Activate a Potential Metadata Server to Replace a Healthy Active Metadata Server
  • Converting an Unshared File System to a Shared File System
    • Create a Hosts File on the Active and Potential Metadata Servers
    • Share the Unshared File System and Configure the Clients
    • Use Local Hosts Files to Route Network Communications
  • Converting a Shared File System to an Unshared File System
    • Convert a Shared Metadata Server to an Unshared System

4 Managing Files and Directories

• Setting SAM-QFS File Attributes
  • Restore Default File Attribute Values
  • Preallocate File-System Space
  • Specify Round-Robin or Striped Allocation for a File
  • Allocate File Storage on a Specified Stripe-Group Device
• Accommodating Large Files
  • Managing Disk Cache With Very Large Files
  • Segmenting Files
    • Segment a File
    • Stripe a Segmented File Across Multiple Volumes
  • Using Removable Media Files for Large Data Sets
    • Create a Removable Media or Volume Overflow File
    • Read a Foreign Tape Volume as a Removable Media File
• Working with Linear Tape File System (LTFS) Volumes
  • Importing LTFS Media Into the Library
  • Attaching LTFS Directories and Files to a SAM-QFS File System
    • Making LTFS Files Accessible On Demand
    • Making LTFS Files Immediately Accessible in the Disk Cache
  • Accessing LTFS Media Using SAM-QFS Software
    • Loading an LTFS Volume Into a Tape Drive and Mounting the LTFS File System
    • Unmounting an LTFS File System and Unloading the Volume from the Tape Drive
  • Managing LTFS Media Using SAM-QFS Software
    • Format a Volume as an LTFS File System
    • Erase LTFS Data and Remove LTFS Formatting and Partitions from a Volume
    • Check the Integrity of an LTFS File System
  • Displaying LTFS Configuration and Status Information
• Managing WORM Files
  • Understanding WORM File Systems
  • Activate WORM Retention for a File
  • Find and List WORM Files
• Managing Directories and Files in SMB/CIFS Shares
  • Managing Extended System Attributes in SMB/CIFS Shares
    • SAM-QFS Supported Extended System Attributes
    • Display Extended System Attributes
    • Modify Extended System Attributes
• Access Control Lists

5 Managing Libraries, Media, and Drives

• Managing Automated Media Libraries
  • Taking the Library On and Off Line
    • Take the Library Offline
    • Bring the Library Online
  • Importing and Exporting Removable Media
    • Import Removable Media Cartridges
    • Export Removable Media Cartridges
  • Maintaining Library Catalogs
    • View the Library Catalog
    • Audit the Contents of a Library Slot
    • Audit the Entire Direct-Attached Automated Library
    • Clear a Media Error from the Catalog
    • Managing the Historian Catalog
      • View the Historian Catalog
      • Add an Entry to the Historian Catalog
      • Remove an Entry from the Historian Catalog
      • Update Historian Information
  • Determining the Order in Which Drives are Installed in the Library
    • Gather Drive Information for the Library and the Solaris Host
    • Map the Drives in a Direct-Attached Library to Solaris Device Names
    • Map the Drives in an ACSLS-Attached Library to Solaris Device Names
• Managing Drives
  • Loading and Unloading Drives
    • Loading and Unloading Drives Installed in an Automated Library
      • Load a Drive from a Specified Library Location
      • Load a Drive with a Specified Media Type and Volume Serial Number
      • Unload a Specified Drive in the Library
    • Manually Loading and Unloading Standalone Drives
      • Load a Cartridge Into a Standalone Drive
      • Unload a Cartridge from a Standalone Drive
    • Notifying Operators When Volumes Must Be Loaded Manually
      • Enable Load Notification
  • Cleaning Tape Drives
    • Provide Sufficient Cleaning Cartridges
    • Enable Automatic Tape-Drive Cleaning (Recommended)
    • Clean a Tape Drive Manually
  • Using Drives With Encryption Capability
  • Handling Drive Problems
    • Taking the Drive Offline for Maintenance or Repair
    • Return Media to the Library Following a Drive Problem
      • Returning Media to a Library that Has Not Performed an Automatic Audit
      • Returning Media to a Library After an Automatic Audit
• Managing Removable Media
  • Labeling Removable Media
    • Generate Labels from Barcodes
    • Label a New Tape or Relabel an Existing Tape
    • Label a New Optical Disk or Relabel an Existing Optical Disk
  • Displaying Data Integrity Validation (DIV) Settings and Status
    • Display the DIV Setting
    • Monitor the Verify After Write Status of Archive Files
    • Monitor the Verify After Write Status of Devices
  • Verifying the Integrity of Tape Media
    • Verify the Data on a Tape Specified by Library Location
    • Verify the Data on a Tape Specified by Media Type and Volume Serial Number
    • Verify the Data on a Tape Using a Specified Drive
    • Restart Data Verification from the Start of the Tape
    • Verify ECC for All Blocks on a T10000C/D Tape
    • Verify ECC and DIV Checksums for All Blocks on a T10000C/D Tape
    • Rebuild the Media Information Region (MIR) of a T10000C/D Tape
    • Cancel Data Verification for a Specified Tape
    • Display the DIV Status and Verification Progress for a Tape
  • Managing Periodic Media Validation
    • View and Validate the verifyd.cmd Configuration File
    • Reload the verifyd.cmd Configuration File
    • Display All Defects Listed in the Periodic Media Verification Tape Defects Database
    • Display Defects Listed for a Particular Volume
    • Clear Defects Listed in the Periodic Media Verification Tape Defects Database

6 Backing Up the Configuration and File Systems

• Backing Up File Systems
  • Understanding Recovery Points and Archive Logs
  • Create a Recovery Point on Demand
  • Back Up the Archiver Log
• Backing Up the SAM-QFS Configuration
  • Manually Backup the SAM-QFS Configuration
• Gathering Configuration and Diagnostic Information with samexplorer
  • Run samexplorer

7 Migrating to New Storage Media

• Planning for Data Migration
  • Estimate Available Resources
  • Plan Post-Migration Disposition of Old Media
• Configuring the Archiving Process for Migration
  • Edit the archiver.cmd file
• Migrating Data to Replacement Media
  • Migrate Data from One Cartridge to Another

A Glossary of Equipment Types

• Recommended Equipment and Media Types
• Other Equipment and Media Types

B Media Status Flags

C Mount Options in a Shared File System

• Shared File System Mount Options
  • bg: Mounting in the Background
  • retry: Reattempting a File System Mount
  • shared: Declaring a SAM-QFS Shared File System
  • minallocsz and maxallocsz: Tuning Allocation Sizes
  • rdlease, wrlease, and aplease: Using Leases in a SAM-QFS Shared File System
  • mh_write: Enabling Multiple Host Reads and Writes
  • min_pool: Setting the Minimum Number of Concurrent Threads
  • meta_timeo: Retaining Cached Attributes
  • stripe: Specifying Striped Allocation
  • sync_meta: Specifying the Frequency With Which Metadata Is Written
  • worm_capable and def_retention: Enabling WORM Functionality

D Configuration Directives for Archiving

• Archiving Directives
  • Global Archiving Directives
    • archivemeta: Controlling Whether Metadata Is Archived
    • archmax: Controlling the Size of Archive Files
    • bufsize: Setting the Archiver Buffer Size
    • drives: Controlling the Number of Drives Used for Archiving
    • examine: Controlling Archive Scans
    • interval: Specifying an Archive Interval
    • logfile: Specifying an Archiver Log File
    • notify: Renaming the Event Notification Script
    • ovflmin: Controlling Volume Overflow
    • scanlist_squash: Controlling Scanlist Consolidation
    • setarchdone: Controlling the Setting of the archdone Flag
    • wait: Delaying Archiver Startup
  • File System Directives
    • fs: Specifying a File System
    • copy-number [archive-age]: Specifying Multiple Copies of File System Metadata
    • interval, logfile, scanlist as File System Directives
  • archive-set-name: the Archive Set Assignment Directive
    • Archive Copy Directives
  • Copy Parameters
  • Volume Serial Number (VSN) Pools Directives
  • Volume Serial Number (VSN) Association Directives
• Staging Directives
  • The stager.cmd File
    • drives: Specifying the Number of Drives for Staging
    • bufsize: Setting the Stage Buffer Size
    • logfile: Specifying a Staging Log File
    • maxactive: Specifying the Number of Stage Requests
    • copysel: Specifying the Copy Selection Order During Staging
• Preview Request Directives
  • Global Directives
    • vsn_priority: Adjusting Volume Priorities
    • age_priority: Adjusting Priorities for Time Spent Waiting in the Queue
  • Global and/or File System-Specific Directives
    • hwm_priority: Adjusting Priorities When the Disk Cache is Nearly Full
    • lwm_priority: Adjusting Priorities When the Disk Cache is Nearly Empty
    • lhwm_priority: Adjusting Priorities as the Disk Cache Fills
    • hlwm_priority: Adjusting Priorities as the Disk Cache Empties
  • Sample preview.cmd File

E Product Accessibility Features

Glossary

Index