Sun Logo


Sun StorEdge SAM-FS Troubleshooting Guide

Version 4, Update 4

819-2756-10



Contents

Tables

Preface

1. Troubleshooting Overview

Troubleshooting Issues

Daemons

SAM-QFS Daemons

Verifying SAM-QFS Daemons

procedure iconsmall spaceTo Check ps(1) Output and Related Factors

Configuration Files

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 and the samexplorer(1M) Diagnostic Report

Troubleshooting Utilities

The samexplorer(1M) Script

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 for Direct-attached Libraries

Verifying mcf Drive Order Matching for Network-attached Libraries

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 StorEdge SAM-FS Software

Troubleshooting the Archiver

Why Files Are Not Archiving

Additional Archiver Diagnostics

Why Files Are Not Releasing

Troubleshooting the Releaser

Troubleshooting the Recycler

3. Troubleshooting the File System Manager

File System Manager Messages

Log and Trace Files

File System Manager Logging

Web Server Logging

File System Manager Portal Agent Configuration and Log Files

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 Portal Agent Tracing

Remote Procedure Call (RPC) Daemon Information

procedure iconsmall spaceTo Determine Whether the RPC Daemon Is Running

4. Backing Up Data

Guarding Against or Troubleshooting Data Loss

Precautions Before Starting Data Restoration

procedure iconsmall spaceTo Troubleshoot an Inaccessible File System

Prerequisites for Data Recovery

Metadata Used in Disaster Recovery

.inodes File Characteristics

More About Directory Pathnames

SAM-QFS Disaster Recovery Features

Guidelines for Performing 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 StorEdge QFS File Systems

procedure iconsmall spaceTo Create a Sun StorEdge SAM-FS Metadata Dump File Manually Using File System Manager

procedure iconsmall spaceTo Create a Sun StorEdge SAM-FS Metadata Dump File Manually Using the Command Line

procedure iconsmall spaceTo Create a Sun StorEdge SAM-FS Metadata Dump File Automatically From the File System Manager

procedure iconsmall spaceTo Create a Sun StorEdge SAM-FS Metadata Dump File Automatically Using cron

Disaster Recovery Commands and Tools

The samexplorer Script

What to Back Up and How Often

Additional Backup Considerations

Using Archiver Logs

procedure iconsmall spaceTo Set Up Archiver Logging

procedure iconsmall spaceTo Save Archiver Logs

How and Where to Keep 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 Using a samfsdump(1M) File

Restoring Files and Directories Without samfsdump(1M) Output

Information Needed to Restore a File

Determining Whether a File Is a Regular File, a Segmented File, or a Volume Overflow File

Regular File

Segmented File

Volume Overflow File

Summary of Differences

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

Method 1 - Using sls(1)

Method 2 - Using the Archiver Log File

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

procedure iconsmall spaceTo Restore Multiple 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 - Other Copies Available

procedure iconsmall spaceTo Recycle a Damaged Tape - Other Copies Available

Damaged Tape Volume - No Other Copies Available

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

Relabeled Tape Volume - No Other Copies Available

Unreadable Tape Label - 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 - Copies Available

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

Damaged Magneto-optical Volume - No Other Copies Available

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

Relabeled Magneto-optical Volume - No Other Copies Available

Unreadable Label - 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 Without a Dump File

8. Recovering From Catastrophic Failure

procedure iconsmall spaceTo Recover From a Catastrophic Failure

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