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