| Title and Copyright Information |
| About This Guide |
| Audience |
| New and Changed Features |
| Organization |
| Related Documents |
| Conventions |
| 1 | Overview |
| 1.1 | LSM Object Hierarchy |
| 1.1.1 | LSM Disk |
| 1.1.2 | Disk Group |
| 1.1.3 | Subdisk |
| 1.1.4 | 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 | LSM Volumes |
| 1.2 | LSM Interfaces |
| 1.2.1 | LSM Command Interface |
| 2 | Planning LSM Volumes and Disk Groups |
| 2.1 | Planning LSM Volumes |
| 2.1.1 | Planning an LSM Volume That Uses a Concatenated Plex |
| 2.1.2 | Planning an LSM Volume That Uses a Striped Plex |
| 2.1.3 | Planning an LSM Volume That Uses a RAID 5 Plex |
| 2.2 | Planning Disk Groups |
| 2.3 | Identifying Unused Storage Devices |
| 2.3.1 | Using the Disk Configuration GUI to Identify Unused Disks |
| 2.3.2 | Using Operating System Commands to Identify Unused Disks |
| 2.3.3 | Using the voldisk Command to Identify Unused Disks |
| 3 | Installing or Upgrading the LSM Software |
| 3.1 | Preparing to Upgrade LSM |
| 3.1.1 | Increasing the Size of BCLs |
| 3.1.2 | Deporting Disk Groups |
| 3.1.3 | Backing Up a Previous LSM Configuration |
| 3.2 | Installing or Upgrading LSM |
| 3.3 | Installing the LSM License |
| 3.4 | Performing Postinstallation Tasks |
| 3.4.1 | Initializing LSM |
| 3.4.1.1 | Verifying That LSM Is Initialized (Optional) |
| 3.4.1.2 | LSM Files, Directories, Drivers, and Daemons |
| 3.4.1.2.1 | LSM Files |
| 3.4.1.2.2 | LSM Directories |
| 3.4.1.2.3 | LSM Device Drivers |
| 3.4.1.2.4 | LSM Daemons |
| 3.4.2 | Optimizing the LSM Configuration Databases (Optional) |
| 3.4.3 | Creating an Alternate Boot Disk |
| 3.4.3.1 | Restrictions |
| 3.4.3.2 | Encapsulating Boot Disk Partitions |
| 3.4.3.3 | Creating Mirror Plexes for Boot Disk Volumes |
| 3.4.3.4 | Displaying Information for Boot Disk Volumes |
| 3.4.3.5 | Displaying AdvFS File Domain Information |
| 3.4.3.6 | Displaying UFS File System Information |
| 3.4.3.7 | Displaying Swap Volume Information |
| 3.4.3.8 | Unencapsulating the Boot Disk |
| 3.4.4 | Configuring the Automatic Data Relocation (Hot-Sparing) Feature |
| 3.4.4.1 | Enabling the Hot-Sparing Feature |
| 3.4.4.2 | Configuring and Deconfiguring a Spare Disk |
| 3.4.4.3 | Setting Up Mail Notification for Exception Events |
| 3.4.4.4 | Moving Relocated LSM Objects |
| 4 | Creating LSM Disk Groups and Volumes |
| 4.1 | Creating Disk Groups |
| 4.1.1 | Displaying Disk Group Information |
| 4.1.2 | Creating a Disk Group or Adding Disks to a Disk Group |
| 4.1.3 | Creating a Backup Copy of the Disk Label Information |
| 4.2 | Creating an LSM Volume for New Data |
| 4.2.1 | Creating an LSM Volume Using a Concatenated Plex |
| 4.2.2 | Creating an LSM Volume Using a Striped Plex |
| 4.2.3 | Creating an LSM Volume Using a Striped Plex (on Different Buses) |
| 4.2.4 | Creating an LSM Volume Using a RAID 5 Plex |
| 4.2.5 | Creating an LSM Volume Using a RAID 5 Plex (on Different Buses) |
| 4.2.6 | Creating an LSM Volume for Secondary Swap Space |
| 4.3 | Configuring File Systems to Use LSM Volumes |
| 4.3.1 | Creating a UFS File System on an LSM Volume |
| 4.3.2 | Creating an AdvFS File Domain on an LSM Volume |
| 4.4 | Creating an LSM Volume for Existing Data |
| 4.4.1 | Encapsulating Disks and Disk Partitions |
| 4.4.2 | Encapsulating AdvFS File Domains |
| 5 | Managing LSM Objects |
| 5.1 | Managing LSM Disks |
| 5.1.1 | Creating an LSM Disk |
| 5.1.2 | Displaying LSM Disk Information |
| 5.1.3 | Renaming an LSM Disk |
| 5.1.4 | Placing an LSM Disk Off Line |
| 5.1.5 | Placing an LSM Disk On Line |
| 5.1.6 | Moving Data from an LSM Disk |
| 5.1.7 | Removing an LSM Disk from LSM Control |
| 5.2 | Managing Disk Groups |
| 5.2.1 | Displaying Disk Group Information |
| 5.2.1.1 | Displaying All LSM Disks |
| 5.2.1.2 | Displaying Free Space in Disk Groups |
| 5.2.1.3 | Displaying the Maximum Size for an LSM Volume in a Disk Group |
| 5.2.2 | Creating a Disk Group |
| 5.2.3 | Adding a Disk to a Disk Group |
| 5.2.4 | Deporting a Disk Group |
| 5.2.5 | Importing a Disk Group |
| 5.2.6 | Moving a Disk Group to Another System |
| 5.2.7 | Removing an LSM Disk from a 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.4 | Managing Volumes |
| 5.4.1 | Displaying LSM Volume Information |
| 5.4.2 | Backing Up an LSM Volume |
| 5.4.2.1 | Backing Up a Volume with a Single Concatenated or Striped Plex |
| 5.4.2.2 | Backing Up a Volume with Mirror Plexes |
| 5.4.2.3 | Backing Up a Volume with a RAID 5 Plex |
| 5.4.3 | Restoring an LSM Volume from Backup |
| 5.4.4 | Starting an LSM Volume |
| 5.4.5 | Stopping an LSM Volume |
| 5.4.6 | Removing an LSM Volume |
| 5.4.7 | Recovering an LSM Volume |
| 5.4.8 | Renaming an LSM Volume |
| 5.4.9 | Changing LSM Volume Permission, User, and Group Attributes |
| 5.5 | Managing Plexes |
| 5.5.1 | Displaying Plex Information |
| 5.5.1.1 | Displaying General Plex Information |
| 5.5.1.2 | Displaying Detailed Plex Information |
| 5.5.2 | Adding a Data Plex |
| 5.5.3 | Adding a Log Plex |
| 5.5.4 | Moving Data to a New Plex |
| 5.5.5 | Reattaching a Plex |
| 5.5.6 | Removing a Plex |
| 5.6 | Managing Subdisks |
| 5.6.1 | Displaying Subdisk Information |
| 5.6.1.1 | Displaying General Subdisk Information |
| 5.6.1.2 | Displaying Detailed Subdisk Information |
| 5.6.2 | Joining Subdisks |
| 5.6.3 | Splitting Subdisks |
| 5.6.4 | Moving Subdisks |
| 5.6.5 | Removing a Subdisk |
| 6 | Troubleshooting |
| 6.1 | Monitoring LSM |
| 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 | Kernel States |
| 6.1.3.2 | LSM States |
| 6.2 | Missing or Altered sysconfigtab File |
| 6.3 | LSM Startup and Command Problems |
| 6.3.1 | Checking the vold Daemon |
| 6.3.2 | Checking the voliod Daemon |
| 6.4 | Solving Problems with LSM Volumes |
| 6.4.1 | Insufficient Space to Create a Volume |
| 6.4.2 | Starting a Disabled Volume |
| 6.4.3 | Recovering Unstartable Nonredundant Volumes |
| 6.4.4 | Recovering Volumes with Mirror Plexes |
| 6.4.4.1 | Recovering a Volume with No Valid Plexes |
| 6.4.4.2 | Recovering a Volume with One Valid Plex |
| 6.4.4.3 | Recovering a Volume After Loss of Configuration Database |
| 6.4.5 | Recovering Volumes with a Failed RAID 5 Plex |
| 6.4.5.1 | Recovering a RAID 5 Plex from Multiple Disk Failures |
| 6.4.5.2 | Recovering a RAID 5 Log Plex |
| 6.4.6 | Checking the Status of Volume Resynchronization |
| 6.4.7 | Clearing Locks on LSM Volumes |
| 6.5 | Solving Disk Problems |
| 6.5.1 | Checking Disk Status |
| 6.5.2 | Recovering a Stale Subdisk |
| 6.5.3 | Recovering Volumes After a Temporary Disk Failure |
| 6.5.4 | Moving a Volume Off a Failing Disk |
| 6.5.5 | Replacing a Failed Disk |
| 6.5.6 | Recovering from a Boot Disk Failure |
| 6.5.6.1 | Replacing a Failed Boot Disk |
| 6.6 | Problems Importing a Disk Group |
| 6.7 | Removing the LSM Software |
| 7 | Error Messages |
| 7.1 | Volume Daemon Error Messages |
| 7.2 | Kernel Error Messages |
| A | The Storage Administrator |
| A.1 | Overview |
| A.1.1 | Installing and Starting the Storage Administrator |
| A.1.2 | Storage Administrator Main Window |
| A.2 | Performing Tasks with the Storage Administrator |
| A.2.1 | Selecting Objects |
| A.2.2 | Using the Menu Bar |
| A.2.3 | Using the Right Mouse Button to Display a Pop-Up Menu |
| A.2.4 | Using the Command Launcher |
| A.2.5 | Exiting the Storage Administrator |
| A.3 | Managing Disks |
| A.3.1 | Adding a Disk |
| A.3.2 | Evacuating a Disk |
| A.3.3 | Mirroring a Disk |
| A.3.4 | Placing a Disk On Line |
| A.3.5 | Recovering Volumes on a Disk |
| A.3.6 | Removing a Disk from an LSM Disk Group |
| A.3.7 | Renaming a Disk |
| A.3.8 | Replacing a Disk |
| A.3.9 | Scanning for New Disks |
| A.3.10 | Taking a Disk Off Line |
| A.4 | Managing Disk Groups |
| A.4.1 | Adding a Disk to a Disk Group |
| A.4.2 | Creating a Disk Group |
| A.4.3 | Deporting a Disk Group |
| A.4.4 | Importing a Disk Group |
| A.4.5 | Destroying a Disk Group |
| A.4.6 | Moving a Disk Group |
| A.4.7 | Recovering Volumes in a Disk Group |
| A.4.8 | Renaming a Disk Group |
| A.5 | Managing Subdisks |
| A.5.1 | Joining Subdisks |
| A.5.2 | Moving a Subdisk |
| A.5.3 | Removing a Subdisk |
| A.5.4 | Splitting a Subdisk |
| A.6 | Managing Volumes |
| A.6.1 | Analyzing Activity on Volumes, Disks, and Subdisks |
| A.6.2 | Adding a File System to a Volume |
| A.6.3 | Adding a Log to a Volume |
| A.6.4 | Adding a Mirror to a Volume |
| A.6.5 | Disabling a Mirror in a Volume |
| A.6.6 | Repairing a Mirror in a Volume |
| A.6.7 | Checking a File System on a Volume |
| A.6.8 | Creating a Copy of Volume Data |
| A.6.9 | Creating a Volume |
| A.6.10 | Mounting a UFS File System on a Volume |
| A.6.11 | Preparing to Restore a Volume from Backup |
| A.6.12 | Recovering a Volume |
| A.6.13 | Removing a Volume |
| A.6.14 | Removing a Log from a Volume |
| A.6.15 | Removing a Mirror from a Volume |
| A.6.16 | Renaming a Volume |
| A.6.17 | Resizing a Volume |
| A.6.18 | Starting a Volume |
| A.6.19 | Stopping a Volume |
| A.6.20 | Unmounting a File System on a Volume |
| B | Customizing the Storage Administrator |
| B.1 | Tracking Storage Administrator Activities |
| B.1.1 | Command Log File |
| B.1.2 | Access Log File |
| B.1.3 | 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 | Main Window |
| B.3.2 | Volume Layout Details Window |
| B.3.3 | Object Properties Dialog Boxes |
| B.3.4 | 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 | Object Tree/Object Table Preferences |
| B.3.4.7 | Toolbar Preferences |
| B.3.4.8 | Layout Details Preferences |
| B.3.5 | Alert Monitor Window |
| B.3.6 | Object Table Copy Window |
| B.3.7 | Search Window |
| B.3.8 | Task Request Monitor Window |
| B.4 | Shortcuts and Other Operations |
| B.4.1 | Sorting Objects |
| B.4.2 | Clearing an Alert |
| B.4.3 | Keyboard Shortcuts |
| B.4.4 | Docking the Toolbar and Command Launcher |
| C | Using the voldiskadm Menu Interface |
| C.1 | Starting the voldiskadm Menu Interface |
| C.2 | Disk Management |
| C.2.1 | Initializing a Disk |
| C.2.2 | Displaying Disk Information |
| C.2.3 | Adding a Disk to a Disk Group |
| C.2.4 | Moving Volumes from a Disk |
| C.2.5 | Removing a Disk from a Disk Group |
| C.2.5.1 | Removing a Disk Without Replacement |
| C.2.5.2 | Removing a Disk for Replacement |
| C.2.6 | Replacing a Failed or Removed Disk |
| C.2.7 | Disabling a Disk |
| C.3 | Disk Group Management |
| C.3.1 | Importing a Disk Group |
| C.3.2 | Deporting a Disk Group |
| C.4 | Mirror Volume Management |
| C.5 | Exiting the voldiskadm Menu Interface |
| D | The Visual Administrator |
| D.1 | Starting the Visual Administrator |
| D.1.1 | The Visual Administrator Main Window |
| D.1.1.1 | Default Views |
| D.1.1.2 | User-Created Views |
| D.1.2 | The View of rootdg Window |
| D.2 | Mouse Buttons |
| D.3 | Icons for LSM Objects |
| D.3.1 | Icon Characteristics |
| D.3.2 | Manipulating Icons |
| D.4 | Pull-Down Menus |
| D.5 | Forms |
| D.5.1 | Fields |
| D.5.2 | Form Error Messages |
| D.6 | Error and Warning Messages |
| D.7 | Help Windows |
| E | Using the Visual Administrator |
| E.1 | Managing Volumes |
| E.1.1 | Volume Menus |
| E.1.1.1 | Basic-Ops Menu |
| E.1.1.2 | Advanced-Ops Menu |
| E.1.2 | Volume Forms |
| E.1.2.1 | Basic-Ops Forms |
| E.1.2.2 | Advanced-Ops Forms |
| E.1.3 | Volume Properties Form |
| E.2 | Plex Management |
| E.2.1 | Plex Menus |
| E.2.2 | Plex Forms |
| E.2.3 | Plex Properties Forms |
| E.3 | Subdisk Management |
| E.3.1 | Subdisk Menus |
| E.3.2 | Subdisk Forms |
| E.3.3 | Subdisk Properties Forms |
| E.4 | Disk Management |
| E.4.1 | Disk Menus |
| E.4.1.1 | Basic-Ops Menu |
| E.4.1.2 | Advanced-Ops Menu |
| E.4.2 | Disk Forms |
| E.4.3 | Basic-Ops Forms |
| E.4.3.1 | Advanced-Ops Forms |
| E.4.4 | Disk Properties Forms |
| E.5 | Disk Group Management |
| E.5.1 | Disk Group Menus |
| E.5.2 | Disk Group Forms |
| E.6 | Projection Analysis |
| E.6.1 | Projection |
| E.6.2 | Projection Menus |
| E.6.3 | Projection Relationships |
| E.7 | Analysis |
| E.7.1 | Analysis Menus |
| E.7.2 | Analysis Forms |
| E.7.3 | Analysis Table |
| E.8 | UFS Management |
| E.8.1 | File System Menus |
| E.8.2 | File System Forms |
| E.8.2.1 | Basic-Ops Forms |
| E.8.2.2 | File Systems Properties Form |
| 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 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 | LSM Volume Attribute Defaults File |
| Figures |
| 1-1 | Typical LSM Hardware Configuration |
| 1-2 | LSM Sliced Disk |
| 1-3 | LSM Simple Disk |
| 1-4 | LSM Nopriv Disk |
| 1-5 | Concatenated Data Plex |
| 1-6 | Concatenated Data Plex with One Mirror |
| 1-7 | Writing Data to a Striped Plex |
| 1-8 | Incomplete Striped Data Plex |
| 1-9 | Striped Data Plex with One Mirror |
| 1-10 | Data and Parity Placement in a Three-Column RAID 5 Data Plex |
| 1-11 | Using LSM Volumes Like Disk Partitions |
| 2-1 | Worksheet for Planning a Volume with Concatenated Plexes |
| 2-2 | Worksheet for Planning a Volume with Striped Plexes |
| 2-3 | Worksheet for Planning a Volume with a RAID 5 Plex |
| 2-4 | Worksheet for Planning rootdg Disk Group |
| 2-5 | Worksheet for Planning Additional Disk Groups |
| 2-6 | Worksheet for Planning Disk Groups (Completed Example) |
| A-1 | The Storage Administrator Main Window |
| B-1 | Typical Storage Administrator Dialog Box |
| B-2 | Volume Layout Window |
| B-3 | Volume Properties Dialog Box |
| B-4 | Preferences Dialog Box |
| B-5 | Alert Monitor Window |
| B-6 | Search Dialog Box |
| B-7 | Task Request Monitor Window |
| C-1 | Main Menu for the LSM voldiskadm Interface |
| D-1 | Visual Administrator Main Window |
| D-2 | View of rootdg Window |
| D-3 | Icons That Represent LSM Objects |
| Tables |
| 1-1 | LSM Commands |
| 2-1 | LSM Volume Attributes with No Default Values |
| 2-2 | LSM Volume Attributes with Default Values |
| 2-3 | Choosing a Plex Type |
| 3-1 | LSM Device Special Files |
| 3-2 | LSM /etc/vol/ Subdirectories |
| 3-3 | 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 Messages and Solutions |
| B-1 | Keyboard Shortcuts |
| B-2 | Main Window Keyboard Shortcuts |
| D-1 | Accessing the Default View Window |
| D-2 | Default Mouse Buttons |
| D-3 | Drag and Drop Operations |
| D-4 | Help Menu Options |
| E-1 | Create Volume Menu |
| E-2 | Add Mirror Menu Options |
| E-3 | Projection Table |
| E-4 | Analysis Table |
| Index |