Document Outline

• Contents
• Safety Notices
  • Definitions of Safety Notices
  • Safety Notice for Installing, Relocating, or Servicing
• About This Book
  • Who Should Use This Book
  • What This Book Contains
  • If You Need More Information
  • Web Support Pages
  • Numbering Convention
• Part 1. User Information
• Chapter 1. Introducing SSA and the Advanced SerialRAID Adapters
  • Serial Storage Architecture (SSA)
  • The Advanced SerialRAID Adapters (type 4–P)
    • Fast-Write Cache Feature
    • 128 MB Memory Module Feature
    • Lights of the Advanced SerialRAID Adapters
    • Port Addresses of the Advanced SerialRAID Adapters
  • SSA Adapter ID during Bring-Up
• Chapter 2. Introducing SSA Loops
  • Loops, Links, and Data Paths
    • Simple Loop
    • Simple Loop — One Disk Drive Missing
    • Simple Loop — Two Disk Drives Missing
    • One Loop with Two Adapters in One Using System
    • One Loop with Two Adapters in Each of Two Using Systems
    • Two Loops with One Adapter
    • Two Loops with Two Adapters
  • Large Configurations
    • Switching Off Using Systems
    • Switching On Using Systems
  • Configuring Devices on an SSA Loop
  • SSA Link Speed
  • Identifying and Addressing SSA Devices
    • Location Code Format
    • Pdisks, Hdisks, and Disk Drive Identification
    • SSA Unique IDs
  • Rules for SSA Loops
  • Checking the Level of the Adapter Microcode
  • Rules for the Physical Relationship between Disk Drives and Adapters
    • One Pair of Adapter Connectors in the Loop
    • Pairs of Adapter Connectors in the Loop – Some Shared Data
    • Pairs Of Adapter Connectors in the Loop – Mainly Shared Data
  • Reserving Disk Drives
  • Fast-Write Cache
• Chapter 3. RAID Functions and Array States
  • RAID Functions
    • Availability
    • Disk Drives That Are Not in Arrays
  • RAID-0 Array States
    • Good State
    • Offline State
  • RAID-1 Array States
  • RAID-5 Array States
    • Good State
    • Exposed State
      • Read Operations while in the Exposed State
      • Write Operations while in the Exposed State
    • Degraded State
    • Rebuilding State
      • Initial Rebuilding Operation
      • Disk Drive Replacement
      • Adapter Replacement
    • Offline State
    • RAID-5 Array State Flowchart
  • RAID-10 Array States
    • Good State
    • Exposed State
    • Degraded State
    • Rebuilding State
    • Offline State
    • Unknown State
    • Multiple States
• Chapter 4. Using the SSA SMIT Menus
  • Getting Access to the SSA Adapters SMIT Menu
  • Getting Access to the SSA Disks SMIT Menu
  • Getting Access to the SSA RAID Arrays SMIT Menu
• Chapter 5. Hot Spare Management
  • Deciding how to Configure Hot Spare Disk Drive Pools
  • Choosing How Many Hot Spare Disk Drives to Include in Each Pool
  • Choosing the Error Threshold (Alarm) Level for a Hot Spare Pool
  • Rules for Hot Spare Disk Drive Pools
  • Solving Hot Spare Pool Problems
• Chapter 6. Using the RAID Array Configurator
  • Installing and Configuring SSA RAID Arrays
    • Getting Access to the SSA RAID Arrays SMIT Menu
    • Adding an SSA RAID Array
    • Deleting an SSA RAID Array
    • Creating a Hot Spare Disk Drive
    • Changing or Showing the Status of a Hot Spare Pool
    • Showing the Disks That Are Protected by Hot Spares
    • Listing the Disks That Are in a Hot Spare Pool
    • Adding a New Hot Spare Pool
    • Adding Disks to, or Removing Disks from, a Hot Spare Pool
  • Dealing with RAID Array Problems
    • Getting Access to the SSA RAID Array SMIT Menu
    • Identifying and Correcting or Removing Failed Disk Drives
    • Installing a Replacement Disk Drive
  • Using Other Configuration Functions
    • Getting Access to the SSA RAID Array SMIT Menu
    • Listing All Defined SSA RAID Arrays
    • Listing All Supported SSA RAID Arrays
    • Listing All SSA RAID Arrays That Are Connected to a RAID Manager
    • Listing the Status of All Defined SSA RAID Arrays
    • Listing or Identifying SSA Physical Disk Drives
      • Listing the Disk Drives in an SSA RAID Array
      • Listing Hot Spare Disk Drives
      • Listing Rejected Array Disk Drives
      • Listing Array Candidate Disk Drives
      • Listing System Disk Drives
      • Identifying the Disk Drives in an SSA RAID Array
      • Identifying Hot Spare Disk Drives
      • Identifying Rejected Array Disk Drives
      • Identifying Array Candidate Disk Drives
      • Identifying System Disk Drives
      • Canceling all SSA Disk Drive Identifications
    • Listing or Deleting Old RAID Arrays Recorded in an SSA RAID Manager
      • Listing Old RAID Arrays Recorded in an SSA RAID Manager
      • Deleting an Old RAID Array Recorded in an SSA RAID Manager
    • Changing or Showing the Attributes of an SSA RAID Array
    • Changing Member Disks in an SSA RAID Array
      • Removing a Disk Drive from an SSA RAID Array
      • Adding a Disk Drive to an SSA RAID Array
      • Swapping Members of an SSA RAID Array
    • Changing or Showing the Use of an SSA Disk Drive
    • Changing the Use of Multiple SSA Physical Disks
    • Copying RAID-1 or RAID-10 Arrays
• Chapter 7. Copying Data from Arrays and from Volume Groups
  • Copying Data from an Array
    • Using the ssaraid Command to Create a RAID-Copy Array from a RAID-1 or RAID-10 Array
    • Using SMIT to Create a RAID-Copy Array from a RAID-1 or RAID-10 Array
    • Using the ssa_make_copy Command to Create a RAID Copy from a RAID-1 or RAID-10 Array
  • ssa_make_copy Command
    • Purpose
    • Syntax
    • Description
    • Flags
    • Example 1: Copying a Complete Volume Group
    • Example 2: Copying One Logical Volume
    • Example 3: Copying One Logical Volume by Logical Volume Name or by FS Name
    • Example 4: Copying One Logical Volume by Logical Volume Name or by FS Name (2)
    • Example 4: Copying a Complete Volume Group and Recreating the Copy on Another Using System
    • Example 5: Running an Automatic Copy of a Volume Group
  • ssa_delete_copy Command
    • Purpose
    • Syntax
    • Flags
  • SMIT Menus for 3-Way Copy Operations
    • Getting Access to the Array Copy Services Menu
    • Array Copy Services
      • Prepare a Copy
      • Uncouple a Volume Group, Logical Volumes, or Filesystems Copy
      • List All Copy Candidates
      • List All Uncoupled Copies
      • List All Uncoupled Volume Groups
      • Delete a RAID Array Copy
      • Delete a Volume Group, Logical Volumes, or Filesystems Copy
  • Effects of Array Copy on Other SMIT Menus
    • Change/Show Attributes of an SSA RAID Array
    • List Status Of All Defined SSA RAID Arrays
    • Identify Disks in an SSA RAID Array
    • Remove a Disk From an SSA RAID Array
    • Swap Members of an SSA RAID Array
• Chapter 8. Split-Site Management
  • Configuration of RAID-1 and RAID-10 Arrays
  • Operation after a Loss of Member Disks
    • One Half of the Array Is Not Present
      • Single-Host System with Primary Disk Drive Missing
      • Dual-Host System with Primary Disk Drive Missing
      • Dual-Host System with Only One System Switched On
      • Split Systems
    • Array is Offline because Adapter Is Not Known to the Remaining Half of the Array
      • Failure of an Adapter and a Disk Drive
      • Moving an Array between Systems
    • Array is Offline because the Split and Join Procedure Was Not Performed Correctly
      • RAID-10 Array Split
      • RAID-10 Array with Unsynchronized Data
• Chapter 9. Using the SSA Spare Tool
• Chapter 10. Using the Fast-Write Cache Feature
  • Fast-Write Cache Card Battery
  • Configuring the Fast-Write Cache Feature
    • Getting Access to the Fast-Write Menus
    • Enabling or Disabling Fast-Write for One Disk Drive
    • Enabling or Disabling Fast-Write for Multiple Devices
    • Bypassing the Cache in a One-Way Fast-Write Network
  • Dealing with Fast-Write Problems
    • SRN 42521
    • SRN 42524
    • SRN 42525
• Chapter 11. SSA Error Logs
  • Error Logging
    • Summary
    • Detailed Description
      • Detail Data Formats
      • run_ssa_healthcheck cron
      • run_ssa_link_speed cron
      • Duplicate Node Test
  • Error Logging Management
    • Summary
    • Detailed Description
  • Error Log Analysis
    • Summary
    • Detailed Description
      • Error Log Analysis Routine
      • Command Line Error Log Analysis
      • run_ssa_ela cron
  • Good Housekeeping
• Chapter 12. Using the SSA Command Line Interface for RAID Configurations
  • Command Syntax
  • Options
  • Object Types
  • Instruct Types
  • Examples
    • Example 1: To Create a RAID-0 Array
    • Example 2: To Create a RAID-1 Array
    • Example 3: To Create a RAID-5 Array
    • Example 4: To Create a RAID-10 Array
    • Example 5: To Create a Hot Spare Pool
    • Example 6: To List All Defined SSA Objects
    • Example 7: To Change an Attribute of an Object
    • Example 8: To Exchange a Member Disk Drive of an Existing Array
    • Example 9: To Make a New System Disk
    • Example 10: To Delete an Array
  • SSARAID Command Attributes
    • RAID Arrays Creation and Change Attributes
      • Creation and Change Attributes for All RAID Arrays
      • Creation and Change Attributes for RAID-1, RAID-5, and RAID-10 Arrays Only
      • Creation and Change Attributes for RAID-1 and RAID-10 Arrays Only
      • Creation and Change Attribute for RAID-5 Arrays Only
      • Creation and Change Attribute for RAID-10 Arrays Only
    • RAID Arrays Change Attributes
      • Change Attributes for All RAID Arrays
    • Hot Spare Pool Creation and Change Attribute
    • Physical Disk Drive Change Attributes
      • Change Attribute for Hot Spare Disk Drives Only
      • Change Attribute for Array Member Disk Drives Only
      • Other Change Attributes for Physical Disk Drives
    • Action Attributes (RAID-1, RAID-5, and RAID-10 Only)
    • Couple Action Attributes (RAID-1 and RAID-10 Only)
    • Uncouple Action Attributes (RAID-1 and RAID-10 Only)
  • Return Codes
• Chapter 13. Using the Programming Interface
  • SSA Subsystem Overview
    • Device Drivers
      • Responsibilities of the SSA Adapter Device Driver
      • Responsibilities of the SSA Disk Device Driver
    • Interface between the SSA Adapter Device Driver and Head Device Driver
    • Trace Formatting
  • SSA Adapter Device Driver
    • Purpose
    • Syntax
    • Description
      • Configuring Devices
    • PCI SSA Adapter ODM Attributes
    • Device-Dependent Subroutines
      • open and close Subroutines
    • Summary of SSA Error Conditions
    • Managing Dumps
    • Files
  • IOCINFO (Device Information) SSA Adapter Device Driver ioctl Operation
    • Purpose
    • Description
    • Files
  • SSA_TRANSACTION SSA Adapter Device Driver ioctl Operation
    • Purpose
    • Description
    • Return Values
    • Files
  • SSA_GET_ENTRY_POINT SSA Adapter Device Driver ioctl Operation
    • Purpose
    • Description
    • Return Values
    • Files
  • SSA Adapter Device Driver Direct Call Entry Point
    • Purpose
    • Description
    • Return Values
  • ssadisk SSA Disk Device Driver
    • Purpose
    • Syntax
    • Configuration Issues
      • SSA Logical Disks, SSA Physical Disks, and SSA RAID Arrays
      • Multiple Adapters
      • Configuring SSA Disk Drive Devices
    • Device Attributes
      • Attributes of the SSA Router, ssar
      • Attributes Common to SSA Logical and SSA Physical Disks
      • Attributes for SSA Logical Disks Only
    • Device-Dependent Subroutines
      • open, read, write and close Subroutines
      • readx and writex Subroutines
    • Error Conditions
    • Special Files
  • IOCINFO (Device Information) SSA Disk Device Driver ioctl Operation
    • Purpose
    • Description
    • Files
  • SSADISK_ISAL_CMD (ISAL Command) SSA Disk Device Driver ioctl Operation
    • Purpose
    • Description
    • Return Values
    • Files
  • SSADISK_ISALMgr_CMD (ISAL Manager Command) SSA Disk Device Driver ioctl Operation
    • Purpose
    • Description
    • Return Values
    • Files
  • SSADISK_SCSI_CMD (SCSI Command) SSA Disk Device Driver ioctl Operation
    • Purpose
    • Description
    • Return Values
    • Files
  • SSADISK_LIST_PDISKS SSA Disk Device Driver ioctl Operation
    • Purpose
    • Description
    • Return Values
    • Files
  • SSA Disk Concurrent Mode of Operation Interface
    • Device Driver Entry Point
    • Top Kernel Extension Entry Point
  • SSA Disk Fencing
  • SSA Target Mode
    • Configuring the SSA Target Mode
    • Buffer Management
    • Understanding Target-Mode Data Pacing
    • Using SSA Target Mode
    • Execution of Target Mode Requests
  • SSA tmssa Device Driver
    • Purpose
    • Syntax
    • Description
    • Configuration Information
    • Device-Dependent Subroutines
      • open Subroutine
      • close Subroutine
      • read Subroutine
      • write subroutine
      • ioctl Subroutine
      • select Entry Point
    • Errors
  • tmssa Special File
    • Purpose
    • Description
    • Implementation Specifics
    • Related Information
  • IOCINFO (Device Information) tmssa Device Driver ioctl Operation
    • Purpose
    • Description
  • TMIOSTAT (Status) tmssa Device Driver ioctl Operation
    • Purpose
    • Description
  • TMCHGIMPARM (Change Parameters) tmssa Device Driver ioctl Operation
    • Purpose
    • Description
• Part 2. Maintenance Information
• Chapter 14. SSA Adapter Information
  • Installing the SSA Adapter
  • Cron Table Entries
  • Microcode Maintenance
    • Checking the ID and Level of the Microcode Package
    • Maintaining the Adapter Microcode
    • Maintaining the Disk Drive Microcode
  • Vital Product Data (VPD) for the SSA Adapter
  • Adapter Power-On Self-Tests (POSTs)
• Chapter 15. Removal and Replacement Procedures
  • Exchanging Disk Drives
  • Changing Pdisk and Hdisk Numbers
  • Removing and Replacing an Advanced SerialRAID Adapter
  • Removing an SDRAM Module of an Advanced SerialRAID Adapter
  • Installing an SDRAM Module of an Advanced SerialRAID Adapter
  • Removing the Fast-Write Cache Option Card of an Advanced SerialRAID Adapter
  • Installing the Fast-Write Cache Option Card of an Advanced SerialRAID Adapter
  • Removing the Battery Assembly from the Fast-Write Cache Option Card of an Advanced SerialRAID Adapter
  • Installing a Battery Assembly into the Fast-Write Cache Option Card of an Advanced SerialRAID Adapter
  • Part Numbers
• Chapter 16. Using the SSA Command Line Utilities
  • ssa_sesdld Command
    • Purpose
    • Syntax
    • Description
    • Flags
    • Examples
  • ssaadap Command
    • Purpose
    • Syntax
    • Description
    • Flags
  • ssacand Command
    • Purpose
    • Syntax
    • Description
    • Flags
  • ssa_certify Command
    • Purpose
    • Syntax
    • Description
    • Flags
  • ssaconn Command
    • Purpose
    • Syntax
    • Description
    • Flags
  • ssa_diag Command
    • Purpose
    • Syntax
    • Description
    • Flags
    • Output
  • ssadisk Command
    • Purpose
    • Syntax
    • Description
    • Flags
  • ssadload Command
    • Purpose
    • Syntax
    • Description
    • Flags
    • Examples
  • ssa_ela Command
    • Purpose
    • Syntax
    • Description
    • Flags
    • Output
  • ssaencl Command
    • Purpose
    • Syntax
    • Description
    • Flags
    • Examples
  • ssa_format Command
    • Purpose
    • Syntax
    • Description
    • Flags
    • Output
  • ssa_fw_status Command
    • Purpose
    • Syntax
    • Description
    • Flags
    • Output
    • Examples
  • ssa_getdump Command
    • Purpose
    • Syntax
    • Description
      • List Mode
      • Copy Mode
    • Flags
      • Required Flags for Both Modes
      • Required Flags for Copy Mode
      • Optional Flags for List Mode
      • Optional Flags for Copy Mode
    • Output
  • ssaidentify Command
    • Purpose
    • Syntax
    • Description
    • Flags
  • ssa_progress Command
    • Purpose
    • Syntax
    • Description
    • Flags
    • Output
    • Examples
  • ssa_rescheck Command
    • Purpose
    • Syntax
    • Description
    • Flags
    • Output
    • Examples
    • Return Codes
  • ssa_servicemode Command
    • Purpose
    • Syntax
    • Description
    • Flags
    • Output
  • ssa_speed Command
    • Purpose
    • Syntax
    • Description
    • Flags
    • Output
    • Examples
  • ssavfynn Command
    • Purpose
    • Syntax
    • Description
    • Flags
    • Output
  • ssaxlate Command
    • Purpose
    • Syntax
    • Description
    • Flags
• Chapter 17. SSA Service Aids
  • The Identify Function
  • Starting the SSA Service Aids
  • Set Service Mode Service Aid
  • Link Verification Service Aid
  • Configuration Verification Service Aid
  • Format Disk Service Aid
  • Certify Disk Service Aid
  • Display/Download Disk Drive Microcode Service Aid
  • Link Speed Service Aid
  • Service Aid Service Request Numbers (SRNs)
  • Using the Service Aids for SSA-Link Problem Determination
    • Example 1. Normal Loops
    • Example 2. Broken Loop (Cable Removed)
    • Example 3. Broken Loop (Disk Drive Removed)
  • Finding the Physical Location of a Device
    • Finding the Device When Service Aids Are Available
    • Finding the Device When No Service Aids Are Available
• Chapter 18. SSA Problem Determination Procedures
  • Service Request Numbers (SRNs)
    • The SRN Table
    • Using the SRN Table
  • Software and Microcode Errors
  • SSA Loop Configurations that Are Not Valid
  • SSA Maintenance Analysis Procedures (MAPs)
    • How to Use the MAPs
  • MAP 2010: START
  • MAP 2320: SSA Link
  • MAP 2323: SSA Intermittent Link Error
  • MAP 2324: SSA RAID
  • MAP 2410: SSA Repair Verification
  • SSA Link Errors
    • SSA Link Error Problem Determination
    • Link Status (Ready) Lights
    • Service Aid
    • Repair Actions
• Part 3. Appendixes
• Appendix. Communications Statements
  • Federal Communications Commission (FCC) Statement
  • Japanese Voluntary Control Council for Interference (VCCI) Statement
  • Korean Government Ministry of Communication (MOC) Statement
  • New Zealand Compliance Statement
  • International Electrotechnical Commission (IEC) Statement
  • Avis de conformité à la réglementation d’Industrie Canada
  • Industry Canada Compliance Statement
  • United Kingdom Telecommunications Requirements
  • European Union (EU) Statement
  • Radio Protection for Germany
  • Taiwan Class A Compliance Statement
• Glossary
• Index