Preface

This manual, the Sun StorEdge QFS and Sun StorEdge SAM-FS File System Administration Guide, describes the file system software included in the Sun StorEdge QFS and Sun StorEdge SAM-FS 4.2 releases. The software products and the file systems they include are as follows:

- Sun StorEdge SAM-FS file system. The Sun StorEdge SAM-FS environment includes a general-purpose file system along with the storage and archive manager, SAM. The Sun StorEdge SAM-FS environment's file system enables data to be archived to automated libraries at device-rated speeds. Data can also be archived to files in another file system through a process known as disk archiving. The file system in the Sun StorEdge SAM-FS environment is a complete file system. The user is presented with a standard file system interface and can read and write files as though they were all on primary disk storage.

- Sun StorEdge QFS file system. The Sun StorEdge QFS file system can be used as a standalone file system, or it can be used in conjunction with the storage and archive manager, SAM. When used in conjunction with SAM, it is known as Sun SAM-QFS. Sun StorEdge QFS shares most of the Sun StorEdge SAM-FS file system's features. The Sun StorEdge QFS file system, however, is designed for high performance and contains more features than are supported within the Sun StorEdge SAM-FS environment.

Note - You can purchase licenses for both Sun StorEdge QFS and Sun StorEdge SAM-FS software with the intent to run the Sun StorEdge QFS file system with the storage and archive manager found in the Sun StorEdge SAM-FS software. Such a system is referred to as Sun SAM-QFS. This manual does not call out the Sun SAM-QFS configuration unless it is necessary for clarity. In this manual, you can assume that references to Sun StorEdge SAM-FS also apply to Sun SAM-QFS configurations when talking about storage and archive management. Likewise, you can assume that references to Sun StorEdge QFS also apply to Sun SAM-QFS configurations when talking about file system design and capabilities.

The Sun StorEdge QFS and Sun StorEdge SAM-FS file systems are technologically similar, but within this manual, differences are noted when necessary.

The Sun StorEdge QFS and Sun StorEdge SAM-FS 4.2 releases are supported on the following minimum Sun Solaris Operating System (OS) platform levels.

TABLE P-1 Minimum Sun Solaris OS Platform Levels
Product | Minimum Platform Levels
--- | ---
Sun StorEdge QFS | Solaris 8 07/01 Solaris 9 04/03
Sun StorEdge SAM-FS | Solaris 8 07/01 Solaris 9 04/03
Sun StorEdge QFS in a Sun Cluster environment | Solaris 8 02/02 Solaris 9 04/03

This manual is written for system administrators responsible for installing, configuring, and maintaining Sun StorEdge QFS and Sun StorEdge SAM-FS file systems. You, the system administrator, are assumed to be knowledgeable about Solaris OS procedures, including installation, configuration, creating accounts, performing system backups, and other basic Solaris OS system administration tasks.

##

How This Book Is Organized

This manual contains the following chapters:

- Chapter 1 provides overview information.

- Chapter 2 provides file system design information.

- Chapter 3 provides volume management information.

- Chapter 4 explains how to perform various tasks for the Sun StorEdge QFS and Sun StorEdge SAM-FS file systems. Tasks covered include initializing a file system, adding a server, adding disk cache, and other system administration activities.

- Chapter 5 explains how to use the shared Sun StorEdge QFS file system.

- Chapter 6 explains how to use the `samu`(1M) operator utility.

- Chapter 7 explains how to use file system quotas.

- Chapter 8 describes how Sun StorEdge QFS software works in a Sun Cluster environment.

- Chapter 9 explains miscellaneous advanced topics such using multireader file system and performance features.

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 OS documentation, which is at the following URL:

`http://docs.sun.com`

##

Shell Prompts

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

TABLE P-2 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-3 lists the typographic conventions used in this manual.

TABLE P-3 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 describes the operations of the Sun StorEdge QFS and Sun StorEdge SAM-FS software products. TABLE P-4 shows the complete release 4.2 documentation set for these products.

TABLE P-4 Related Documentation
Title | Part Number
--- | ---
Sun SAM-Remote Administration Guide | 816-2094-11
Sun QFS, Sun SAM-FS, and Sun SAM-QFS Disaster Recovery Guide | 816-2540-10
Sun StorEdge QFS and Sun StorEdge SAM-FS File System Administration Guide | 817-7721-10
Sun StorEdge QFS and Sun StorEdge SAM-FS Software Installation and Configuration Guide | 817-7722-10
Sun StorEdge SAM-FS Storage and Archive Management Guide | 817-4093-10
Sun StorEdge QFS and Sun StorEdge SAM-FS 4.2 Release Notes | 817-7724-10

##

Accessing Sun Documentation Online

The Sun StorEdge QFS and Sun StorEdge SAM-FS software distribution includes PDF files for the documents for these products. You can view these PDF files from the following locations:

- At Sun`s Network Storage documentation web site.

This web site contains documentation for many storage software products.

a. To access this web site, go to the following URL:

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

The Storage Software page is displayed.

b. Click on the appropriate link from the following list:

- Sun StorEdge QFS Software

- Sun StorEdge SAM-FS Software

- At `docs.sun.com`.

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

a. To access this web site, go to the following URL:

`docs.sun.com`

The `docs.sun.com` page is displayed.

b. Find the documentation for your product by searching for one of the following products in the search box:

- Sun StorEdge QFS

- Sun StorEdge SAM-FS

##

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 on obtaining licenses for Sun StorEdge QFS and Sun StorEdge SAM-FS software, contact your Sun sales representative or your authorized service provider (ASP).

##

Diagnostics

The Sun StorEdge QFS and Sun StorEdge SAM-FS software includes the `samexplorer`(1M) script. This diagnostic script can be very useful to you and to the Sun customer support staff. This script produces a diagnostic report of the server configuration and collects log information. After the software is installed, you can access the `samexplorer`(1M) man page for more information about this script.

##

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 submit your comments by going to the following web site:

`http://www.sun.com/hwdocs/feedback`

Please include the title and part number of your document with your feedback (Sun StorEdge QFS and Sun StorEdge SAM-FS File System Administration Guide, part number 817-7721-10).

Copyright © 2004, Sun Microsystems, Inc. All rights reserved.