| Title and Copyright Information |
| About This Manual |
| Audience |
| New and Changed Features |
| Organization |
| Related Documentation |
| Reader's Comments |
| Conventions |
| 1 | Overview |
| 1.1 | Overview of the LSM Object Hierarchy |
| 1.1.1 | LSM Disk |
| 1.1.1.1 | Disk Access Name |
| 1.1.1.2 | Disk Media Name |
| 1.1.2 | Disk Group |
| 1.1.3 | Subdisk |
| 1.1.4 | Data Plex |
| 1.1.4.1 | Concatenated Data Plex |
| 1.1.4.2 | Striped Data Plex |
| 1.1.4.3 | RAID 5 Data Plex |
| 1.1.5 | Log Plex |
| 1.1.6 | LSM Volume |
| 1.1.6.1 | Nonredundant Volumes |
| 1.1.6.2 | Mirrored Volumes |
| 1.1.6.3 | RAID 5 Volumes |
| 1.1.6.4 | Volume Usage Types |
| 1.1.6.5 | Volume Device Interfaces |
| 1.2 | Overview of LSM Interfaces |
| 1.2.1 | LSM Command-Line Interpreter |
| 1.2.2 | Storage Administrator Interface |
| 2 | Planning LSM Volumes and Disk Groups |
| 2.1 | Planning LSM Volumes |
| 2.1.1 | Planning Dirty-Region Logs |
| 2.1.2 | Planning RAID 5 Logs |
| 2.1.3 | Worksheet for LSM Volumes with Concatenated Plexes |
| 2.1.4 | Worksheet for LSM Volumes with Striped Plexes |
| 2.1.5 | Worksheet for LSM Volumes with a RAID 5 Plex |
| 2.2 | Planning Disk Groups |
| 2.2.1 | Guidelines for the Number and Usage of Disks |
| 2.2.2 | Guidelines for Connectivity and Availability |
| 2.2.3 | Worksheet for Planning Disk Groups |
| 2.3 | Finding Unused Storage Devices |
| 2.3.1 | Using the Disk Configuration GUI to Find Unused Disks |
| 2.3.2 | Using Operating System Commands to Find Unused Disks |
| 2.3.3 | Using the LSM voldisk Command to Find Unused Disks |
| 3 | Installing and Initializing the LSM Software |
| 3.1 | Installing the LSM Software |
| 3.2 | Installing the LSM License |
| 3.3 | Initializing LSM |
| 3.4 | Using LSM for Critical File Systems and Swap Space |
| 3.4.1 | Creating Alternate Boot Disks (Standalone System) |
| 3.4.1.1 | Restrictions and Requirements |
| 3.4.1.2 | Encapsulating System Partitions (Creating System Volumes) |
| 3.4.1.3 | Mirroring System Volumes |
| 3.4.1.4 | Displaying Information for System Volumes |
| 3.4.2 | Using LSM Volumes for Cluster Domains |
| 3.4.2.1 | Migrating AdvFS Domains to LSM Volumes |
| 3.4.2.1.1 | Disk Space Considerations |
| 3.4.2.1.2 | Migrating AdvFS Domains |
| 3.4.2.1.3 | Mirroring Migrated Domain Volumes to the Original Disk (Optional) |
| 3.4.3 | Encapsulating Cluster Members' Swap Devices |
| 3.5 | Enabling the Automatic Data Relocation (Hot-Sparing) Feature |
| 3.5.1 | Configuring and Deconfiguring Hot-Spare Disks |
| 3.5.2 | Examples of Mail Notification for Exception Events |
| 3.6 | LSM Files, Directories, Device Drivers, and Daemons |
| 3.6.1 | LSM Files |
| 3.6.2 | LSM Directories |
| 3.6.3 | LSM Device Drivers |
| 3.6.4 | LSM Daemons |
| 4 | Creating LSM Disks, Disk Groups, and Volumes |
| 4.1 | Overview of Creating LSM Disks |
| 4.1.1 | Overview of Configuration Database Copies |
| 4.1.2 | Overview of Disk Offsets |
| 4.1.3 | Creating LSM Sliced Disks |
| 4.1.4 | Creating LSM Simple Disks |
| 4.1.5 | Backing Up Disk Label Information |
| 4.2 | Creating Disk Groups |
| 4.2.1 | Creating LSM Disks and Disk Groups Using the voldiskadd Script |
| 4.2.2 | Creating Disk Groups Using the voldg Command |
| 4.3 | Creating LSM Volumes for New Data |
| 4.3.1 | Overview of LSM Volume Attributes |
| 4.3.2 | Creating LSM Volumes with a Single Concatenated Plex |
| 4.3.3 | Creating LSM Volumes with Mirrored, Concatenated Plexes |
| 4.3.3.1 | Creating a Mirrored, Concatenated Volume in One Step |
| 4.3.3.2 | Creating a Mirrored, Concatenated Volume with Plexes on Different Buses |
| 4.3.4 | Creating LSM Volumes with a Single Striped Plex |
| 4.3.5 | Creating LSM Volumes with Mirrored, Striped Plexes |
| 4.3.5.1 | Creating a Mirrored, Striped Volume in One Step |
| 4.3.5.2 | Creating a Mirrored, Striped Volume with Plexes on Different Buses |
| 4.3.6 | Creating LSM Volumes with a RAID 5 Plex |
| 4.3.7 | Creating LSM Volumes for Swap Space |
| 4.3.7.1 | Creating Swap Volumes |
| 4.3.7.2 | Mirroring Swap Volumes |
| 4.4 | Creating LSM Volumes with Nondefault Properties |
| 4.4.1 | Creating a Striped Plex with Subdisks of Different Sizes |
| 4.4.2 | Creating a Striped Plex with Disks on Different Buses |
| 4.4.3 | Creating a RAID 5 Plex with Disks on Different Buses |
| 4.5 | Configuring File Systems to Use LSM Volumes |
| 4.5.1 | Configuring AdvFS Domains to Use LSM Volumes |
| 4.5.2 | Configuring UFS File Systems to Use LSM Volumes |
| 4.6 | Creating LSM Volumes for Existing Data |
| 4.6.1 | Encapsulating Disks or Disk Partitions |
| 4.6.2 | Creating LSM Volumes for AdvFS Domains |
| 4.6.2.1 | Encapsulating an AdvFS Domain |
| 4.6.2.2 | Migrating an AdvFS Domain |
| 5 | Managing LSM Objects |
| 5.1 | Managing LSM Disks |
| 5.1.1 | Displaying LSM Disk Information |
| 5.1.2 | Renaming LSM Disks |
| 5.1.3 | Placing LSM Disks Off Line |
| 5.1.4 | Placing LSM Disks On Line |
| 5.1.5 | Moving Data Off an LSM Disk |
| 5.1.6 | Moving LSM Objects Relocated by Hot-Sparing |
| 5.1.7 | Removing Disks from LSM Control |
| 5.2 | Managing Disk Groups |
| 5.2.1 | Displaying Disk Group Information |
| 5.2.2 | Adding LSM Disks to Disk Groups |
| 5.2.3 | Removing LSM Disks from Disk Groups |
| 5.2.4 | Deporting Disk Groups |
| 5.2.5 | Importing Disk Groups |
| 5.2.6 | Renaming Disk Groups |
| 5.2.7 | Creating a Clone Disk Group |
| 5.3 | Managing the LSM Configuration Database |
| 5.3.1 | Backing Up the LSM Configuration Database |
| 5.3.2 | Restoring the LSM Configuration Database from Backup |
| 5.3.3 | Changing the Size and Number of Configuration Database Copies |
| 5.3.3.1 | Reducing the Number of Configuration Database Copies on an LSM Disk |
| 5.3.3.2 | Removing Configuration Database Copies on LSM Disks with Small Private Regions |
| 5.4 | Managing LSM Volumes |
| 5.4.1 | Displaying LSM Volume Information |
| 5.4.2 | Backing Up LSM Volumes |
| 5.4.2.1 | Overview of the Fast Plex Attach Feature |
| 5.4.2.2 | Creating a Backup Volume Using the Fast Plex Attach Feature (volassist snapfast and snapback) |
| 5.4.2.3 | Creating a Backup Volume by Attaching a New Plex (volassist snapstart and snapshot) |
| 5.4.2.4 | Creating a Backup Volume by Detaching an Existing Plex |
| 5.4.2.5 | Backing Up a Nonredundant or RAID 5 Volume |
| 5.4.2.6 | Performing a Backup |
| 5.4.2.7 | Special Case: Backing Up LSM Volumes in an AdvFS Domain |
| 5.4.3 | Restoring LSM Volumes from Backup |
| 5.4.4 | Starting LSM Volumes |
| 5.4.5 | Stopping LSM Volumes |
| 5.4.6 | Removing LSM Volumes |
| 5.4.6.1 | Unencapsulating AdvFS Domains |
| 5.4.7 | Disabling the Fast Plex Attach Feature on LSM Volumes |
| 5.4.8 | Renaming LSM Volumes |
| 5.4.9 | Growing LSM Volumes |
| 5.4.9.1 | Growing LSM Volumes by a Specific Amount |
| 5.4.9.2 | Growing LSM Volumes to a Specific Size |
| 5.4.10 | Shrinking LSM Volumes |
| 5.4.10.1 | Shrinking LSM Volumes by a Specific Amount |
| 5.4.10.2 | Shrinking LSM Volumes to a Specific Size |
| 5.4.11 | Changing LSM Volume Permission, User, and Group Attributes |
| 5.5 | Managing Plexes |
| 5.5.1 | Displaying Plex Information |
| 5.5.2 | Adding a Data Plex (Mirroring LSM Volumes) |
| 5.5.3 | Adding a Log Plex |
| 5.5.4 | Adding an FPA Plex |
| 5.5.5 | Detaching a Plex |
| 5.5.6 | Dissociating a Plex |
| 5.5.7 | Reattaching Plexes |
| 5.5.8 | Changing the Plex Layout of LSM Volumes |
| 5.5.8.1 | Changing the Plex Layout from Concatenated to Striped |
| 5.5.8.2 | Changing the Plex Layout from Striped to Concatenated |
| 5.6 | Managing Subdisks |
| 5.6.1 | Displaying Subdisk Information |
| 5.6.2 | Joining Subdisks |
| 5.6.3 | Splitting Subdisks |
| 5.6.4 | Moving Subdisks to a Different Disk |
| 5.6.5 | Removing Subdisks |
| 6 | Troubleshooting |
| 6.1 | Troubleshooting LSM Objects |
| 6.1.1 | Monitoring LSM Events |
| 6.1.2 | Monitoring Read and Write Statistics |
| 6.1.2.1 | Displaying Read and Write Statistics |
| 6.1.2.2 | Displaying Failed Read and Write Statistics |
| 6.1.3 | Monitoring LSM Object States |
| 6.1.3.1 | Overview of LSM Kernel States |
| 6.1.3.2 | Overview of LSM Object States |
| 6.2 | Troubleshooting a Missing or Altered sysconfigtab File |
| 6.3 | Troubleshooting LSM Startup and Command Problems |
| 6.3.1 | Checking the Volume Configuration Daemon (vold) |
| 6.3.2 | Restarting the Volume Configuration Daemon (vold) |
| 6.3.3 | Checking the Volume Extended I/O Daemon (voliod) |
| 6.4 | Troubleshooting LSM Disks |
| 6.4.1 | Checking Disk Status |
| 6.4.2 | Recovering Stale Subdisks |
| 6.4.3 | Recovering From Temporary Disk Failures |
| 6.4.4 | Moving LSM Volumes Off a Failing Disk |
| 6.4.5 | Replacing Failed Disks |
| 6.4.6 | Replacing Failed Boot Disks |
| 6.5 | Troubleshooting LSM Volumes |
| 6.5.1 | Recovering LSM Volumes After a System Failure |
| 6.5.2 | Recovering LSM Volumes After Disk Failure |
| 6.5.2.1 | Recovering Mirrored and RAID 5 LSM Volumes |
| 6.5.2.2 | Recovering a Nonredundant Volume |
| 6.5.2.3 | Recovering a Mirrored Volume with No Valid Plexes |
| 6.5.2.4 | Recovering a Mirrored Volume with One Valid Plex |
| 6.5.2.5 | Recovering a RAID 5 Plex from Multiple Disk Failures |
| 6.5.2.6 | Recovering a RAID 5 Log Plex |
| 6.5.3 | Starting Disabled LSM Volumes |
| 6.5.4 | Checking the Status of Volume Resynchronization |
| 6.5.4.1 | Changing the Rate of Future Volume Resynchronizations |
| 6.5.5 | Calculating Sufficient Space to Create LSM Volumes |
| 6.5.6 | Clearing Locks on LSM Volumes |
| 6.6 | Troubleshooting Disk Groups |
| 6.6.1 | Resolving Mismatched Host IDs |
| 6.6.2 | Importing Disk Groups with Failed Disks (Forced Import) |
| 7 | Special Cases |
| 7.1 | Upgrading an LSM Configuration |
| 7.1.1 | Increasing the Size of BCLs |
| 7.1.2 | Backing Up the LSM Configuration |
| 7.1.3 | Deporting Disk Groups (Optional) |
| 7.1.4 | Upgrading the LSM Software |
| 7.1.5 | Manually Converting Version 4.0 Disk Groups |
| 7.1.6 | Optimizing Restored LSM Configuration Databases (Optional) |
| 7.2 | Adding a System with LSM to a Cluster |
| 7.3 | Moving Disk Groups Between Systems |
| 7.3.1 | Moving the rootdg Disk Group to Another System |
| 7.3.2 | Moving Disk Groups to Another System |
| 7.3.3 | Moving Disk Groups with nopriv Disks to Another System |
| 7.4 | Unencapsulating the Boot Disk (Standalone System) |
| 7.5 | Migrating AdvFS Domains from LSM Volumes to Physical Storage |
| 7.6 | Unencapsulating a Cluster Member's Swap Devices |
| 7.7 | Uninstalling the LSM Software |
| A | The Storage Administrator GUI (lsmsa) |
| A.1 | Overview of the Storage Administrator |
| A.1.1 | Installing and Starting the Storage Administrator GUI |
| A.1.2 | Storage Administrator Main Window Components |
| A.2 | Performing Tasks with the Storage Administrator |
| A.2.1 | Selecting Objects |
| A.2.2 | Using the Console Menu and Selected Menu |
| A.2.3 | Using the Right Mouse Button to Display a Pop-Up Menu |
| A.2.4 | Using the Command Launcher Window |
| A.2.5 | Exiting the Storage Administrator |
| A.3 | Managing LSM Disks |
| A.3.1 | Adding an LSM Disk |
| A.3.2 | Adding a Hot-Spare Disk |
| A.3.3 | Moving Data Off an LSM disk |
| A.3.4 | Mirroring an LSM disk |
| A.3.5 | Placing an LSM Disk Off Line |
| A.3.6 | Placing an LSM disk On Line |
| A.3.7 | Recovering LSM Volumes on an LSM disk |
| A.3.8 | Removing LSM Disks from Disk Groups |
| A.3.9 | Renaming an LSM disk |
| A.3.10 | Replacing an LSM disk |
| A.3.11 | Scanning for New Disks |
| A.4 | Managing Disk Groups |
| A.4.1 | Creating Disk Groups |
| A.4.2 | Adding LSM Disks to Disk Groups |
| A.4.3 | Adding Disk Partitions to Disk Groups |
| A.4.4 | Deporting Disk Groups |
| A.4.5 | Importing a Deported Disk Group |
| A.4.6 | Recovering LSM Volumes in Disk Groups |
| A.4.7 | Renaming Disk Groups |
| A.4.8 | Moving Disk Groups to Another System |
| A.4.9 | Destroying Disk Groups |
| A.5 | Managing Subdisks |
| A.5.1 | Joining Subdisks |
| A.5.2 | Splitting Subdisks |
| A.5.3 | Moving Subdisks |
| A.5.4 | Removing Subdisks |
| A.6 | Managing LSM Volumes |
| A.6.1 | Creating LSM Volumes |
| A.6.2 | Adding Mirrors to LSM Volumes |
| A.6.3 | Adding Logs to LSM Volumes |
| A.6.4 | Mounting UFS File Systems on LSM Volumes |
| A.6.5 | Adding File Systems to LSM Volumes |
| A.6.6 | Checking UFS File Systems |
| A.6.7 | Unmounting UFS File Systems on LSM Volumes |
| A.6.8 | Mapping and Analyzing LSM Volumes, Disks, and Subdisks |
| A.6.9 | Disabling a Mirror in LSM Volumes |
| A.6.10 | Repairing Disabled Mirrors |
| A.6.11 | Creating Snapshots of Volume Data |
| A.6.12 | Recovering LSM Volumes |
| A.6.13 | Preparing LSM Volumes for Restoration |
| A.6.14 | Removing Mirrors from LSM Volumes |
| A.6.15 | Removing Logs from LSM Volumes |
| A.6.16 | Removing LSM Volumes |
| A.6.17 | Renaming LSM Volumes |
| A.6.18 | Resizing LSM Volumes |
| A.6.19 | Restarting LSM Volumes |
| A.6.20 | Stopping LSM Volumes |
| A.7 | Performing AdvFS Operations |
| A.7.1 | Creating AdvFS Domains |
| A.7.2 | Adding LSM Volumes to AdvFS Domains |
| A.7.3 | Adding Filesets to AdvFS Domains |
| A.7.4 | Defragmenting AdvFS Domains |
| A.7.5 | Cloning AdvFS Filesets |
| A.7.6 | Changing Fileset Quotas |
| A.7.7 | Unmounting AdvFS Filesets |
| A.7.8 | Renaming AdvFS Filesets |
| A.7.9 | Mounting AdvFS Filesets |
| A.7.10 | Removing AdvFS Filesets |
| B | Understanding and Customizing the Storage Administrator GUI |
| B.1 | Tracking Storage Administrator Activities |
| B.1.1 | Overview of the Command Log File |
| B.1.2 | Overview of the Access Log File |
| B.1.3 | Overview of the Server Log File |
| B.2 | Working with Dialog Boxes |
| B.2.1 | Specifying Objects in Dialog Boxes |
| B.2.2 | Specifying Object Sizes in Dialog Boxes |
| B.3 | Viewing Objects and Object Properties |
| B.3.1 | Overview of the Main Window |
| B.3.2 | Viewing Volume Layout Details |
| B.3.3 | Overview of Object Properties Dialog Boxes |
| B.3.4 | Overview of the User Preferences Dialog Box |
| B.3.4.1 | General Preferences |
| B.3.4.2 | Main Window Preferences |
| B.3.4.3 | Font Preferences |
| B.3.4.4 | Color Preferences |
| B.3.4.5 | Geometry Preferences |
| B.3.4.6 | Tree/Table Preferences |
| B.3.4.7 | Toolbar Preferences |
| B.3.4.8 | Layout Details Preferences |
| B.3.5 | Overview of the Alert Monitor Window |
| B.3.6 | Overview of the Object Table Copy Window |
| B.3.7 | Overview of the Object Search Window |
| B.3.8 | Overview of the Task Request Monitor Window |
| B.4 | Storage Administrator GUI Shortcuts |
| B.4.1 | Sorting Objects |
| B.4.2 | Clearing Alerts |
| B.4.3 | Using Keyboard Shortcuts |
| B.4.4 | Docking the Toolbar and Command Launcher |
| Glossary |
| Examples |
| 3-1 | Sample Mail Notification |
| 3-2 | Complete Disk Failure Mail Notification |
| 3-3 | Partial Disk Failure Mail Notification |
| 3-4 | Successful Data Relocation Mail Notification |
| 3-5 | No Hot-Spare or Free Disk Space Mail Notification |
| 3-6 | Data Relocation Failure Mail Notification |
| 3-7 | Unusable Volume Mail Notification |
| 3-8 | Unusable RAID 5 Volume Mail Notification |
| 4-1 | Creating an LSM Disk Group with the voldiskadd script |
| 4-2 | LSM Volume Attribute Defaults File |
| 6-1 | Volume Recovery Section of /sbin/lsm-startup Script |
| Figures |
| 1-1 | Typical LSM Hardware Configuration |
| 1-2 | Single Subdisk Using a Public Region |
| 1-3 | Multiple Subdisks Using a Public Region |
| 1-4 | Concatenated Data Plex |
| 1-5 | Volume with a Three-Column Striped Data Plex |
| 1-6 | Volume with a RAID 5 Data Plex |
| 1-7 | Volume with Concatenated and Mirrored Data Plexes |
| 1-8 | Volume with Striped and Mirrored Data Plexes |
| 1-9 | Two LSM Volumes Using Subdisks on the Same Disk |
| 1-10 | LSM Volumes Used Like Disk Partitions |
| 2-1 | Worksheet for LSM Volumes with Concatenated Plexes |
| 2-2 | Worksheet for LSM Volumes with Striped Plexes |
| 2-3 | Worksheet for LSM Volumes with a RAID 5 Plex |
| 5-1 | Volume Before Fast Plex Attach |
| 5-2 | Process of the volassist snapfast Command: Phase 1 |
| 5-3 | Process of the volassist snapfast Command: Phase 2 |
| 5-4 | Writes Occurring to Primary and Secondary LSM Volumes |
| 5-5 | Process of volassist snapback Command: Phase 1 |
| 5-6 | Process of volassist snapback Command: Phase 2 |
| A-1 | Storage Administrator Main Window |
| A-2 | Add Disk(s) Dialog Box |
| A-3 | Evacuate Disk Dialog Box |
| A-4 | Mirror Disk Dialog Box |
| A-5 | Remove Disk Dialog Box |
| A-6 | Replace Disk Dialog Box |
| A-7 | New Disk Group Dialog Box |
| A-8 | Add Disk Partition Dialog Box |
| A-9 | Deport Disk Group Dialog Box |
| A-10 | Import Disk Group Dialog Box |
| A-11 | Rename Disk Group Dialog Box |
| A-12 | Join Subdisks Dialog Box |
| A-13 | Split Subdisk Dialog Box |
| A-14 | Move Subdisks Dialog Box |
| A-15 | New Volume Dialog Box |
| A-16 | Add Mirror Dialog Box |
| A-17 | Add Log Dialog Box |
| A-18 | Mount File System Dialog Box |
| A-19 | New File System Dialog Box |
| A-20 | Check File System Dialog Box |
| A-21 | Volume to Disk Mapping Window |
| A-22 | Disable Mirror Dialog Box |
| A-23 | Repair Mirror Dialog Box |
| A-24 | Volume Snapshot Dialog Box |
| A-25 | Remove Log Dialog Box |
| A-26 | Rename Volume Dialog Box |
| A-27 | Resize Volume Dialog Box |
| A-28 | Storage Administrator Main Window |
| A-29 | New Domain Dialog Box |
| A-30 | Add Volume Dialog Box |
| A-31 | Add Fileset Dialog Box |
| A-32 | Defragment Domain Dialog Box |
| A-33 | Clone Fileset Dialog Box |
| A-34 | Fileset Quotas Dialog Box |
| A-35 | Rename Fileset Dialog Box |
| A-36 | Mount Fileset Dialog Box |
| B-1 | Typical Storage Administrator Dialog Box |
| B-2 | Volume Layout Details Window |
| B-3 | Volume Properties Dialog Box |
| B-4 | Preferences Dialog Box |
| B-5 | Alert Monitor Window |
| B-6 | Object Search Window |
| B-7 | Task Request Monitor Window |
| Tables |
| 1-1 | LSM Commands Described in This Manual |
| 2-1 | Plex Layout Type Benefits and Trade-Offs |
| 2-2 | Default (Approximate) Sizes of DRL Logs |
| 2-3 | Completed Disk Group Worksheets for a Standalone System |
| 2-4 | Worksheet for Disk Group |
| 3-1 | LSM Software Subsets |
| 3-2 | LSM Commands for Providing Cluster Redundancy |
| 3-3 | LSM Device Special Files |
| 3-4 | LSM /etc/vol Subdirectories |
| 3-5 | LSM Block and Character Device Subdirectories |
| 4-1 | Common LSM Volume Attributes |
| 6-1 | Common volstat Command Options |
| 6-2 | LSM Volume Kernel States (KSTATE) |
| 6-3 | LSM Volume States (STATE) |
| 6-4 | LSM Plex States |
| 6-5 | LSM Subdisk States |
| 6-6 | vold Status and Solutions |
| 6-7 | Volume Recovery Procedures |
| B-1 | Keyboard Shortcuts |
| B-2 | Main Window Keyboard Shortcuts |
| Index |