Compex Advanced SerialRAID Adapters SA33-3285-02 manual

A d v an ce d S e ria lRAID A d ap te rs Us e r ’ s G u ide a nd M a in t e n an c e Inf o rm ati o n SA33-3285-02[...]

[...]

A d v an ce d S e ria lRAID A d ap te rs Us e r ’ s G u ide a nd M ain t e n an c e Inf o rm ati o n SA33-3285-02[...]

Third Edition (September 2000) This softcopy of 14 January 2002 is a minor revision to SA33-3285-02. It contains new technical changes that are not shown in the printed book. Such changes are shown by a colon (:) to the left of each change. Changes that are also in the printed book are shown by a vertical line to the left of each change. The follow[...]

Contents Safety Notices ........................ x v Definitions of Safety Notices ................... x v Safety Notice for Installing, Relocating, or Servicing ............ x v About This Book ...................... xvii Who Should Use This Book ................... xvii What This Book Contains .................... xvii If Y ou Need More Informati[...]

Reserving Disk Drives ..................... 2 7 Fast-Write Cache ....................... 2 7 Chapter 3. RAID Functions and Array States ............. 2 9 RAID Functions ....................... 2 9 Availability ........................ 2 9 Disk Drives That Are Not in Arrays ................ 3 0 RAID-0 Array States ...................... 3 1 Good Sta[...]

Dealing with RAID Array Problems ................. 8 9 Getting Access to the SSA RAID Array SMIT Menu ........... 9 0 Identifying and Correcting or Removing Failed Disk Drives ........ 9 1 Installing a Replacement Disk Drive ................ 9 5 Using Other Configuration Functions ................ 9 7 Getting Access to the SSA RAID Array SMIT Menu [...]

Remove a Disk From an SSA RAID Array ............. 1 9 0 Swap Members of an SSA RAID Array .............. 1 9 1 Chapter 8. Split-Site Management ................ 1 9 3 Configuration of RAID-1 and RAID-10 Arrays ............. 1 9 3 Operation after a Loss of Member Disks ............... 1 9 4 One Half of the Array Is Not Present ............... 1 9 5[...]

Example 7: T o Change an Attribute of an Object ........... 2 4 2 Example 8: T o Exchange a Member Disk Drive of an Existing Array ..... 2 4 2 Example 9: T o Make a New System Disk .............. 2 4 3 Example 10: T o Delete an Array ................. 2 4 3 SSARAID Command Attributes .................. 2 4 4 RAID Arrays Creation and Change Attribut[...]

Device Attributes ...................... 2 7 0 Device-Dependent Subroutines ................. 2 7 2 Error Conditions ...................... 2 7 4 Special Files ....................... 2 7 6 IOCINFO (Device Information) SSA Disk Device Driver ioctl Operation ..... 2 7 7 Purpose ........................ 2 7 7 Description ........................ 2 7 [...]

Related Information ..................... 3 0 4 IOCINFO (Device Information) tmssa Device Driver ioctl Operation ...... 3 0 5 Purpose ........................ 3 0 5 Description ........................ 3 0 5 TMIOST A T (Status) tmssa Device Driver ioctl Operation .......... 3 0 7 Purpose ........................ 3 0 7 Description ..................[...]

ssacand Command ...................... 3 4 4 Purpose ........................ 3 4 4 Syntax ......................... 3 4 4 Description ........................ 3 4 4 Flags ......................... 3 4 4 ssa_certify Command ..................... 3 4 5 Purpose ........................ 3 4 5 Syntax ......................... 3 4 5 Description ........[...]

ssa_fw_status Command .................... 3 6 0 Purpose ........................ 3 6 0 Syntax ......................... 3 6 0 Description ........................ 3 6 0 Flags ......................... 3 6 0 Output ......................... 3 6 0 Examples ........................ 3 6 0 ssa_getdump Command .................... 3 6 1 Purpose ........[...]

Flags ......................... 3 7 1 Output ......................... 3 7 1 ssaxlate Command ...................... 3 7 2 Purpose ........................ 3 7 2 Syntax ......................... 3 7 2 Description ........................ 3 7 2 Flags ......................... 3 7 2 Chapter 17. SSA Service Aids .................. 3 7 3 The Identify F[...]

Federal Communications Commission (FCC) Statement .......... 4 8 5 Japanese V oluntary Control Council for Interference (VCCI) Statement ..... 4 8 5 Korean Government Ministry of Communication (MOC) Statement ...... 4 8 5 New Zealand Compliance Statement ................ 4 8 5 International Electrotechnical Commission (IEC) Statement ......... 4 8 [...]

xiv User ’ s Guide and Maintenance Information[...]

Safety Notices For a translation of the danger and caution notices contained in this book, see the Safety Information manual, SA23-2652. Definitions of Safety Notices A danger notice indicates the presence of a hazard that has the potential of causing death or serious personal injury . This book contains no danger notices. A caution notice indicate[...]

xvi User ’ s Guide and Maintenance Information[...]

About This Book Who Should Use This Book This book is for people who operate or service a RISC system that contains one or more Advanced SerialRAID Adapters. T o follow the instructions in this book, you should be familiar with the basic operational procedures for a RISC system. What This Book Contains Part 1 of this book is mainly for the user . I[...]

Web Support Pages When you are installing an SSA device or subsystem, upgrading your SSA subsystem, or doing preventive maintenance on your SSA subsystem, refer to the web page shown here. This web page provides access to the latest SSA publications, micorocde, and support information for the using system, SSA adapters, and SSA subsystem. http://ww[...]

Part 1. User Information 1[...]

2 User ’ s Guide and Maintenance Information[...]

Chapter 1. Introducing SSA and the Advanced SerialRAID Adapters This chapter describes: v Serial storage architecture (SSA). v The Advanced SerialRAID Adapter and the Advanced SerialRAID Plus Adapter . Physically , the two types of adapter are the same. The Advanced SerialRAID Plus Adapter , however , provides additional functions. In this book, th[...]

The Advanced SerialRAID Adapters (type 4 – P) The Advanced SerialRAID Adapters (see Figure 1) are 40-MB-per-second Serial Storage Architecture (SSA), Peripheral Component Interconnect (PCI) adapters that serve as the interface between systems that use PCI architecture and devices that use SSA. These adapters provide support for two SSA loops. Eac[...]

Note: In the SSA service aids, this adapter is called “ IBM SSA 160 SerialRAID Adapter (14109100) ” . The adapter card has four SSA connectors that are arranged in two pairs. Connectors A1 and A2 are one pair; connectors B1 and B2 are the other pair . The SSA links must be configured as loops. Each loop is connected to a pair of connectors at t[...]

Lights of the Advanced SerialRAID Adapters Each pair of connectors has a green light that indicates the operational status of its related loop: Status of Light Meaning Off Both SSA connectors are inactive. If disk drives or other SSA adapters are connected to these connectors, either those disk drives or adapters are failing, or their SSA links are[...]

Chapter 2. Introducing SSA Loops This chapter describes the principles of SSA loops, how SSA devices are known to the system programs, and the rules that you must observe when you configure your SSA loops. Loops, Links, and Data Paths In the simplest SSA configuration, SSA devices are connected through two or more SSA links to an SSA adapter that i[...]

Simple Loop Figure 2 shows a simple SSA loop. The devices that are attached to the SSA adapter card 1 are connected through SSA links 2 . These SSA links are configured as a loop. Data and commands to a particular device pass through all other devices on the link between the adapter and the target device. Data can travel in either direc[...]

Simple Loop — One Disk Drive Missing If a disk drive fails, or is switched off, the loop is broken, and one of the data paths to a particular disk drive is no longer available. The disk drives on the remainder of the loop continue to work, but an error is reported to the system. The adapter now uses the alternative path to some of the devices. In[...]

Simple Loop — T wo Disk Drives Missing If two or more disk drives are switched off, fail, or are removed from the loop, some disk drives might become isolated from the SSA adapter . In Figure 4, disk drives 3 and 7 have been removed. Disk drives 1 and 2 can communicate with the using system only through connector A1 of the SSA adapter . Disk driv[...]

One Loop with T wo Adapters in One Using System In Figure 5, the loop contains two SSA adapters 1 and 2 that are both in the same using system. In this configuration, all the disk drives can still communicate with the using system if one SSA adapter fails. Using System A1 A2 B1 B2 A1 A2 B1 B2 Disk 1 Disk 2 Disk 3 Disk 4 Disk 5 Disk 6 Di[...]

One Loop with T wo Adapters in Each of T wo Using Systems If the loop contains four SSA adapters, with two adapters in each of two using systems, disk drives become isolated if they are connected between the two adapters of one using system, and both those adapters fail, or are held reset, but remain powered on. Bypass Note: Y our SSA Disk Subsyste[...]

If, however , disk drives are connected into the link between two SSA adapters that are in the same using system, those disk drives become isolated if both SSA adapters fail, or are held reset, but remain powered on (see also “ Bypass Note ” on page 12). In Figure 7, disk drives 13 through 16 have been connected between the SSA adapters in usin[...]

T wo Loops with One Adapter If only one SSA adapter is contained in the SSA loops, the adapter can provide support for up to 96 disk drives (a maximum of 48 per loop). Figure 8 shows an example configuration that has two loops and one adapter: Adapter SSA Disk Drives Figure 8. T wo Loops with One Adapter 14 User ’ s Guide and Maintenance Informat[...]

T wo Loops with T wo Adapters The two adapters can provide support for up to 96 SSA disk drives (a maximum of 48 per loop). Figure 9 shows an example configuration that has two loops and two adapters: Adapter Adapter SSA Disk Drives Figure 9. T wo Loops with T wo Adapters Chapter 2. Introducing SSA Loops 15[...]

Large Configurations Up to eight SSA adapters can be connected in a particular SSA loop, and up to 48 disk drives can be included in that loop. Figure 10 shows an example of a large configuration that has eight adapters in eight using systems. Figure 1 1 shows an example of a large configuration that has eight adapters in four using systems. Adapte[...]

Switching Off Using Systems Be careful if you want to switch off one or more using systems in a large configuration. If any disk subsystem in the configuration does not use bypass cards, some using systems might lose access to disk drives if you: v Switch off more than one using system at a time v Switch off a using system when a disk drive has fai[...]

Configuring Devices on an SSA Loop If an SSA loop contains three or more SSA adapters that are installed in two or more using systems, you must ensure that all those using systems are switched on, and that all the disk drives in all those using systems are configured, as follows: v If all the using systems are switched off (Micro Channel or PCI): 1[...]

Identifying and Addressing SSA Devices This section describes how SSA adapters and devices are known to the using system programs. Location Code Format Location codes identify the locations of adapters and devices in the using system and its attached subsystems and devices. These codes are displayed when the diagnostic programs isolate a problem. F[...]

The configuration software first recognizes the disk drive by its machine-readable serial number . The serial number of the disk drive is also displayed by the service aids. The service aids show the number as the last eight digits of the IEEE SSA Unique ID. Service actions are always related to physical disk drives. For this reason, errors that oc[...]

SSA Unique IDs Each SSA device has a specific identifier that is not used by any other SSA device in the whole world. This identifier is called the IEEE SSA Unique ID (UID) of the device. It is written into the device during manufacture. The full UID consists of 16 characters. The label on the side of a disk drive shows the full UID. The label on t[...]

Rules for SSA Loops For SSA loops that include an Advanced SerialRAID Adapter (type 4 – P), the following rules apply: v Each SSA loop must be connected to a valid pair of connectors on the SSA adapter (that is, either connectors A1 and A2, or connectors B1 and B2). v A maximum of one pair of adapter connectors can be connected in a particular SS[...]

Checking the Level of the Adapter Microcode If you need to check the level of the adapter microcode: 1. T ype, on the command line: lscfg -vl ssan where ssan is the name of the adapter whose microcode you are checking; for example, ssa0. A list of vital product data (VPD) is displayed. 2. Find ROS Level and ID , for example, 5000. Chapter 2. Introd[...]

Rules for the Physical Relationship between Disk Drives and Adapters The physical relationship between the disk drives and the adapters in an SSA loop can affect the performance of the subsystem. The following rules help you to get best performance from your subsystem. One Pair of Adapter Connectors in the Loop The following sequence enables you to[...]

Pairs of Adapter Connectors in the Loop – Some Shared Data The following sequence enables you to determine the best relationship between the disk drives and the adapter on an SSA loop that contains two or more pairs of adapter connectors. Some of the disk drives share data access with other disk drives. 1. For each pair of connectors, identify al[...]

Pairs Of Adapter Connectors in the Loop – Mainly Shared Data The following sequence enables you to determine the best relationship between the disk drives and the adapter , or adapters, on an SSA loop that contains two or more pairs of adapter connectors. Most of the disk drives share data access with each other . 1. Determine which data is share[...]

Reserving Disk Drives The Advanced SerialRAID Adapter , the Micro Channel SSA Multi-Initiator/RAID EL Adapter , and the PCI SSA Multi-Initiator/RAID EL Adapter implement reservation by using commands that are sent directly from adapter to adapter . They do not use the SCSI reservation command. The advantages of this method are: v System software ca[...]

28 User ’ s Guide and Maintenance Information[...]

Chapter 3. RAID Functions and Array States This chapter describes the RAID functions and the states of RAID arrays. RAID Functions Redundant Array of Independent Disks (RAID) technology provides: v Larger disk size v Immediate availability and recovery of data v Redundancy of data at a level that you can choose. RAID technology stores data across g[...]

transfer operations, performance is better than that provided by RAID-1 because data is striped across member disk drives. For short data transfer operations, performance is better because operations are distributed across the member disk drives, and the effect of skew is reduced. Member disk drives of a RAID-10 array can be configured to be in sep[...]

RAID-0 Array States A RAID-0 array can be in either of two states. A knowledge of those states is useful when you are configuring your arrays. The states are described here. Good State A RAID-0 array is in the Good state when all the member disk drives of that array are present. Offline State A RAID-0 array enters Offline state when one or more mem[...]

RAID-1 Array States RAID-1 array states are the same as RAID-10 array states. For details, see “ RAID-10 Array States ” on page 36. In RAID-1 arrays, the first member disk drive of the array is defined as the primary disk drive and the second member disk drive is defined as the secondary disk drive. These definitions prevent operation on separa[...]

RAID-5 Array States A RAID-5 array can be in one of several states. A knowledge of those states is useful when you are configuring your arrays. The states are described here. A flowchart for the RAID-5 array states is shown in Figure 15 on page 35. Good State A RAID-5 array is in the Good state when all the member disk drives of that array are pres[...]

While in Degraded state, an array is not protected. If another disk drive in the array fails, or the power fails during a write operation, data might be lost. Y ou can return the disk drive to the array , or install another disk drive by using the procedure in step 37 on page 473 of MAP 2324: SSA RAID to logically add the device to the array . The [...]

RAID-5 Array State Flowchart Second disk fails or is removed Write operatio n Array Offlin e New disk Original disk replaced Y Y Array enabled for Hot Spare Hot Spare swapped in Hot Spare available Array Rebuilding Allow Write while Exposed Write Op rejected Array Degraded (no protectio n) N N N Y Y Y N N Disk fails Disk rejected Array Degraded Arr[...]

RAID-10 Array States Configuration information of the array is held in a reserved area sector on each of the first three member disk drives of the array . If fewer than two of these sectors can be read or written, the array normally goes into the Offline state. An important characteristic of RAID-10 is that the mirrored pairs can be located in diff[...]

operations put the array into the Degraded state. When the missing member disk drives are reintroduced, the array returns to the Good state. Degraded State A RAID-10 array is in the Degraded state when one or more member disk drives are missing or deconfigured, and a write operation has occurred. Read and write operations can be performed on the ar[...]

v Both member disk drives of a mirrored pair are missing, deconfigured, or rebuilding. Unknown State A RAID-10 array is in the Unknown state when not enough array members are present for the array configuration to be determined; that is, fewer than two of the first three members are present. Unless the Split Array Resolution flag is set, the array [...]

Chapter 4. Using the SSA SMIT Menus This chapter describes how to use the system management interface tool (SMIT) to display and change characteristics of the SSA devices, and to access various service functions. Three SSA menus are available through the SMIT Devices menu. v SSA Adapter v SSA Disks v SSA RAID Arrays Notes: 1. Although this book alw[...]

Getting Access to the SSA Adapters SMIT Menu 1. For fast-path access to the SSA RAID Array SMIT menus, type smitty ssaa and press Enter . Otherwise: a. T ype smitty and press Enter . The System Management menu is displayed. b. Select Devices . The Devices menu is displayed. c. Select SSA Adapters . 2. The SSA Adapters menu is displayed: SSA Adapter[...]

Getting Access to the SSA Disks SMIT Menu 1. For fast-path access to the SSA RAID Array SMIT menus, type smitty ssad and press Enter . Otherwise: a. T ype smitty and press Enter . The System Management menu is displayed. b. Select Devices . The Devices menu is displayed. c. Select SSA Disks . 2. The SSA Disks menu is displayed: SSA Disks Move curso[...]

4. The SSA Logical Disks menu is displayed: SSA Logical Disks Move cursor to desired item and press Enter. List All Defined SSA Logical Disks List All Supported SSA Logical Disks Add an SSA Logical Disk Change/Show Characteristics of an SSA Logical Disk Remove an SSA Logical Disk Configure a Defined SSA Logical Disk Generate Error Report Trace an S[...]

Getting Access to the SSA RAID Arrays SMIT Menu 1. For fast-path access to the SSA RAID Array SMIT menus, type smitty ssaraid and press Enter . Otherwise: a. T ype smitty and press Enter . The System Management menu is displayed. b. Select Devices . The Devices menu is displayed. c. Select SSA RAID Arrays . 2. The SSA RAID Arrays menu is displayed:[...]

44 User ’ s Guide and Maintenance Information[...]

Chapter 5. Hot Spare Management With all levels of adapter code, disk drives can be configured to be hot spare disk drives. These hot spare disk drives can be used in any array that is on the same SSA loop. If the adapter microcode level is at, or higher than, level 50, each hot spare disk drive can be configured to a particular hot spare pool. The[...]

Figure 16 shows an array that has its primary disk drives (pdisk2, pdisk3, pdisk10 and pdisk1 1) in building 1, and its secondary disk drives (pdisk5, pdisk6, pdisk7 and pdisk8) in building 2. Pdisk1 and pdisk4 have been assigned as hot spare disk drives, but no hot spare pool has been defined. Primar y Disks Building 1 Building 2 pdisk1 (Spare) pd[...]

If pdisk2 fails, the hot spare disk drive pdisk4 might replace pdisk 2 as one of the primary disk drives in the array , as shown in Figure 17. Now , assume that for some reason, the disk drives in building 2 are no longer available. The example array is now in the Offline state because one of its four primary disk drives is in building 2. Only the [...]

This problem can be solved if, in each building, a hot spare pool is created for the disk drives. In Figure 18, all the disk drives in building 1 have been made members of pool A1, and all the disk drives in building 2 have been made members of Pool A2. A failure of a member disk drive in Pool A1 now causes pdisk1 to be selected as the hot spare di[...]

Figure 19 shows how RAID-5 arrays can be protected against the complete failure of an SSA enclosure. Each pdisk of each array (hdisk) is in a different SSA enclosure. The hot spare disk drives are also in a different enclosure. Pools A1 and A2 each contain an hdisk and a hot spare disk drive. The pools ensure that, if any one SSA enclosure fails co[...]

Figure 20 shows an alternative method of protecting RAID-5 arrays against the complete failure of an SSA Enclosure. This method uses a dif ferent hot spare disk drive to protect each member of the array . P ool A2 P ool A3 hdisk hdisk P ool A1 Enclosure-1 Enclosure-2 Enclosure-3 pdisk pdisk pdisk pdisk pdisk pdisk Spare Spare Spare Figure 20. Pools[...]

Figure 21 shows how a RAID-10 array can be protected against the complete failure of an SSA enclosure. The primary disk drives of the array are in enclosure 1; the secondary disk drives are in enclosure 2. The secondary disk drives contain the same data as do the primary disk drives. Pool A1 contains all the primary disk drives of the arrays and a [...]

that is needed to protect the array in the selected pool. No error log entry is made until the number of hot spare disk drives that remains in the pool is less than the Hot Spare Minimum parameter . Rules for Hot Spare Disk Drive Pools v By default, all hot spare disk drives are in pool zero. v Pool zero is called A0 for hot spare disk drives that [...]

Solving Hot Spare Pool Problems Hot spare pool problems are indicated by the state of the pool and by error codes in the system error log. When configuring or reconfiguring hot spare pools, it is recommended that you use the state of the hot spare pool to help guide your actions. If hot spare pool problems occur during normal operations, use the Se[...]

v Have a size equal to, or greater than, the largest disk drive that they will be protecting v Are in pool 0 on the SSA loop on which the hot spare pool exists 2. If you are not sure whether your disk drives are assigned correctly: a. Ensure that the required number of disk drives of the correct size are assigned as hot spare disk drives, or as arr[...]

Inconsistent The member disk drives in the pool do not agree about the size of the hot spare disk drives, or about the minimum number of hot spare disk drives that is required. This state is probably caused by changes to the SSA loop; for example, the addition of disk drives or changes to the SSA cabling. If you did not intend to make such changes,[...]

56 User ’ s Guide and Maintenance Information[...]

Chapter 6. Using the RAID Array Configurator This chapter describes how to use the system management interface tool (SMIT) to manage your SSA RAID arrays. The SMIT provides a set of menus from which you can select the various functions of the ssaraid command. The ssaraid command allows you to create, delete, and manage your RAID arrays. If you pref[...]

Installing and Configuring SSA RAID Arrays Y ou can get to the required SMIT menu by using fast path commands, or by working through other menus. In this chapter , the fast path command for a particular option is given at the start of the description of that option. Notes: 1. Although this book always refers to the smitty commands, you can use eith[...]

Getting Access to the SSA RAID Arrays SMIT Menu 1. For fast-path access to the SSA RAID Array SMIT menus, type smitty ssaraid and press Enter . Otherwise: a. T ype smitty and press Enter . The System Management menu is displayed. b. Select Devices . The Devices menu is displayed. c. Select SSA RAID Arrays . 2. The SSA RAID Arrays menu is displayed:[...]

Adding an SSA RAID Array This option lets you add an array to the configuration. 1. For fast path, type smitty mkssaraid and press Enter . Otherwise, select Add an SSA RAID Array from the SSA RAID Arrays menu. A list of adapters is displayed in a window: SSA RAID Arrays Move cursor to desired item and press Enter. List All Defined SSA RAID Arrays L[...]

2. Select the adapter to which you want to add the array . A list of array types is displayed in a window: SSA RAID Arrays Move cursor to desired item and press Enter. List All Defined SSA RAID Arrays List All Supported SSA RAID Arrays List All SSA RAID Arrays Connected to a RAID Manager List Status Of All Defined SSA RAID Arrays List/Identify SSA [...]

3. Select the type of array that you want to create. If you select RAID-0, the following menu is displayed: Add an SSA RAID Array Type or select values in entry fields. Press Enter AFTER making all desired changes. [Entry Fields] SSA RAID Manager ssa0 RAID Array Type raid_0 * Member Disks + Allow Page Splits yes + Enable Fast-Write no + F1=Help F2=[...]

If you select RAID-1, the following menu is displayed: Add an SSA RAID Array Type or select values in entry fields. Press Enter AFTER making all desired changes. [Entry Fields] SSA RAID Manager ssa0 RAID Array Type raid_1 * Primary Disk + * Secondary Disk + Split Array Resolution Primary + Enable Use of Hot Spares yes + Choose Hot Spare only from P[...]

If you select RAID-5, the following menu is displayed: Add an SSA RAID Array Type or select values in entry fields. Press Enter AFTER making all desired changes. [Entry Fields] SSA RAID Manager ssa0 RAID Array Type raid_5 * Member Disks + Strip Size (KB) 64 + Enable Use of Hot Spares yes + Choose Hot Spare only from Preferred Pool no + Allow Page S[...]

If you select RAID-10, the following menu is displayed: Add an SSA RAID Array Type or select values in entry fields. Press Enter AFTER making all desired changes. [Entry Fields] SSA RAID Manager ssa0 RAID Array Type raid_10 * Primary Disks + * Secondary Disks + Strip Size (KB) 16 + Split Array Resolution Primary + Enable Use of Hot Spares yes + Cho[...]

Meanings of the Fields SSA RAID Manager The name of an SSA RAID Manager . SSA RAID Managers are devices that control SSA RAID arrays. RAID Array T ype The type of the SSA RAID array . Member Disks For a RAID-0 or a RAID-5 array , member disks are the disk drives that are to be added to the SSA RAID array . The array must consist of disk drives that[...]

If you select Exact , the replacement disk drive is chosen only from hot spare disk drives whose size exactly matches the size of the failing disk drive. Choose Hot Spare only from Preferred Pool If you select yes for this option, a hot spare disk drive is selected only from the hot spare pool that contains the failed member disk drive. If you sele[...]

If you select yes for this option, the array enters the Rebuilding state. The data that is on the primary disk drives is copied to the secondary disk drives. This operation might take several hours to complete, during which time, performance is affected. Enable Fast-Write Switches the fast-write cache on or off. This facility is not available on ad[...]

6. Select the disk drives that you want in the array . Y ou must select a minimum of: v T wo disk drives if you are creating a RAID-0 array v One primary and one secondary disk drive if you are creating a RAID-1 array v Three disk drives if you are creating a RAID-5 array v T wo primary and two secondary disk drives if you are creating a RAID-10 ar[...]

Deleting an SSA RAID Array This option allows you to delete arrays that you have created through the Add an SSA RAID Array option. The deleted array is broken into its member disk drives. Y ou cannot delete arrays that do not have a corresponding hdisk. 1. For fast path, type smitty rmssaraid and press Enter . Otherwise, select Delete an SSA RAID A[...]

3. A prompt is displayed in a window: SSA RAID Arrays Move cursor to desired item and press Enter. List All Defined SSA RAID Arrays List All Supported SSA RAID Arrays List All SSA RAID Arrays Connected to a RAID Manager List Status Of All Defined SSA RAID Arrays List/Identify SSA Physical Disks List/Delete Old RAID Arrays Recorded in an SSA RAID Ma[...]

Creating a Hot Spare Disk Drive 1. For fast path, type smitty chgssadisk and press Enter . Otherwise, select Change/Show Use of an SSA Physical Disk from the SSA RAID Arrays menu. A list of disk drives and their usage is displayed in a window: SSA RAID Arrays Move cursor to desired item and press Enter. List All Defined SSA RAID Arrays ------------[...]

3. Select the disk drive that you want to designate as a hot spare. The following screen is displayed for the disk drive that you have chosen: Change/Show Attributes of an SSA Physical Disk Type or select values in entry fields. Press Enter AFTER making all desired changes. [Entry Fields] SSA RAID Manager ssa0 SSA physical disk pdisk6 CONNECTION ad[...]

Changing or Showing the Status of a Hot Spare Pool This option shows you the existing configuration of the arrays and the status of each hot spare pool. 1. For fast path, type smitty ls_hsm_status and press Enter . Otherwise, select List Status of Hot Spare Pools from the SSA RAID Arrays menu. 2. A list of adapters is displayed in a window: SSA RAI[...]

3. A list of hot spare pools and their status is displayed: COMMAND STATUS Command: OK stdout: yes stderr: no Before command completion, additional instructions may appear below. ssa1 Pool Components Spares Configured Minimum Status pool_A0 0 1 1 1 unused pool_A1 7 0 1 1 empty pool_B1 6 2 2 1 full F1=Help F2=Refresh F3=Cancel F6=Command F8=Image F9[...]

empty The pool contains no hot spare disk drives, or the hot spare disk drives that are in the pool are not suitable as member disk drives of the pool. reduced The number of hot spare disk drives that are in the pool is less than the number of hot spare disk drives that were originally configured, but greater than the configured minimum number . cr[...]

Showing the Disks That Are Protected by Hot Spares This option shows you which member disk drives of an array are protected by hot spare disk drives. 1. For fast path, type smitty ls_hsm_array_status and press Enter . Otherwise, select List Status of Hot Spare Protection for an SSA RAID Array from the SSA RAID Arrays menu. 2. A list of adapters is [...]

3. A list of protected member disk drives is displayed: COMMAND STATUS Command: OK stdout: yes stderr: no Before command completion, additional instructions may appear below. ssa1 Component Location Size Pool Protected Status hdisk4 raid_10 pdisk13 04-02-REGY-06-P 18.2GB pool_B2 yes good pdisk11 04-02-REGY-08-P 9.2GB pool_B1 yes good pdisk3 04-02-R[...]

Status The status of the array member disk drive. V alid values for status are: good The disk drive is working. not_present The disk drive cannot be detected. It has been removed or it has failed. too_large The member disk drive is too large to be protected by one of the hot spare disk drives that is in the pool. Note: The size of the member disk d[...]

Listing the Disks That Are in a Hot Spare Pool This option shows you all the disk drives that are in a hot spare pool and shows the status of each disk drive. 1. For fast path, type smitty ls_hsm_array_components and press Enter . Otherwise, select List Components in a Hot Spare Pool from the SSA RAID Arrays menu. 2. A list of adapters is displayed[...]

3. A list of hot spare pools is displayed: SSA RAID Arrays Move cursor to desired item and press Enter. List All Defined SSA RAID Arrays List All Supported SSA RAID Arrays List All SSA RAID Arrays Connected to a RAID Manager ------------------------------------------------------------------------- | SSA Hot Spare Pools | | | | Move cursor to desire[...]

Component The array member disk drive of the hdisk that is listed on the screen, or hot spare disk drives that are assigned to the pool. Location The physical location of the array member disk drive. Size The size of the array member disk drive. This value is useful to know , if you have assigned a hot spare disk drive to a pool, but the array memb[...]

Adding a New Hot Spare Pool This option allows you to add a new hot spare pool. If you are not sure how to configure hot spare pools, read Chapter 5, “ Hot Spare Management ” on page 45 before you proceed. 1. For fast path, type smitty add_hsm_pool_adap and press Enter . Otherwise, select Add a Hot Spare Pool from the SSA RAID Arrays menu. 2. A[...]

3. A list that shows Loop A or Loop B is displayed: SSA RAID Arrays Move cursor to desired item and press Enter. List All Defined SSA RAID Arrays List All Supported SSA RAID Arrays List All SSA RAID Arrays Connected to a RAID Manager List Status Of All Defined SSA RAID Arrays List/Identify SSA Physical Disks List/Delete Old RAID Arrays Recorded in [...]

The Hot Spares Minimum field contains a default value of 1. This value defines the minimum number of spares that can exist in the pool before an error condition is logged. Y ou should normally set this field to the number of hot spare disk drives that you intend to assign to this pool. Y ou can, however , set it to a lower number if you do not want[...]

Adding Disks to, or Removing Disks from, a Hot Spare Pool This option allows you to exchange the disk drives that are in the hot spare pool, or to resynchronize the state of the pool. If you are not sure how to configure hot spare pools, read Chapter 5, “ Hot Spare Management ” on page 45 before you proceed. 1. For fast path, type smitty chg_hs[...]

3. A list of hot spare pools is displayed: SSA RAID Arrays Move cursor to desired item and press Enter. List All Defined SSA RAID Arrays List All Supported SSA RAID Arrays List All SSA RAID Arrays Connected to a RAID Manager ------------------------------------------------------------------------- | SSA Hot Spare Pools | | | | Move cursor to desire[...]

4. The hot spare pool is displayed: SSA Hot Spare Pools Type or select values in entry fields. Press Enter AFTER making all desired changes. [Entry Fields] SSA RAID Manager ssa1 Spares Pool pool_B2 Status full Components in Pool 3 Hot Spares Previously Configured 1 Hot Spares in Pool 1 Components to Add [] + Components to Remove [] + Hot Spares Min[...]

Dealing with RAID Array Problems This part of the chapter describes how to solve problems that might occur on your SSA RAID arrays. Y ou can get to the required SMIT menu by using fast path commands or by working through other menus. During problem determination, you can use any of the maintenance procedures described in Using Other Configuration F[...]

Getting Access to the SSA RAID Array SMIT Menu 1. For fast-path access to the SSA RAID Array SMIT menus, type smitty ssaraid and press Enter . Otherwise: a. T ype smitty and press Enter . The System Management menu is displayed. b. Select Devices . The Devices menu is displayed. c. Select SSA RAID Arrays . 2. The SSA RAID Arrays menu is displayed: [...]

Identifying and Correcting or Removing Failed Disk Drives When a disk drive fails, the array rejects it. If access to the array is still possible, the Current Use attribute of the disk drive is changed from Member of an SSA RAID Array to Rejected . The disk drive is listed in the SMIT menus as a rejected disk drive. If the disk drive cannot be acce[...]

3. A list of rejected disk drives is displayed: COMMAND STATUS Command: OK stdout: yes stderr: no Before command completion, additional instructions may appear below. pdisk4 08005AEA030D00D member rejected 2.3G Physical disk F1=Help F2=Refresh F3=Cancel F6=Command F8=Image F9=Shell F10=Exit /=Find n=Find Next 4. Check the list of rejected disk driv[...]

8. Select the adapter that contains the rejected disk drive. The following menu is displayed: Identify Rejected Array Disks Type or select values in entry fields. Press Enter AFTER making all desired changes. [Entry Fields] SSA RAID Manager ssa0 * Rejected Array Disks + Flash Disk Identification Lights yes + F1=Help F2=Refresh F3=Cancel F4=List F5=[...]

13. Physically remove the failing disk drive for a new one (see the Operator Guide or Service Guide for the unit). 14. If you are going to install a replacement disk drive, go to “ Installing a Replacement Disk Drive ” on page 95. 94 User ’ s Guide and Maintenance Information[...]

Installing a Replacement Disk Drive 1. Physically install the replacement disk drive (see the Operator Guide or Service Guide for the unit). 2. If the failed disk drive has been exchanged for a hot spare disk drive, change the use of the new disk drive to Hot Spare Disk (see “ Changing or Showing the Use of an SSA Disk Drive ” on page 144). Run[...]

5. The following information is displayed: Swap Members of an SSA RAID Array Type or select values in entry fields. Press Enter AFTER making all desired changes. [Entry Fields] SSA RAID Manager ssa1 SSA RAID Array hdisk4 RAID Array Type raid_10 Connection Address / Array Name 00703784C540C0O * Disk To Remove + * Disk To Add + F1=Help F2=Refresh F3=[...]

Using Other Configuration Functions This part of the chapter describes the maintenance procedures that are available for your Advanced SerialRAID Adapter . Y ou can use these procedures at any time. Y ou can get to the required SMIT menu by using fast path commands or by working through other menus. Notes: 1. Although this book always refers to the[...]

Getting Access to the SSA RAID Array SMIT Menu 1. For fast-path access to the SSA RAID Array SMIT menus, type smitty ssaraid and press Enter . Otherwise: a. T ype smitty and press Enter . The System Management menu is displayed. b. Select Devices . The Devices menu is displayed. c. Select SSA RAID Arrays . 2. The SSA RAID Arrays menu is displayed: [...]

–“ Identifying the Disk Drives in an SSA RAID Array ” on page 1 19 –“ Identifying Hot Spare Disk Drives ” on page 121 –“ Identifying Rejected Array Disk Drives ” on page 123 –“ Identifying Array Candidate Disk Drives ” on page 125 –“ Identifying System Disk Drives ” on page 127 –“ Canceling all SSA Disk Drive Ident[...]

Listing All Defined SSA RAID Arrays This option lists all the arrays that are connected to the SSA adapter . 1. For fast path, type smitty lsdssaraid and press Enter . Otherwise, select List All Defined SSA RAID Arrays from the SSA RAID Arrays menu. 2. A list of defined arrays is displayed: COMMAND STATUS Command: OK stdout: yes stderr: no Before c[...]

Listing All Supported SSA RAID Arrays This option lists all the types of array that are supported by the installed SSA RAID managers. 1. For fast path, type smitty lsssaraid and press Enter . Otherwise, select List All Supported SSA RAID Arrays from the SSA RAID Arrays menu. 2. A list of supported arrays is displayed: COMMAND STATUS Command: OK std[...]

Listing All SSA RAID Arrays That Are Connected to a RAID Manager This option lists all the SSA RAID disk drives that are connected to a particular RAID manager . 1. For fast path, type smitty lsmssaraid and press Enter . Otherwise, select List All SSA RAID Arrays Connected to a RAID Manager from the SSA RAID Arrays menu. 2. A list of RAID managers [...]

3. A list of arrays is displayed: COMMAND STATUS Command: OK stdout: yes stderr: no Before command completion, additional instructions may appear below. hdisk4 09523173A02137K good 3.4G RAID-5 array hdisk3 095231779F0737K good 3.4G RAID-5 array F1=Help F2=Refresh F3=Cancel F6=Command F8=Image F9=Shell F10=Exit /=Find n=Find Next Chapter 6. Using th[...]

Listing the Status of All Defined SSA RAID Arrays This option lists the status of each defined array . 1. For fast path, type smitty lstssaraid and press Enter . Otherwise, select List Status of All Defined SSA RAID Arrays from the SSA RAID Arrays menu. 2. The following information is displayed: SSA RAID Arrays Move cursor to desired item and press[...]

3. The following information is displayed for RAID-5 arrays: COMMAND STATUS Command: OK stdout: yes stderr: no Before command completion, additional instructions may appear below. Unsynced Parity Strips Unbuilt Data Strips hdisk3 0 0 hdisk4 0 0 F1=Help F2=Refresh F3=Cancel F6=Command F8=Image F9=Shell F10=Exit /=Find n=Find Next Chapter 6. Using th[...]

The following information is displayed for RAID-1 and RAID-10 arrays: COMMAND STATUS Command: OK stdout: yes stderr: no Before command completion, additional instructions may appear below. Components Primary Secondary Status hdisk4 degraded pdisk13 pdisk15 good pdisk3 pdisk6 good pdisk7 BlankReserved5Z degraded F1=Help F2=Refresh F3=Cancel F6=Comma[...]

exposed One member disk drive of a mirrored pair is missing or has failed, but no write operation has been issued to the pair . degraded One member disk drive of a mirrored pair is missing or has failed, and a write operation has been issued to the working member disk drive. rebuilding A failed member disk drive in a mirrored pair has been exchange[...]

Listing or Identifying SSA Physical Disk Drives This option allows you to list the disk drives that are being used by a particular array , and to identify particular disk drives. 1. For fast path, type smitty lsidssaraid and press Enter . Otherwise, select List/Identify SSA Physical Disks from the SSA RAID Arrays menu. 2. The following information [...]

Listing the Disk Drives in an SSA RAID Array This option allows you to list the disk drives that are contained in a particular array . 1. For fast path, type smitty lssaraid and press Enter . Otherwise: a. Select List/Identify SSA Physical Disks from the SSA RAID Arrays menu. b. Select List Disks in an SSA RAID Array . 2. A list of arrays is displa[...]

3. A list of disk drives is displayed: COMMAND STATUS Command: OK stdout: yes stderr: no Before command completion, additional instructions may appear below. pdisk1 0004AC5119E000D member present 1.1G Physical disk pdisk4 08005AEA030D00D member present 2.3G Physical disk pdisk7 08005AEA087A00D member present 4.5G Physical disk pdisk8 08005AEA098100[...]

Listing Hot Spare Disk Drives This option allows you to list the hot spare disk drives that are available to a particular array . 1. For fast path, type smitty lhssaraid and press Enter . Otherwise: a. Select List/Identify SSA Physical Disks from the SSA RAID Arrays menu. b. Select List Hot Spares . 2. A list of adapters is displayed in a window: L[...]

3. A list of hot spare disk drives is displayed: COMMAND STATUS Command: OK stdout: yes stderr: no Before command completion, additional instructions may appear below. pdisk3 0004AC5119E000D spare n/a 1.1G Physical disk pdisk5 08005AEA030D00D spare n/a 2.3G Physical disk F1=Help F2=Refresh F3=Cancel F6=Command F8=Image F9=Shell F10=Exit /=Find n=Fi[...]

Listing Rejected Array Disk Drives This option allows you to list disk drives that have been rejected (probably because of failure) from arrays. 1. For fast path, type smitty lfssaraid and press Enter . Otherwise: a. Select List/Identify SSA Physical Disks from the SSA RAID Arrays menu. b. Select List Rejected Array Disks . 2. A list of adapters is[...]

3. A list of rejected disk drives is displayed: COMMAND STATUS Command: OK stdout: yes stderr: no Before command completion, additional instructions may appear below. pdisk3 0004AC5119E000D rejected n/a 1.1G Physical disk pdisk5 08005AEA030D00D rejected n/a 2.3G Physical disk F1=Help F2=Refresh F3=Cancel F6=Command F8=Image F9=Shell F10=Exit /=Find[...]

Listing Array Candidate Disk Drives This option allows you to list disk drives that are available for adding to an array . 1. For fast path, type smitty lcssaraid and press Enter . Otherwise: a. Select List/Identify SSA Physical Disks from the SSA RAID Arrays menu. b. Select List Array Candidate Disks . 2. A list of adapters is displayed in a windo[...]

3. A list of candidate disk drives is displayed: COMMAND STATUS Command: OK stdout: yes stderr: no Before command completion, additional instructions may appear below. pdisk3 0004AC5119E000D free 1.1G Physical disk pdisk5 08005AEA030D00D free 2.3G Physical disk F1=Help F2=Refresh F3=Cancel F6=Command F8=Image F9=Shell F10=Exit /=Find n=Find Next 11[...]

Listing System Disk Drives This option allows you to list disk drives that are used by the using system. These disk drives are not member disk drives of any array . 1. For fast path, type smitty lassaraid and press Enter . Otherwise: a. Select List/Identify SSA Physical Disks from the SSA RAID Arrays menu. b. Select List System Disks . 2. A list of[...]

3. A list of system disk drives is displayed: COMMAND STATUS Command: OK stdout: yes stderr: no Before command completion, additional instructions may appear below. pdisk3 0004AC5119E000D system 1.1G Physical disk pdisk5 08005AEA030D00D system 2.3G Physical disk F1=Help F2=Refresh F3=Cancel F6=Command F8=Image F9=Shell F10=Exit /=Find n=Find Next 1[...]

Identifying the Disk Drives in an SSA RAID Array This option allows you to identify the disk drives that are contained in a particular array . 1. For fast path, type smitty issaraid and press Enter . Otherwise: a. Select List/Identify SSA Physical Disks from the SSA RAID Arrays menu. b. Select Identify Disks in an SSA RAID Array . 2. A list of arra[...]

3. The following information is displayed: Identify Disks in an SSA RAID Array Type or select values in entry fields. Press Enter AFTER making all desired changes. Entry Fields SSA RAID Manager ssa0 SSA RAID Array hdisk2 * Member Disks + Flash Disk Identification Lights yes + F1=Help F2=Refresh F3=Cancel F4=List F5=Reset F6=Command F7=Edit F8=Image[...]

Identifying Hot Spare Disk Drives This option allows you to identify the hot spare disk drives that are available to a particular SSA RAID manager . 1. For fast path, type smitty ihssaraid and press Enter . Otherwise: a. Select List/Identify SSA Physical Disks from the SSA RAID Arrays menu. b. Select Identify Hot Spares . 2. A list of arrays is dis[...]

3. The following information is displayed: Identify Hot Spares Type or select values in entry fields. Press Enter AFTER making all desired changes. [Entry Fields] SSA RAID Manager ssa0 * Hot Spare Disks + Flash Disk Identification Lights yes + F1=Help F2=Refresh F3=Cancel F4=List F5=Reset F6=Command F7=Edit F8=Image F9=Shell F10=Exit Enter=Do 4. Se[...]

Identifying Rejected Array Disk Drives This option allows you to identify disk drives that have been rejected (probably because of failure) from arrays. 1. For fast path, type smitty ifssaraid and press Enter . Otherwise: a. Select List/Identify SSA Physical Disks from the SSA RAID Arrays menu. b. Select Identify Rejected Array Disks . 2. A list of[...]

3. The following information is displayed: Identify Rejected Array Disks Type or select values in entry fields. Press Enter AFTER making all desired changes. [Entry Fields] SSA RAID Manager ssa0 * Rejected Array Disks + Flash Disk Identification Lights yes + F1=Help F2=Refresh F3=Cancel F4=List F5=Reset F6=Command F7=Edit F8=Image F9=Shell F10=Exit[...]

Identifying Array Candidate Disk Drives This option allows you to identify disk drives that are available for adding to an array . 1. For fast path, type smitty icssaraid and press Enter . Otherwise: a. Select List/Identify SSA Physical Disks from the SSA RAID Arrays menu. b. Select Identify Array Candidate Disks . 2. A list of adapters is displaye[...]

3. The following information is displayed: Identify Array Candidate Disks Type or select values in entry fields. Press Enter AFTER making all desired changes. [Entry Fields] SSA RAID Manager ssa0 * Array Candidate Disks + Flash Disk Identification Lights yes + F1=Help F2=Refresh F3=Cancel F4=List F5=Reset F6=Command F7=Edit F8=Image F9=Shell F10=Ex[...]

Identifying System Disk Drives This option allows you to identify disk drives that are used by the using system. These disk drives are not member disk drives of any array . 1. For fast path, type smitty iassaraid and press Enter . Otherwise: a. Select List/Identify SSA Physical Disks from the SSA RAID Arrays menu. b. Select Identify System Disks . [...]

3. The following information is displayed: Identify System Disks Type or select values in entry fields. Press Enter AFTER making all desired changes. [Entry Fields] SSA RAID Manager ssa0 * System Disks + Flash Disk Identification Lights yes + F1=Help F2=Refresh F3=Cancel F4=List F5=Reset F6=Command F7=Edit F8=Image F9=Shell F10=Exit Enter=Do 4. Sel[...]

Canceling all SSA Disk Drive Identifications This option allows you to cancel all disk drive identifications. For fast path, type smitty ssa_identify_cancel and press Enter . Otherwise: 1. Select List/Identify SSA Physical Disks from the SSA RAID Arrays menu. 2. Select Cancel all SSA Disk Identifications . The Check lights of all identified disk dr[...]

Listing or Deleting Old RAID Arrays Recorded in an SSA RAID Manager If an array becomes disconnected from a RAID manager by some method other than the method described in “ Deleting an SSA RAID Array ” on page 70, a record of that array remains in the RAID manager . The record must be deleted manually . This option allows you to list the serial[...]

Listing Old RAID Arrays Recorded in an SSA RAID Manager This option allows you to list the serial numbers of disconnected arrays whose records remain in the RAID manager . 1. Select List/Delete Old RAID Arrays in an SSA RAID Manager from the SSA RAID Arrays menu. 2. Select List Old RAID Arrays Recorded in an SSA RAID Manager . 3. A list of RAID man[...]

5. If any old arrays are in the RAID manager , a list of those arrays appears: COMMAND STATUS Command: OK stdout: yes stderr: no Before command completion, additional instructions may appear below. [TOP] 0952314698B637K 09523146994837K 0952314699A437K 0952314699CE37K 095231469A9337K 095231469B6D37K 095231469C4537K 095231469CEE37K 095231469D7A37K 09[...]

Deleting an Old RAID Array Recorded in an SSA RAID Manager This option allows you to delete the records of RAID managers that have been disconnected, but whose records remain in the RAID manager . 1. Select List/Delete Old RAID Arrays in an SSA RAID Manager from the SSA RAID Arrays menu. 2. Select Delete an Old RAID Array Recorded in an SSA RAID Ma[...]

4. The following information is displayed: Delete an Old RAID Array Recorded in an SSA RAID Manager Type or select values in entry fields. Press Enter AFTER making all desired changes. [Entry Fields] SSA RAID Manager ssa0 * Old SSA RAID Array Record to Delete F1=Help F2=Refresh F3=Cancel F4=List F5=Reset F6=Command F7=Edit F8=Image F9=Shell F10=Exi[...]

Changing or Showing the Attributes of an SSA RAID Array Each array type has several attributes associated with it. This option allows you to see, and possibly change, those attributes. 1. For fast path, type smitty chssaraid and press Enter . Otherwise, select Change/Show Attributes of an SSA RAID Array from the SSA RAID Arrays menu. 2. A list of R[...]

4. A list of attributes is displayed: Change/Show Attributes of an SSA RAID Array Type or select values in entry fields. Press Enter AFTER making all desired changes. [Entry Fields] SSA RAID Manager ssa0 SSA RAID Array hdisk3 Connection Address / Array Name 00243199986267K RAID Array Type raid_5 State good Member Disks pdisk1 pdisk3 pdisk4 p> Si[...]

Changing Member Disks in an SSA RAID Array This option allows you to remove a disk drive from an array and install a replacement disk drive. All the data that is on the original disk drive is automatically written to the replacement disk drive. 1. For fast path, type smitty swpssaraid and press Enter . Otherwise, select Change Member Disks in an SS[...]

Removing a Disk Drive from an SSA RAID Array This option allows you to remove a disk drive from an array so that you can install a replacement disk drive. Use this option when you do not have either an available online disk drive, or a spare slot for a replacement disk drive. 1. For fast path, type smitty redssaraid and press Enter . Otherwise: a. [...]

3. The following information is displayed: Remove a Disk from an SSA RAID Array Type or select values in entry fields. Press Enter AFTER making all desired changes. [Entry Fields] SSA RAID Manager ssa0 SSA RAID Array hdisk3 Connection Address / Array Name 095231779F0737K * Disk to Remove + F1=Help F2=Refresh F3=Cancel F4=List F5=Reset F6=Command F7[...]

Adding a Disk Drive to an SSA RAID Array This option allows you to install a replacement disk drive into a RAID-5 array that is running in the Exposed or Degraded state because a disk drive has been rejected or removed from the array . You cannot use this procedure to add a disk drive to a RAID-1 or RAID-10 array . When you install the replacement [...]

3. The following information is displayed: Add a Disk to an SSA RAID Array Type or select values in entry fields. Press Enter AFTER making all desired changes. [Entry Fields] SSA RAID Manager ssa0 SSA RAID Array hdisk3 Connection Address / Array Name 09523177F0737K * Disk to Add + F1=Help F2=Refresh F3=Cancel F4=List F5=Reset F6=Command F7=Edit F8=[...]

Swapping Members of an SSA RAID Array This option allows you to swap a disk drive for a replacement disk drive. 1. For fast path, type smitty exssaraid and press Enter . Otherwise: a. Select Change Member Disks in an SSA RAID Array from the SSA RAID Arrays menu. b. Select Swap Members of an SSA RAID Array . 2. A list of arrays is displayed in a win[...]

3. The following information is displayed: Swap Members of an SSA RAID Array Type or select values in entry fields. Press Enter AFTER making all desired changes. [Entry Fields] SSA RAID Manager ssa0 SSA RAID Array hdisk3 Connection Address / Array Name 09523173A02137K * Disk To Remove + * Disk To Add + F1=Help F2=Refresh F3=Cancel F4=List F5=Reset [...]

Changing or Showing the Use of an SSA Disk Drive This option allows you to change, or see, how particular disk drives are used. 1. For fast path, type smitty chgssadisk and press Enter . Otherwise, select Change/Show Use of an SSA Physical Disk from the SSA RAID Arrays menu. 2. A list of adapters is displayed in a window: List/Identify SSA Physical[...]

3. A list of disk drives and their usage is displayed in a window: SSA RAID Arrays Move cursor to desired item and press Enter. List All Defined SSA RAID Arrays -------------------------------------------------------------------------- | SSA Physical Disk | | | | Move cursor to desired item and press Enter. Use arrow keys to scroll. | | | | # SSA p[...]

4. Select the disk drive that you want to change or show . The following screen is displayed for the disk drive that you have chosen: Change/Show Use of an SSA Physical Disk Type or select values in entry fields. Press Enter AFTER making all desired changes. [Entry Fields] SSA RAID Manager ssa0 SSA physical disk pdisk6 CONNECTION address 08005AEA08[...]

Changing the Use of Multiple SSA Physical Disks 1. For fast path, type smitty chgssadisks and press Enter . Otherwise, select Change Use of Multiple SSA Physical Disks from the SSA RAID Arrays menu. 2. A list of adapters is displayed in a window: SSA RAID Arrays Move cursor to desired item and press Enter. List All Defined SSA RAID Arrays List All [...]

4. Use the Select key to select the disk drives whose use you want to change. Select only those disk drives that are to have the same use. (For example, select only disk drives that are to become hot spare disk drives, or select only disk drives that are to become system disks.) The following screen is displayed for the disk drives that you have ch[...]

Chapter 7. Copying Data from Arrays and from V olume Groups When disk drives are configured through the Logical V olume Manager for mirroring, you can use the Split Copy function to create a copy of a logical volume. Y ou can then save that copy on a tape or other medium for backup purposes. When disk drives are configured as members of a RAID-1 or[...]

synchronized to the array before you run the copy operation. The recommended procedure for copying logical volumes is to use the ssa_make_copy command, rather than SMIT or ssaraid commands. The ssa_delete_copy command is provided to enable you to delete the copy after it has been backed up. Y ou can, for example, use the ssa_make_copy and ssa_delet[...]

Copying Data from an Array Three methods are available by which you can create a RAID-Copy array from a RAID-1 or RAID-10 array . Those methods are: v Using the ssaraid command from the command line v Using SMIT v Using the ssa_make_copy command (the recommended method) Using the ssaraid Command to Create a RAID-Copy Array from a RAID-1 or RAID-10 [...]

All the free disk drives that are listed are large enough and have the correct format to become part of the RAID-Copy array for hdisk5. 2. With a disk drive from the list (for example, 000629CD8A3900D), create your RAID-Copy array . T ype: ssaraid -C -l ssa2 -t raid_copy -s 000629CD8A3900D -r hdisk5 A message is displayed; for example: 185439188B4F[...]

4. The time needed for the copy operation is related to the amount of data that you are copying. A large amount of data might take more that one hour to copy . T o check whether the copy operation has completed, type: ssaraid -I -l ssa2 -n hdisk5 While the copy operation is running, the following information is included in the displayed data: array[...]

8. The newly created RAID-Copy array is created as a free disk drive. Y ou must now make it a system disk drive, and configured it on the using system: a. Using the RAID-Copy array serial number that was created in step 6 on page 153, type: ssaraid -H -l ssa2 -n 185439188B4F4CT -a use=system The RAID-Copy array is now a system disk drive. b. If you[...]

Using SMIT to Create a RAID-Copy Array from a RAID-1 or RAID-10 Array This section describes how to use the SMIT menus to create RAID-copy arrays. This method and the ssaraid command method (see “ Using the ssaraid Command to Create a RAID-Copy Array from a RAID-1 or RAID-10 Array ” on page 151) are particularly suitable if you are not using Lo[...]

3. Select the RAID-1 or RAID-10 array hdiskx that you want to copy , and press Enter . The Prepare a Copy menu is displayed: Prepare a Copy Type or select values in entry fields. Press Enter AFTER making all desired changes. [Entry Fields] Array to be copied hdisk3 Number of disk drives required 1 Minimum disk drive size required 9.1GB Verify copy [...]

c. Press Enter . The new RAID-Copy array is created and coupled to the parent array . The copy operation starts. 5. The time needed for the copy operation is related to the amount of data that you are copying. A large amount of data can take more than one hour to copy . T o check whether the copy operation has completed: a. Select Array Copy Servic[...]

6. T o uncouple the RAID-Copy Array: a. Select Array Copy Services from the SSA RAID Arrays menu. b. Select Uncouple a RAID Array Copy . A list is displayed of all the RAID-1 and RAID-10 arrays that have been copied. c. Select the array that you want to uncouple, for example, hdisk3, and press Enter . When the array is uncoupled, a new hdisk is cre[...]

Using the ssa_make_copy Command to Create a RAID Copy from a RAID-1 or RAID-10 Array Figure 22 shows a volume group that contains one physical volume: hdisk1. This hdisk is a RAID-1 array . The ssa_make_copy command checks whether the hdisk is either a RAID-1 or a RAID-10 array . If the array is neither of these types, the command displays a warnin[...]

The recreatevg command is run on the RAID-Copy array . It creates the new volume group, renames the file systems, and mounts them to new mount points (see Figure 24). Figure 24. The RAID-Copy Array Uncoupled from the Parent hdisk 160 User ’ s Guide and Maintenance Information | | | | | | | | |[...]

ssa_make_copy Command Purpose T o create a RAID-Copy array from a RAID-1 or RAID-10 array . Syntax ssa_make_copy -v vgname -l lvname -f fsname [-V newvgname] [-L newlvprename] [-F newfsprempoint] [-s] [-m|r] [-e] [-E filename] ssa_make_copy -U -v vgname -l lvname -f fsname [-s] [-e] [-E filename] Usage: ssa_make_copy -P -v vgname -l lvname -f fsnam[...]

c. If the dump logical volume and the boot logical volume are copied, a warning is displayed. Y ou must delete the copies of these logical volumes after the copy volume group has been created. d. If the logical volume that you want to copy has a file system loglv that is located in a different volume group, you cannot copy the logical volume. 2. Th[...]

-F Determines the name of the copy file system. If this flag is not provided, the default naming convention applies. For example, the copy of the original file system /data is named /fs/data . -L Determines the name of the copy logical volume. If this flag is not provided, the default naming convention applies. For example, the copy of the original[...]

Example 1: Copying a Complete V olume Group In this example, you are copying a complete volume group from the parent array to the RAID-Copy array . T o copy a complete volume group, give the commands: ssa_make_copy -P -v vgname ssa_make_copy -v vgname Figure 25 shows, from left to right: v The parent array that contains the source volume group. v T[...]

Example 2: Copying One Logical V olume In this example, you are copying only one logical volume (-lv B) from the parent array to the RAID-Copy array . T o copy one logical volume, give the commands: ssa_make_copy -P -l lv_B ssa_make_copy -l lv_B Figure 26 shows, from left to right: v The parent array that contains the source volume group. v The emp[...]

Example 3: Copying One Logical V olume by Logical V olume Name or by FS Name In this example, you are copying one logical volume (lv_A) from the parent array to the RAID-Copy array . Y ou can use either the logical volume name (lv_A), or the FS name (data fs_1). T o copy one logical volume by logical volume name, give either of the following sets o[...]

Figure 27 shows, from left to right: v The parent array that contains the source volume group. v The empty RAID-Copy array coupled to the parent array . v The uncoupled RAID-Copy array that now contains a copy of the logical volume. Note that in the copy , all names start with fs. Figure 27. Copying One Logical V olume or Copying by FS Name (1) Cha[...]

Example 4: Copying One Logical V olume by Logical V olume Name or by FS Name (2) In this example, you are copying one logical volume (lv_C) from the parent array to the RAID-Copy array . Y ou can use either the logical volume name (lv_C), or the FS name (data_fs2). T o copy one logical volume by logical volume name, give the commands: ssa_make_copy[...]

Example 4: Copying a Complete V olume Group and Recreating the Copy on Another Using System In this example, you are copying a complete volume group, then recreating the copy on another using system. 1. On the original using system, give the commands: ssa_make_copy -P -v vgname ssa_make_copy -U -v vgname A message is displayed; for example: Copy Ar[...]

Example 5: Running an Automatic Copy of a V olume Group 1. Prepare a volume group for copying: a. Give the command: ssa_make_copy -P -v vgname b. Wait for the copy to complete. c. Wait for the external trigger to be created. 2. Uncouple the volume group: Give the command: ssa_make_copy -U -v vgname 3. Recreate the volume group: Give the command: ss[...]

ssa_delete_copy Command Purpose T o delete a RAID-Copy array after it has been backed up. Syntax ssa_delete_copy -v vgname | -p pvname -A/-C [-f] Flags -A Deletes a copy and its RAID-Copy arrays. -C Deletes a copy and couples the RAID-Copy to its original parents. -f If the specified volume group is varied off, this flag forces the volume group to [...]

SMIT Menus for 3-W ay Copy Operations This section describes the SMIT menus that are related to the 3-W ay Copy function. These SMIT menus help you to develop your own shell scripts to manage the copy operations. Getting Access to the Array Copy Services Menu 1. For fast path access to the SSA RAID Array SMIT menu, type smitty ssaraid and press Ent[...]

Array Copy Services For fast path access to the Array Copy Services menu, type smitty ssa_copy and press Enter . Otherwise, select Array Copy Services from the SSA RAID Arrays menu. Note: Array Copy Services are designed to be run from shell scripts. These SMIT menus are intended as an aid to shell script development and as a problem determination [...]

Uncouple a RAID Array Copy Select this option if you want to uncouple a copy from an array . The copy must be in the Good state before it can be uncoupled. When the copy is uncoupled, a new hdisk is created. This hdisk contains the copied data. When this option is selected, a RAID array selection menu is displayed. If you select a RAID array that h[...]

Prepare a Copy For fast path, type smitty copy_pre_array and press Enter . Otherwise, select Prepare a Copy from the Array Copy Services menu. The Prepare a Copy menu is displayed: Prepare a Copy Type or select values in entry fields. Press Enter AFTER making all desired changes. [Entry Fields] Array to be copied hdisk3 Number of disk drives requir[...]

Hot spare selection Default Assigns the coupled disk drives to the pool to which those disk drives were previously assigned: Primary Each coupled disk drive is assigned to the hot spare pool to which the Primary disk drive that it is copying is assigned. Secondary Each coupled disk drive is assigned to the hot spare pool to which the Secondary disk[...]

Uncouple a V olume Group, Logical V olumes, or Filesystems Copy For fast path, type smitty copy_unvglvfs and press Enter . Otherwise, select Uncouple a V olume Group, Logical V olumes, or Filesystems Copy from the Array Copy Services menu. The Uncouple a V olume Group, Logical V olumes or Filesystems Copy menu is displayed: Uncouple a Volume Group,[...]

If you select yes , the file systems are mounted when the copy is uncoupled. If you select read only , the file systems are mounted for “ read only ” when the copy is uncoupled. Synchronize the file systems Select this option to schedule a synchronization operation before the copy is uncoupled. 178 User ’ s Guide and Maintenance Information |[...]

List All Copy Candidates For fast path, type smitty copy_lstcopycand and press Enter . Otherwise, select List All Copy Candidates from the Array Copy Services menu. The following information is displayed: COMMAND STATUS Command: OK stdout: yes stderr: no Before command completion, additional instructions may appear below. Array Array Type Coupled D[...]

Copying Data is being copied to the coupled disk drives, but these coupled disk drives do not yet contain an exact copy of the data that is on the array . Degraded A copy has been created, but one or more coupled disk drives are missing or have failed. If missing disk drives are replaced or exchanged for new disk drives, the copy operation continue[...]

List All Uncoupled Copies For fast path, type smitty copy_lstcopies and press Enter . Otherwise, select List All Uncoupled Copies from the Array Copy Services menu. The following information is displayed: COMMAND STATUS Command: OK stdout: yes stderr: no Before command completion, additional instructions may appear below. Copy Status Parent Array T[...]

List All Uncoupled V olume Groups For fast path, type smitty copy_lstunvg and press Enter . Otherwise, select List All Uncoupled V olume Groups from the Array Copy Services menu. The following information is displayed: COMMAND STATUS Command: OK stdout: yes stderr: no Before command completion, additional instructions may appear below. Copy Status [...]

Delete a RAID Array Copy For fast path, type smitty copy_delcopy and press Enter . Otherwise, select Delete a RAID Array Copy from the Array Copy Services menu. The following information is displayed: Array Copy Services Move cursor to desired item and press Enter. Prepare a RAID Array Copy Prepare Volume Group, Logical Volumes, or Filesystems Copy[...]

Delete a V olume Group, Logical V olumes, or Filesystems Copy For fast path, type smitty copy_delvglvfs and press Enter . Otherwise, select Delete a V olume Group, Logical V olumes, or Filesystems Copy from the Array Copy Services menu. The following information is displayed: Array Copy Services Move cursor to desired item and press Enter. Prepare [...]

The meanings of the fields are: V olume Group The volume group that you selected previously . Action The possible actions are: Delete and Detach The volume group name is removed. Data on the volume group is no longer accessible. The RAID-Copy arrays change to free, and can be recoupled to parent arrays. Delete The volume group name is removed, and [...]

Effects of Array Copy on Other SMIT Menus This section shows SMIT menus that are described elsewhere in this book. When Array Copy is used, however , additional fields or display panels are present. Change/Show Attributes of an SSA RAID Array The following information is displayed for RAID-1 or RAID-10 arrays: Change/Show Attributes of an SSA RAID [...]

Percentage Copied The percentage of the array data that has been copied onto the coupled disk drives. When this reaches 100%, the coupled disk drives contain an exact copy of the data that is on the array , and can be uncoupled at any time from the array . For fields that are not defined here, see “ Changing or Showing the Attributes of an SSA RA[...]

List Status Of All Defined SSA RAID Arrays For fast path, type smitty lstssaraid and press Enter . Otherwise, select List Status Of All Defined SSA RAID Arrays from the SSA RAID Arrays menu. The following information is displayed for RAID-Copy arrays: COMMAND STATUS Command: OK stdout: yes stderr: no Before command completion, additional instructio[...]

Identify Disks in an SSA RAID Array For fast path, type smitty issaraid and press Enter . Otherwise, select Identify Disks in an SSA RAID Array from the List/Identify SSA Physical Disks menu. The following information is displayed for RAID arrays that have coupled disk drives: Identify Disks in an SSA RAID Array Type or select values in entry field[...]

Remove a Disk From an SSA RAID Array For fast path, type smitty redssaraid and press Enter . Otherwise, select Remove a Disk From an SSA RAID Array from the Change Member Disks in an SSA RAID Array menu. When the List key is pressed for the Disk to Remove option, the following pop-up menu is displayed: Remove a Disk From an SSA RAID Array Type or s[...]

Swap Members of an SSA RAID Array For fast path, type smitty exssaraid and press Enter . Otherwise, select Swap Members of an SSA RAID Array from the Change Member Disks in an SSA RAID Array menu. When the List key is pressed for the Disk to Remove option, the following pop-up menu is displayed: Swap Members of an SSA RAID Array Type or select valu[...]

192 User ’ s Guide and Maintenance Information[...]

Chapter 8. Split-Site Management This chapter describes how to configure and manage a system in which the computing and disk drive resources are split between two or more sites, so that the system can continue to operate if one site is lost. Configuration of RAID-1 and RAID-10 Arrays RAID-1 and RAID-10 arrays hold data on mirrored pairs of disk dri[...]

loss of any power domain in this configuration, a using system continues to detect either all the primary configuration disk drives, or one primary and one secondary configuration disk drive, and continues to access the array without the need to set the Split Array Resolution flag. Operation after a Loss of Member Disks An array goes into the Offli[...]

spare disk drives are not introduced if the Split Array Resolution flag is set to Secondary (secondary disk drives only are being used), the HotSpareSplits flag is set to off , and all the primary disk drives and the other adapter are not visible. Three types of array management problems can cause an array to be in the Offline state to the using sy[...]

Single-Host System with Primary Disk Drive Missing Figure 29 shows a single-host system that has just been switched on. The system contains a RAID-1 array whose primary disk drive is missing. The array remains online, but in the Exposed state until one of the following occurs: v The missing primary disk drive becomes available again before a write [...]

Dual-Host System with Primary Disk Drive Missing Figure 30 shows a dual-host system that has just been switched on. The system contains a RAID-1 array whose primary disk drive is missing. The array remains online, but in the Exposed state until one of the following occurs: v The missing primary disk drive becomes available again before a write oper[...]

Dual-Host System with Only One System Switched On Figure 31 shows a dual-host system that has just been switched on. The system contains a RAID-1 array , but the primary disk drive is missing because system 1 in not switched on. The array remains in the Of fline state on both systems until either of the following occurs: v The primary disk drive be[...]

Split Systems The system can become split because communications have failed between the two systems. System 1 Split from System 2: Figure 32 shows system 1 split from system 2. On system 1, the array is in the Exposed or the Degraded state. On system 2, the array is in the Offline state, and SRN 48750 is generated. The array remains in the Offline[...]

Normal Reconnection: When the systems are reconnected, the secondary disk drives are resynchronized with the primary disk drives, as shown in Figure 33. The array enters the Good state for both systems. Split Arra y Resolution = Primar y System 1 SSA Adapter System 2 SSA Adapter Secondar y 1 Secondar y 2 Primar y 1 Primar y 2 Split Arra y Resolutio[...]

Failure of a Primary Disk Drive in a Dual-Host System: Figure 34 shows a dual-host system in which the primary disk drive of a RAID-1 array has failed. Because both adapters can still detect the secondary disk drive of the array , the Split Array Resolution flag is automatically set to Secondary , and I/O operations continue. The array is in the Ex[...]

RAID-1 Failure of a Host System and a Primary Disk Drive: Figure 35 shows system 2 disconnected from system 1. The array is in the Of fline state. If you set Split Array Resolution to Secondary , the array goes into the Good state. RAID-10 Failure of a Host System and a Primary Disk Drive: Figure 36 shows system 2 disconnected from system 1. The ar[...]

Array is Offline because Adapter Is Not Known to the Remaining Half of the Array When this condition exists, the host system generates SRN 48755. T o maintain data consistency , SSA RAID-1 and RAID-10 arrays keep a record of the adapters to which they are connected. If exactly one half of the array is connected to a different adapter , the array re[...]

Moving an Array between Systems In Figure 38, exactly half of a RAID-10 array is being moved from its original connections (adapter A and adapter B) to a new configuration where it is connected to adapter C and adapter D. Under these conditions: v The half of the array that is still connected to adapter A and adapter B is in the Exposed state. v Th[...]

v Change the state of the Split Array Resolution flag on the new adapters. Attention: This method helps you to recover the system from severe errors. Use this method only if the other half of the array has failed completely , and will never be used again. Array is Offline because the Split and Join Procedure W as Not Performed Correctly When this c[...]

RAID-10 Array Split Figure 39 shows a RAID-10 array that has been split into halves. The Split Array Resolution flag has been set to Secondary to permit I/O operations to be performed on the secondary half of the array . Only user actions can set this condition. Separate write operations can be performed to each half of the array . If these write o[...]

RAID-10 Array with Unsynchronized Data Figure 40 shows a RAID – 10 array whose halves have been reconnected. Each half of the array contains different data, but no indication is given to which data is valid. Under these conditions, the array is in the Offline state, and both systems generate SRN 48760. Split Arra y Resolution = Primar y System 1 [...]

208 User ’ s Guide and Maintenance Information[...]

Chapter 9. Using the SSA Spare T ool The SSA Spare T ool helps you to manage your SSA networks when Logical V olume Manager (L VM) mirrored volume groups are used. It works with the L VM to identify stale partitions or missing physical volumes in L VM mirrored volume groups. If the SSA Spare T ool finds any stale partitions or missing physical volu[...]

210 User ’ s Guide and Maintenance Information[...]

Chapter 10. Using the Fast-Write Cache Feature This chapter describes how to configure the Fast-Write Cache feature, and how to deal with any fast-write problems that might occur during fast-write operations. Fast-Write Cache Card Battery The Fast-Write Cache Option Card receives its power from a rechargeable battery . This battery can maintain dat[...]

those shown in this book. If you are not familiar with the selection of items from the graphics versions of the menus, use the smitty command. The menus will then appear as shown in this book. 2. If you use fast-path commands, you might need to go through intermediate steps that are not shown in this book. Also, some menus might be displayed slight[...]

Getting Access to the Fast-Write Menus 1. For fast-path access to the Fast-Write SMIT menus, type smitty ssadlog and press Enter . Otherwise: a. T ype smitty and press Enter . The System Management menu is displayed. b. Select Devices . The Devices menu is displayed. c. Select SSA Disks . The SSA Disks menu is displayed. d. Select SSA Logical Disks[...]

Enabling or Disabling Fast-Write for One Disk Drive This option lets you enable or disable the fast-write function for one disk drive. 1. For fast-path access to the Change/Show Characteristics of an SSA Logical Disk menu: a. T ype smitty chgssardsk and press Enter . b. From the menu displayed, select the logical disk that you want to change. Other[...]

device is present in the fast-write cache, and you want to disable the fast-write function, go to “ Enabling or Disabling Fast-Write for Multiple Devices ” . Enabling or Disabling Fast-Write for Multiple Devices This option allows you to enable or disable the fast-write function on multiple devices. Y ou can select multiple devices from the lis[...]

Notes: a. If you are running a two-way fast-write operation, and you enable or disable the fast-write function, the hdisk on the second using system becomes unavailable. From the second using system, delete that hdisk, and reconfigure as follows: 1) T ype: rmdev -l hdiskname -d 2) Run cfgmgr to reconfigure the new hdisk. b. The fast-write function [...]

Bypassing the Cache in a One-W ay Fast-Write Network If you are using the two-way fast-write function (that is, two adapters have access to a fast-write disk drive), you can choose whether you want fast-write operations to continue if the partner adapter fails or becomes not accessible. By default , fast-write operations continue. 1. For fast-path [...]

Dealing with Fast-Write Problems This section describes how to recover from problems that might occur during fast-write operations. The type of problems are those in which data loss might have occurred or customer data recovery procedures need to be performed. These problems are indicated by any of the following Service Request Numbers (SRNs): v 42[...]

v T o disable the fast-write cache, type: ssaraid -l ssaX -H -n Y -a fastwrite=off -a force=yes -u where X is the number of the adapter that has reported the failure, and Y is the name of the device. (The name of the device can be either the logical disk name, or the SSA serial number .) A typical command line might be, therefore: ssaraid -l ssa3 -[...]

SRN 42524 If a Fast-Write Cache Option Card fails, or is removed from the adapter , the affected devices are all those that contain unsynchronized data when the cache card fails, or is removed. T o list these devices, type: ssaraid -l ssaX -Iz -a state=no_cache where X is the adapter number . Use the recovery procedure that is described for SRN 425[...]

Chapter 1 1. SSA Error Logs This chapter describes: v Error logging v Error logging management v Error log analysis v Good housekeeping Each topic is discussed as a summary , then as a detailed description . The summaries provide all the information that you need for routine service operations on SSA subsystems. For these operations, you have no ne[...]

Detailed Description SSA error logs are grouped into types of errors. Each type of error is assigned to an Error Label and an Error ID. The Error Label specifies the text that appears when the error log is displayed. It also specifies the priority that is applied to each error type when the cause of a problem is determined. The Error ID is a numeri[...]

T able 2. Error Labels (continued) Error Label Error ID Error Description SSA_DEVICE_ERROR FE9E9357 This error can be logged against the adapter or disk drive resource. When the error is logged against a disk drive, it indicates that the adapter has detected a failure on the disk drive. It is possible, however , that the failure was detected becaus[...]

T able 2. Error Labels (continued) Error Label Error ID Error Description SSA_LINK_ERROR ABECECFD Link errors might be detected by any node in the SSA loop. The adapter is notified of these errors. It performs any necessary error recovery , and logs the error . Link errors are normally associated with some other failure on the SSA loop. Link errors[...]

Disk drive errors on SSA subsystems are logged against the physical disk drive (pdisk) rather than the logical disk drive (hdisk). If you are looking for the cause of a problem where the failing hdisk is known, you can use either of the following methods to find that cause: v Use the Configuration V erification service aid, or give the ssaxlate -l [...]

SCSI Sense Data Format: Errors that are logged with the following labels have SCSI sense data in the detail data field in the error log: DISK_ERR1 SSA_DISK_ERR2 DISK_ERR4 SSA_DISK_ERR3 SSA_DISK_ERR1 SSA_DISK_ERR4 SCSI sense data consists of 32 bytes of data. See “ Error Log Analysis ” on page 229 to find out how this data is used. SSA Error Cod[...]

v Redundant power failures in SSA enclosures The test runs hourly at a specific time in the hour . run_ssa_link_speed cron SSA links can run at 20 MB per second or at 40 MB per second. Normally , two SSA nodes that can communicate at 40 MB per second operate the link between them at 40 MB per second. Some faults, however , can cause a 40-MB-per-sec[...]

Error Logging Management Summary If an error is permanent, it is reported each time that the health check is run. If an error is intermittent, it is logged each time that it occurs. Because a particular error need be logged only a defined number of times for the automatic error log analysis to determine that service activity is needed, the device d[...]

The example also shows that, during any six hour period, no more than three errors of this type are sent to the error log. If other types of error occur for this device, or errors occur for another device, they are sent immediately to the error log. The actual threshold values that are used for any given error type are regularly reviewed, and might[...]

If SD/6000 is installed on the system, it runs error log analysis whenever a hardware error is logged, and raises an incident if problems are found that need service activity . Detailed Description Error log analysis determines whether the data that is in the error log indicates that service activity is needed on the subsystem. The analysis uses th[...]

error log analysis that is related to a period longer than 24 hours, use the ssa_ela command (see “ Command Line Error Log Analysis ” on page 232). If the detail data field for the error record contains SCSI sense data: v SSA_DISK_ERR2 or SSA_DISK_ERR3 type errors do not generate an SRN. v DISK_ERR1 or DISK_ERR4 type errors (media errors) gener[...]

Command Line Error Log Analysis A command line utility has been provided that allows you to run SSA error log analysis from a manually-entered command or from shell scripts. The utility is ssa_ela. It can perform SSA error log analysis on: v All SSA devices v A selected hdisk v A selected pdisk v A selected adapter v Any of the above items for a hi[...]

Good Housekeeping The items described here can help you ensure that your SSA subsystem works correctly . v When you are installing your SSA subsystem, ensure that ssa_adm is set to an address that is suitable for your installation. v Regularly view the mail messages or OPMSGs that are in the error log, to determine whether the automatic error log a[...]

234 User ’ s Guide and Maintenance Information[...]

Chapter 12. Using the SSA Command Line Interface for RAID Configurations Y ou can use the ssaraid command from the command line instead of the from the SMIT panels (see Chapter 6, “ Using the RAID Array Configurator ” on page 57) to configure and manage your arrays. The Command Line Interface includes a README file that explains the syntax for [...]

v List the objects that have support from a particular RAID manager: – List all the types of array objects. – List all the types of objects that can be created. – List all types of object. Notes about the ssaraid Command: 1. Y ou can specify RAID object names (arrays or member disk drives) as either the 15-character connection location, or as[...]

Command Syntax ssaraid -? ssaraid -M [-o] [-l RaidManager] ssaraid -l RaidManager [-n Name [-m|-p|-x|-e] | -t ObjectType [-r Name] [-c]] ssaraid -I -l RaidManager [-n Name [-m|-p|-x|-e] | -t ObjectType [-r Name] [-c]] [-a Attribute=Value]...[-o|-z[-h] | -S[-o]] ssaraid -C -l RaidManager -t CreateType -s Member [Member]... [-a Attribute=Value]... [-[...]

Options Y ou can use the following options with the ssaraid command: Option Description -? Print a short usage message. -A Perform an action on an object. -C Create an object. -D Delete an object. -H Change an object. -I Report information on an object. -M List all the available SSA RAID managers that are on the system. -S Show the hot spare pool i[...]

Examples For the examples given here, assume that the following items of hardware are available in the system: v A RAID Manager named ssa0 v Four SSA physical disks named pdisk0, pdisk1, pdisk2, and pdisk3 Example 1: T o Create a RAID-0 Array This example shows how to use three SSA physical disks to create a RAID-0 array . The attributes of the dis[...]

Example 3: T o Create a RAID-5 Array This example shows how to use three SSA physical disks to create a RAID-5 array . The attributes of the disks are all set to their default values. T ype the command: > ssaraid -C -l ssa0 -t raid_5 -s pdisk0 pdisk1 pdisk2 -d where: -C specifies that this operation is a create operation. -l ssa0 specifies that [...]

Example 5: T o Create a Hot Spare Pool This example shows how to create a hot spare pool that contains an array member disk drive and a hot spare disk drive. The attributes of the disks are all set to their default values. T ype the command: > ssaraid -C -l ssa0 -t spare_pool -n pool_B1 -s pdisk0 pdisk3 where: -C specifies that this operation is[...]

Example 7: T o Change an Attribute of an Object This example shows how to change an attribute of an object; for example, to change the new array so that it does not automatically call a hot spare disk drive if one of its member disk drives goes into the Offline state. T ype the command: > ssaraid -H -l ssa0 -n hdisk5 -a spare=false where: -H spe[...]

Example 9: T o Make a New System Disk This example shows how use a single SSA disk to make a new system disk. T ype the command: > ssaraid -H -l ssa0 -n pdisk0 -a use=system -d where: -H specifies that this operation is a change operation. -l ssa0 specifies the RAID manager that is to be used. -n pdisk specifies the pdisk that is to be changed t[...]

SSARAID Command Attributes When using the ssaraid command, you can specify the following types of attribute: v RAID array Creation and Change attributes v RAID array Change attributes v Physical Disk Drive Change attributes v Action attributes RAID Arrays Creation and Change Attributes This section describes the creation and change attributes that [...]

bypass_cache_if_oneway=true/false (default=false) With the attribute set to true : If the partner fast-write cache becomes not available, the fast-write cache operations to this disk drive are disabled, and an entry is made in the error log. With the attribute set to false : If the partner fast-write cache becomes not available, fast-write operatio[...]

read_only_when_exposed=true/false (default=false) With the attribute set to false : If the array enters the Exposed state, and write operations are made to the array: v The first write operation causes the array to enter the Degraded state. The written data is not protected. If another disk drive in the array fails, or the power fails during a writ[...]

Creation and Change Attributes for RAID-1 and RAID-10 Arrays Only Y ou can specify the following attributes with the -a option when you are using the ssaraid command with the -C or -H option to create or change a RAID-1 or RAID-10 array: split_resolution=primary/secondary (default=primary) This attribute selects the copy of the data that is to rema[...]

Creation and Change Attribute for RAID-5 Arrays Only Y ou can specify the following attribute with the -a option when you are using the ssaraid command with the -C option to create a RAID-5 array: fw_max_length (default=128 x (n-1), where n is the number of member disk drives in the array) This attribute sets the maximum size, in blocks, of write o[...]

force=yes/no If an array is using a fast-write cache that is failing, you must specify this attribute as yes to allow the fast-write cache to be disabled. Hot Spare Pool Creation and Change Attribute Y ou can specify the following attribute with the -a option when you are using the ssaraid command with the -C or -H option to create or change a hot [...]

Other Change Attributes for Physical Disk Drives Y ou can specify the following attributes with the -a option when you are using the ssaraid command with the -H option to change a physical disk drive. use=system/spare/free With the attribute set to system : The physical disk drive can be used directly by the operating system. If you specify also th[...]

fw_max_length (default=128) This attribute sets the maximum size, in blocks, of write operations to the fast-write cache. Write operations that are larger than the specified value write data directly to the disk, and do not use the fast-write cache. force=yes/no If a disk is using a fast-write cache that is failing, you must specify this attribute [...]

Couple Action Attributes (RAID-1 and RAID-10 Only) Y ou can specify the following attributes with the -a option when you are using the ssaraid command with the -A and -i couple options to do actions on a RAID-1 or RAID-10 array . raid_copy=copy This attribute specifies the name that you have given to the existing RAID copy that you are going to use[...]

Return Codes Code Description 0 Successful. 1 Some changes made, but finally not successful. 2 General problem accessing the object data manager (ODM). 3 Specified object (file, record, ODM object) not found. 4 Heap allocation failed. 5 Open/ioctl failure for RAID manager . 6 Bad T ransaction result. 7 Array already known to cfgmgr . 8 System call [...]

254 User ’ s Guide and Maintenance Information[...]

Chapter 13. Using the Programming Interface SSA Subsystem Overview Device Drivers T wo types of device driver provide support for all SSA subsystems: v The SSA adapter device driver , which deals with the SSA adapter . v The SSA head device drivers, which deal with devices that are attached to the SSA adapter . The SSA disk device driver is an exam[...]

Interface between the SSA Adapter Device Driver and Head Device Driver T o communicate with the SSA adapter device driver , the SSA head device driver: 1. Uses the fp_open kernel service to open the required instance of the SSA adapter device driver . 2. Calls the fp_ioctl kernel service to issue the SSA_GET_ENTRY_POINT operation to the opened adap[...]

SSA Adapter Device Driver Purpose T o provide support for the SSA adapter . Syntax #include /usr/include/sys/ssa.h #include /usr/include/sys/devinfo.h Description The /dev/ssa n special files provide an interface that allows client application programs to access SSA adapters and the SSA devices that are connected to those adapters. Multiple-head de[...]

intr_priority Holds the value of the interrupt priority that the SSA adapter device driver for this adapter will use. daemon Specifies whether to start the SSA adapter daemon. If the attribute is set to TRUE, the daemon is started when the adapter is configured. The daemon holds the adapter device driver open although the operating system might not[...]

Y ou can use the open or the openx subroutine call to open the SSA adapter device driver . If you use the openx subroutine call, set the ext parameter to 0, because the call does not use it. Summary of SSA Error Conditions If an open or ioctl subroutine that has been issued to an SSA adapter fails, the subroutine returns -1, and the global variable[...]

Files /dev/ssa0, /dev/ssa1,..., /dev/ssa n Provide an interface to allow SSA head device drivers to access SSA devices or adapters. 260 User ’ s Guide and Maintenance Information[...]

IOCINFO (Device Information) SSA Adapter Device Driver ioctl Operation Purpose T o return a structure that is defined in the /usr/include/sys/devinfo.h file. Description The IOCINFO ioctl operation returns a structure that is defined in the /usr/include/sys/devinfo.h header file. The caller supplies the address to an area that is of the type struct[...]

SSA_TRANSACTION SSA Adapter Device Driver ioctl Operation Purpose T o send an SSA transaction to an SSA adapter . Description The SSA_TRANSACTION operation allows the caller to issue an IPN (Independent Packet Network) transaction to a selected SSA adapter . IPN is the language that is used to communicate with the SSA adapter . The caller must be r[...]

TimeOutPeriod Number of seconds after which the transaction is considered to have failed. A value of 0 indicates no time limit. Note: If an operation takes longer to complete than the specified time-out, the adapter is reset to purge the command. Attention: This is a very low-level interface. It is for use only by configuration methods and diagnost[...]

SSA_GET_ENTR Y_POINT SSA Adapter Device Driver ioctl Operation Purpose T o allow another kernel extension, typically a SSA head device driver , to determine the direct call entry point for the SSA adapter device driver . This operation is the entry point through which the head device driver communicates with the adapter device driver . The address [...]

SSA Adapter Device Driver Direct Call Entry Point Purpose T o allow another kernel extension to send transactions to the SSA adapter device driver . This function is not valid for a user process. When the function completes its run, an off-level interrupt notifies the caller . See SSA_GET_ENTRY_POINT SSA adapter ioctl operation. Description The ent[...]

ssadisk SSA Disk Device Driver Purpose T o provide support for Serial Storage Architecture (SSA) disk drives. Syntax #include <sys/devinfo.h> #include <sys/ssa.h> #include <sys/ssadisk.h> Configuration Issues SSA Logical Disks, SSA Physical Disks, and SSA RAID Arrays Serial Storage Architecture (SSA) disk drives are represented in[...]

Multiple Adapters Some SSA subsystems (see “ Rules for SSA Loops ” on page 22) allow a disk drive to be controlled by up to two adapters in a particular using system. The disk drive has, therefore, two paths to each using system, and the SSA subsystem can continue to function if an adapter fails. If an adapter fails or the disk drive cannot be [...]

Fencing is provided as an alternative method for controlling access to disks that are connected to multiple using systems. The PCI SSA Multi-Initiator/RAID EL Adapter , the Micro Channel SSA Multi-Initiator/RAID EL Adapter , and the Advanced SerialRAID Adapter can reserve to a node number rather than to an adapter (see “ Reserving Disk Drives ”[...]

Using mkdev to Configure a Physical Disk T o use mkdev to configure an SSA physical disk, specify the following information: Parent ssar Class pdisk Subclass ssar T ype Y ou can list the types by typing: lsdev -P -c pdisk -s ssar ConnectionLocation 15-character unique identifier of the disk drive. Y ou can determine the unique identifier in three w[...]

v Construct the 15-character unique identifier from the 12-character SSA UID that is shown on the label that is on the side of the disk drive. Y ou can recognize the UID by its three-character suffix “ 00D ” . v Run the ssacand command, and specify the adapter to which the logical disk is connected. For example: ssacand -a ssa0 -L If the logica[...]

Attributes Common to SSA Logical and SSA Physical Disks adapter_a Specifies either the name of one adapter that is connected to the device, or none if no adapter is connected as adapter_a now . adapter_b Specifies either the name of one adapter that is connected to the device, or none if no adapter is connected as adapter_b now . primary_adapter Sp[...]

max_coalesce The maximum number of bytes that the SSA disk device driver attempts to transfer to or from an SSA logical disk in one operation. The default value is appropriate for most environments. For applications that perform very long sequential write operations, performance improves when data is written in blocks of 64 KB multiplied by (n-1), [...]

secondary path, if one exists. Y ou can prevent this switch by additionally specifying the SSADISK_NOSWITCH flag. This flag has support both for SSA logical disk drives and for SSA physical disk drives. Y ou cannot specify this flag and the SSADISK_SECONDAR Y flag together . SSADISK_SECONDAR Y Opens the device using the secondary adapter as the pat[...]

each side of the indicated physical so that the disk can be removed from the loop for service, and no errors are caused on the loops. This flag has support only for SSA physical disk drives. Y ou cannot specify this flag and the SSADISK_SCSIMODE flag together . SSADISK_SCSIMODE Opens an SSA physical disk in SCSI passthrough mode. This action allows[...]

v An attempt was made to open an SSA physical device that has already been opened by another process. v The target device is reserved by another initiator . EF AUL T Illegal user address. EINV AL One of the following circumstances has occurred: v The read or write subroutine supplied an nbyte parameter that is not an even multiple of the block size[...]

ENOMEM The system does not have enough real memory or enough paging space to complete the operation. ENOLCK An attempt was made to open a device in Service mode, and the device is in an SSA network that is not a loop. Special Files The ssadisk device driver uses raw and block special files to perform its functions. Attention: Corruption of data, lo[...]

IOCINFO (Device Information) SSA Disk Device Driver ioctl Operation Purpose T o return a structure that is defined in the /usr/include/sys/devinfo.h file. Description The IOCINFO operation returns a structure that is defined in the /usr/include/sys/devinfo.h header file. The caller supplies the address to an area of type struct devinfo in the arg p[...]

SSADISK_ISAL_CMD (ISAL Command) SSA Disk Device Driver ioctl Operation Purpose T o provide a method of sending Independent Network Storage Access Language (ISAL) commands to an SSA physical or logical disk drive. ISAL consists of a set of commands that allow a program to control and access a storage device. The ISAL command set is described in the [...]

The SSADISK_ISAL_CMD ioctl uses the following fields of the ssadisk_ioctl_parms structure: dsb Contains the directive status byte that is returned for the command. The byte contains a value from the /usr/include/ipn/ipndef.h file. A non-zero value indicates an error . result Contains the Independent Packet Network (IPN) result word that is returned[...]

Files /dev/pdisk0, /dev/pdisk1, ..., /dev/pdisk n Provide an interface to allow SSA device drivers to access SSA physical disk drives. /dev/hdisk0, /dev/hdisk1,..., /dev/hdisk n Provide an interface to allow SSA device drivers to access SSA logical disk drives. 280 User ’ s Guide and Maintenance Information[...]

SSADISK_ISALMgr_CMD (ISAL Manager Command) SSA Disk Device Driver ioctl Operation Purpose T o provide a method of sending Independent Network Storage Access Language (ISAL) Manager commands to an SSA physical or logical disk drive. ISAL consists of a set of commands that allow a program to control and access a storage device. The ISAL command set i[...]

u0.isal.status_descriptor Set by the caller to indicate the buffer for status data. u0.isal.minor_function Set by the caller to one of the ISAL Manager Commands that is defined in the /usr/include/ipn/ipnsal.h file and listed at the start of the description of this operation. Note: Structures are provided in the /usr/include/ipn/ipnsal.h file. This[...]

SSADISK_SCSI_CMD (SCSI Command) SSA Disk Device Driver ioctl Operation Purpose T o provide a method of sending Serial Storage Architecture - Small Computer Systems Interface (SSA-SCSI) commands to an SSA physical disk drive that has been opened with the SSADISK_SCSIMODE extension flag. Description The SSADISK_SCSI_CMD operation allows the caller to[...]

u0.scsi.cdb_length Set by the caller to indicate the length of the CDB. u0.scsi.scsi_status Contains the SCSI status that is returned for the command. The device driver does not know the contents of the CDB. The driver only passes on the CDB to the hardware. See the relevant hardware documentation to determine what CDBs are valid for a particular S[...]

SSADISK_LIST_PDISKS SSA Disk Device Driver ioctl Operation Purpose T o provide a method of determining which SSA physical disk drives make up a SSA logical disk drive. Description The SSADISK_LIST_PDISKS operation can be issued by any user to an SSA logical disk (hdisk). The operation returns a list of the SSA physical disks (pdisks) that make up t[...]

Return V alues If the command was successfully sent to the adapter card, this operation returns a value of 0. Otherwise, a value of -1 is returned, and the errno global variable is set to one of the following values: EIO An unrecoverable I/O error has occurred. ENOMEN The device driver was unable to allocate or pin enough memory to complete the ope[...]

SSA Disk Concurrent Mode of Operation Interface The SSA subsystem provides support for the broadcast of one-byte message codes from one using system to all other using systems that are connected to the same disk drive. This ability to pass messages can be used to synchronize access to the disk drive. The operating system has a concurrent mode inter[...]

DD_CONC_TEST Issues a test disk command to verify that the SSA disk drive is still accessible to this using system. The concurrent mode entry point returns a value of EINV AL if any of the following is true: v The top kernel extension did not perform a DD_CONC_REGISTER operation. v The conc_cmd pointer is null. v The devno field in the conc_cmd str[...]

error field of the conc_cmd structure contains the return code that is necessary for the completion of this command. The possible values are defined in the /usr/include/sys/errno.h file. The conc_cmd pointer argument to the special interrupt handler entry point of the top kernel extension is non-null. The cmd_op , message_code , and devno fields ar[...]

SSA Disk Fencing SSA disk fencing is a facility that is provided in the SSA subsystem. It allows multiple using systems to control access to a common set of disks. Using the fencing commands that are provided by the hardware, you can prevent particular using systems from accessing a particular disk drive. Each disk drive has an access list that is [...]

SSADISK_FORCED_OPEN to the openx subroutine, the reservation is broken, but the open fails with errno set to ENOCONNECT . T o break through the fence, the SSA logical disk must be opened in SSADISK_FENCEMODE and the SSADISK_ISALCMD ioctl operation used to issue the appropriate hardware command to break the fence condition. SSA T arget Mode The SSA [...]

between the adapters fails. The tmssa device driver automatically switches to adapters ssa1 and ssa3 or adapters ssa1 and ssa4. The connections between nodes can be modified while they are in use, and the target-mode interface tries to recover . The TMSSA uses either of two methods to read and write data: v The blocking method, which waits until th[...]

When configuration is complete, special files exist in the /dev directory . These files allow you to use the target mode interface with each node that is defined in the configuration database. Configuration does not need communication to be actually possible between the relevant using systems. Communication is needed only for the write operation. B[...]

amount of data that is being sent. For example, to write 64 KB of data with no retry operations, you need 64 KB read and write buffers. If you allow one retry operation, you need only 32 KB buffers. Using SSA T arget Mode SSA T arget Mode does not attempt to manage the data transfer between devices. It does, however , take action if buffers become [...]

SSA tmssa Device Driver Purpose T o provide support for using-system to using-system communications through the SSA target-mode device driver . Syntax #include /usr/include/sys/devinfo.h #include /usr/include/sys/tmscsi.h #include /usr/include/sys/scsi.h #include /usr/include/sys/tmssa.h Description The Serial Storage Architecture (SSA) target-mode[...]

The calling program must observe any other rules that are needed to maintain, or otherwise manage, the communication of data. Delays that occur when data is received or sent through the target mode device driver are that are characteristics of the hardware and software driver environment. Configuration Information When tmssa n is configured (where [...]

EINV AL Attempted to run an open subroutine for a device instance, but either a wrong open flag was used, or the device is not yet configured. EIO An I/O error occurred. ENOMEM The SSA device does not have enough memory resources. close Subroutine The close subroutine deallocates resources that are local to the target device driver for the target o[...]

any time, the device driver does not maintain an internal timer to interrupt the read. Therefore, if a time-out function is required, it must be started by the calling program. If the calling program wants to break a blocked read subroutine, the program can generate a signal. The target-mode device driver receives the signal and ends the current re[...]

write subroutine Support for the write entry point is provided only for the initiator-mode device driver . The write entry point generates one write operation in response to a calling program write request. If the device is opened with the O_NDELA Y flag set, and the write request is for a length that is greater than the total buffer size of the de[...]

timeout_value = ((transfer_length / 65536) + 1) * 20 In the calculation, 20 is the default scaling factor that generates the time-out value. The caller can customize the time-out value through the TMCHGIMP ARM operation. The actual period that elapses before a time-out occurs can be up to 10 seconds longer than the calculated value, because it is r[...]

ioctl Subroutine The following ioctl operations are provided by the target-mode device driver . Some are specific to either the target-mode device or the initiator-mode device. All require the respective device instance be open for the operation run. IOCINFO Returns a structure defined in the /usr/include/sys/devinfo.h file. TMCHGIMP ARM Allows the[...]

The POLLIN event is indicated by the device driver when any data is received for this target instance. A nonblocking read subroutine, if subsequently issued by the caller , returns data. For a blocking read subroutine, the read does not return until either the requested length is received, or the write operation ends, whichever comes first. Asynchr[...]

v A hardware error that has not been recovered v A software error that has been detected by the device driver The target-mode device driver passes error-recovery responsibility for all detected errors to the caller . For these errors, the target-mode device driver does not know if this type of error is permanent or temporary . These types of errors[...]

tmssa Special File Purpose T o provide access to the SSA tmssa device driver . Description The Serial Storage Architecture (SSA) target-mode device driver provides an interface that allows the SSA interface to be used for data transfer from using system to using system. Y ou can access the data transfer functions through character special files tha[...]

IOCINFO (Device Information) tmssa Device Driver ioctl Operation Purpose T o return information about the device in a structure that is defined in the /usr/include/sys/devinfo.h file. Description This operation allows you to supply a pointer to the address of an area of type struct devinfo in the arg parameter to the IOCINFO operation. This structu[...]

Use TM_GetDevinfoNodeNum( ) to read the node number from which the data is received. The remainder of the structure is filled as follows: devtype DD_TMSCSI. flags Set to zero. devsubtype DS_TM. 306 User ’ s Guide and Maintenance Information[...]

TMIOST A T (Status) tmssa Device Driver ioctl Operation Purpose T o allow the caller to put the status information for the current or previous write operation into a structure that is defined in the /usr/include/sys/tmscsi.h file. Description This operation returns information about the last write operation. Because a nonblocking write operation mi[...]

TMCHGIMP ARM (Change Parameters) tmssa Device Driver ioctl Operation Purpose T o allow the caller to change the retry parameter and the time out parameter that are used by the target-mode device driver . Description This operation allows the caller to change the default set up of the device. It is allowed only for the initiator-mode device. The arg[...]

Regardless of the value of the timeout_type field, if the new_timeout field is set to a value of 0, the caller specifies “ no time out ” for the send command, allowing the command to take an indefinite amount of time. If the calling program wants to end a write operation, it generates a signal. This option is allowed only for blocking-type writ[...]

310 User ’ s Guide and Maintenance Information[...]

Part 2. Maintenance Information 31 1[...]

312 User ’ s Guide and Maintenance Information[...]

Chapter 14. SSA Adapter Information For a description of the SSA adapter , port addresses, and the rules for SSA loops, see Chapter 1, “ Introducing SSA and the Advanced SerialRAID Adapters ” . Installing the SSA Adapter 1. Install the adapter and disk drive microcode from the media that are supplied with the adapter . A README sheet of install[...]

The second entry instructs the run_ssa_healthcheck shell script to run once each hour . This shell script causes the SSA adapter to log any errors that might exist in the SSA subsystem, but that are not causing application programs to fail. The third entry instructs the run_ssa_encl_healthcheck shell script to run at 30 minutes past each hour . Thi[...]

Diagnostic Information for Multiple Bus Systems manual). The microcode level is shown in the ROS level field. Alternatively , give the following command: lscfg -v1 adapter where adapter is the ID of the adapter that you want to check. Y ou can determine the disk drive microcode level by using the Display/Download Disk Drive Microcode SSA service ai[...]

Vital Product Data (VPD) for the SSA Adapter The vital product data (VPD) for the SSA adapter can be displayed by using the using-system service aids. This section shows the types of information that are contained in the VPD. Part number The part number of the adapter card. FRU number The part number of the adapter card field-replaceable unit (FRU)[...]

Adapter Power-On Self-T ests (POST s) Power-on self-tests (POST s) are resident in the SSA adapter . These tests ensure that the adapter does not run the functional code until the hardware that uses the code has been tested. The hardware consists of only the adapter card, memory module, and, if installed, Fast-Write Cache Option Card and battery . [...]

318 User ’ s Guide and Maintenance Information[...]

Chapter 15. Removal and Replacement Procedures Exchanging Disk Drives 1. If you are removing a disk drive under concurrent maintenance (see the service information for the device that contains the disk drive), you must first determine which hdisk is using the pdisk that you want to remove. T o do this, you can either use the Configuration V erifica[...]

SSA RAID Arrays Move cursor to desired item and press Enter. List All Defined SSA RAID Arrays List All Supported SSA RAID Arrays List All SSA RAID Arrays Connected to a RAID Manager List Status Of All Defined SSA RAID Arrays List/Identify SSA Physical Disks List/Delete Old RAID Arrays Recorded in an SSA RAID Manager List Status of Hot Spare Pools L[...]

4. A prompt is displayed in a window: SSA RAID Arrays Move cursor to desired item and press Enter. List All Defined SSA RAID Arrays List All Supported SSA RAID Arrays List All SSA RAID Arrays Connected to a RAID Manager List Status Of All Defined SSA RAID Arrays List/Identify SSA Physical Disks List/Delete Old RAID Arrays Recorded in an SSA RAID Ma[...]

7. Attention: Y ou should be here only if you are working with a RAID-1, RAID-5, or RAID-10 array . For fast path, type smitty redssaraid and press Enter . Otherwise: a. Select Change Member Disks in an SSA RAID Array from the SSA RAID Array menu. b. Select Remove a Disk from an SSA RAID Array . 8. A list of arrays is displayed in a window: Change [...]

9. The following information is displayed: Remove a Disk from an SSA RAID Array Type or select values in entry fields. Press Enter AFTER making all desired changes. Entry Fields SSA RAID Manager ssa0 SSA RAID Array hdisk3 Connection Address / Array Name 095231779F0737K * Disk to Remove + F1=Help F2=Refresh F3=Cancel F4=List F5=Reset F6=Command F7=E[...]

17. On each using system to which this replacement disk drive is connected, you must now remove from the system configuration the reference to the pdisk that you have just removed. Attention: If the disk drive is connected to more than one using system, the pdisk and hdisk numbers might be different on each system. If you are not sure what the pdis[...]

23. If the disk drive that you are installing is a replacement for a disk drive that was a member of an SSA RAID array , go to step 24. Otherwise, go no further with these instructions. 24. T ype smitty ssaraid and press Enter . 25. Select Change/Show Use of an SSA Physical Disk . The pdisk that has been exchanged is listed under SSA Physical Disks[...]

Changing Pdisk and Hdisk Numbers Pdisk and hdisk numbers are assigned automatically when the using system is configured. T o help in system administration, it is sometimes useful to change these numbers. If you want to change the numbers, use the following procedure: 1. Find the pdisk or hdisk number that you want to change, and select a new (unuse[...]

Removing and Replacing an Advanced SerialRAID Adapter Attention: The adapter assembly contains parts that are electrostatic-discharge (ESD) sensitive. Use the tools and procedures defined by your organization to protect such parts. 1. Remove the adapter from the using system (see the Installation and Service Guide for the using system). 2. If you a[...]

If you cannot do this procedure because, for example, the boot disks are on the SSA network, do the following: a. Run diagnostics to the SSA adapter that is on the partner system, to ensure that no array problems exist. b. Wait until all coupled disk drives can be uncoupled, before you connect the new adapter to the network. 6. Install the adapter [...]

Removing an SDRAM Module of an Advanced SerialRAID Adapter Attention: The adapter assembly contains parts that are electrostatic-discharge (ESD) sensitive. Use the tools and procedures defined by your organization to protect such parts. 1. Remove the adapter from the using system (see the Installation and Service Guide for the using system). 2. Ref[...]

Installing an SDRAM Module of an Advanced SerialRAID Adapter Attention: v The adapter assembly contains parts that are electrostatic-discharge (ESD) sensitive. Use the tools and procedures defined by your organization to protect such parts. v If you are exchanging a new SDRAM for a failed SDRAM, ensure that new SDRAM is the same size as the old SDR[...]

4. Refer to Figure 45. 5. Carefully insert the SDRAM module into the connector . 6. Press strongly on the module until it is fully home. 7. Close the clips 1 by pivoting them in the directions shown by the arrows in the diagram. Y ou hear a click when the clips are fully closed. If you cannot close the clips, the module is not fully home. Pre[...]

Removing the Fast-Write Cache Option Card of an Advanced SerialRAID Adapter Attention: v The adapter assembly contains parts that are electrostatic-discharge (ESD) sensitive. Use the tools and procedures defined by your organization to protect such parts. v The Fast-Write Cache Option card might contain customer data. 1. Remove the adapter from the[...]

5. Refer to Figure 47. 6. Invert the adapter card, so that its components are upward. 7. Carefully unplug the Fast-Write Cache Option card 2 from the connector 1 . 1 2 Figure 47. Removing the Fast-Write Cache Option Card Chapter 15. Removal and Replacement Procedures 333[...]

Installing the Fast-Write Cache Option Card of an Advanced SerialRAID Adapter Attention: The adapter card contains parts that are electrostatic-discharge (ESD) sensitive. Use the tools and procedures defined by your organization to protect such parts. 1. Remove the adapter from the using system, if not already removed (see the Installation and Serv[...]

6. Refer to Figure 49. 7. Install the mounting screw 1 , and tighten it fully . (The screw is supplied with the Fast-Write Cache Option Card.) 8. Reinstall the adapter into the using system (see the Installation and Service Guide for the using system). Note: The battery on the Fast-Write Option Card is not fully charged. After the adapter is [...]

Removing the Battery Assembly from the Fast-Write Cache Option Card of an Advanced SerialRAID Adapter Attention: v The adapter assembly contains parts that are electrostatic-discharge (ESD) sensitive. Use the tools and procedures defined by your organization to protect such parts. v The Fast-Write Cache Option card might contain customer data. 1. R[...]

6. Refer to Figure 51. 7. Invert the Fast-Write Cache Option card. 8. Carefully unplug the battery assembly from the connector 1 . 1 Figure 51. Disconnecting the Battery Assembly Chapter 15. Removal and Replacement Procedures 337[...]

Installing a Battery Assembly into the Fast-Write Cache Option Card of an Advanced SerialRAID Adapter Attention: v The adapter assembly contains parts that are electrostatic-discharge (ESD) sensitive. Use the tools and procedures defined by your organization to protect such parts. v The Fast-Write Cache Option card might contain customer data. 1. R[...]

4. Refer to Figure 53. 5. Locate the battery assembly so that the two lugs 1 are under the edges of the small slots 2 , and the clip 3 is over the larger slot 4 . 6. Carefully press the battery assembly downward until the clip latches under the edge of the slot. 7. Reinstall the Fast-Write Cache Option card (see “ Installi[...]

Part Numbers v Advanced SerialRAID Adapter card without SDRAM module and without Fast-Write Cache Option card: 09L2090 v 64 MB module: 09L2104 v 128 MB module: 08J0663 v Fast-Write Cache Option Card: 09L2105 v Fast-write cache battery: 09L5609 340 User ’ s Guide and Maintenance Information[...]

Chapter 16. Using the SSA Command Line Utilities The commands that are described here allow you to get access from the command line to some of the functions that are available in the SSA service aids. The commands are very simple and are intended for use mainly from within shell scripts. They do not provide many error checking routines or error mes[...]

-t This optional flag allows new levels of microcode to be tested. The enclosure returns to the original level of microcode if the enclosure power is switched off, then switched on. Examples T o install the latest level of microcode on all available SES enclosures, give the command: ssa_sesdld -u T o install microcode file coral1014.hex on enclosur[...]

ssaadap Command Purpose T o list the adapters to which a logical disk or physical disk is connected. Syntax ssaadap -l LogicalDiskName ssaadap -l PhysicalDiskName Description The output is the list of SSA adapters to which the logical or physical disk is connected. If the list contains more than one adapter , the first adapter in the list is the pr[...]

ssacand Command Purpose T o display the unused connection locations for an SSA adapter . Syntax ssacand -a AdapterName -P|-L Description The ssacand command lists the available connection locations of an SSA adapter . These connection locations are related to disk drives that, although connected to the adapter , are not yet configured as system dis[...]

ssa_certify Command Purpose v T o certify the physical disk drive so that data can be read from, or written to, the disk drive without problems. v T o certify a RAID-5 array to determine whether any array logical block addresses (LBAs) have been as unreadable. Syntax ssa_certify -l pdisk [-n MaxReadSize] [-a] ssa_certify -l hdisk [-b StartLBA] [-c][...]

reassign operations. Y ou must not use this flag when the ssa_certify command is running concurrently on an active using system. -n MaxReadSize Specifies the maximum size, in kilobytes, of each read command that is sent to the disk drive. Default size for this flag = 3072 kilobytes Minimum value that can be specified for this flag = 64 kilobytes Ma[...]

ssaconn Command Purpose T o display the SSA connection details for the physical disk. Syntax ssaconn -l PhysicalDiskName -a AdapterName Description The ssaconn command performs a function that is similar to the Link V erification service aid. The output from this command is: PhysicalDiskName AdapterName hopcount1 hopcount2 hopcount3 hopcount4 The f[...]

ssa_diag Command Purpose T o run diagnostic tests to a specified device. Syntax ssa_diag -l pdiskX ssa_diag -l ssaX Description The ssa_diag command is in /usr/lpp/diagnostics/bin. Flags -a Causes the adapter to be reset if the device that is being tested is an adapter . This flag has no effect if the device is a disk drive. -u Forces a disk reserv[...]

ssadisk Command Purpose T o display the names of disk drives that are connected to an SSA adapter . Syntax ssadisk -a AdapterName -P|-L Description The ssadisk command lists the names of disk drives that are connected to an SSA adapter . These names are related to devices that are in the customized device data base, and have the SSA adapter as thei[...]

ssadload Command Purpose T o download microcode to SSA physical disk drives. Syntax ssadload -d PhysicalDiskName -f CodeFileName [-p] ssadload -u [-d PhysicalDiskName | -a adapter ] [-p] ssadload -s [-d PhysicalDiskName | -a adapter ] Description The ssadload command performs microcode downloads to SSA physical disk drives. The command has three mo[...]

Flags -d PhysicalDiskName Specifies the physical disk drive that is to receive the microcode. -f CodeFileName Specifies the microcode file to be downloaded. -u Ensures that all SSA physical disk drives are loaded with the latest level of microcode that is available on the system. By default, this flag ensures that all SSA physical disk drives are l[...]

v Using the -s and -a adapter flags: ssadload -s -a ssa0 With these flags, the command lists the existing levels of microcode of all the available disk drives that are connected to adapter ssa0. v Using the -u, -a adapter , and -p flags: ssadload -u -a ssa0 -p & ; ssadload -u -a ssa1 -p With these flags, the command causes the update mechanism [...]

ssa_ela Command Purpose T o look for the most significant error in the error log. Syntax ssa_ela ssa_ela -l Device [-h timeperiod] ssa_ela -l pdisk ssa_ela -l hdisk ssa_ela -l adapter Description The ssa_ela command (with no flags) scans the error log, and looks for all SSA errors. The command returns a list that contains one SRN for each SSA devic[...]

Output If an error occurs, the ssa_ela command sends an error message to stdout, such as: ssa0 SRN 42500 If no error occurs, the command sends no message to stdout. A non-zero return code indicates an error . The command sends an error message to stderr . 354 User ’ s Guide and Maintenance Information[...]

ssaencl Command Purpose T o allow the monitoring and changing of the status for SSA SES disk enclosures (subsystems). Syntax T o display enclosure component settings: ssaencl -l name [-s] [-v] [-i] [-r] [-b [card ...]] [-t [threshold ...]] [-a] [-f [fan ...]] [-d [drive_bay ...]] [-p [PSU ...]] [-o] [-c] [-e] T o modify enclosure component settings[...]

-t [threshold] Displays all the temperature thresholds, or only the specified temperature thresholds. The valid values for the [threshold] parameter are: lowarn The low-temperature warning threshold. locrit The low-temperature critical threshold. hiwarn The high-temperature warning threshold. hicrit The high-temperature critical threshold. -a Displ[...]

-S b[card ...] Resets the flag for the bypass card. V alid values for card are 1, 4, 5, 8, 9, 12, 13, 16. -S p[PSU ...] Resets the flag for the selected PSU (power supply assembly). V alid values for PSU are 1, 2. -S r Resets the flag for remote power on (RPO). -S c Resets the flag for the controller card. -S o Resets the flag for the operator pane[...]

ssa_format Command Purpose T o format the specified device. Syntax ssa_format -l pdisk or ssa_format -l SSA_Adapter [-b] Description The ssa_format -l pdisk command opens the pdisk special file, and uses the ISAL Format command to format the device. Y ou can close the device while the format operation is running. If the command cannot format the de[...]

-b Specifies that the battery-age counter be reset. When this flag is used, the data on the Fast-Write Cache Option Card is not set to zero. Important: Do not select the -b flag unless you have exchanged the battery . Otherwise, no error message will occur when the battery reaches the end of its life. Output The ssa_format command sends all error m[...]

ssa_fw_status Command Purpose T o show the status of the fast-write cache. Syntax ssa_fw_status -a Adapter [-p|-l|-c] Description The ssa_fw_status command displays the status of the fast-write cache of an SSA adapter . Flags -a Adapter Shows all fast-write status for the specific adapter . -l Displays the expected life of the battery . -p Displays[...]

ssa_getdump Command Purpose T o display SSA adapter dump locations, and to save the dump to a specified location. Syntax For the List version of the command: ssa_getdump -l [-h] [-d pdiskxx] [-a AdapterName | -n AdapterUID | -s SlotNumber ] For the Copy version of the command: ssa_getdump -c [-h] -d pdiskxx {-a AdapterName | -n AdapterUID | -s Slot[...]

Flags The ssa_getdump command uses several types of flag: v Required flags for both modes v Required flags for Copy mode v Optional flags for List mode v Optional flags for Copy mode Required Flags for Both Modes Yo u must use one of these flags: -l Specifies that the program is to operate in List mode. The program searches for dumps. -c Specifies [...]

-a AdapterName Specifies the adapter name for which the program must search (for example, ssa1). The adapter must be known to the searching machine. -n AdapterUID Specifies the adapter UID for which the program must search. The adapter need not be known to the searching machine. -s SlotNumber Specifies the slot that contains the disk drive, as show[...]

ssaidentify Command Purpose T o set or clear Identify mode for a physical disk. Syntax ssaidentify -l PhysicalDiskName -y ssaidentify -l PhysicalDiskName -n Description If the -y parameter is specified, the disk is set into Identify mode. While the disk is in Identify mode, its amber Ready light flashes at approximately one-second intervals. The -n[...]

ssa_progress Command Purpose T o show how much (by percentage) of a format operation has been completed, and to show the status of the format operation. The status can be “ Complete ” , “ Formatting ” ,o r “ Failed ” . Syntax ssa_progress -l pdisk Description The ssa_progress command opens the pdisk special file, and uses the ISAL Progr[...]

ssa_rescheck Command Purpose T o report the reservation status of an hdisk. Syntax ssa_rescheck -l hdisk [-h] Description The ssa_rescheck command tests the access paths to the specified hdisk. It checks whether the disk is reserved. If the disk is reserved, the command attempts to determine why the disk is reserved. Flags -l hdisk Specifies the hd[...]

Examples The following examples show typical output from the rescheck command. The Adapter In Use field shows which adapter path the using system is using. ssa_rescheck -l hdisk1 produces this type of output: Disk Primary Secondary Adapter Primary Secondary Reserved Adapter Adapter In Use Access Access to hdisk1 ssa0 ------ ssa0 OK ----- none ssa_r[...]

ssa_servicemode Command Purpose T o put the disk drive into Service Mode (set Service Mode), or to remove the disk drive from Service Mode (reset Service Mode). Syntax ssa_servicemode -l [-a AdapterName] -y|-n Description The ssa_servicemode command opens the adapter special file, and sends the appropriate IACL command to put the disk drive into, o[...]

ssa_speed Command Purpose T o determine the operating speed of SSA links. Syntax ssa_speed -l pdisk [-s] ssa_speed -a AdapterName {-p Loop | -n Network} [-s] ssa_speed -x [-e] Description The ssa_speed command either tests the existing link speeds of the selected pdisk or adapter , or searches for link speed exceptions on all SSA adapters in the us[...]

Output The ssa_speed command sends all error messages to stderr , and output to stdout. Link speeds can be: v 20 (20 MB) v 40 (40 MB) v 00 (not operational) v ?? (not determined) Examples v T o display the link speed of pdisk0, give the command: ssa_speed -l pdisk0 v T o display the adapter link speeds of ports A1 and A2 on ssa0, give the command: [...]

ssavfynn Command Purpose T o check for duplicated node numbers. Note: It is recommended that this command be used only when all the adapters on the network are SSA RAID adapters. Syntax ssavfynn [-w] Description The ssavfynn command is in the /usr/lpp/diagnostics/bin file. It has no flags. If the ssavfynn command runs and finds no duplicate node nu[...]

ssaxlate Command Purpose T o translate between logical disks (hdisks) and physical disks (pdisks). Syntax ssaxlate -l LogicalDiskName ssaxlate -l PhysicalDiskName Description If the parameter is a logical disk, the output is a list of names of the physical disks that provide support for that logical disk. If the parameter is a physical disk, the ou[...]

Chapter 17. SSA Service Aids Note: For some problems, you can use the SSA command line utilities instead of the SSA service aids. For information about the command line utilities, see Chapter 16, “ Using the SSA Command Line Utilities ” on page 341. SSA service aids are resident in the using system. They help you to service SSA subsystems. This[...]

Note: The service aids refer to the Advanced SerialRAID Adapter as IBM SSA 160 SerialRAID Adapter (14109100). On some service screens, this name is shortened. 374 User ’ s Guide and Maintenance Information[...]

The Identify Function The Identify function can be accessed from many of the service aid menus . This function enables you to determine the location of a particular disk drive that you want to identify , but do not want to remove. When set, the Identify function causes the Check light of the disk drive to flash for identification (two seconds on, t[...]

Starting the SSA Service Aids T o start the SSA service aids: 1. Start the using-system diagnostics (see the Diagnostic Information for Multiple Bus Systems manual), and go to the Diagnostic Operating Instructions . 2. Follow the instructions to select Function Selection . 3. Select T ask Selection from the Function Selection menu. 4. Select SSA Se[...]

5. Select the service aid that you require, then go to the relevant instructions in this chapter: “ Set Service Mode Service Aid ” on page 378 “ Link V erification Service Aid ” on page 383 “ Configuration V erification Service Aid ” on page 387 “ Format Disk Service Aid ” on page 389 “ Certify Disk Service Aid ” on page 391 “[...]

Set Service Mode Service Aid The Set Service Mode service aid enables you to determine the location of a particular disk drive, and to remove that disk drive from the unit in which it is installed. It causes the Check light of that disk drive to come on for identification, and stops all SSA loop activity through the disk drive. It also causes the S[...]

T o use the Set Service Mode service aid: 1. Select Set Service Mode from the SSA Service Aids menu (see “ Starting the SSA Service Aids ” on page 376). A list of physical disk drives (pdisks) is displayed: SET SERVICE MODE 802381 Move cursor onto selection, then press <Enter>. systemname:pdisk0 AC50AE43 2GB SSA C Physical Disk Drive syst[...]

2. Select the pdisk that you want to identify or put into Service Mode (for example, pdisk3). The following display appears with details of the disk drive that you have just selected: SET SERVICE MODE 802382 systemname:pdisk0 AC50AE43 4GB SSA C Physical Disk Drive Move cursor onto selection, then press <Enter>. + Set or Reset Identify. Select[...]

3. Select Service Mode or the Identify function. (For this example, assume that you have selected Service Mode.) The list of pdisks is displayed again, and the disk drive that you selected is marked by a >, which shows that the disk drive is in Service Mode. SET SERVICE MODE 802381 Move cursor onto selection, then press <Enter>. systemname[...]

4. Select a second disk drive if required (for example, pdisk5). The following display appears again: SET SERVICE MODE 802382 systemname:pdisk5 AC7C6E51 4GB SSA C Physical Disk Drive Move cursor onto selection, then press <Enter>. + Set or Reset Identify. Select this option to set or reset the Identify indicator on the disk drive. > Set or[...]

Link V erification Service Aid The Link V erification service aid helps you determine: v Which devices are connected to the SSA loop v Where an SSA loop has been broken v The status of the disk drives on that SSA loop v The location of enclosure faults that have been detected by the disk drives on that SSA loop T o use the Link V erification servic[...]

3. When you have selected an adapter , a list is displayed that shows all the devices that are connected to the adapter: LINK VERIFICATION 802386 SSA Link Verification for: nunu:ssa0 04-02 IBM SSA 160 SerialRAID Adapter ( To Set or Reset Identify, move cursor onto selection, then press <Enter>. Physical Serial# Adapter Port A1 A2 B1 B2 Status[...]

v The Adapter Port column shows the address of each adapter port to which a particular device is connected. The device is connected to two ports except when the SSA loop is broken, under which condition the device is connected to only one port. v The Status column shows the existing status of the physical disk drive, as known by the adapter . Statu[...]

Notes: a. In the lists of physical disk drives (pdisks) that are displayed by the service aids, you might see: ????? These question marks show where an SSA loop is broken. The service aid cannot display which, if any , devices are missing from this configuration. ***** These asterisks indicate an unconfigured device; that is, an SSA device that is [...]

Configuration V erification Service Aid The Configuration V erification service aid enables you to determine the relationship between SSA logical units (hdisks) and SSA physical disk drives (pdisks). It also displays the connection information and operational status of the disk drive. Notes: 1. User applications communicate with the hdisks; error d[...]

2. Select the hdisk or pdisk that you want to verify . 3. If you select an hdisk, a list of pdisks is displayed: CONFIGURATION VERIFICATION 802391 systemname:hdisk2 AC51DB47 SSA Logical Disk Drive Good To set or reset Identify, move cursor onto selection, then press <Enter>. Physical Serial# Adapter Port SSA_Addr Status systemname:pdisk0 AC51[...]

Format Disk Service Aid The Format Disk service aid formats SSA disk drives. Attention: Formatting a disk drive destroys all the data on that disk drive. Use this procedure only when instructed to do so by the service procedures. T o use the Format Disk service aid: 1. Select Format Disk from the SSA Service Aids menu (see “ Starting the SSA Serv[...]

2. Select the pdisk that you want to format. The following instructions are displayed: FORMAT DISK 802396 systemname:pdisk2 AC1DBE11 4GB SSA C Physical Disk Drive Move cursor onto selection, then press <Enter>. + Set or Reset Identify. Select this option to set or reset the Identify indicator on the disk drive. Format. Select this option only[...]

Certify Disk Service Aid The Certify service aid verifies that all the data on a disk drive can be read correctly . Other maintenance procedures tell you when you need to run this service aid. T o use the Certify Disk service aid: 1. Select Certify Disk from the SSA Service Aids menu (see “ Starting the SSA Service Aids ” on page 376). A list o[...]

2. Select the pdisk that you want to certify . The following instructions are displayed: CERTIFY DISK 802405 systemname:pdisk0 AC706E9A 4GB SSA C Physical Disk Drive Move cursor onto selection, then press <Enter>. + Set or Reset Identify. Select this option to set or reset the Identify indicator on the disk drive. Certify. Select this option [...]

Display/Download Disk Drive Microcode Service Aid The Display/Download Disk Drive Microcode service aid allows you to: v Display the level of microcode that is installed on all available disk drives. v Change the level of microcode, for a specific available disk drive, to any level that is available in the using-system microcode directory or on dis[...]

T o use the Display/Download Disk Drive Microcode service aid: 1. Select Display/Download Disk Drive Microcode from the SSA Service Aids menu (see “ Starting the SSA Service Aids ” on page 376). The following menu is displayed: MICROCODE DOWNLOAD 802420 Move cursor onto selection, then press Enter. Display the Microcode levels of all SSA Physic[...]

3. Attention: For several seconds during microcode download, new data is written to the disk drive EEPROM. If the power fails while that data is being written, the disk drive microcode might become corrupted. The microcode cannot be corrected . Normally , exchange the disk drive for a new one. If you need to try to save data, you might be able to e[...]

Link Speed Service Aid The Link Speed service aid allows you to display the operating speed of each link on an SSA adapter . T o use the Link Speed service aid: 1. Select Link Speed from the SSA Service Aids menu (see “ Starting the SSA Service Aids ” on page 376). A list of adapters is displayed: LINK SPEED 802437 Move cursor onto selection, t[...]

2. Select the adapter that you want to inspect. A list of link speeds is displayed, as shown in this example screen: LINK SPEED 802438 SSA Link Speed for: systemname:ssa0 00-03 IBM SSA 160 SerialRAID Adapter ( To set or reset Identify, move cursor onto selection, then press <Enter>. Source Speed Destination systemname:ssa0:A1 40 systemname:pd[...]

The Source field represents the link end that is closest to the A1 or B1 port. The Destination field represents the link end that is closest to the A2 or B2 port. Note: The Source and Destination fields have no other meaning. They do not indicate data flow . The Speed field indicates the operating speed of the link as follows: 00 The link is not op[...]

This screen shows the same configuration, but here the link is broken between pdisk1 and pdisk2. LINK SPEED 802438 SSA Link Speed for: systemname:ssa0 00-03 IBM SSA 160 SerialRAID Adapter ( To set or reset Identify, move cursor onto selection, then press <Enter>. Source Speed Destination systemname:ssa0:A1 40 systemname:pdisk3 systemname:pdis[...]

Service Aid Service Request Numbers (SRNs) If the SSA service aids detect an unrecoverable error , and are unable to continue, one of the following service request numbers (SRNs) might occur: v SSA01 v SSA02 v SSA03 These SRNs are explained in the main SRN table (see “ Service Request Numbers (SRNs) ” on page 41 1). Using the Service Aids for S[...]

Example 1. Normal Loops In Figure 56, disk drives 1 through 8 are connected to connectors A1 and A2 of the SSA adapter 1 . Disk drives 9 through 12 are connected to connectors B1 and B2 of the same SSA adapter . Disk drives 13 through 16 are connected to connectors A1 and A2 of a different SSA adapter 2 . Using system Disk 1 Disk 2 Disk[...]

For this example, the Link V erification service aid displays the following information: LINK VERIFICATION 802386 SSA Link Verification for: systemname:ssa0 00-04 IBM SSA 160 SerialRAID Adapter ( To Set or Reset Identify, move cursor onto selection, then press <Enter>. Physical Serial# Adapter Port A1 A2 B1 B2 Status [TOP] systemname:pdisk11 [...]

Example 2. Broken Loop (Cable Removed) Each disk drive normally communicates with the adapter through one data path. Because data can pass round the loop in either direction, the adapter automatically reconfigures the loop to enable communication to continue to each disk drive if the loop becomes broken. In Figure 57 on page 404, disk drives 1 thro[...]

Using system Disk 1 Disk 2 Disk 3 Disk 4 Disk 5 Disk 6 Disk 7 Disk 8 Disk 16 Disk 15 Disk 14 Disk 13 Disk 12 Disk 11 Disk 10 Disk 9 Using system A1 A2 B1 B2 A1 A2 B1 B2 Figure 57. Broken Loop (Cable Removed) 404 User ’ s Guide and Maintenance Information[...]

For this example, the Link V erification service aid displays the following information: LINK VERIFICATION 802386 SSA Link Verification for: systemname:ssa0 00-04 IBM SSA 160 SerialRAID Adapter ( To Set or Reset Identify, move cursor onto selection, then press <Enter>. Physical Serial# Adapter Port A1 A2 B1 B2 Status [TOP] systemname:pdisk11 [...]

Example 3. Broken Loop (Disk Drive Removed) In Figure 58 on page 407, disk drives 1 through 8 are connected to connectors A1 and A2 of the SSA adapter 1 , but the loop is broken because disk drive number 3 has been removed. Disk drives 9 through 12 are connected to connectors B1 and B2 of the same SSA adapter . Disk drives 13 through 16 are c[...]

Using system Disk 1 Disk 2 Disk 3 Disk 4 Disk 5 Disk 6 Disk 7 Disk 8 Disk 16 Disk 15 Disk 14 Disk 13 Disk 12 Disk 11 Disk 10 Disk 9 Using system A1 A2 B1 B2 A1 A2 B1 B2 Figure 58. Broken Loop (Disk Drive Removed) Chapter 17. SSA Service Aids 407[...]

For this example, the Link V erification service aid displays the following information: LINK VERIFICATION 802386 SSA Link Verification for: systemname:ssa0 00-04 IBM SSA 160 SerialRAID Adapter ( To Set or Reset Identify, move cursor onto selection, then press <Enter>. Physical Serial# Adapter Port A1 A2 B1 B2 Status [TOP] systemname:pdisk11 [...]

Finding the Physical Location of a Device The physical location of a device (for example, a disk drive or an SSA adapter) cannot be reported directly by the using system because of the way in which the SSA interface works. The address of an SSA device is related to the position of that device on the SSA loop. The address can, therefore, change if t[...]

410 User ’ s Guide and Maintenance Information[...]

Chapter 18. SSA Problem Determination Procedures SSA problem determination procedures are provided by power-on self-tests (POST s), service request numbers, and maintenance analysis procedures (MAPs). Some of these procedures use the service aids that are described in Chapter 17, “ SSA Service Aids ” on page 373. Service Request Numbers (SRNs) [...]

2. Read carefully the “ Action ” you must do for the problem. Do not exchange FRUs unless you are instructed to do so . 3. Normally exchange only one FRU at a time. After each FRU is exchanged, go to “ MAP 2410: SSA Repair V erification ” on page 475 to verify the repair . 4. When exchanging an adapter , always use the instructions that are[...]

SRN Problem Possible Causes 1xxxx Description: SRNs in this range are not adapter SRNs. Action: For SRNs in this range, see the documentation for your SSA enclosure or SSA subsystem. Not applicable. 20P AA Description: An open SSA link has been detected. Action: Run the Link V erification service aid to isolate the failure (see “ Link V erificati[...]

SRN Problem Possible Causes 2A004 Description: Async code 04 has been received. Probably , a software error has occurred. Action: Go to “ Software and Microcode Errors ” on page 441 before exchanging any FRUs. Software error . Possible FRUs: Device (50%) ( “ Exchanging Disk Drives ” on page 319). SSA adapter card (50%) ( “ Removing and Re[...]

SRN Problem Possible Causes 34000 Description: The adapter cannot initialize a device. This problem might be badly affecting the SSA loop. If the device was a member of a RAID array , you might not be able to list this disk drive by using the RAID facilities. Action: Exchange the FRUs for new FRUs. Possible FRUs: Device (90%) ( “ Exchanging Disk [...]

SRN Problem Possible Causes 40128 Description: A 128 MB SDRAM in the adapter card module has failed. Action: Exchange the FRUs for new FRUs. Possible FRUs: 128 MB SDRAM module (99%) ( “ Removing an SDRAM Module of an Advanced SerialRAID Adapter ” on page 329). SSA adapter card (1%) ( “ Removing and Replacing an Advanced SerialRAID Adapter ”[...]

SRN Problem Possible Causes 42510 Description: Not enough SDRAM available to run the fast-write cache operation. Action: 1. Start the using-system service aids. 2. Select Display or Change Configuration or Vital Product Data (VPD) . 3. Select Display Vital Product Data . 4. Find the VPD for the SSA adapter that is logging the error . 5. Note the SD[...]

SRN Problem Possible Causes 42521 Description: A Fast-Write Cache Option Card has failed. Data has been written to the cache card, and cannot now be recovered. The disk drives that have lost the data cannot be identified. All unsynchronized fast-write disk drives that are attached to this adapter are offline. Action: 1. Ask the customer to refer to[...]

SRN Problem Possible Causes 42524 Description: A fast-write disk drive (or drives) contains unsynchronized data, but the Fast-Write Cache Option Card cannot be detected. The disk drive (or drives) is offline. Action: v If the Fast-Write Cache Option Card has been removed, reinstall it, and test the disk drive subsystem. v If the Fast-Write Cache Op[...]

SRN Problem Possible Causes 42525 Description: A fast-write logical disk contains unsynchronized data, but the Fast-Write Option Card does not contain that data. The failing disk drive is offline. Action: v If the disk drive has just been moved from another adapter , do either of the following actions: – Return the disk drive to its original adap[...]

SRN Problem Possible Causes 42528 Description: A fast-write disk drive has been detected that was previously unsynchronized, but has since been configured on a different adapter . Action: If this disk drive contains data that should be kept, return the disk drive to the adapter to which it was previously connected. If the disk drive does not contai[...]

SRN Problem Possible Causes 4252C Description: The Fast-W rite Cache Option Card battery needs to be exchanged for a new one. Action: Exchange the FRU for a new FRU. Possible FRUs: Fast-Write Cache Option Card battery (100%) ( “ Removing the Fast-Write Cache Option Card of an Advanced SerialRAID Adapter ” on page 332). 4252D Description: Fast-w[...]

SRN Problem Possible Causes 43P AA Description: An SSA device on the link is preventing the completion of the loop configuration. Action: If the SSA service aids are available, run the Link V erification service aid (see “ Link V erification Service Aid ” on page 383) to determine which device is preventing configuration. (That device is the on[...]

SRN Problem Possible Causes 46500 Description: A member disk drive is missing from an array , or the original SSA adapter is not available. The array is in the Offline state. Action: v If the missing disk drive is still operational, reconnect it to the SSA loop. v If the original SSA adapter is operational, reconnect the offline array to that adapt[...]

SRN Problem Possible Causes 48600 Description: All the member disk drives of an array are not on the same SSA loop. The array is in the Exposed state, and write operations to the array are inhibited. Action: All the member disk drives of an array must be on the same SSA loop. Find all the members of the array: 1. T ype smitty devices and press Ente[...]

SRN Problem Possible Causes 48750 Description: An array is in the Offline state because the primary or the secondary half of the array is not present. Action: Switch on the power to the other half of the array , or repair the broken loop that is preventing access to the other disk drives. If the other half of the array has become permanently unavai[...]

SRN Problem Possible Causes 48760 Description: An array is in the Offline state because the split/join procedure was not performed correctly . The data on the array is not constant. Action: See Chapter 8, “ Split-Site Management ” on page 193 before you attempt to recover the array . This problem can occur if a RAID-1 array or a RAID-10 array h[...]

SRN Problem Possible Causes 48950 Description: A disk drive has caused an array building operation to fail. Action: 1. T ype smitty ssaraid and press Enter . 2. Select List all Defined SSA RAID Arrays . The hdisk that is causing this problem is listed as exposed or degraded. 3. Ask the user to make a backup of the data that is on this array . Some [...]

SRN Problem Possible Causes 49000 Description: An array is in the Degraded state. A disk drive might not be available for one of the following reasons: v The disk drive has failed. v The disk drive has been removed from the subsystem. v An SSA link has failed. v A power failure has occurred. Action: If the SSA service aids are available, run the Li[...]

SRN Problem Possible Causes 49500 Description: No hot spare disk drives are available for an array that is configured for hot spare disk drives. Action: Determine whether any disk drives have failed or have been rejected. T o do this action: 1. Display the use of the disk drives that are attached to the SSA adapter that logged the error (see “ Ch[...]

SRN Problem Possible Causes 49510 Description: Hot-spare configuration is not synchronized. This problem has occurred because the cabling has changed or because new hot-spare disks have been added to the SSA loop. Action: 1. If the changes were not planned, restore the system to its original configuration. If the changes were planned, go to step 2.[...]

SRN Problem Possible Causes 49520 Description: Hot-spare tuning has been lost. Action: 1. T ype smitty ssaraid and press Enter . 2. Select List Status of Hot-Spare Pools . 3. Select the adapter that logged the error . If the adapter is not known, select all adapters. 4. Note the RAID Manager (adapter) and pool number of spare-pools that have a stat[...]

SRN Problem Possible Causes 49530 Description: The number of disk drives that remain in a hot-spare pool is less than the specified number . Action: 1. T ype smitty ssaraid and press Enter . 2. Select Change/Show Use of an SSA Physical Disk . 3. Note all the disk drives that are listed as rejected. 4. Exchange all the rejected disk drives for new d[...]

SRN Problem Possible Causes 49950 Description: An array copy disk drive is missing. The array copy is degraded. If the missing disk drive is restored to the network or exchanged for a new disk drive, the copy rebuilds. A disk drive might not be available for one of the following reasons: v The disk drive has failed. v The disk drive has been remove[...]

SRN Problem Possible Causes 50002 Description: An SSA adapter DMA error has occurred. Action: Exchange the FRU for a new FRU. Possible FRUs: SSA adapter card (100%) ( “ Removing and Replacing an Advanced SerialRAID Adapter ” on page 327). 50007 Description: The IOCC detected an internal error . Action: Exchange the FRU for a new FRU. Possible F[...]

SRN Problem Possible Causes 50200 Description: A duplicate node number has been detected. This problem is a user error . Action: See “ SSA Disk Concurrent Mode of Operation Interface ” on page 287. Y ou can use the ssavfynn command line utility (see “ ssavfynn Command ” on page 371) to determine which node has the duplicate node number . SS[...]

SRN Problem Possible Causes 504XX Description: The SSA adapter microcode has hung. Action: Run diagnostics in System V erification mode to the SSA adapter . If the diagnostics fail, exchange the FRU for a new FRU. If the diagnostics do not fail, go to “ Software and Microcode Errors ” on page 441. Software error . Possible FRUs: SSA adapter car[...]

SRN Problem Possible Causes D4000 Description: The diagnostics cannot configure the SSA adapter . Action: Exchange the FRU for a new FRU. Possible FRUs: SSA adapter card (100%) ( “ Removing and Replacing an Advanced SerialRAID Adapter ” on page 327). D4050 Description: The Enhanced Error Handling test has failed. Action: Exchange the FRUs for n[...]

SRN Problem Possible Causes DFFFF Note: The description and action for this SRN are valid only if you have run diagnostics to the SSA attachment. If this SRN has occurred because you have run diagnostics to some other device, see the service information for that device. Description: A command or parameter that has been sent or received is not valid[...]

SRN Problem Possible Causes SSA03 Description: The service aid was unable to open an hdisk. This problem might have occurred because a disk drive has failed or has been removed from the system. Action: Do the actions described here: 1. Use the Configuration V erification service aid (see “ Configuration V erification Service Aid ” on page 387) [...]

Software and Microcode Errors Some SRNs indicate that a problem might have been caused by a software error or by a microcode error . If you have one of these SRNs, do the following actions: 1. Make a note of the contents of the error log for the device that has the problem. 2. For AIX V ersions 4.2 and above, run the snap -b command to collect syst[...]

2. Review the configuration that you are trying to make, and determine why that configuration is not valid. 3. Correct your configuration by reconfiguring the SSA cables or by removing the excess devices or adapters from the loop. 442 User ’ s Guide and Maintenance Information[...]

SSA Maintenance Analysis Procedures (MAPs) The maintenance analysis procedures (MAPs) describe how to analyze a failure that has occurred in an SSA loop. How to Use the MAPs Attention: Unless the using system needs to be switched off for some other reason, do not switch off the using system when servicing an SSA loop . Enclosure power cables and ex[...]

MAP 2010: ST ART This MAP is the entry point to the MAPs for the adapter . If you are not familiar with these MAPs, read “ How to Use the MAPs ” on page 443 first. Y ou might have been sent here because: v The system problem determination procedures sent you here. v A problem occurred during the installation of a disk subsystem or a disk drive.[...]

MAP 2320: SSA Link This MAP helps you to isolate FRUs that are causing an SSA loop problem between a device and the SSA adapter , or between two devices. If you are not familiar with SSA loops, read the section Chapter 2, “ Introducing SSA Loops ” on page 7 before using this MAP . Chapter 2, “ Introducing SSA Loops ” explains SSA links, str[...]

If the service aid cannot detect any pdisks, a message is displayed: LINK VERIFICATION 802385 Move cursor onto selection, then press <Enter>. nunu:ssa1 00-04 IBM SSA 160 SerialRAID Adapter ( nunu:ssa1 00-05 IBM SSA 160 SerialRAID Adapter ( nunu:ssa1 00-07 IBM SSA 160 SerialRAID Adapter ( ------------------------------------------------------ [...]

LINK VERIFICATION 802386 SSA Link Verification for: nunu:ssa0 00-04 IBM SSA 160 SerialRAID Adapter ( To Set or Reset Identify, move cursor onto selection, then press <Enter>. Physical Serial# Adapter Port A1 A2 B1 B2 Status [TOP] nunu:pdisk11 AC7AA09A 0 5 Good nunu:pdisk8 AC7AA2D6 1 4 Good nunu:pdisk2 AC7AA0BD 2 3 Power nunu:pdisk3 AC7AA0B1 3[...]

5. (from step 4) Observe the Status column on the screen. If the status of any pdisk is ‘ Failed ’ , that pdisk is failing. In the example shown here, pdisk2 is failing. LINK VERIFICATION 802386 SSA Link Verification for: nunu:ssa0 00-04 IBM SSA 160 SerialRAID Adapter ( To Set or Reset Identify, move cursor onto selection, then press <Enter&[...]

6. (from step 5) Observe the list of pdisks the screen. A row of question marks (?????) shows that a link in one of the loops is broken. If two rows of question marks are displayed, two links are broken, one in each loop. In the example shown here, pdisk2 is missing. LINK VERIFICATION 802386 SSA Link Verification for: nunu:ssa0 00-04 IBM SSA 160 Se[...]

MAP 2323: SSA Intermittent Link Error This MAP helps you to isolate FRUs that are causing an intermittent SSA link problem. Y ou are here because you have an SRN from the series 21xxx through 29xxx, or you have SRN 33xxx. If you are not familiar with the SSA link, read the section Chapter 2, “ Introducing SSA Loops ” on page 7 before using this[...]

a. Observe the SRN that sent you to this MAP . The last three characters are in the format P AA, where P is the number of the SSA adapter port, and AA is the SSA address of the device). Note the value of P AA in the SRN. For example: If the SRN is 24002, P AA = 002. If the SRN is 24104, P AA = 104. b. Observe the Link V erification screen, and iden[...]

Example 1 If the SRN is 24002, the device is connected to adapter port 0 (shown as A1 on the screen), and has an SSA address of 02 (shown as 2 on the screen). In the example screen, that device is pdisk3, which is the first device of the two. The second device is pdisk2 (P AA − 1). If the SRN is 33002, the first device of the two is again pdisk3.[...]

Example 2 If the SRN is 24104, the device (in theory) is connected to adapter port 1 (shown as A2 on the screen). The device, however , has an SSA address of 04. That address is higher than the highest address that is displayed for adapter port 1. The devices are, therefore, the SSA adapter and pdisk1. 3. (from step 2) The problem is in the SSA lin[...]

MAP 2324: SSA RAID This MAP helps you to solve problems that have occurred in SSA RAID arrays. Attention: Unless the using system needs to be switched off for some other reason, do not switch off the using system when servicing an SSA link or an enclosure in which SSA devices are installed . Enclosure power cables and external SSA cables that conne[...]

3. (from step 2) Do you have any other SRN? NO Go to step 22 on page 467. YES a. Solve the problems that caused the SRN. b. Return to step 1 on page 454. 4. (from step 2) Find your SRN in the following table, then do the appropriate actions. Note: If you still do not have any of these SRNs, you are in the wrong MAP . SRN Cause Action 46000 An array[...]

6. (from step 5) Either one or more disk drives have failed, or an array that is not complete has been connected to the SSA adapter . v If one or more disk drives have been added to this system, and those disk drives were previously members of an array on this system or on another system, do the following: a. T ype smitty ssaraid and press Enter . [...]

7. (from step 6) The array data cannot be recovered. The following steps clear the error condition and change the disk drives to a usable state. a. T ype smitty ssaraid and press Enter . b. Select Change/Show Use of an SSA Physical Disk . Are any disk drives listed as “ SSA physical disks that are rejected ” ? NO Ask the user to delete and recr[...]

9. (from step 4) Attention: Part of the data that is on the array has been damaged and cannot be recovered. Before any other action is taken, the user must recover all the data that is not damaged, and create a backup of that data. a. T ype smitty ssaraid and press Enter . b. Select List Status Of All Defined SSA RAID Arrays . c. Select, in turn, e[...]

10. (from step 9) a. T ype smitty ssaraid and press Enter . b. Select List/Identify SSA Physical Disks . c. Select List Disks in an SSA RAID Array . d. Select the failing disk drive, and note the pdisk numbers of the disk drives that are members of the array . e. Ask the user to create a backup of all the data from this array . Some data might not [...]

12. (from step 1 1) Did the Certify service aid fail again? NO a. Ask the user to recreate the array . b. Go to step 22 on page 467. YES a. Exchange the failing disk drive for a new one (see “ Exchanging Disk Drives ” on page 319). b. Go to step 37 on page 473 to add the disk drive to the group of disk drives that are available for use by the R[...]

14. (from step 13) Are any disk drives listed as “ SSA physical disks that are rejected ” ? NO A disk drive has not been detected by the adapter . Go to step 15 on page 462. YES a. Run diagnostics in System V erification mode to all the disk drives that are listed as rejected. b. Run the Certify service aid (see “ Certify Disk Service Aid ”[...]

When the rebuilding operation is complete, ask the user to run diagnostics in System V erification mode to the SSA adapters, to ensure that the rebuilding operation has not found any more problems. k. Go to “ MAP 2410: SSA Repair V erification ” on page 475 to verify the repair . 15. (from step 14) Does the Link V erification service aid indica[...]

17. (from step 4) A RAID-5 array is in the Exposed state when one member disk drive of the array is not available to the array . A RAID-1 or RAID-10 array is in the Exposed state when one or more mirrors are exposed. A mirror is exposed when one disk drive in the mirror pair is not available to the array . If the missing disk drives are returned to[...]

18. (from step 17) Are any disk drives listed as “ SSA physical disks that are rejected ” ? NO A disk drive has not been detected by the adapter . Go to step 19 on page 465. YES a. Run diagnostics in System V erification mode to all the disk drives that are listed as rejected. b. Run the Certify service aid (see “ Certify Disk Service Aid ”[...]

When the rebuilding operation is complete, ask the user to run diagnostics in System V erification mode to the SSA adapters, to ensure that the rebuilding operation has not found any more problems. k. Go to “ MAP 2410: SSA Repair V erification ” on page 475 to verify the repair . 19. (from step 18) Does the Link V erification service aid indica[...]

21. (from step 1) No spare disk drives are available for an array that is configured for hot spare disk drives. a. If the subsystem contains disk drives that have failed, repair those disk drives, or exchange them for new disk drives (see “ Exchanging Disk Drives ” on page 319). b. T ype smitty ssaraid and press Enter . c. Select Change/Show Us[...]

22. (from step 7 in MAP 2410: SSA Repair V erification, and from steps 3, 1 1, and 12 in this MAP) RAID Checkout Y ou are now starting the RAID checkout procedure a. T ype smitty ssaraid and press Enter . b. Select Change/Show Use of an SSA Physical Disk from the SSA RAID Arrays menu. Are any disks listed as “ SSA physical disks that are rejected[...]

c. If problems occur on any disk drive, exchange that disk drive for a new disk drive (see “ Exchanging Disk Drives ” on page 319), then continue from step 24e in this procedure. d. A disk drive that is listed as rejected is not necessarily failing. For example, the array might have rejected the disk drive because a power problem, or an SSA lin[...]

d. Select the pdisk from the list, and change the Current Use parameter to Array Candidate Disk . e. Select Change Member Disks in an SSA RAID Array . f. Select Swap Members of an SSA RAID Array . g. Select the hdisk that is in the Degraded copy state (that is, the hdisk that you noted in step 23d on page 467). h. Referring to the displayed instruc[...]

27. (from step 22) Is any disk drive failing? NO A disk drive that is listed as rejected is not necessarily failing. For example, the array might have rejected the disk drive because a power problem, or an SSA link problem, caused that drive to become temporarily unavailable. Under such conditions, the disk drive can be reused. If you think that a [...]

30. (from step 29) Do any RAID-5 arrays have Unsynced Parity Strips or Unbuilt Data Strips? NO Go to step 31. YES The rebuilding operation is running or has stopped before completion. a. Note the number of unsynced parity strips and unbuilt data strips. b. Press the Cancel key to leave the status display . c. Wait for a few moments, then reselect t[...]

33. (from step 32) W as SRN 49100 logged, but no error found, when diagnostics were run in System V erification mode? NO Go to step 34. YES An array was in the Exposed state, but is now in the Good state. This problem might have occurred because a disk drive was temporarily removed from the system. V erify that using-system procedures ensure that t[...]

36. (from step 35) Y ou have solved all the problems. a. Run the repair verification or repair completion procedures that are defined by your using system. b. If you have previously created a backup, reload that data now . 37. (from steps 7, 10, 12, and 27) Has a failed disk drive been exchanged for a new disk drive? NO If you have repaired a power[...]

v Array Candidate Disk if the use of hot spares is disabled for the arrays on the subsystem e. Go to step 38. 38. (from step 37) Y ou have changed the use of a disk drive. Y ou must now ensure that the hot spare pools are correctly configured. T o do this action: a. T ype smitty ssaraid and press Enter . b. Select List Status of Hot Spare Pools . c[...]

MAP 2410: SSA Repair V erification This MAP helps you to verify that FRUs that you have exchanged for new FRUs, or repair actions that you have done, have solved all the problems on the subsystem. Attention: Unless the using system needs to be switched off for some other reason, do not switch off the using system when servicing an SSA link or an en[...]

Notes: 1) Do not run Advanced Diagnostics; otherwise, errors might be logged on other using systems that share the same loop. 2) If you have just exchanged a disk drive or an SSA adapter , you might need to run cfgmgr to restore the device to the system configuration. If the original problem was not reported by a device, run diagnostics to each SSA[...]

7. (from steps 3 in MAP 2010: ST ART and from steps 5 and 4 in this MAP) Does your subsystem contain RAID arrays? If you are not sure whether your subsystem contains RAID arrays: a. T ype smitty ssaraid and press Enter . b. Select List All Defined SSA RAID Arrays . NO Run the repair verification, or repair completion, procedures that are defined by[...]

SSA Link Errors SSA link errors can be caused if: v Power is removed from an SSA device. v An SSA device is failing. v An SSA device is removed. v A cable is disconnected. Such errors might be indicated by: v SRN 45P AA v A flashing link status (Ready) light on the SSA device at each end of the failing link v The indication of an open link by the L[...]

Example 1 In Figure 59, the link is between two disk drives that are in the same subsystem. It has three parts. Example 2 In Figure 60, the link is between two disk drives that are in the same subsystem. It has five parts. Internal Connection Disk Drive 1 Disk Drive 2 SSA Subsystem Figure 59. Three-Part Link in One Subsystem Internal Connection Dum[...]

Example 3 In Figure 61, the link is between two disk drives that are not in the same subsystem. It has seven parts. Example 4 Figure 62, the link is between a disk drive and an SSA adapter . It has five parts. Example 5 In Figure 63, the link is between two SSA adapters. It has five parts. Note that it has fiber optic cables and optical connectors [...]

Link Status (Ready) Lights If a fault occurs that prevents the operation of a particular link, the link status lights of the various parts of the complete link show that the error has occurred. Y ou can find the failing link by looking for the flashing green status light at each end of the affected link. Some configurations might have other indicat[...]

Service Aid If service aids are available, you can use the Link V erification service aid to show that the SSA loop is broken. LINK VERIFICATION 802386 SSA Link Verification for: systemname:ssa0 00-04 SSA Enhanced RAID Adapter To Set or Reset Identify, move cursor onto selection, then press <Enter>. Physical Serial# Adapter Port A1 A2 B1 B2 S[...]

Part 3. Appendixes 483[...]

484 User ’ s Guide and Maintenance Information[...]

Appendix. Communications Statements The following statements apply to this product. The statements for other products intended for use with this product appear in their accompanying manuals. Federal Communications Commission (FCC) Statement This equipment has been tested and found to comply with the limits for a Class A digital device, pursuant to [...]

International Electrotechnical Commission (IEC) Statement This product has been designed and built to comply with (IEC) Standard 950. A vis de conformit éà la r é glementation d ’ Industrie Canada Cet appareil num é rique de la classe A est conforme à la norme NMB-003 du Canada. Industry Canada Compliance Statement This Class A digital appar[...]

festgelegt), dann kann es dabei eventuell gest ö rt werden. In solch einem Fall ist der Abstand bzw . die Abschirmung zu der industriellen St ö rquelle zu vergr ö ssern. ″ Anmerkung: Um die Einhaltung des EMVG sicherzustellen sind die Ger ä te, wie in den Handb ü chern angegeben, zu installieren und zu betreiben. T aiwan Class A Compliance S[...]

488 User ’ s Guide and Maintenance Information[...]

Glossary This glossary explains terms and abbreviations that are used in the manual. The glossary contains terms and definitions from the IBM Dictionary of Computing . If you do not find the term or abbreviation for which you are looking, try the index or refer to the IBM Dictionary of Computing at URL: http://www .networking.ibm.com/nsg/nsgmain.ht[...]

Exposed state. The state that a RAID array enters if a member disk drive becomes missing (logically or physically) from that array . F Failed status. The disk drive is not working. fencing. SSA disk fencing is a facility that is provided in the SSA subsystem. It allows multiple using systems to control access to a common set of disk drives. flag. A[...]

microcode. One or more microinstructions used in a product as an alternative to hard-wired circuitry to implement functions of a processor or other system component. mirrored pair . T wo disk drives that contain the same data, and are referred to as one entity by the using system. mirroring. The process of writing the same data to two disk drives a[...]

service request number . A number that helps you to identify the cause of a problem, the failing field-replaceable units (FRUs), and the service actions that might be needed to solve the problem. Service request numbers are generated by the system error-log analysis, system configuration code, and customer problem determination procedures. SMIT . S[...]

Index Numerics 128 MB Memory Module feature 5 3-way copy array copy services 173 Delete a RAID Array Copy option 183 Delete a V olume Group, Logical V olumes, or Filesystems Copy option 184 List All Copy Candidates option 179 List All Uncoupled Copies option 181 List All Uncoupled V olume Groups option 182 Prepare a Copy option 175 Uncouple a V olu[...]

array copy services (continued) Prepare a Copy option 175 Uncouple a V olume Group, Logical V olumes, or File Systems Copy option 177 array states, RAID-0 31 Good 31 Offline 31 array states, RAID-1 32 array states, RAID-10 36 Degraded 37 Exposed 36 Good 36 multiple 38 Offline 37 Rebuilding 37 Unknown 38 array states, RAID-5 33 Degraded 33 Exposed 3[...]

attributes (continued) ODM, PCI (continued) bus_mem_start2 257 bus_mem_start3 257 bus_mem_start4 257 daemon 258 dma_mem 258 host_address 258 intr_priority 257 poll_threshold 258 scat_gat_pages 258 ucode 257 physical disk change attributes 249 physical disk drive change fastwrite=on/off 250 force=yes/no 251 fw_end_block 250 fw_max_length 250 fw_star[...]

choosing the error threshold (alarm) level for a hot spare pool 51 chssaraid command 135 close subroutine tmssa device driver 297 command line error log analysis 232 Command Line Interface for RAID 235 action attributes 251 command syntax 237 couple action attributes 252 hot spare pool creation and change attributes 249 instruct types 238 object ty[...]

configuring and installing SSA RAID arrays (continued) adding a new hot spare pool 83 adding an SSA RAID array 60 adding disks to a hot spare pool 86 canceling all SSA disk drive identifications 129 changing member disks in an SSA RAID array 137 changing or showing the attributes of an SSA RAID array 135 changing or showing the status of a hot spar[...]

Degraded state, RAID-10 37 Degraded state, RAID-5 33 Delete a RAID Array Copy option 183 Delete a V olume Group, Logical V olumes, or Filesystems Copy option 184 Delete an SSA RAID Array option 70 detail data formats, error logging 225 device attributes 270 device driver entry point 287 device drivers 255 adapter configuring devices 257 description[...]

disk device driver (continued) files 282 purpose 281 return values 282 SSADISK_LIST_PDISKS ioctl operation 285 description 285 files 286 purpose 285 return values 286 SSADISK_SCSI_CMD ioctl operation 283 description 283 files 284 purpose 283 return values 284 syntax 266 disk drive microcode maintenance 315 disk drives failed, identifying, correctin[...]

FRU part numbers 340 full-stride writes, definition 272 G getting access to the Fast-Write menus 213 getting access to the SSA Adapters SMIT menu 40 getting access to the SSA Disks SMIT menu 41 getting access to the SSA RAID Array SMIT menu 59 good housekeeping 233 Good state, RAID-0 31 Good state, RAID-10 36 Good state, RAID-5 33 H hdisks and pdis[...]

installing the SSA adapter 313 instruct types, Command Line Interface 238 interface, adapter device driver/head device driver 256 IOCINFO ioctl operation 261, 305 description 261, 305 disk device driver 277 description 277 files 277 purpose 277 files 261 purpose 261, 305 ioctl subroutine tmssa device driver 301 issaraid command 1 19 L large configu[...]

Offline state, RAID-5 34 one loop with two adapters in each of two using systems 12 one loop with two adapters in one using system 1 1 open and close subroutines adapter device driver 258 open subroutine tmssa device driver 296 open, read, write, and close subroutines disk device driver 272 operation after a loss of member disks, split-site managem[...]

RAID arrays (continued) adding to the configuration 60 canceling all SSA disk drive identifications 129 changing member disks in an SSA RAID array 137 changing or showing the attributes of an SSA RAID array 135 changing or showing the status of a hot spare pool 74 changing or showing the use of an SSA disk drive 144 changing the use of multiple SSA[...]

removal and replacement procedures (continued) installing a battery assembly into the fast-write cache card 338 installing an SDRAM module 330 installing the fast-write cache card 334 removing an SDRAM module 329 removing the battery assembly from the fast-write cache card 336 removing the fast-write cache card 332 SSA adapter 327 Remove a Disk fro[...]

SMIT (or SMITTY) options (continued) Change/Show Characteristics of an SSA Logical Disk 214 Change/Show Use of an SSA Disk 144 Change/Show/Delete a Hot Spare Pool 86 Delete an SSA RAID Array 70 Enable/Disable Fast-Write for Multiple Devices 215 Identify Array Candidate Disks 125 Identify Disks in an SSA RAID Array 1 19 Identify Hot Spares 121 Ident[...]

SSA loops (continued) large configurations 16 links and data paths 7 loops and data paths, examples broken loop (cable removed) 403 broken loop (disk drive removed) 406 normal loops 401 one loop with two adapters in each of two using systems 12 one loop with two adapters in one using system 1 1 problem determination 400 rules 22 simple 8 simple, on[...]

ssadisk SSA disk device driver (continued) attributes common to logical and physical disks 271 attributes for logical disks only 271 attributes of the SSA router , ssar 270 error conditions 274 special files 276 SSADISK_ISAL_CMD ioctl operation disk device driver 278 description 278 files 280 purpose 278 return values 279 SSADISK_ISALMgr_CMD ioctl [...]

three-way copy (continued) SMIT menus for 172 ssa_delete_copy command 171 ssa_make_copy command 161 using SMIT menus to create a copy array 155 using ssa_make_copy command to create a copy array 159 using ssaraid commands to create a copy array 151 TMCHGIMP ARM (change parameters) tmssa device driver ioctl operation 308 description 308 purpose 308 [...]

[...]

Part Number: 27H0678 Printed in the U.S.A. SA33-3285-02 (1P) P/N: 27H0678[...]

Spine information: A d va n ced S eri alRAID A d a pt ers U se r’s Gui d e an d M ain te nan ce Inf or ma ti o n[...]