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 StorageTek trademark Storage Archive Manager (SAM) system. It describes problem situations, the tools needed to diagnose problems, and approaches to problem resolution.

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 recovery of a single lost file to recovery of 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 StorageTek QFS file system running in conjunction with a Sun StorageTek SAM storage and archive management system. This combination is known as SAM-QFS. This manual does not provide troubleshooting information for stand-alone Sun StorageTek QFS file systems. For Sun StorageTek QFS information, see the Sun StorageTek QFS File System Configuration and Administration Guide.

You, the system administrator, are assumed to be familiar with Sun StorageTek SAM and Sun StorageTek QFS installation, configuration, and basic operations. You are also assumed to be knowledgeable about the Solaris trademark Operating System (Solaris OS) 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 StorageTek QFS and Sun StorageTek SAM environments as described in the other manuals under Related Documentation.

How This Book Is Organized

This manual contains the following chapters:

Chapter 1 provides an overview of the troubleshooting process.

Chapter 2 describes specific troubleshooting features for the Sun StorageTek SAM software.

Chapter 3 describes troubleshooting methods for the File System Manager software.

Chapter 4 describes how to back up data in the Sun StorageTek SAM 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 StorageTek QFS and Sun StorageTek SAM documentation.

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

Shell Prompts

TABLE P-1 shows the shell prompts used in this manual.

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

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`

TABLE P-3 Related Documentation
Title	Part Number
Sun StorageTek QFS Installation and Upgrade Guide	819-7936-10
Sun StorageTek QFS File System Configuration and Administration Guide	819-7935-10
Sun StorageTek Storage Archive Manager File System Configuration and Administration Guide	819-7934-10
Sun StorageTek Storage Archive Manager Archive Configuration and Administration Guide	819-7931-10
Sun StorageTek Storage Archive Manager Installation and Upgrade Guide	819-7932-10
Sun StorageTek QFS and Sun StorageTek Storage Archive Manager 4.6 Release Notes	818-7938-10
Sun StorageTek QFS Linux Client Guide	819-7937-10

Accessing Sun Documentation Online

The Sun StorageTek QFS software distribution includes PDF files that you can view from Sun's Network Storage documentation web site or from docs.sun.com.

To Access Documentation From `docs.sun.com`

This web site contains documentation for Solaris and many other Sun software products.

1. Go to the following URL:

http://docs.sun.com

The docs.sun.com page appears.

2. Find the documentation for your product by searching for Sun StorageTek SAM or Sun StorageTek QFS in the search box.

To Access Documentation From Sun`s Network Storage Documentation Web Site

This web site contains documentation for Network Storage products.

1. Go to the following URL:

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

The Storage Software page appears.

2. Click the Sun StorageTek SAM or Sun StorageTek QFS Software link.

Third-Party Web Sites

Sun is not responsible for the availability of third-party web sites mentioned in this document. Sun does not endorse and is not responsible or liable for any content, advertising, products, or other materials that are available on or through such sites or resources. Sun will not be responsible or liable for any actual or alleged damage or loss caused by or in connection with the use of or reliance on any such content, goods, or services that are available on or through such sites or resources.

Contacting Sun Technical Support

If you have technical questions about this product that are not answered in this document, go to the following web site:

http://www.sun.com/service/contacting

Licensing

For information about obtaining licenses for Sun StorageTek QFS software, contact your Sun sales representative or your authorized service provider (ASP).

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.

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:

http://docs.sun.com/app/docs/form/comments

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