3Ware 720-0186-00 Manual

3Ware 720-0186-00 Manual

Sas/sata raid controller
Table of Contents

Advertisement

Quick Links

®
3ware
SAS/SATA

RAID Controller

Command Line Interface
Version 9.5.1—Supports the 9000 Series
(9690SA, 9650SE, 9590SE, 9550SX(U), and 9500S)
PN: 720-0186-00
August 2008

Advertisement

Table of Contents
loading
Need help?

Need help?

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

Questions and answers

Summary of Contents for 3Ware 720-0186-00

  • Page 1: Raid Controller

    ® 3ware SAS/SATA RAID Controller Command Line Interface Version 9.5.1—Supports the 9000 Series (9690SA, 9650SE, 9590SE, 9550SX(U), and 9500S) PN: 720-0186-00 August 2008...
  • Page 2 Trademarks 3ware®, Escalade®, 3DM®, and TwinStor® are all registered trademarks of AMCC. The 3ware logo, 3BM, Multi-Lane, StorSave, StorSwitch, StreamFusion, and R5 Fusion are all trademarks of AMCC. Linux® is a registered trademark of Linus Torvalds in the United States, other countries, or both.
  • Page 3: Table Of Contents

    Installing the 3ware CLI on Windows ........
  • Page 4 /cx stop mediascan ..........73 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.1...
  • Page 5 /cx/px set identify=on|off ......... . . 105 /cx/px set dpmstat=clear [type=ra|lct|ext] ......106 www.3ware.com...
  • Page 6 /cx/ux ............125 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.1...
  • Page 7 Return Code ............128 www.3ware.com...
  • Page 8: 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 9: Introduction To The 3Ware Command Line Interface

    If a command is labeled as applying to the SX controller, it is available for both 9550SX and 9550SXU. 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 10: 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.1 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 11: 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 12: Installing The 3Ware Cli On Linux And Freebsd

    /home/user/tw_cli The 3ware CLI comes in both 32-bit and 64-bit versions. If you are copying the file directly, be sure to copy the correct version for the version of the operating system you are using.
  • Page 13: Working With 3Ware Cli

    The default directory location used by 3ware is /opt/AMCC/CLI/tw_cli. More detailed information about using this installer is supplied in Appendix B of 3ware SAS/SATA RAID Software User Guide, Version 9.5.1. Working with 3ware CLI You can work with the 3ware CLI in different ways: •...
  • Page 14: Using The Command Interface Interactively

    ./tw_cli ) The main prompt is displayed, indicating that the program is awaiting a command. //localhost> At the CLI prompt, you can enter commands to show or act on 3ware controllers, units, and drives. For example, //localhost> show...
  • Page 15: Using An Input File To Execute A Script

    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.
  • Page 16: Conventions

    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).
  • Page 17: Raid 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 18: Available Raid Configurations

    RAID levels 0, 1, 10 and 5 are the most popular. AMCC'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 19 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 20 For example, one sub-unit can be degraded, while another may be rebuilding, or one sub-unit may be initializing, while another is verifying. AMCC 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 21 (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 22 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 23 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 24: 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 25: 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 26: 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 27: 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.1...
  • Page 28 Controller Maintenance Tasks Update controller with new /cx update firmware Add a time slot to a rebuild /cx add rebuild schedule Add a time slot to a verify /cx add verify schedule 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.1...
  • Page 29 /cx/px show status Show statistics for the drive on a /cx/px show dpmstat particular port type=inst|ra|lct|histdata|ext Clear statistics counters for a /cx/px set dpmstat=clear particular drive [type=ra|lct|ext] PHY Tasks View details about link speed for a /cx/phyx show specified phy www.3ware.com...
  • Page 30: Terminology

    RAID 10 and RAID 50 are examples of three-tier units and as such will have sub-sub-units. 3ware controller models up to the 9650SE series have one or many ports Port. (typically 4, 8, 12, 16, or 24). Each port can be attached to a single disk drive.
  • Page 31: Syntax Overview

    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. Syntax Overview...
  • Page 32 For details, see “Help Commands” on page 121. Shell Object Commands Controller Object Commands Unit Object Commands Port Object Commands Phy Object Commands BBU Object Commands Enclosure Object and Element Commands Help Commands 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.1...
  • Page 33: Shell Object Commands

    URI (Universal Resource Identifier) of an object on controller , unit specifies one level up (the parent object). specifies the root ./object specifies the next level of the object. /c0/bbu specifies a relative path with respect to the current focused hostname. www.3ware.com...
  • Page 34: Commit

    This command sends a commit command to all 3ware controllers in the system. For more information, see “/cx commit” on page 60. flush This command sends a flush command to all 3ware controllers in the system. For more information, see “/cx flush” on page 60. rescan This command sends a rescan command to all 3ware controllers in the system.
  • Page 35: Show Alarms [Reverse]

    MIGRATING, MIGRATE-PAUSED, RECOVERY, INOPERABLE, and UNKNOWN. RRate also applies to initializing, migrating, and recovery background tasks. (Definitions of the unit statuses are available in the 3ware SAS/SATA RAID Software User Guide, Version 9.5.1.) Example for 9690SA-414E with enclosure and expander:...
  • Page 36: Show Rebuild

    For additional information about rebuild schedules, see “/cx add rebuild=ddd:hh:duration” on page 62, 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 37: Show Ver

    /c3 basic verify weekly preferred start: Saturday, 12:00AM For additional information about verify schedules, see “/cx add verify=ddd:hh:duration” on page 63, “/cx set verify=basic [pref=ddd:hh]” on page 68, and see the discussion of background tasks and schedules in 3ware SAS/SATA RAID Software User Guide, Version 9.5.1. www.3ware.com...
  • Page 38: Update Fw=Filename_With_Path [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 60. 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.1...
  • Page 39: Controller Object Commands

    [rapidrecovery=all|rebuild|disable](9000 series SE/SA) [storsave=<protect|balance|perform>] (9000 series SX/SE/SA only) /cx add rebuild=ddd:hh:duration (9000 series) /cx add verify=ddd:hh:duration (9000 series) /cx add selftest=ddd:hh (9000 series) /cx set dpmstat=on|off (9000 series SX/SE/SA only) /cx del rebuild=slot_id (9000 series) /cx del verify=slot_id (9000 series) www.3ware.com...
  • Page 40 Possible unit statuses include OK, RECOVERY, INOPERABLE, UNKNOWN, DEGRADED, INITIALIZING, INIT-PAUSED, VERIFYING, 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. 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.1...
  • Page 41 149.05 GB 312581808 WD-WCANM1883862 149.05 GB 312581808 WD-WCANM1778008 149.05 GB 312581808 WD-WCANM1770998 NOT-PRESENT 149.05 GB 312581808 WD-WCANM1869003 149.05 GB 312581808 WD-WCANM1762464 Name OnlineState BBUReady Status Volt Temp Hours LastCapTest ------------------------------------------------------------------------- 22-Jun-2004 The above output is for 9650SE and earlier controllers. www.3ware.com...
  • Page 42: Cx Show Attribute [Attribute

    (In the sample output above, “x” will be replaced with the actual version number.) /cx show achip This command reports the ACHIP (ATA Interface Chip) version of the specified controller /cx. Example: //localhost> /c0 show achip /c0 ACHIP Version = 3.x 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.1...
  • Page 43: Cx Show Allunitstatus

    For more information, see “/cx set autorebuild=on|off” on page 71. 1. Smallest usable spare. 2. Smallest usable unconfigured (available) drive. 3. Smallest usable failed drive. www.3ware.com...
  • Page 44: Cx Show Bios

    /c2 Controller Bus Width = 8 lanes /c2 Controller Bus Speed = 2.5 Gbps/lane /cx show driver This command reports the device driver version associated with controller /cx. Example: //localhost> /c0 show driver /c0 Driver Version = 3.x 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.1...
  • Page 45: Cx Show Dpmstat [Type=Inst|Ra|Ext]

    The amount of statistics data in the buffer is determined by these configurations and the memory constraints of the system. These configuration settings cannot be changed. www.3ware.com...
  • Page 46 Max commands for averaging: 100 Max latency commands to save: 10 Requested data: Running Average Drive Statistics Queue Xfer Resp Port Status Unit Depth IOPs Rate(MB/s) Time(ms) ------------------------------------------------------------------------ NOT-PRESENT NOT-PRESENT 25.249 21.630 NOT-PRESENT NOT-PRESENT 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.1...
  • Page 47 Example of drive statistics overflow: //localhost> /c3 show dpmstat type=ext Extended Drive Statistics for /c3 ... Sectors Commands ----------------------------- -------------------------------------- Port Read Write Write-FUA Read Write Write-FUA Flush ----------------------------------------------------------------------- ######## 158838656 158838720 0 ######## ######## ######## ######## ######## ######## ######## ######## www.3ware.com...
  • Page 48: 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 49: Cx Show Exportjbod

    /c0 JBOD Export Policy = Not Supported. //localhost> /c1 show exportjbod /c1 JBOD Export Policy = on /cx show firmware This command reports the firmware version of controller /cx. Example: //localhost> /c0 show firmware /c0 Firmware Version = FE9X 3.03.06.X03 www.3ware.com...
  • Page 50: Cx Show Memory

    On 9500S and earlier controllers, physically-removed disk(s) will still be counted. For a workaround, see “/cx/px show smart” on page 100. Example: //localhost> /c0 show numdrives /c0 Number of Drives = 5 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.1...
  • Page 51: Cx Show Numports

    /cx. Example: //localhost> /c0 show pcb /c0 PCB Version = RevX /cx show pchip This command reports the PCHIP (PCI Interface Chip) version of the specified controller /cx. Example: //localhost> /c0 show pchip /c0 PCHIP Version = 1.x www.3ware.com...
  • Page 52: Cx Show Serial

    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 53: Cx Show All

    /c2 Controller Bus Speed = 2.5 Gbps/lane Unit UnitType Status %RCmpl %V/I/M Stripe Size(GB) Cache AVrfy --------------------------------------------------------------------------- RAID-5 REBUILD-PAUSED 0% 372.476 Port Status Unit Size Blocks Serial --------------------------------------------------------------- NOT-PRESENT 931.51 GB 1953525168 3QJ03W34 931.51 GB 1953525168 GTA000PAGE2JKA 74.53 GB 156301488 5RX6AMGL www.3ware.com...
  • Page 54: Cx Show Alarms [Reverse]

    [Tue Apr 01 2008 12:34:02] WARNING Drive removed: port=1 [Tue Apr 01 2008 12:34:22] ERROR Unit inoperable: unit=1 [Tue Apr 01 2008 12:34:23] INFO Drive inserted: port=1 [Tue Apr 01 2008 12:34:23] INFO Unit operational: unit=1 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.1...
  • Page 55: Cx Show Diag

    Example of 9690SA-8I with directly attached drives: //localhost> /c3 show phy Device --- Link Speed (Gbps) --- SAS Addesss Type Device Supported Enabled Limit -------------------------------------------------------------------------- phy0 500050e000000002 SATA /c3/p0 1.5-3.0 Auto phy1 500050e000000002 SATA /c3/p1 1.5-3.0 Auto phy2 500050e000000002 SATA /c3/p2 1.5-3.0 Auto www.3ware.com...
  • Page 56: 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. The show rebuild command displays the current rebuild background task schedule as illustrated below.
  • Page 57: P3 Ok U0

    1:00am 4 hr(s) enabled 12:00am 1 hr(s) enabled $ tw_cli /c1 show Unit UnitType Status %RCmpl %V/I/M Stripe Size(GB) Cache AVrfy -------------------------------------------------------------------------- RAID-5 INIT-PAUSED 521.466 Port Status Unit Size Blocks Serial --------------------------------------------------------------- NOT-PRESENT 76.33 GB 160086528 Y2NXL7FE NOT-PRESENT www.3ware.com...
  • Page 58: 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 59: Cx Show Verify

    RAID 0, single, and spare, are also verified (by reading and reporting un-readable sectors). If any parity mismatches are found, the array will be automatically background initialized. (For information about the initialization process, see the user guide that came with your 3ware RAID controller.) www.3ware.com...
  • Page 60 For 9650SE and 9690SA controllers, if the “basic” Verify Task Schedule is selected, the show verify command displays a schedule as illustrated below: //localhost> /c1 show verify /c1 basic verify weekly preferred start: Friday 12:00am 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.1...
  • Page 61: [Rapidrecovery=All|Rebuild|Disable] [V0=N|Vol=A:b:c:d]

    (9650SE and higher only), raid10, raid50, single, and spare. type=raid5 Example: 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 62 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.1...
  • Page 63 9690SA controllers that support basic verify, autoverify will be set to ON by default for a new unit. For other 9000-series controllers that do not support basic verify, autoverify is set to OFF by default for a new unit. www.3ware.com...
  • Page 64 Setting it to rebuild applies it only to rebuild tasks. If the policy is set to disable, then none of the tasks will be sped up. 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.1...
  • Page 65 After the unit creation, a subsequent show command for the unit shows the the volume size(s): //localhost> /c0/u0 show Unit UnitType Status %RCmpl %V/I/M VPort Stripe Size(GB) -------------------------------------------------------------- RAID-5 1117.56 u0-0 DISK 372.519 u0-1 DISK 372.519 u0-2 DISK 372.519 u0-3 DISK 372.519 u0/v0 Volume u0/v1 Volume 1107.56 www.3ware.com...
  • Page 66: Cx Rescan [Noscan]

    Any newly found unit(s) or drive(s) will be listed. noscan is used to not inform the operating system of the unit discovery. The default is to inform the operating system. 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.1...
  • Page 67: Cx Commit

    Before issuing this command, you must have already obtained the firmware image and placed it on your system. You can obtain the firmware image from the 3ware website: http:www.3ware.com/downloads. Important: Before you update the firmware on your controller, please follow these recommendations: 1) Back up your data.
  • Page 68 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. The new image will take effect after reboot. 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.1...
  • Page 69: 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 66.) 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 70: Cx Add Verify=Ddd:hh:duration

    (this enables all rebuild schedule slots). (For details, see page 67.) 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 85.) 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.1...
  • Page 71: Cx Add Selftest=Ddd:hh

    /cx del selftest command to remove them. (For details, see page 65.) Use the /cx add selftest command to create the selftest schedule slots you want (described above.) Use the /cx set selftest=enable command to enable the schedule (this enables all selftest schedule slots). (For details, see page 69.) www.3ware.com...
  • Page 72: 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.1...
  • Page 73: Cx Set Dpmstat=On|Off

    To clear the data, use the command “/cx/px set dpmstat=clear [type=ra|lct|ext]” on page 106. 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 74: Cx Set Verify=Enable|Disable|1

    “/cx show verify” on page 52. You can add verify task slots to the schedule using the command “/cx add verify=ddd:hh:duration” on page 63. You can remove verify task slots from the schedule with the “/cx del verify=slot_id” on page 65. 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.1...
  • Page 75 When verify=advanced, if you start a manual verify, it will follow the advanced Verify Task Schedule. For more information, see “/cx/ux start verify” on page 83. Example: //localhost> /c3 set verify=basic pref=Fri:23 Setting /c3 basic verify preferred start time to [Fri, 11:00PM] ... Done. www.3ware.com...
  • Page 76: 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 77: Cx Set Spinup=Nn

    When auto-carve policy is set to off, all new units are created as a single large volume. If the operating system can only recognize up to 2 TBs, space over 2 TB will not be available. Example: //localhost> /c0 set autocarve=on Setting Auto-Carving Policy on /c0 to on ... Done. www.3ware.com...
  • Page 78: Cx Set Carvesize=[1024

    If the policy is off, spares are the only candidates for rebuild operations. Example: //localhost> /c0 set autorebuild=enable Setting Auto-Rebuild Policy on /c0 to enable ... Done. 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.1...
  • Page 79: /Cx Set Autodetect=On|Off Disk=|All

    Setting Auto-Detect on /c0 to [off] for port [3] and for disk [5,6]... Done If “disk=all,” then all of the drives or ports for that controller are specified. For the 9690SA controller, it would spinup all directly attached SAS and SATA drives, but not any drives attached to an expander. www.3ware.com...
  • Page 80: 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.) 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.1...
  • Page 81: Unit Object Commands

    /cx/ux set rapidrecovery=all|rebuild|disable [quiet](9000 series SE/SA only) /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=Stripe] [noscan] [nocache] [autoverify] (9000 series) RaidType = {raid0, raid1, raid5, raid6(9650SE and later only), raid10, raid50, single} /cx/ux remove [noscan] [quiet] www.3ware.com...
  • Page 82: 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 83 2683.80 u0-0 DISK 298.20 u0-1 DISK 298.20 u0-2 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 www.3ware.com...
  • Page 84: Cx/Ux Show Attribute [Attribute

    This command is related to the /cx/ux set identify command. It shows the identify status of the specified unit (either on or off). Example: //localhost> /c0/u0 show identify /c0/u0 Identify status = on 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.1...
  • Page 85: Cx/Ux Show Ignoreecc

    ''new'' parent unit. Thus, this command does not show the queue policy for the spare unit type. Note that currently only NCQ will be enabled, not tag-queueing. Note that queuing information is not available for SAS drives. Example: //localhost> /c0/u5 show qpolicy /c0/u5 Command Queuing Policy = on www.3ware.com...
  • Page 86: Cx/Ux Show Rapidrecovery

    /cx/ux show serial This feature only applies to 9000 series controllers. This command reports the unique serial number of the specified unit. Example: //localhost> /c0/u5 show serial /c0/u5 Serial Number = 12345678901234567890 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.1...
  • Page 87: Cx/Ux Show Status

    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 88: Cx/Ux Show All

    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 89: Cx/Ux Remove [Noscan] [Quiet]

    No confirmation is given and the command is executed immediately. This is useful for scripting purposes. Example of interactive mode: //localhost> /c0/u0 del Deleting /c0/u0 will cause the data on the unit to be permanently lost. Do you want to continue ? Y|N [N]: www.3ware.com...
  • Page 90: Cx/Ux Start Rebuild Disk=P

    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 9000 9650SE 9690SA a. Models 9500S, 9550SX, and 9590SE 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.1...
  • Page 91: Cx/Ux Pause Rebuild

    The /cx/ux pause rebuild command is provided to enable 7000/8000 users to achieve similar functionality with use of Linux-provided schedulers such as cron(8) or at(1), or user-supplied programs. www.3ware.com...
  • Page 92: Cx/Ux Resume Rebuild

    You can use the show verify command to display the existing schedule windows. For more information about using basic or advanced verify, see “/cx set verify=advanced|basic|1..5” on page 68. 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.1...
  • Page 93: Cx/Ux Set Cache=On|Off [Quiet]

    The following table shows the supported RAID types for caching as a function of controller model and logical unit type. N/A (Not Applicable) refers to cases where the given logical unit type is not supported on a particular controller model. www.3ware.com...
  • Page 94: Cx/Ux Set Identify=On|Off

    When you use ignoreECC, a file system check is recommended following the rebuild, to insure data integrity. By default, ignoreECC is off. See Table 8, “Supported Model-Unit Types for ignoreECC,” on page 57 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.1...
  • Page 95: Cx/Ux Set Name=String

    There is some system overhead from setting rapidrecovery to all. If you have a BBU, you can set rapid recovery to rebuild, as a BBU provides protection against data loss in the event of an unclean shutdown. www.3ware.com...
  • Page 96: Cx/Ux Set Storsave=Protect|Balance|Perform [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 97: Cx/Ux Migrate Type=Raidtype [Disk=P:-P]

    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 98 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. The following table illustrates valid migration paths: Table 13: Valid Migration Paths Destination Source Single Spare JBOD 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.1...
  • Page 99 Note that RAID-10 always has group=2, so an attribute specifying it’s group is not necessary. stripe=Stripe consists of the stripe size to be used. The following table illustrates the supported and applicable stripes on the respective unit types and controller models. Stripe size units are in KB (kilobytes). www.3ware.com...
  • Page 100 Once the migration is finished, a reboot will be required if you are booted from the unit. For secondary storage, depending on your operating system, you may need to first unmount the unit, 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.1...
  • Page 101 The following is an example of how migrating units will be displayed. In this example, the report indicates that /c0/u3 is a migrating unit with 39% completion. The report also indicate that Source Unit is of type RAID-1 and Destination Unit is of type RAID-10. www.3ware.com...
  • Page 102 For example, below is a system with two migrating units, /c0/u0 and /c0/u1. u0 is migrating from a RAID-10 to a RAID-0 array, while u1 is migrating from Single to a RAID-1, initiated by the following commands: /c0/u0 migrate type=raid0 /c0/u1 migrate type=raid1 disk=5 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.1...
  • Page 103 Unit Object Commands 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 %V/I/M Stripe Size(GB) Cache AVrfy --------------------------------------------------------------------------- Migrator MIGRATING 298.002 RAID-1 REBUILD-PAUSED 0 372.519...
  • Page 104: Port Object Commands

    Example for 9690SA controller: Note that in this case the summary information is in a slightly different format //localhost> /c3/p1 show VPort Status Unit Size Type Phy Encl-Slot Model -------------------------------------------------------------------------- 149.05 GB SATA WDC WD1600JS-22NCB1a 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.1...
  • Page 105: Cx/Px Show Attribute [Attribute

    SATA drives have only one port. indicates the number of connections from the controller Drive Connections to the drive. Can be either 1 or 2. Additional information is available using the /cx/px show all command. www.3ware.com...
  • Page 106: Cx/Px Show Firmware

    /c0/p5 SATA Link Speed = 3.0 Gb/s /cx/px show model This command displays the model of the drive attached to the specified port. Example: //localhost> /c0/p5 show model /c0/p5 Model = WDC WD1600BB-00DAA0 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.1...
  • Page 107: Cx/Px Show Ncq

    The SMART data is not decoded. If the drive attached to the specified port is not present or if there are cabling problems reaching the drive, CLI will return an error. This can be one way of detecting whether or not a drive is present. www.3ware.com...
  • Page 108: Cx/Px Show Status

    Chapter 2. CLI Syntax Reference /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> /c0/p5 show status...
  • Page 109: Cx/Px Show Dpmstat Type=Inst|Ra|Lct|Histdata|Ext

    Histogram Data, and ext for Extended Drive Statistics. inst (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. www.3ware.com...
  • Page 110 “/cx show dpmstat [type=inst|ra|ext]” on page 38. 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 111 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 ----------------------------------------------- 1000 2000 3000 4000 5000 6000 7000 8000 9000 10000 10000+ www.3ware.com...
  • Page 112: Cx/Px Remove [Noscan] [Quiet]

    This feature requires an enclosure with appropriate enclosure support. For additional information about enclosure-related commands, see “Enclosure Object and Element Commands” on page 113 Example: //localhost> /c0/p5 set identify=on Setting Port Identify on /c0/p5 to [on] ... Done. 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.1...
  • Page 113: Cx/Px Set Dpmstat=Clear [Type=Ra|Lct|Ext]

    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 114: Phy Object Commands

    SAS are: auto . Speed is in Gigabytes per second and the 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.1...
  • Page 115: 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 116: 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 112. /cx/bbu show pcb This command shows the PCB revision number on the BBU. 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.1...
  • Page 117: 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 118: Cx/Bbu Show Temp

    = OK /c1/bbu Estimated Backup Capacity = 241 Hours /c1/bbu Last Capacity Test = 22-Jun-2004 /c1/bbu Battery Installation Date = 20-Jun-2004 /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.1...
  • Page 119: Cx/Bbu Test [Quiet]

    Check for AENs with the alarms command /cx show alarms [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.
  • Page 120: Enclosure Object And Element Commands

    /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> /cx/ex/pwrsx show /cx/ex/pwrsx/ show identify /cx/ex/pwrsx set identify=on|off /cx/ex/tempx show /cx/ex/tempx/ show identify /cx/ex/tempx set identify=on|off 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.1...
  • Page 121: Cx/Ex Show

    NOT-INSTALLED PowerSupply Status State Voltage Current Identify --------------------------------------------------------------------------- pwrs0 pwrs1 Slot Status VPort Identify -------------------------------------------------- slot0 /c0/p0 slot1 NO-DEVICE slot2 /c0/p1 slot3 /c0/p2 slot4 /c0/p3 slot5 /c0/p4 slot6 /c0/p5 slot7 /c0/p6 slot8 /c0/p7 slot9 /c0/p8 slot10 /c0/p9 slot11 NO-DEVICE www.3ware.com...
  • Page 122: 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 123: Cx/Ex Show Fans

    The maximum temperature for successful use of a drive should be noted in the documentation for the drive. Example: //localhost> /c0/e0 show temp TempSensor Status Temperature Identify -------------------------------------------------------- temp0 41C(105F) temp1 37C(98F) temp2 34C(93F) temp3 38C(100F) temp4 38C(100F) temp5 34C(93F) temp6 NOT-INSTALLED temp7 NOT-INSTALLED www.3ware.com...
  • Page 124: Cx/Ex Show Pwrs

    (-) in the Port column. The final column shows whether “identify” is currently set for the specified slot. Example: //localhost> c0/e0/slot1 show Slot Status Port Identify ---------------------------------------------------- slot1 /c0/p1 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.1...
  • Page 125: Cx/Ex/Slotx Show Identify

    The fan name is followed by its status. If a fan is on and no fault has been detected, the status would indicate OK. Example: //localhost> /c0/e0/fan0 show ---Speed--- Status State Step Identify ------------------------------------------------------------ fan0 2700 www.3ware.com...
  • Page 126: Cx/Ex/Fanx Show Identify

    OK, OVER-CURRENT. In either case, OVER- means over the set threshold of the voltage or current. If a power supply is on and no fault has been detected, the status would indicate OK. 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.1...
  • Page 127: Cx/Ex/Pwrsx Show Identify

    /fanx 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 128: Cx/Ex/Tempx Show Identify

    You can also get help with specific commands, by entering help before an object name, or by typing a question mark (?) at the point in a command where you are uncertain what the attributes are. 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.1...
  • Page 129: Help With Specific Commands

    /cx add verify=ddd:hh:duration (9000 series) /cx add selftest=ddd:hh (9000 series) /cx del rebuild=slot_id (9000 series) /cx del verify=slot_id (9000 series) /cx del selftest=slot_id (9000 series) /cx set ondegrade=cacheoff|follow (9500S only) /cx set spinup=nn (9000 series) /cx set stagger=nn (9000 series) www.3ware.com...
  • Page 130: Help With Attributes

    /cx show all where all means attributes and configurations. /cx show diag /cx show alarms [reverse] /cx show rebuild (9000 only) /cx show verify (9000 only) /cx show selftest (9000 only) //localhost> 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.1...
  • Page 131: 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 Copyright(c) 2004-2006 Applied Micro Circuits Corporation (AMCC). All rights reserved. AMCC/3ware CLI (version 2.x) Commands Description -------------------------------------------------------------- show Displays information about controller(s), unit(s) and port(s).
  • Page 132: Help Rescan

    107. help /c This command provides specific unit /cx/ux related help, illustrating various commands to use on a unit /cx/ux. See the section “Unit Object Commands” on page 74 for more information. 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.1...
  • Page 133: Help /Cx/Px

    Object and Element Commands” on page 113 for more information. help /c /temp This command provides specific temperature sensor cx/ex/tempx related help, illustrating various ways to use the cx/ex/tempx command. See the section “Enclosure Object and Element Commands” on page 113 for more information. www.3ware.com...
  • Page 134: Help /Cx/Ex/Pwrsx

    For all previous versions of Windows (XP, Server 2003, etc), the log file is stored in \Documents and Settings\All Users\Application Data\AMCC In Linux, and FreeBSD, the log file is in the directory /var/log directory. 3ware SAS/SATA RAID Controller CLI Guide, Version 9.5.1...
  • Page 135: 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