Contents

Title and Copyright Information

Preface

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

1 Maintaining Oracle HSM Solutions

2 Monitoring File System Operations

• Oracle HSM Manager
• samu
• Log and Trace Files

3 Managing Oracle HSM File Systems

• Managing Oracle HSM 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
    • Enable Quotas on New File Systems
    • Enable Quotas on Existing File Systems
    • 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
      • Extend a Grace Period by a Specified Amount
      • Restart 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 Oracle HSM 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 a 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 Oracle HSM 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
• Using Extended File Attributes
• 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 an Oracle HSM File System
    • Making LTFS Files Accessible On Demand
    • Making LTFS Files Immediately Accessible in the Disk Cache
  • Accessing LTFS Media Using Oracle HSM Software
    • Load an LTFS Volume Into a Tape Drive and Mount the LTFS File System
    • Unmount an LTFS File System and Unload the Volume from the Tape Drive
  • Managing LTFS Media Using Oracle HSM 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
    • Display LTFS Configuration and Status Information
• Managing Directories and Files in SMB/CIFS Shares
  • Managing System Attributes in SMB/CIFS Shares
    • Oracle HSM Supported System Attributes
    • Display System Attributes
    • Modify System Attributes
• Administering 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
  • Managing Drives that Have Encryption Capability
  • Handling Drive Problems
    • Take a Drive Offline for Maintenance or Repair
    • Return Media to the Library Following a Drive Problem
      • Return 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
  • Maintaining Data Integrity
    • 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
    • Checking the Integrity of a Given Tape Volume
      • 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
    • Monitoring Automated Integrity Verification
      • 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
• Managing Cloud Storage
  • Update Storage Cloud Account Password Files
  • Maintaining Local Encryption Keystore Files
    • Add a Key to a Cloud Library Keystore File
    • Configure a Cloud Library to Use a Different Encryption Key
    • Retire an Encryption Key After Unarchiving Files

6 Managing Archives for Digital Preservation

• Configuring File Systems for Preservation
• Using Message Digests (Checksums)
  • Make Sure that File-System Host Performance Will Be Adequate
  • Supply a Message Digest and Enable Validation for a File
  • Generate a Message Digest and Enable Validation for a File
  • Generate a Message Digest and Enable Validation for Each File in a Directory
  • Validate the Message Digest of a File During Staging
  • Change Message Digesting and Validation Attributes Before a File is Archived
• Making Files Immutable
  • Supply a Message Digest and Make a File Immutable
  • Generate a Message Digest and Make a File Immutable
• Checking File Digest and Fixity Attributes
  • List Message Digesting and Validation Attributes
• Using WORM File Systems
  • Understanding WORM File Systems
  • WORM-Enable a Directory
  • Activate WORM Protection for a File
  • Find and List WORM Files

7 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 Oracle HSM Configuration
  • Manually Back Up the Oracle HSM Configuration
• Gathering Configuration and Diagnostic Information with samexplorer
  • Run samexplorer

8 Migrating to New Storage Media

• Types of Migration
• Preparing for Migration
  • Make Sure that File Systems Stay Backed Up
  • Provide the Required Media
  • Select the Migration Approach that Best Meets Your Needs
  • Select a Volume Migration Method
    • Select a StorageTek Direct Copy Mode
• Migrating Complete Volumes
  • Create the migrationd.cmd Configuration File
  • Check for Active Migration Jobs
  • Migrate Volumes
• Staging Files and Rearchiving to Replacement Media
  • Estimate The Resources Available for Staging and Re-Archiving
  • Configure an Archiving Process to Use the New Media
  • Migrate the Data to the Replacement Media
    • Migrate Data from One Cartridge to Another
• Disposing of Old Media After Migration

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 an Oracle HSM Shared File System
  • minallocsz and maxallocsz: Tuning Allocation Sizes
  • rdlease, wrlease, and aplease: Using Leases in an Oracle HSM 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 and Parameters

• Archiving
  • The archiver.cmd File
  • Archiving Directives
    • Archiving Directive: archivemeta
      • Syntax
      • Description
      • Scope
      • Recommendations
    • Archiving Directive: archive-set-name path
      • Syntax
      • Description
      • Scope
      • Options
      • Recommendations
      • Examples
    • Archiving Directive: archive-set-name.copy-number media-specification
      • Syntax
      • Scope
      • Examples
    • Archiving Directive: archmax
      • Syntax
      • Description
      • Scope
      • Recommendations
    • Archiving Directive: bufsize
      • Syntax
      • Description
      • Scope
      • Recommendations
    • Archiving Directive: copy-number
      • Syntax
      • Description
      • Scope
      • Options
      • Examples
    • Archiving Directive: copy-number[archive-age]
      • Syntax
      • Description
      • Scope
      • Recommendations
      • Example
    • Archiving Directive: drives
      • Syntax
      • Description
      • Scope
    • Archiving Directive: endparams
      • Syntax
      • Examples
    • Archiving Directive: endvsnpools
      • Syntax
      • Examples
    • Archiving Directive: endvsns
      • Syntax
      • Example
    • Archiving Directive: examine
      • Syntax
      • Description
      • Scope
      • Recommendations
    • Archiving Directive: fs
      • Syntax
      • Description
      • Scope
      • Example
    • Archiving Directive: interval
      • Syntax
      • Description
      • Scope
    • Archiving Directive: logfile
      • Syntax
      • Description
      • Scope
      • Recommendations
    • Archiving Directive: notify
      • Syntax
      • Description
      • Scope
    • Archiving Directive: ovflmin
      • Syntax
      • Description
      • Scope
      • Recommendations
    • Archiving Directive: params
      • Syntax
      • Examples
    • Archiving Directive: scanlist_squash
      • Syntax
      • Description
      • Scope
      • Recommendations
    • Archiving Directive: setarchdone
      • Syntax
      • Description
      • Scope
      • Recommendations
    • Archiving Directive: vsn-pool-name media-type volume-specification
      • Syntax
      • Scope
      • Examples
    • Archiving Directive: vsnpools
      • Syntax
      • Examples
    • Archiving Directive: vsns
      • Syntax
      • Example
    • Archiving Directive: wait
      • Syntax
      • Description
      • Scope
      • Recommendations
  • Copy Parameters
    • Copy Parameter: archive-set-name[.copy-number] [options]
      • Syntax
      • Description
      • Options
      • Recommendations
• Staging
  • The stager.cmd File
  • Staging Directives
    • Staging Directive: drives
      • Syntax
      • Description
      • Recommendations
      • Examples
    • Staging Directive: bufsize
      • Syntax
      • Description
      • Recommendations
    • Staging Directive: logfile
      • Syntax
      • Description
      • Log Fields
      • Examples
    • Staging Directive: maxactive
      • Syntax
      • Description
      • Examples
    • Staging Directive: copysel
      • Syntax
      • Description
      • Example
• Adjusting the Preview Queue
  • The preview.cmd file
  • Preview Queue Directives
    • Preview Queue Directive: age_priority
      • Syntax
      • Description
      • Scope
      • Example
    • Preview Queue Directive: hlwm_priority
      • Syntax
      • Description
      • Scope
      • Example
    • Preview Queue Directive: hwm_priority
      • Syntax
      • Description
      • Scope
      • Example
    • Preview Queue Directive: lhwm_priority
      • Syntax
      • Description
      • Scope
      • Example
    • Preview Queue Directive: lwm_priority
      • Syntax
      • Description
      • Scope
      • Example
    • Preview Queue Directive: vsn_priority
      • Syntax
      • Description
      • Scope
      • Example

E Understanding Archiver and Migration Logs

F Product Accessibility Features

Glossary