Skip to main content

storage command

Use this command to display and configure (if supported by the platform) information about the server's storage devices that are managed by the BMC.

Syntax:
storage [-options]
Note
The detailed information of the VROC controller can also be viewed via the adapter command.
Table 1. storage options
OptionDescriptionValues
-listList the storage targets managed by the BMC.controllers, pools, volumes, drives
-list -target [target_id]List the storage targets managed by the BMC according to the [target_id]. 
-list devicesDisplay the status of all disks managed by the BMC. 
-show [target_id]Display information for the selected target that is managed by the BMC. 
-show [target_id] infoDisplay detailed information for the selected target that is managed by the BMC. 
-show [target_id] firmwareDisplay the firmware information for the selected target that is managed by the BMC. 
-showinfo nvmeDisplay firmware information of NVMe disk. 
-wthre showDisplay critical and warning SSD wear threshold.Threshold value (1 to 99)
-wthre -ct [threshold value]Set SSD wear critical threshold.Threshold value (0 to 98)
-wthre -wt [threshold value]Set SSD wear warning threshold.Threshold value (1 to 99)
Note
The warning value needs to be greater than the critical value.
-config ctrl -scanforgn -target [target_id]Detect the foreign RAID configuration.Where [target_id] is ctrl[x]
-config ctrl -imptforgn -target [target_id]Import the foreign RAID configuration.Where [target_id] is ctrl[x]
-config ctrl -clrforgn -target [target_id]Clear the foreign RAID configuration.Where [target_id] is ctrl[x]
-config ctrl -clrcfg -target [target_id]Clear the RAID configuration.Where [target_id] is ctrl[x]
-config ctrl -bootdevice -vd [volume] -target [target_id]Set boot device by volume.Where [target_id] is ctrl[x] and [volume] is a value in the first column of "list volumes" output.
-config ctrl -bootdevice -pd [drive] -target [target_id]Set boot device by drive.Where [target_id] is ctrl[x] and [drive] is a value in the first column of "list drives" output.
-config ctrl -bootdevice -index [index] -target [target_id]Set boot device by index.Where [target_id] is ctrl[x] and [index] is a value in "[]" which is the output of "display" option.
-config ctrl -bootdevice -display -target [target_id]Show bootable device. 
-config drv -mkoffline -target [target_id]Change the drive state from online to offline.Where [target_id] is disk[x]
-config drv -mkonline -target [target_id]Change the drive state from offline to online.Where [target_id] is disk[x]
-config drv -mkmissing -target [target_id]Mark the offline drive as an unconfigured good drive.Where [target_id] is disk[x]
-config drv -prprm -target [target_id]Prepare an unconfigured good drive for removal.Where [target_id] is disk[x]
-config drv -undoprprm -target [target_id]Cancel the prepare an unconfigured good drive for removal operation.Where [target_id] is disk[x]
-config drv -mkbad -target [target_id]Change the unconfigured good drive to a unconfigured bad drive.Where [target_id] is disk[x]
-config drv -mkgood -target [target_id]Change an unconfigured bad drive to a unconfigured good drive, or convert the just a bunch of disks (JBOD) drive to an unconfigured good drive.Where [target_id] is disk[x]
-config drv -mkjbod -target [target_id]Make unconfigured good as JBOD.Where [target_id] is disk[x]
-config drv -rebuild -target [target_id]Start rebuild drive.Where [target_id] is disk[x]
-config drv -addhsp -target [target_id]Assign the selected drive as a hot spare to one controller or to existing storage pools.Where [target_id] is disk[x]
-config drv -dedicated pools -target [target_id]Assign drive as dedicated hot spare to the selected storage pools.Where [target_id] is disk[x]
-config drv -rmhsp -target [target_id]Remove the hot spare.Where [target_id] is disk[x]
-config vol -remove -target [target_id]Remove one volume.Where [target_id] is disk[x]
-config vol -set [-N] [-w] [-r] [-i] [-a] [-d] [-b] -target [target_id]Modify the properties of one volume.
  • [-N volume_name] is the name of the volume (optional).
  • [-w <0|1|2|3>] is the cache write policy (optional for Broadcom RAID, N/A for others).
    • Type 0 for the Write Through policy
    • Type 1 for the Protected Write Back policy
    • Type 2 for the Unprotected Write Back policy
    • Type 3 for no policy
  • [-r <0|1>] is the cache read policy (optional for Broadcom RAID, N/A for others).
    • Type 0 for the No Read Ahead policy
    • Type 1 for the Read Ahead Policy
  • [-i <0|1>] is the cache I/O policy (optional for Broadcom RAID, N/A for others).
    • Type 0 for the Direct I/O policy
    • Type 1 for the Cached I/O policy
  • [-a <0|2|3>] is the access policy (optional for Broadcom RAID, N/A for others).
    • Type 0 for the Read Write policy
    • Type 2 for the Read Only policy
    • Type 3 for the Blocked policy
  • [-d <0|1|2>] is the disk cache policy (optional for Broadcom RAID, N/A for others).
    • Type 0 if the policy is unchanged
    • Type 1 to enable policy
    • Type 2 to disable policy
  • [-b <0|1>] is the background initialization (optional for Broadcom RAID, N/A for others).
    • Type 0 to enable initialization
    • Type 1 to disable initialization
  • -target_id is vol[x]
-config vol -add [-R] [-D disk] [-H disk] [-1 hole] [-N] [-w] [-r] [-i] [-a] [-d] [-f] [-S] [-P]Create one volume for a new storage pool when the target is a controller, or create one volume with an existing storage pool when the target is a storage pool.
  • [-R <0|1|5|1E|6|10|50|60|00>]This option defines the RAID level and is only used with a new storage pool.
  • [-D disk [id11]:disk[id12]:..disk[id21]:disk[id22]:..]This option defines the drive group (including spans) and is only used with a new storage pool.
  • [-H disk [id1]:disk[id2]:..] This option defines the hot spare group and is only used with a new storage pool.
  • [-1 hole]This option defines the index number of the free hole space for an existing storage pool.
  • [-N volume_name] is the name of the volume (optional).
  • [-w <0|1|2|3>] is the cache write policy (optional for Broadcom/Microchip RAID, N/A for VROC).
    • Type 0 for the Write Through policy
    • Type 1 for the Protected Write Back policy
    • Type 2 for the Unprotected Write Back policy
    • Type 3 for no policy
  • [-r <0|1>] is the cache read policy (optional for Broadcom/Microchip RAID, N/A for VROC).
    • Type 0 for the No Read Ahead policy
    • Type 1 for the Read Ahead Policy
  • [-i <0|1>] is the cache I/O policy (optional for Broadcom RAID, N/A for others).
    • Type 0 for the Direct I/O policy
    • Type 1 for the Cached I/O policy
  • [-a <0|2|3>] is the access policy (optional for Broadcom RAID, N/A for others).
    • Type 0 for the Read Write policy
    • Type 2 for the Read Only policy
    • Type 3 for the Blocked policy
  • [-d <0|1|2>] is the disk cache policy (optional for Broadcom RAID, N/A for others).
    • Type 0 if the policy remains unchanged
    • Type 1 to enable the policy (doesn't support mirror RAID level)
    • Type 2 to disable the policy
  • [-f <0|1|2>] is the type of initialization (optional for Broadcom RAID, N/A for others).
    • Type 0 for no initialization
    • Type 1 for quick initialization
    • Type 2 for full initialization
  • [-S volume_size] is the size of the new volume in MB (optional)
  • [-P strip_size] is the volume strip size for example, 512B, 4K, 128K, 1M, and so on (optional)
  • -target target_id is:
    • ctrl[x] (new storage pool)
    • pool[x] (existing storage pool)
-config vol -getfreecap [-R] [-D disk] [-H disk] -target [target_id]Get the free capacity amount of the drive group.
  • [-R <0|1|5|1E|6|10|50|60|00>] This option defines the RAID level and is only used with a new storage pool
  • [-D disk [id11]:[id12]:..[id21]:[id22]:..] This option defines the drive group (including spans) and is only used with a new storage pool
  • [-H disk [id1]:[id2]:..]This option defines the hot spare group and is only used with a new storage pool
  • -target target_id is ctrl[x]
-fgi vol[idx]Fast initialize the specified volume(s)Where vol[idx] is vol[id1],vol[id2]:..
-helpDisplay the command usage and options 
Examples:
system> storage -list controllers
ctrl[1] ThinkSystem RAID 940-8i 4GB Flash PCIe Gen4 12Gb Adapter(PCI Slot 1)

system> storage -list pools
pool[1-239] Storage Pool 239

system> storage -list volumes
vol[1-239] VD2 RAID1 200.00GiB Optimal

system> storage -list drives
disk[1-48] Drive 1-2 Online 480GB 6Gbps 2.5" SATA SSD
disk[1-47] Drive 1-3 Online 480GB 6Gbps 2.5" SATA SSD
disk[1-46] Drive 1-1 JBOD 480GB 6Gbps 2.5" SATA SSD
disk[1-40] Drive 1-0 JBOD 480GB 6Gbps 2.5" SATA SSD

system> storage -list devices
Drive 1-2 Normal
Drive 1-3 Normal
Drive 1-1 Normal
Drive 1-0 Normal
system> storage -show ctrl[1]
Product Name: ThinkSystem RAID 940-8i 4GB Flash PCIe Gen4 12Gb Adapter
Firmware Package Version: 52.27.0-5215
Battery Backup: Not installed
Manufacture: Lenovo
UUID: 9C9450DAA89040BD9B8C5CEC2C7EF170
Model: SAS3908
Serial No.: L1FM23HSA10
Part No.: SR17B09191
FRU No.: 01PE816
Persistent Cache Size: 3142
Total Cache Size: 4096
PCI Slot Number: 1
PCI Device ID: 0x10e2
SubsystemId: 1546
SubsystemVendorId: 7497
VendorId: 4096

Storage Pool: 1
pool[1-239] Storage Pool 239

Drives: 4
disk[1-48] Drive 1-2 Online 480GB 6Gbps 2.5" SATA SSD
disk[1-47] Drive 1-3 Online 480GB 6Gbps 2.5" SATA SSD
disk[1-46] Drive 1-1 JBOD 480GB 6Gbps 2.5" SATA SSD
disk[1-40] Drive 1-0 JBOD 480GB 6Gbps 2.5" SATA SSD

Total Firmware number: 1
Name: Firmware
Manufacture: Broadcom
Version: 52.27.0-5215

system> storage -show pool[1-239]
RAID State: RAID1
RAID Capacity: 200.00GiB (246.10GiB free)
Holes: 1
#0 Free Capacity: 246.10GiB
Drives: 2
disk[1-48] Drive 1-2 Online 480GB 6Gbps 2.5" SATA SSD
disk[1-47] Drive 1-3 Online 480GB 6Gbps 2.5" SATA SSD
Volumes: 1
vol[1-239] VD2 RAID1 200.00GiB Optimal

system> storage -show disk[1-48]
Product Name: MZ7L3480HELT-00A07
State: Online
Slot No.: 2
Disk Type: SATA
Media Type: SSD
Health Status: Normal
Capacity: 446.10 GiB
Speed: 6 Gb/s
Current Temperature: 33
Rotation Rate: 0 RPM
Secured: No
Manufacture: SAMSUNG
Enclosure ID: 0
Model: MZ7L3480HELT-00A07
Serial No.: S785NA0X300234
Part No.: MZ7L3480HELT-00A07
FRU No.: S785NA0X300234
Name: Drive 2
Manufacture: SAMSUNG
Version:

system> storage -show vol[1-239]
Name: VD2
Status: Optimal
Strip Size: 256KiB
Bootable: Not Bootable
Capacity: 200.00GiB
Read Policy: Off
Current Write Policy: ProtectedWriteBack
I/O Policy: Direct
Access Policy: ReadWrite