Skip Navigation Links
Sun QFS File System 5.3 Configuration and Administration Guide
Sun QFS and Sun Storage Archive Manager 5.3 Information Library
Search Scope:
This Document
Entire Library
Sun QFS File System 5.3 Configuration and Administration Guide
June 2012
Sun QFS File System 5.3 Configuration and Administration Guide
Document Information
Preface
1. File System Overview
General File System Configurations
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
Additional File System Features
Sun QFS File Systems 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
Stripe Widths on
ms
File Systems
Stripe Widths on
ma
File Systems Not Using Striped Groups
Stripe Widths on
ma
File Systems Using Striped Groups
Stripe Widths on Metadata Disks
File Allocation Methods
Metadata Allocation
Round-Robin Allocation
Striped Allocation
Striped Groups
Mismatched Striped Groups
Example of a Mismatched Striped Group
Per-Logical Unit Number (LUN) Allocation Control
2. About the Master Configuration File
Basic
mcf
File Structure
mcf
File Fields
Equipment Identifier Field (Required)
The Equipment Number Field (Required)
The Equipment Type Field (Required)
Family Set Field (Required)
Device State Field (Optional)
Additional Parameters Field (Optional)
Examples of
mcf
Files
Interactions Among File Settings, Options, and Directives Introduction
3.
mcf
File Examples
Configuration Examples for Local File Systems
Simple File System Configuration Example
How to Configure a Simple File System
Round-Robin Configuration Example
How to Configure the System for Round-Robin Allocation
Local Striping Configuration Example
How to Configure the System for Local Striping
Striped Group Configuration Example
How to Configure the System for Striped Groups
Configuration Example for a Shared File System on an Oracle Solaris OS Platform
How to Configure the Shared File System
Configuration Examples for Highly Available File Systems
How to Create an
mcf
File for a Highly Available File System
Configuration Example for a Shared File System on an Oracle Solaris Cluster Platform
How to Create an
mcf
File for a Shared File System in an Oracle Solaris Cluster Environment
4. Configuring the File System
Function of the
mcf
File
Initializing a File System
Configuration Examples
How to Create a Round-Robin Disk Configuration
How to Create a Striped Disk Configuration
How to Create a Striped Group Configuration
5. Configuring a Shared File System
Using Shared QFS With NFS
How to Configure Shared Sun QFS With NFS
Mounting and Unmounting Shared File Systems
How to Mount a Shared File System
How to Unmount a Shared File System
Adding or Removing a Client Host
How to Add a Client Host to a Shared File System
How to Remove a Client Host From a Shared File System
Updating the
mcf
file in a Shared File System Environment
Creating the Local Hosts Configuration File
Changing the Metadata Server
Changing the Metadata Server in a Shared File System Environment
How to Change the Metadata Server When the Metadata Server Is Available
How to Change the Metadata Server When the Metadata Server Is Not Available
Changing the Metadata Server in an Archiving Environment
How to Change the Metadata Server in an Archiving Environment
Converting an Unshared File System to a Shared File System
How to Convert an Unshared Metadata Server to a Shared Metadata Server
How to Add a Client to the Metadata Server
Converting a Shared File System to an Unshared File System
How to Remove a Client From a Shared File System
How to Convert a Shared Metadata Server to an Unshared System
Client-Server Communications in a Shared File System
Adding Disk Cache to a File System
How to Add Disk Cache to a File System
Recreating a File System
How to Back Up and Re-Create a File System
6. Administering File System Quotas
About File System Quotas
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
How to Configure a New File System to Use Quotas
How to Configure an Existing File System to Use Quotas
How to Assign Admin Set IDs to Directories and Files
Setting Infinite Quotas
Enabling Default Quota Values
Enabling Limits
How to Enable or Change Limits for Users, Groups, or Admin Sets Using an Existing Quota File
Checking Quotas
Changing and Removing Quotas
How to Change the Grace Period
Changing the Grace Period Expiration
Inhibiting Additional File System Resource Allocations
How to Inhibit Additional File System Resource Allocations
How to Remove the Quotas for a File System
How to Correct Quotas
7. Advanced File System 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
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
Accommodating Large Files
Configuring a Multireader File System
About I/O Types
Paged I/O
Direct I/O
I/O Switching
8. SMB Service in SAM-QFS
Getting Started With the Oracle Solaris SMB Service
share
Command
Case-Insensitivity Support
DOS Attributes Support
Using ACLs to Protect Sun QFS and SAM-QFS Files
Mapping User and Group Identities in SAM-QFS
Creating and Converting File Systems to Support NFSv4 ACLs
Syntax Descriptions for Setting ACLs
ACL Inheritance
9. Configuring WORM-FS File Systems
About WORM-FS File Systems
Using WORM-FS With NFS Clients
Enabling the WORM-FS Feature
WORM Lite Options
Creating WORM Files
Retention Periods
Setting the Default Retention Period
Setting the Retention Period Using
touch
Using
sls
to View WORM-FS Files
Using
sfind
to Find WORM-FS Files
10. Tunable Parameters
Increasing File Transfer Performance for Large Files
How to 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
ninodes
Parameter
nhino
Parameter
When to Set the
ninodes
and
nhino
Parameters
11. Using QFS File Systems with SANergy (SAN-QFS)
Using the SAN-QFS File System in a Heterogeneous Computing Environment
SAN-QFS Shared File System and Sun QFS Shared File System Comparison
Enabling the SAN-QFS File System
Before You Begin
How to Enable the SAN-QFS File System on the Metadata Controller
How to Enable the SAN-QFS File System on the Clients
How to Install the SANergy Software on the Clients
Unmounting the SAN-QFS File System
How to Unmount the SAN-QFS File System on the SANergy Clients
How to Unmount the SAN-QFS File System on the Metadata Controller
How to Unmount the SAN-QFS File System on the Sun QFS Clients
How to Unmount the SAN-QFS File System on the Sun QFS Server
Troubleshooting: Unmounting a SAN-QFS File System With SANergy File Holds
How to Unmount a File System in the Presence of SANergy File Holds
Using
samgrowfs
to Expand SAN-QFS File Systems
12. Mount Options in a Shared File System
Shared File System Mount Options
Mounting in the Background: (
bg
Option)
Reattempting a File System Mount: (
retry
Option)
Declaring a Sun QFS Shared File System: (
shared
Option)
Tuning Allocation Sizes: (
minallocsz
and
maxallocsz
Options)
Using Leases in a Sun QFS Shared File System: (
rdlease
,
wrlease
, and
aplease
Options)
Enabling Multiple Host Reads and Writes: (
mh_write
Option)
Setting the Minimum Number of Concurrent Threads: (
min_pool
Option)
Retaining Cached Attributes: (
meta_timeo
Option)
Specifying Striped Allocation: (
stripe
Option)
Specifying the Frequency With Which Metadata Is Written: (
sync_meta
Option)
Enabling WORM Functionality: (
worm_capable
and
def_retention
Options)
13. Using the
samu
Operator Utility
samu
Operator Utility at a Glance
Overview of the
samu
Operator Utility
How to Start the
samu
Utility
How to Display a
samu
Screen
How to Stop
samu
Interacting With
samu
Identifying a Device
Accessing Online Help
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 Disc 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 Disc 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
Status Codes
Removable Media Device Display Status Codes
File System Display Status Codes
States of an Operator Display Device
How to Change a Drive State From
down
to
on
Operator Commands
Device Commands
File System Commands: I/O Management
The
flush_behind
Command
force_nfs_async
and
noforce_nfs_async
Commands
readahead
Command
sw_raid
and
nosw_raid
Commands
writebehind
Command
wr_throttle
Command
File System Commands: Direct I/O Management
dio_rd_form_min
and
dio_wr_form_min
Commands
dio_rd_ill_min
and
dio_wr_ill_min
Commands
dio_rd_consec
and
dio_wr_consec
Commands
dio_szero
and
nodio_szero
Commands
forcedirectio
and
noforcedirectio
Commands
File System Commands: Sun QFS Shared File Systems
meta_timeo
Command
mh_write
and
nomh_write
Commands
minallocsz
and
maxallocsz
Commands
rdlease
,
wrlease
, and
aplease
Commands
File System Commands: Miscellaneous
abr
and
noabr
Commands
dmr
and
nodmr
Commands
invalid
interval Command
mm_stripe
Command
qwrite
and
noqwrite
Commands
refresh_at_eof
and
norefresh_at_eof
Commands
suid
and
nosuid
Commands
stripe
Command
sync_meta
Command
trace
and
notrace
Commands
Miscellaneous Commands
clear
vsn
Command
devlog
Command
diskvols
flag Command
dtrace
Commands
fs
Command
mount
Command
open
Command
read
Command
refresh
Command
snap
Command
!
shell-command
Command