Summary of the content on the page No. 1
®
3ware
Serial ATA RAID Controller
Command Line Interface
Supports the 9590SE-4ME for the Power Mac® G5
PN: 720-0140-00
September 2006
CLI Guide for the Power Mac G5
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 Chapter 1. Introduction to the 3ware Command Line Interface . . . . . . .3 Features of the CLI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3 Supported Operating Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4 Terminology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4 Installing the 3ware CLI on Mac OS X . . . . . . . . . . . .
Summary of the content on the page No. 4
/cx show numdrives . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .29 /cx show numports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .30 /cx show numunits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .30 /cx show ctlbus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .30 /cx show exportjbod . . . . . . . . . . . . . . . . . . . . . .
Summary of the content on the page No. 5
/cx/ux show name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .55 /cx/ux show serial . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .55 /cx/ux show qpolicy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .56 /cx/ux show storsave . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .56 /cx/ux show identify . . . . . . . . . . . . . . . . . . . . .
Summary of the content on the page No. 6
/cx/bbu show pcb . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .77 /cx/bbu show bootloader . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .77 /cx/bbu show all . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .77 /cx/bbu test [quiet] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .77 /cx/bbu enable . . . . . . . . . . . . . . . . . . . . . . . .
Summary of the content on the page No. 7
About this CLI Guide 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 provides instructions for configuring and maintaining your 3ware controller using 3ware’s command line interface (CLI). Note: This guide assumes that you have already installed your 3ware RAID controller in your system and set up your 3ware Sidecar. If you have not yet done so, see the installation guide that came with your 3ware RAID controller for instructions.
Summary of the content on the page No. 8
2 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5
Summary of the content on the page No. 9
1 Introduction to the 3ware Command Line Interface 3ware RAID controllers can be managed using the CLI via a command line or script. Important! For all of the functions of the 3ware CLI to work properly, you must have the proper CLI, firmware, and driver versions installed. Check http://www.3ware.com for the latest versions and upgrade instructions. This chapter includes the following sections: • “Features of the CLI” on page 3 • “Installing the 3war
Summary of the content on the page No. 10
Chapter 1. Introduction to the 3ware Command Line Interface Supported Operating Systems The 3ware CLI is supported under the following operating systems: •Mac OS X, running in a Power Mac® G5 (PowerPC™-based) with PCI Express®. •Windows®. Windows 2000, Windows XP, and Windows Server 2003, both 32-bit and 64-bit. • Linux®. Redhat, SuSE, both 32-bit and 64-bit. • FreeBSD®, both 32-bit and 64-bit. Terminology This document (3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5) uses t
Summary of the content on the page No. 11
Installing the 3ware CLI on Mac OS X Installing the 3ware CLI on Mac OS X 3ware CLI can be installed from the 3ware software CD, or the latest version can be downloaded from the 3ware web site, http://www.3ware.com/support/ download.asp. To install 3ware CLI on Mac OS X • Run the installer and select CLI as the software to be installed. Permissions Required to Run CLI To run CLI, you can be logged onto the Power Mac G5 with one of the following sets of permissions: • Administrator • Root You
Summary of the content on the page No. 12
Chapter 1. Introduction to the 3ware Command Line Interface Using the command interface interactively You can use 3ware CLI interactively, entering commands at the main prompt and observing the results on the screen. To use the CLI interactively 1 Enter the following command: ./tw_cli The main prompt is displayed, indicating that the program is awaiting a command. //localhost> 2 At the CLI prompt, you can enter commands to show or act on 3ware controllers, units, and drives. For example, //
Summary of the content on the page No. 13
Working with 3ware CLI Using an input file to execute a script You can operate 3ware CLI scripts by executing a file. The file is a text file containing a list of CLI commands which you have entered in advance. Each command must be on a separate line. Syntax tw_cli -f Where is the name of the text file you want to execute. Example tw_cli -f clicommand.txt This example executes the file clicommand.txt, and runs the CLI commands included in that file. Scripting example Fol
Summary of the content on the page No. 14
Chapter 1. Introduction to the 3ware Command Line Interface Conventions The following conventions are used through this guide: • In text, monospace font is used for code and for things you type. • In descriptions and explanations of commands, a bold font indicates the name of commands and parameters, for example, /c0/p0 show all. • In commands, an italic font indicates items that are variable, but that you must specify, such as a controller ID, or a unit ID, for example, /c0/p0 show attribut
Summary of the content on the page No. 15
Understanding RAID Levels and Concepts RAID Concepts The following concepts are important to understand when working with a RAID controller: • Arrays and Units. In the storage industry, the term “array” is used to describe two or more disk drives that appear to the operating system as a single unit. When you work with 3ware software, “unit” is the term used to refer to an array of disks that is configured and managed through the 3ware software. Single-disk units can also be configured in th
Summary of the content on the page No. 16
Chapter 1. Introduction to the 3ware Command Line Interface Available RAID Configurations The following RAID levels and configurations are available for drives attached to a 9590SE-4ME 3ware RAID controller: • RAID 0 • RAID 1 • RAID 5 • RAID 10 • Single Disk • Hot Spare Note: You may notice mention of RAID 50 in the Command Syntax sections of the CLI Guide. RAID 50 requires six or more drives, and so is not available using the 9590SE-4ME. For how to co
Summary of the content on the page No. 17
Understanding RAID Levels and Concepts Figure 1. RAID 0 Configuration Example RAID 1 RAID 1 provides fault tolerance and a speed advantage over non-RAID disks. 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 2). This gives your system fault tolerance by preserving the data on one drive if the other drive fails. Fault tolerance is a
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 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 4). A minimum of four drives are required to use this technique. The first two drives are mirror
Summary of the content on the page No. 19
Understanding RAID Levels and Concepts Single Disk A single drive can be configured as a unit through 3ware software. (3DM 2 or CLI). Like disks in other RAID configurations, single disks contain 3ware Disk Control Block (DCB) information and are seen by the OS as available units. Single drives are not fault tolerant and therefore not recommended for high availability systems unless additional precautions are taken to prevent system hangs and data loss. Hot Spare A hot spare is a single dri
Summary of the content on the page No. 20
Chapter 1. Introduction to the 3ware Command Line Interface Using Drive Capacity Efficiently To make the most efficient use of drive capacity, it is advisable to use drives of the same capacity. This is because the capacity of each drive is limited to the capacity of the smallest drive in the unit. The total array capacity is defined as follows: Table 3: Drive Capacity RAID Level Capacity Single Disk capacity of the drive RAID 0 (number of drives) X (cap
