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.

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 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.

You, the system administrator, are assumed to be familiar with Sun StorEdge SAM-FS and Sun StorEdge QFS installation, configuration, and basic operations. You are also 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

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.

##

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`

##

Related Documentation

This manual is part of a set of documents that describe the operations of the Sun StorEdge QFS and Sun StorEdge SAM-FS software products. TABLE P-3 shows the complete documentation set for Version 4, Update 5 (4U5), of these products.

TABLE P-3 Related Documentation
Title | Part Number
--- | ---
Sun StorEdge QFS Installation and Upgrade Guide | 819-4334-10
Sun StorEdge QFS Configuration and Administration Guide | 819-4332-10
Sun StorEdge SAM-FS File System Configuration and Administration Guide | 819-4333-10
Sun StorEdge SAM-FS Storage and Archive Management Guide | 819-4329-10
Sun StorEdge SAM-FS Installation and Upgrade Guide | 819-4330-10
Sun StorEdge QFS and Sun StorEdge SAM-FS 4.5 Release Notes | 818-4335-10

##

Accessing Sun Documentation Online

The Sun StorEdge 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 StorEdge SAM-FS or Sun StorEdge 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 StorEdge SAM-FS or Sun StorEdge 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 StorEdge 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:

`docfeedback@sun.com`

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

Copyright © 2006, Sun Microsystems, Inc. All Rights Reserved.