Adaptec 2120S - SCSI RAID Controller User manual

Adaptec SCSI RAID
2120S/2200S
Software Reference Guide

ii
Adaptec SCSI RAID Software Reference Guide
Copyright
© 2000 - 2002 Adaptec, Inc. All rights reserved. No part of this publication may be
reproduced, stored in a retrieval system, or transmitted in any form or by any means,
electronic, mechanical, photocopying, recording or otherwise, without the prior
written consent of Adaptec, Inc., 691 South Milpitas Blvd., Milpitas, CA 95035.
Trademarks
Adaptec and the Adaptec logo are trademarks of Adaptec, Inc., which may be
registered in some jurisdictions.
Windows NT, Windows 2000, Windows .NET and Windows XP are trademarks of
Microsoft Corporation in the US and other countries, used under license.
Linux is trademarked by Linus Torvalds.
Red Hat® Linux® consists of hundreds of software modules, some developed by Red
Hat and many developed by other members of the open source community. Those
authors hold the copyrights in the modules or code they developed. At the same time,
the combined body of work that constitutes Red Hat® Linux® is a collective work
which has been organized by Red Hat, and Red Hat holds the copyright in that
collective work. Red Hat then permits others to copy, modify and redistribute the
collective work. To grant this permission Red Hat usually uses the GNU General
Public License ("GPL") version 2 and Red Hat's own End User License Agreement.
Although software licensed under the GPL is "open source software," Red Hat retains
ownership of the copyright in its collective work.
Adobe, the Adobe logo, Acrobat, Acrobat Capture, and Distiller are trademarks of
Adobe Systems Incorporated.
Novell and NetWare are trademarks of Novell, Inc.
Open UNIX 8, UnixWare 7, and SCO OpenServer are trademarks of the SCO Group,
Inc.
All other trademarks are the property of their respective owners.
Changes
The material in this document is for information only and is subject to change
without notice. While reasonable efforts have been made in the preparation of this
document to assure its accuracy, Adaptec, Inc. assumes no liability resulting from
errors or omissions in this document, or from the use of the information contained
herein.
Adaptec reserves the right to make changes in the product design without
reservation and without notification to its users.
Disclaimer
IF THIS PRODUCT DIRECTS YOU TO COPY MATERIALS, YOU MUST HAVE
PERMISSION FROM THE COPYRIGHT OWNER OF THE MATERIALS TO AVOID
VIOLATING THE LAW WHICH COULD RESULT IN DAMAGES OR OTHER
REMEDIES.

iii
Contents
1 Getting Started
Audience 1-2
Supported Platforms 1-2
Organization 1-2
Conventions 1-3
Related Documentation 1-4
2 Accessing the Command Line Interface
Accessing the CLI from the MS-DOS Prompt 2-2
Accessing the CLI from the Windows Start Button 2-2
To access the CLI from the UNIX/Linux prompt, display a
window and type aaccli in any directory. When the
system displays the CLI> prompt, you can use CLI
commands. For the commands to work in any directory,
the path in the startup file (.login or .cshrc) must
include the directory where the software is installed. See
your UNIX/Linux documentation for information on
setting up directory paths in the .login and.cshrc files.
2-3
Accessing the CLI from the NetWare Server Console 2-3
Accessing the CLI from the UNIX Prompt 2-3

iv
Adaptec SCSI RAID Software Reference Guide
3 Syntax and Conventions for CLI Commands
CLI Features 3-1
CLI Command Syntax 3-2
Class 3-3
Action 3-3
Object 3-3
Switch 3-3
Value 3-4
Parameter 3-4
Blank Space 3-4
CLI Parameter and Switch Value Types 3-4
boolean 3-5
integer 3-5
string 3-6
scsi_device 3-7
free_space 3-8
container 3-9
CLI Status Information 3-10
The Stat and Task Items 3-10
The Func Item 3-11
The Ctr and State Items 3-12

v
Adaptec SCSI RAID Software Reference Guide
4 General Control Commands
close 4-2
Syntax 4-2
exit 4-2
Syntax 4-2
help, ? 4-2
Syntax 4-2
Parameters 4-2
Switches 4-2
history_size 4-3
Command Availability 4-3
Syntax 4-3
Parameters 4-3
open 4-3
Syntax 4-3
Parameters 4-3
Switches 4-4
reset_window 4-5
Command Availability 4-5
Syntax 4-5
toggle_more 4-5
Command Availability 4-5
Syntax 4-5

vi
Adaptec SCSI RAID Software Reference Guide
5 container Commands
container add_level 5-3
Syntax 5-3
Parameters 5-3
Examples 5-3
Related Information 5-4
container create mirror 5-5
Syntax 5-5
Parameters 5-5
Switches 5-6
Examples 5-6
Related Information 5-8
container create mmirror 5-9
Notes 5-9
Syntax 5-9
Parameters 5-9
Switches 5-10
Examples 5-11
Related Information 5-12
container create mstripe 5-14
Notes 5-14
Syntax 5-14
Parameters 5-15
Switches 5-15
Examples 5-16
Related Information 5-18
container create mvolume 5-19
Notes 5-19
Syntax 5-19
Parameters 5-19
Switches 5-20
Examples 5-20
Related Information 5-23
container create raid5 5-24
Notes 5-24
Syntax 5-24
Parameters 5-24

vii
Adaptec SCSI RAID Software Reference Guide
Switches 5-25
Examples 5-27
Related Information 5-29
container create stripe 5-30
Notes 5-30
Syntax 5-30
Parameters 5-30
Switches 5-31
Examples 5-32
Related Information 5-34
container create volume 5-35
Notes 5-35
Syntax 5-35
Parameters 5-35
Switches 5-36
Examples 5-37
Related Information 5-39
container delete 5-40
Notes 5-40
Syntax 5-40
Parameters 5-40
Switches 5-40
Examples 5-41
Related Information 5-42
container extend file_system 5-43
Notes 5-43
Command And Switch Availability 5-44
Syntax 5-44
Parameters 5-44
Examples 5-44
Related Information 5-45
container extend mvolume 5-46
Command And Switch Availability 5-46
Syntax 5-46
Parameters 5-46
Examples 5-47
Related Information 5-49

viii
Adaptec SCSI RAID Software Reference Guide
container extend volume 5-50
Command And Switch Availability 5-50
Syntax 5-50
Parameters 5-50
Examples 5-51
Related Information 5-53
container list 5-54
Syntax 5-54
Parameters 5-54
Switches 5-54
Examples 5-55
Related Information 5-64
container lock 5-65
Syntax 5-65
Parameters 5-65
Examples 5-65
Related Information 5-66
container move 5-67
Notes 5-67
Syntax 5-67
Parameters 5-67
Examples 5-68
Related Information 5-68
container promote 5-69
Notes 5-69
Syntax 5-69
Parameters 5-69
Examples 5-70
Related Information 5-71
container readonly 5-72
Syntax 5-72
Parameters 5-72
Examples 5-72
Related Information 5-73
container readwrite 5-74
Syntax 5-74
Parameters 5-74

ix
Adaptec SCSI RAID Software Reference Guide
Examples 5-74
Related Information 5-75
container reconfigure 5-76
Notes 5-77
Syntax 5-77
Parameters 5-78
Switches 5-78
Examples 5-81
Related Information 5-82
container release_cache 5-83
Syntax 5-83
Parameters 5-83
Examples 5-83
Related Information 5-83
container remove drive_letter 5-84
Command Availability 5-84
Syntax 5-84
Parameters 5-84
Examples 5-84
Related Information 5-85
container remove failover 5-86
Syntax 5-86
Parameters 5-86
Examples 5-87
Related Information 5-87
container remove file_system 5-88
Command Availability 5-88
Syntax 5-88
Parameters 5-88
Examples 5-88
Related Information 5-89
container remove global_failover 5-90
Syntax 5-90
Parameters 5-90
Examples 5-90
Related Information 5-91
container restore RAID5 5-92

x
Adaptec SCSI RAID Software Reference Guide
Syntax 5-92
Parameters 5-92
Examples 5-92
Related Information 5-93
container scrub 5-94
Syntax 5-94
Parameters 5-94
Switches 5-94
Examples 5-95
Related Information 5-96
container set cache 5-97
Notes 5-97
Syntax 5-97
Parameters 5-98
Switches 5-98
Examples 5-99
Related Information 5-100
container set failover 5-101
Syntax 5-101
Parameters 5-101
Examples 5-101
Related Information 5-102
container set global_failover 5-103
Syntax 5-103
Parameters 5-103
Examples 5-103
Related Information 5-104
container set io_delay 5-105
Syntax 5-105
Parameters 5-105
Examples 5-106
Related Information 5-107
container set label 5-108
Syntax 5-108
Parameters 5-108
Examples 5-108
Related Information 5-109

xi
Adaptec SCSI RAID Software Reference Guide
container show cache 5-110
Syntax 5-110
Parameters 5-110
Examples 5-110
Related Information 5-115
container show failover 5-116
Syntax 5-116
Parameters 5-116
Examples 5-116
Related Information 5-116
container split 5-117
Syntax 5-117
Parameters 5-118
Examples 5-118
Related Information 5-120
container unlock 5-121
Syntax 5-121
Parameters 5-121
Examples 5-121
Related Information 5-122
container unmirror 5-123
Syntax 5-123
Parameters 5-123
Examples 5-123
Related Information 5-124

xii
Adaptec SCSI RAID Software Reference Guide
6 controller Commands
controller details 6-2
Syntax 6-2
Examples 6-2
Related Information 6-6
controller firmware compare 6-7
Syntax 6-7
Switches 6-7
Examples 6-7
Related Information: 6-7
controller firmware save 6-8
Syntax 6-8
Switches 6-8
Examples 6-8
Related Information: 6-9
controller firmware update 6-10
Syntax 6-10
Switches 6-10
Examples 6-10
Related Information: 6-10
controller list 6-11
Syntax 6-11
Parameters 6-11
Switches 6-11
Examples 6-11
Related Information 6-12
controller pause_io 6-13
Command And Switch Availability 6-14
Notes 6-14
Syntax 6-14
Parameters 6-14
Examples 6-14
Related Information 6-15
controller rescan 6-16
Syntax 6-16
controller reset_scsi_channel 6-17
Syntax 6-17

xiii
Adaptec SCSI RAID Software Reference Guide
Parameters 6-17
Examples 6-17
controller resume_io 6-18
Syntax 6-18
Examples 6-18
Related Information 6-18
controller set automatic_failover 6-19
Notes 6-19
Syntax 6-19
Examples 6-20
Related Information 6-20
controller set array_verify 6-21
Syntax 6-21
Examples 6-21
Related Information 6-22
controller show automatic_failover 6-23
Syntax 6-23
Examples 6-23
Related Information 6-23
controller show channels 6-24
Syntax 6-24
Examples 6-24
Related Information 6-26
controller show array_verify 6-27
Syntax 6-27
Examples 6-27
Related Information 6-27

xiv
Adaptec SCSI RAID Software Reference Guide
7 disk Commands
disk blink 7-2
Syntax 7-2
Parameters 7-2
Switches 7-2
Examples 7-2
disk initialize 7-3
Syntax 7-3
Parameters 7-3
Switches 7-3
Examples 7-4
disk list 7-5
Syntax 7-5
Parameters 7-5
Switches 7-5
Examples 7-5
Related Information 7-8
disk remove dead_partitions 7-9
Syntax 7-9
Parameters 7-9
Examples 7-9
Related Information 7-9
disk set default 7-10
Syntax 7-10
Parameters 7-10
Examples 7-10
Related Information 7-11
disk set smart 7-12
Syntax 7-12
Parameters 7-12
Switches 7-13
Examples 7-14
Related Information 7-14
disk show default 7-15
Syntax 7-15
Examples 7-15
Related Information 7-15

xv
Adaptec SCSI RAID Software Reference Guide
disk show defects 7-16
Syntax 7-16
Parameters 7-16
Switches 7-16
Examples 7-16
disk show partition 7-18
Syntax 7-18
Examples 7-18
disk show smart 7-21
Syntax 7-21
Parameters 7-21
Switches 7-21
Examples 7-22
Related Information 7-24
disk show space 7-25
Syntax 7-25
Parameters 7-25
Switches 7-25
Examples 7-25
disk verify 7-28
Syntax 7-28
Parameters 7-28
Switches 7-28
Examples 7-29
disk zero 7-30
Command And Switch Availability 7-30
Syntax 7-30
Parameters 7-30
Switches 7-30
Examples 7-31

xvi
Adaptec SCSI RAID Software Reference Guide
8 diagnostic Commands
diagnostic clear boot_parameters 8-2
Syntax 8-2
Examples 8-2
Related Information 8-2
diagnostic dump structures 8-3
Syntax 8-3
Parameters 8-3
Examples 8-3
Related Information 8-3
diagnostic dump text 8-4
Notes 8-4
Syntax 8-4
Examples 8-5
Related Information 8-5
diagnostic load_arrays 8-6
Syntax 8-6
Examples 8-6
Related Information 8-6
diagnostic moderation set count 8-7
Syntax 8-7
Parameters 8-7
Related Information 8-7
diagnostic moderation set timer 8-8
Syntax 8-8
Parameters 8-8
Related Information 8-8
diagnostic moderation show count 8-9
Syntax 8-9
Related Information 8-9
diagnostic moderation show timer 8-10
Syntax 8-10
Related Information 8-10
diagnostic set boot_parameter 8-11
Syntax 8-11
Parameters 8-11
Related Information 8-11
diagnostic show boot_parameter 8-12

xvii
Adaptec SCSI RAID Software Reference Guide
Syntax 8-12
Parameters 8-12
Related Information 8-12
diagnostic show history 8-13
Syntax 8-13
Switches 8-13
9 logfile Commands
logfile end 9-2
Syntax 9-2
Examples 9-2
Related Information 9-2
logfile start 9-3
Syntax 9-3
Parameter 9-3
Switches 9-3
Examples 9-3
Related Information 9-4
10 task Commands
task list 10-2
Syntax 10-2
Parameters 10-2
Switches 10-2
Examples 10-2
The Specific2 Column 10-6
Related Information 10-7
task resume 10-8
Syntax 10-8
Parameters 10-8
Switches 10-8
Examples 10-8
Related Information 10-9
task stop 10-10
Syntax 10-10
Parameters 10-10

xviii
Adaptec SCSI RAID Software Reference Guide
Switches 10-10
Examples 10-10
Related Information 10-11
task suspend 10-12
Syntax 10-12
Parameters 10-12
Switches 10-12
Examples 10-12
Related Information 10-13
11 enclosure Commands
enclosure activate slot 11-3
Syntax 11-3
Parameters 11-3
Examples 11-3
Related Information 11-4
enclosure identify slot 11-5
Syntax 11-5
Parameters 11-5
Switches 11-5
Examples 11-5
Related Information 11-6
enclosure list 11-7
Syntax 11-7
Parameters 11-7
Switches 11-7
Examples 11-8
Related Information 11-11
enclosure prepare slot 11-12
Syntax 11-12
Parameters 11-12
Examples 11-12
Related Information 11-13
enclosure set alarm 11-14
Syntax 11-14
Parameters 11-14
Switches 11-14

xix
Adaptec SCSI RAID Software Reference Guide
Examples 11-14
Related Information 11-14
enclosure set door 11-15
Syntax 11-15
Parameters 11-15
Switches 11-15
Examples 11-15
Related Information 11-15
enclosure set fan 11-16
Syntax 11-16
Parameters 11-16
Switches 11-17
Examples 11-17
Related Information 11-17
enclosure set interval 11-18
Syntax 11-18
Parameters 11-18
Examples 11-18
Related Information 11-19
enclosure set power 11-20
Syntax 11-20
Parameters 11-20
Switches 11-20
Examples 11-20
Related Information 11-21
enclosure set scsiid 11-22
Notes 11-22
Syntax 11-22
Parameters 11-22
Examples 11-23
Related Information 11-24
enclosure set temperature 11-25
Syntax 11-25
Parameters 11-25
Examples 11-25
Related Information 11-26
enclosure show fan 11-27

xx
Adaptec SCSI RAID Software Reference Guide
Syntax 11-27
Parameters 11-27
Examples 11-28
Related Information 11-29
enclosure show power 11-30
Syntax 11-30
Parameters 11-30
Examples 11-30
Related Information 11-32
enclosure show slot 11-33
Syntax 11-33
Parameters 11-33
Examples 11-34
Related Information 11-36
enclosure show status 11-37
Syntax 11-37
Parameters 11-37
Examples 11-37
Related Information 11-40
enclosure show temperature 11-41
Syntax 11-41
Parameters 11-41
Examples 11-41
Related Information 11-43