Compex Systems SA33-3285-02 User Manuals

Table of Contents

• Contents

  5
• Safety Notices

  17
  • Definitions of Safety Notices

    17
  • Safety Notice for Installing, Relocating, or Servicing

    17
• About This Book

  19
  • Who Should Use This Book

    19
  • What This Book Contains

    19
  • If You Need More Information

    19
  • Web Support Pages

    20
  • Numbering Convention

    20
• Part 1. User Information

  21
• Chapter 1. Introducing SSA and the Advanced SerialRAID Adapters

  23
  • Serial Storage Architecture (SSA)

    23
  • The Advanced SerialRAID Adapters (type 4–P)

    24
    • Fast-Write Cache Feature

      25
    • 128 MB Memory Module Feature

      25
    • Lights of the Advanced SerialRAID Adapters

      26
    • Port Addresses of the Advanced SerialRAID Adapters

      26
  • SSA Adapter ID during Bring-Up

    26
• Chapter 2. Introducing SSA Loops

  27
  • Loops, Links, and Data Paths

    27
    • Simple Loop

      28
    • Simple Loop — One Disk Drive Missing

      29
    • Simple Loop — Two Disk Drives Missing

      30
    • One Loop with Two Adapters in One Using System

      31
    • One Loop with Two Adapters in Each of Two Using Systems

      32
    • Two Loops with One Adapter

      34
    • Two Loops with Two Adapters

      35
  • Large Configurations

    36
    • Switching Off Using Systems

      37
    • Switching On Using Systems

      37
  • Configuring Devices on an SSA Loop

    38
  • SSA Link Speed

    38
  • Identifying and Addressing SSA Devices

    39
    • Location Code Format

      39
    • Pdisks, Hdisks, and Disk Drive Identification

      39
    • SSA Unique IDs

      41
  • Rules for SSA Loops

    42
  • Checking the Level of the Adapter Microcode

    43
  • Rules for the Physical Relationship between Disk Drives and Adapters

    44
    • One Pair of Adapter Connectors in the Loop

      44
    • Pairs of Adapter Connectors in the Loop – Some Shared Data

      45
    • Pairs Of Adapter Connectors in the Loop – Mainly Shared Data

      46
  • Reserving Disk Drives

    47
  • Fast-Write Cache

    47
• Chapter 3. RAID Functions and Array States

  49
  • RAID Functions

    49
    • Availability

      49
    • Disk Drives That Are Not in Arrays

      50
  • RAID-0 Array States

    51
    • Good State

      51
    • Offline State

      51
  • RAID-1 Array States

    52
  • RAID-5 Array States

    53
    • Good State

      53
    • Exposed State

      53
      • Read Operations while in the Exposed State

        53
      • Write Operations while in the Exposed State

        53
    • Degraded State

      53
    • Rebuilding State

      54
      • Initial Rebuilding Operation

        54
      • Disk Drive Replacement

        54
      • Adapter Replacement

        54
    • Offline State

      54
    • RAID-5 Array State Flowchart

      55
  • RAID-10 Array States

    56
    • Good State

      56
    • Exposed State

      56
    • Degraded State

      57
    • Rebuilding State

      57
    • Offline State

      57
    • Unknown State

      58
    • Multiple States

      58
• Chapter 4. Using the SSA SMIT Menus

  59
  • Getting Access to the SSA Adapters SMIT Menu

    60
  • Getting Access to the SSA Disks SMIT Menu

    61
  • Getting Access to the SSA RAID Arrays SMIT Menu

    63
• Chapter 5. Hot Spare Management

  65
  • Deciding how to Configure Hot Spare Disk Drive Pools

    65
  • Choosing How Many Hot Spare Disk Drives to Include in Each Pool

    71
  • Choosing the Error Threshold (Alarm) Level for a Hot Spare Pool

    71
  • Rules for Hot Spare Disk Drive Pools

    72
  • Solving Hot Spare Pool Problems

    73
• Chapter 6. Using the RAID Array Configurator

  77
  • Installing and Configuring SSA RAID Arrays

    78
    • Getting Access to the SSA RAID Arrays SMIT Menu

      79
    • Adding an SSA RAID Array

      80
    • Deleting an SSA RAID Array

      90
    • Creating a Hot Spare Disk Drive

      92
    • Changing or Showing the Status of a Hot Spare Pool

      94
    • Showing the Disks That Are Protected by Hot Spares

      97
    • Listing the Disks That Are in a Hot Spare Pool

      100
    • Adding a New Hot Spare Pool

      103
    • Adding Disks to, or Removing Disks from, a Hot Spare Pool

      106
  • Dealing with RAID Array Problems

    109
    • Getting Access to the SSA RAID Array SMIT Menu

      110
    • Identifying and Correcting or Removing Failed Disk Drives

      111
    • Installing a Replacement Disk Drive

      115
  • Using Other Configuration Functions

    117
    • Getting Access to the SSA RAID Array SMIT Menu

      118
    • Listing All Defined SSA RAID Arrays

      120
    • Listing All Supported SSA RAID Arrays

      121
    • Listing All SSA RAID Arrays That Are Connected to a RAID Manager

      122
    • Listing the Status of All Defined SSA RAID Arrays

      124
    • Listing or Identifying SSA Physical Disk Drives

      128
      • Listing the Disk Drives in an SSA RAID Array

        129
      • Listing Hot Spare Disk Drives

        131
      • Listing Rejected Array Disk Drives

        133
      • Listing Array Candidate Disk Drives

        135
      • Listing System Disk Drives

        137
      • Identifying the Disk Drives in an SSA RAID Array

        139
      • Identifying Hot Spare Disk Drives

        141
      • Identifying Rejected Array Disk Drives

        143
      • Identifying Array Candidate Disk Drives

        145
      • Identifying System Disk Drives

        147
      • Canceling all SSA Disk Drive Identifications

        149
    • Listing or Deleting Old RAID Arrays Recorded in an SSA RAID Manager

      150
      • Listing Old RAID Arrays Recorded in an SSA RAID Manager

        151
      • Deleting an Old RAID Array Recorded in an SSA RAID Manager

        153
    • Changing or Showing the Attributes of an SSA RAID Array

      155
    • Changing Member Disks in an SSA RAID Array

      157
      • Removing a Disk Drive from an SSA RAID Array

        158
      • Adding a Disk Drive to an SSA RAID Array

        160
      • Swapping Members of an SSA RAID Array

        162
    • Changing or Showing the Use of an SSA Disk Drive

      164
    • Changing the Use of Multiple SSA Physical Disks

      167
    • Copying RAID-1 or RAID-10 Arrays

      168
• Chapter 7. Copying Data from Arrays and from Volume Groups

  169
  • Copying Data from an Array

    171
    • Using the ssaraid Command to Create a RAID-Copy Array from a RAID-1 or RAID-10 Array

      171
    • Using SMIT to Create a RAID-Copy Array from a RAID-1 or RAID-10 Array

      175
    • Using the ssa_make_copy Command to Create a RAID Copy from a RAID-1 or RAID-10 Array

      179
  • ssa_make_copy Command

    181
    • Purpose

      181
    • Syntax

      181
    • Description

      181
    • Flags

      182
    • Example 1: Copying a Complete Volume Group

      184
    • Example 2: Copying One Logical Volume

      185
    • Example 3: Copying One Logical Volume by Logical Volume Name or by FS Name

      186
    • Example 4: Copying One Logical Volume by Logical Volume Name or by FS Name (2)

      188
    • Example 4: Copying a Complete Volume Group and Recreating the Copy on Another Using System

      189
    • Example 5: Running an Automatic Copy of a Volume Group

      190
  • ssa_delete_copy Command

    191
    • Purpose

      191
    • Syntax

      191
    • Flags

      191
  • SMIT Menus for 3-Way Copy Operations

    192
    • Getting Access to the Array Copy Services Menu

      192
    • Array Copy Services

      193
      • Prepare a Copy

        195
      • Uncouple a Volume Group, Logical Volumes, or Filesystems Copy

        197
      • List All Copy Candidates

        199
      • List All Uncoupled Copies

        201
      • List All Uncoupled Volume Groups

        202
      • Delete a RAID Array Copy

        203
      • Delete a Volume Group, Logical Volumes, or Filesystems Copy

        204
  • Effects of Array Copy on Other SMIT Menus

    206
    • Change/Show Attributes of an SSA RAID Array

      206
    • List Status Of All Defined SSA RAID Arrays

      208
    • Identify Disks in an SSA RAID Array

      209
    • Remove a Disk From an SSA RAID Array

      210
    • Swap Members of an SSA RAID Array

      211
• Chapter 8. Split-Site Management

  213
  • Configuration of RAID-1 and RAID-10 Arrays

    213
  • Operation after a Loss of Member Disks

    214
    • One Half of the Array Is Not Present

      215
      • Single-Host System with Primary Disk Drive Missing

        216
      • Dual-Host System with Primary Disk Drive Missing

        217
      • Dual-Host System with Only One System Switched On

        218
      • Split Systems

        219
    • Array is Offline because Adapter Is Not Known to the Remaining Half of the Array

      223
      • Failure of an Adapter and a Disk Drive

        223
      • Moving an Array between Systems

        224
    • Array is Offline because the Split and Join Procedure Was Not Performed Correctly

      225
      • RAID-10 Array Split

        226
      • RAID-10 Array with Unsynchronized Data

        227
• Chapter 9. Using the SSA Spare Tool

  229
• Chapter 10. Using the Fast-Write Cache Feature

  231
  • Fast-Write Cache Card Battery

    231
  • Configuring the Fast-Write Cache Feature

    231
    • Getting Access to the Fast-Write Menus

      233
    • Enabling or Disabling Fast-Write for One Disk Drive

      234
    • Enabling or Disabling Fast-Write for Multiple Devices

      235
    • Bypassing the Cache in a One-Way Fast-Write Network

      237
  • Dealing with Fast-Write Problems

    238
    • SRN 42521

      238
    • SRN 42524

      240
    • SRN 42525

      240
• Chapter 11. SSA Error Logs

  241
  • Error Logging

    241
    • Summary

      241
    • Detailed Description

      242
      • Detail Data Formats

        245
      • run_ssa_healthcheck cron

        246
      • run_ssa_link_speed cron

        247
      • Duplicate Node Test

        247
  • Error Logging Management

    248
    • Summary

      248
    • Detailed Description

      248
  • Error Log Analysis

    249
    • Summary

      249
    • Detailed Description

      250
      • Error Log Analysis Routine

        250
      • Command Line Error Log Analysis

        252
      • run_ssa_ela cron

        252
  • Good Housekeeping

    253
• Chapter 12. Using the SSA Command Line Interface for RAID Configurations

  255
  • Command Syntax

    257
  • Options

    258
  • Object Types

    258
  • Instruct Types

    258
  • Examples

    259
    • Example 1: To Create a RAID-0 Array

      259
    • Example 2: To Create a RAID-1 Array

      259
    • Example 3: To Create a RAID-5 Array

      260
    • Example 4: To Create a RAID-10 Array

      260
    • Example 5: To Create a Hot Spare Pool

      261
    • Example 6: To List All Defined SSA Objects

      261
    • Example 7: To Change an Attribute of an Object

      262
    • Example 8: To Exchange a Member Disk Drive of an Existing Array

      262
    • Example 9: To Make a New System Disk

      263
    • Example 10: To Delete an Array

      263
  • SSARAID Command Attributes

    264
    • RAID Arrays Creation and Change Attributes

      264
      • Creation and Change Attributes for All RAID Arrays

        264
      • Creation and Change Attributes for RAID-1, RAID-5, and RAID-10 Arrays Only

        265
      • Creation and Change Attributes for RAID-1 and RAID-10 Arrays Only

        267
      • Creation and Change Attribute for RAID-5 Arrays Only

        268
      • Creation and Change Attribute for RAID-10 Arrays Only

        268
    • RAID Arrays Change Attributes

      268
      • Change Attributes for All RAID Arrays

        268
    • Hot Spare Pool Creation and Change Attribute

      269
    • Physical Disk Drive Change Attributes

      269
      • Change Attribute for Hot Spare Disk Drives Only

        269
      • Change Attribute for Array Member Disk Drives Only

        269
      • Other Change Attributes for Physical Disk Drives

        270
    • Action Attributes (RAID-1, RAID-5, and RAID-10 Only)

      271
    • Couple Action Attributes (RAID-1 and RAID-10 Only)

      272
    • Uncouple Action Attributes (RAID-1 and RAID-10 Only)

      272
  • Return Codes

    273
• Chapter 13. Using the Programming Interface

  275
  • SSA Subsystem Overview

    275
    • Device Drivers

      275
      • Responsibilities of the SSA Adapter Device Driver

        275
      • Responsibilities of the SSA Disk Device Driver

        275
    • Interface between the SSA Adapter Device Driver and Head Device Driver

      276
    • Trace Formatting

      276
  • SSA Adapter Device Driver

    277
    • Purpose

      277
    • Syntax

      277
    • Description

      277
      • Configuring Devices

        277
    • PCI SSA Adapter ODM Attributes

      277
    • Device-Dependent Subroutines

      278
      • open and close Subroutines

        278
    • Summary of SSA Error Conditions

      279
    • Managing Dumps

      279
    • Files

      280
  • IOCINFO (Device Information) SSA Adapter Device Driver ioctl Operation

    281
    • Purpose

      281
    • Description

      281
    • Files

      281
  • SSA_TRANSACTION SSA Adapter Device Driver ioctl Operation

    282
    • Purpose

      282
    • Description

      282
    • Return Values

      283
    • Files

      283
  • SSA_GET_ENTRY_POINT SSA Adapter Device Driver ioctl Operation

    284
    • Purpose

      284
    • Description

      284
    • Return Values

      284
    • Files

      284
  • SSA Adapter Device Driver Direct Call Entry Point

    285
    • Purpose

      285
    • Description

      285
    • Return Values

      285
  • ssadisk SSA Disk Device Driver

    286
    • Purpose

      286
    • Syntax

      286
    • Configuration Issues

      286
      • SSA Logical Disks, SSA Physical Disks, and SSA RAID Arrays

        286
      • Multiple Adapters

        287
      • Configuring SSA Disk Drive Devices

        288
    • Device Attributes

      290
      • Attributes of the SSA Router, ssar

        290
      • Attributes Common to SSA Logical and SSA Physical Disks

        291
      • Attributes for SSA Logical Disks Only

        291
    • Device-Dependent Subroutines

      292
      • open, read, write and close Subroutines

        292
      • readx and writex Subroutines

        294
    • Error Conditions

      294
    • Special Files

      296
  • IOCINFO (Device Information) SSA Disk Device Driver ioctl Operation

    297
    • Purpose

      297
    • Description

      297
    • Files

      297
  • SSADISK_ISAL_CMD (ISAL Command) SSA Disk Device Driver ioctl Operation

    298
    • Purpose

      298
    • Description

      298
    • Return Values

      299
    • Files

      300
  • SSADISK_ISALMgr_CMD (ISAL Manager Command) SSA Disk Device Driver ioctl Operation

    301
    • Purpose

      301
    • Description

      301
    • Return Values

      302
    • Files

      302
  • SSADISK_SCSI_CMD (SCSI Command) SSA Disk Device Driver ioctl Operation

    303
    • Purpose

      303
    • Description

      303
    • Return Values

      304
    • Files

      304
  • SSADISK_LIST_PDISKS SSA Disk Device Driver ioctl Operation

    305
    • Purpose

      305
    • Description

      305
    • Return Values

      306
    • Files

      306
  • SSA Disk Concurrent Mode of Operation Interface

    307
    • Device Driver Entry Point

      307
    • Top Kernel Extension Entry Point

      308
  • SSA Disk Fencing

    310
  • SSA Target Mode

    311
    • Configuring the SSA Target Mode

      312
    • Buffer Management

      313
    • Understanding Target-Mode Data Pacing

      313
    • Using SSA Target Mode

      314
    • Execution of Target Mode Requests

      314
  • SSA tmssa Device Driver

    315
    • Purpose

      315
    • Syntax

      315
    • Description

      315
    • Configuration Information

      316
    • Device-Dependent Subroutines

      316
      • open Subroutine

        316
      • close Subroutine

        317
      • read Subroutine

        317
      • write subroutine

        319
      • ioctl Subroutine

        321
      • select Entry Point

        321
    • Errors

      322
  • tmssa Special File

    324
    • Purpose

      324
    • Description

      324
    • Implementation Specifics

      324
    • Related Information

      324
  • IOCINFO (Device Information) tmssa Device Driver ioctl Operation

    325
    • Purpose

      325
    • Description

      325
  • TMIOSTAT (Status) tmssa Device Driver ioctl Operation

    327
    • Purpose

      327
    • Description

      327
  • TMCHGIMPARM (Change Parameters) tmssa Device Driver ioctl Operation

    328
    • Purpose

      328
    • Description

      328
• Part 2. Maintenance Information

  331
• Chapter 14. SSA Adapter Information

  333
  • Installing the SSA Adapter

    333
  • Cron Table Entries

    333
  • Microcode Maintenance

    334
    • Checking the ID and Level of the Microcode Package

      334
    • Maintaining the Adapter Microcode

      335
    • Maintaining the Disk Drive Microcode

      335
  • Vital Product Data (VPD) for the SSA Adapter

    336
  • Adapter Power-On Self-Tests (POSTs)

    337
• Chapter 15. Removal and Replacement Procedures

  339
  • Exchanging Disk Drives

    339
  • Changing Pdisk and Hdisk Numbers

    346
  • Removing and Replacing an Advanced SerialRAID Adapter

    347
  • Removing an SDRAM Module of an Advanced SerialRAID Adapter

    349
  • Installing an SDRAM Module of an Advanced SerialRAID Adapter

    350
  • Removing the Fast-Write Cache Option Card of an Advanced SerialRAID Adapter

    352
  • Installing the Fast-Write Cache Option Card of an Advanced SerialRAID Adapter

    354
  • Removing the Battery Assembly from the Fast-Write Cache Option Card of an Advanced SerialRAID Adapter

    356
  • Installing a Battery Assembly into the Fast-Write Cache Option Card of an Advanced SerialRAID Adapter

    358
  • Part Numbers

    360
• Chapter 16. Using the SSA Command Line Utilities

  361
  • ssa_sesdld Command

    361
    • Purpose

      361
    • Syntax

      361
    • Description

      361
    • Flags

      361
    • Examples

      362
  • ssaadap Command

    363
    • Purpose

      363
    • Syntax

      363
    • Description

      363
    • Flags

      363
  • ssacand Command

    364
    • Purpose

      364
    • Syntax

      364
    • Description

      364
    • Flags

      364
  • ssa_certify Command

    365
    • Purpose

      365
    • Syntax

      365
    • Description

      365
    • Flags

      365
  • ssaconn Command

    367
    • Purpose

      367
    • Syntax

      367
    • Description

      367
    • Flags

      367
  • ssa_diag Command

    368
    • Purpose

      368
    • Syntax

      368
    • Description

      368
    • Flags

      368
    • Output

      368
  • ssadisk Command

    369
    • Purpose

      369
    • Syntax

      369
    • Description

      369
    • Flags

      369
  • ssadload Command

    370
    • Purpose

      370
    • Syntax

      370
    • Description

      370
    • Flags

      371
    • Examples

      371
  • ssa_ela Command

    373
    • Purpose

      373
    • Syntax

      373
    • Description

      373
    • Flags

      373
    • Output

      374
  • ssaencl Command

    375
    • Purpose

      375
    • Syntax

      375
    • Description

      375
    • Flags

      375
    • Examples

      377
  • ssa_format Command

    378
    • Purpose

      378
    • Syntax

      378
    • Description

      378
    • Flags

      378
    • Output

      379
  • ssa_fw_status Command

    380
    • Purpose

      380
    • Syntax

      380
    • Description

      380
    • Flags

      380
    • Output

      380
    • Examples

      380
  • ssa_getdump Command

    381
    • Purpose

      381
    • Syntax

      381
    • Description

      381
      • List Mode

        381
      • Copy Mode

        381
    • Flags

      382
      • Required Flags for Both Modes

        382
      • Required Flags for Copy Mode

        382
      • Optional Flags for List Mode

        382
      • Optional Flags for Copy Mode

        383
    • Output

      383
  • ssaidentify Command

    384
    • Purpose

      384
    • Syntax

      384
    • Description

      384
    • Flags

      384
  • ssa_progress Command

    385
    • Purpose

      385
    • Syntax

      385
    • Description

      385
    • Flags

      385
    • Output

      385
    • Examples

      385
  • ssa_rescheck Command

    386
    • Purpose

      386
    • Syntax

      386
    • Description

      386
    • Flags

      386
    • Output

      386
    • Examples

      387
    • Return Codes

      387
  • ssa_servicemode Command

    388
    • Purpose

      388
    • Syntax

      388
    • Description

      388
    • Flags

      388
    • Output

      388
  • ssa_speed Command

    389
    • Purpose

      389
    • Syntax

      389
    • Description

      389
    • Flags

      389
    • Output

      390
    • Examples

      390
  • ssavfynn Command

    391
    • Purpose

      391
    • Syntax

      391
    • Description

      391
    • Flags

      391
    • Output

      391
  • ssaxlate Command

    392
    • Purpose

      392
    • Syntax

      392
    • Description

      392
    • Flags

      392
• Chapter 17. SSA Service Aids

  393
  • The Identify Function

    395
  • Starting the SSA Service Aids

    396
  • Set Service Mode Service Aid

    398
  • Link Verification Service Aid

    403
  • Configuration Verification Service Aid

    407
  • Format Disk Service Aid

    409
  • Certify Disk Service Aid

    411
  • Display/Download Disk Drive Microcode Service Aid

    413
  • Link Speed Service Aid

    416
  • Service Aid Service Request Numbers (SRNs)

    420
  • Using the Service Aids for SSA-Link Problem Determination

    420
    • Example 1. Normal Loops

      421
    • Example 2. Broken Loop (Cable Removed)

      423
    • Example 3. Broken Loop (Disk Drive Removed)

      426
  • Finding the Physical Location of a Device

    429
    • Finding the Device When Service Aids Are Available

      429
    • Finding the Device When No Service Aids Are Available

      429
• Chapter 18. SSA Problem Determination Procedures

  431
  • Service Request Numbers (SRNs)

    431
    • The SRN Table

      431
    • Using the SRN Table

      431
  • Software and Microcode Errors

    461
  • SSA Loop Configurations that Are Not Valid

    461
  • SSA Maintenance Analysis Procedures (MAPs)

    463
    • How to Use the MAPs

      463
  • MAP 2010: START

    464
  • MAP 2320: SSA Link

    465
  • MAP 2323: SSA Intermittent Link Error

    470
  • MAP 2324: SSA RAID

    474
  • MAP 2410: SSA Repair Verification

    495
  • SSA Link Errors

    498
    • SSA Link Error Problem Determination

      498
    • Link Status (Ready) Lights

      501
    • Service Aid

      502
    • Repair Actions

      502
• Part 3. Appendixes

  503
• Appendix. Communications Statements

  505
  • Federal Communications Commission (FCC) Statement

    505
  • Japanese Voluntary Control Council for Interference (VCCI) Statement

    505
  • Korean Government Ministry of Communication (MOC) Statement

    505
  • New Zealand Compliance Statement

    505
  • International Electrotechnical Commission (IEC) Statement

    506
  • Avis de conformité à la réglementation d’Industrie Canada

    506
  • Industry Canada Compliance Statement

    506
  • United Kingdom Telecommunications Requirements

    506
  • European Union (EU) Statement

    506
  • Radio Protection for Germany

    506
  • Taiwan Class A Compliance Statement

    507
• Glossary

  509
• Index

  513