Main
            Page
            Page
            Page
              Contents
Part 1. User Information ........................1                
iii
              iv 
              ||||| ||||| |||||||||||||||||
||||||||||||||||||||||||||              
vi 
              ||||
              viii 
              Part 2. Maintenance Information ....................311
||||||||||||              
x
              ||||||||||||||
              Part 3. Appendixes..........................483
xii             
Page
            Page
              Safety Notices
Definitions of Safety Notices                
xv
Safety Notice for Installing, Relocating, or Servicing            
Page
              About This Book
Who Should Use This Book                
xvii
What This Book Contains                
If You Need More Information
              Web Support Pages
Numbering Convention            
Page
            Page
              Chapter 1. Introducing SSA and the Advanced SerialRAIDAdapters
Serial Storage Architecture (SSA)                
The Advanced SerialRAID Adapters (type 4P)
              4-P
4              
Fast-Write Cache Feature
128 MB Memory Module Feature              
Lights of the Advanced SerialRAID Adapters
Port Addresses of the Advanced SerialRAID Adapters                
6
SSA Adapter ID during Bring-Up              
Chapter 2. Introducing SSA Loops
Loops, Links, and Data Paths              
Simple Loop 
8              
Simple Loop One Disk Drive Missing
              Simple Loop Two Disk Drives Missing
10               
One Loop with TwoAdapters in One Using System
Figure5. One Loop with Two Adapters in One Using System              
One Loop with TwoAdapters in Each of Two Using Systems
12             
Page
            Page
            Page
              Large Configurations
SSA Disk Drives                
16 
              Switching Off Using Systems
Switching On Using Systems              
Configuring Devices on an SSA Loop
SSA Link Speed                
18 
              Identifying and Addressing SSA Devices
Location Code Format                
Pdisks, Hdisks, and Disk Drive Identification
            Page
              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                
24 
              Pairs of Adapter Connectors in the Loop Some Shared Data
              Pairs Of Adapter Connectors in the Loop Mainly Shared Data
26               
Reserving Disk Drives
Fast-Write Cache            
Page
              Chapter 3. RAID Functions and Array States
RAID Functions                
Availability 
              Disk Drives That Are Not in Arrays
            Page
              RAID-1 Array States
32               
RAID-5 Array States
Good State                  
Exposed State
Read Operations while in the Exposed State                
Write Operations while in the Exposed State
              Rebuilding State
Initial Rebuilding Operation                
34 
Disk Drive Replacement                
Adapter Replacement
              RAID-5 Array State Flowchart
Figure15. RAID-5 Array State Flowchart                
Chapter3. RAID Functions and Array States 35
              RAID-10 Array States
Good State                  
36 
Exposed State              
Degraded State
Rebuilding State                
Offline State  
              Unknown State
Multiple States                
38 
              Chapter 4. Using the SSA SMIT Menus
              Getting Access to the SSAAdapters SMIT Menu
40               
Getting Access to the SSA Disks SMIT Menu
4. The SSALogical Disks menu is displayed:              
42 
If you need help with an item, move the cursor to that item, and press F1 (Help).              
Getting Access to the SSA RAIDArrays SMIT Menu
            Page
              Chapter 5. Hot Spare Management
Deciding how to Configure Hot Spare Disk Drive Pools              
46 
Building 1 Building 2                
Figure16. Primary Disks in Building 1; Secondary Disks in Building 2
            Page
              48 
            Page
              50 
              Choosing How Many Hot Spare Disk Drives to Include in Each Pool
Choosing the Error Threshold (Alarm) Level for a Hot Spare Pool                
Enclosure-1 
hdisk1 Primary Disks hdisk2 Primary Disks spare                
Enclosure-2 
              Rules for Hot Spare Disk Drive Pools
52               
Solving Hot Spare Pool Problems
              54 
            Page
            Page
              Chapter 6. Using the RAID Array Configurator
              Installing and Configuring SSA RAID Arrays
58               
Getting Access to the SSA RAIDArrays SMIT Menu
              Adding an SSA RAID Array
60               
Chapter6. Using the RAID Array Configurator 61
              62 
              If you select RAID-1, the following menu is displayed:
Chapter6. Using the RAID Array Configurator 63                
If you select RAID-5, the following menu is displayed:
              64 
              If you select RAID-10, the following menu is displayed:
Chapter6. Using the RAID Array Configurator 65              
66 
            Page
              68 
            Page
              Deleting an SSA RAID Array
70               
3. Aprompt is displayed in a window:
Chapter6. Using the RAID Array Configurator 71              
Creating a Hot Spare Disk Drive
72             
Page
              Changing or Showing the Status of a Hot Spare Pool
74             
Page
              76 
              Showing the Disks That Are Protected by Hot Spares
              78 
            Page
              Listing the Disks That Are in a Hot Spare Pool
80             
Page
              82 
              Adding a New Hot Spare Pool
3. Alist that shows Loop A or Loop B is displayed:              
84 
This menu automatically assigns the next available pool number to the new pool.            
Page
              Adding Disks to, or Removing Disks from, a Hot Spare Pool
86               
3. Alist of hot spare pools is displayed:
Select the hot spare pool that you want to change.                
Chapter6. Using the RAID Array Configurator 87
              88 
              Dealing with RAID Array Problems
              Getting Access to the SSA RAIDArray SMIT Menu
90               
Identifying and Correcting or Removing Failed Disk Drives
              92 
            Page
            Page
              Installing a Replacement Disk Drive
              96 
              Using Other Configuration Functions
              Getting Access to the SSA RAIDArray SMIT Menu
98             
Page
              Listing All Defined SSA RAID Arrays
100               
Listing All Supported SSA RAID Arrays
              Listing All SSA RAIDArrays That Are Connected to a RAID Manager
102               
3. Alist of arrays is displayed:
Chapter6. Using the RAID Array Configurator 103              
Listing the Status of All Defined SSA RAIDArrays
104               
3. The following information is displayed for RAID-5 arrays:
Chapter6. Using the RAID Array Configurator 105              
106 
            Page
              Listing or Identifying SSA Physical Disk Drives
              Listing the Disk Drives in an SSA RAID Array
3. Alist of disk drives is displayed:              
110 
              Listing Hot Spare Disk Drives
3. Alist of hot spare disk drives is displayed:              
112 
              Listing Rejected Array Disk Drives
3. Alist of rejected disk drives is displayed:              
114 
              Listing Array Candidate Disk Drives
3. Alist of candidate disk drives is displayed:              
116 
              Listing System Disk Drives
            Page
              Identifying the Disk Drives in an SSA RAID Array
              120 
              Identifying Hot Spare Disk Drives
              122 
              Identifying Rejected Array Disk Drives
              124 
              Identifying Array Candidate Disk Drives
              126 
              Identifying System Disk Drives
            Page
            Page
              Listing or Deleting Old RAID Arrays Recorded in an SSA RAID Manager
130               
Listing Old RAID Arrays Recorded in an SSA RAID Manager
5. If any old arrays are in the RAID manager,a list of those arrays appears:              
132 
              Deleting an Old RAID Array Recorded in an SSA RAID Manager
              134 
              Changing or Showing the Attributes of an SSA RAIDArray
            Page
              Changing Member Disks in an SSA RAID Array
              Removing a Disk Drive from an SSA RAID Array
138             
Page
              Adding a Disk Drive to an SSA RAID Array
140             
Page
              Swapping Members of an SSA RAID Array
142             
Page
              Changing or Showing the Use of an SSA Disk Drive
              3. Alist of disk drives and their usage is displayed in a window:
Chapter6. Using the RAID Array Configurator 145              
146 
              Changing the Use of Multiple SSA Physical Disks
              Copying RAID-1 or RAID-10 Arrays
              Chapter 7. Copying Data from Arrays and from VolumeGroups
            Page
              Copying Data from an Array
Using the ssaraid Command to Create a RAID-Copy Array from a RAID-1 or RAID-10 Array            
Page
            Page
            Page
              Using SMIT to Create a RAID-Copy Array from a RAID-1 or RAID-10 Array
            Page
            Page
            Page
              Using the ssa_make_copy Command to Create a RAID Copy from a RAID-1 or RAID-10 Array
            Page
              ssa_make_copy Command Purpose 
Description             
Page
            Page
              Example 1: Copying a Complete Volume Group
              Example 2: Copying One Logical Volume
              Example 3: Copying One Logical Volume by Logical VolumeName or by FS Name 
            Page
              Example 4: Copying One Logical Volume by Logical VolumeName 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 VolumeGroup
              ssa_delete_copy Command Purpose 
              SMIT Menus for 3-Way Copy Operations
Getting Access to the Array Copy Services Menu              
Array Copy Services
            Page
              Prepare a Copy
            Page
              Uncouple a Volume Group, Logical Volumes,or Filesystems Copy
            Page
              List All Copy Candidates
            Page
              List All Uncoupled Copies
              List All Uncoupled VolumeGroups
              Delete a RAID Array Copy
              Delete a Volume Group, Logical Volumes,or Filesystems Copy
            Page
              Effects of Array Copy on Other SMIT Menus
Change/Show Attributes of an SSA RAID Array            
Page
              List Status Of All Defined SSA RAIDArrays
              Identify Disks in an SSA RAID Array
              Remove a Disk From an SSA RAID Array
              Swap Members of an SSA RAID Array
            Page
              Chapter 8. Split-Site Management
Configuration of RAID-1 and RAID-10 Arrays              
Operation after a Loss of Member Disks
194               
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
System 2 SSA Adapter                
198 
              Split Systems
              200 
            Page
              202 
              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
204               
Array is Offline because the Split and Join Procedure Was Not Performed Correctly 
              RAID-10 Array Split
206               
RAID-10 Array with Unsynchronized Data
? ?            
Page
              Chapter 9. Using the SSA Spare Tool
            Page
              Chapter 10. Using the Fast-Write Cache Feature
Fast-Write Cache Card Battery                
Configuring the Fast-Write Cache Feature
            Page
              Getting Access to the Fast-Write Menus
              Enabling or Disabling Fast-Write for One Disk Drive
214               
Enabling or Disabling Fast-Write for Multiple Devices
              216 
              Bypassing the Cache in a One-Way Fast-Write Network
              Dealing with Fast-Write Problems
SRN 42521                  
218 
            Page
              SRN 42524  
SRN 42525                  
220 
              Chapter 11. SSAError Logs
Error Logging Summary               
222 
            Page
Table2. Error Labels (continued)              
224 
:|              
Detail Data Formats
              run_ssa_healthcheck cron
226               
run_ssa_link_speed cron
Duplicate Node Test              
Error Logging Management Summary 
228               
Error Log Analysis Summary 
              Error Log Analysis Routine
230             
Page
              Command Line Error Log Analysis
run_ssa_ela cron                
232 
              Good Housekeeping
            Page
              Chapter 12. Using the SSA Command Line Interface for RAID Configurations
              236 
              Command Syntax
              Options
Object Types                
Instruct Types
238               
Example 1: To Create a RAID-0Array
Example 2: To Create a RAID-1Array              
Example 3: To Create a RAID-5Array
Example 4: To Create a RAID-10Array                
240 
              Example 5: To Create a Hot Spare Pool
Example 6: To ListAll Defined SSA Objects              
Example 7: To Change anAttribute of an Object
Example 8: To Exchange a Member Disk Drive of an ExistingArray                
242 
              Example 9: To Make a New System Disk
Example 10: To Delete anArray              
SSARAID Command Attributes
RAID Arrays Creation and Change Attributes                
244 
Creation and Change Attributes for All RAIDArrays              
Creation and Change Attributes for RAID-1, RAID-5, and RAID-10 Arrays Only
            Page
              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
250               
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
            Page
              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                
256 
              SSA Adapter Device Driver Purpose  Syntax 
Description                 
Configuring Devices
PCI SSA Adapter ODMAttributes              
open and close Subroutines
              Summary of SSA Error Conditions
Managing Dumps            
Page
            Page
              SSA_TRANSACTION SSA Adapter Device Driver ioctl Operation Purpose  Description 
262               
Files 
            Page
            Page
              ssadisk SSA Disk Device Driver Purpose  Syntax 
Configuration Issues SSA Logical Disks, SSA Physical Disks, and SSARAID Arrays              
Multiple Adapters
              Configuring SSA Disk Drive Devices
            Page
              Device Attributes
Attributes of the SSA Router, ssar                
270 
              Attributes Common to SSA Logical and SSA Physical Disks
Attributes for SSA Logical Disks Only              
open, read, write and close Subroutines
272             
Page
              readx and writex Subroutines
Error Conditions                
274 
            Page
              Special Files 
276             
Page
              SSADISK_ISAL_CMD (ISAL Command) SSA Disk Device Driver ioctl Operation Purpose 
Description                 
278 
            Page
            Page
              SSADISK_ISALMgr_CMD (ISAL Manager Command) SSA Disk Device Driver ioctl Operation Purpose 
Description               
282 
              SSADISK_SCSI_CMD (SCSI Command) SSA Disk Device Driver ioctl Operation Purpose 
Description               
284 
              SSADISK_LIST_PDISKS SSA Disk Device Driver ioctl Operation Purpose 
Description               
286 
              SSA Disk Concurrent Mode of Operation Interface
Device Driver Entry Point              
Top Kernel Extension Entry Point
288             
Page
              SSA Disk Fencing
290               
SSA Target Mode
              Configuring the SSA TargetMode
292               
Buffer Management
Understanding Target-Mode Data Pacing              
Using SSA TargetMode
Execution of Target Mode Requests                
294 
              SSA tmssa Device Driver Purpose 
Syntax                 
Description 
              Configuration Information
open Subroutine                
296 
              close Subroutine
read Subroutine              
298 
              write subroutine
              300 
              ioctl Subroutine
select Entry Point              
Errors 
302             
Page
              tmssa Special File Purpose  Description 
Implementation Specifics                
304 
Related Information              
IOCINFO (Device Information) tmssa Device Driver ioctl Operation Purpose 
Description             
Page
              TMIOSTAT(Status) tmssa Device Driver ioctl Operation Purpose 
Description               
TMCHGIMPARM (Change Parameters) tmssa Device Driver ioctl Operation Purpose 
Description                 
308 
            Page
            Page
            Page
            Page
              Chapter 14. SSA Adapter Information
Installing the SSA Adapter                
Cron Table Entries
              Microcode Maintenance
Checking the ID and Level of the Microcode Package                
314 
              Maintaining the Adapter Microcode
Maintaining the Disk Drive Microcode              
Vital Product Data (VPD) for the SSA Adapter
316               
Adapter Power-On Self-Tests (POSTs)
            Page
              Chapter 15. Removal and Replacement Procedures
Exchanging Disk Drives                
3. Select the array that you want to delete.
              320 
            Page
              322 
            Page
            Page
            Page
              Changing Pdisk and Hdisk Numbers
326               
Removing and Replacing an Advanced SerialRAID Adapter
            Page
              Removing an SDRAM Module of an Advanced SerialRAID Adapter
              Installing an SDRAM Module of an Advanced SerialRAID Adapter
              1 1
              Removing the Fast-Write Cache Option Card of an Advanced SerialRAID Adapter
332             
Page
              Installing the Fast-Write Cache Option Card of an Advanced SerialRAID Adapter
334             
Page
              336 
            Page
            Page
            Page
            Page
              Chapter 16. Using the SSA Command Line Utilities
ssa_sesdld Command Purpose                 
Description 
              Examples 
            Page
            Page
              ssa_certify Command Purpose
Description               
346 
            Page
              ssa_diag Command Purpose 
Description                 
Output 
348             
Page
              ssadload Command Purpose 
Description                 
350 
            Page
            Page
              ssa_ela Command Purpose 
Description             
Page
              ssaencl Command Purpose 
Syntax                 
Description 
              356 
            Page
              ssa_format Command Purpose 
Description                 
358 
            Page
              ssa_fw_status Command Purpose 
Description                 
Output 
            Page
              Flags 
Required Flags for Both Modes                
362 
Required Flags for Copy Mode                
Optional Flags for List Mode
              Optional Flags for Copy Mode
Output             
Page
            Page
            Page
              Examples 
Return Codes            
Page
              ssa_speed Command Purpose 
Description               
Output 
370             
Page
            Page
              Chapter 17. SSA Service Aids
            Page
              The Identify Function
              Starting the SSA Service Aids
376             
Page
              Set Service Mode Service Aid
378               
The columns of information displayed on the screen have the following meanings:
              380 
            Page
              382 
              Link Verification Service Aid
              384 
            Page
              386 
              Configuration Verification Service Aid
              388 
              Format Disk Service Aid
              390 
              Certify Disk Service Aid
              392 
              Display/Download Disk Drive Microcode Service Aid
              394 
            Page
              Link Speed Service Aid
396             
Page
              398 
              This screen shows the same configuration, but here the link is broken between pdisk1 and pdisk2.
Figure55 gives a physical representation of the configuration that is shown on the screen.                
Figure55. Configuration with Broken Link Shown by the Service Aid
            Page
              Example 1. Normal Loops
Chapter17. SSAService Aids 401                
Figure56. Normal Loop
Note: Scroll the display to see all the connected disk drives.              
402 
              Example 2. Broken Loop (Cable Removed)
Figure57. Broken Loop (Cable Removed)              
404 
              Note that the column for adapter connectorA2 shows no connections.
Chapter17. SSAService Aids 405              
Example 3. Broken Loop (Disk Drive Removed)
406               
Figure58. Broken Loop (Disk Drive Removed)
Note that the missing disk drive (pdisk8) is represented by a line of question marks.              
408 
              Finding the Physical Location of a Device
Finding the Device When Service Aids AreAvailable                
Finding the Device When No Service Aids AreAvailable
            Page
              Chapter 18. SSA Problem Determination Procedures
Service Request Numbers (SRNs)                
The SRN Table
Using the SRN Table            
Page
            Page
              414 
            Page
            Page
            Page
              418 
            Page
              420 
            Page
            Page
            Page
            Page
            Page
              426 
            Page
              428 
            Page
              430 
            Page
              432 
            Page
            Page
            Page
              436 
            Page
            Page
            Page
              440 
              Software and Microcode Errors
SSA Loop Configurations that Are Not Valid            
Page
              SSA Maintenance Analysis Procedures (MAPs)
How to Use the MAPs              
MAP 2010: START
444               
MAP 2320: SSA Link
              446 
            Page
              448 
            Page
              MAP 2323: SSA Intermittent Link Error
450             
Page
              452 
            Page
              MAP 2324: SSA RAID
            Page
              456 
            Page
              458 
            Page
              460 
            Page
              462 
            Page
              464 
            Page
              466 
            Page
            Page
            Page
              470 
            Page
            Page
            Page
            Page
              MAP 2410: SSA Repair Verification
              476 
            Page
              SSA Link Errors
SSA Link Error Problem Determination                
478 
            Page
Cable              
SSASubsystem SSASubsystem
Cable                
480 
              Link Status (Ready) Lights
              Service Aid  
Repair Actions                
482 
            Page
            Page
              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 conformitla rglementation dIndustrie Canada                
486 
Industry Canada Compliance Statement                
United Kingdom Telecommunications Requirements
            Page
            Page
Glossary              
A
B                
C
D                
E
              F
G                
H
I                
K
              N
O                
P
R                
S
              U
V                
Index
              Numerics
A              
494 
              B
C              
496 
              D
              498 
              E
F              
G
H                
500 
I              
L
M                
N
O              
P
R                
502 
            Page
              S
504             
Page
              506 
              T
              U
V                
508 
W