3Ware 720-0192-00 Manual
  1. Manuals
  2. Brands
  3. 3Ware Manuals
  4. Controller
  5. 720-0192-00
  6. Manual

3Ware 720-0192-00 Manual

Sas/sata raid controller
Hide thumbs
Table of Contents

Advertisement

Quick Links

Download this manual
®
3ware
SAS/SATA

RAID Controller

Command Line Interface
Version 9.5.2—Supports the 9000 Series
(9690SA, 9650SE, 9590SE, 9550SX(U), and 9500S)
PN: 720-0192-00
May 2009

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the 720-0192-00 and is the answer not in the manual?

Questions and answers

Related Manuals for 3Ware 720-0192-00

Summary of Contents for 3Ware 720-0192-00

  • Page 1: Raid Controller

    ® 3ware SAS/SATA RAID Controller Command Line Interface Version 9.5.2—Supports the 9000 Series (9690SA, 9650SE, 9590SE, 9550SX(U), and 9500S) PN: 720-0192-00 May 2009...

  • Page 2: Copyright Notice

    © 2009 LSI Corporation. All rights reserved. Trademark Acknowledgments 3ware®, Escalade®, 3DM®, and TwinStor® are all registered trademarks of LSI Corporation. The 3ware logo, 3BM, Multi-Lane, StorSave, StorSwitch, StreamFusion, and R5 Fusion are all trademarks of LSI. . All other brand...

  • Page 4: Table Of Contents

    Installing the 3ware CLI on Windows ........
  • Page 5 /cx set verify=basic [pref=ddd:hh] ........74 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.2...
  • Page 6 Port Object Commands ..........106 www.3ware.com...
  • Page 7 /cx/ex/fanx set speed=<0..7> ........130 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.2...
  • Page 8 Return Code ............142 www.3ware.com...

  • Page 9: About This Cli Guide

    3ware controller using 3ware’s command line interface (CLI). This guide assumes that you have already installed your 3ware RAID controller in your system. If you have not yet done so, see the installation guide that came with your 3ware RAID controller for instructions.

  • Page 10: Introduction To The 3Ware Command Line Interface

    You may need to install particular firmware and drivers for some features to take effect. See the Release Notes for details. 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/support for the latest versions and upgrade instructions.

  • Page 11: Features Of The Cli

    For a summary of what you can do using the CLI, see “Common Tasks Mapped to CLI Commands” on page 20. Supported Operating Systems The 9.5.2 version of the 3ware CLI is supported under the following operating systems: • Windows®. Windows XP, Windows Server 2003, Windows Server 2008, and Vista, (32-bit and 64-bit versions of each).

  • Page 12: Installing The 3Ware Cli On Windows

    Installing the 3ware CLI Installing the 3ware CLI on Windows 3ware CLI can be installed or run directly from the 3ware software CD, or the latest version can be downloaded from the 3ware web site, http://www.3ware.com. Online manual pages are also available in nroff and html formats.

  • Page 13: Installing The 3Ware Cli On Linux, Freebsd, And Opensolaris

    Chapter 1. Introduction to the 3ware Command Line Interface Installing the 3ware CLI on Linux, FreeBSD, and OpenSolaris 3ware CLI can be installed or run directly from the 3ware software CD, or the latest version can be downloaded from the 3ware web site, http://www.3ware.com.
  • Page 14 ./setupFreeBSD7_x64.sh -console • Press Enter to begin installation. Step through the installation screens in text mode. On the 3ware Disk Management Tools screen, make sure that Command Line Interface (tw_cli) is selected. The default directory location used by 3ware is /opt/AMCC/CLI/tw_cli.

  • Page 15: Working With 3Ware Cli

    Chapter 1. Introduction to the 3ware Command Line Interface The installer application will start in graphical mode. Step through the pages of the installation wizard. On the 3ware Disk Management Tools screen, make sure that Command Line Interface (tw_cli) is selected. The default directory location used by 3ware is /opt/AMCC/CLI/tw_cli.

  • Page 16: Using A Single Command With Output

    /c0 show diag > /tmp/3w_diag.out 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.

  • Page 17: Outputting The Cli To A Text File

    -f config_unit.txt 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 LSI Technical Support.

  • Page 18: Understanding Raid Levels And Concepts

    When working with a 3ware RAID controller, “unit” is the term used to refer to an array of disks that is configured and managed through the 3ware software.

  • Page 19: Available Raid Configurations

    RAID is a method of combining several hard drives into one unit. It can offer fault tolerance and higher throughput levels than a single hard drive or group of independent hard drives. LSI's 3ware controllers support RAID 0, 1, 5, 6, 10, 50, and Single Disk. The information below provides a more in-depth explanation of the different RAID levels.
  • Page 20 Fault tolerance is a basic requirement for critical systems like web and database servers. 3ware uses a patented technology, TwinStor®, on RAID 1 arrays for improved performance during sequential read operations. With TwinStor technology, read performance is twice the speed of a single drive during sequential read operation.
  • Page 21 For example, one sub-unit can be degraded, while another may be rebuilding, or one sub-unit may be initializing, while another is verifying. LSI 3ware’s implementation of RAID 6 requires a minimum of five drives. Performance and storage efficiency also increase as the number of drives increase.
  • Page 22 (half of each mirrored pair) and the array will continue to function. Please note that if both halves of a mirrored pair in the RAID 10 array fail, then all of the data will be lost. www.3ware.com...
  • Page 23 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.
  • Page 24 Figure 6. RAID 50 Configuration Example Single Disk A single drive can be configured as a unit through 3ware software. (3BM, 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.

  • Page 25: Determining What Raid Level To Use

    Chapter 1. Introduction to the 3ware Command Line Interface Hot Spare A hot spare is a single drive, available online, so that a redundant unit can be automatically rebuilt in case of drive failure. Determining What RAID Level to Use Your choice of which type of RAID unit (array) to create will depend on your needs.

  • Page 26: Using Drive Capacity Efficiently

    (number of drives - 2) x (capacity of the smallest drive) RAID 10 (number of drives / 2) X (capacity of smallest drive) RAID 50 (number of drives - number of groups of drives) X (capacity of the smallest drive) www.3ware.com...

  • Page 27: Support For Over 2 Terabytes

    Chapter 1. Introduction to the 3ware Command Line Interface Through drive coercion, the capacity used for each drive is rounded down so that drives from differing manufacturers are more likely to be able to be used as spares for each other. The capacity used for each drive is rounded down to the nearest GB for drives under 45 GB (45,000,000,000 bytes), and rounded down to the nearest 5 GB for drives over 45 GB.

  • Page 28: Cli Syntax Reference

    Task CLI Command Page Controller Configuration Tasks View information about a controller /cx show View controller policies and other /cx show [attribute] [attribute] details View drive performance statistics /cx show dpmstat [type=inst|ra|ext] 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.2...
  • Page 29 Remove a unit (export) /cx/ux remove Name a unit /cx/ux set name Controller Maintenance Tasks Update controller with new /cx update firmware Add a time slot to a rebuild /cx add rebuild schedule 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.2...
  • Page 30 Identify all drives that make up a /cx/ux set identify unit by blinking associated LEDs Port Tasks Locate drive by blinking an LED /cx/px set identify Check if LED is set to on or off /cx/px show identify View information for specific drive /cx/px show www.3ware.com...
  • Page 31 LED Locate a temperature sensor in an /cx/ex/tempx set identify enclosure by blinking an LED Turn off or mute an audible alarm /cx/ex/almx set alarm in an enclosure 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.2...

  • Page 32: Terminology

    VPort. For additional information about 3ware controller concepts and terminology, see the user guide that came with your 3ware RAID controller or the user guide portions of the 3ware HTML Bookshelf. www.3ware.com...

  • Page 33: Syntax Overview

    You also use the 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.2...

  • Page 34: Shell Object Commands

    Shell object commands are either applicable to all the controllers in the system (such as show, rescan, flush, commit), or redirect the focused object. Syntax focus object commit flush rescan show [attribute [modifier]] alarms [reverse] diag rebuild selftest verify update fw=filename_with_path [force] www.3ware.com...

  • Page 35: Focus Object

    TW_CLI_INPUT_STYLE to old. (See “Return Code” on page 142.) commit This command sends a commit command to all 3ware controllers in the system. For more information, see “/cx commit” on page 64. 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.2...

  • Page 36: Flush

    Shell Object Commands flush This command sends a flush command to all 3ware controllers in the system. For more information, see “/cx flush” on page 64. rescan This command sends a rescan command to all 3ware controllers in the system.

  • Page 37: Show Alarms [Reverse]

    This command shows the diagnostic information of all controllers in the system. The enclosure diagnostic log may be requested by 3ware Customer Support to help troubleshoot problems on your controller. show rebuild This command displays all rebuild schedules for the 9000 series controllers in the system.

  • Page 38: Show Selftest

    For additional information about rebuild schedules, see “/cx add rebuild=ddd:hh:duration” on page 66, and see the discussion of background tasks and schedules in 3ware SAS/SATA RAID Software User Guide, Version 9.5.1. show selftest This command displays all selftest schedules for the 9000 series controllers in the system.

  • Page 39: Show Ver

    For additional information about verify schedules, see “/cx add verify=ddd:hh:duration” on page 67, “/cx set verify=basic [pref=ddd:hh]” on page 74, and see the discussion of background tasks and schedules in 3ware SAS/SATA RAID Software User Guide, Version 9.5.1. 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.2...

  • Page 40: Update Fw=Filename_With_Path [Force]

    [force] This command downloads the specified firmware image to the controllers that are compatible with it and iterates through all the controllers in the system, updating the firmware. For more information, see “/cx update fw=filename_with_path [force]” on page 64. www.3ware.com...

  • Page 41: Controller Object Commands

    /cx show phy (9690SA only) /cx add type=<RaidType> (RaidType={raid0,raid1,raid5,raid6(9650SE and higher only),raid10,raid50,single,spare}) disk=<p:-p..> [stripe=<Stripe>][noscan][nocache|nowrcache] [nordcache|rdcachebasic] [group=<3|4|5|6|7|8|9|10|11|12|13|14|15|16>] [autoverify][noqpolicy][ignorECC] [name=string](9000 series) [v0=n|vol=a:b:c:d](n=size of first volume in GB) [rapidrecovery=all|rebuild|disable](9000 series SE/SA) [storsave=<protect|balance|perform>] (9000 series SX/SE/SA only) 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.2...
  • Page 42 • A Unit summary listing all present units • A Port summary section listing of all ports (or virtual ports) and disks attached to them. • A BBU summary section listing, if a BBU is installed on the controller. www.3ware.com...
  • Page 43 VERIFY-PAUSED, REBUILDING, REBUILD-PAUSED, MIGRATING, and MIGRATE-PAUSED. Definitions of the unit statuses are available in the 3ware SAS/SATA RAID Software User Guide, Version 9.5.1. Note: If an asterisk (*) appears next to the status of a unit, there is an error on one of the drives in the unit.
  • Page 44 %RCmpl %V/I/M Stripe Size(GB) Cache AVrfy --------------------------------------------------------------------------- SPARE 149.042 Single 149.051 VPort Status Unit Size Type Phy Encl-Slot Model --------------------------------------------------------------------------- 149.05 GB SATA WDC WD1600JS-22NCB1 149.05 GB SATA WDC WD1600JS-22NCB1 149.05 GB SATA WDC WD1600JS-22NCB1 34.18 GB SEAGATE ST936701SS www.3ware.com...

  • Page 45: Cx Show Attribute [Attribute

    Each volume can be treated as an individual drive with its own file system. The 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.2...

  • Page 46: Cx Show Autorebuild

    If the policy is disabled, only spare drives will be used for an automatic rebuild operation. Example: //localhost> /c0 show autorebuild /c0 Auto-Rebuild Policy = on /cx show bios This command reports the BIOS version of controller /cx. Example: //localhost> /c0 show bios /c0 BIOS Version = BG9X 2.x www.3ware.com...

  • Page 47: Cx Show Carvesize

    (Instantaneous). This measurement provides a short duration average. ra (Running Average). Running average is a measure of long-term averages that smooth out the data, and results in older results fading from the average over time. 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.2...
  • Page 48 Drive Performance Monitor Configuration for /c0 ... Performance Monitor: ON Version: 1 Max commands for averaging: 100 Max latency commands to save: 10 Requested data: Instantaneous Drive Statistics Queue Xfer Resp Port Status Unit Depth IOPs Rate(MB/s) Time(ms) -------------------------------------------------------------- NOT-PRESENT NOT-PRESENT 2.907 2.640 NOT-PRESENT NOT-PRESENT www.3ware.com...
  • Page 49 “/cx/px set dpmstat=clear [type=ra|lct|ext]” on page 115. Example of drive statistics overflow: //localhost> /c3 show dpmstat type=ext Extended Drive Statistics for /c3 ... 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.2...

  • Page 50: Cx Show Drivestatus

    (Definitions of the drive statuses are available in the 3ware SAS/SATA RAID Software User Guide, Version 9.5.1.) Example for 9650SE and earlier controllers: //localhost>...

  • Page 51: Cx Show Exportjbod

    Some memory is reserved for use by the controller, so the amount of memory available will be less than the controller actually has installed. The 9690SA controller has 512MB of memory of which 448MB is available. 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.2...

  • Page 52: Cx Show Model

    Example for a 9650SE-16ML with no drives attached: //localhost> /c0 show numports /c0 Number of Ports = 16 Example for 9690SA-8E with 8 dual-port SAS drives: //localhost> /c3 show numports /c3 Connections = 16 of 128 www.3ware.com...

  • Page 53: Cx Show Numunits

    //localhost> /c0 show pchip /c0 PCHIP Version = 1.x /cx show serial This command reports the serial number of the specified controller /cx. Example: //localhost> /c0 show serial /c0 Serial Number = F12705A3240009 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.2...

  • Page 54: Cx Show Spinup

    DEGRADED, MIGRATING, MIGRATE-PAUSED, RECOVERY, INOPERABLE, and UNKNOWN. (Definitions of the unit statuses are available in the 3ware SAS/SATA RAID Software User Guide, Version 9.5.1.) Note: If an asterisk (*) appears next to the status of a unit, there is an error on one of the drives in the unit.

  • Page 55: Cx Show All

    3QJ03W34 931.51 GB 1953525168 GTA000PAGE2JKA 74.53 GB 156301488 5RX6AMGL 931.51 GB 1953525168 3QJ0392E 931.51 GB 1953525168 GTA000PAG67AGA DEGRADED 931.51 GB 1953525168 3QJ01PG6 931.51 GB 1953525168 GTA000PAGE1RSA NOT-PRESENT NOT-PRESENT NOT-PRESENT NOT-PRESENT NOT-PRESENT NOT-PRESENT 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.2...

  • Page 56: Cx Show Alarms [Reverse]

    Asynchronous event notifications (also referred to as AENs or controller alarms) are originated by controller firmware or an SES attached enclosure (9690SA or 9650SE only) and captured by the 3ware device drivers. These events reflect warnings, errors, and/or informative messages. These events are kept in a finite queue inside the kernel, and can be listed by CLI and 3DM 2.

  • Page 57: Cx Show Aens [Reverse]

    Gpbs. The current link speed for phy1 is 3.0 Gpbs, and the link control setting is 'Auto'. The link control setting could be either 1.5, 3.0, or Auto. 'Auto' denotes Automatic Negotiation, where the best negotiated speed possible for that link will be used. 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.2...

  • Page 58: Cx Show Rebuild

    For in depth information about rebuild and other background tasks, see “About Background Tasks” in the 3ware SAS/SATA RAID Software User Guide, Version 9.5.1. www.3ware.com...
  • Page 59 Y2NXQPZE NOT-PRESENT 76.33 GB 160086528 Y2NXM4VE 74.53 GB 156301488 3JV3WTSE 74.53 GB 156301488 3JV3WRHC 74.53 GB 156301488 3JV3WQLQ 74.53 GB 156301488 3JV3WQLZ Name OnlineState BBUReady Status Volt Temp Hours LastCapTest -------------------------------------------------------------------------- xx-xxx-xxxx 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.2...

  • Page 60: Cx Show Rebuildmode

    The Adaptive setting is the default rebuild mode. It allows the firmware to adjust the interaction of rebuild tasks with host I/Os to maximize the speed of both host I/O and rebuild tasks. The Low Latency setting minimizes latency www.3ware.com...

  • Page 61: Cx Show Rebuildrate

    For a more complete discussion of background task modes, see “Working with the Background Task Mode” in the 9.5.2 Addendum to the 3ware SAS/ SATA RAID Software User Guide.

  • Page 62: Cx Show Selftest

    Note: UDMA mode is applicable only for PATA (parallel ATA) drives on earlier 3ware controllers. It is not applicable for SATA or SAS drives. UDMA self test entails checking the current ATA bus speed (between controller and attached disk), which could have been throttled down during previous operations and increase the speed for best performance (usually one level higher).

  • Page 63: Cx Show Verify

    Advanced Verify Schedule For 9550SX and earlier controllers, and when verify=advanced for 9650SE and 9690SA controllers running 9.5.1 or later, the show verify command displays the current verify background task schedule as illustrated below. 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.2...

  • Page 64: Cx Show Verifymode

    For a more complete discussion of background task modes, see “Working with the Background Task Mode” in the 9.5.2 Addendum to the 3ware SAS/ SATA RAID Software User Guide...

  • Page 65: Cx Show Verifyrate

    In 9.5.2, the scale is reported correctly, as described above, with 5 the fastest verify rate. Example: //localhost> /c1 show verifyrate /c1 Verify task rate = 4 (faster verify; slower I/O) Related commands: /cx set verifymode=<adaptive|lowlatency> /cx set verifyrate=<1..5> /cx show verifymode 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.2...

  • Page 66: Rdcachebasic] [Autoverify] [Noqpolicy] [Ignoreecc] [Name=String]

    (9650SE and higher only), raid10, raid50, single, and spare. Example: type=raid5 When a new unit is created, it is automatically assigned a unique serial number. In addition, users can assign the unit a name. Note: The unit’s serial number cannot be changed. www.3ware.com...
  • Page 67 Table 7: Supported Stripe Sizes (KB) Model Spare Single JBOD 7K/8K 1024 1024 9000 9650SE 9690SA a. Models 9500S, 9550SX, and 9590SE 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.2...
  • Page 68 Basic. By default (if you do not set a read cache attribute), the read cache mode is set to Intelligent. This command is supported on 9650SE and later controllers. For more information, see “/cx/ux set rdcache=basic|intelligent|off” on page 94. www.3ware.com...
  • Page 69 This feature is only for 9000 series SX/SE/SA controllers. For more information, see “/cx/ux set storsave=protect|balance|perform [quiet]” on page 97. 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.2...
  • Page 70 Setting write cache=ON for the new unit ... Done. Setting default Command Queuing Policy for unit /c0/u0 to [on] ... Done. After the unit creation, a subsequent show command for the unit shows the the volume size(s): //localhost> /c0/u0 show www.3ware.com...
  • Page 71 931.312 u0-3 DISK 931.312 u0-4 DISK 931.312 u0-5 DISK 931.312 u0-6 DISK 931.312 u0/v0 Volume 2000 u0/v1 Volume u0/v2 Volume 1024 u0/v3 Volume u0/v4 Volume 1024 u0/v5 Volume 1024 u0/v6 Volume 247.188 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.2...

  • Page 72: Cx Rescan [Noscan]

    This command allows the downloading of the specified firmware image to the corresponding controller. Before issuing this command, you must have already obtained the Note: firmware image and placed it on your system. You can obtain the firmware image from the 3ware website: http:www.3ware.com/downloads. www.3ware.com...
  • Page 73 Current firmware version is the same as the new firmware. Recommendation: No need to update. Given the above recommendation... Do you want to continue ? Y|N [N]: y Downloading the firmware from file /tmp/prom0006.img ... Done. 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.2...

  • Page 74: Cx Add Rebuild=Ddd:hh:duration

    Use the /cx set rebuild=enable command to enable the schedule (this enables all rebuild schedule slots). (For details, see page 70.) Warning: If all time slots are removed from the rebuild task schedule, be sure to also disable the schedule. Otherwise the rebuild task will never occur. www.3ware.com...

  • Page 75: Cx Add Verify=Ddd:hh:duration

    (this enables all rebuild schedule slots). (For details, see page 72.) Use the /cx/ux set autoverify=on command to turn on autoverify for each unit you want to follow the schedule. (For details, see page 92.) 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.2...

  • Page 76: Cx Add Selftest=Ddd:hh

    If any of the scheduled tasks do not match your desired schedule, use the /cx del selftest command to remove them. (For details, see page 69.) Use the /cx add selftest command to create the selftest schedule slots you want (described above.) www.3ware.com...

  • Page 77: Cx Del Rebuild=Slot_Id

    //localhost> /c1 del selftest=3 Will remove selftest background task in slot 3. Warning: If all time slots are removed, be sure to also disable the schedule. Otherwise the selftest background task will never occur. 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.2...

  • Page 78: Cx Set Dpmstat=On|Off

    To clear the data, use the command “/cx/px set dpmstat=clear [type=ra|lct|ext]” on page 115. For more information, see “Drive Performance Monitoring” on page 253 of the 3ware SAS/SATA RAID Software User Guide, Version 9.5.1. Example: //localhost> /c0 set dpmstat=off Setting Drive Performance Monitoring on /c0 to [off]...

  • Page 79: Cx Set Rebuildmode=

    RAID unit by slowing down the rebuild task, which allows host Reads to complete, thus improving performance. For a more complete discussion of background task modes, see “Working with the Background Task Mode” in the 9.5.2 Addendum to the 3ware SAS/ SATA RAID Software User Guide. Important:...

  • Page 80: Cx Set Rebuildrate=<1

    The priority of verify versus I/O operations is specified with 1..5, where 5 is more resources and 1 the least. Setting this value to 5 implies fastest verify, and 1 implies fastest I/O. 5 = fastest verify; slowest I/O 4 = faster verify; slower I/O 3 = balanced between verify and I/O www.3ware.com...

  • Page 81: Cx Set Verify=Advanced|Basic|1

    The priority of verify versus I/O operations is specified with 1..5, where 5 is more resources and 1 the least. Setting this value to 1 implies fastest I/O, and 5 implies fastest verify. 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.2...

  • Page 82: Cx Set Verifymode=

    Verify mode works in conjunction with the verify task rate (see “/cx set verifyrate=<1..5>” on page 75). The Adaptive setting is the default verify mode. It allows the firmware to adjust the interaction of verify tasks with host I/Os to maximize the speed of both host I/O and verify tasks. www.3ware.com...

  • Page 83: Cx Set Verifyrate=<1

    Reads to complete, thus improving performance. For a more complete discussion of background task modes, see “Working with the Background Task Mode” in the 9.5.2 Addendum to the 3ware SAS/ SATA RAID Software User Guide. Important:...

  • Page 84: Cx Set Selftest=Enable|Disable [Task=Udma|Smart]

    (UDMA or SMART). The selftest schedule is always enabled. For 3ware RAID controllers older than the 9690SA, two self-tests can be set: one to check whether UDMA Mode can be upgraded (applies to PATA drives only) , and another to check whether SMART thresholds have been exceeded.

  • Page 85: Cx Set Ondegrade=Cacheoff|Follow

    Each volume can then be treated as an individual disk with its own file system. The default carvesize is 2 TB. 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.2...

  • Page 86: Cx Set Carvesize=[1024

    Enabling Auto-Rebuild allows you to add a drive to the controller and have it be available for a rebuild as soon as you tell the controller to rescan, without www.3ware.com...

  • Page 87: /Cx Set Autodetect=On|Off Disk=|All

    For the 9690SA controller, it would spinup all directly attached SAS and SATA drives, but not any drives attached to an expander. Example: //localhost>> /c0 set autodetect=off disk=all Setting Auto-Detect on /c2 to [off] for all disks/ports... Done. 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.2...

  • Page 88: Cx Start Mediascan

    /cx. stop mediascan This command applies only to 7000/8000 controllers. This commands stops a media scan operation on the specified controller /cx. (Media scans are started using /cx start mediascan.) www.3ware.com...

  • Page 89: Unit Object Commands

    /cx/ux set storsave=protect|balance|perform [quiet](9000 series SX/SE/SA only) /cx/ux migrate type=RaidType [disk=p:-p] [group=3|4|5|6|7|8|9|10|11|12|13|14|15|16] [stripe=size] [noscan] [nocache] [autoverify] (9000 series) RaidType = {raid0, raid1, raid5, raid6(9650SE and later only), raid10, raid50, single} /cx/ux remove [noscan] [quiet] 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.2...

  • Page 90: Cx/Ux Show

    Similarly, if the unit was created using the 3ware BIOS utility 3BM and a size was entered in the Boot Volume Size field, multiple volumes were created and will be displayed.
  • Page 91 DISK 298.20 u0-3 DISK REBUILDING 298.20 u0-4 DISK 298.20 u0-5 DISK 298.20 u0-6 DISK 298.20 u0-7 DISK 298.20 u0-8 DISK REBUILD-PAUSE 298.20 u0-9 DISK 298.20 u0-10 DISK 298.20 u0-11 DISK 298.20 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.2...

  • Page 92: Cx/Ux Show Attribute [Attribute

    /c0/u0 Write Cache State = on /cx/ux show wrcache This command shows the current write cache state of the specified unit. (It provides the same information as the command /cx/ux show cache.) Example: //localhost> /c0/u0 show wrcache /c0/u0 Write Cache State = on www.3ware.com...

  • Page 93: Cx/Ux Show Rdcache

    /c0/u5 is not initializing, its current state is OK /cx/ux show name This feature only applies to 9000 series controllers. This command reports the name (if any) of the specified unit. Example: //localhost> /c0/u5 show name /c0/u5 name = Joe 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.2...

  • Page 94: Cx/Ux Show Qpolicy

    //localhost> /c0/u5 show rebuildstatus /c0/u5 is not rebuilding, its current state is OK If the unit is in the process of migrating, the command will return the following: //localhost> /c0/u5 show rebuildstatus /c0/u5 is not rebuilding, its current state is MIGRATING www.3ware.com...

  • Page 95: Cx/Ux Show Serial

    Possible statuses include: OK, VERIFYING, VERIFY-PAUSED, INITIALIZING, INIT-PAUSED, REBUILDING, REBUILD-PAUSED, DEGRADED, MIGRATING, MIGRATE-PAUSED, RECOVERY, INOPERABLE, and UNKNOWN. (Definitions of the unit statuses are available in the 3ware SAS/SATA RAID Software User Guide, Version 9.5.1.) Example: //localhost> /c0/u0 show status /c0/u5 status = OK /cx/ux show storsave This feature only applies to 9000 series SX/SE/SA model controllers.

  • Page 96: Cx/Ux Show Volumes

    Similarly, if the unit was created using the 3ware BIOS utility 3BM and a size was entered in the Boot Volume Size field, multiple volumes were created and will be displayed. Note that a volume created using the Boot Volume Size feature does not have to be used as a boot volume.

  • Page 97: Cx/Ux Remove [Noscan] [Quiet]

    The default is to inform the operating system. quiet is used for non-interactive mode. No confirmation is given and the command is executed immediately. This is useful for scripting purposes. 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.2...

  • Page 98: Cx/Ux Start Rebuild Disk=

    N/A (Not Applicable) refers to cases where the RAID type is not supported on that controller model. Table 9: Supported RAID (Logical Unit) Types for Verification Model Single Spare JBOD 7K/8K www.3ware.com...
  • Page 99 (verify=disable) (Same as Basic) Verify Schedule is Follows Follows Verify Follows Verify Enabled Advanced Verify Schedule Schedule (verify=enable) Schedule Verify will pause if a rebuild, migration, or initialization is currently in progress. 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.2...

  • Page 100: Cx/Ux Pause Rebuild

    This feature only applies to 9000 series controllers. This command allows you to turn on and off the autoverify operation on a specified unit /cx/ux. By default, autoverify is on for 9650SE and 9690SA controllers running firmware 9.5.1 or later, and off all earlier controller models. www.3ware.com...
  • Page 101 Verify Schedule is Follows Follows verify Follows verify Enabled Advanced Verify schedule schedule (verify=enable) Schedule For more about setting up verify schedules, see “Setting Up a Verify Schedule” on page 67. 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.2...

  • Page 102: Cx/Ux Set Cache=On|Off [Quiet]

    By default, write cache is on. Write cache includes the disk drive cache and controller cache. When write cache is on, data will be stored in 3ware controller cache and drive cache before the data is committed to disk. This allows the system to process multiple write commands at the same time, thus improving performance.

  • Page 103: Cx/Ux Set Identify=On|Off

    This command allows you to identify a unit within an enclosure by blinking the LEDs associated with the drive slots of the specified unit. Example: //localhost> /c0/u0 set identify=on Sending Identify request for unit /c0/u0 to [on] ... Done. 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.2...

  • Page 104: Cx/Ux Set Ignoreecc=On|Off

    ''new'' parent unit. Thus, this command does not set the queue policy for the spare unit type. Queuing is only applicable for SATA drives. Note: By default, qpolicy is Example: //localhost> /c0/u5 set qpolicy = on Setting Command Queuing Policy for unit /c0/u5 to [on] ... Done. www.3ware.com...

  • Page 105: Cx/Ux Set Rapidrecovery All|Rebuild|Disable [Quiet]

    The following description about the settings should help you to decide which one is suitable to you and your application. You will find further discussion of this setting in the 3ware SAS/SATA RAID Software User Guide, Version 9.5.1, under “About StorSave Profile Levels” on page 124.
  • Page 106 No confirmation is given and the command is executed immediately. This is useful for scripting purposes. For additional information, see “Setting the StorSave Profile for a Unit” in the 3ware SAS/SATA RAID Software User Guide, Version 9.5.1. Example: //localhost> /c0/u5 set storsave=protect Setting Command Storsave Policy for unit /c0/u5 to [protect] ...

  • Page 107: Cx/Ux Migrate Type=Raidtype [Disk=P:-P]

    A four-drive RAID 5 unit can migrate to a four-drive RAID 0, but a four-drive RAID 0 unit cannot migrate to a four-drive RAID 5, without adding another drive, due to the need for additional storage capacity for parity bits. 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.2...
  • Page 108 For example, given 6 disks, specifying 3 will create two RAID 5 arrays. With 12 disks, specifying 3 will create four RAID 5 arrays under the RAID 0 level. With only 6 disks a grouping of 6 is not allowed, as you would basically be creating a RAID 5. www.3ware.com...
  • Page 109 (unless a BBU or UPS is installed). By default the cache is enabled. To avoid the possibility of data loss in the event of a sudden power loss, it is recommended not to set nocache 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.2...
  • Page 110 Sending migration message to /c0/u3 ... Done. In this case, the command indicates that the source unit is u3 and the destination unit has a RAID type of raid10 and has added the disks 10 and 11 to the disks in the existing unit u3. www.3ware.com...
  • Page 111 As a result this command shows a different status than other migration paths. In addition, the status of the newly specified disk will show DEGRADED until the “migration/rebuild” is complete. 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.2...
  • Page 112 Single to a RAID-1, initiated by the following commands: /c0/u0 migrate type=raid0 /c0/u1 migrate type=raid1 disk=5 Note the difference in UnitType and Status of u0 and u1, even though they are both migrating units. 3ware CLI> /c0 show Unit UnitType Status %RCmpl...
  • Page 113 Chapter 2. CLI Syntax Reference u1-0 DISK 372.519 u1-1 DISK DEGRADED 372.519 u1/v0 Volume 372.519 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.2...

  • Page 114: Port Object Commands

    Example for 9650SE and earlier controllers: //localhost> /c1/p5 show Port Status Unit Size Blocks Serial --------------------------------------------------------- 149.05 GB 312581808 3JS0L9QW The above output indicates that port 5 of controller 1 is attached to one disk with status OK participating in unit 0. www.3ware.com...

  • Page 115: Cx/Px Show Attribute [Attribute

    This command applies to the 9690SA only. It displays the following information about the drive: can be either SAS or SATA. Drive Type can be either Direct or Expander. This indicates how the drive Interface Type is connected to the controller. 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.2...

  • Page 116: Cx/Px Show Firmware

    This command displays the maximum SATA link speed supported by the drive attached to the port and the present SATA link speed setting. Example: //localhost> /c0/p5 show lspeed /c0/p5 SATA Link Speed Supported = 3.0 Gb/s /c0/p5 SATA Link Speed = 3.0 Gb/s www.3ware.com...

  • Page 117: Cx/Px Show Model

    Because the data is extracted live from the disk, this command can be used to get the most recent data about the presence or absence of a disk. The SMART data is displayed in hexadecimal form. 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.2...

  • Page 118: Cx/Px Show Status

    This can be one way of detecting whether or not a drive is present. /cx/px show status This command displays the status of the drive attached to the specified port. (Definitions of the drive statuses are available in the 3ware SAS/SATA RAID Software User Guide, Version 9.5.1.) Example: //localhost>...
  • Page 119 C4 55 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 CC 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.2...

  • Page 120: Cx/Px Show Dpmstat Type=Inst|Ra|Lct|Histdata|Ext

    “/cx show dpmstat [type=inst|ra|ext]” on page 39. For more information, see “Drive Performance Monitoring” on page 253 of the 3ware SAS/SATA RAID Software User Guide, Version 9.5.1. Example of running average statistics (RA) //localhost>...
  • Page 121 To display a histogram of IOPs grouped together based on response time associated with the specified port, use command /cx/px show dpmstat type=histdata. //localhost> /c0/p3 show dpmstat type=histdata Port Status Unit ------------------------------ Response Time(ms) IO Count ----------------------------------------------- 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.2...

  • Page 122: Cx/Px Remove [Noscan] [Quiet]

    After the drive is removed in CLI it can be removed physically, without powering down the system if a hot swap bay is available. System hangs and damage can occur if a hot swap bay is not used. www.3ware.com...

  • Page 123: Cx/Px Set Identify=On|Off

    If no type is specified, the default is the same as type=ra. Note that there are no direct commands for clearing only histogram data, or for clearing instantaneous data. 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.2...
  • Page 124 If I/O traffic to the drive has been stopped, after clearing, a subsequent request to show the running average statistics would show all zeros. //localhost> /c0/p3 show dpmstat type=ra Queue Xfer Resp Port Status Unit Depth IOPs Rate(MB/s) Time(ms) -------------------------------------------------------------- 0.000 Similarly, the display for Histogram data would also be all zeros. www.3ware.com...

  • Page 125: Phy Object Commands

    SAS are: . Speed is in Gigabytes per second and the auto default setting is auto. Example: //localhost> /c0/phy0 set link=1.5 Sending link speed control of /c0/phy0 to [1.5 Gbps] ... Done. 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.2...

  • Page 126: Bbu Object Commands

    The BBU is not ready to backup the write cache on the controller (due to the testing). (For complete information about the BBU, see the user guide that came with your 3ware RAID controller). Note: If the BBU is either not present or disabled, the following will be displayed after the command //localhost>...

  • Page 127: Cx/Bbu Show Attribute [Attribute

    If you have not run the BBU test command for some time, this number can be misleading. For information about running a test, see “/cx/bbu test [quiet]” on page 122. /cx/bbu show pcb This command shows the PCB revision number on the BBU. 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.2...

  • Page 128: Cx/Bbu Show Serial

    However, the battery is weak and should be replaced. The BBU is ready, online and capable of backing up the write cache. - (dash) A battery is not present or a Battery Backup Unit is not installed www.3ware.com...

  • Page 129: Cx/Bbu Show Temp

    = OK /c1/bbu Estimated Backup Capacity = 241 Hours /c1/bbu Last Capacity Test = 22-Jun-2008 /c1/bbu Battery Installation Date = 20-Jun-2008 /c1/bbu Bootloader Version = BBU 0.02.00.002 /c1/bbu PCB Revision = 65 //localhost> 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.2...

  • Page 130: Cx/Bbu Test [Quiet]

    AENs [reverse]. Using the “reverse” attribute displays the most recent AEN message at the top of the list. (For a list of all AENs, see the user guide that came with your 3ware RAID controller.) /bbu enable This command enables BBU detection on the controller. If the BBU is Ready, the controller will utilize BBU functionality in the event of a power failure.

  • Page 131: Enclosure Object And Element Commands

    /cx/ex show /cx/ex show attribute [attribute ...] where attributes are: controllers|diag|protocol|slots|fans|temp|pwrs|alarms /cx/ex show all /cx/ex/slotx show /cx/ex/slotx show identify /cx/ex/slotx set identify=on|off /cx/ex/fanx show /cx/ex/fanx show identify /cx/ex/fanx set identify=on|off /cx/ex/fanx set speed=<0|1|2|3|4|5|6|7> 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.2...

  • Page 132: Cx/Ex Show

    9500 fan2 8540 fan3 2830 fan4 9120 fan5 8330 TempSensor Status Temperature Identify -------------------------------------------------------- temp0 41C(105F) temp1 38C(100F) temp2 34C(93F) temp3 38C(100F) temp4 38C(100F) temp5 34C(93F) temp6 NOT-INSTALLED temp7 NOT-INSTALLED PowerSupply Status State Voltage Current Identify --------------------------------------------------------------------------- pwrs0 pwrs1 www.3ware.com...

  • Page 133: Cx/Ex Show Attribute [Attribute

    This command allows you to view the enclosure diagnostic log. What is reported by this log will vary depending upon the manufacturer of the enclosure. The enclosure diagnostic log may be requested by 3ware Customer Support to help troubleshoot problems on your controller.

  • Page 134: Cx/Ex Show Slots

    RPM (revolutions per minute). There are seven speed levels: 0 - Off 1 - Lowest 2 - Low 3 - Medium-low 4 - Medium 5 - Medium-high 6 - High 7 - Highest The Identify column lists the Identify setting of the fans. www.3ware.com...

  • Page 135: Cx/Ex Show Temp

    The PowerSupply column lists the IDs of the power supply units, the Status column lists the status of each power supply, the State column indicate if the 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.2...

  • Page 136: Cx/Ex Show Alarms

    OK. If the slot is empty the status will indicate NO-DEVICE. The port that is correlated to the slot is indicated in the next column. If no device is found in the slot, that www.3ware.com...

  • Page 137: Cx/Ex/Slotx Show Identify

    Setting identify to on will cause the LED associated with that slot to blink. This command is equivalent to “/cx/px set identify=on|off” on Note: page 115. Example: //localhost> /c0/e0/slot1 set identify=on Setting Slot Identify /c0/e0/slot0 to [on] ... Done. 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.2...

  • Page 138: Cx/Ex/Fanx Show

    This command is used with the 9690SA controller. For the 9650SE, simply drop the prepended controller name in the command and use /ex. This command sets the speed level of the specified enclosure fan. The speed level is a number in the range of <0 . . 7>, where: www.3ware.com...

  • Page 139: Cx/Ex/Pwrsx Show

    The status can be either on or off. If identify is on, the LED associated with the power supply will blink. If the enclosure does not support Power Supply Identify, this command will return N/A. Example: //localhost> /c0/e0/pwrs1 show identify /c0/e0/pwrs1 Identify status = on 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.2...

  • Page 140: Cx/Ex/Pwrsx Set Identify=On|Off

    /tempx in the specified enclosure cx/ex. The possible status values are OK, OVER-WARNING, OVER-FAIL, UNDER-WARNING, UNDER- FAIL, where OVER denotes over-temperature and UNDER denotes under- temperature. For more information about these statuses, see the 3ware SAS/ SATA RAID Software User Guide, Version 9.5.1 Example: //localhost>...

  • Page 141: Cx/Ex/Tempx Set Identify=On|Off

    This command controls the audibility and state of the enclosure alarm. It provides the ability to silence the alarm after it has activated. It also gives you the option to mute or unmute the alarm setting. 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.2...

  • Page 142: Help Commands

    (such as /cx, /cx/ux, /cx/px, /cx/bbu, /ex, /ex/slotx, /ex/fanx, and /ex/tempx), displays all possible sub-commands associated with the object. For example: help on the controller object /cx, will display all the sub- commands associated with the controller /cx, like this: //localhost> help /cx /cx show www.3ware.com...
  • Page 143 /cx set autocarve=on|off (9000 series) /cx set carvesize=[1024..32768] (9KSX/SE/SA only) /cx set rebuild=enable|disable|<1..5> (enable|disable for 9000 series) /cx set rebuildmode=<adaptive|lowlatency> (9KSE/SA only) /cx set rebuildrate=<1..5> (9KSE/SA only) /cx set verify=enable|disable|<1..5> (enable|disable for 9000 series) 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.2...

  • Page 144: Help With Attributes

    (9000 only) /cx show verify (9000 only) /cx show selftest (9000 only) //localhost> help This help command provide a table of contents, providing help with the overall navigation of the CLI commands. Typical output looks like the following. //localhost> help www.3ware.com...

  • Page 145: Help Show

    26 for more information. help rescan This command provides specific rescan related help, illustrating various ways to use the rescan command. See the section “Shell Object Commands” on page 26 for more information. 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.2...

  • Page 146: Help Update

    /cx/ux. See the section “Unit Object Commands” on page 81 for more information. help /c This command provides specific /cx/px related help, illustrating various ways to use the /cx/px command. See the section “Port Object Commands” on page 106 for more information. www.3ware.com...

  • Page 147: Help /Cx/Bbu

    /pwrsx This command provides specific power supply /cx/ex/pwrsx related help, illustrating various ways to use the /cx/ex/pwrsx command. See the section “Enclosure Object and Element Commands” on page 123 for more information. 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.2...

  • Page 148: Help /Cx/Ex/Almx

    Advance settings For all previous versions of Windows (XP, Server 2003, etc) The log file is stored in \Documents and Settings\All Users\Application Data\AMCC For Linux, FreeBSD, Mac OS, and OpenSolaris The log file is in the directory /var/log www.3ware.com...

  • Page 149: Disabling And Enabling Command Logging

    On the Advanced tab, click the Environment Variables button. You can add a new variable by clicking , or edit an existing variable by selecting TW_CLI_LOG in the list and clicking Edit 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.2...

  • Page 150: Return Code

    $? The screen prints either a 0 or a 1, depending on whether the command was successful or not. For example, if you had a 3ware controller with an ID of 0, you could type this command: tw_cli /c0 show...

This manual is also suitable for:

9690sa9590se9550sx9550sxu9500s3ware 9650se

Table of Contents