AMCC 9550SX, 9500S, 9590SE Introduction to the 3ware Command Line Interface, Features of the CLI

Page 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 supported for only a subset of controllers. For example, commands that apply only to 3ware 9000 series controllers are labeled as such and are not supported for 3ware 7000/8000 controllers. Within the 9000 series, some commands apply to only to models 9550SX, 9590SE, and 9650SE and not to 9500S, and are so labeled. A few commands apply only to models 9500S, and are labeled as such.

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 2

“Installing the 3ware CLI” on page 4

“Working with 3ware CLI” on page 6

“Understanding RAID Levels and Concepts” on page 9

Features of the CLI

3ware CLI is a command line interface for managing 3ware RAID Controllers. It provides controller, logical unit, drive, enclosure, and BBU (Battery Backup Unit) management. It can be used in both interactive and batch mode, providing higher level API (application programming interface) functionalities.

2

3ware Serial ATA RAID Controller CLI Guide

Image 8
Contents Command Line Interface 3ware Serial ATA RAID ControllerCopyright Table of Contents 3ware Serial ATA RAID Controller CLI Guide Cx/ux set autoverify=onoff 3ware Serial ATA RAID Controller CLI Guide About this CLI Guide Introduction to the 3ware Command Line Interface Features of the CLISupported Operating Systems TerminologyInstalling the 3ware CLI Installing the 3ware CLI on WindowsTo install 3ware CLI on Windows Permissions Required to Run CLIInstalling the 3ware CLI on Linux and FreeBSD To start CLI, do one of the followingTo use the CLI interactively Using the command interface interactivelyWorking with 3ware CLI Scripting example Using a single command with outputUsing an input file to execute a script Outputting the CLI to a Text File ConventionsUnderstanding RAID Levels and Concepts RAID ConceptsAvailable RAID Configurations RAIDRAID 1 Configuration Example RAID 5 Configuration Example RAID 6 Configuration Example RAID 10 Configuration Example Single Disk JbodRAID Configuration Types Possible Configurations Based on Number of DrivesDetermining What RAID Level to Use Hot SpareUsing Drive Capacity Efficiently Drive CapacitySupport for Over 2 Terabytes Common Tasks Mapped to CLI Commands CLI Syntax ReferenceCLI Syntax Reference Syntax Overview Port TasksC1 add type=raid1 disk=0-1 Shell Object Commands Focus ObjectShow ExampleShow ver Show rebuild Show alarms reverseShow diag Show verify Show selftestCommit FlushRescan Controller Object Commands Cx showCx show Cx show attribute attribute Cx show bios Cx show driverCx show model Cx show firmwareCx show serial Cx show pcbCx show pchip Cx show achipCx show numports Cx show numunitsCx show ctlbus Cx show exportjbodCx show spinup Cx show staggerCx show ondegrade Cx show autocarveCx show carvesize Cx show memoryCx show autorebuild Cx show unitstatusCx show allunitstatus Cx show drivestatusCx show all 3JV3MVTASupported RAID Types Supported Stripe Sizes KB Supported Model-Unit Types for ignoreECC Cx rescan noscan Cx commit Cx flushCx show alarms reverse Cx show diag Cx show rebuildRAID-5 Initializing Cx show verify Cx show selftest Setting Up a Rebuild Schedule Cx add rebuild=dddhhdurationSetting Up a Verify Schedule Cx add verify=dddhhdurationSetting Up a Selftest Schedule Cx add selftest=dddhhCx set rebuild=enabledisable1..5 Cx del rebuild=slotidCx del verify=slotid Cx del selftest=slotidCx set verify=enabledisable1..5 Cx set selftest=enabledisable task=UDMASMARTCx set spinup=nn Cx set exportjbod=onoffCx set ondegrade=cacheofffollow Cx set carvesize=1024..2048 Cx set stagger=nnCx set autocarve=onoff Cx set autorebuild=onoff Cx set autodetect=onoff disk=p-pallCx start mediascan Unit Object Commands Cx stop mediascanCx/ux show Cx/ux show verifystatus Cx/ux show statusCx/ux show rebuildstatus Cx/ux show initializestatus Cx/ux show nameCx/ux show serial Cx/ux show qpolicyCx/ux show storsave Cx/ux show identifyCx/ux show autoverify Cx/ux show cacheCx/ux show all Cx/ux show volumesCx/ux show ignoreECC Cx/ux remove noscan quiet Cx/ux del noscan quiet Cx/ux start rebuild disk=pp-p...ignoreECCCx/ux start verify Cx/ux pause rebuildCx/ux resume rebuild Supported RAID Logical Unit Types for VerificationCx/ux stop verify Cx/ux flushCx/ux set autoverify=onoff Cx/ux set cache=onoff quietSupported RAID Types for Caching Cx/ux set identify=onoffCx/ux set ignoreECC=onoff Cx/ux set storsave=protectbalanceperform quiet Cx/ux set name=stringCx/ux set qpolicy=onoff Example 3ware Serial ATA RAID Controller CLI Guide Valid Migration Paths Supported Stripe Sizes Example of capacity expansion Migration ProcessExample of splitting a mirror Example of migrate output Port Object Commands Cx/px showCx/px show status Cx/px show modelCx/px show serial Cx/px show firmwareCx/px show ncq Cx/px show lspeedCx/px show capacity Cx/px show smartCx/px show all Cx/px remove noscan quiet Cx/px set identify=onoffBBU Object Commands Cx/bbu showCx/bbu show attribute attribute Cx/bbu show statusCx/bbu show batinst Cx/bbu show lasttestCx/bbu show volt Cx/bbu show tempCx/bbu show bootloader Cx/bbu show serialCx/bbu show fw Cx/bbu show pcbCx/bbu test quiet Cx/bbu enableCx/bbu disable quiet Enclosure Object Commands Ex showEx show attribute attribute Ex show controllersEx show slots Ex show fansEx show temp Ex show allEx/slotx set identify=onoff Ex/slotx showEx/slotx show identify Help Commands Help with specific commandsEx/fanx show Ex/tempx showAttribute attribute Help with attributes HelpHelp update Help showHelp flush Help rescanHelp focus Help /cxHelp /cx/ux Help /cx/pxCommand Logging Return CodeHelp /ex/fanx Help /ex/tempxIf you type