Sun Logo


Sun StorageTek Storage Archive Manager Troubleshooting Guide

Version 4, Update 6

819-7933-10



Contents

Tables

Preface

1. Troubleshooting Overview

Tools for Troubleshooting

Daemons

Sun StorageTek SAM Daemons

Verifying Sun StorageTek SAM Daemons

Checking ps(1) Output and Related Factors

Log and Trace Files

Enabling System Logging

procedure iconsmall spaceTo Enable System Logging

Enabling Device Down Notification

Enabling Daemon Tracing

Enabling Device Logging

Troubleshooting Utilities

The samexplorer Script

Troubleshooting Common Problems

Hardware Configuration Problems

procedure iconsmall spaceTo Verify Hardware

SAN-Attached Device Configuration Problems

Troubleshooting Configuration Files

The /etc/opt/SUNWsamfs/mcf File

Verifying mcf Drive Order Matching

The /kernel/drv/st.conf File

The /kernel/drv/samst.conf File

The /etc/opt/SUNWsamfs/inquiry.conf File

The /etc/opt/SUNWsamfs/defaults.conf File

Planning for Disaster Recovery

Recovering From Failure of the Operating Environment Disk

Testing Backup and Recovery Methods

Testing Backup Scripts and cron Jobs

Testing the Disaster Recovery Process

2. Troubleshooting Sun StorageTek SAM Software

Troubleshooting the Archiver

Why Files Are Not Archiving

Additional Archiver Diagnostics

Troubleshooting the Releaser

Troubleshooting the Recycler

3. Troubleshooting the File System Manager Software

Log and Trace Files

File System Manager Logging

Web Server Logging

Tracing

procedure iconsmall spaceTo Enable Tracing for File System Manager and Native Code

procedure iconsmall spaceTo Enable Tracing or to Adjust the Tracing Level

File System Manager Messages

Remote Procedure Call Daemon Information

procedure iconsmall spaceTo Determine Whether the RPC Daemon Is Running

4. Backing Up Data

Guarding Against or Troubleshooting Data Loss

Troubleshooting an Inaccessible File System

procedure iconsmall spaceTo Troubleshoot an Inaccessible File System

Backup and Recovery Commands and Tools

Disaster Recovery Commands

Disaster Recovery Utilities

The samexplorer Script

Files Requiring Backup

Preparing a Disaster Recovery Plan

Using SAM-QFS Archiving Features

Metadata Used in Disaster Recovery

.inodes File Characteristics

Directory Path Name Synchronization

Guidelines for Performing Metadata Dumps

Backing Up the Metadata in SAM-QFS File Systems

Creating samfsdump Dump Files

Using samfsdump With the -u Option

procedure iconsmall spaceTo Find Sun StorageTek QFS File Systems

procedure iconsmall spaceTo Create a Sun StorageTek SAM Metadata Dump File Manually Using File System Manager

Additional File System Manager Tools

procedure iconsmall spaceTo Create a Sun StorageTek SAM Metadata Dump File Manually Using the Command Line

procedure iconsmall spaceTo Create a Recovery Point File Automatically From File System Manager

procedure iconsmall spaceTo Create a Sun StorageTek SAM Metadata Dump File Automatically Using cron

Using Archiver Logs

procedure iconsmall spaceTo Set Up Archiver Logging

procedure iconsmall spaceTo Save Archiver Logs

Storing Copies of Disaster Recovery Files and Metadata

5. Restoring Files and Directories

Restoring Regular Files and Directories With samfsdump(1M) Output

procedure iconsmall spaceTo Restore Files Using File System Manager

procedure iconsmall spaceTo Restore Files Using a samfsdump(1M) File

Restoring Files and Directories Without samfsdump(1M) Output

Determining the File Type

Regular File

Segmented File

Volume Overflow File

Restoring a Regular File Using Archiver Log or sls Information

procedure iconsmall spaceTo Restore a Regular File Using Information From an Archiver Log or sls Command Output

Restoring a Regular File Without Information From an Archiver Log

procedure iconsmall spaceTo Restore a Regular File Without Information From an Archiver Log

Restoring a Segmented File Using Information From an Archiver Log

procedure iconsmall spaceTo Restore a Segmented File Using Information From Archiver Log Entries

Restoring a Volume Overflow File Using Information From an Archiver Log

procedure iconsmall spaceTo Restore a Volume Overflow File Using Information From an Archiver Log

Restoring Files Archived to Disk

procedure iconsmall spaceTo Gather Information for a Disk Archive Restoration

procedure iconsmall spaceTo Restore Files From a Disk Archive tar(1) File

Retrieving Unarchived Files From File Systems

6. Salvaging Damaged Volumes

Recovering Data From a Tape Volume

Damaged Tape Volume With Other Copies Available

procedure iconsmall spaceTo Recycle a Damaged Tape With Other Copies Available

Damaged Tape Volume With No Other Copies Available

procedure iconsmall spaceTo Recover Files From a Damaged Tape With No Other Copies Available

Relabeled Tape Volume With No Other Copies Available

Unreadable Tape Label With No Other Copies Available

procedure iconsmall spaceTo Recover Files From a Tape Whose Label Is Unreadable

Recovering Data From a Magneto-optical Volume

Damaged Magneto-optical Volume With Copies Available

procedure iconsmall spaceTo Rearchive Files and Recycle a Damaged Magneto-optical Volume With Copies Available

Damaged Magneto-optical Volume With No Other Copies Available

procedure iconsmall spaceTo Recover From a Damaged Magneto-optical Volume With No Other Copies Available

Relabeled Magneto-optical Volume With No Other Copies Available

Unreadable Label With No Other Copies Available

7. Recovering File Systems

Recovering a SAM-QFS File System With a Metadata Dump File

procedure iconsmall spaceTo Restore a File System Using File System Manager

procedure iconsmall spaceTo Restore a File System Using the Command- Line Interface

Recovering a SAM-QFS File System Without a Dump File

procedure iconsmall spaceTo Recover a File System Without a Dump File

8. Recovering From Catastrophic Failure

Recovery Task Overview

Recovery Procedures

procedure iconsmall spaceTo Restore Failed System Components

procedure iconsmall spaceTo Disable the Archiver and Recycler Until All Files Are Restored

procedure iconsmall spaceTo Keep and Compare Previous and Current Configuration and Log Files

procedure iconsmall spaceTo Repair Disks

procedure iconsmall spaceTo Restore or Build New Library Catalog Files

procedure iconsmall spaceTo Make New File Systems and Restore From samfsdump Output

Glossary

Index