Sun Logo


Sun StorEdge QFS Configuration and Administration Guide

Version 4, Update 5

819-4332-10



Contents

Tables

Preface

1. File System Overview

File System Features

Volume Management

Support for Paged and Direct I/O

High Capacity

Fast File System Recovery

Metadata Storage

vnode Interface

Shared File System Support

Linux Client Support

Additional File System Features

Design Basics

Inode Files and File Characteristics

Specifying Disk Allocation Units

DAU Settings and File System Geometry

ms and ma File Systems

Dual and Single Allocation Schemes

Data Alignment

Stripe Widths on Data Disks

File Allocation Methods

Metadata Allocation

Round-Robin Allocation

Striped Allocation

Striped Groups

Mismatched Striped Groups

Example of a Mismatched Striped Group

2. System Configuration Tasks

Using the File System Manager Software

procedure iconsmall spaceTo Invoke File System Manager for the First Time

Creating Additional Administrator and User Accounts

procedure iconsmall spaceTo Create Additional Accounts

Assigning Privilege Levels

Creating an Account for Multiple Users

procedure iconsmall spaceTo Add an Additional Server for File System Manager Access

Setting the Session Timeout

Using the File System Manager Portal Agent

procedure iconsmall spaceTo Enable the File System Manager Portal Agent

About Port Numbers for the File System Manager Portal Agent

About Configuration and Log Files for the File System Manager Portal Agent

Function of the mcf File

The Equipment Identifier Field

The Equipment Ordinal Field

The Equipment Type Field

The Family Set Field

The Device State Field

The Additional Parameters Field

Examples of mcf Files

Interactions Among File Settings, Options, and Directives

Initializing a File System

Configuration Examples

procedure iconsmall spaceTo Create a Sun StorEdge QFS Round-Robin Disk Configuration

procedure iconsmall spaceTo Create a Sun StorEdge QFS Striped Disk Configuration

procedure iconsmall spaceTo Create a Sun StorEdge QFS Striped Group Configuration

3. Performing Operational Tasks

Viewing Files and File Attributes

File Attributes and File States

Displaying File Information

About the sls(1) Output

About the Retention Line

Propagating Configuration File Changes to the System

procedure iconsmall spaceTo Change mcf(4) or defaults.conf(4) Information in a Sun StorEdge QFS Sun Cluster Environment

procedure iconsmall spaceTo Change mcf(4) or defaults.conf(4) File System Information in a SAM-QFS Environment

procedure iconsmall spaceTo Change mcf(4) or defaults.conf(4) Removable Media Drive Information

Changing the Shared Hosts File

procedure iconsmall spaceTo Add New Entries or Change Existing Entries

procedure iconsmall spaceTo Change Host Names, Reorder Entries, or Insert Entries

Setting Up Mount Parameters

The mount(1M) Command

The /etc/vfstab File

The samfs.cmd File

Unmounting a File System

procedure iconsmall spaceTo Unmount a Standalone QFS or SAM-QFS File System

procedure iconsmall spaceTo Unmount a Sun StorEdge QFS Shared File System

Adding Disk Cache to a File System

procedure iconsmall spaceTo Add Disk Cache to a File System

Re-creating a File System

procedure iconsmall spaceTo Back Up and Re-create a File System

4. Configuring a Sun StorEdge QFS Shared File System

Mounting and Unmounting Sun StorEdge QFS Shared File Systems

procedure iconsmall spaceTo Mount a Shared File System

procedure iconsmall spaceTo Unmount a Shared File System

Converting an Unshared File System to a Shared File System

procedure iconsmall spaceTo Perform a Conversion

procedure iconsmall spaceTo Perform a Conversion on Each Client

Converting a Shared File System to an Unshared File System

procedure iconsmall spaceTo Perform a Conversion on Each Client

procedure iconsmall spaceTo Perform a Conversion on the Server

Adding and Removing a Client Host

procedure iconsmall spaceTo Add a Client Host

procedure iconsmall spaceTo Remove a Client Host

Updating the mcf file in a Sun StorEdge QFS Shared Environment

Creating the Local Hosts Configuration File

Changing the Metadata Server in a Sun StorEdge QFS Environment

procedure iconsmall spaceTo Change the Metadata Server When the Metadata Server Is Available

procedure iconsmall spaceTo Change the Metadata Server When the Metadata Server Is Unavailable

Changing the Metadata Server in a SAM-QFS Environment

procedure iconsmall spaceTo Change the Metadata Server in a SAM-QFS Environment

Client-Server Communications in a Sun StorEdge QFS Shared File System

5. Administering File System Quotas

Overview

Types of Quotas, Quota Files, and Quota Records

Soft Limits and Hard Limits

Disk Blocks and File Limits

Enabling Quotas

Guidelines for Setting Up Quotas

procedure iconsmall spaceTo Configure a New File System to Use Quotas

procedure iconsmall spaceTo Configure an Existing File System to Use Quotas

procedure iconsmall spaceTo Assign Admin Set IDs to Directories and Files

Setting Infinite Quotas

procedure iconsmall spaceTo Set an Infinite Quota

Enabling Default Quota Values

procedure iconsmall spaceTo Enable Default Quota Values for Users, Groups, or Admin Sets

Enabling Limits

procedure iconsmall spaceTo Enable Limits for Users, Groups, or Admin Sets

procedure iconsmall spaceTo Enable or Change Limits for Users, Groups, or Admin Sets Using an Existing Quota File

Checking Quotas

procedure iconsmall spaceTo Check for Exceeded Quotas

Changing and Removing Quotas

procedure iconsmall spaceTo Change the Grace Period

Changing the Grace Period Expiration

procedure iconsmall spaceTo Inhibit Additional File System Resource Allocations

procedure iconsmall spaceTo Remove a File System's Quotas

procedure iconsmall spaceTo Correct Quotas

6. Configuring Sun StorEdge QFS in a Sun Cluster Environment

Before You Begin

Restrictions

How the Sun Cluster System and the Sun StorEdge QFS Software Interact

Data Access With a Shared File System

Data Access With an Unshared File System

Sun StorEdge QFS Support for Solaris Volume Manager for Sun Cluster

procedure iconsmall spaceTo Configure a File System With Solaris Volume Manager for Sun Cluster

About Configuration Examples

Configuring a Sun StorEdge QFS Shared File System in a Sun Cluster Environment

Metadata Server Resource Considerations

Example Configuration

procedure iconsmall spaceTo Prepare to Create Sun StorEdge QFS Shared File Systems

procedure iconsmall spaceTo Create the Sun StorEdge QFS Shared File System and Configure Sun Cluster Nodes

procedure iconsmall spaceTo Validate the Configuration

procedure iconsmall spaceTo Configure the Sun Cluster Data Service for Oracle Real Application Clusters

Configuring an Unshared File System in a Sun Cluster Environment

Example 1: HA-NFS on Raw Global Devices

procedure iconsmall spaceTo Prepare to Create an Unshared Sun StorEdge QFS File System

procedure iconsmall spaceTo Create the Sun StorEdge QFS File System and Configure Sun Cluster Nodes

procedure iconsmall spaceTo Configure the Network Name Service and the IPMP Validation Testing

procedure iconsmall spaceTo Configure HA-NFS and the Sun StorEdge QFS File System for High Availability

Example 2: HA-NFS on Volumes Controlled by Solstice DiskSuite/Solaris Volume Manager

procedure iconsmall spaceTo Prepare the Solstice DiskSuite/Solaris Volume Manager Software

procedure iconsmall spaceTo Prepare to Create a Sun StorEdge QFS File System

procedure iconsmall spaceTo Create the Sun StorEdge QFS File System and Configure Sun Cluster Nodes

procedure iconsmall spaceTo Configure the Network Name Service and the IPMP Validation Testing

procedure iconsmall spaceTo Configure HA-NFS and the Sun StorEdge QFS File System for High Availability

Example 3: HA-NFS on VxVM Volumes

procedure iconsmall spaceTo Configure the VxVM Software

procedure iconsmall spaceTo Prepare to Create a Sun StorEdge QFS File System

procedure iconsmall spaceTo Create the Sun StorEdge QFS File System and Configure Sun Cluster Nodes

procedure iconsmall spaceTo Validate the Configuration

procedure iconsmall spaceTo Configure the Network Name Service and the IPMP Validation Testing

procedure iconsmall spaceTo Configure HA-NFS and the Sun StorEdge QFS File System for High Availability

Changing the Sun StorEdge QFS Configuration

procedure iconsmall spaceTo Change the Shared File System Configuration

procedure iconsmall spaceTo Disable HA-NFS on a File System That Uses Raw Global Devices

procedure iconsmall spaceTo Disable HA-NFS on a File System That Uses Solaris Volume Manager-Controlled Volumes

procedure iconsmall spaceTo Disable HA-NFS on a Sun StorEdge QFS File System That Uses VxVM-Controlled Volumes

7. Advanced Topics

Using Daemons, Processes, and Tracing

Daemons and Processes

Trace Files

Trace File Content

Trace File Rotation

Determining Which Processes Are Being Traced

Using the setfa(1) Command to Set File Attributes

Selecting File Attributes for Files and Directories

Preallocating File Space

Selecting a File Allocation Method and Stripe Width

Selecting a Striped Group Device

Configuring WORM-FS File Systems

Enabling the WORM-FS Feature

Setting the Default Retention Period

Setting the Retention Period Using touch

Extending a File's Retention Period

Using sls to View WORM-FS Files

Using sfind to Find WORM-FS Files

Accommodating Large Files

Configuring a Multireader File System

Using the SAN-QFS File System in a Heterogeneous Computing Environment

Before You Begin

Enabling the SAN-QFS File System

procedure iconsmall spaceTo Enable the SAN-QFS File System on the Metadata Controller

procedure iconsmall spaceTo Enable the SAN-QFS File System on the Clients

procedure iconsmall spaceTo Install the SANergy Software on the Clients

Unmounting the SAN-QFS File System

procedure iconsmall spaceTo Unmount the SAN-QFS File System on the SANergy Clients

procedure iconsmall spaceTo Unmount the SAN-QFS File System on the Metadata Controller

procedure iconsmall spaceTo Unmount the SAN-QFS File System on the Sun StorEdge QFS Clients

procedure iconsmall spaceTo Unmount the SAN-QFS File System on the Sun StorEdge QFS Server

Troubleshooting: Unmounting a SAN-QFS File System With SANergy File Holds

procedure iconsmall spaceTo Unmount a File System in the Presence of SANergy File Holds

Block Quotas in a SAN-QFS File System

File Data and File Attributes in a SAN-QFS File System

Using samgrowfs(1M) to Expand SAN-QFS File Systems

SAN-QFS Shared File System and Sun StorEdge QFS Shared File System Comparison

Understanding I/O Types

Paged I/O

Direct I/O

I/O Switching

Increasing File Transfer Performance for Large Files

procedure iconsmall spaceTo Increase File Transfer Performance

Enabling Qwrite Capability

Setting the Write Throttle

Setting the Flush-Behind Rate

Tuning the Number of Inodes and the Inode Hash Table

The ninodes Parameter

The nhino Parameter

When to Set the ninodes and nhino Parameters

A. Troubleshooting Sun StorEdge QFS

Checking File System Integrity and Repairing File Systems

procedure iconsmall spaceTo Check a File System

procedure iconsmall spaceTo Repair a File System

Troubleshooting a Failed or Hung sammkfs(1M) or mount(1M) Command in a Shared File System

Recovering From a Failed sammkfs(1M) Command

procedure iconsmall spaceTo Verify the mcf(4) File and Propagate mcf(4) File Changes to the System

Recovering From a Failed mount(1M) Command

procedure iconsmall spaceTo Verify that the File System Can Be Mounted

procedure iconsmall spaceTo Use the samfsinfo(1M) and samsharefs(1M) Commands

procedure iconsmall spaceTo Use the samfsconfig(1M) Command

Recovering From a Hung mount(1M) Command

procedure iconsmall spaceTo Verify Network Connections

procedure iconsmall spaceTo Verify That the Client Can Reach the Server

procedure iconsmall spaceTo Verify That the Server Can Reach the Client

procedure iconsmall spaceTo Examine the sam-sharefsd Trace Log

Troubleshooting the Linux Client

Troubleshooting Tools

Frequently Asked Questions

B. Mount Options in a Sun StorEdge QFS Shared File System

Mounting in the Background: the bg Option

Reattempting a File System Mount: the retry Option

Declaring a Sun StorEdge QFS Shared File System: the shared Option

Tuning Allocation Sizes: the minallocsz=n and maxallocsz=n Options

Using Leases in a Sun StorEdge QFS Shared File System: the rdlease=n, wrlease=n, and aplease=n Options

Enabling Multiple Host Reads and Writes: the mh_write Option

Setting the Number of Concurrent Threads: the nstreams=n Option

Retaining Cached Attributes: the meta_timeo=n Option

Specifying Striped Allocation: the stripe Option

Specifying the Frequency With Which Metadata Is Written: the sync_meta=n Option

Enabling WORM Functionality: the worm_capable and def_retention Options

C. Using the samu(1M) Operator Utility

Overview

procedure iconsmall spaceTo Invoke samu(1M)

procedure iconsmall spaceTo Display a samu(1M) Screen

procedure iconsmall spaceTo Stop samu(1M)

Interacting With samu(1M)

Entering a Device

Getting Online Help

procedure iconsmall spaceTo Access Online Help From a Display Screen

Operator Displays

(a) - Archiver Status Display

Navigation

Sample Display

Field Descriptions

(c) - Device Configuration Display

Navigation

Sample Display

Field Descriptions

(C) - Memory Display

Sample Display

(d) - Daemon Trace Controls Display

Sample Display

(D) - Disk Volume Dictionary

Sample Display

Flags

(f) - File Systems Display

Sample Display

Field Descriptions

(F) - Optical Disk Label Display

(h) - Help Display

Navigation

Sample Display

(I) - Inode Display

Navigation

Sample Display

(J) - Preview Shared Memory Display

Navigation

Sample Display

(K) - Kernel Statistics Display

Navigation

Sample Display

(l) - Usage Display

Sample Display

(L) - Shared Memory Tables

Sample Display

(m) - Mass Storage Status Display

Sample Display

Field Descriptions

(M) - Shared Memory Display

Navigation

Sample Display

(n) - Staging Status Display

Sample Display

(N) - File System Parameters Display

Navigation

Sample Display

(o) - Optical Disk Status Display

Navigation

Sample Display

Field Descriptions

(p) - Removable Media Load Requests Display

Navigation

Sample Display

Field Descriptions

Flags

(P) - Active Services Display

Navigation

Sample Display

(r) - Removable Media Status Display

Sample Display

Field Descriptions

(R) - Sun SAM-Remote Information Display

(s) - Device Status Display

Navigation

Sample Display

Field Descriptions

(S) - Sector Data Display

Navigation

(t) - Tape Drive Status Display

Navigation

Sample Display

Field Descriptions

(T) - SCSI Sense Data Display

Navigation

(u) - Staging Queue Display

Navigation

Sample Display

Field Descriptions

(U) - Device Table Display

Navigation

Sample Display

(v) - Automated Library Catalog Display

Navigation

Sample Display

Field Descriptions

Flags

(w) - Pending Stage Queue

Navigation

Sample Display

Field Descriptions

Operator Display Status Codes

Removable Media Device Display Status Codes

File System Display Status Codes

Operator Display Device States

procedure iconsmall spaceTo Change a Drive State from down to on

procedure iconsmall spaceTo Change a Drive State from on to down

Operator Commands

Device Commands

File System Commands: I/O Management

The :flush_behind eq value Command

The :force_nfs_async eq and :noforce_nfs_async eq Commands

The :readahead eq contig Command

The :sw_raid eq and :nosw_raid eq Commands

The :writebehind eq contig Command

The :wr_throttle eq value Command

File System Commands: Direct I/O Management

The :dio_rd_form_min eq value and :dio_wr_form_min eq value Commands

The :dio_rd_ill_min eq value and :dio_wr_ill_min eq value Commands

The :dio_rd_consec eq value and :dio_wr_consec eq value Commands

The :dio_szero eq and :nodio_szero eq Commands

The :forcedirectio eq and :noforcedirectio eq Commands

File System Commands: Sun StorEdge QFS Shared File Systems

The :meta_timeo eq interval Command

The :mh_write eq and :nomh_write eq Commands

The :minallocsz eq value and :maxallocsz eq value Commands

The :rdlease eq interval, :wrlease eq interval, and :aplease eq interval Commands

File System Commands: Miscellaneous

The :abr eq and :noabr eq Commands

The :dmr eq and :nodmr eq Commands

The :invalid eq interval Command

The :mm_stripe eq value Command

The :qwrite eq and :noqwrite eq Commands

The :refresh_at_eof eq and :norefresh_at_eof eq Commands

The :suid eq and :nosuid eq Commands

The :stripe eq value Command

The :sync_meta eq value Command

The :trace eq and :notrace eq Commands

Miscellaneous Commands

The :clear vsn [ index ] Command

The :devlog eq [ option ] Command

The :diskvols volume [+flag | -flag] Command

The :dtrace Commands

The :fs fsname Command

The :mount mntpt Command

The :open eq Command

The :read addr Command

The :refresh i Command

The :snap [ filename ] Command

The :! shell_command Command

Glossary

Index