Sun Logo


Sun StorEdge SAM-FS File System Configuration and Administration Guide

Version 4, Update 5

819-4333-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

vnode Interface

Sun StorEdge SAM-FS Archive Management

Additional File System Features

Design Basics

Inode Files and File Characteristics

Specifying Disk Allocation Units

DAU Settings and File System Geometry

Sun StorEdge SAM-FS File Systems

Dual Allocation Scheme

Data Alignment

Stripe Widths on Data Disks

File Allocation Methods

Metadata Allocation

Round-Robin Allocation

Striped Allocation

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

Example mcf File

Interactions Among File Settings, Options, and Directives

Initializing a File System

3. Performing Operational Tasks

Viewing Files and File Attributes

File Attributes and File States

System-Specified File States

Displaying File Information

About the sls(1) Output

About the Retention Line

Checksum Line Explanation

Propagating Configuration File Changes to the System

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

procedure iconsmall spaceTo Change archiver.cmd(4) or stager.cmd(4) Information

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

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

Configuring WORM-FS File Systems

Enabling the WORM-FS Feature

Using the WORM-FS Feature in SAM-QFS Environments

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

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 SAM-FS

Checking File System Integrity and Repairing File Systems

procedure iconsmall spaceTo Check a File System

procedure iconsmall spaceTo Repair a File System

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

Sun StorEdge SAM-FS Commands: Archiver Control

The :hwm_archive eq and :nohwm_archive eq Commands

The :thresh eq high low Command

Sun StorEdge SAM-FS Commands: Releaser Control

The :maxpartial eq value Command

The :partial eq value Command

Sun StorEdge SAM-FS Commands: Stager Control

The :partial_stage eq value Command

The :stage_flush_behind eq value Command

The :stage_n_window eq value Command

The :stage_retries eq value Command

The :stclear mt.vsn Command

The :stidle Command

The :strun Command

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: 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 :refresh_at_eof eq and :norefresh_at_eof eq Commands

The :suid eq and :nosuid eq Commands

The :stripe eq value Command

The :trace eq and :notrace eq Commands

Automated Library Commands

The :audit [ -e ] eq [ :slot [ :side ]] Commands

The :export eq:slot and :export mt.vsn Commands

The :import eq Command

The :load eq:slot [ :side ] and :load mt.vsn Commands

The :priority pid newpri Command

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