IBM Advanced SerialRAID Adapters SA33-3285-02 User Manual
  1. Manuals
  2. Brands
  3. IBM Manuals
  4. Adapter
  5. Advanced SerialRAID Adapters SA33-3285-02
  6. User manual
IBM Advanced SerialRAID Adapters SA33-3285-02 User Manual

IBM Advanced SerialRAID Adapters SA33-3285-02 User Manual

Advanced serialraid adapters
Hide thumbs
1
2
3
4
Table Of Contents
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
Table of Contents

Advertisement

Quick Links

Download this manual
Advanced SerialRAID Adapters
User's Guide and
Maintenance Information
SA33-3285-02

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the Advanced SerialRAID Adapters SA33-3285-02 and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Related Manuals for IBM Advanced SerialRAID Adapters SA33-3285-02

Summary of Contents for IBM Advanced SerialRAID Adapters SA33-3285-02

  • Page 1 Advanced SerialRAID Adapters User’s Guide and Maintenance Information SA33-3285-02...

  • Page 3: Maintenance Information

    Advanced SerialRAID Adapters User’s Guide and Maintenance Information SA33-3285-02...
  • Page 4 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.

  • Page 5: Table Of Contents

    Contents Safety Notices. Definitions of Safety Notices Safety Notice for Installing, Relocating, or Servicing. About This Book . Who Should Use This Book . What This Book Contains . If You Need More Information. Web Support Pages. Numbering Convention . Part 1.
  • Page 6 Reserving Disk Drives . Fast-Write Cache . Chapter 3. RAID Functions and Array States . RAID Functions Availability . Disk Drives That Are Not in Arrays . RAID-0 Array States . Good State . Offline State. RAID-1 Array States . RAID-5 Array States .
  • Page 7 Dealing with RAID Array Problems . Getting Access to the SSA RAID Array SMIT Menu . Identifying and Correcting or Removing Failed Disk Drives . Installing a Replacement Disk Drive . Using Other Configuration Functions Getting Access to the SSA RAID Array SMIT Menu . Listing All Defined SSA RAID Arrays .
  • Page 8 Remove a Disk From an SSA RAID Array Swap Members of an SSA RAID Array Chapter 8. Split-Site Management Configuration of RAID-1 and RAID-10 Arrays . Operation after a Loss of Member Disks . One Half of the Array Is Not Present . Array is Offline because Adapter Is Not Known to the Remaining Half of the Array .
  • Page 9 Example 7: To Change an Attribute of an Object . Example 8: To Exchange a Member Disk Drive of an Existing Array . Example 9: To Make a New System Disk. Example 10: To Delete an Array. SSARAID Command Attributes . RAID Arrays Creation and Change Attributes RAID Arrays Change Attributes .
  • Page 10 Device Attributes . Device-Dependent Subroutines . Error Conditions . Special Files . IOCINFO (Device Information) SSA Disk Device Driver ioctl Operation . Purpose Description. Files . SSADISK_ISAL_CMD (ISAL Command) SSA Disk Device Driver ioctl Operation Purpose Description. Return Values. Files . SSADISK_ISALMgr_CMD (ISAL Manager Command) SSA Disk Device Driver ioctl Operation .
  • Page 11 Related Information . IOCINFO (Device Information) tmssa Device Driver ioctl Operation . Purpose Description. TMIOSTAT (Status) tmssa Device Driver ioctl Operation . Purpose Description. TMCHGIMPARM (Change Parameters) tmssa Device Driver ioctl Operation . Purpose Description. Part 2. Maintenance Information ....311 Chapter 14.
  • Page 12 ssacand Command . Purpose Syntax . Description. Flags ssa_certify Command . Purpose Syntax . Description. Flags ssaconn Command . Purpose Syntax . Description. Flags ssa_diag Command . Purpose Syntax . Description. Flags Output . ssadisk Command . Purpose Syntax . Description.
  • Page 13 ssa_fw_status Command . Purpose Syntax . Description. Flags Output . Examples . ssa_getdump Command . Purpose Syntax . Description. Flags Output . ssaidentify Command . Purpose Syntax . Description. Flags ssa_progress Command . Purpose Syntax . Description. Flags Output . Examples .
  • Page 14 Flags Output . ssaxlate Command . Purpose Syntax . Description. Flags Chapter 17. SSA Service Aids . The Identify Function . Starting the SSA Service Aids Set Service Mode Service Aid . Link Verification Service Aid . Configuration Verification Service Aid . Format Disk Service Aid .
  • Page 15 Federal Communications Commission (FCC) Statement . Japanese Voluntary Control Council for Interference (VCCI) Statement . Korean Government Ministry of Communication (MOC) Statement . New Zealand Compliance Statement . International Electrotechnical Commission (IEC) Statement . Avis de conformité à la réglementation d’Industrie Canada . Industry Canada Compliance Statement .
  • Page 16 User’s Guide and Maintenance Information...

  • Page 17: Safety Notices

    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.
  • Page 18 User’s Guide and Maintenance Information...

  • Page 19: About This Book

    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. To 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.

  • Page 20: Web Support Pages

    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.

  • Page 21: Part 1. User Information

    Part 1. User Information...
  • Page 22 User’s Guide and Maintenance Information...

  • Page 23: Chapter 1. Introducing Ssa And The Advanced Serialraid Adapters

    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.

  • Page 24: The Advanced Serialraid Adapters (Type 4-P)

    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. Each loop can contain a maximum of eight pairs of adapter connectors and a maximum of 48 disk drives.

  • Page 25: Fast-Write Cache Feature

    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.

  • Page 26: Lights Of The Advanced Serialraid Adapters

    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 Permanently on Slow Flash Port Addresses of the Advanced SerialRAID Adapters The port addresses used in some SRNs that relate to these adapters can be numbers 0 through 3.

  • Page 27: Chapter 2. Introducing Ssa Loops

    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 is located in a using system.

  • Page 28: Simple Loop

    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.

  • Page 29: Simple Loop - One Disk Drive Missing

    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.

  • Page 30: Simple Loop - Two Disk Drives Missing

    Simple Loop — Two 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.

  • Page 31: One Loop With Two Adapters In One Using System

    One Loop with Two 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.

  • Page 32: One Loop With Two Adapters In Each Of Two Using Systems

    One Loop with Two Adapters in Each of Two 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.
  • Page 33 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 using system 1.

  • Page 34: Two Loops With One Adapter

    Two 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 Figure 8.

  • Page 35: Two Loops With Two Adapters

    Two Loops with Two 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.

  • Page 36: Large Configurations

    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. Adapter Figure 10.

  • Page 37: Switching Off Using Systems

    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 failed.

  • Page 38: Configuring Devices On An Ssa Loop

    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.

  • Page 39: Identifying And Addressing Ssa Devices

    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.
  • Page 40 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.

  • Page 41: Ssa Unique Ids

    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.

  • Page 42: Rules For Ssa Loops

    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 SSA loop.

  • Page 43: Checking The Level Of The Adapter Microcode

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

  • Page 44: Rules For The Physical Relationship Between Disk Drives And Adapters

    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 determine the best relationship between the disk drives and the adapter on an SSA loop that contains only one pair of adapter...

  • Page 45: Pairs Of Adapter Connectors In The Loop - Some Shared Data

    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.

  • Page 46: Pairs Of Adapter Connectors In The Loop - Mainly Shared Data

    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.

  • Page 47: Reserving Disk Drives

    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 can read the Physical Volume ID (PVID) from a reserved disk drive.
  • Page 48 User’s Guide and Maintenance Information...

  • Page 49: Chapter 3. Raid Functions And Array States

    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.

  • Page 50: Disk Drives That Are Not In Arrays

    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 separate domains.

  • Page 51: Raid-0 Array States

    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.

  • Page 52: Raid-1 Array States

    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 separate member disk drives of the array when the array becomes split, but separate systems can still access one of the member disk drives.

  • Page 53: Raid-5 Array States

    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 present.

  • Page 54: Rebuilding State

    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. You 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.

  • Page 55: Raid-5 Array State Flowchart

    RAID-5 Array State Flowchart Array Good Disk is removed Array Exposed Second Original disk disk fails or replaced is removed Write operation New disk Array Degraded Array enabled for Hot Spare Hot Spare available Hot Spare swapped in Array Rebuilding Figure 15.

  • Page 56: Raid-10 Array States

    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 different sites in different power domains.

  • Page 57: Degraded State

    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.

  • Page 58: Unknown State

    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.

  • Page 59: Chapter 4. Using The Ssa Smit Menus

    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...

  • Page 60: Getting Access To The Ssa Adapters Smit Menu

    Getting Access to the SSA Adapters SMIT Menu 1. For fast-path access to the SSA RAID Array SMIT menus, type press Enter. Otherwise: a. Type b. Select Devices. The Devices menu is displayed. c. Select SSA Adapters. 2. The SSA Adapters menu is displayed: If you need help with an item, move the cursor to that item, and press F1 (Help).

  • Page 61: Getting Access To The Ssa Disks Smit Menu

    Getting Access to the SSA Disks SMIT Menu 1. For fast-path access to the SSA RAID Array SMIT menus, type press Enter. Otherwise: a. Type b. Select Devices. The Devices menu is displayed. c. Select SSA Disks. 2. The SSA Disks menu is displayed: Select the type of SSA disk on which you want to work.
  • Page 62 4. The SSA Logical Disks menu is displayed: If you need help with an item, move the cursor to that item, and press F1 (Help). 5. The SSA Physical Disks menu is displayed: If you need help with an item, move the cursor to that item, and press F1 (Help). User’s Guide and Maintenance Information...

  • Page 63: Getting Access To The Ssa Raid Arrays Smit Menu

    Getting Access to the SSA RAID Arrays SMIT Menu 1. For fast-path access to the SSA RAID Array SMIT menus, type press Enter. Otherwise: a. Type b. Select Devices. The Devices menu is displayed. c. Select SSA RAID Arrays. 2. The SSA RAID Arrays menu is displayed: For more information about how to use this menu, go to Chapter 6, “Using the RAID Array Configurator”...
  • Page 64 User’s Guide and Maintenance Information...

  • Page 65: Chapter 5. Hot Spare Management

    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.
  • Page 66 Figure 16 shows an array that has its primary disk drives (pdisk2, pdisk3, pdisk10 and pdisk11) 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.
  • Page 67 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. Building 1 pdisk1 pdisk2 (Spare) (Failed) pdisk12 pdisk11 Primary Disks Figure 17. Primary Disk in Building 1; Secondary Disks in Building 2; Distributed Spares Now, assume that for some reason, the disk drives in building 2 are no longer available.
  • Page 68 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 disk drive.
  • Page 69 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.
  • Page 70 Figure 20 shows an alternative method of protecting RAID-5 arrays against the complete failure of an SSA Enclosure. This method uses a different hot spare disk drive to protect each member of the array. Enclosure-1 hdisk pdisk Enclosure-2 pdisk Enclosure-3 pdisk Figure 20.

  • Page 71: Choosing How Many Hot Spare Disk Drives To Include In Each Pool

    Figure 21 shows how a RAID-10 array can be protected against the complete failure of an SSA enclosure. Enclosure-1 hdisk1 Primary Disks Enclosure-2 hdisk1 Secondary Disks Figure 21. Pools and Hdisks along Enclosures The primary disk drives of the array are in enclosure 1; the secondary disk drives are in enclosure 2.

  • Page 72: Rules For Hot Spare Disk Drive Pools

    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.

  • Page 73: Solving Hot Spare Pool Problems

    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 Service Request Number (SRN) that is generated by the diagnostics to guide your actions.
  • Page 74 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.
  • Page 75 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.
  • Page 76 User’s Guide and Maintenance Information...

  • Page 77: Chapter 6. Using The Raid Array Configurator

    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.

  • Page 78: Installing And Configuring Ssa Raid Arrays

    Installing and Configuring SSA RAID Arrays You 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.

  • Page 79: Getting Access To The Ssa Raid Arrays Smit Menu

    Getting Access to the SSA RAID Arrays SMIT Menu 1. For fast-path access to the SSA RAID Array SMIT menus, type press Enter. Otherwise: a. Type b. Select Devices. The Devices menu is displayed. c. Select SSA RAID Arrays. 2. The SSA RAID Arrays menu is displayed: From the following list, find the option that you want, and go to the place that is indicated.

  • Page 80: Adding An Ssa Raid Array

    Adding an SSA RAID Array This option lets you add an array to the configuration. 1. For fast path, type Otherwise, select Add an SSA RAID Array from the SSA RAID Arrays menu. A list of adapters is displayed in a window: User’s Guide and Maintenance Information and press Enter.
  • Page 81 2. Select the adapter to which you want to add the array. A list of array types is displayed in a window: Chapter 6. Using the RAID Array Configurator...
  • Page 82 3. Select the type of array that you want to create. If you select RAID-0, the following menu is displayed: For the meanings of the fields, see page 66. User’s Guide and Maintenance Information...
  • Page 83 If you select RAID-1, the following menu is displayed: For the meanings of the fields, see page 66. Chapter 6. Using the RAID Array Configurator...
  • Page 84 If you select RAID-5, the following menu is displayed: For the meanings of the fields, see page 66. User’s Guide and Maintenance Information...
  • Page 85 If you select RAID-10, the following menu is displayed: For the meanings of the fields, see page 66. Chapter 6. Using the RAID Array Configurator...
  • Page 86 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 Type 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.
  • Page 87 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.
  • Page 88 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.
  • Page 89 6. Select the disk drives that you want in the array. You must select a minimum of: v Two 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 Two primary and two secondary disk drives if you are creating a RAID-10...

  • Page 90: Deleting An Ssa Raid Array

    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. You cannot delete arrays that do not have a corresponding hdisk. 1.
  • Page 91 3. A prompt is displayed in a window: 4. At the prompt, press Enter if you want to delete the array. Press Cancel if you do not want to delete the array. Chapter 6. Using the RAID Array Configurator...

  • Page 92: Creating A Hot Spare Disk Drive

    Creating a Hot Spare Disk Drive 1. For fast path, type 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: 2. Using the arrow keys, scroll the information until you find the list of SSA physical disks that are not used.
  • Page 93 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: Move the cursor to Current Use, and press the List key. Note: If the Current Use field shows that the disk drive is owned by an array, you cannot change that use.

  • Page 94: Changing Or Showing The Status Of A Hot Spare Pool

    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 Otherwise, select List Status of Hot Spare Pools from the SSA RAID Arrays menu.
  • Page 95 3. A list of hot spare pools and their status is displayed: The columns of information displayed on the screen have the following meanings: Pool The pool identifier. Note: Until you have defined hot spare pools (see “Adding a New Hot Spare Pool”...
  • Page 96 empty reduced critical The number of hot spare disk drives that are in the pool is less inconsistent mixed unused User’s Guide and Maintenance Information 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.

  • Page 97: Showing The Disks That Are Protected By Hot Spares

    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 Otherwise, select List Status of Hot Spare Protection for an SSA RAID Array from the SSA RAID Arrays menu.
  • Page 98 3. A list of protected member disk drives is displayed: The columns of information displayed on the screen have the following meanings: Component The array member disk drive of the hdisk that is listed on the screen. Location The physical location code of the array member disk drive. Size The size of the array member disk drive.
  • Page 99 Status The status of the array member disk drive. Valid 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.

  • Page 100: Listing The Disks That Are In A Hot Spare Pool

    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 Otherwise, select List Components in a Hot Spare Pool from the SSA RAID Arrays menu.
  • Page 101 3. A list of hot spare pools is displayed: Select the hot spare pool whose disk drives you want to list. 4. The pool status is displayed: The columns of information displayed on the screen have the following meanings: Chapter 6. Using the RAID Array Configurator...
  • Page 102 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 member disk drive is too large to be protected by the hot spare disk drive.

  • Page 103: Adding A New Hot Spare Pool

    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.
  • Page 104 3. A list that shows Loop A or Loop B is displayed: Select the loop on which you want to create the hot spare pool. 4. The Hot Spare Pool Creation menu is displayed: This menu automatically assigns the next available pool number to the new pool. User’s Guide and Maintenance Information...
  • Page 105 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. You should normally set this field to the number of hot spare disk drives that you intend to assign to this pool.

  • Page 106: Adding Disks To, Or Removing Disks From, A Hot Spare Pool

    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”...
  • Page 107 3. A list of hot spare pools is displayed: Select the hot spare pool that you want to change. Chapter 6. Using the RAID Array Configurator...
  • Page 108 4. The hot spare pool is displayed: v To add disk drives to the pool: 1. Select Components to Add and press the List key. A list of valid hot spare pool candidates is displayed. This list contains RAID disk drives, hot spare disk drives, and free disk drives that are in pool zero on the selected loop.

  • Page 109: Dealing With Raid Array Problems

    Dealing with RAID Array Problems This part of the chapter describes how to solve problems that might occur on your SSA RAID arrays. You 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 Functions.

  • Page 110: Getting Access To The Ssa Raid Array Smit Menu

    Getting Access to the SSA RAID Array SMIT Menu 1. For fast-path access to the SSA RAID Array SMIT menus, type press Enter. Otherwise: a. Type b. Select Devices. The Devices menu is displayed. c. Select SSA RAID Arrays. 2. The SSA RAID Arrays menu is displayed: From the following list, find the option that you want, and go to the place that is indicated.

  • Page 111: Identifying And Correcting Or Removing Failed Disk Drives

    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.
  • Page 112 3. A list of rejected disk drives is displayed: 4. Check the list of rejected disk drives against other error reports to find out why the disk drive was rejected from the array. 5. If you know the physical location of the rejected disk drive, go to step 12 on page 93.
  • Page 113 8. Select the adapter that contains the rejected disk drive. The following menu is displayed: 9. Select yes in the Flash Disk Identification Lights field. 10. Press the List key to list the disk drives. 11. From the displayed list, select the disk drives that you want to identify. The Check light flashes on each disk drive that you have selected.
  • Page 114 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. User’s Guide and Maintenance Information...

  • Page 115: Installing A Replacement Disk Drive

    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”...
  • Page 116 5. The following information is displayed: 6. Select Disk to Remove. 7. Press the List key to display the disk drive to remove. If the disk drive that you are replacing has been rejected by the array, that disk drive is listed as BlankReservedZ.

  • Page 117: Using Other Configuration Functions

    Using Other Configuration Functions This part of the chapter describes the maintenance procedures that are available for your Advanced SerialRAID Adapter. You can use these procedures at any time. You can get to the required SMIT menu by using fast path commands or by working through other menus.

  • Page 118: Getting Access To The Ssa Raid Array Smit Menu

    Getting Access to the SSA RAID Array SMIT Menu 1. For fast-path access to the SSA RAID Array SMIT menus, type press Enter. Otherwise: a. Type b. Select Devices. The Devices menu is displayed. c. Select SSA RAID Arrays. 2. The SSA RAID Arrays menu is displayed: From the following list, find the option that you want, and go to the place that is indicated.
  • Page 119 – “Identifying the Disk Drives in an SSA RAID Array” on page 119 – “Identifying Hot Spare Disk Drives” on page 121 – “Identifying Rejected Array Disk Drives” on page 123 – “Identifying Array Candidate Disk Drives” on page 125 –...

  • Page 120: Listing All Defined Ssa Raid Arrays

    Listing All Defined SSA RAID Arrays This option lists all the arrays that are connected to the SSA adapter. 1. For fast path, type Otherwise, select List All Defined SSA RAID Arrays from the SSA RAID Arrays menu. 2. A list of defined arrays is displayed: User’s Guide and Maintenance Information and press Enter.

  • Page 121: Listing All Supported Ssa Raid Arrays

    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 Otherwise, select List All Supported SSA RAID Arrays from the SSA RAID Arrays menu.

  • Page 122: Listing All Ssa Raid Arrays That Are Connected To A Raid Manager

    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 Otherwise, select List All SSA RAID Arrays Connected to a RAID Manager from the SSA RAID Arrays menu.
  • Page 123 3. A list of arrays is displayed: Chapter 6. Using the RAID Array Configurator...

  • Page 124: Listing The Status Of All Defined Ssa Raid Arrays

    Listing the Status of All Defined SSA RAID Arrays This option lists the status of each defined array. 1. For fast path, type Otherwise, select List Status of All Defined SSA RAID Arrays from the SSA RAID Arrays menu. 2. The following information is displayed: Select the type of RAID array for which you want to display the status.
  • Page 125 3. The following information is displayed for RAID-5 arrays: Chapter 6. Using the RAID Array Configurator...
  • Page 126 The following information is displayed for RAID-1 and RAID-10 arrays: Status data is given for the array and for each mirrored pair of disk drives in the array. The status values for the array are: good The status of all mirrored pairs is good. exposed The status of one or more mirrored pairs is exposed.
  • Page 127 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.

  • Page 128: Listing Or Identifying Ssa Physical Disk Drives

    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 Otherwise, select List/Identify SSA Physical Disks from the SSA RAID Arrays menu.

  • Page 129: Listing The Disk Drives In An Ssa Raid Array

    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 Otherwise: a. Select List/Identify SSA Physical Disks from the SSA RAID Arrays menu. b.
  • Page 130 3. A list of disk drives is displayed: User’s Guide and Maintenance Information...

  • Page 131: Listing Hot Spare Disk Drives

    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 Otherwise: a. Select List/Identify SSA Physical Disks from the SSA RAID Arrays menu. b.
  • Page 132 3. A list of hot spare disk drives is displayed: User’s Guide and Maintenance Information...

  • Page 133: Listing Rejected Array Disk Drives

    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 Otherwise: a. Select List/Identify SSA Physical Disks from the SSA RAID Arrays menu. b.
  • Page 134 3. A list of rejected disk drives is displayed: User’s Guide and Maintenance Information...

  • Page 135: Listing Array Candidate Disk Drives

    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 Otherwise: a. Select List/Identify SSA Physical Disks from the SSA RAID Arrays menu. b. Select List Array Candidate Disks. 2.
  • Page 136 3. A list of candidate disk drives is displayed: User’s Guide and Maintenance Information...

  • Page 137: Listing System Disk Drives

    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 Otherwise: a. Select List/Identify SSA Physical Disks from the SSA RAID Arrays menu. b.
  • Page 138 3. A list of system disk drives is displayed: User’s Guide and Maintenance Information...

  • Page 139: Identifying The Disk Drives In An Ssa Raid Array

    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 Otherwise: a. Select List/Identify SSA Physical Disks from the SSA RAID Arrays menu. b.
  • Page 140 3. The following information is displayed: 4. Select yes in the Flash Disk Identification Lights field. 5. Press the List key to list the disk drives. 6. From the displayed list, select the disk drives that you want to identify. The Check light flashes on each disk drive that you have selected.

  • Page 141: Identifying Hot Spare Disk Drives

    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 Otherwise: a. Select List/Identify SSA Physical Disks from the SSA RAID Arrays menu. b.
  • Page 142 3. The following information is displayed: 4. Select yes in the Flash Disk Identification Lights field. 5. Press the List key to list the disk drives. 6. From the displayed list, select the disk drives that you want to identify. The Check light flashes on each disk drive that you have selected.

  • Page 143: Identifying Rejected Array Disk Drives

    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 Otherwise: a. Select List/Identify SSA Physical Disks from the SSA RAID Arrays menu. b.
  • Page 144 3. The following information is displayed: 4. Select yes in the Flash Disk Identification Lights field. 5. Press the List key to list the disk drives. 6. From the displayed list, select the disk drives that you want to identify. The Check light flashes on each disk drive that you have selected.

  • Page 145: Identifying Array Candidate Disk Drives

    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 Otherwise: a. Select List/Identify SSA Physical Disks from the SSA RAID Arrays menu. b. Select Identify Array Candidate Disks. 2.
  • Page 146 3. The following information is displayed: 4. Select yes in the Flash Disk Identification Lights field. 5. Press the List key to list the disk drives. 6. From the displayed list, select the disk drives that you want to identify. The Check light flashes on each disk drive that you have selected.

  • Page 147: Identifying System Disk Drives

    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 Otherwise: a. Select List/Identify SSA Physical Disks from the SSA RAID Arrays menu. b.
  • Page 148 3. The following information is displayed: 4. Select yes in the Flash Disk Identification Lights field. 5. Press the List key to list the disk drives. 6. From the displayed list, select the disk drives that you want to identify. The Check light flashes on each disk drive that you have selected.

  • Page 149: Canceling All Ssa Disk Drive Identifications

    Canceling all SSA Disk Drive Identifications This option allows you to cancel all disk drive identifications. For fast path, type 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 drives stop flashing.

  • Page 150: Listing Or Deleting Old Raid Arrays Recorded In An Ssa Raid Manager

    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.
  • Page 151 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.
  • Page 152 5. If any old arrays are in the RAID manager, a list of those arrays appears: 6. If you want to delete any records, note the names of those records, and go to “Deleting an Old RAID Array Recorded in an SSA RAID Manager” on page 133. User’s Guide and Maintenance Information...
  • Page 153 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.
  • Page 154 4. The following information is displayed: Press the List key to list the records. 5. From the displayed list, select the record that you want to delete, and follow the instructions that are given on the screen. User’s Guide and Maintenance Information...

  • Page 155: Changing Or Showing The Attributes Of An Ssa Raid Array

    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 Otherwise, select Change/Show Attributes of an SSA RAID Array from the SSA RAID Arrays menu.
  • Page 156 4. A list of attributes is displayed: Move the cursor to the attribute that you want to change, and press the List key. 5. A list of options for that attribute is displayed. Select the option that you want. 6. If you want to change another attribute, move the cursor to that attribute and press the List key.

  • Page 157: Changing Member Disks In An Ssa Raid Array

    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.

  • Page 158: Removing A Disk Drive From An Ssa Raid Array

    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.
  • Page 159 3. The following information is displayed: Press the List key to list the disk drives. 4. From the displayed list, select the disk drive that you want to remove. 5. Physically remove the disk drive from the subsystem (see the Operator Guide or Service Guide for the unit).

  • Page 160: Adding A Disk Drive To An Ssa Raid Array

    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.
  • Page 161 3. The following information is displayed: Press the List key to list the disk drives. 4. From the displayed list, select the name of the disk drive that you are adding. Chapter 6. Using the RAID Array Configurator...

  • Page 162: Swapping Members Of An Ssa Raid Array

    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 Otherwise: a. Select Change Member Disks in an SSA RAID Array from the SSA RAID Arrays menu.
  • Page 163 3. The following information is displayed: Select Disk to Remove, and press the List key. 4. From the displayed list, select the disk drive that you want to remove, and press Enter. Note: If the disk drive that you are replacing has been removed, or the array has rejected it, it is listed as BlankReservedZ.

  • Page 164: Changing Or Showing The Use Of An Ssa Disk Drive

    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 Otherwise, select Change/Show Use of an SSA Physical Disk from the SSA RAID Arrays menu.
  • Page 165 3. A list of disk drives and their usage is displayed in a window: Using the arrow keys, scroll the information until you find the list of SSA physical disks that contains the disk drive that you want to change. Chapter 6.
  • Page 166 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: If you are only checking the use of the disk drive, and do not want to change it, go no further with these instructions.

  • Page 167: Changing The Use Of Multiple Ssa Physical Disks

    Changing the Use of Multiple SSA Physical Disks 1. For fast path, type 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: 3. Select the adapter. A list is displayed of the disk drives that are attached to the adapter: and press Enter.

  • Page 168: Copying Raid-1 Or Raid-10 Arrays

    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 chosen: 5.

  • Page 169: Chapter 7. Copying Data From Arrays And From Volume Groups

    Chapter 7. Copying Data from Arrays and from Volume Groups When disk drives are configured through the Logical Volume Manager for mirroring, you can use the Split Copy function to create a copy of a logical volume. You can then save that copy on a tape or other medium for backup purposes.
  • Page 170 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. You can, for example, use the ssa_make_copy and ssa_delete_copy commands for nightly backups when an automated closed circle of operations is required to: 1.

  • Page 171: Copying Data From An Array

    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 Array This section describes how to use the ssaraid command to create RAID-copy arrays.
  • Page 172 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. Type: A message is displayed;...
  • Page 173 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. To check whether the copy operation has completed, type: While the copy operation is running, the following information is included in the displayed data: When...
  • Page 174 8. The newly created RAID-Copy array is created as a free disk drive. You 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: The RAID-Copy array is now a system disk drive.

  • Page 175: Using Smit To Create A Raid-Copy Array From A Raid-1 Or Raid-10 Array

    Using SMIT to Create a RAID-Copy Array from a RAID-1 or RAID-10 Array 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”...
  • Page 176 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: 4. If you want to verify that all the data written to the copy is readable, select Verify copy during creation, and change the entry to yes.
  • Page 177 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. To check whether the copy operation has completed: a.
  • Page 178 6. To 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.

  • Page 179: Using The Ssa_Make_Copy Command To Create A Raid Copy From A Raid-1 Or Raid-10 Array

    Using the ssa_make_copy Command to Create a RAID Copy from a RAID-1 or RAID-10 Array Figure 22 shows a volume group that contains one physical volume: hdisk1. This hdisk is a RAID-1 array. Figure 22. A Volume Group the Contains One Physical Volume The ssa_make_copy command checks whether the hdisk is either a RAID-1 or a RAID-10 array.
  • Page 180 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 User’s Guide and Maintenance Information...

  • Page 181: Ssa_Make_Copy Command

    ssa_make_copy Command Purpose To create a RAID-Copy array from a RAID-1 or RAID-10 array. Syntax Description The ssa_make_copy command creates copy volume groups via the following process: 1. The command checks whether you can copy all or part of the volume group. v If you want to copy a whole volume group, the command checks whether all the hdisks in the volume group are RAID-1 or RAID-10 arrays.

  • Page 182: Flags

    c. If the dump logical volume and the boot logical volume are copied, a warning is displayed. You 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.
  • Page 183 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. Determines the name of the copy logical volume. If this flag is not provided, the default naming convention applies.

  • Page 184: Example 1: Copying A Complete Volume Group

    Example 1: Copying a Complete Volume Group In this example, you are copying a complete volume group from the parent array to the RAID-Copy array. To copy a complete volume group, give the commands: Figure 25. Copying a Complete Volume Group Figure 25 shows, from left to right: v The parent array that contains the source volume group.

  • Page 185: Example 2: Copying One Logical Volume

    Example 2: Copying One Logical Volume In this example, you are copying only one logical volume (-lv B) from the parent array to the RAID-Copy array. To copy one logical volume, give the commands: Figure 26. Copying One Logical Volume Figure 26 shows, from left to right: v The parent array that contains the source volume group.

  • Page 186: Example 3: Copying One Logical Volume By Logical Volume Name Or By Fs Name

    Example 3: Copying One Logical Volume by Logical Volume 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. You can use either the logical volume name (lv_A), or the FS name (data fs_1).
  • Page 187 Figure 27. Copying One Logical Volume or Copying by FS Name (1) 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.

  • Page 188: Example 4: Copying One Logical Volume By Logical Volume Name Or By Fs Name (2)

    Example 4: Copying One Logical Volume by Logical Volume 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. You can use either the logical volume name (lv_C), or the FS name (data_fs2).

  • Page 189: Example 4: Copying A Complete Volume Group And Recreating The Copy On Another Using System

    Example 4: Copying a Complete Volume 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: A message is displayed;...

  • Page 190: Example 5: Running An Automatic Copy Of A Volume Group

    Example 5: Running an Automatic Copy of a Volume Group 1. Prepare a volume group for copying: a. Give the command: b. Wait for the copy to complete. c. Wait for the external trigger to be created. 2. Uncouple the volume group: Give the command: 3.

  • Page 191: Ssa_Delete_Copy Command

    ssa_delete_copy Command Purpose To delete a RAID-Copy array after it has been backed up. Syntax Flags Deletes a copy and its RAID-Copy arrays. Deletes a copy and couples the RAID-Copy to its original parents. If the specified volume group is varied off, this flag forces the volume group to be exported.

  • Page 192: Smit Menus For 3-Way Copy Operations

    SMIT Menus for 3-Way Copy Operations This section describes the SMIT menus that are related to the 3-Way 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.

  • Page 193: Array Copy Services

    Array Copy Services For fast path access to the Array Copy Services menu, type 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 tool.
  • Page 194 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.
  • Page 195 Prepare a Copy For fast path, type Otherwise, select Prepare a Copy from the Array Copy Services menu. The Prepare a Copy menu is displayed: The meanings of the fields are: Array to be copied The array that you selected as the source data for the copy. Number of disk drives required The number of disk drives that must be coupled to the array to permit a copy to be performed.
  • Page 196 Hot spare selection Default Assigns the coupled disk drives to the pool to which those disk drives Primary Secondary To get more control over this process, use the ssaraid command directly from the command line or from inside a shell script (see “Using the ssaraid Command to Create a RAID-Copy Array from a RAID-1 or RAID-10 Array”...
  • Page 197 Uncouple a Volume Group, Logical Volumes, or Filesystems Copy For fast path, type Otherwise, select Uncouple a Volume Group, Logical Volumes, or Filesystems Copy from the Array Copy Services menu. The Uncouple a Volume Group, Logical Volumes or Filesystems Copy menu is displayed: The meanings of the fields are: Volume Group...
  • Page 198 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.
  • Page 199 List All Copy Candidates For fast path, type Otherwise, select List All Copy Candidates from the Array Copy Services menu. The following information is displayed: The columns of information displayed on the screen have the following meanings: Array The hdisk name of the RAID array. This field contains the array serial number if the array is not configured.
  • Page 200 Copying Degraded User’s Guide and Maintenance Information 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. A copy has been created, but one or more coupled disk drives are missing or have failed.
  • Page 201 List All Uncoupled Copies For fast path, type Otherwise, select List All Uncoupled Copies from the Array Copy Services menu. The following information is displayed: The columns of information displayed on the screen have the following meanings: Copy The name of the RAID-Copy array. Status The status of the RAID-Copy array.
  • Page 202 List All Uncoupled Volume Groups For fast path, type Otherwise, select List All Uncoupled Volume Groups from the Array Copy Services menu. The following information is displayed: The columns of information displayed on the screen have the following meanings: Copy The new volume group name that was created when the copy of the parent volume group was uncoupled.
  • Page 203 Delete a RAID Array Copy For fast path, type Otherwise, select Delete a RAID Array Copy from the Array Copy Services menu. The following information is displayed: If you select a raid_1 or a raid_10 array from the pop-up menu and press Enter, the coupled pdisks change to free disk drives.
  • Page 204 Delete a Volume Group, Logical Volumes, or Filesystems Copy For fast path, type Otherwise, select Delete a Volume Group, Logical Volumes, or Filesystems Copy from the Array Copy Services menu. The following information is displayed: If you select either the volume group name or any hdisk in that volume group, all the disk drives in the volume group are selected.
  • Page 205 The meanings of the fields are: Volume Group The volume group that you selected previously. Action The possible actions are: Delete and Detach Delete The volume group name is removed, and pdisks that are in each Delete and Recouple Force (Yes/No) If the specified volume group is varied off, yes forces the script to export the volume group.

  • Page 206: Effects Of Array Copy On Other Smit Menus

    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: The meanings of the additional fields are: Copy State...
  • Page 207 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.

  • Page 208: List Status Of All Defined Ssa Raid Arrays

    List Status Of All Defined SSA RAID Arrays For fast path, type 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: Status data is given for the array and each disk drive in the array. The status values for the array are: Good All the array components are present and operational.

  • Page 209: Identify Disks In An Ssa Raid Array

    Identify Disks in an SSA RAID Array For fast path, type 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: 1.

  • Page 210: Remove A Disk From An Ssa Raid Array

    Remove a Disk From an SSA RAID Array For fast path, type 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: The status values for coupled disk drives are: present...

  • Page 211: Swap Members Of An Ssa Raid Array

    Swap Members of an SSA RAID Array For fast path, type 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: The status values for coupled disks are: present...
  • Page 212 User’s Guide and Maintenance Information...

  • Page 213: Chapter 8. Split-Site Management

    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 drives;...

  • Page 214: Operation After A Loss Of Member Disks

    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.

  • Page 215: One Half Of The Array Is Not Present

    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 system: v One half of the array is not present.
  • Page 216 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 operation to the array occurs.
  • Page 217 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 operation to the array occurs.
  • Page 218 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 Offline state on both systems until either of the following occurs: v The primary disk drive becomes available.

  • Page 219: Split Systems

    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. Split Array Resolution System 1 SSA Adapter Figure 32. System 1 Split from System 2 On system 1, the array is in the Exposed or the Degraded state.
  • Page 220 Normal Reconnection: When the systems are reconnected, the secondary disk drives are resynchronized with the primary disk drives, as shown in Figure 33. Split Array Resolution System 1 SSA Adapter Figure 33. Reconnection of a Split Array The array enters the Good state for both systems. User’s Guide and Maintenance Information Split Array Resolution = Primary...
  • Page 221 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. Split Array Resolution = Primary System 1 System 2 SSA Adapter SSA Adapter Primary 1 Secondary 1 Figure 34.
  • Page 222 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 Offline state. If you set Split Array Resolution to Secondary, the array goes into the Good state. Figure 35.

  • Page 223: Array Is Offline Because Adapter Is Not Known To The Remaining Half Of The Array

    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. To 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 remains in the Offline state unless you take specific action to make the array available.
  • Page 224 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. System 1 SSA Adapter A System 3...

  • Page 225: Array Is Offline Because The Split And Join Procedure Was Not Performed Correctly

    v Change the state of the Split Array Resolution flag on the new adapters. Attention: 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 Was Not Performed Correctly When this condition occurs, the host system generates SRN 48760.
  • Page 226 RAID-10 Array Split Figure 39 shows a RAID-10 array that has been split into halves. Split Array Resolution System 1 SSA Adapter Figure 39. Forcing Access on a RAID-10 Array 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.
  • Page 227 RAID-10 Array with Unsynchronized Data Figure 40 shows a RAID–10 array whose halves have been reconnected. Split Array Resolution System 1 SSA Adapter Figure 40. Reconnecting an Unsynchronized Array Each half of the array contains different data, but no indication is given to which data is valid.
  • Page 228 User’s Guide and Maintenance Information...

  • Page 229: Chapter 9. Using The Ssa Spare Tool

    Chapter 9. Using the SSA Spare Tool The SSA Spare Tool helps you to manage your SSA networks when Logical Volume Manager (LVM) mirrored volume groups are used. It works with the LVM to identify stale partitions or missing physical volumes in LVM mirrored volume groups. If the SSA Spare Tool finds any stale partitions or missing physical volumes: v It automatically resynchronizes the stale partition if no replacement hardware is needed.
  • Page 230 User’s Guide and Maintenance Information...

  • Page 231: Chapter 10. Using The Fast-Write Cache Feature

    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 data in the write cache for seven days after power has been removed from the adapter card.
  • Page 232 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.

  • Page 233: Getting Access To The Fast-Write Menus

    Getting Access to the Fast-Write Menus 1. For fast-path access to the Fast-Write SMIT menus, type Enter. Otherwise: a. Type b. Select Devices. The Devices menu is displayed. c. Select SSA Disks. The SSA Disks menu is displayed. d. Select SSA Logical Disks. 2.

  • Page 234: Enabling Or Disabling Fast-Write For One Disk Drive

    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. Type b. From the menu displayed, select the logical disk that you want to change. Otherwise: a.

  • Page 235: Enabling Or Disabling Fast-Write For Multiple Devices

    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. You can select multiple devices from the list that this option displays.
  • Page 236 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) Type: 2) Run cfgmgr to reconfigure the new hdisk.

  • Page 237: Bypassing The Cache In A One-Way Fast-Write Network

    Bypassing the Cache in a One-Way 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.

  • Page 238: Dealing With Fast-Write Problems

    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 42521 v 42524...
  • Page 239 v To disable the fast-write cache, type: 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: The force attribute ensures that all data is lost from the fast-write cache.

  • Page 240: Srn 42524

    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. To list these devices, type: where X is the adapter number. Use the recovery procedure that is described for SRN 42521.

  • Page 241: Chapter 11. Ssa Error Logs

    Chapter 11. 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.

  • Page 242: Detailed Description

    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.
  • Page 243 Table 2. Error Labels (continued) Error Label Error ID SSA_DEVICE_ERROR FE9E9357 SSA_DISK_ERR1 1D2E2C3B SSA_DISK_ERR2 928F5165 SSA_DISK_ERR3 8BDD5B42 SSA_DISK_ERR4 F7863CFE : : : SSA_ENCL_ERR1 BD797922 : : : SSA_ENCL_ERR2 A5BED0BC SSA_HDW_ERROR 05F97A32 SSA_HDW_RECOVERED B3FF2B19 Error Description This error can be logged against the adapter or disk drive resource.
  • Page 244 Table 2. Error Labels (continued) Error Label Error ID SSA_LINK_ERROR ABECECFD SSA_LINK_OPEN 625E6B9A SSA_LOGGING_ERROR 610BDA5E SSA_SETUP_ERROR 48489B00 SSA_SOFTWARE_ERROR 91FBD5DB User’s Guide and Maintenance Information Error Description 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.
  • Page 245 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 Verification service aid, or give the ssaxlate -l hdisk command, to determine which pdisks are associated with the hdisk.
  • Page 246 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 DISK_ERR4 SSA_DISK_ERR1 SCSI sense data consists of 32 bytes of data. See “Error Log Analysis” on page 229 to find out how this data is used.
  • Page 247 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.

  • Page 248: Error Logging Management

    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 driver stops the repeated logging of the same error.

  • Page 249: Error Log Analysis

    Figure 41. Example of an Open Link Error 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.

  • Page 250: Detailed Description

    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.
  • Page 251 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) generate an SRN if more than a predetermined number of these errors exist in the log.

  • Page 252: Command Line Error Log Analysis

    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...

  • Page 253: Good Housekeeping

    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 analysis has detected any errors.
  • Page 254 User’s Guide and Maintenance Information...

  • Page 255: Chapter 12. Using The Ssa Command Line Interface For Raid Configurations

    Chapter 12. Using the SSA Command Line Interface for RAID Configurations You 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.
  • Page 256 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.

  • Page 257: Command Syntax

    Command Syntax Legend: RaidManager The name of the SSA adapter that has RAID array support. Name The name of the specific device upon which the operation is to be performed. See “Notes about the ssaraid Command” on page 236. Object Type The type of device upon which the operation is to be performed.

  • Page 258: Options

    Options You can use the following options with the ssaraid command: Option Description Print a short usage message. Perform an action on an object. Create an object. Delete an object. Change an object. Report information on an object. List all the available SSA RAID managers that are on the system. Show the hot spare pool information for an SSA RAID array.

  • Page 259: Examples

    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: To Create a RAID-0 Array This example shows how to use three SSA physical disks to create a RAID-0 array.

  • Page 260: Example 3: To Create A Raid-5 Array

    Example 3: To 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. Type the command: where: specifies that this operation is a create operation. specifies that RAID Manager ssa0 is to be used.

  • Page 261: Example 5: To Create A Hot Spare Pool

    Example 5: To 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.

  • Page 262: Example 7: To Change An Attribute Of An Object

    Example 7: To 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.

  • Page 263: Example 9: To Make A New System Disk

    Example 9: To Make a New System Disk This example shows how use a single SSA disk to make a new system disk. Type the command: where: specifies that this operation is a change operation. specifies the RAID manager that is to be used. specifies the pdisk that is to be changed to a system disk.

  • Page 264: Ssaraid Command Attributes

    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 you can use for: v All RAID arrays v RAID-1, RAID-5, and RAID-10 arrays only...
  • Page 265 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 operations to this disk drive continue.
  • Page 266 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 write operation, data might be lost.
  • Page 267 Creation and Change Attributes for RAID-1 and RAID-10 Arrays Only You can specify the following attributes with the ssaraid command with the array: split_resolution=primary/secondary (default=primary) This attribute selects the copy of the data that is to remain available if the primary disk drive is completely separated from the secondary disk drive.

  • Page 268: Raid Arrays Change Attributes

    Creation and Change Attribute for RAID-5 Arrays Only You can specify the following attribute with the ssaraid command with the 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 operations to the cache.

  • Page 269: Hot Spare Pool Creation And Change Attribute

    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 You can specify the following attribute with the ssaraid command with the minimum_spares(default=0) This attribute determines the minimum number of hot spare disk drives that...
  • Page 270 Other Change Attributes for Physical Disk Drives You can specify the following attributes with the ssaraid command with the 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 the physical disk drive.

  • Page 271: Action Attributes (Raid-1, Raid-5, And Raid-10 Only)

    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 as yes to allow the fast-write cache to be disabled.

  • Page 272: Couple Action Attributes (Raid-1 And Raid-10 Only)

    Couple Action Attributes (RAID-1 and RAID-10 Only) You can specify the following attributes with the -a option when you are using the ssaraid command with the 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.

  • Page 273: Return Codes

    Return Codes Code Description Successful. Some changes made, but finally not successful. General problem accessing the object data manager (ODM). Specified object (file, record, ODM object) not found. Heap allocation failed. Open/ioctl failure for RAID manager. Bad Transaction result. Array already known to cfgmgr. System call failed.
  • Page 274 User’s Guide and Maintenance Information...

  • Page 275: Chapter 13. Using The Programming Interface

    Chapter 13. Using the Programming Interface SSA Subsystem Overview Device Drivers Two 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.

  • Page 276: Interface Between The Ssa Adapter Device Driver And Head Device Driver

    Interface between the SSA Adapter Device Driver and Head Device Driver To 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.

  • Page 277: Ssa Adapter Device Driver

    SSA Adapter Device Driver Purpose To provide support for the SSA adapter. Syntax #include /usr/include/sys/ssa.h #include /usr/include/sys/devinfo.h Description The /dev/ssan 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 device drivers and application programs can all access a particular SSA adapter and its connected devices at the same time.

  • Page 278: Open And Close Subroutines

    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 be using that adapter device driver at the time.

  • Page 279: Summary Of Ssa Error Conditions

    You 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 errno is set to a value from the file /usr/include/sys/errno.h.

  • Page 280: Files

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

  • Page 281: Iocinfo (Device Information) Ssa Adapter Device Driver Ioctl Operation

    IOCINFO (Device Information) SSA Adapter Device Driver ioctl Operation Purpose To 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 operation.

  • Page 282: Ssa_Transaction Ssa Adapter Device Driver Ioctl Operation

    SSA_TRANSACTION SSA Adapter Device Driver ioctl Operation Purpose To 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.

  • Page 283: Return Values

    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 Attention: This is a very low-level interface. It is for use only by configuration methods and diagnostics software.

  • Page 284: Ssa_Get_Entry_Point Ssa Adapter Device Driver Ioctl Operation

    SSA_GET_ENTRY_POINT SSA Adapter Device Driver ioctl Operation Purpose To 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 that is supplied is valid only while the calling kernel extension holds an open file descriptor for the SSA adapter device driver.

  • Page 285: Ssa Adapter Device Driver Direct Call Entry Point

    SSA Adapter Device Driver Direct Call Entry Point Purpose To 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.

  • Page 286: Ssadisk Ssa Disk Device Driver

    ssadisk SSA Disk Device Driver Purpose To 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 the operating system as SSA logical disks (hdisk0, hdisk1...hdiskN) and SSA physical disks (pdisk0,pdisk1...pdiskN).

  • Page 287: Multiple Adapters

    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.

  • Page 288: Configuring Ssa Disk Drive Devices

    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”...
  • Page 289 Using mkdev to Configure a Physical Disk To use mkdev to configure an SSA physical disk, specify the following information: Parent ssar Class pdisk Subclass ssar Type You can list the types by typing: ConnectionLocation 15-character unique identifier of the disk drive. You can determine the unique identifier in three ways: v If the disk drive is already defined, you can use the lsdev command to determine the unique identity, as follows:...

  • Page 290: Device Attributes

    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. You 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.
  • Page 291 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.

  • Page 292: Device-Dependent Subroutines

    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), where n is the number of disks in the array.
  • Page 293 secondary path, if one exists. You 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. You cannot specify this flag and the SSADISK_SECONDARY flag together.

  • Page 294: Error Conditions

    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. You cannot specify this flag and the SSADISK_SCSIMODE flag together.
  • Page 295 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. EFAULT Illegal user address. EINVAL 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.

  • Page 296: Special Files

    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.

  • Page 297: Iocinfo (Device Information) Ssa Disk Device Driver Ioctl Operation

    IOCINFO (Device Information) SSA Disk Device Driver ioctl Operation Purpose To 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 field for this component is DD_SCDISK;...

  • Page 298: Ssadisk_Isal_Cmd (Isal Command) Ssa Disk Device Driver Ioctl Operation

    SSADISK_ISAL_CMD (ISAL Command) SSA Disk Device Driver ioctl Operation Purpose To 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 Technical Reference for the adapter.

  • Page 299: Return Values

    The SSADISK_ISAL_CMD ioctl uses the following fields of the ssadisk_ioctl_parms structure: 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 by IPN for the command.

  • Page 300: Files

    Files /dev/pdisk0, /dev/pdisk1, ..., /dev/pdiskn Provide an interface to allow SSA device drivers to access SSA physical disk drives. /dev/hdisk0, /dev/hdisk1,..., /dev/hdiskn Provide an interface to allow SSA device drivers to access SSA logical disk drives. User’s Guide and Maintenance Information...

  • Page 301: Ssadisk_Isalmgr_Cmd (Isal Manager Command) Ssa Disk Device Driver Ioctl Operation

    SSADISK_ISALMgr_CMD (ISAL Manager Command) SSA Disk Device Driver ioctl Operation Purpose To 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 is described in the Technical Reference for the adapter.

  • Page 302: Return Values

    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.

  • Page 303: Ssadisk_Scsi_Cmd (Scsi Command) Ssa Disk Device Driver Ioctl Operation

    SSADISK_SCSI_CMD (SCSI Command) SSA Disk Device Driver ioctl Operation Purpose To 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 issue an SSA-SCSI command to a selected physical disk.

  • Page 304: Return Values

    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 SSA physical disk.

  • Page 305: Ssadisk_List_Pdisks Ssa Disk Device Driver Ioctl Operation

    SSADISK_LIST_PDISKS SSA Disk Device Driver ioctl Operation Purpose To 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).

  • Page 306: Return Values

    Return Values 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: An unrecoverable I/O error has occurred. ENOMEN The device driver was unable to allocate or pin enough memory to complete the operation.

  • Page 307: Ssa Disk Concurrent Mode Of Operation Interface

    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.

  • Page 308: Top Kernel Extension Entry Point

    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 EINVAL 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.
  • Page 309 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.

  • Page 310: Ssa Disk Fencing

    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.

  • Page 311: Ssa Target Mode

    SSADISK_FORCED_OPEN to the openx subroutine, the reservation is broken, but the open fails with errno set to ENOCONNECT. To 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.

  • Page 312: Configuring The Ssa Target Mode

    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: The blocking method, which waits until the I/O is complete or an error occurs before it returns control to you.

  • Page 313: Buffer Management

    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.

  • Page 314: Using Ssa Target Mode

    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 Target Mode SSA Target Mode does not attempt to manage the data transfer between devices.

  • Page 315: Ssa Tmssa Device Driver

    SSA tmssa Device Driver Purpose To 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 device driver provides an interface to allow using-system to using-system data transfer by using an SSA interface.

  • Page 316: Configuration Information

    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.

  • Page 317: Close Subroutine

    EINVAL 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. 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 or initiator device.
  • Page 318 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.
  • Page 319 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_NDELAY flag set, and the write request is for a length that is greater than the total buffer size of the device, the write request fails.
  • Page 320 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 TMCHGIMPARM 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 related to the operation of the hardware at the time of the write operation.
  • Page 321 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. TMCHGIMPARM Allows the caller to change some parameters that are used by the target mode device driver for a particular device instance.

  • Page 322: Errors

    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.
  • Page 323 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.

  • Page 324: Tmssa Special File

    tmssa Special File Purpose To 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.

  • Page 325: Iocinfo (Device Information) Tmssa Device Driver Ioctl Operation

    IOCINFO (Device Information) tmssa Device Driver ioctl Operation Purpose To 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.
  • Page 326 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. User’s Guide and Maintenance Information...

  • Page 327: Tmiostat (Status) Tmssa Device Driver Ioctl Operation

    TMIOSTAT (Status) tmssa Device Driver ioctl Operation Purpose To 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 might still be running, you must ensure that the status information applies to a particular write operation.

  • Page 328: Tmchgimparm (Change Parameters) Tmssa Device Driver Ioctl Operation

    TMCHGIMPARM (Change Parameters) tmssa Device Driver ioctl Operation Purpose To 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.
  • Page 329 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.
  • Page 330 User’s Guide and Maintenance Information...

  • Page 331: Part 2. Maintenance Information

    Part 2. Maintenance Information...
  • Page 332 User’s Guide and Maintenance Information...

  • Page 333: Chapter 14. Ssa Adapter 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.

  • Page 334: Microcode Maintenance

    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.

  • Page 335: Maintaining The Adapter Microcode

    Diagnostic Information for Multiple Bus Systems manual). The microcode level is shown in the ROS level field. Alternatively, give the following command: adapter where You can determine the disk drive microcode level by using the Display/Download Disk Drive Microcode SSA service aid (see “Display/Download Disk Drive Microcode Service Aid”...

  • Page 336: Vital Product Data (Vpd) For The Ssa Adapter

    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.

  • Page 337: Adapter Power-On Self-Tests (Posts)

    Adapter Power-On Self-Tests (POSTs) Power-on self-tests (POSTs) 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.
  • Page 338 User’s Guide and Maintenance Information...

  • Page 339: Chapter 15. Removal And Replacement Procedures

    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. To do this, you can either use the Configuration Verification service aid (see “Configuration Verification Service Aid”...
  • Page 340 3. Select the array that you want to delete. User’s Guide and Maintenance Information...
  • Page 341 4. A prompt is displayed in a window: 5. Attention: When an array is deleted, all the data that is contained in that array is lost. At the prompt, press Enter if you want to delete the array. Press Cancel if you do not want to delete the array.
  • Page 342 7. Attention: You should be here only if you are working with a RAID-1, RAID-5, or RAID-10 array. For fast path, type 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.
  • Page 343 9. The following information is displayed: Press F4 to list the disk drives. 10. A list of disk drives is displayed. From the displayed list, select the disk drive that you want to remove. 11. If necessary, use the Identify function to find the disk drive that you want to remove (see “Finding the Physical Location of a Device”...
  • Page 344 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: pdisk and hdisk numbers might be different on each system. If you are not sure what the pdisk and hdisk numbers are on either system, give the command: where NNNNNNNN is the serial number on the front of the removed disk drive.
  • Page 345 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. Type and press Enter. 25.

  • Page 346: Changing Pdisk And Hdisk Numbers

    Changing Pdisk and Hdisk Numbers Pdisk and hdisk numbers are assigned automatically when the using system is configured. To help in system administration, it is sometimes useful to change these numbers. If you want to change the numbers, use the following procedure: 1.

  • Page 347: Removing And Replacing An Advanced Serialraid Adapter

    Removing and Replacing an Advanced SerialRAID Adapter Attention: (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.
  • Page 348 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.

  • Page 349: Removing An Sdram Module Of An Advanced Serialraid 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).

  • Page 350: Installing An Sdram Module Of An Advanced Serialraid Adapter

    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 SDRAM.
  • Page 351 4. Refer to Figure 45. Figure 45. Installing the SDRAM Module 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.

  • Page 352: Removing The Fast-Write Cache Option Card Of An Advanced Serialraid Adapter

    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.
  • Page 353 5. Refer to Figure 47. Figure 47. Removing the Fast-Write Cache Option Card 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 . Chapter 15. Removal and Replacement Procedures...

  • Page 354: Installing The Fast-Write Cache Option Card Of An Advanced Serialraid Adapter

    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 Service Guide for the using system).
  • Page 355 6. Refer to Figure 49. Figure 49. Installing the Mounting Screw of the Fast-Write Cache Option Card 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).

  • Page 356: Removing The Battery Assembly From The Fast-Write Cache Option Card Of An Advanced Serialraid Adapter

    Removing the Battery Assembly from the Fast-Write Cache Option Card of an Advanced SerialRAID Adapter 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.
  • Page 357 6. Refer to Figure 51. Figure 51. Disconnecting the Battery Assembly 7. Invert the Fast-Write Cache Option card. 8. Carefully unplug the battery assembly from the connector 1 . Chapter 15. Removal and Replacement Procedures...

  • Page 358: Installing A Battery Assembly Into The Fast-Write Cache Option Card Of An Advanced Serialraid Adapter

    Installing a Battery Assembly into the Fast-Write Cache Option Card of an Advanced SerialRAID Adapter 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.
  • Page 359 4. Refer to Figure 53. Figure 53. Installing the Battery Assembly 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.

  • Page 360: Part Numbers

    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 User’s Guide and Maintenance Information...

  • Page 361: Chapter 16. Using The Ssa Command Line Utilities

    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 messages.

  • Page 362: Examples

    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 To install the latest level of microcode on all available SES enclosures, give the command: To install microcode file coral1014.hex on enclosure0, give the command: To install microcode file coral1014.hex on all available SES enclosures whose existing...

  • Page 363: Ssaadap Command

    ssaadap Command Purpose To list the adapters to which a logical disk or physical disk is connected. Syntax 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 primary adapter.

  • Page 364: Ssacand Command

    ssacand Command Purpose To display the unused connection locations for an SSA adapter. Syntax 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 disk drives.

  • Page 365: Ssa_Certify Command

    ssa_certify Command Purpose v To certify the physical disk drive so that data can be read from, or written to, the disk drive without problems. v To certify a RAID-5 array to determine whether any array logical block addresses (LBAs) have been as unreadable. Syntax Description If the ssa_certify command is issued to a pdisk, it uses the ISAL_Read, ISAL_Write,...
  • Page 366 reassign operations. You 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 Maximum value that can be specified for this flag = 10240 kilobytes.

  • Page 367: Ssaconn Command

    ssaconn Command Purpose To display the SSA connection details for the physical disk. Syntax Description The ssaconn command performs a function that is similar to the Link Verification service aid. The output from this command is: The four hop counts represent the number of SSA devices that are between the physical disk and the A1, A2, B1, and B2 ports of the adapter, respectively.

  • Page 368: Ssa_Diag Command

    ssa_diag Command Purpose To run diagnostic tests to a specified device. Syntax Description The ssa_diag command is in /usr/lpp/diagnostics/bin. Flags 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. Forces a disk reservation to be broken if the device the device that is being tested is a disk drive.

  • Page 369: Ssadisk Command

    ssadisk Command Purpose To display the names of disk drives that are connected to an SSA adapter. Syntax 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 their adapter_a or adapter_b attribute.

  • Page 370: Ssadload Command

    ssadload Command Purpose To download microcode to SSA physical disk drives. Syntax Description The ssadload command performs microcode downloads to SSA physical disk drives. The command has three modes of operation: v Load a specific level of microcode into a specific SSA physical disk drive. Using the command in this mode, you can force load any available level of microcode into any compatible SSA disk drive.

  • Page 371: Flags

    Flags -d PhysicalDiskName Specifies the physical disk drive that is to receive the microcode. -f CodeFileName Specifies the microcode file to be downloaded. 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 loaded with the latest microcode.
  • Page 372 v Using the -s and -a adapter flags: 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: With these flags, the command causes the update mechanism to run in parallel and update concurrently the microcode on all the available disk drives that are connected to adapters ssa0 and ssa1.

  • Page 373: Ssa_Ela Command

    ssa_ela Command Purpose To look for the most significant error in the error log. Syntax 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 device that is on the system.

  • Page 374: Output

    Output If an error occurs, the ssa_ela command sends an error message to stdout, such as: 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.

  • Page 375: Ssaencl Command

    ssaencl Command Purpose To allow the monitoring and changing of the status for SSA SES disk enclosures (subsystems). Syntax To display enclosure component settings: To modify enclosure component settings: To display a usage message: Description The ssaencl command can be used to observe the existing settings of an SSA SES disk enclosure (subsystem), or to modify the settings of that enclosure.
  • Page 376 -t [threshold] Displays all the temperature thresholds, or only the specified temperature thresholds. The valid values for the [threshold] parameter are: lowarn locrit hiwarn hicrit Displays the ambient temperature of the enclosure. -f [fan] Displays the status of all the fans, or of only the specified fans. Valid values for the [fan] parameter are: 1, 2, 3, and so on.

  • Page 377: Examples

    -S b[card ...] Resets the flag for the bypass card. Valid 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). Valid values for PSU are 1, 2. -S r Resets the flag for remote power on (RPO).

  • Page 378: Ssa_Format Command

    ssa_format Command Purpose To format the specified device. Syntax Description The ssa_format -l pdisk command opens the pdisk special file, and uses the ISAL Format command to format the device. You can close the device while the format operation is running. If the command cannot format the device, it prints an error message.

  • Page 379: Output

    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 Output The ssa_format command sends all error messages to stderr. battery.

  • Page 380: Ssa_Fw_Status Command

    ssa_fw_status Command Purpose To show the status of the fast-write cache. Syntax 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. Displays the expected life of the battery. Displays the number of hours for which the battery has been powered-on.

  • Page 381: Ssa_Getdump Command

    ssa_getdump Command Purpose To display SSA adapter dump locations, and to save the dump to a specified location. Syntax For the List version of the command: For the Copy version of the command: Description The ssa_getdump command has two modes of operation: List mode and Copy mode. List Mode In List mode, the command searches for adapter dumps on unused SSA disk drives.

  • Page 382: Flags

    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 You must use one of these flags: Specifies that the program is to operate in List mode.

  • Page 383: Output

    -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 shown in the List Output.

  • Page 384: Ssaidentify Command

    ssaidentify Command Purpose To set or clear Identify mode for a physical disk. Syntax 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 flag switches off Identify mode.

  • Page 385: Ssa_Progress Command

    ssa_progress Command Purpose To 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”, or “Failed”. Syntax Description The ssa_progress command opens the pdisk special file, and uses the ISAL Progress command to determine the percentage of the formatting operation that is complete.

  • Page 386: Ssa_Rescheck Command

    ssa_rescheck Command Purpose To report the reservation status of an hdisk. Syntax 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.

  • Page 387: Examples

    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. The next example shows the disk drive Open by adapter ssa1. The disk drive is reserved to ssa1, and adapter ssa0 has a Busy status.

  • Page 388: Ssa_Servicemode Command

    ssa_servicemode Command Purpose To put the disk drive into Service Mode (set Service Mode), or to remove the disk drive from Service Mode (reset Service Mode). Syntax Description The ssa_servicemode command opens the adapter special file, and sends the appropriate IACL command to put the disk drive into, or remove it from, Service Mode. When the Service Mode has been successfully set or reset, the IACL command closes the adapter special file.

  • Page 389: Ssa_Speed Command

    ssa_speed Command Purpose To determine the operating speed of SSA links. Syntax 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 using system. Flags -l pdisk Specifies the pdisk that you want to test.

  • Page 390: Output

    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 To display the link speed of pdisk0, give the command: v To display the adapter link speeds of ports A1 and A2 on ssa0, give the command: v To display the adapter link speeds of all the devices in network B on ssa0, give the command:...

  • Page 391: Ssavfynn Command

    ssavfynn Command Purpose To 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 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 numbers on the SSA network, it returns no message.

  • Page 392: Ssaxlate Command

    ssaxlate Command Purpose To translate between logical disks (hdisks) and physical disks (pdisks). Syntax 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 output is a list of names of the logical disks that use that physical disk.

  • Page 393: Chapter 17. Ssa Service Aids

    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.
  • Page 394 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. User’s Guide and Maintenance Information...

  • Page 395: The Identify Function

    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, two seconds off), but has no effect on the normal operation of the disk drive.

  • Page 396: Starting The Ssa Service Aids

    Starting the SSA Service Aids To 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.
  • Page 397 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 Verification Service Aid” on page 383 “Configuration Verification Service Aid” on page 387 “Format Disk Service Aid” on page 389 “Certify Disk Service Aid”...

  • Page 398: Set Service Mode Service Aid

    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.
  • Page 399 To 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: The columns of information displayed on the screen have the following meanings: systemname pdisk0 through pdisk8 AC50AE43 through AC1DBE32...
  • Page 400 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: User’s Guide and Maintenance Information...
  • Page 401 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.
  • Page 402 4. Select a second disk drive if required (for example, pdisk5). The following display appears again: 5. Select Service Mode or the Identify function. If the original disk drive is to remain in Service Mode, you can select only the Identify function now. (Only one disk drive at a time can be in Service Mode.) The list of pdisks appears again.

  • Page 403: Link Verification Service Aid

    Link Verification Service Aid The Link Verification 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 To use the Link Verification service aid:...
  • Page 404 3. When you have selected an adapter, a list is displayed that shows all the devices that are connected to the adapter: The columns of information displayed on the screen have the following meanings: v The Physical column lists the devices as they appear on the SSA loop. A device can be either a pdisk, or an adapter.
  • Page 405 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.
  • Page 406 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 ***** For example: This example shows that the SSA loop is broken between pdisk2 and pdisk3, and that an unconfigured device is present between pdisk6 and pdisk0.

  • Page 407: Configuration Verification Service Aid

    Configuration Verification Service Aid The Configuration Verification 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.
  • Page 408 2. Select the hdisk or pdisk that you want to verify. 3. If you select an hdisk, a list of pdisks is displayed: If you select a pdisk, a list of hdisks is displayed: Note: If you select the hdisk from this screen, the hdisk configuration is displayed. User’s Guide and Maintenance Information...

  • Page 409: Format Disk Service Aid

    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. To use the Format Disk service aid: 1.
  • Page 410 2. Select the pdisk that you want to format. The following instructions are displayed: 3. If you are not sure of the identification (pdisk number) of the disk drive that you want to format, use the Identify function to get a positive physical identification of the disk drive (see “The Identify Function”...

  • Page 411: Certify Disk Service Aid

    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. To use the Certify Disk service aid: 1.
  • Page 412 2. Select the pdisk that you want to certify. The following instructions are displayed: 3. If you are not sure of the identification (pdisk number) of the disk drive that you want to certify, use the Identify function to get a positive physical identification of the disk drive (see “The Identify Function”...

  • Page 413: Display/Download Disk Drive Microcode Service Aid

    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 diskette.
  • Page 414 To 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: 2. To display the levels of microcode that are installed on the SSA disk drives, select Display the Microcode levels of all SSA Physical Disk Drives.
  • Page 415 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 exchange the electronics card assembly of the disk drive.

  • Page 416: Link Speed Service Aid

    Link Speed Service Aid The Link Speed service aid allows you to display the operating speed of each link on an SSA adapter. To use the Link Speed service aid: 1. Select Link Speed from the SSA Service Aids menu (see “Starting the SSA Service Aids”...
  • Page 417 2. Select the adapter that you want to inspect. A list of link speeds is displayed, as shown in this example screen: The screen shows an adapter that has four disk drives connected between ports A1 and A2, and two disk drives connected between ports B1 and B2. The link between pdisk1 and pdisk2 is working at 20 MB per second.
  • Page 418 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.
  • Page 419 This screen shows the same configuration, but here the link is broken between pdisk1 and pdisk2. Figure 55 gives a physical representation of the configuration that is shown on the screen. Disk 40 MB/s 40 MB/s Disk 40 MB/s 40 MB/s Figure 55.

  • Page 420: Service Aid Service Request Numbers (Srns)

    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)”...

  • Page 421: Example 1. Normal Loops

    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 .
  • Page 422 For this example, the Link Verification service aid displays the following information: Note: Scroll the display to see all the connected disk drives. User’s Guide and Maintenance Information...

  • Page 423: Example 2. Broken Loop (Cable Removed)

    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.
  • Page 424 Using system A1 A2 B1 B2 Disk Disk Disk Disk Disk Disk Figure 57. Broken Loop (Cable Removed) User’s Guide and Maintenance Information Using system A1 A2 B1 B2 Disk Disk Disk Disk Disk Disk Disk Disk Disk Disk...
  • Page 425 For this example, the Link Verification service aid displays the following information: Note that the column for adapter connector A2 shows no connections. Chapter 17. SSA Service Aids...

  • Page 426: Example 3. Broken Loop (Disk Drive Removed)

    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.
  • Page 427 Using system A1 A2 B1 B2 Disk Disk Disk Disk Disk Disk Figure 58. Broken Loop (Disk Drive Removed) Using system A1 A2 B1 B2 Disk Disk Disk Disk Disk Disk Disk Disk Disk Disk Chapter 17. SSA Service Aids...
  • Page 428 For this example, the Link Verification service aid displays the following information: Note that the missing disk drive (pdisk8) is represented by a line of question marks. User’s Guide and Maintenance Information...

  • Page 429: Finding The Physical Location Of A Device

    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.
  • Page 430 User’s Guide and Maintenance Information...

  • Page 431: Chapter 18. Ssa Problem Determination Procedures

    Chapter 18. SSA Problem Determination Procedures SSA problem determination procedures are provided by power-on self-tests (POSTs), 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.
  • Page 432 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 Verification” on page 475 to verify the repair. 4.
  • Page 433 Problem 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. 20PAA Description: An open SSA link has been detected. Action: Run the Link Verification service aid to isolate the failure (see “Link Verification Service Aid”...
  • Page 434 Problem 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. 2A005 Description: SRNs in this range are not adapter SRNs. Action: For SRNs in this range, see the documentation for your SSA 2A206 enclosure or SSA subsystem.
  • Page 435 Problem 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.
  • Page 436 Problem 40128 Description: A 128 MB SDRAM in the adapter card module has failed. Action: Exchange the FRUs for new FRUs. 42000 Description: Either no SDRAM module is present on the adapter card, or the POST cannot determine the size of the existing SDRAM module. Action: Install an SDRAM module of the correct size, or exchange the existing SDRAM module for a new one of the correct size.
  • Page 437 Problem 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.
  • Page 438 Problem 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.
  • Page 439 Problem 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.
  • Page 440 Problem 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: –...
  • Page 441 Problem 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 contain data that should be kept: 1.
  • Page 442 Problem 4252C Description: The Fast-Write Cache Option Card battery needs to be exchanged for a new one. Action: Exchange the FRU for a new FRU. 4252D Description: Fast-write caching is suspended (stopped temporarily) for one or more devices. Action: 1. Type 2.
  • Page 443 Problem 43PAA 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 Verification service aid (see “Link Verification Service Aid” on page 383) to determine which device is preventing configuration.
  • Page 444 Problem 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.
  • Page 445 Problem 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.
  • Page 446 Problem 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 unavailable because an unrecoverable error has occurred, you can force access to the available half of the array.
  • Page 447 Problem 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. 48800 Description: The Invalid-strip-table is full.
  • Page 448 Problem 48950 Description: A disk drive has caused an array building operation to fail. Action: 1. Type and press Enter. 2. Select List all Defined SSA RAID Arrays. The hdisk that is causing this problem is listed as exposed or degraded.
  • Page 449 Problem 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.
  • Page 450 Problem 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. To do this action: 1. Display the use of the disk drives that are attached to the SSA adapter that logged the error (see “Changing or Showing the Use of an SSA Disk Drive”...
  • Page 451 Problem 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.
  • Page 452 Problem 49520 Description: Hot-spare tuning has been lost. Action: 1. Type 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 status of mixed.
  • Page 453 Problem 49530 Description: The number of disk drives that remain in a hot-spare pool is less than the specified number. Action: 1. Type 2. Select Change/Show Use of an SSA Physical Disk. 3. Note all the disk drives that are listed as rejected. 4.
  • Page 454 Problem 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.
  • Page 455 Problem 50002 Description: An SSA adapter DMA error has occurred. Action: Exchange the FRU for a new FRU. 50007 Description: The IOCC detected an internal error. Action: Exchange the FRU for a new FRU. 50008 Description: Unable to read or write the POS registers or PCI configuration space.
  • Page 456 Problem 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. You can use the ssavfynn command line utility (see “ssavfynn Command” on page 371) to determine which node has the duplicate node number.
  • Page 457 Problem 504XX Description: The SSA adapter microcode has hung. Action: Run diagnostics in System Verification 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.
  • Page 458 Problem D4000 Description: The diagnostics cannot configure the SSA adapter. Action: Exchange the FRU for a new FRU. D4050 Description: The Enhanced Error Handling test has failed. Action: Exchange the FRUs for new FRUs. D4100 Description: The diagnostics cannot open the SSA adapter. Action: Exchange the FRU for a new FRU.
  • Page 459 Problem 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.
  • Page 460 Problem 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 Verification service aid (see “Configuration Verification Service Aid”...

  • Page 461: Software And Microcode Errors

    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.
  • Page 462 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. User’s Guide and Maintenance Information...

  • Page 463: Ssa Maintenance Analysis Procedures (Maps)

    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.

  • Page 464: Map 2010: Start

    MAP 2010: START 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. You might have been sent here because: v The system problem determination procedures sent you here.

  • Page 465: Map 2320: Ssa Link

    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.
  • Page 466 If the service aid cannot detect any pdisks, a message is displayed: Are any pdisks listed for the selected SSA adapter? 4. (from step 3) Observe the Status column on the screen. If the status of any pdisk is ‘Power’, that pdisk has detected a loss of redundant power or cooling.
  • Page 467 Does one of the pdisks have a ‘Power’ status? Go to step 5 on page 448. Go to the START MAP for the enclosure in which the SSA device is installed. Chapter 18. SSA Problem Determination Procedures...
  • Page 468 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. Is one of the pdisks failing? Go to step 6 on page 449. a.
  • Page 469 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. Is a link broken between two pdisks? No trouble found.

  • Page 470: Map 2323: Ssa Intermittent Link Error

    MAP 2323: SSA Intermittent Link Error This MAP helps you to isolate FRUs that are causing an intermittent SSA link problem. You 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”...
  • Page 471 a. Observe the SRN that sent you to this MAP. The last three characters are in the format PAA, where P is the number of the SSA adapter port, and AA is the SSA address of the device). Note the value of PAA in the SRN. For example: If the SRN is 24002, PAA = 002.
  • Page 472 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 (PAA−1).
  • Page 473 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.

  • Page 474: Map 2324: Ssa Raid

    MAP 2324: SSA RAID This MAP helps you to solve problems that have occurred in SSA RAID arrays. Attention: 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 connect devices to the using system can be disconnected while that system is running.
  • Page 475 3. (from step 2) Do you have any other SRN? 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. Cause 46000 An array is in the Offline state.
  • Page 476 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.
  • Page 477 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. Type 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”? Ask the user to delete and recreate the array that is in the Offline state.
  • Page 478 9. (from step 4) Attention: 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. Type b. Select List Status Of All Defined SSA RAID Arrays. c.
  • Page 479 10. (from step 9) a. Type 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.
  • Page 480 12. (from step 11) Did the Certify service aid fail again? a. Ask the user to recreate the array. b. Go to step 22 on page 467. a. Exchange the failing disk drive for a new one (see “Exchanging Disk b.
  • Page 481 14. (from step 13) Are any disk drives listed as “SSA physical disks that are rejected”? A disk drive has not been detected by the adapter. Go to step 15 on page 462. a. Run diagnostics in System Verification mode to all the disk drives that are listed as rejected.
  • Page 482 k. Go to “MAP 2410: SSA Repair Verification” on page 475 to verify the 15. (from step 14) Does the Link Verification service aid indicate an open loop? Go to step 16. Go to “MAP 2320: SSA Link” on page 445. 16.
  • Page 483 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.
  • Page 484 18. (from step 17) Are any disk drives listed as “SSA physical disks that are rejected”? A disk drive has not been detected by the adapter. Go to step 19 on page 465. a. Run diagnostics in System Verification mode to all the disk drives that b.
  • Page 485 When the rebuilding operation is complete, ask the user to run diagnostics in System Verification mode to the SSA adapters, to ensure that the rebuilding operation has not found any more problems. k. Go to “MAP 2410: SSA Repair Verification” on page 475 to verify the repair.
  • Page 486 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).
  • Page 487 22. (from step 7 in MAP 2410: SSA Repair Verification, and from steps 3, 11, and 12 in this MAP) RAID Checkout You are now starting the RAID checkout procedure a. Type b. Select Change/Show Use of an SSA Physical Disk from the SSA RAID Arrays menu.
  • Page 488 25. (from step 24) Does the Link Verification service aid indicate an open loop? 26. (from step 25) Does any SSA disk drive have its Check light on? User’s Guide and Maintenance Information c. If problems occur on any disk drive, exchange that disk drive for a new disk drive (see “Exchanging Disk Drives”...
  • Page 489 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).
  • Page 490 27. (from step 22) Is any disk drive failing? 28. (from steps 22 and 27) a. Type b. Select List All SSA RAID Arrays Connected to a RAID Manager. c. List the arrays that are connected to each SSA Adapter. Are any arrays listed with a status other than Good or Rebuilding? 29.
  • Page 491 30. (from step 29) Do any RAID-5 arrays have Unsynced Parity Strips or Unbuilt Data Strips? Go to step 31. The rebuilding operation is running or has stopped before completion. a. Note the number of unsynced parity strips and unbuilt data strips. b.
  • Page 492 33. (from step 32) Was SRN 49100 logged, but no error found, when diagnostics were run in System Verification mode? (from step 33) a. Type b. Select List Status of Hot Spare Pools. c. Display the pool status for each installed SSA adapter. Are any pools listed with a status of “reduced”? 35.
  • Page 493 (from step 35) You 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? If you have repaired a power or cabling fault that caused the disk drive to be missing from the system, the drive might now be in a rejected state.
  • Page 494 (from step 37) You have changed the use of a disk drive. You must now ensure that the hot spare pools are correctly configured. To do this action: a. Type b. Select List Status of Hot Spare Pools. c. Select, in turn, each SSA adapter. d.

  • Page 495: Map 2410: Ssa Repair Verification

    MAP 2410: SSA Repair Verification 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 enclosure in which SSA devices are installed.
  • Page 496 b. Go to step 4. 4. (from step 3) Do you still have the same SRN? Go to step 5. Go to step 6. 5. (from step 3 in MAP 2010: START and step 4 in this MAP) Do you have any other SRN? Go to step 7 on page 477.
  • Page 497 7. (from steps 3 in MAP 2010: START 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. Type and press Enter. b. Select List All Defined SSA RAID Arrays. Run the repair verification, or repair completion, procedures that are defined by your using system.

  • Page 498: Ssa Link Errors

    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 45PAA 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 Link Verification service aid...
  • Page 499 Example 1 In Figure 59, the link is between two disk drives that are in the same subsystem. It has three parts. SSA Subsystem Disk Internal Disk Drive 1 Connection Drive 2 Figure 59. Three-Part Link in One Subsystem Example 2 In Figure 60, the link is between two disk drives that are in the same subsystem.
  • Page 500 Example 3 In Figure 61, the link is between two disk drives that are not in the same subsystem. It has seven parts. SSA Subsystem Disk Internal Drive Connection Figure 61. Seven-Part Link in Two Subsystems Example 4 Figure 62, the link is between a disk drive and an SSA adapter. It has five parts. SSA Subsystem Internal Disk...

  • Page 501: Link Status (Ready) Lights

    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. You can find the failing link by looking for the flashing green status light at each end of the affected link.

  • Page 502: Service Aid

    Service Aid If service aids are available, you can use the Link Verification service aid to show that the SSA loop is broken. This example screen shows a break in the SSA loop between the pdisk0 and pdisk10. In the condition shown by the display, the Ready lights on the pdisk0 and pdisk10 are both flashing.

  • Page 503: Part 3. Appendixes

    Part 3. Appendixes...
  • Page 504 User’s Guide and Maintenance Information...

  • Page 505: Appendix. Communications Statements

    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 Part 15 of the FCC Rules.

  • Page 506: International Electrotechnical Commission (Iec) Statement

    International Electrotechnical Commission (IEC) Statement This product has been designed and built to comply with (IEC) Standard 950. Avis 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 apparatus complies with IECS-003.

  • Page 507: Taiwan Class A Compliance Statement

    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. Taiwan Class A Compliance Statement Appendix.
  • Page 508 User’s Guide and Maintenance Information...

  • Page 509: Glossary

    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.htm array.
  • Page 510 Exposed state. The state that a RAID array enters if a member disk drive becomes missing (logically or physically) from that array. 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.
  • Page 511 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. Two disk drives that contain the same data, and are referred to as one entity by the using system.
  • Page 512 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.

  • Page 513: Index

    Index Numerics 128 MB Memory Module feature 5 3-way copy array copy services 173 Delete a RAID Array Copy option 183 Delete a Volume Group, Logical Volumes, or Filesystems Copy option 184 List All Copy Candidates option 179 List All Uncoupled Copies option 181 List All Uncoupled Volume Groups option 182 Prepare a Copy option 175 Uncouple a Volume Group, Logical Volumes, or...
  • Page 514 array copy services (continued) Prepare a Copy option 175 Uncouple a Volume Group, Logical Volumes, 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...
  • Page 515 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_start_block 250 use=system/spare/free 250...
  • Page 516 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 types 238...
  • Page 517 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 spare...
  • Page 518 Degraded state, RAID-10 37 Degraded state, RAID-5 33 Delete a RAID Array Copy option 183 Delete a Volume Group, Logical Volumes, 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...
  • Page 519 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, correcting, and removing 91 finding the physical location 409...
  • Page 520 FRU part numbers 340 full-stride writes, definition 272 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...
  • Page 521 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 119...
  • Page 522 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 11 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...
  • Page 523 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...
  • Page 524 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 from an SSA RAID Array option 138...
  • Page 525 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 119 Identify Hot Spares 121 Identify Rejected Array Disks 123...
  • Page 526 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 11 problem determination 400...
  • Page 527 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...
  • Page 528 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 TMCHGIMPARM (change parameters) tmssa device driver ioctl operation 308 description 308...
  • Page 530 Part Number: 27H0678 Printed in the U.S.A.
  • Page 531 User’s Guide and Maintenance Information Advanced SerialRAID Adapters...

Table of Contents

Save PDF