Document Outline

• Contents
• Getting Started
  • Audience
  • Supported Platforms
  • Organization
  • Conventions
  • Related Documentation
    • Notes, Cautions, and Warnings
• Introducing the Command Line Interface
  • Accessing the CLI from the MS-DOS Prompt
  • Accessing the CLI from the Windows NT and Windows 2000 Start Button
    • 1 Click the Start button and move the mouse cursor to the Programs item. The Programs item displa...
    • 2 Move the mouse cursor to the HP NetRaid-4M item. The HP NetRaid-4M menu appears.
    • 3 Click on the AfaCli program icon on the HP NetRaid-4M menu.
  • Accessing the CLI from the Flexible Array Storage Tool Window
  • Accessing the CLI from the NetWare Server Console
  • Accessing the CLI from the UNIX Prompt
• Working with Controllers
  • Opening and Closing a Controller
    • Displaying a List of Available Controllers
    • Modes of Opening and Closing a Controller
      • Opening a Controller in Read/Write Mode
      • Opening a Controller in Read-only Mode
      • Opening a Controller in Snapshot Mode
      • Closing a Controller
    • Opening and Closing a Controller on NetWare from Windows NT and Windows 2000
  • Understanding Controller Attributes
    • Table 31. Controller Attributes
    • Displaying whether a Controller Resides in a Cluster Environment
    • Displaying Cluster Partner Information
    • Displaying a Controller Name
    • Displaying a Controller’s Type
    • Displaying a Controller’s Availability
    • Displaying a Remote Computer Name
    • Displaying a Controller’s Serial Number
    • Displaying a Controller’s CPU Type
    • Displaying the Number of Channels
    • Displaying the Number of Devices per Channel
    • Displaying a Controller’s CPU Speed
    • Displaying Controller Memory
    • Displaying the Controller Firmware Build Number
  • Rescanning a Controller
  • Pausing and Resuming Controller I/O
  • Displaying and Enabling Controller Automatic Spare
  • Managing Flash EPROM Components
    • Understanding User Flash Image (UFI) Files
      • Understanding Integrity Checking
  • Understanding Channel Attributes
    • Table 32. Channel Attributes
    • Displaying a Channel Number
    • Displaying a Host Controller ID
    • Displaying the Maximum Number of Targets on a Channel
    • Displaying a Channel’s Type
    • Displaying a Channel’s Speed
  • Resetting a Channel
  • Understanding Batteries
    • Table 33. Battery Attributes
    • Displaying the Condition of a Controller’s Battery
    • Reconditioning the Battery
• Working with Disks
  • Understanding Disk Attributes
    • Table 41. Disk Attributes
    • Displaying the SCSI Device ID
    • Displaying Device Types
    • Displaying Removable Media
    • Displaying the Vendor ID
    • Displaying the Product ID
    • Displaying the Revision Number
    • Displaying the Number of Blocks
    • Displaying the Bytes per Block
    • Displaying Disk Usage
      • Table 42. Disk Usage Values.
    • Displaying Disk Defects
  • Initializing a Disk
    • Displaying the Initialization State of a Disk
    • Initializing a Disk
  • Working with a Default SCSI ID
    • Displaying the Current Default SCSI Device ID
    • Setting a Default SCSI Device ID
  • Working with Partitions
    • Understanding Partition Attributes
      • Table 43. Partition Attributes
      • Displaying a Partition’s Offset
      • Displaying and Reconfiguring a Partition’s Size
      • Displaying a Container’s ID
      • Displaying a Container’s Type
      • Displaying a Multilevel Container’s ID
      • Displaying a Multilevel Container’s Type
      • Displaying and Changing a Partition’s Read/Write Accessibility
      • Displaying and Removing a Dead Partition
  • Verifying a Disk
    • Verifying a Disk Without Repairing Bad Blocks
    • Verifying a Disk and Repairing Bad Blocks
  • Blinking a Disk Light
  • Working with S.M.A.R.T. Disks
    • Understanding S.M.A.R.T. Attributes
      • Table 44. S.M.A.R.T. Attributes
      • Displaying S.M.A.R.T. Capable Devices
      • Displaying and Setting the Method of Reporting Informational Exceptions
        • Table 45. MRIE Methods
      • Displaying and Enabling the Exception Control Setting
      • Displaying and Enabling the MRIE Performance Setting
      • Displaying and Enabling Error Logging
      • Displaying and Setting the Exception Report Interval
      • Displaying and Setting the Report Count
      • Displaying and Clearing the Error Count
• Working with Disksets
  • Understanding Diskset Attributes
    • Table 51. Diskset Attributes
    • Displaying the Diskset ID
    • Displaying the Creator ID
    • Displaying the Owner
    • Displaying the Number of Disks in a Diskset
    • Displaying the Attached State of a Diskset
    • Displaying if a Diskset is Managed by the MS Cluster Service
    • Displaying a Diskset’s Label
    • Displaying if a Diskset Resides on a Controller with a Shared Channel
    • Displaying if a Diskset is a Member of a Spare Pool
    • Displaying the Diskset Creation Date and Time
    • Displaying Members of a Diskset
  • Creating a Diskset
  • Adding a Disk to a Diskset
  • Removing a Disk from a Diskset
  • Deleting a Diskset
  • Assigning Diskset Management
  • Attaching a Diskset
  • Detaching a Diskset
  • Changing a Diskset’s Label
  • Changing Ownership of a Diskset
    • Taking Ownership of a Diskset
    • Forcing Ownership of a Diskset
    • Releasing Ownership of a Diskset
  • Changing a Diskset’s Sparepool Assignment
• Working with Container Attributes
  • Understanding Container Identification Attributes
    • Table 61. Container Identification Attributes
    • Displaying, Assigning, and Removing a Drive Letter (Windows Only)
      • Displaying a Drive Letter Assigned to a Container
      • Assigning a Drive Letter to a Container
      • Removing a Drive Letter from a Container
    • Displaying A Root Special File (UNIX Only)
    • Displaying and Specifying a Cluster Partner
      • Displaying a Cluster Partner
      • Specifying a Cluster Partner
        • Table 62. CLI Commands with /cluster_partner or /partner Switch
    • Displaying and Renumbering a Container ID
      • Displaying a Container’s ID
      • Renumbering a Container’s ID
      • Specify a Cluster Partner as Part of a Container ID
    • Displaying and Setting a Container Label
    • Displaying and Setting a Container’s Type
      • Table 63. Container Types
    • Displaying a Container’s Other Container ID
  • Understanding Container Creation Attributes
    • Table 64. Container Creation Attributes
    • Displaying a Container’s Creation Date
    • Displaying a Container’s Creation Time
  • Understanding Container Size Attributes
    • Table 65. Container Size Attributes
    • Understanding Freespace
    • Displaying and Setting a Container’s Total Size
    • Displaying and Setting Stripe Size
  • Understanding Container Access Attributes
    • Table 66. Container Access Attributes
    • Displaying and Setting a Container’s Read-only Availability
    • Displaying and Setting a Container’s Read/Write Availability
    • Displaying and Setting a Container’s Lock Mode
  • Understanding Container Usage Attributes
    • Table 67. Container Usage Attributes
    • Displaying a Full Compact Snapshot Container
    • Displaying the Resident File System
    • Displaying a Multi-partition Container
    • Displaying a Container that Resides in a NetWare Environment
    • Displaying the UNIX-Opened Container
    • Displaying an Unknown File System
    • Displaying an Unmapped Container
    • Displaying an Unconfigured Container
    • Displaying a Valid Container
  • Understanding State Attributes
    • Understanding Mirror Set State Attributes
      • Table 68. Mirror Set State Attributes
      • Displaying a Mirror Set Create State
      • Displaying a Mirror Set Normal State
    • Understanding Reconfiguration State Attributes
      • Table 69. Reconfiguration State Attributes
      • Displaying the Reconfiguration Copy Container State
      • Displaying the Reconfiguration Destination Container State
      • Displaying the Reconfiguration RAID-5 Set Container State
      • Displaying the Reconfiguration Source Container State
      • Displaying the Reconfiguration Temporary Container State
    • Understanding Snapshot State Attributes
      • Table 610. Snapshot State Attributes
      • Displaying the Snapshot Original Container Create Complete State
      • Displaying the Snapshot Backing Container State
      • Displaying the Snapshot Original Container Currently Executing State
      • Displaying the Snapshot Backing Container Creation Complete State
    • Understanding RAID-5 Set State Attributes
      • Table 611. RAID-5 Set State Attribute
      • Displaying the RAID-5 Set Unprotected State
  • Understanding Container Cache Attributes
    • Table 612. Container Cache Attributes
    • Displaying a Container’s Global Container Read Cache Size
    • Displaying a Container’s Global Container Write Cache Size
    • Displaying a Container’s Read Cache Setting
    • Displaying a Container’s Write Cache Setting
    • Displaying a Container’s Write Cache Status
• Working With Single-level Containers
  • Working with a Volume Set
    • Understanding the Volume Set Attributes You Can Specify
      • Specifying Freespace When Creating a Volume Set
      • Enabling a Volume Set’s Raw Container Cache
      • Specifying a Label for a Volume Set
    • Understanding How to Create a Volume Set
    • Understanding Volume Set Creation in a NetWare Environment
    • Understanding Volume Set Creation in a UNIX Environment
    • Identifying Some Tasks to Perform After Creating a Volume Set
  • Working with a Stripe Set
    • Understanding the Stripe Set Attributes You Can Specify
      • Specifying Freespace When Creating a Stripe Set
      • Specifying Stripe Size When Creating a Stripe Set
      • Enabling a Stripe Set’s Raw Container Cache
      • Specifying a Label for a Stripe Set
    • Understanding How to Create a Stripe Set
    • Understanding Stripe Set Creation in a NetWare Environment
    • Understanding Stripe Set Creation in a UNIX Environment
    • Identifying Some Tasks to Perform After Creating a Stripe Set
  • Working with a Mirror Set
    • Understanding the Mirror Set Attributes You Can Specify
      • Specifying Mirror Disk Capacity
      • Specifying the I/O Delay
      • Specifying Synchronous or Asynchronous Mirror Set Creation
    • Understanding How to Create a Mirror Set
    • Understanding Mirror Set Creation in a NetWare Environment
    • Understanding Mirror Set Creation in a UNIX Environment
    • Identifying Some Tasks to Perform After Creating a Mirror Set
  • Working with a RAID-5 Set
    • Understanding the RAID-5 Set Attributes You Can Specify
      • Specifying Freespace When Creating a RAID-5 Set
      • Specifying Stripe Size When Creating a RAID-5 Set
      • Enabling a RAID-5 Set’s Raw Container Cache
      • Specifying a Label for a RAID-5 Set
      • Setting Up Parity by Scrubbing
      • Synchronous or Asynchronous RAID-5 Set Creation
    • Understanding How to Create a RAID-5 Set
    • Understanding RAID-5 Set Creation in a NetWare Environment
    • Understanding RAID-5 Set Creation in a UNIX Environment
    • Identifying Some Tasks to Perform After Creating a RAID-5 Set
• Working with Multi-level Containers
  • Working with Multi-level Stripe Sets
    • Working with a Stripe Set of Mirror Sets
      • Understanding the Stripe Set of Mirror Sets Attributes You can Specify
        • Specifying Stripe Size When Creating a Stripe Set of Mirror Sets
        • Specifying a Label for a Stripe Set of Mirror Sets
      • Understanding How to Create a Stripe Set of Mirror Sets
      • Understanding a Stripe Set of Mirror Set Creation in a NetWare Environment
      • Understanding a Stripe Set of Mirror Set Creation in a UNIX Environment
      • Understanding Some Tasks to Perform After Creating a Stripe Set of Mirror Sets
    • Working with a Stripe Set of Volume Sets
      • Understanding the Stripe Set of Volume Set Attributes You can Specify
        • Specifying Stripe Size When Creating a Stripe Set of Volume Sets
        • Specifying a Label for a Stripe Set of Volume Sets
      • Understanding How to Create a Stripe Set of Volume Sets
      • Understanding a Stripe Set of Volume Set Creation in a NetWare Environment
      • Understanding a Stripe Set of Volume Set Creation in a UNIX Environment
      • Understanding Some Tasks to Perform After Creating a Stripe Set of Volume Sets
    • Creating a Stripe Set of Stripe Sets
      • Understanding the Stripe Set of Stripe Set Attributes You can Specify
        • Specifying Stripe Size When Creating a Stripe Set of Stripe Sets
        • Specifying a Label for a Stripe Set of Stripe Sets
      • Understanding How to Create a Stripe Set of Stripe Sets
      • Understanding a Stripe Set of Stripe Sets in a NetWare Environment
      • Understanding a Stripe Set of Stripe Set Creation in a UNIX Environment
      • Understanding Some Tasks to Perform After Creating a Stripe Set of Stripe Sets
    • Working with a Stripe Set of RAID-5 Sets (RAID-50)
      • Understanding the Stripe Set of RAID-5 Sets Attributes You can Specify
        • Specifying Stripe Size When Creating a Stripe Set of RAID-5 Sets
        • Specifying a Label for a Stripe Set of RAID-5 Sets
      • Understanding How to Create a Stripe Set of RAID-5 Sets
      • Understanding a Stripe Set of RAID-5 Set Creation in a NetWare Environment
      • Understanding a Stripe Set of RAID-5 Set Creation in a UNIX Environment
      • Understanding Some Tasks to Perform After Creating a Stripe Set of RAID-5 Sets
  • Creating Multi-level Volume Sets
    • Creating a Volume Set of Stripe Sets
      • Understanding the Volume Set of Stripe Sets Attribute You can Specify
        • Specifying a Label for a Volume Set of Stripe Sets
      • Understanding How to Create a Volume Set of Stripe Sets
      • Understanding a Volume Set of Stripe Set Creation in a NetWare Environment
      • Understanding a Volume Set of Stripe Set Creation in a UNIX Environment
      • Understanding Some Tasks to Perform After Creating a Volume Set of Stripe Sets
    • Creating a Volume Set of Mirror Sets
      • Understanding the Volume Set of Mirror Sets Attribute You can Specify
        • Specifying a Label for a Volume Set of Mirror Sets
      • Understanding How to Create a Volume Set of Mirror Sets
      • Understanding a Volume Set of Mirror Sets in a NetWare Environment
      • Understanding a Volume Set of Mirror Set Creation in a UNIX Environment
      • Understanding Some Tasks to Perform After Creating a Volume Set of Mirror Sets
    • Creating a Volume Set of RAID-5 Sets
      • Understanding the Volume Set of RAID-5 Sets Attribute You can Specify
        • Specifying a Label for a Volume Set of RAID-5 Sets
      • Understanding How to Create a Volume Set of RAID-5 Sets
      • Understanding a Volume Set of RAID-5 Set Creation in a NetWare Environment
      • Understanding a Volume Set of RAID-5 Set Creation in a UNIX Environment
      • Understanding Some Tasks to Perform After Creating a Volume Set of RAID-5 Sets
    • Creating a Volume Set of Volume Sets
      • Understanding the Volume Set of Volume Sets Attribute You can Specify
        • Specifying a Label for a Volume Set of Volume Sets
      • Understanding How to Create a Volume Set of Volume Sets
      • Understanding a Volume Set of Volume Sets in a NetWare Environment
      • Understanding a Volume Set of Volume Set Creation in a UNIX Environment
      • Understanding Some Tasks to Perform After Creating a Volume Set of Volume Sets
  • Working with Multi-level Container’s of Mirror Sets
    • Understanding the Multi-level Container of Mirror Sets Attributes You can Specify
      • Specifying the I/O Wait Duration for a Volume Set of Mirror Sets
      • Specifying Synchronous or Asynchronous Command Execution for a Volume Set of Mirror Sets
    • Understanding How to Create a Multi-level Container of Mirror Sets
    • Understanding a Multi-level Container of Mirror Sets in a NetWare Environment
    • Understanding Some Tasks to Perform After Creating a Volume Set of Mirror Sets
• Modifying Containers
  • Working with Container Reconfiguration
    • Understanding the Container Reconfiguration Attributes You can Specify
      • Reconfiguring a Container’s Type
      • Adding SCSI Devices to a Container
      • Changing a Container’s Stripe Size
      • Changing a Container’s Partition Size
      • Moving a Container’s Partitions
      • Extending a File System
      • Specifying Synchronous or Asynchronous Command Execution
      • Restarting a Stopped Reconfigure Task
    • Understanding How to Reconfigure a Container
    • Understanding Container Reconfiguration in a UNIX Environment
  • Working with Container Promotion
    • Understanding the Container Promotion Attributes You can Specify
    • Understanding How to Promote a Container
    • Understanding Container Promotion in a UNIX Environment
  • Working with Adding a Level to a Container
    • Understanding the Container Add Level Attributes You can Specify
    • Understanding How to Add a Level to a Container
    • Understanding How to Add a Level to a Container in a UNIX Environment
  • Working with Mirror Sets
    • Splitting a Mirror Set
      • Understanding the Mirror Split Attributes You can Specify
      • Understanding How to Split a Mirror Set
      • Understanding Splitting a Mirror Set in a UNIX Environment
    • Unmirroring a Mirror Set
      • Understanding the Container Unmirroring Attributes You can Specify
      • Understanding How to Unmirror a Container
    • Scrubbing a Mirror Set
      • Understanding the Mirror Set Scrubbing Attributes You can Specify
        • Specifying the I/O Delay When Scrubbing a Mirror Set
        • Specifying No Repair when Scrubbing a Mirror Set
        • Specifying Synchronous or Asynchronous Command Execution
      • Understanding How to Scrub a Mirror Set
  • Working with a RAID-5 Set
    • Restoring a RAID-5 Set
      • Understanding the RAID-5 Set Restore Attributes You can Specify
      • Understanding How to Restore a RAID-5 Set
    • Scrubbing a RAID-5 Set
      • Understanding the RAID-5 Set Scrub Attributes You can Specify
        • Specifying the I/O Delay When Scrubbing a RAID-5 Set
        • Specifying No Repair when Scrubbing a RAID-5 Set
        • Specifying Synchronous or Asynchronous Command Execution
      • Understanding How to Scrub a RAID-5 Set
  • Working with the Raw Container Cache
    • Working with Enabling the Container’s Volatile Read-ahead Cache
      • Understanding the Read-ahead Cache Attributes You can Specify
      • Understanding How to Enable a Container’s Volatile Read-ahead Cache
    • Working with Enabling the Container’s NVRAM Write-back Cache
      • Understanding the NVRAM Write-back Cache Attributes You can Specify
        • Setting a Container’s NVRAM Write-back Cache to Unprotected
        • Enabling Write Cache
      • Understanding How to Enable a Container’s NVRAM Write-back Cache
    • Working with Releasing a Container’s Cache Buffers
      • Understanding the Container Release Cache Attributes You can Specify
      • Understanding How to Release the Cache Buffers Associated with a Container
      • Understanding Releasing the Cache Buffers Associated with a Container in a UNIX Environment
      • The container release cache feature is not available in a UNIX environment.
  • Working with Container Rebuild
    • Assigning Spare Disks to a Single Container
      • Understanding the Assign Spare Disk Attributes You can Specify
      • Understanding How to Assign Spare Disks to a Single Container
    • Removing Spare Disks from a Single Container
      • Understanding the Remove Spare Disk Attributes from a Single Container You can Specify
      • Understanding How to Remove Spare Disks from a Single Container
    • Assigning Global Spare Disks
      • Understanding the Assign Global Spare Disk Attributes You can Specify
      • Understanding How to Assign Global Spare Disks
    • Removing Global Spare Disks
      • Understanding the Remove Global Spare Disk Attributes You can Specify
      • Understanding How to Remove Global Spare Disks
  • Working with File Systems
    • Adding a File System
      • Understanding the File System Attributes You can Specify
        • Specifying a Container Label
        • Specifying the File System
        • Specifying File System Compression
        • Specifying the Allocation Size
        • Specifying Quick Format
        • Specifying Synchronous or Asynchronous Command Execution
      • Understanding How to Add a File System to a Container
      • Understanding Adding a File System in a UNIX Environment
    • Extending a File System
      • Understanding the Extend File System Attributes You can Specify
      • Understanding How to Extend a File System on a Container
      • Understanding Extending a File System on a Container in a Unix Environment
    • Removing a File System
      • Understanding the Remove File System Attributes You can Specify
      • Understanding How to Remove a File System from a Container
      • Understanding Removing a File System from a Container in a Unix Environment
  • Extending a Container
    • Extending a Volume Set
      • Understanding the Extend Volume Set Attributes You can Specify
        • Specifying Freespace
      • Understanding How to Extend a Volume Set
    • Extending a Multi-level Container of Volume Sets
      • Understanding the Extend Multi-level Container of Volume Set Attributes You can Specify
      • Understanding How to Extend a Multi-level Container of Volume Sets
  • Taking a Container Offline
    • Understanding the Container Offline Attributes You Can Specify
    • Understanding How to Take a Container Offline
  • Deleting a Container
    • Understanding the Container Delete Attributes You Can Specify
      • Specifying Always Delete a Container
      • Specifying Unconditionally Deleting a Container
    • Understanding How to Delete a Container
    • Understanding How to Delete a Container in a NetWare Environment
• Working with Snapshot Containers
  • Creating a Snapshot Container
    • Understanding the Create Snapshot Container Attributes You Can Specify
      • Specifying Compact Format When Creating a Snapshot Container
      • Specifying Stripe Size When Creating a Snapshot Container
      • Specifying Safe Mode When Creating a Snapshot Container
    • Understanding How to Create a Snapshot Container
  • Updating a Snapshot Container
    • Understanding the Update Snapshot Container Attributes that You Can Specify
      • Specifying Synchronous or Asynchronous Snapshot Container Update
    • Understanding How to Update a Container Snapshot
  • Removing a Snapshot Container
    • Understanding the Snapshot Container Remove Attributes that You Can Specify
      • Specifying How To Unconditionally Remove the Link Between the Original and Snapshot Containers
    • Understanding How to Remove a Container Snapshot
  • Clearing NVRAM of Unconfigured Snapshot Containers
    • Understanding the Controller Free Snapshot Attributes You Can Specify
    • Understanding How to Clear NVRAM of Unconfigured Snapshot Containers
• Working with Diagnostic Commands
  • Understanding Diagnostic Attributes
    • Table 111. Diagnostic Attributes
    • Displaying the Interrupt Count
    • Displaying the Interrupt Response Time
    • Displaying a Boot-time Parameter
  • Dumping Diagnostic Data
  • Displaying Internal History Log
  • Dumping Data Structures
  • Clearing Boot Parameters
  • Setting a Boot Parameter
  • Setting the Interrupt Count
  • Setting the Interrupt Timer
  • Loading Containers
• Working with Event Notification
  • Enabling E-Mail Notification
    • 1 Open the FAST control panel applet. The FAST Management Interfaces dialog box appears.
    • 2 Select the E-Mail Notification item in the Management Interfaces section of the FAST Management...
    • 3 Click OK.
    • 4 Open a Command Prompt window.
    • 5 Use the CLI commands described in the following sections to manage the controller management ev...
  • Understanding Event Notification Attributes
    • Table 121. Event Notification Attributes
    • Displaying the Mail Server
    • Displaying the Mail Message Type
    • Displaying the Mail To Line
    • Displaying the Mail Subject Line
    • Displaying the Mail Body Line
  • Setting the Mail Server
    • How to Set the Mail Server
  • Setting Mail Message Reporting
    • How to Set Mail Message Reporting
  • Testing Mail Message Reporting
    • How to Test the Mail Server
  • Clearing Mail Message Reporting
    • How to Clear the Mail Server
• Working with Tasks
  • Understanding Task Attributes
    • Table 131. Task Attributes
    • Displaying the Task ID
    • Displaying the Task Function
    • Displaying the Task Percent Done
    • Displaying the Container ID
    • Displaying the Task State
    • Displaying Task Specific1 Information
    • Displaying Task Specific2 Information
    • Displaying the Task Status
  • Starting Tasks
  • Stopping Tasks
  • Suspending Tasks
  • Resuming Tasks
• Working with Remote Management
  • Understanding Remote Management Attributes
    • Table 141. Remote Management Attributes
    • Displaying the Lock Status
    • Displaying the Computer Name
    • Displaying the Remote User Name
    • Displaying the Remote User Access Mode
  • Scanning for Remote Management Services Agents
  • Adding Information to the Remote Connection Database
  • Locking Information in the Network Connection Database
  • Unlocking Information in the Network Connection Database
  • Deleting Information from the Network Connection Database
• Working with Scripts
  • Executing a Script
    • Executing a Script from the CLI Command Prompt
    • Executing a Script from the OS Command Prompt
      • Executing Scripts at the DOS Command Prompt
      • Executing Scripts at the UNIX Command Prompt
      • Executing Scripts at the NetWare and Windows NT/2000 Command Prompts
  • Example Scripts
    • Example 1
    • Example 2
    • Example 3
• Index