Preface

This manual is written for Sun personnel and customers who need to diagnose and troubleshoot common problems encountered with the installation, configuration, and operation of a Sun StorEdge SAM-FS system. It describes problem situations, the tools needed to diagnose problems, and approaches to problem resolution. The reader is assumed to be familiar with Sun StorEdge SAM-FS and Sun StorEdge QFS installation, configuration, and basic operations.

This manual also describes the steps to prepare for disaster recovery and steps to recover from a disaster, should one occur. It describes the system data (metadata) that you need to protect and how to use that data to reconstruct or recover lost data. The types of data recovery addressed in this manual range from recovering a single lost file to recovering large amounts of data lost in a fire, flood, or other disaster.

Many of the procedures in this manual have to do with a Sun StorEdge QFS file system running in conjunction with a Sun StorEdge SAM-FS storage and archive management system. This combination is known as SAM-QFS. This manual does not provide troubleshooting information for stand-alone Sun StorEdge QFS file systems. For Sun StorEdge QFS information, see the Sun StorEdge QFS Configuration and Administration Guide.

Before You Read This Book

You, the system administrator, are assumed to be knowledgeable about Solaris system and network administration procedures, including installation, configuration, creation of accounts, and system backups.

Before you read this book, you need to understand how to administer Sun StorEdge QFS and Sun StorEdge SAM-FS environments as described in the other manuals under Related Documentation.

How This Book Is Organized

The first three chapters of this book cover general troubleshooting procedures for the Sun StorEdge SAM-FS software and the File System Manager software (previously called SAM-QFS Manager). Chapters 4 through 8 cover file system backup and restoration procedures. Backup procedures described in Chapter 4 are applicable for Sun StorEdge QFS and SAM-QFS file systems and for all types of archive media. The recovery procedures in the remaining chapters apply only to SAM-QFS file systems.

Also, while the procedures in Chapter 5 are for recovering individual files from all supported types of archive media, the recovery procedures for damaged file systems in Chapter 6 apply only to file systems archived on tape or on magneto optical disk. Procedures for recovering file systems archived on hard disks are outside the scope of this manual.

This manual contains the following chapters:

Chapter 1 provides an overview of the troubleshooting process

Chapter 2 describes specific troubleshooting features for the Sun StorEdge SAM-FS software

Chapter 3 describes troubleshooting methods for the File System Manager software

Chapter 4 describes how to back up data in the Sun StorEdge SAM-FS environment

Chapter 5 explains how to recover individual data files and directories

Chapter 6 explains how to recover data from damaged volumes

Chapter 7 explains how to recover data from damaged file systems

Chapter 8 provides overall guidelines for recovery after a catastrophic failure.

The glossary defines terms used in this and other Sun StorEdge QFS and Sun StorEdge SAM-FS documentation.

TABLE P-1 Related Documentation
Title	Part Number
Sun StorEdge QFS Installation and Upgrade Guide	819-2757-10
Sun StorEdge QFS Configuration and Administration Guide	819-2758-10
Sun StorEdge SAM-FS File System Configuration and Administration Guide	819-3635-10
Sun StorEdge SAM-FS Installation and Upgrade Guide	819-2754-10
Sun StorEdge SAM-FS Storage and Archive Management Guide	819-2755-10
Sun StorEdge QFS and Sun StorEdge SAM-FS 4.4 Release Notes	818-2759-10

Installation Assistance

For installation and configuration services, please contact Sun's Enterprise Services at 1-800-USA4SUN, or contact your local Enterprise Services sales representative.

Accessing Sun Documentation Online

The Sun StorEdge QFS and Sun StorEdge SAM-FS software distribution includes PDF files of the documents for these products. These PDF files can also be accessed online at either of two locations by using one of the two methods below.

Method 1: Access the documents at docs.sun.com.

1. Go to the following URL:

http://docs.sun.com

The docs.sun.com page displays.

2. Enter the appropriate product name in the search box.

Method2: Access the documents at Sun`s Network Storage documentation website.

1. Go to the following URL:

http://www.sun.com/products-n-solutions/hardware/docs/Software/Storage_Software

The Storage Software page displays.

2. Click on the appropriate product link.

Note - Viewing PDF files requires the Acrobat Reader software, which is available for free from the following website: www.adobe.com.

Using UNIX Commands

This document does not contain information on basic UNIX® commands and procedures such as shutting down the system, booting the system, and configuring devices. Refer to one or more of the following for this information:

Software documentation that you received with your system

Solaris Operating System documentation, which is at the following URL:

http://docs.sun.com

Typographic Conventions

TABLE P-2 lists the typographic conventions used in this manual.

TABLE P-2 Typographic Conventions
Typeface or Symbol	Meaning	Examples
`AaBbCc123`	The names of commands, files, and directories; on-screen computer output.	Edit your `.login` file. Use `ls -a` to list all files. `% You have mail`.
`AaBbCc123`	What you type, when contrasted with on-screen computer output.	`%` `su` `Password:`
AaBbCc123	Book titles; new words or terms; words to be emphasized; and command line variables to be replaced with a real name or value.	Read Chapter 6 in the User's Guide. These are called class options. You must be `root` to do this. To delete a file, type `rm` filename.
[ ]	In syntax, brackets indicate that an argument is optional.	`scmadm` [`-d` sec] [`-r` n[:n][,n]...] [`-z`]
{ arg \| arg}	In syntax, braces and pipes indicate that one of the arguments must be specified.	`sndradm -b` {phost \| shost}
\	At the end of a command line, the backslash (`\`) indicates that the command continues on the next line.	`atm90 /dev/md/rdsk/d5 \` `/dev/md/rdsk/d1 atm89`

Shell Prompts

TABLE P-3 shows the shell prompts that this manual uses.

TABLE P-3 Shell Prompts
Shell	Prompt
C shell	machine_name`%`
C shell superuser	machine_name`#`
Bourne shell and Korn shell	`$`
Bourne shell and Korn shell superuser	`#`

Sun Welcomes Your Comments

Sun is interested in improving its documentation and welcomes your comments and suggestions. You can email your comments to Sun at:

docfeedback@sun.com

Please include the part number (819-2756-10) of your document in the subject line of your email.