| Title and Copyright Information |
| About This Manual |
| Audience |
| New and Changed Features |
| Organization |
| Related Documentation |
| Reader's Comments |
| Conventions |
| 1 | Planning the File System |
| 1.1 | What is AdvFS? |
| 1.2 | License Registration |
| 1.3 | File System Design |
| 1.3.1 | Filesets, Domains, and Volumes |
| 1.3.2 | Transaction Log File |
| 1.3.3 | File Storage Allocation |
| 1.4 | Setting Up an AdvFS File System |
| 1.4.1 | Configuring Domains and Filesets |
| 1.4.2 | Organizing Volumes |
| 1.5 | Choosing Storage for AdvFS |
| 2 | Setting Up the File System |
| 2.1 | Overview |
| 2.2 | Volumes |
| 2.2.1 | Volume Attributes |
| 2.3 | Domains |
| 2.3.1 | The /etc/fdmns Directory |
| 2.3.2 | Displaying Domain Information |
| 2.3.3 | Creating Domains |
| 2.3.3.1 | Domain Version Numbers |
| 2.3.3.2 | Creating Domains with DVN4 |
| 2.3.3.3 | Creating Domains with DVN3 |
| 2.3.3.4 | Upgrading Domains to DVN4 |
| 2.3.4 | Increasing the Size of Domains |
| 2.3.4.1 | Increasing Storage in Domains by Adding Volumes |
| 2.3.4.2 | Increasing Storage in Domains by Exchanging Volumes |
| 2.3.4.3 | Increasing Storage in Domains by Extending an Existing Volume |
| 2.3.5 | Reducing the Size of Domains |
| 2.3.6 | Removing Domains |
| 2.3.7 | Renaming Domains |
| 2.4 | Filesets |
| 2.4.1 | Designating Filesets in the /etc/fstab File |
| 2.4.2 | Displaying Fileset Information |
| 2.4.3 | Creating Filesets |
| 2.4.4 | Upgrading Filesets |
| 2.4.5 | Mounting Filesets |
| 2.4.6 | Unmounting Filesets |
| 2.4.7 | Removing a Fileset |
| 2.4.8 | Renaming Filesets |
| 2.4.9 | Changing the Characteristics of Filesets |
| 2.4.10 | AdvFS Fileset Clones |
| 2.4.10.1 | Creating an AdvFS Fileset Clone |
| 2.4.10.2 | Mounting and Unmounting an AdvFS Fileset Clone |
| 2.4.10.3 | Removing an AdvFS Fileset Clone |
| 2.4.10.4 | Renaming an AdvFS Fileset Clone |
| 2.5 | Configuring an AdvFS root File System |
| 2.5.1 | Mounting the root File System in Single-User Mode |
| 2.5.2 | Changing the Name of the root Domain |
| 2.5.3 | Changing the Name of the root Fileset |
| 2.6 | Setting Up Trashcans for File Recovery |
| 3 | Managing Quotas |
| 3.1 | Introducing Quotas |
| 3.1.1 | Quota Limits |
| 3.1.2 | Grace Period |
| 3.1.3 | Summarizing Quota Characteristics |
| 3.2 | User and Group Quotas |
| 3.2.1 | User and Group Quota Files |
| 3.2.2 | Setting User and Group Quotas and Grace Periods |
| 3.2.2.1 | Setting User Quotas |
| 3.2.2.2 | Setting the User Grace Period |
| 3.2.2.3 | Setting Group Quotas |
| 3.2.2.4 | Setting the Group Grace Period |
| 3.2.2.5 | Setting a Temporary Grace Period |
| 3.2.3 | Setting User and Group Quotas for Multiple Users and Groups |
| 3.2.3.1 | Setting Quotas for Multiple Users |
| 3.2.3.2 | Setting Quotas for Multiple Groups |
| 3.2.4 | Activating User and Group Quotas at System Start-Up |
| 3.2.5 | Activating User and Group Quotas Manually |
| 3.2.6 | Deactivating User and Group Quotas |
| 3.3 | Fileset Quotas |
| 3.3.1 | Fileset Quota Files |
| 3.3.2 | Setting Fileset Quotas and Grace Periods |
| 3.3.2.1 | Setting Fileset Quotas |
| 3.3.2.2 | Setting the Grace Period |
| 3.3.3 | Setting Fileset Quotas for Multiple Filesets |
| 3.3.4 | Activating Fileset Quotas |
| 3.3.5 | Deactivating Fileset Quotas |
| 3.4 | Verifying Fileset and Disk Space Usage |
| 3.4.1 | Examining User and Group Quotas |
| 3.4.1.1 | Printing the Tag and Full Pathname for Each File |
| 3.4.1.2 | Summarizing Fileset Ownership |
| 3.4.1.3 | Displaying Disk Usage and Limits |
| 3.4.1.4 | Verifying User and Group Quota Consistency |
| 3.4.1.5 | Summarizing User and Group Quotas by Fileset |
| 3.4.2 | Examining Fileset Quotas |
| 3.4.2.1 | Displaying Fileset Space |
| 3.4.2.2 | Displaying Fileset Limits |
| 3.4.2.3 | Displaying Domain Space |
| 3.4.2.4 | Displaying Domain and Fileset Space |
| 4 | Backing Up and Restoring Data |
| 4.1 | Data and Metadata Integrity |
| 4.1.1 | Ensuring Data Integrity |
| 4.1.1.1 | Ensuring Data Integrity Using An Application's Quiesce Function |
| 4.1.1.2 | Ensuring Data Integrity Using Synchronous Writing |
| 4.1.1.3 | Ensuring Data Integrity Without Using Synchronous Writing |
| 4.1.2 | Ensuring Metadata Integrity |
| 4.1.2.1 | Ensuring Metadata Integrity by Freezing Domains |
| 4.1.2.2 | Ensuring Metadata Integrity by Unmounting Filesets |
| 4.2 | Creating a Backup Source |
| 4.2.1 | Using a Mounted Original Fileset as a Backup Source |
| 4.2.1.1 | Advantages and Disadvantages |
| 4.2.1.2 | Ensuring Data and Metadata Integrity |
| 4.2.1.3 | Preparing the Backup Source |
| 4.2.2 | Using a Mounted Fileset Clone as a Backup Source |
| 4.2.2.1 | Advantages and Disadvantages |
| 4.2.2.2 | Ensuring Data and Metadata Integrity |
| 4.2.2.3 | Preparing the Backup Source |
| 4.2.3 | Using a Mounted Fileset from an LSM Split Mirror as a Backup Source |
| 4.2.3.1 | Advantages and Disadvantages |
| 4.2.3.2 | Ensuring Data and Metadata Integrity |
| 4.2.3.3 | Preparing the Backup Source |
| 4.2.4 | Using a Mounted Fileset from a Controller-Based Clone as a Backup Source |
| 4.2.4.1 | Advantages and Disadvantages |
| 4.2.4.2 | Ensuring Data and Metadata Integrity |
| 4.2.4.3 | Preparing the Backup Source |
| 4.2.5 | Using a Mounted Fileset from a Controller-Based Snapshot as a Backup Source |
| 4.2.5.1 | Advantages and Disadvantages |
| 4.2.5.2 | Ensuring Data and Metadata Integrity |
| 4.2.5.3 | Preparing the Backup Source |
| 4.3 | Backup Methods and Tools |
| 4.3.1 | Introduction to the vdump and vrestore Commands |
| 4.3.2 | Unique Features of the vdump Command |
| 4.3.3 | Specifying Backup Level Using the vdump Command |
| 4.3.4 | Dumping to Tape Using the vdump Command |
| 4.3.5 | Dumping to Standard Output Using the vdump Command |
| 4.3.6 | Dumping Subdirectories Using the vdump Command |
| 4.3.7 | Dumping to Files or Disk Partitions |
| 4.3.8 | Compressing Savesets |
| 4.3.9 | Dumping with Error Protection |
| 4.3.10 | Listing Saved Files in a vdump Saveset |
| 4.3.11 | Backing Up a System Disk Using the clonefset and vdump Commands an Example |
| 4.3.12 | Dumping and Restoring Files Remotely |
| 4.3.13 | Unique Features of the vrestore Command |
| 4.3.14 | Restoring Files Using the vrestore Command |
| 4.3.15 | Restoring Quotas Using the vrestore Command |
| 4.3.16 | Restoring from a Tape with Many Savesets Using the vrestore Command |
| 5 | Optimizing and Tuning the AdvFS File System |
| 5.1 | Monitoring Performance |
| 5.2 | Improving Performance by Disabling the Frag File |
| 5.3 | Improving Transaction Log File Performance |
| 5.3.1 | Moving the Transaction Log File |
| 5.3.2 | Isolating the Transaction Log File |
| 5.4 | Data Cache Tuning |
| 5.5 | Improving Data Consistency |
| 5.5.1 | Controlling I/O |
| 5.5.1.1 | Asynchronous I/O |
| 5.5.1.2 | Synchronous I/O |
| 5.5.1.3 | Turning Synchronous I/O On and Off |
| 5.5.2 | Enabling Atomic-Write Data Logging I/O |
| 5.5.2.1 | Asynchronous Atomic-Write Data Logging I/O |
| 5.5.2.2 | Synchronous Atomic-Write Data Logging I/O |
| 5.5.2.3 | Persistent Atomic-Write Data Logging |
| 5.5.2.4 | Temporary Atomic-Write Data Logging |
| 5.5.2.5 | Turning Atomic-Write Data Logging On and Off |
| 5.6 | Improving Data Transfer Rate with Direct I/O |
| 5.7 | Changing Attributes to Improve System Performance |
| 5.8 | Improving Operating System Throughput with the vfast Utility |
| 5.8.1 | Choosing to Run the vfast Utility |
| 5.8.2 | Examples of the vfast Utility |
| 5.9 | Defragmenting a Domain |
| 5.10 | Defragmenting a File |
| 5.11 | Balancing a Multivolume Domain |
| 5.12 | Migrating Files to Different Volumes |
| 5.13 | Striping Files |
| 5.14 | Moving a Domain and its Filesets to a New Volume |
| 5.15 | Controlling Domain Panic Information |
| 6 | Troubleshooting |
| 6.1 | Recovering a User File |
| 6.2 | General Recovery Procedures |
| 6.2.1 | Saving Data for a Problem Report |
| 6.2.2 | Saving Copies of System Metadata |
| 6.2.3 | Saving Undamaged Filesets |
| 6.2.4 | Verifying File System Consistency |
| 6.2.5 | Fixing On-Disk Metadata Corruptions with the fixfdmn Utility |
| 6.2.6 | Salvaging File Data from a Corrupted Domain |
| 6.2.6.1 | Recovering File Data |
| 6.2.6.2 | Recovering Data from a Corrupted root Domain |
| 6.2.6.3 | Recovering Data Block by Block |
| 6.3 | Fixing Problems |
| 6.3.1 | Recovering from a Domain Panic |
| 6.3.2 | Recovering from Filesets That are Mounted Read-Only |
| 6.3.3 | Restoring the /etc/fdmns Directory |
| 6.3.3.1 | Reconstructing the /etc/fdmns Directory Manually |
| 6.3.3.2 | Reconstructing the /etc/fdmns Directory Using the advscan Command |
| 6.3.4 | Recovering from Data Corruption of an AdvFS root Domain |
| 6.3.5 | Recovering from Hardware Corruption |
| 6.3.6 | Moving an AdvFS Disk to Another Machine |
| 6.3.7 | Restoring a Multivolume usr Domain |
| 6.3.8 | Recovering from Accidental Use of the mkfdmn or addvol Command |
| 6.4 | Preventing Problems |
| 6.4.1 | Checking Free Space and Disk Usage |
| 6.4.2 | Reusing Volumes |
| 6.4.3 | Failing Disks |
| 6.4.4 | Controlling Disk Usage |
| 6.4.5 | Quota and Grace Period Limits |
| 6.4.5.1 | Exceeding Quota Limits |
| 6.4.5.2 | Saving Up to Quota Limits |
| 6.4.5.3 | Changing Quota Limits |
| 6.4.5.4 | Turning Off the Grace Period |
| 6.4.6 | Avoiding Disk Structure Incompatibility |
| 6.4.7 | Avoiding Utility Incompatibility |
| 6.4.8 | Avoiding Log File Inconsistency |
| 6.4.9 | Increasing the Size of an AdvFS root Domain |
| 6.4.9.1 | Increasing the Size of the root Volume |
| 6.4.9.2 | Replacing the root Volume with a Larger Device |
| 6.4.10 | Memory Mapping, Direct I/O, and Data Logging Incompatibility |
| 6.4.11 | Preventing Access to Old Data |
| 6.4.12 | Invalid or Corrupt Saveset Format |
| 6.4.13 | Overcoming Poor Performance |
| 6.4.14 | The rmvol or migrate Command Will Not Start |
| A | Accessing File System Information with the SysMan Menu |
| B | AdvFS Commands |
| B.1 | AdvFS Base System Commands |
| B.2 | AdvFS Utilities Commands |
| B.3 | Comparison of AdvFS and UFS Commands |
| C | Converting File Systems |
| C.1 | Converting a /usr File System to AdvFS |
| C.1.1 | Using a Backup Tape |
| C.1.2 | Using an Intermediate File |
| C.1.3 | Using a Second Disk |
| C.2 | Converting the root File System to AdvFS |
| C.3 | Converting a File System to AdvFS |
| C.3.1 | Using a Backup Tape |
| C.3.2 | Using an Intermediate File |
| C.3.3 | Using a Second Disk |
| C.3.4 | Using a Second System |
| C.4 | Converting from AdvFS to UFS |
| C.4.1 | Converting the root File System to UFS |
| C.4.2 | Converting a Fileset to UFS |
| D | Data Management Applications Programming Interface (DMAPI) |
| E | Graphical User Interfaces |
| E.1 | Installing the AdvFS GUI |
| E.2 | Components of the GUI |
| E.2.1 | GUI Agent (advfsd) |
| E.2.2 | AdvFS GUI (dtadvfs) |
| E.2.2.1 | GUI Security |
| E.2.2.2 | Ignoring Disks |
| E.2.2.3 | Log Files |
| E.2.2.4 | Help |
| E.2.2.5 | Monitoring Remote File Systems |
| E.2.2.6 | Managing LSM Volumes |
| E.3 | Displaying File System Information |
| E.3.1 | Choosing Units for Displaying Information |
| E.3.2 | Main Window |
| E.3.3 | Devices and Volumes Window |
| E.4 | Performing File System Operations |
| E.4.1 | Operations on a Domain |
| E.4.1.1 | Creating a Domain |
| E.4.1.2 | Setting a Free Space Alert for a Domain |
| E.4.1.3 | Enlarging a Domain |
| E.4.1.4 | Removing a Domain |
| E.4.1.5 | Renaming a Domain |
| E.4.2 | Operations on a Fileset |
| E.4.2.1 | Creating a Fileset |
| E.4.2.2 | Mounting a Fileset |
| E.4.2.3 | Unmounting a Fileset |
| E.4.2.4 | Setting a Free Space Alert for a Fileset |
| E.4.2.5 | Setting Fileset Quotas |
| E.4.2.6 | Removing a Fileset |
| E.4.2.7 | Renaming a Fileset |
| E.4.3 | Operations on an AdvFS Fileset Clone |
| E.4.3.1 | Creating an AdvFS Fileset Clone |
| E.4.3.2 | Mounting a Clone |
| E.4.3.3 | Unmounting a Clone |
| E.4.3.4 | Removing a Clone |
| E.4.4 | Operations on a Volume |
| E.4.4.1 | Setting a Free Space Alert for a Volume |
| E.4.4.2 | Adding a Volume |
| E.4.4.3 | Removing a Volume |
| E.4.5 | Maintaining AdvFS |
| E.4.5.1 | Balancing a Multivolume Domain |
| E.4.5.2 | Defragmenting a Domain |
| E.5 | GUI Operation |
| F | Application Programming Interface (API) |
| Glossary |
| Figures |
| 1-1 | AdvFS File System Design |
| 2-1 | Single-Volume Domain |
| 2-2 | Enlarging a Domain |
| 2-3 | Cloning a Fileset |
| 5-1 | Balancing a Domain |
| 5-2 | Migrating Files |
| Tables |
| 1-1 | Domain and Fileset Configuration Tradeoffs |
| 1-2 | AdvFS Volume Configuration Tradeoffs |
| 2-1 | Trashcan Commands |
| 3-1 | Quota Size Limits |
| 3-2 | Comparing User and Group Quotas with Fileset Quotas |
| 3-3 | User and Group Usage Commands |
| 3-4 | User and Group Usage Commands |
| 4-1 | Using a Mounted Original Fileset as a Backup Source |
| 4-2 | Using a Mounted Fileset Clone as a Backup Source |
| 4-3 | Using an LSM Split Mirror as a Backup Source |
| 4-4 | Using a Mounted Fileset from a Controller-Based Clone as a Backup Source |
| 4-5 | Using a Mounted Fileset from a Controller-Based Snapshot as a Backup Source |
| 5-1 | Turning Atomic-Write Data Logging On |
| 5-2 | Turning Atomic- Write Data Logging Off |
| 6-1 | Incorrect Number of Links |
| 6-2 | Incorrect Domain Volume Count |
| 6-3 | Incorrect Number of Partitions |
| 6-4 | Disk Space Usage Commands |
| B-1 | AdvFS Configuration Commands |
| B-2 | AdvFS Information Display Commands |
| B-3 | AdvFS Backup Commands |
| B-4 | AdvFS Check and Repair Commands |
| B-5 | AdvFS Quota Commands |
| B-6 | AdvFS Disk Structure Commands |
| B-7 | AdvFS Utilities Commands |
| B-8 | Comparison of AdvFS and UFS Commands |
| E-1 | AdvFS GUI Subsets |
| E-2 | Disk Space Requirements for the AdvFS GUI |
| E-3 | GUI Troubleshooting |
| Index |