You are previewing Solaris ZFS Administration Guide.
O'Reilly logo
Solaris ZFS Administration Guide

Book Description

This book is intended for anyone responsible for setting up and administering ZFS file systems. Topics are described for both SPARC and x86 based systems, where appropriate.

Table of Contents

  1. Copyright
  2. Preface
    1. Who Should Use This Book
    2. How This Book Is Organized
    3. Related Books
    4. Documentation, Support, and Training
    5. Sun Welcomes Your Comments
    6. Typographic Conventions
    7. Shell Prompts in Command Examples
  3. 1. ZFS File System (Introduction)
    1. What's New in ZFS?
      1. Zone Migration in a ZFS Environment
      2. ZFS Installation and Boot Support
      3. Rolling Back a Dataset Without Unmounting
      4. Enhancements to the zfs send Command
      5. ZFS Quotas and Reservations for File System Data Only
      6. ZFS Storage Pool Properties
      7. ZFS Command History Enhancements (zpool history)
      8. Upgrading ZFS File Systems (zfs upgrade)
      9. ZFS Delegated Administration
      10. Setting Up Separate ZFS Logging Devices
      11. Creating Intermediate ZFS Datasets
      12. ZFS Hotplugging Enhancements
      13. Recursively Renaming ZFS Snapshots (zfs rename r)
      14. GZIP Compression is Available for ZFS
      15. Storing Multiple Copies of ZFS User Data
      16. Improved zpool status Output
      17. ZFS and Solaris iSCSI Improvements
      18. ZFS Command History (zpool history)
      19. ZFS Property Improvements
        1. ZFS xattr Property
        2. ZFS canmount Property
        3. ZFS User Properties
        4. Setting Properties When Creating ZFS File Systems
      20. Displaying All ZFS File System Information
      21. New zfs receive F Option
      22. Recursive ZFS Snapshots
      23. Double Parity RAID-Z (raidz2)
      24. Hot Spares for ZFS Storage Pool Devices
      25. Replacing a ZFS File System With a ZFS Clone (zfs promote)
      26. Upgrading ZFS Storage Pools (zpool upgrade)
      27. ZFS Backup and Restore Commands are Renamed
      28. Recovering Destroyed Storage Pools
      29. ZFS is Integrated With Fault Manager
      30. New zpool clear Command
      31. Compact NFSv4 ACL Format
      32. File System Monitoring Tool (fsstat)
      33. ZFS Web-Based Management
    2. What Is ZFS?
      1. ZFS Pooled Storage
      2. Transactional Semantics
      3. Checksums and Self-Healing Data
      4. Unparalleled Scalability
      5. ZFS Snapshots
      6. Simplified Administration
    3. ZFS Terminology
    4. ZFS Component Naming Requirements
  4. 2. Getting Started With ZFS
    1. ZFS Hardware and Software Requirements and Recommendations
    2. Creating a Basic ZFS File System
    3. Creating a ZFS Storage Pool
      1. How to Identify Storage Requirements for Your ZFS Storage Pool
      2. How to Create a ZFS Storage Pool
    4. Creating a ZFS File System Hierarchy
      1. How to Determine Your ZFS File System Hierarchy
      2. How to Create ZFS File Systems
  5. 3. ZFS and Traditional File System Differences
    1. ZFS File System Granularity
    2. ZFS Space Accounting
      1. Out of Space Behavior
    3. Mounting ZFS File Systems
    4. Traditional Volume Management
    5. New Solaris ACL Model
  6. 4. Installing and Booting a ZFS Root File System
    1. Installing and Booting a ZFS Root File System (Overview)
      1. ZFS Installation Features
      2. Solaris Installation and Solaris Live Upgrade Requirements for ZFS Support
    2. Installing a ZFS Root File System (Initial Installation)
    3. Installing a ZFS Root File System (JumpStart Installation)
      1. ZFS JumpStart Profile Examples
      2. ZFS JumpStart Keywords
      3. ZFS JumpStart Issues
    4. Migrating a UFS Root File System to a ZFS Root File System (Solaris Live Upgrade)
      1. ZFS Solaris Live Upgrade Migration Issues
      2. Using Solaris Live Upgrade to Migrate to a ZFS Root File System (Without Zones)
      3. Using Solaris Live Upgrade to Migrate or Upgrade a System With Zones (Solaris 10 10/08)
        1. How to Migrate a UFS Root File System With Zone Roots on UFS to a ZFS Root File System (Solaris 10 10/08)
        2. How to Configure a ZFS Root File System With Zone Roots on ZFS (Solaris 10 10/08)
        3. How to Upgrade or Patch a ZFS Root File System With Zone Roots on ZFS (Solaris 10 10/08)
      4. Using Solaris Live Upgrade to Migrate or Upgrade a System With Zones (Solaris 10 5/09)
        1. Supported ZFS with Zone Root Configuration Information (Solaris 10 5/09)
        2. How to Create a ZFS BE with a ZFS Root File System and a Zone Root (Solaris 10 5/09)
        3. How to Upgrade or Patch a ZFS Root File System With Zone Roots (Solaris 10 5/09)
        4. How to Migrate a UFS Root File System With Zone Root to a ZFS Root File System (Solaris 10 5/09)
    5. ZFS Support for Swap and Dump Devices
      1. Adjusting the Sizes of Your ZFS Swap and Dump Devices
    6. Booting From a ZFS Root File System
      1. Booting From a Alternate Disk in a Mirrored ZFS root Pool
      2. Booting From a ZFS Root File System on a SPARC Based System
      3. Booting From a ZFS Root File System on an x86 Based System
      4. Resolving ZFS Mount Point Problems That Prevent Successful Booting
        1. How to Resolve ZFS Mount Point Problems
    7. Recovering the ZFS Root Pool or Root Pool Snapshots
      1. How to Replace a Disk in the ZFS Root Pool
      2. How to Create Root Pool Snapshots
      3. How to Recreate a ZFS Root Pool and Restore Root Pool Snapshots
      4. How to Roll Back Root Pool Snapshots From a Failsafe Boot
  7. 5. Managing ZFS Storage Pools
    1. Components of a ZFS Storage Pool
      1. Using Disks in a ZFS Storage Pool
      2. Using Slices in a ZFS Storage Pool
      3. Using Files in a ZFS Storage Pool
    2. Replication Features of a ZFS Storage Pool
      1. Mirrored Storage Pool Configuration
      2. RAID-Z Storage Pool Configuration
      3. ZFS Hybrid Storage Pool
      4. Self-Healing Data in a Redundant Configuration
      5. Dynamic Striping in a Storage Pool
    3. Creating and Destroying ZFS Storage Pools
      1. Creating a ZFS Storage Pool
        1. Creating a Basic Storage Pool
        2. Creating a Mirrored Storage Pool
        3. Creating a ZFS Root Pool
        4. Creating RAID-Z Storage Pools
        5. Creating a ZFS Storage Pool with Log Devices
      2. Displaying Storage Pool Virtual Device Information
      3. Handling ZFS Storage Pool Creation Errors
        1. Detecting In-Use Devices
        2. Mismatched Replication Levels
        3. Doing a Dry Run of Storage Pool Creation
        4. Default Mount Point for Storage Pools
      4. Destroying ZFS Storage Pools
        1. Destroying a Pool With Faulted Devices
    4. Managing Devices in ZFS Storage Pools
      1. Adding Devices to a Storage Pool
      2. Attaching and Detaching Devices in a Storage Pool
      3. Onlining and Offlining Devices in a Storage Pool
        1. Taking a Device Offline
        2. Bringing a Device Online
      4. Clearing Storage Pool Devices
      5. Replacing Devices in a Storage Pool
      6. Designating Hot Spares in Your Storage Pool
        1. Activating and Deactivating Hot Spares in Your Storage Pool
    5. Managing ZFS Storage Pool Properties
    6. Querying ZFS Storage Pool Status
      1. Displaying Basic ZFS Storage Pool Information
        1. Listing Information About All Storage Pools
        2. Listing Specific Storage Pool Statistics
        3. Scripting ZFS Storage Pool Output
      2. Viewing ZFS Storage Pool I/O Statistics
        1. Listing Pool-Wide Statistics
        2. Listing Virtual Device Statistics
      3. Determining the Health Status of ZFS Storage Pools
        1. Basic Storage Pool Health Status
        2. Detailed Health Status
    7. Migrating ZFS Storage Pools
      1. Preparing for ZFS Storage Pool Migration
      2. Exporting a ZFS Storage Pool
      3. Determining Available Storage Pools to Import
      4. Finding ZFS Storage Pools From Alternate Directories
      5. Importing ZFS Storage Pools
      6. Recovering Destroyed ZFS Storage Pools
      7. Upgrading ZFS Storage Pools
  8. 6. Managing ZFS File Systems
    1. Creating and Destroying ZFS File Systems
      1. Creating a ZFS File System
      2. Destroying a ZFS File System
      3. Renaming a ZFS File System
    2. Introducing ZFS Properties
      1. ZFS Read-Only Native Properties
        1. The used Property
      2. Settable ZFS Native Properties
        1. The canmount Property
        2. The recordsize Property
        3. The volsize Property
      3. ZFS User Properties
    3. Querying ZFS File System Information
      1. Listing Basic ZFS Information
      2. Creating Complex ZFS Queries
    4. Managing ZFS Properties
      1. Setting ZFS Properties
      2. Inheriting ZFS Properties
      3. Querying ZFS Properties
        1. Querying ZFS Properties for Scripting
    5. Mounting and Sharing ZFS File Systems
      1. Managing ZFS Mount Points
        1. Automatic Mount Points
        2. Legacy Mount Points
      2. Mounting ZFS File Systems
      3. Using Temporary Mount Properties
      4. Unmounting ZFS File Systems
      5. Sharing and Unsharing ZFS File Systems
        1. Controlling Share Semantics
        2. Unsharing ZFS File Systems
        3. Sharing ZFS File Systems
        4. Legacy Share Behavior
    6. ZFS Quotas and Reservations
      1. Setting Quotas on ZFS File Systems
      2. Setting Reservations on ZFS File Systems
  9. 7. Working With ZFS Snapshots and Clones
    1. Overview of ZFS Snapshots
      1. Creating and Destroying ZFS Snapshots
        1. Renaming ZFS Snapshots
      2. Displaying and Accessing ZFS Snapshots
        1. Snapshot Space Accounting
      3. Rolling Back a ZFS Snapshot
    2. Overview of ZFS Clones
      1. Creating a ZFS Clone
      2. Destroying a ZFS Clone
      3. Replacing a ZFS File System With a ZFS Clone
    3. Sending and Receiving ZFS Data
      1. Sending a ZFS Snapshot
      2. Receiving a ZFS Snapshot
      3. Sending and Receiving Complex ZFS Snapshot Streams
        1. Remote Replication of ZFS Data
      4. Saving ZFS Data With Other Backup Products
  10. 8. Using ACLs to Protect ZFS Files
    1. New Solaris ACL Model
      1. Syntax Descriptions for Setting ACLs
      2. ACL Inheritance
      3. ACL Property Modes
    2. Setting ACLs on ZFS Files
    3. Setting and Displaying ACLs on ZFS Files in Verbose Format
      1. Setting ACL Inheritance on ZFS Files in Verbose Format
    4. Setting and Displaying ACLs on ZFS Files in Compact Format
  11. 9. ZFS Delegated Administration
    1. Overview of ZFS Delegated Administration
      1. Disabling ZFS Delegated Permissions
    2. Delegating ZFS Permissions
      1. Syntax Descriptionfor Delegating Permissions (zfs allow)
      2. Removing ZFS Delegated Permissions (zfs unallow)
    3. Using ZFS Delegated Administration
      1. Displaying ZFS Delegated Permissions (Examples)
      2. Delegating ZFS Permissions (Examples)
      3. Removing ZFS Permissions (Examples)
  12. 10. ZFS Advanced Topics
    1. ZFS Volumes
      1. Using a ZFS Volume as a Swap or Dump Device
      2. Using a ZFS Volume as a Solaris iSCSI Target
    2. Using ZFS on a Solaris System With Zones Installed
      1. Adding ZFS File Systems to a Non-Global Zone
      2. Delegating Datasets to a Non-Global Zone
      3. Adding ZFS Volumes to a Non-Global Zone
      4. Using ZFS Storage Pools Within a Zone
      5. Managing ZFS Properties Within a Zone
      6. Understanding the zoned Property
    3. Using ZFS Alternate Root Pools
      1. Creating ZFS Alternate Root Pools
      2. Importing Alternate Root Pools
    4. ZFS Rights Profiles
  13. 11. ZFS Troubleshooting and Data Recovery
    1. ZFS Failure Modes
      1. Missing Devices in a ZFS Storage Pool
      2. Damaged Devices in a ZFS Storage Pool
      3. Corrupted ZFS Data
    2. Checking ZFS Data Integrity
      1. Data Repair
      2. Data Validation
      3. Controlling ZFS Data Scrubbing
        1. Explicit ZFS Data Scrubbing
        2. ZFS Data Scrubbing and Resilvering
    3. Identifying Problems in ZFS
      1. Determining if Problems Exist in a ZFS Storage Pool
      2. Reviewing zpool status Output
        1. Overall Pool Status Information
        2. Configuration Information
        3. Scrubbing Status
        4. Data Corruption Errors
      3. System Reporting of ZFS Error Messages
    4. Repairing a Damaged ZFS Configuration
    5. Repairing a Missing Device
      1. Physically Reattaching the Device
      2. Notifying ZFS of Device Availability
    6. Repairing a Damaged Device
      1. Determining the Type of Device Failure
      2. Clearing Transient Errors
      3. Replacing a Device in a ZFS Storage Pool
        1. Determining if a Device Can Be Replaced
        2. Devices That Cannot be Replaced
        3. Replacing a Device in a ZFS Storage Pool
        4. Viewing Resilvering Status
    7. Repairing Damaged Data
      1. Identifying the Type of Data Corruption
      2. Repairing a Corrupted File or Directory
      3. Repairing ZFS Storage Pool-Wide Damage
    8. Repairing an Unbootable System