® 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.
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.
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.
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).
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.
/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.
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: •...
./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...
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.
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).
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.
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.
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.
(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...
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.
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...
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.
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...
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...
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.
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:...
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.
/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...
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...
[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...
(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...
/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...
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...
(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>...
/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...
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...
/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...
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.
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...
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.
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).
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...
(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...
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...
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...
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...
(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...
/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...
//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...
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]...
“/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...
(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.
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...
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...
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...
/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...
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...
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...
''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...
/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...
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.
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.
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...
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...
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...
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...
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...
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...
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...
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.
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...
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...
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...
/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...
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...
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...
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...
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...
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...
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...
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>...
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...
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...
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.
/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...
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.
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...
(-) 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...
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...
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...
/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>...
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...
/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...
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).
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...
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...
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...
$? 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...
Need help?
Do you have a question about the 720-0186-00 and is the answer not in the manual?
Questions and answers