Académique Documents
Professionnel Documents
Culture Documents
Reference Manual
December 2012
53419-00, Rev. E
Revision History
Version and Date
Rev. E, December 2012
Description of Changes
NOTE This Revision History lists only the changes made to the current version of the document. For a complete list of all revisions made to the
previous versions of this document since its original publication, see Appendix D: Revision Information.
LSI, the LSI & Design logo, CacheCade, and MegaRAID are registered trademarks of LSI Corporation or its subsidiaries. All other brand and product names may be trademarks of their respective companies.
LSI Corporation reserves the right to make changes to the product(s) or information disclosed herein at any time without notice. LSI Corporation does not assume any responsibility or liability arising out of
the application or use of any product or service described herein, except as expressly agreed to in writing by LSI Corporation; nor does the purchase, lease, or use of a product or service from LSI Corporation
convey a license under any patent rights, copyrights, trademark rights, or any other of the intellectual property rights of LSI Corporation or of third parties. LSI products are not intended for use in life-support
appliances, devices, or systems. Use of any LSI product in such applications without written consent of the appropriate LSI officer is prohibited.
This document contains proprietary information of LSI Corporation. The information contained herein is not to be used by or disclosed to third parties without the express written permission of LSI Corporation.
Corporate Headquarters
Milpitas, CA
800-372-2447
Document Number: 53419-00, Rev. E
Copyright 2012 LSI Corporation
All Rights Reserved
Email
globalsupport@lsi.com
Website
www.lsi.com
Table of Contents
Table of Contents
Chapter 1: Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
1.1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
1.2 Support for MegaCLI Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
1.3 Devices Supported by the StorCLI Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Chapter 2: Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
2.1 Installing StorCLI on Microsoft Windows Operating Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.2 Installing StorCLI on Linux Operating Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.3 Installing StorCLI on VMware Operating Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.4 Installing StorCLI on FreeBSD Operating Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.5 Installing StorCLI on the Microsoft EFI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.6 Installing StorCLI on Solaris Operating Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
6
6
7
7
7
7
LSI Corporation
-3-
10
10
11
11
15
16
19
20
21
22
22
23
23
24
25
25
25
26
26
27
28
29
29
30
30
32
33
33
34
35
36
37
38
Table of Contents
39
39
40
41
41
41
42
42
43
45
46
46
48
48
48
48
48
49
49
50
50
LSI Corporation
-4-
Chapter 1: Introduction
Overview
Chapter 1: Introduction
1.1
Overview
The Storage Command Line Tool (StorCLI) is the command line management software designed for the MegaRAID
product line. The StorCLI is a command line interface that is designed to be easy to use, consistent, and easy to script.
This document is the reference manual for installing and using the Storage Command Line Tool, and it explains the
various features of the Storage Command Line Tool.
NOTE The legacy commands are deprecated from this guide.
1.2
1.3
Chapter 2: Installation
Installing StorCLI on Microsoft Windows Operating Systems
Chapter 2: Installation
The MegaRAID controllers can be used with the following operating systems for Intel and AMD 32-bit and 64-bit
x86-based motherboards:
2.1
Copy the binary file from the CD or from the LSI website.
2.
Place the binary file in the directory from which you want to run the Storage Command Line Tool, and run
the tool.
NOTE StorCLI must be run with the administrator privileges.
2.2
2.
To install the StorCLI RPM, run the rpm -ivh <StorCLI-x.xx-x.noarch.rpm> command.
3.
To upgrade the StorCLI RPM, run the rpm -Uvh <StorCLI-x.xx-x.noarch.rpm> command.
Chapter 2: Installation
Installing StorCLI on VMware Operating Systems
2.3
2.4
2.5
1.
Copy the binary file from the CD or from the LSI website.
2.
Place the binary file in the directory from which you want to run the Storage Command Line Tool, and run
the tool.
2.6
1.
Copy the binary file from the CD or from the LSI website.
2.
Place the binary file in the directory from which you want to run the Storage Command Line Tool, and run
the tool.
NOTE JSON format output is not supported in the EFI operating system. The EFI platform ignores the J when it is
added at the end of the command syntax.
NOTE Background operations are blocked in the EFI and HII environments and these operations are resumed in the
operating system environments.
Description
No object identifier specified If there is no object identifier, the command is a system command.
/cx
/cx/vx
/cx/vall
/cx/ex
/cx/eall
/cx/fx
/cx/fall
/cx/ex/sx
/cx/sx
This object identifier represents the drives that are directly attached to controller x.
/cx/ex/sall
/cx/dx
/cx/dall
This object identifier is for the all drive groups on enclosure x on controller x.
NOTE If enclosures are not used to connect physical drives to the controller, you do not specify the enclosure
ID in the command.
Description
add
This verb adds virtual drives, JBODs, and so on to the object identifier.
del
set
show
This verb shows the value and properties of the object identifier.
pause
resume
suspend
compare
download
start
flush
stop
This verb stops an operation that is in progress. A stopped process cannot be resumed.
import
expand
<[adverb | attributes | properties] > Specifies what the verb modifies or displays.
<[key=value]> Specifies a value, if a value is required by the command.
4.1
System Commands
4.1.1
show
show all
show ctrlcount
show help
-v
4.2
Controller Commands
Controller commands provide information and perform actions related to the specified controller, such as the /c0
controller. The Storage Command Line Tool supports the controller commands described in this section.
4.2.1
Value Range
Description
show <properties>
See Table 4
set <properties>
See Table 4
show
This section provides command information to show and set controller properties.
NOTE You cannot set multiple properties with a single command.
/cx
/cx
/cx
/cx
/cx
/cx
/cx
/cx
/cx
/cx
/cx
/cx
/cx
/cx
/cx
/cx
show
show
show
show
show
show
show
show
show
show
show
show
show
show
show
show
abortcconerror
activityforlocate
alarm
backplane
batterywarning
bgirate
bootwithpinnedcache
cachebypass
cacheflushint
ccrate
clusterenable
coercion
consistencycheck|cc
copyback
directpdmapping
dimmerswitch|ds
LSI Corporation Confidential
- 11 -
storcli
storcli
storcli
storcli
storcli
storcli
storcli
storcli
storcli
storcli
storcli
storcli
storcli
storcli
storcli
storcli
storcli
storcli
storcli
storcli
storcli
storcli
storcli
storcli
storcli
storcli
storcli
storcli
time=yyyymmdd hh:mm:ss|systemtime
usefdeonlyencrypt=<on|off>
The following table lists and describes the properties for the show and set commands.
Table 4 Properties for Show and Set Commands
Property Name
Description
abortcconerror
on|off
activityforlocate
on|off
alarm
on|off|silence
silence: Silences the alarm.
backplane
batterywarning
on|off
bgirate
0 to 100
cacheflushint
ccrate
0 to 100
coercion
0: No coercion
1: 128 MB
2: 1 GB
consistencycheck
copyback
on|off
type = smartssd|smarthdd|all
smartssd: Copy back enabled for SSD
drives.
smarthdd: Copy back enabled for HDD
drives.
all: Copy back enabled for both ssd
drives and HDD drives.
Example:
storcli /cx set copyback=on
type=all
directpdmapping
on|off
eccbucketleakrate
0 to 255
eccbucketsize
0 to 255
enableeghsp
on|off
enableesmarter
on|off
Description
enableeug
on|off
exposeencldevice
on|off
dimmerswitch|ds
foreignautoimport
on|off
jbod
on|off
loadbalancemode
on|off
maintainpdfailhistory
on|off
migraterate
0 to 100
patrolread|pr
perfmode
prcorrectunconfiguredareas
on|off
prrate
0 to 100
rebuildrate
0 to 100
reconrate
0 to 100
restorehotspare
on|off
smartpollinterval
0 to 65535
spinupdrivecount
0 to 255
spinupdelay
0 to 255
stoponerror
on|off
time
Valid time in yymmdd hh:mm:ss format or Sets the controller time to your input value or the system
systemtime
time (local time in 24-hour format).
usefdeonlyencrypt
on|off
4.2.2
4.2.3
4.2.3.1
Rebuild Rate
storcli /cx set rebuildrate=<value>
storcli /cx show rebuildrate
The detailed description for each command follows.
storcli /cx set rebuildrate=<value>
This command sets the rebuild task rate of the specified controller. The input value is in percentage.
Input example:
storcli /c0 set rebuildrate=30
NOTE A high rebuild rate slows down I/O processing.
4.2.3.2
Patrol Read
The Storage Command Line Tool supports the following patrol read commands:
storcli /cx resume patrolread
storcli /cx set patrolread ={{on mode=<auto|manual>}|{off}}
storcli /cx set patrolread [starttime=<yyyy/mm/dd hh>] [maxconcurrentpd=<value>]
[includessds=<on|off>] [uncfgareas=<on|off>]
storcli /cx set patrolread delay=<value>
storcli /cx show patrolread
storcli /cx start patrolread
storcli /cx stop patrolread
storcli /cx suspend patrolread
NOTE A patrol read operation is scheduled for all the physical drives of the controller.
Value Range
Description
starttime
maxconcurrentpd
includessds
uncfgareas
NOTE Controller time is taken as a reference for scheduling a patrol read operation.
Input example:
storcli /c0 set patrolread=on starttime=2012/02/21 00
storcli /cx set patrolread [delay=<value>]
This command delays the scheduled patrol read in hours.
Input example:
storcli /c0 set patrolread delay=30
storcli /cx show patrolRead
This command shows the progress on the current patrol read in percentage.
Input example:
storcli /c0 show patrolread
storcli /cx start patrolread
This command starts the patrol read operation. This command starts a patrol read immediately.
Input example:
storcli /c0 start patrolread
storcli /cx stop patrolread
This command stops a running patrol read operation.
Input example:
storcli /c0 stop patrolread
NOTE You cannot resume a stopped patrol read.
4.2.3.3
Consistency Check
The Storage Command Line Tool supports the following commands to schedule, perform, and view the status of a
consistency check (CC) operation.
storcli /cx set consistencycheck|cc=[off|seq|conc][delay=value]
starttime=yyyy/mm/dd hh [excludevd=x-y,z]
storcli /cx show cc
storcli /cx show ccrate
Value Range
Description
Sets CC to either sequential mode, or concurrent mode, or turns off the CC.
starttime
excludevd
Excludes virtual drives from the consistency checks. To exclude particular virtual
drives, you can provide list of virtual drive names (Vx,Vy format) or the range
of virtual drives that you want to exclude from a consistency check (Vx-Vy
format). If this option is not specified in the command, no virtual drives
are excluded.
Input example:
storcli /c0 set CC=on starttime=2012/02/21 00 excludevd v0-v3
storcli /cx show cc
This command shows the consistency check schedule properties for a controller.
Input example:
storcli /c0 show cc
storcli /cx show ccrate
This command checks the status of a consistency check operation. The CC rate appears in percentage.
Input example:
storcli /c0 show ccrate
NOTE A high CC rate slows I/O processing.
4.2.4
Value Range
Description
key
deactivatetrialkey
rehostcomplete
Input example:
storcli /c0 set Aso key=LSI0000
storcli /cx show safeid
This command shows the Safe ID of the specified controller.
Input example:
storcli /c0 show safeid
4.2.5
Value Range
Description
Should have a combination of numbers, upper String that is linked to the controller and is used in the next bootup to
case letters, lower case letters and special
encrypt the lock key. If the passphrase is not set, the controller
characters.
generates it by default.
Minimum of 8 characters and maximum of
32 characters
keyid
Input example:
storcli /c0 set securitykey=Lsi@12345 passphrase=Lsi@123456 keyid=1
storcli /cx set securitykey=sssss oldsecuritykey=ssss [passphrase=sssss][keyid=sssss]
This command changes the security key for the controller.
Input example:
storcli /c0 set securitykey=Lsi@12345 oldsecuritykey=pass123
passphrase=Lsi@123456 keyid=1
4.2.6
Value Range
nosigchk
Description
The application flashes the firmware even if the check word on the file does not match the required
check word for the controller.
NOTE You can damage the controller if a corrupted image is flashed using this option.
noverchk
fwtype
0: Application
1: TMMC
The application flashes the controller firmware without checking the version of the firmware image.
The firmware type to be downloaded. The application downloads the firmware for the controller. The
TMMC downloads the firmware for the TMMC battery only. Default is 0 (application).
4.3
Drive Commands
This section describes the drive commands, which provide information and perform actions related to physical drives.
The following table describes frequently used virtual drive commands.
Table 10 Physical Drives Commands Quick Reference Table
Commands
4.3.1
Value Range
Description
set
show
4.3.2
NOTE To set a drive that is part of an array as missing, first set it as offline. After the drive is set to offline,
you can then set the drive to missing.
4.3.3
4.3.4
4.3.5
4.3.6
4.3.7
Input example:
storcli /cx/e34/s4 spindown
storcli /cx[/ex]/sx spinup
This command spins up a spun-down drive and the drive state is unconfigured good.
Input example:
storcli /cx/e34/s4 spinup
4.3.8
4.3.9
Value Range
Description
erase
erasepatternA
8-bit value
erasepatternB
8-bit value
Input example:
storcli /c0/e25/s1 start erase thorough erasepatternA=10010011
erasepatternB=11110000
4.3.10
/cx[/ex]/sx
/cx[/ex]/sx
/cx[/ex]/sx
/cx[/ex]/sx
/cx[/ex]/sx
pause rebuild
resume rebuild
show rebuild
start rebuild
stop rebuild
NOTE If enclosures are used to connect physical drives to the controller, specify the enclosure ID in
the command.
The detailed description for each command follows.
storcli /cx[/ex]/sx pause rebuild
This command pauses an ongoing rebuild process. You can run this command only for a drive that is currently rebuilt.
Input example:
storcli /c0/s4 pause rebuild
storcli /cx[/ex]/sx resume rebuild
This command resumes a paused rebuild process. You can run this command only when a paused rebuild process for
the drive exists.
Input example:
storcli /c0/s4 resume rebuild
storcli /cx[/ex]/sx show rebuild
This command shows the progress of the rebuild process in percentage.
Input example:
storcli /c0/s5 show rebuild
storcli /cx[/ex]/sx start rebuild
This command starts a rebuild operation for a drive.
Input example:
storcli /c0/s4 start rebuild
storcli /cx[/ex]/sx stop rebuild
This command stops a rebuild operation. You can run this command only for a drive that is currently rebuilt.
Input example:
storcli /c0/s4 stop rebuild
4.3.11
/cx[/ex]/sx
/cx[/ex]/sx
/cx[/ex]/sx
/cx[/ex]/sx
/cx[/ex]/sx
pause copyback
resume copyback
show copyback
start copyback target=eid:sid
stop copyback
4.3.12
Value Range
Description
dgs
enclaffinity
nonrevertible
Input example:
storcli /c0/e3/s4,5 add hotsparedrive
This command sets the drives /c0/e3/s4,5 as Global Hot spare.
Input example:
storcli /c0/e3/s6,8 add hotsparedrive dgs=0,1
This command sets /c0/e3/s6,8 as Dedicated Hot spare for disk groups 0,1.
storcli /cx/[ex]/sx delete hotsparedrive
This command deletes a hotspare drive.
Input example:
storcli /c0/e3/s4,5 delete hotsparedrive
4.3.13
Input example:
storcli /c0/e252/s1 show SecurityKey keyid
4.4
Value Range
Description
add
delete
set
See Table 14, Table 15, and Section 4.4.5, Change Virtual Drive Properties
Commands
show
4.4.1
Value Range
Description
type
RAID [0|1|5|6|10|50|60].
size
name
15 characters of length.
drives
pdperarray
0 to 15.
sed
pdcache
on|off|default.
pi
dimmerswitch
direct|cached
wt|wb
nora|ra
cachedbadbbu|nocachedbadbbu
strip
aftervd
spares
force
Input example:
storcli /c0 add vd type=raid10 size=2gb,3gb,4gb names=tmp1,tmp2,tmp3
drives=252:2-3,5,7 pdperarray=2
Value Range
Description
cachecade
type
0, 1, 10
drives
Valid enclosure number and valid slot number See the drives row in the previous table for format.
wt|*wb
assignvds
Specifies the list of virtual drives associated with the new CacheCade virtual
drives.
Input example:
storcli /c0 add vd type=raid10 size=2gb,3gb,4gb names=tmp1,tmp2,tmp3
drives=252:2-3, 7
4.4.2
4.4.3
4.4.4
4.4.5
4.4.6
4.4.7
The Storage Command Line Tool supports the following commands for virtual drive migration (reconstruction).
storcli /cx/vx show migrate
storcli /cx/vx start migrate <type=raidlevel>
[option=<add | remove> disk=<e1/s1,e2/s2 ...> ]
The detailed description for each command follows.
storcli /cx/vx show migrate
This command shows the progress of the virtual drive migrate operation in percentage.
Input example:
storcli /c0/v0 show migrate
storcli /cx/vx start migrate <type=raidlevel> [option=<add | remove> disk=<e1:s1,e2:s2 ...> ]
This command starts the reconstruction on a virtual drive to the specified RAID level by adding or removing disks
from the existing virtual drive. You can use the following options with the start migrate command:
Table 16 Virtual Drive Migration Command Options
Options
type = RAID level
Value Range
Description
The RAID level to which the virtual drive must be
migrated.
RAID [0|1|5|6]
[option=<add | remove> add: Adds disks to the virtual drive and starts
Adds or removes disks from the virtual drive.
disk=<e1:s1,e2:s2, >] reconstruction.
remove: Removes disks from the virtual drive and starts
reconstruction.
disk: The enclosure number and the slot number of the
disks to be added to the virtual drive.
Virtual drive migration can be done between the following RAID levels.
Table 17 Virtual Drive Migration Table
Initial RAID level
RAID 0
RAID 1
RAID 0
RAID 5
RAID 0
RAID 6
RAID 1
RAID 0
RAID 1
RAID 5
RAID 1
RAID 6
RAID 5
RAID 0
RAID 5
RAID 6
RAID 6
RAID 0
RAID 6
RAID 5
Input example:
storcli /c0/v3 start migrate type=r5 option=add disk=e5:s2,e5:s3
4.4.8
/cx/vx
/cx/vx
/cx/vx
/cx/vx
/cx/vx
pause cc
resume cc
show cc
start cc [force]
stop cc
NOTE If enclosures are used to connect the physical drives to the controller, specify the IDs in the command.
4.4.9
/cx/vx
/cx/vx
/cx/vx
/cx/vx
/cx/vx
/cx/vx
resume bgi
set autobgi=<on|off>
show autobgi
show bgi
stop bgi
suspend bgi
Input example:
storcli /c0/v4 pause bgi
4.4.10
4.5
Input example:
storcli /c0/fall show preview foreign
storcli /c0/fall import preview
storcli /c0/fall show all
4.6
BIOS-Related Commands
The Storage Command Line Tool supports the following BIOS commands:
storcli
storcli
storcli
storcli
/cx
/cx
/cx
/cx
set bios=<on|off>
set stoponerror|soe=<on|off>
autobootselect(abs)=<on|off>
show bios
4.6.1
4.7
4.7.1
Input example:
storcli /c0/dall show all
storcli /cx/dall show cachecade
This command shows all CacheCade virtual drive information.
Input example:
storcli /c0/dall show cachecade
4.8
4.8.1
You can use the following combinations for the dimmer switch commands:
storcli
storcli
storcli
storcli
/cx
/cx
/cx
/cx
set
set
set
set
ds=off type=1|2|3|4
ds=on type=1|2 [properties]
ds=on type=3|4 defaultldtype=<value> [properties]
ds=on [properties]
Value Range
Description
dimmerswitch or ds
on|off
type
1: Unconfigured
2: Hotspare
3: Virtual drive
4: All
defaultldtype
auto: Logical device power savings are managed Specifies the default logical drive type that is created by
by the firmware.
the dimmer switch option; set to none automatically.
none: No power saving policy.
max: Logical device uses maximum power savings.
maxnocache: Logical device does not cache write
to maximise power savings.
properties
4.9
BBU Commands
The Storage Command Line Tool supports the following battery backup unit (BBU) commands:
storcli
storcli
storcli
storcli
storcli
storcli
storcli
storcli
storcli
/cx/bbu
/cx/bbu
/cx/bbu
/cx/bbu
/cx/bbu
/cx/bbu
/cx/bbu
/cx/bbu
/cx/bbu
show
show all
set bbuMode=<value>
set learndelayinterval=<value>
set powermode=sleep
set writeaceess=sealed
show properties
show status
start learn
Description
Same as the description for BBU mode 5. The BBU mode 6 enables you to receive events when the battery
capacity reaches suboptimal and critical thresholds.
a.
Indicates how long the battery can hold data in the controller's memory in case of accidental system shutdown.
b.
The controller's performance is not affected during the battery's learn cycle.
Input example:
storcli /c0/bbu set bbuMode=2
NOTE BBU modes are supported on any iBBU08/09 bbu/controller combo, and later-generations controllers.
Input example:
storcli /c0/bbu set writeaccess=sealed
LSI Corporation Confidential
- 44 -
4.10
Enclosure Commands
The Storage Command Line Tool supports the following enclosure commands.
storcli /cx/ex download src=filepath[forceActivate]
storcli /cx/ex show all
storcli /cx/ex show status
The detailed description for each command follows.
storcli /cx/ex download src=filepath [forceactivate]
This command flashes the firmware with the file specified at the command line. The enclosure performs an error
check after the operation. The following option can be used with the enclosure firmware download command.
Value Range
forceactivate
Description
Issues a command descriptor block (CDB) with write command with no data with command
mode 0x0F (flash download already in progress).
NOTE This option is used primarily to activate Scotch Valley Enclosures.
NOTE The firmware file that is used to flash the enclosure can be of any format. The StorCLI utility assumes
that you provide a valid firmware image.
Input example:
storcli /c0/e0 download src=c:\file2.bin
storcli /cx/ex show all
This command shows all enclosure information, which includes general enclosure information, enclosure inquiry data,
a count of enclosure elements, and information about the enclosure elements.
Input example:
storcli /c0/e0 show all
storcli /cx/ex show status
This command shows the enclosure status and the status of all the enclosure elements.
Input example:
storcli /c0/e0 show status
4.11
PHY Commands
The Storage Command Line Tool supports the following PHY commands:
storcli /cx/px|pall set linkspeed=1.5|3|6|12
storcli /cx/px|pall show
storcli /cx/px|pall show all
The detailed description for each command follows.
storcli /cx/px|pall set linkspeed=1.5|3|6|12
This command sets the PHY link speed. The speed can be set to 1.5 Gb/s, 3 Gb/s, 6 Gb/s, or 12 Gb/s.
Input example:
storcli /c0/p0 set linkspeed=1.5
storcli /cx/px|pall show
This command shows the basic PHY layer information.
Input example:
storcli /c1/p0 show
storcli /cx/px|pall show all
This command shows all the PHY layer information.
Input example:
storcli /c1/p0 show all
4.12
Logging Commands
The Storage Command Line Tool supports the following commands to generate and maintain log files.
storcli
storcli
storcli
storcli
storcli
/cx
/cx
/cx
/cx
/cx
clear events
delete termlog
show events file=<absolute path>
show eventloginfo
show termlog type=config|contents
Input example:
storcli /c0 delete events
storcli /cx delete termlog
This command clears the TTY (firmware log for issue troubleshooting) logs.
Input example:
storcli /c0 delete termlog
storcli /cx show events file=<absolute path>
This command prints the system log to a text file and saves the file in the specified location.
Input example:
storcli /c0 show events file=C:\Users\brohan\test\eventreports
storcli /cx show eventloginfo
This command shows the history of log files generated.
Input example:
storcli /c0 show eventloginfo type=config
storcli /cx show termlog type=config|contents
This command shows the firmware logs. The config option shows the term log configuration (settings of TTY BBU
buffering), the contents option shows the term log.The contents option is the default.
Input example:
storcli /c0 show termlog type=contents
5.2
5.3
5.4
5.5
NOTE The * indicates default values used in the creation of the virtual drives. If values are not specified, the
default values are taken.
Example: /cx add vd type=r1 drives=0:10-15 WB Direct strip=64
This command creates a RAID volume of RAID 1 type from drives in slots 10 to slot 15 in enclosure 0. The strip size
is 64kb.
5.6
5.7
5.8
5.9
StorCLI Command
show
show ctrlcount
StorCLI Command
/cx show all
StorCLI Command
/cx show <PropertyName>
The following properties can be used with this
command:
abortcconerror
activityforlocate
alarm
autorebuild
backplane
batterywarning
bgirate
bootwithpinnedcache
cachebypass
cacheflushint
ccrate
clusterenable
coercion
copyback
directpdmapping
ds
eccbucketleakrate
eccbucketsize
enableeghsp
enableesmarter
enableeug
exposeencldevice
jbod
loadbalancemode
maintainpdfailhistory
migraterate
ncq
perfmode
pr
prcorrectunconfiguredareas
prrate
rebuildrate
rehostinfo
restorehotspare
safeid
smartpollinterval
spinupdelay
spinupdrivecount
time
usefdeonlyencrypt
StorCLI Command
abortcconerror=<on|off>
activityforlocate=<on|off>
alarm=<value>
autorebuild=<on|off>
backplane=<value>
batterywarning=<on|off>
bgirate=<value>
bootwithpinnedcache=<on|off>
cachebypass=<on|off>
flush|flushcache
cacheflushinterval=<value>
ccrate=<value>
coercion=<value>
clusterenable=<value>
copyback=<on|off>
type=<smartssd|smarthdd|all>
directpdmapping=<on|off>
eccbucketleakrate=<value>
eccbucketsize=<value>
enableeghsp=<value>
enableesmarter=<value>
enableeug=<value>
exposeencldevice=<on|off>
foreignautoimport=<on|off>
jbod=<on|off>
loadbalancemode=<value>
maintainpdfailhistory=<on|off>
migraterate=<value>
ncq=<on|off>
perfmode=<value>
prcorrectunconfiguredareas=<on|off>
prrate=<value>
rebuildrate=<value>
restorehotspare=<on|off>
smartpollinterval=<value>
spinupdelay=<value>
spinupdrivecount=<value>
stoponerror=<on|off>
usefdeonlyencrypt=<on|off>
time=yyyymmdd hh:mm:ss|systemtime
usefdeonlyencrypt=<on|off>
StorCLI Command
/cx set alarm=<on|off|silence>
NOTE The StorCLI controllers have controller alarms.
StorCLI Command
/cx/ux show
/cx/vx show cc
/cx show ccrate
NOTE The 3Ware CLI combines both patrol read and consistency check into a single command. The StorCLI
has different commands for each.
StorCLI Command
/cx/bbu show
/cx/bbu show
/cx/bbu
/cx/bbu
/cx/bbu
/cx/bbu
/cx/bbu
/cx/bbu
/cx/bbu
/cx/bbu
/cx/bbu
/cx/bbu
/cx/bbu
show
show
show
show
show
show
show
show
show
show
show
batinst
bootloader
fw
lasttest
pcb
serial
status
temp
tempstat
tempval
volt
StorCLI Command
/cx add vd
type=raid[0|1|5|6|10|50|60]
[[size=<vd1_size>,<vd2_size>,..|
*all][name=<vdname1>,..]
drives=e:s|e:s-x|e:s-x,y;e:s-x,y,z
[pdperarray=x|*auto] [sed]
[pdcache=on|off|*default ]
[pi][dimmerswitch|
ds=default|automatic(auto)|
*none|maximum(max)
|maximumwithoutcaching(maxnocache)]
[wt|*wb] [nora|*ra] [*direct|cached]
[cachedbadbbu|*nocachedbadbbu]
[strip=<8|16|32|64|128|256|512|
1024] [aftervd=x]
[ spares=[e:]s|[e:]s-x|[e:]sx,y;[e:]s-x,y,z > ] [force]
StorCLI Command
/cx/dall show [cachecade]
/cx rescan
/cx/ux
/cx/ux
/cx/ux
/cx/ux
/cx/ux
/cx/ux
/cx/ux
/cx/ux
/cx/ux
/cx/ux
/cx/ux
/cx/ux
/cx/ux
/cx/ux
/cx/ux
/cx/ux
show
show
show
show
show
show
show
show
show
show
show
show
show
show
show
show
autoverify
identify
ignoreECC
initializestatus
name
parit
qpolicy
rapidrecovery
rdcache
rebuildstatus
serial
status
storsave
verifystatus
volumes
wrcache
/cx/vx set
accesspolicy=<rw|ro|blocked|
rmvblkd>
/cx/vx set cachedbadbbu=<on|off>
/cx/vx set iopolicy=<cached|direct>
/cx/vx set name=<namestring>
/cx/vx set pdcache=<on|off|default>
/cx/vx set rdcache=<ra|nora|adra>
/cx/vx set security=<on|off>
/cx/vx|vall set ssdcaching=<on|off>
/cx/vx set wrcache=<wt|wb|fwb>
[all]
autoverify
cache
identify
ignoreECC
name
parit
qpolicy
rapidrecovery
rdcache
rebuildstatus
serial
status initializestatus
storsave
verifystatus
volumes
wrcache
StorCLI Command
/cx/vx show all
NOTE The StorCLI does not have commands to
show individual virtual drive properties.
/cx/vx start cc
/cx/vx stop cc
StorCLI Command
/cx[/ex]/sx
/cx[/ex]/sx
/cx[/ex]/sx
/cx[/ex]/sx
start rebuild
stop rebuild
pause rebuild
resume rebuild
Add jbod.
/cx[/ex]/sx spindown
StorCLI Command
/cx/ex
/cx/ex
/cx/ex
/cx/ex
/cx/ex
/cx/ex
/cx/ex
show
show
show
show
show
show
show
[all]
controllers
slots
fans
temp
pwrs
alms
StorCLI Command
StorCLI Command
ver
show help
/cx/phyx show
/cx/px show
/cx/phyx set
link=<0|1.5|3.0|6.0|12.0>
MegaCLI Command
StorCLI Command
MegaCLI -v
storcli -v
MegaCLI -help|-h|?
storcli -help|-h|?
MegaCLI -adpCount
MegaCLI Command
StorCLI Command
/cx show <propertyName>
MegaCLI Command
spinupencdrvcnt
ssdsmartcpybkenbl
usediskactivityforlocate
usefdeonlyencrypt
StorCLI Command
MegaCLI Command
StorCLI Command
Megacli -AdpSetProp
<propertyname>-an|-a0,1,2|-aall
MegaCLI Command
StorCLI Command
spinupencdrvcnt
sdsmartcpybkenbl
usediskactivityforlocate
usefdeonlyencrypt
MegaCLI -adpCount
MegaCli -AdpAllInfo
-aN|-a0,1,2|-aALL
MegaCLI -CfgFreeSpaceinfo
-aN|-a0,1,2|-aALL
MegaCLI-GetPreservedCacheList
-aN|-a0,1,2|-aALL
MegaCLI Command
StorCLI Command
MegaCLI Command
StorCLI Command
MegaCLI Command
MegaCLI -AdpCcSched -Dsbl|-Info|
{-ModeConc | -ModeSeq [-ExcludeLD
-LN|-L0,1,2] [-SetStartTime yyyymmdd
hh ] [-SetDelay val ] }
-aN|-a0,1,2|-aALL
StorCLI Command
storcli /cx set
consistencycheck|cc=[off|seq|conc]
[delay=value] starttime=yyyy/mm/dd
hh [excludevd=x-y,z]
storcli /cx show cc/ConsistencyCheck
MegaCLI Command
StorCLI Command
MegaCLI Command
StorCLI Command
MegaCli -AdpBbuCmd
-GetBbuCapacityInfo
-aN|-a0,1,2|-aALL
MegaCli CfgLDAdd
-R0|-R1|-R5|-R6[E0:S0,E1:S1,...]
[WT | WB] [NORA | RA | ADRA]
[Direct | Cached]
[CachedBadBBU|NoCachedBadBBU]
[-szXXXXXXXX [-szYYYYYYYY [... ]]]
[-strpszM] [Hsp[E5:S5,...]]
[afterLdX] -aN
MegaCli CfgSpanAdd
-aN|-a0,1,2|-aALL
-R10|-R50|R60
Array0[E0:S0,E1:S1,...]
Array1[E0:S0,E1:S1,...] [...]
[WT | WB] [NORA | RA | ADRA]
[Direct | Cached]
[CachedBadBBU|NoCachedBadBBU]
[-szXXXXXXXX [-szYYYYYYYY [... ]]]
[-strpszM] [afterLdX] -aN
MegaCLI -CfgDsply
-aN|-a0,1,2|-Aall
MegaCLI -CfgCacheCadeDsply
-aN|-a0,1,2|-Aall
MegaCLI -CfgLdDel
-LX|-L0,2,5...|-LALL [-Force]
-aN|-a0,1,2|-aALL
MegaCLI -CfgCacheCadeDel
-LX|-L0,2,5...|-LALL
-aN|-a0,1,2|-Aall
MegaCli -CreateSecurityKey
-SecurityKey sssssssssss |
[-Passphrase sssssssssss] |
[-KeyID kkkkkkkkkkk] -aN
MegaCli -ChangeSecurityKey
-OldSecurityKey sssssssssss |
-SecurityKey sssssssssss|
[-Passphrase sssssssssss] |
[-KeyID kkkkkkkkkkk] -aN
MegaCli -VerifySecurityKey
-SecurityKey sssssssssss -aN
MegaCLI -DestroySecurityKey |
[-Force] -aN
Set the security key for the controller. MegaCli -SetKeyID -KeyID kkkkkkkkkkk storcli /cx set SecurityKey
-aN
KeyId=xxxx
MegaCli -getLdExpansionInfo
-Lx|-L0,1,2|-Lall -aN|-a0,1,2|-aALL
MegaCLI --LDMakeSecure
-Lx|-L0,1,2,...|-Lall An
storcli
storcli
storcli
storcli
storcli
/cx/v(x|all)
/cx/v(x|all)
/cx/v(x|all)
/cx/v(x|all)
/cx/v(x|all)
start cc
stop cc
pause cc
resume cc
show cc
Enable/disable automatic
background initialization. Show, stop,
pause, resume, and show the
progress of the background
initialization.
storcli /cx/v(x|all)
autobgi=On|Off
storcli /cx/v(x|all)
storcli /cx/v(x|all)
storcli /cx/v(x|all)
storcli /cx/v(x|all)
storcli /cx/v(x|all)
set
show autobgi
stop bgi
pause bgi
resume bgi
show bgi
Start and show progress for a migrate MegaCli LDRecon {Start Rx [Add storcli /cx/vx start migrate
operation.
| Rmv PhysDrv[E0:S0,E1:S1,...] ] } type=raidx [option=add|remove
| ShowProg|-ProgDsply Lx aN
drives=[e:]s|[e:]s-x|[e:]s-x,y]
[Force]
storcli /cx/v(x|all) show migrate
Delete preserved cache.
MegaCLI -DiscardPreservedCache
-Lx|-L0,1,2|-Lall -force
-aN|-a0,1,2|-aALL
MegaCLI Command
StorCLI Command
storcli
storcli
storcli
storcli
storcli
/cx/ex/sx
/cx/ex/sx
/cx/ex/sx
/cx/ex/sx
/cx/ex/sx
start rebuild
stop rebuild
pause rebuild
resume rebuild
show rebuild
storcli /cx/ex/sx
target=exx:sxx
storcli /cx/ex/sx
storcli /cx/ex/sx
storcli /cx/ex/sx
storcli /cx/ex/sx
start copyback
stop copyback
pause copyback
resume copyback
show copyback
MegaCli -PdMarkMissing
-physdrv[E0:S0,E1:S1,...]
-aN|-a0,1,2|-aALL
MegaCli -PdGetMissing
-aN|-a0,1,2|-aALL
MegaCli -PdReplaceMissing
-physdrv[E0:S0] -arrayA, -rowB
-aN
MegaCLI Command
StorCLI Command
MegaCli PDOffline
-PhysDrv[E0:S0,E1:S1....]
-aN|-a0,1,2|-aALL
MegaCli PDMakeGood
-PhysDrv[E0:S0,E1:S1....]
-aN|-a0,1,2|-aALL
MegaCli -PDMakeJBOD
-PhysDrv[E0:S0,E1:S1,...]
-aN|-a0,1,2|-aALL
storcli
storcli
storcli
storcli
storcli
/cx/ex/sx
/cx/ex/sx
/cx/ex/sx
/cx/ex/sx
/cx/ex/sx
start initialization
stop initialization
pause initialization
resume initialization
show initialization
Start a drive locate and activate the MegaCli PDLocate {[-start] | storcli /cx/ex/sx start locate
drives LED or stop a drive locate and -stop} -physdrv[E0:S0,E1:S1,...] storcli /cx/ex/sx stop locate
deactivate the drives LED.
-aN|-a0,1,2|-aALL
Spin down an unconfigured drive
MegaCli PDPrpRmv [-Undo]
and prepare it for removal or spin up PhysDrv[E0:S0,E1:S1....]
spun-down drive and mark the drive -aN|-a0,1,2|-aALL
state as unconfigured good.
MegaCLI PdFwDownload[offline]
[ForceActivate] {[-SataBridge]
-PhysDrv[0:1]}|{-EncdevId[devId1
]} -f <filename>
-aN|-a0,1,2|-Aall
MegaCli -PDInstantSecureErase
Erase the drive's security
configuration and securely erase data -PhysDrv[E0:S0,E1:S1,...] |
[-Force] -aN|-a0,1,2|-aALL
on a drive.
MegaCLI Command
MegaCli -GetKeyID
[-PhysDrv[E0:S0]] -aN
StorCLI Command
storcli /cx/ex/sx show securitykey
keyid
MegaCLI DirectPdMapping
-Enbl|-Dsbl|-Dsply
-aN|-a0,1,2|-Aall
MegaCLI Command
StorCLI Command
MegaCli EncInfo
-aN|-a0,1,2|-aALL
MegaCli EncStatus
-aN|-a0,1,2|-aALL
MegaCLI Command
StorCLI Command
MegaCLI Command
StorCLI Command
MegaCLI Command
StorCLI Command
MegaCli -AdpEventLog
-GetEventLogInfo
-aN|-a0,1,2|-aALL
MegaCli -AdpEventLog
-GetSinceShutdown {-info
-warning -critical -fatal}
{-f <fileName>}
-aN|-a0,1,2|-aALL
MegaCLI Command
StorCLI Command
MegaCli -ELF -Applykey key val storcli /cx(x|all) set aso key=<key
-preview -a0
value> preview
MegaCli -ELF
DeactivateTrialKey -a0
Command
storcli /c0 set jbod=<on|off>
storcli /c0/s2 set jbod
storcli /c0/s2 set bootdrive=<on|off>
DS
Security
ASO
Copy back
Migrate
Cache
Command
storcli /cx/bbu show
storcli /cx/bbu show all
storcli /cx/bbu set [ learnDelayInterval=<val> | bbuMode=<val>
storcli /cx/bbu start learn
Secure ease
Consistency check
Controller
Description of Changes
Updated the /cx add/ syntax in Section 4.4.1, Add Virtual Drives Commands.
Updated the description for force option in Section 4.4.2, Delete Virtual Drives Commands.
Updated the /cx add/ syntax in the following tables:
Description of Changes
Updated the following sections:
Section 1.1, Overview.
Chapter 2, Installation.