Summary of the content on the page No. 1
®
3ware Serial ATA
RAID Controller
Command Line Interface
Supports the 9000 Series
(9500S, 9550SX, 9590SE, 9650SE)
PN: 720-0145-00
October 2006
CLI Guide
Summary of the content on the page No. 2
Copyright ©2003-2006 Applied Micro Circuits Corporation (AMCC). All rights reserved. This publication may be copied or reproduced for reference purposes only. All other purposes require the express written consent of AMCC, 215 Moffett Park Drive, Sunnyvale, CA 94089. AMCC shall not be responsible or liable for, and shall be held harmless against, any and all damages, claims, and/or disputes that arise from the copying or reproduction of this publication. Trademarks 3ware®, Escalade®, 3DM®
Summary of the content on the page No. 3
Table of Contents About this CLI Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1 Chapter 1. Introduction to the 3ware Command Line Interface. . . . . . . . . . . . . . . . . .2 Features of the CLI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 Supported Operating Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 Terminology . . . . . . . . . . . . . .
Summary of the content on the page No. 4
/cx show numdrives . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33 /cx show numports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34 /cx show numunits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34 /cx show ctlbus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34 /cx show exportjbod .
Summary of the content on the page No. 5
/cx/ux show serial . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62 /cx/ux show qpolicy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62 /cx/ux show storsave . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63 /cx/ux show identify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63 /cx/ux show autoverify
Summary of the content on the page No. 6
/cx/bbu test [quiet] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86 /cx/bbu enable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86 /cx/bbu disable [quiet] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86 Enclosure Object Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87 /ex show . . . . . . .
Summary of the content on the page No. 7
About this CLI Guide 3ware Serial ATA Controller CLI Guide provides instructions for configuring and maintaining your 3ware controller using 3ware’s command line interface (CLI). Table 1: Sections in this CLI Guide Chapter Description 1. Introduction to 3ware Installation, features, concepts Command Line Interface 2. CLI Syntax Reference Describes individual commands using the primary syntax There are often multiple ways to accomplish the same configura
Summary of the content on the page No. 8
1 Introduction to the 3ware Command Line Interface The 3ware SATA RAID Controller Command Line Interface (CLI) for Linux, Windows, and FreeBSD is provided to manage 7000, 8000, and 9000-series 3ware ATA and Serial ATA RAID controllers. Multiple 3ware RAID controllers can be managed using the CLI via a command line or script. Note: Some CLI commands are supported only for particular models of 3ware RAID controllers. Wherever possible, commands are labeled to indicate when they are supporte
Summary of the content on the page No. 9
Supported Operating Systems You can use the CLI to view unit status and version information and perform maintenance functions such as adding or removing drives. 3ware CLI also includes advanced features for creating and deleting RAID units online. For a summary of what you can do using the CLI, see “Common Tasks Mapped to CLI Commands” on page 19. Supported Operating Systems The 3ware CLI is supported under the following operating systems: •Windows®. Windows 2000, Windows XP, and Windows Se
Summary of the content on the page No. 10
Chapter 1. Introduction to the 3ware Command Line Interface Installing the 3ware CLI Warning! If you are using 3DM, as opposed to 3DM2, AMCC does not recommend installing both 3DM and CLI on the same system. Conflicts may occur. For example, if both are installed, alarms will be captured only by 3DM. You should use either CLI or 3DM to manage your 3ware RAID controllers. This is not an issue for 3DM2. It can be installed with CLI. (3DM was an earlier ve
Summary of the content on the page No. 11
Installing the 3ware CLI If you are uncertain whether you have the correct permissions, contact your network administrator. To start CLI, do one of the following: • Start the 3ware CD and at the 3ware Escalade menu, click Run CLI. • Or, open a console window, change to the directory where tw_cli is located, and at the command prompt, enter tw_cli • OR, double-click the CLI icon in a folder. The CLI prompt is displayed in a DOS console window. Installing the 3ware CLI on Linux and FreeBSD 3ware
Summary of the content on the page No. 12
Chapter 1. Introduction to the 3ware Command Line Interface Working with 3ware CLI You can work with the 3ware CLI in different ways: • Interactively, entering commands at the main prompt • As a series of single commands • By creating a script—an input file with multiple commands The next few topics shows examples of these different methods. • “Using the command interface interactively” on page 6 • “Using a single command with output” on page 7 • “Using an input file to execute a script” on pag
Summary of the content on the page No. 13
Working with 3ware CLI Using a single command with output You can use 3ware CLI with line arguments, processing a single command at a time. To do so, simply enter the command and the arguments. Single commands can be useful when you want to perform a task such as redirecting the output of the command to a file. It also allows you to use the command line history to eliminate some typing. Syntax tw_cli Example tw_cli /c0 show diag > /tmp/3w_diag.out Using an input fil
Summary of the content on the page No. 14
Chapter 1. Introduction to the 3ware Command Line Interface Outputting the CLI to a Text File You can have the output of the 3ware CLI, including errors, sent to a text file by adding 2>&1 to the end of the line. This could be useful, for example, if you want to email the output to AMCC Technical Support. Examples tw_cli /c2/p0 show >> controller2port0info.txt 2>&1 or tw_cli /c0 show diag >> Logfile.txt 2>&1 Conventions The following conventions are used through this guide: • In text, monospac
Summary of the content on the page No. 15
Understanding RAID Levels and Concepts Understanding RAID Levels and Concepts 3ware RAID controllers use RAID (Redundant Array of Inexpensive Disks) to increase your storage system’s performance and provide fault tolerance (protection against data loss). This section organizes information about RAID concepts and configuration levels into the following topics: • “RAID Concepts” on page 1 • “Available RAID Configurations” on page 1 • “Determining What RAI
Summary of the content on the page No. 16
Chapter 1. Introduction to the 3ware Command Line Interface • Array Roaming. The process of removing a unit from a controller and putting it back later, either on the same controller, or a different one, and having it recognized as a unit. The disks may be attached to different ports than they were originally attached to, without harm to the data. For definitions of other terms used throughout the documentation, see the “Glossary”. Available RAID Configurations RAID is a method of combining
Summary of the content on the page No. 17
Understanding RAID Levels and Concepts RAID 1 RAID 1 provides fault tolerance and a speed advantage over non-RAID disks. RAID 1 is also known as a mirrored array. Mirroring is done on pairs of drives. Mirrored disk arrays write the same data to two different drives using RAID 1 algorithms (see Figure ?). This gives your system fault tolerance by preserving the data on one drive if the other drive fails. Fault tolerance is a basic requirement for critical systems like web and database server
Summary of the content on the page No. 18
Chapter 1. Introduction to the 3ware Command Line Interface Figure 3. RAID 5 Configuration Example RAID 6 RAID 6 requires a 3ware 9650SE RAID controller. RAID 6 provides greater redundancy and fault tolerance than RAID 5. It is similar to RAID 5, but has two blocks of parity information (P+Q) distributed across all the drives of a unit, instead of the single block of RAID 5. Due to the two parities, a RAID 6 unit can tolerate two hard drives failing sim
Summary of the content on the page No. 19
Understanding RAID Levels and Concepts Figure 4. RAID 6 Configuration Example RAID 10 RAID 10 is a combination of striped and mirrored arrays for fault tolerance and high performance. When drives are configured as a striped mirrored array, the disks are configured using both RAID 0 and RAID 1 techniques, thus the name RAID 10 (see Figure ?). A minimum of four drives are required to use this technique. The first two drives are mirrored as a fault toleran
Summary of the content on the page No. 20
Chapter 1. Introduction to the 3ware Command Line Interface Figure 5. RAID 10 Configuration Example RAID 50 RAID 50 is a combination of RAID 5 with RAID 0. This array type provides fault tolerance and high performance. RAID 50 requires a minimum of six drives. Several combinations are available with RAID 50. For example, on a 12-port controller, you can have a grouping of 3, 4, or 6 drives. A grouping of 3 means that the RAID 5 arrays used have 3 disks
