Preface

This manual, the Sun StorEdge QFS and Sun StorEdge SAM-FS Software Installation and Configuration Guide, explains the installation and upgrade procedures for the Sun StorEdge QFS and Sun StorEdge SAM-FS software products, release 4.2. The 4.2 releases can be installed on the following minimum Solaris Operating System (OS) platforms:

- Solaris 8 07/01

- Solaris 9 04/03

Certain features might require an operating system level that is beyond the requirements stated in the previous bullet list. For more information, see the release notes or see the specific feature's documentation.

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

TABLE P-1 Product Overview
Product | Components
--- | ---
Sun StorEdge QFS | Sun StorEdge QFS standalone file system.
Sun StorEdge SAM-FS | Standard file system plus the storage and archive management utility, SAM.
Sun SAM-QFS | The Sun StorEdge QFS file system combined with the storage and archive management utilities found in the Sun StorEdge SAM-FS software.

##

How This Book Is Organized

This manual contains the following chapters:

- Chapter 1 contains system requirements and prerequisites to installation.

- Chapter 2 explains the Sun StorEdge QFS initial installation procedure.

- Chapter 3 explains the Sun StorEdge QFS upgrade procedure.

- Chapter 4 explains the Sun StorEdge SAM-FS initial installation procedure.

- Chapter 5 explains the Sun StorEdge SAM-FS upgrade procedure.

- Appendix A provides information about administering SAM-QFS Manager.

- Appendix B describes the release package contents and the directories created at installation time.

- Appendix C is a command reference.

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 about 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`

##

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 Sun StorEdge QFS and Sun StorEdge SAM-FS 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

If you are configuring a Sun StorEdge QFS file system in a Sun Cluster environment, the following additional documents might interest you:

- Sun Cluster Concepts Guide for Solaris OS

- Sun Cluster Software Installation Guide for Solaris OS

- Sun Cluster Data Services Planning and Administration Guide for Solaris OS

- Sun Cluster Data Service for Oracle Real Application Clusters Guide for Solaris OS

##

Accessing Sun Documentation Online

The Sun StorEdge QFS and Sun StorEdge SAM-FS 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 Sun`s Network Storage Documentation Web Site

This web site contains documentation for Network Storage products.

1. Go to the following URL:

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

The Storage Software page appears.

2. Click the appropriate link from the following list:

- Sun StorEdge QFS Software

- Sun StorEdge SAM-FS Software

### 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:

`docs.sun.com`

The `docs.sun.com` page appears.

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

- Sun StorEdge QFS 4.2

- Sun StorEdge SAM-FS 4.2

##

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 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, 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 & Sun StorEdge SAM-FS Software Installation & Configuration Guide, part number 817-7722-10).

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