3Ware 720-0127-02 Manual

3Ware 720-0127-02 Manual

9000 series serial ata raid controller
Table of Contents

Advertisement

Quick Links

3ware
®
Serial ATA RAID Controller

Command Line Interface

Supports the 9000 Series
(9500S and 9550SX)
PN: 720-0127-02
November 2005

Advertisement

Table of Contents
loading
Need help?

Need help?

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

Questions and answers

Subscribe to Our Youtube Channel

Summary of Contents for 3Ware 720-0127-02

  • Page 1: Command Line Interface

    3ware ® Serial ATA RAID Controller Command Line Interface Supports the 9000 Series (9500S and 9550SX) PN: 720-0127-02 November 2005...
  • Page 2 AMCC, 215 Moffett Park Drive, Sunnyvale, CA 94089. Trademarks 3ware, Escalade, and 3DM are all registered trademarks of AMCC. The 3ware logo, 3BM, StorSwitch, TwinStor, and R5 Fusion are all trademarks of AMCC. All other trademarks herein are property of their respective owners. Disclaimer...
  • Page 3: Table Of Contents

    Installing the 3ware CLI on Windows ....... . . 5...
  • Page 4 /cx/ux show storsave ..........56 3ware 9000 Series Serial ATA Controller CLI Guide...
  • Page 5 ........... . . 78 www.3ware.com...
  • Page 6 [maint] rebuild cid uid pid_list [ignoreECC] ......101 3ware 9000 Series Serial ATA Controller CLI Guide...
  • Page 7 Return Code ........... . 114 www.3ware.com...
  • Page 8 3ware 9000 Series Serial ATA Controller CLI Guide...
  • Page 9: About This Guide

    About This Guide 3ware 9000 Series Serial ATA Controller CLI Guide provides instructions for configuring and maintaining your 3ware controller using 3ware’s command line interface (CLI). This guide assumes that you have already installed your controller in your system. If you have not yet done so, see the user guide that came with your 3ware RAID controller for instructions.
  • Page 10 3ware 9000 Series Serial ATA Controller CLI Guide...
  • Page 11: Chapter 1. Introduction To The 3Ware Command Line Interface

    3ware 9000 series products will not work with 3ware 7000 or 8000 series controllers. Warning! 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...
  • Page 12: Supported Operating Systems

    32-bit and 64-bit. Linux. Redhat, SuSE, both 32-bit and 64-bit. FreeBSD, both 32-bit and 64-bit. For specific versions of Linux and FreeBSD that are supported for the 3ware CLI, see the Release Notes. Terminology This document uses the following terminology: Usually shortened to “units.”...
  • Page 13: Installing The 3Ware Cli

    To install 3ware CLI on Windows, copy the file to the directory tw_cli.exe from which you want to run the program. CLI is located on the 3ware CD in the directory \packages\cli\windows Note: CLI comes in both 32-bit and 64-bit versions. Be sure to copy the correct version for the version of the operating system you are using.
  • Page 14: Installing The 3Ware Cli On Linux And Freebsd

    Chapter 1. Introduction to the 3ware Command Line Interface Installing the 3ware CLI on Linux and FreeBSD 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 15: Working With 3Ware Cli

    Legacy command syntax. In the current CLI version, the command syntax used in previous versions of the 3ware CLI is still supported, to make sure that scripts written with the old syntax will still operate. New functions (such as BBU-related commands, StorSave and queuing policies, and other recent additions) are not available in the legacy syntax.
  • 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_array.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 AMCC Technical Support.
  • Page 18: Understanding Raid Concepts And Levels

    When you work with 3ware software, “unit” is the term used to refer to an array of disks that is configured and managed through the 3ware software.
  • Page 19: Available Raid Configurations

    Provides striping, but no mirroring. Striped disk arrays achieve high transfer rates because they can read and write data on more than one drive simultaneously. The stripe size is configurable in the 3ware CLI, 3ware BIOS Manager (3BM) and in the 3ware Disk Manager (3DM 2). Requires a minimum of two drives.
  • Page 20 Fault tolerance is a basic requirement for mission 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 Single Disk A single drive that has been configured as a unit through 3ware software (3BM, 3DM2, 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 22: Determining What Raid Level To Use

    JBOD A JBOD is an unconfigured disk attached to your 3ware RAID controller. 3ware recommends that you use Single Disk as a replacement for JBOD, to take advantage of advanced features such as RAID level migration (RLM). JBOD units are not fault tolerant and therefore not recommended for high availability systems unless additional precautions are taken to prevent system hangs and data loss.
  • Page 23 GB for drives under 45 GB (45,000,000,000), and rounded down to the nearest 5 GBytes for drives over 45 GB. For example, a 44.3 GB drive will be rounded down to 44 GBytes, and a 123 GB drives will be rounded. down to 120 GBytes. www.3ware.com...
  • Page 24: Storsave Profiles

    Chapter 1. Introduction to the 3ware Command Line Interface Support for Over 2 Terabytes Windows 2000, Windows XP, and Linux 2.4 do not currently recognize unit capacity in excess of 2 TB. If the combined capacity of the drives to be connected to a unit exceeds 2...
  • Page 25 If write journaling is disabled and a BBU is present, then it is as if the BBU was disabled for that unit. Write cache disabled on degrade . In the event that a unit degrades, the use of write cache can be disabled until the unit is rebuilt. Once the unit is www.3ware.com...
  • Page 26 Chapter 1. Introduction to the 3ware Command Line Interface rebuilt, you must enable the write cache manually using 3DM2, 3BM, or the CLI. The write cache will not automatically reenable when the unit is rebuilt. The Protection profile enables this feature, so that write cache is disabled;...
  • Page 27: Chapter 2. Primary Cli Syntax Reference

    3ware 7000 or 8000 series controllers. This chapter provides detailed information about using the primary command syntax for the 3ware CLI. (The legacy syntax is still supported for a limited time. For details see, “Legacy CLI Syntax Reference” on page 83.) Throughout this chapter the examples reflect the interactive method of executing 3ware CLI.
  • Page 28 /cx set rebuild schedule and set the task rate Enable/disable the verify schedule /cx set verify and set the task rate Enable/disable the selftest /cx set selftest schedule View Alarms /cx show alarms 3ware 9000 Series Serial ATA Controller CLI Guide...
  • Page 29: Primary Syntax Overview

    /c1 add type=raid1 disk=0-1 is the object, is the command, (for type of array) is an attribute type with as the value of the attribute, and is another attribute with raid1 disk as the value (ports 0 through 1). www.3ware.com...
  • Page 30 Battery Backup Unit on a specific controller. For details, see “BBU Object Commands” on page 72. Help commands allow you to display help information for Help Commands. all commands and attributes. For details, see “Help Commands” on page 76. 3ware 9000 Series Serial ATA Controller CLI Guide...
  • Page 31: Shell Object Commands

    //hostname hostname specifies one level up (the parent object). specifies the root at the current focused hostname. ./object specifies the next level of the object. specifies a relative path with respect to the current focused /c0/bbu hostname. www.3ware.com...
  • Page 32: Show

    BBU of '-' (Not Applicable). Not Optimal refers to any state except OK and VERIFYING. Other states include VERIFY-PAUSED, INITIALIZING, INIT- PAUSED, REBUILDING, REBUILD-PAUSED, DEGRADED, MIGRATING, MIGRATE-PAUSED, RECOVERY, INOPERABLE, and UNKNOWN. RRate also applies to initializing, migrating, and recovery background tasks. 3ware 9000 Series Serial ATA Controller CLI Guide...
  • Page 33: Show Ver

    12:00am 24 hr(s) disabled 12:00am 24 hr(s) disabled For additional information about rebuild schedules, see “/cx add rebuild=ddd:hh:duration” on page 45, and see the discussion of background tasks and schedules in 3ware 9550SX Serial ATA RAID Controller User Guide. www.3ware.com...
  • Page 34: Show Verify

    For additional information about verify schedules, see “/cx add verify=ddd:hh:duration” on page 46, and see the discussion of background tasks and schedules in 3ware 9550SX Serial ATA RAID Controller User Guide. show selftest This command displays all selftest schedules for the 9000 controllers in the system.
  • Page 35: 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 40. rescan This command sends a rescan command to all 3ware controllers in the system.
  • Page 36: Controller Object Commands

    (9000 only) /cx flush /cx commit (Windows only. Also known as shutdown) /cx start mediascan (7000/8000 only) /cx stop mediascan (7000/8000 only) /cx rescan [noscan] (Does not import non-JBOD on 7000/8000 models. 3ware 9000 Series Serial ATA Controller CLI Guide...
  • Page 37: Cx Show

    Port Status Unit Size Blocks Serial --------------------------------------------------------------- 149.05 GB 312581808 3JS0TF14 149.05 GB 312581808 3JS0TETZ 149.05 GB 312581808 3JS0VG85 149.05 GB 312581808 3JS0VGCY 149.05 GB 312581808 3JS0VGGQ 149.05 GB 312581808 3JS0VH1P 149.05 GB 312581808 3JS0TF0P 149.05 GB 312581808 3JS0VF43 www.3ware.com...
  • Page 38: Cx Show Attribute [Attribute

    Example: //localhost> /c0 show model /c0 Model = 9500-x /cx show firmware This command reports the firmware version of controller /cx. Example: //localhost> /c0 show firmware /c0 Firmware Version = FGXX 2.x 3ware 9000 Series Serial ATA Controller CLI Guide...
  • Page 39: Cx Show Bios

    /cx. Example: //localhost> /c0 show pchip /c0 PCHIP Version = 1.x /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 www.3ware.com...
  • Page 40: Cx Show Numports

    This command reports the number of concurrent disks that will spin up when the system is powered on, after waiting for the number of seconds specified with the command. set stagger Example: 3ware 9000 Series Serial ATA Controller CLI Guide...
  • Page 41: Cx Show Stagger

    2 TB. When the autocarve policy is off, all newly created units will consist of one single volume. Example //localhost> /c0 show autocarve /c0 Auto-Carving Policy = on www.3ware.com...
  • Page 42: Cx Show Carvesize

    2. Smallest usable unconfigured (available) drive. 3. Smallest usable failed drive. 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 3ware 9000 Series Serial ATA Controller CLI Guide...
  • Page 43: Cx Show Unitstatus

    //localhost> /c0 show drivestatus Port Status Unit Size Blocks Serial -------------------------------------------------------------- 149.05 GB 312581808 3JS0TF14 149.05 GB 312581808 3JS0TETZ 149.05 GB 312581808 3JS0VG85 149.05 GB 312581808 3JS0VGCY 149.05 GB 312581808 3JS0VGGQ 149.05 GB 312581808 3JS0VH1P 149.05 GB 312581808 3JS0TF0P www.3ware.com...
  • Page 44: Cx Show All

    74.53 GB 156301488 3JV3MVTA 74.53 GB 156301488 5JV980Z0 74.53 GB 156301488 5JV9820G 111.79 GB 234441648 WD-WMAEL10275 111.79 GB 234441648 WD-WMAEL10274 111.79 GB 234441648 WD-WMAEL10281 111.79 GB 234441648 WD-WMAEL10273 111.79 GB 234441648 WD-WMAEL10274 3ware 9000 Series Serial ATA Controller CLI Guide...
  • Page 45: [Storsave=]

    Stripe size units are in K (kilobytes). If no stripe size is specified, 64K is used by default, if applicable. If you need to change the stripe size after the unit is created, you can do so my migrating the unit. www.3ware.com...
  • Page 46 (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 9000 Series Serial ATA Controller CLI Guide...
  • Page 47: Cx Rescan [Noscan]

    Note: If you are adding new drives, add them physically before issuing the rescan commands. Hot swap carriers are required unless you first power- down the system to prevent system hangs and electrical damage. www.3ware.com...
  • Page 48: Cx Commit

    '-' in the Date column. This means that it is not applicable. In addition, alarm messages on 7000/8000 controllers contain the severity in the message text, so the Severity column also shows a '-'. 3ware 9000 Series Serial ATA Controller CLI Guide...
  • Page 49: Cx Show Diag

    Scheduled rebuilds will take place during the scheduled time slot, if enabled the schedules are enabled. For in depth information about rebuild and other background tasks, see “About Background Tasks” in the 3ware 9550SX Serial ATA RAID Controller User Guide. www.3ware.com...
  • Page 50 Y2NXL7FE NOT-PRESENT 76.33 GB 160086528 Y2NXLB9E NOT-PRESENT 76.33 GB 160086528 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 3ware 9000 Series Serial ATA Controller CLI Guide...
  • Page 51: Cx Show Verify

    Verify is one of the supported background tasks. Rebuild and selftest are other background tasks for which there are separate schedules. Migrate and initialize are additional background tasks that follow the same schedule as www.3ware.com...
  • Page 52: Cx Show Selftest

    For each background task, up to 7 time periods can be registered, known as slots 1 through 7. Each task schedule can be managed by a set of 3ware 9000 Series Serial ATA Controller CLI Guide...
  • Page 53: Cx Add Rebuild=Ddd:hh:duration

    This command will fail if no (empty) task slot is available. For example: //localhost> /c1 add rebuild=Sun:16:3 adds a rebuild background task schedule to be executed on Sundays at 16 hours (4:00 PM) for a duration of 3 hours. www.3ware.com...
  • Page 54: Cx Add Verify=Ddd:hh:duration

    (For details, see page 43.) If any of the scheduled tasks do not match your desired schedule, use the /cx del verify command to remove them. (For details, see page 48.) 3ware 9000 Series Serial ATA Controller CLI Guide...
  • Page 55: Cx Add Selftest=Ddd:hh

    /cx del selftest command to remove them. (For details, see page 48.) 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 49.) www.3ware.com...
  • Page 56: Cx Del Rebuild=Slot_Id

    The priority of rebuild versus I/O operations is specified with 1..5, where 1 is more resources and 5 the least. Setting the value to 1 gives maximum 3ware 9000 Series Serial ATA Controller CLI Guide...
  • Page 57: Cx Set Verify=Enable|Disable|1

    If the JBOD export policy is off, CLI will not be able to create JBODs. During reboot, firmware will not export JBOD units to the operating system. The JBOD Export Policy is only supported on 9000-series controllers. Previous models did not have such a policy enforcement feature. www.3ware.com...
  • Page 58: /Cx Set Ondegrade=Cacheoff|Follow

    Chapter 2. Primary CLI Syntax Reference A JBOD is an unconfigured disk attached to your 3ware RAID controller. AMCC recommends that you use Single Disk as a replacement for JBOD, to take advantage of features such as RAID level migration.
  • Page 59: Cx Set Carvesize=[1024

    (causing the controller to see it as a failed drive) and then reconnect it, the controller will automatically try to use it again. If the policy is off, spares are the only candidates for rebuild operations. www.3ware.com...
  • Page 60: Cx Start Mediascan

    /cx. /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 9000 Series Serial ATA Controller CLI Guide...
  • Page 61: Unit Object Commands

    One application of this command is to see which sub-unit of a degraded unit has caused the unit to degrade and which disk within that sub-unit is the source of degradation. Another application is to see the source and destination units during a migration. www.3ware.com...
  • Page 62: Cx/Ux Show Attribute [Attribute

    /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 3ware 9000 Series Serial ATA Controller CLI Guide...
  • Page 63: Cx/Ux Show Verifystatus

    If some drives in the unit do not support a queueing policy, this policy will have no effect on those drives. Note that currently only NCQ will be enabled, not tag-queueing. Example: //localhost> /c0/u5 show qpolicy /c0/u5 Command Queuing Policy = on www.3ware.com...
  • Page 64: Cx/Ux Show Storsave

    DISK 298.20 624962560 u1-5 DISK 298.20 624962560 u1-6 DISK 298.20 624962560 u1-7 DISK 298.20 624962560 u1-8 DISK 298.20 624962560 u1-9 DISK 298.20 624962560 u1-10 DISK 298.20 624962560 u1-11 DISK 298.20 624962560 3ware 9000 Series Serial ATA Controller CLI Guide...
  • Page 65: Cx/Ux Export [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 Are you sure you want to delete the unit /c0/u0? Enter Y to continue. www.3ware.com...
  • Page 66: Cx/Ux Start Rebuild Disk=P

    When you issue this command, the specified verify will begin if schedules are disabled; otherwise it will pause until the next scheduled verify. Verify will also pause if a rebuild or initialization is currently in progress. 3ware 9000 Series Serial ATA Controller CLI Guide...
  • Page 67: Cx/Ux Pause Rebuild

    If no schedule is set up and auto-verify is enabled, then the controller can run the verify function any time it is deemed necessary. This can include pausing the process and restarting it www.3ware.com...
  • Page 68: Cx/Ux Set Cache=On|Off [Quiet]

    When ignoreECC is set to on, such errors are ignored, and the rebuild will continue. When you use ignoreECC, a file system check is recommended following the rebuild, to insure data integrity. By default, ignoreECC is off. 3ware 9000 Series Serial ATA Controller CLI Guide...
  • Page 69: Cx/Ux Set Name=String

    BBU is installed and enabled, in which case, they will be ignored. perform provides the maximum performance and least data protection of the three controller settings. When storsave is set to perform mode, it means: When the unit becomes degraded, the write cache will not be disabled. www.3ware.com...
  • Page 70: Cx/Ux Migrate Type=Raidtype [Disk=P:-P] [Group=3|4|5|6] [Stripe=Stripe] [Noscan] [Nocache][Autoverify]

    Incoming FUA (Force Unit Access) host requests will be honored unless a BBU is installed and enabled, in which case, they will be ignored. For additional information, see “Setting the StorSave Profile for a Unit” in the 3ware 9550SX Serial ATA RAID Controller User Guide. Example: //localhost> /c0/u5 set storsave=protect Setting Command Storsave Policy for unit /c0/u5 to [protect] ...
  • Page 71 Multiple ports can be specified using a colon (:) or a dash (-) as port index separators. A dash indicates a range and can be mixed with colons. For example disk=0:1:2-5:9:12 indicates port 0, 1, 2 through 5 (inclusive), 9 and 12. www.3ware.com...
  • Page 72 CLI not to notify the operating system of the creation of the new unit. By default CLI will inform the operating system. One application of this feature is to prevent the operating system from 3ware 9000 Series Serial ATA Controller CLI Guide...
  • Page 73 Example of capacity expansion //localhost> /c0/u0 migrate type=raid10 disk=3-4 stripe=16 Indicates that the destination unit has a RAID type of raid10 and has the disk 3 and 4 in addition to all the disks in the existing unit u0. www.3ware.com...
  • Page 74 156227584 su0-0 DISK 74.4951 156227584 su0-1 DISK 74.4951 156227584 RAID-10 148.99 312455168 du0-0 RAID-1 du0-0-0 DISK 74.4951 156227584 du0-0-1 DISK 74.4951 156227584 du0-1 RAID-1 du0-1-0 DISK 74.4951 156227584 du0-1-1 DISK 74.4951 156227584 3ware 9000 Series Serial ATA Controller CLI Guide...
  • Page 75: Port Object Commands

    Possible attributes are: capacity, firmware, model, serial, smart, and status. /cx/px show status This command displays the status of the drive attached to the specified port. Example: //localhost> /c0/p5 show status /c0/p5 Status = OK www.3ware.com...
  • Page 76: Cx/Px Show Model

    This command displays the NCQ (Native Command Queueing) information for the drive attached to the specified port, including whether NCQ is supported by the drive, and whether it is enabled at the drive. 3ware 9000 Series Serial ATA Controller CLI Guide...
  • Page 77: Cx/Px Show Lspeed

    00 9A 96 BC 14 00 00 00 00 00 04 32 00 64 64 7A 00 00 00 00 00 00 05 33 00 C8 C8 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 2C www.3ware.com...
  • Page 78: Cx/Px Show All

    Block) metadata on the attached disk. You can import (or re-introduce) the port by rescanning the controller. noscan is used to not inform the operating system of this change. The default is to inform the operating system. quiet is for non-interactive mode. 3ware 9000 Series Serial ATA Controller CLI Guide...
  • Page 79: /Cx/Px Set Identify=On|Off

    Chassis Control Unit (CCU). The CCU will also support the monitoring of fan speed, temperature sensors, door lock, and so forth, depending on the level of chassis vendor support. Check the 3ware support web site for future updates on a list of chassis vendors that support the CCU, as they become available.
  • Page 80: 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). If the BBU is either not present or disabled, the following will be Note: displayed after the //localhost>...
  • Page 81: Cx/Bbu Show Attribute [Attribute

    OK. 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 /cx/bbu show batinst This command shows the date when the current battery was installed. www.3ware.com...
  • Page 82: Cx/Bbu Show Lasttest

    “/cx/bbu test [quiet]” on page 75. /cx/bbu show serial This command shows the BBU serial number. /cx/bbu show fw This command shows the BBU firmware version number. 3ware 9000 Series Serial ATA Controller CLI Guide...
  • Page 83: Cx/Bbu Show Pcb

    Check for AENs with the alarms command /cx show alarms [reverse] Using the “reverse” attribute displays the most recent AEN message at the bottom of the list. (For a list of all AENs, see the user guide that came with your 3ware RAID controller.) www.3ware.com...
  • Page 84: Cx/Bbu Enable

    /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) 3ware 9000 Series Serial ATA Controller CLI Guide...
  • Page 85: Help With Attributes

    /cx show attribute [attribute ...] where attribute is: driver|model|firmware|bios|monitor|serial|pcb|pchip|achip numports|numunits|numdrives|unitstatus|drivestatus|allunitstatus exportjbod|ondegrade|spinup|stagger|autocarve /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> www.3ware.com...
  • Page 86: Help

    This command provides specific show-related help, illustrating various ways to use the show command. It provides reports on Controllers, Units and Drives. See the section “Shell Object Commands” on page 23 for more information. 3ware 9000 Series Serial ATA Controller CLI Guide...
  • Page 87: Help Flush

    /cx/px command. See the section “Port Object Commands” on page 67 for more information. help /cx/bbu This command provides specific /cx/bbu related help, illustrating various ways to use the /cx/bbu command. See the section “BBU Object Commands” on page 72 for more information. www.3ware.com...
  • Page 88: Environment Variables

    $? 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...
  • Page 89 To view the return code for Windows, in a command window type tw_cli /c0 show (c0 info displayed here) if errorlevel 0 echo 0 tw_cli /c7 show error..if errorlevel 1 echo 1 This example fails (returns 1) because there is no controller 7. www.3ware.com...
  • Page 90 Chapter 2. Primary CLI Syntax Reference 3ware 9000 Series Serial ATA Controller CLI Guide...
  • Page 91: Chapter 3. Legacy Cli Syntax Reference

    Reference This chapter provides detailed information about using the legacy syntax for the 3ware CLI, using the commands Info, Maint, Sched, Alarms, Set, and Help. Support for the legacy syntax is available only for a limited time. Information contained in this document that describes usage...
  • Page 92: Conventions

    To preserve the alarms through reboot, you can either extract the alarms from CLI and store them in a file, or install 3DM 2, which does log alarm messages. For more information, see the 3ware 9000 Series Serial ATA RAID Controller User Guide.
  • Page 93: Screen Reporting Style

    Screen Reporting Style In the previous version of the CLI, 3ware has changed the default reporting style to a tabular reporting style for screen displays. Using this format, information is easier to read and analyze. The new style also accommodates automation, by providing consistent columns with or without values so that it can be easily parsed.
  • Page 94: Info

    Cache is on or off. It also shows whether AutoVerify and OvrECC are on or off (9000 only). OvrECC is short for Overwrite ECC, or Force Continue on source error. The function is explained in “Set Commands” on page 111. 3ware 9000 Series Serial ATA Controller CLI Guide...
  • Page 95: Info Cid Driver

    NOT-PRESENT - NOT-PRESENT - 3ware CLI calculates one megabyte as 1024 x 1024, the same calculation that Windows and Linux use. 3DM 2 uses 1024 x 1024, so when using 3DM 2, the capacity listed will match the capacity stated by the CLI. Previous versions of 3DM (v1.x) calculate one megabyte as 1000 x 1000, which is the calculation...
  • Page 96: Info Cid Firmware

    //localhost> info c0 bios /c0 BIOS Version = BG9X 2.01.00.026 info monitor This command reports the monitor (firmware boot-loader) version of controller cid. Example: //localhost> info c0 monitor /c0 Monitor Version = BLDR 1.00.00.008 3ware 9000 Series Serial ATA Controller CLI Guide...
  • Page 97: Info Cid Serial

    This command reports the number of units currently managed by the specified controller cid. This report does not include units that have been removed (placed off-line) with the maint remove command. Example: //localhost> info c0 numunits /c0 Number of Units = 1 www.3ware.com...
  • Page 98: Info Cid Numdrives

    This command presents a count of Total and NotOptimal units managed by the specified controller cid. See “Info Commands” on page 85 for more information on NotOptimal. Example: //localhost> info c0 allunitstatus Total Units = 2 NotOptimal Units = 0 3ware 9000 Series Serial ATA Controller CLI Guide...
  • Page 99: Info Cid Drivestatus

    /c0 Cache on Degrade Policy = Follow Unit Policy info spinup This command shows whether staggered spinup is enabled. Example: //localhost> info c0 spinup /c0 Disk Spinup Policy = 1 Note that “1” indicates enabled. When disabled, “255” is shown. www.3ware.com...
  • Page 100: Info Cid Stagger

    DISK 74.4951 156227584 u0-10 DISK 74.4951 156227584 u0-11 DISK 74.4951 156227584 cid uid info status This command presents the status of the specified unit. Example: //localhost> info c0 u5 status /c0/u5 status=DEGRADED 3ware 9000 Series Serial ATA Controller CLI Guide...
  • Page 101: Info Cid Uid Rebuildstatus

    Typical information looks like: Example: //localhost> info p5 Port Status Unit Size Blocks Serial -------------------------------------------------------------- u2 149.05 312581808 3JS0VH1P This report indicates that port 5 of controller 0 is attached to disk serial number 3JS0VH1P, with status OK participating in unit 5. www.3ware.com...
  • Page 102: Info Cid Pid Status

    00 00 00 00 00 00 05 33 00 C8 C8 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 2C 3ware 9000 Series Serial ATA Controller CLI Guide...
  • Page 103: Info Cid Diag

    SETTINGS: Saving USER parameters ... done. (count=1, bytes=9) SETTINGS: Saving USER parameters ... done. (count=1, bytes=9) SETTINGS: Saving USER parameters ... done. (count=1, bytes=9) Send AEN (code, time): 0x31, 0x7a2d6b Synchronize host/controller time (EC:0x31, SK=0x00, ASC=0x00, ASCQ=0x00, SEV=04, Type=0x71) www.3ware.com...
  • Page 104: Maint Commands

    If no controller is specified, all controllers are rescanned. One or several controllers can be specified. By default, the OS is informed of changes resulting from rescan. You can alter this behavior using the noscan option. 3ware 9000 Series Serial ATA Controller CLI Guide...
  • Page 105: [Maint] Remove Cid Uid [Noscan]

    Physically removing any drive requires use of an approved hot swap carrier. If you do not have such a carrier you must first power down your system. Failure to do so may cause the system to hang or become corrupted. It may even damage your system. www.3ware.com...
  • Page 106: [Maint] Remove Cid Pid [Noscan]

    You can alter this behavior using the noscan option. Warning! Back up data Back up any critical data prior to deleting a unit. Failure to do so will result in lost data. 3ware 9000 Series Serial ATA Controller CLI Guide...
  • Page 107: [Nocache] [Autoverify] [Ignoreecc]

    The following table illustrates the supported and applicability of stripes on unit types and controller models. Stripe size units are in K (kilobytes). Table 15: Supported Stripe Sizes Model JBOD Spare Single 7K/8K 1024 1024 www.3ware.com...
  • Page 108 The following table illustrates the supported Model- UnitType. This table only applies to setting this feature at Unit Creation time. Generally ignoreECC applies to redundant units. Table 16: Supported Model-Unit Types Model R-10 R-50 Single JBOD Spare 7K/8K 3ware 9000 Series Serial ATA Controller CLI Guide...
  • Page 109: [Maint] Rebuild Cid Uid Pid_List [Ignoreecc]

    Rebuild pause and resume function is provided to enable 7000/8000 users to achieve similar functionality with the use of OS- provided schedulers. See also “Sched Commands” on page 104. www.3ware.com...
  • Page 110: [Maint] Rebuild Cid Uid Resume

    I/Os on disks and clear the in-transaction bit. Typical application of this feature is when an application is using a given unit in raw mode (such as databases) and the user would like to shut down the host 3ware 9000 Series Serial ATA Controller CLI Guide...
  • Page 111 DCBs in-transaction flag as the disk is going down. Note that block devices (cooked devices) do not require this command. Clients of block devices (such as File system) send such requests via ASPI SRB_SHUTDOWN_REQUEST. www.3ware.com...
  • Page 112: Sched Commands

    <n> sched verify c<c> enable|disable sched selftest c<c> sched selftest c<c> add d<d> h<h> sched selftest c<c> remove <n> sched selftest c<c> enable|disable s<s> 3ware 9000 Series Serial ATA Controller CLI Guide...
  • Page 113: Sched Rebuild Cid

    Warning: If all time slots are removed, be sure to also disable the schedule. Otherwise the applicable background task will never occur. For example: //localhost> tw_cli sched rebuild c1 remove 2 Removes the rebuild background task in slot 2. www.3ware.com...
  • Page 114: Sched Rebuild Cid Enable

    Adds a verify background task to be executed on Sundays at 4:00 PM for a duration of 3 hours. Note: The new schedule is added to the first available slot. Events do not need to be added in sequential order. 3ware 9000 Series Serial ATA Controller CLI Guide...
  • Page 115: Sched Verify Cid Remove Slot_Id

    This command displays the current selftest background task as illustrated below. //localhost> tw_cli sched selftest c1 Selftest Schedule for controller /c1 ======================================================== Slot Hour UDMA SMART -------------------------------------------------------- 12:00am enabled enabled 12:00am enabled enabled 12:00am enabled enabled 12:00am enabled enabled 12:00am enabled enabled 12:00am enabled enabled 12:00am enabled enabled www.3ware.com...
  • Page 116: Sched Selftest Cid Add Dday Hhour

    When enabling the verify schedule you must also remember to also Note: enable the autoverify setting for the arrays to be verified. For example: //localhost> tw_cli sched selftest c1 enable s0 Enables UDMA selftest on controller c0. 3ware 9000 Series Serial ATA Controller CLI Guide...
  • Page 117: Sched Selftest Cid Disable Selftest_Task_Id

    Alarms generated on 7000/8000 models do not have dates, so a dash (-) meaning not-applicable appears in the Date column. Also on 7000/8000 models, the alarm message does not contain the severity, hence the Severity column displays a dash (-) as well. www.3ware.com...
  • Page 118: Syntax

    Invoked without cid, displays alarms associated with all detected controllers. A listing of AEN codes can be found in the “Troubleshooting: Note: Problems and Solutions” section of 3ware 9000 Series Serial ATA RAID Controller User Guide. Typical output looks like: tw_cli> alarms...
  • Page 119: Set Commands

    1..5 This command allows you to set the priority of verification in relation to I/O operations. Setting this value to 1 implies fastest verify, and 5 implies fastest I/O. Note that This feature only applies to 9000 series controllers. www.3ware.com...
  • Page 120: Set Cache Cid Uid On|Off

    If this setting is already enabled you do not need to specify it again when rebuilding an array. This setting only applies to 9000 models. 3ware 9000 Series Serial ATA Controller CLI Guide...
  • Page 121: Help Commands

    Type help <command> to get more details about a particular command. help info This command provides specific info related help, illustrating various ways to use the info command. Info provides reports on 3ware controllers, units and drives. help alarms This command provides specific alarms related help, illustrating various ways to use the alarms command.
  • Page 122: Help Quit

    $? 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 info c0...

This manual is also suitable for:

9500s9550sx

Table of Contents