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 IMM.

Syntax:
storage [-options]
Table 1. storage options
OptionDescriptionValues
-listList the storage targets managed by the IMM.controllers|pools|volumes|drives
  • controllers: list the supported RAID controllers1
  • pools: list the storage pools associated with the RAID controller1
  • volumes: list the storage volumes associated with the RAID controller1
  • drives: list the storage drives associated with the RAID controller1
-list storage targets -target target_idList the storage targets managed by the IMM according to the target_id.pools|volumes|drives and ctrl[x]|pool[x]

Where storage targets and target_id are:

  • pools and ctrl[x]: list the storage pools associated with the RAID controller, based on the target_id1
  • volumes and ctrl[x]|pool[x]: list the storage volumes associated with the RAID controller, based on the target_id1
  • drives and ctrl[x]|pool[x]: list the storage drives associated with the RAID controller, based on the target_id1
-list devicesDisplay the status of all disks managed by the IMM. 
-show target_idDisplay information for the selected target that is managed by the IMM.Where target_id is ctrl[x]|vol[x]|disk[x]|pool[x]3
-show target_id infoDisplay detailed information for the selected target that is managed by the IMM.Where target_id is ctrl[x]|vol[x]|disk[x]|pool[x]3
-show target_id firmware3Display the firmware information for the selected target that is managed by the IMM.Where target_id is ctrl[x]|disk[x]2
-showinfo nvmeDisplay firmware information of Nvme disk. 
-wthre showDisplay critical and warning SSD wear threshold.Threshold value (1 to 99)
-wthre -ct threshold valueSet SSD wear critical threshold.Threshold value (1 to 99)
-wthre -wt threshold valueSet SSD wear warning threshold.Threshold value (1 to 99)
Note
The warning value needs to be greater than the critical.
-config ctrl -scanforgn -target target_id3Detect the foreign RAID configuration.Where target_id is ctrl[x]5
-config ctrl -imptforgn -target target_id3Import the foreign RAID configuration.Where target_id is ctrl[x]5
-config ctrl -clrforgn -target target_id3Clear the foreign RAID configuration.Where target_id is ctrl[x]5
-config ctrl -clrcfg -target target_id3Clear the RAID configuration.Where target_id is ctrl[x]5
-config ctrl -bootdevice -vd volume -target target_idSet 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_idSet 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_idSet 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_idShow bootable device. 
-config drv -mkoffline -target target_id3Change the drive state from online to offline.Where target_id is disk[x]5
-config drv -mkonline -target target_id3Change the drive state from offline to online.Where target_id is disk[x]5
-config drv -mkmissing -target target_id3Mark the offline drive as an unconfigured good drive.Where target_id is disk[x]5
-config drv -prprm -target target_id3Prepare an unconfigured good drive for removal.Where target_id is disk[x]5
-config drv -undoprprm -target target_id3Cancel the prepare an unconfigured good drive for removal operation.Where target_id is disk[x]5
-config drv -mkbad -target target_id3Change the unconfigured good drive to a unconfigured bad drive.Where target_id is disk[x]5
-config drv -mkgood -target target_id3Change 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]5
-config drv -mkjbod -target target_id3Make unconfigured good as JBOD.Where target_id is disk[x]5
-config drv -rebuild -target target_id3Start rebuild drive.Where target_id is disk[x]5
-config drv -addhsp -target target_id3Assign the selected drive as a hot spare to one controller or to existing storage pools.Where target_id is disk[x]5
-config drv -dedicated pools -target target_id3Assign drive as dedicated hot spare to the selected storage pools.Where target_id is disk[x]5
-config drv -rmhsp -target target_id3Remove the hot spare.Where target_id is disk[x]5
-config vol -remove -targettarget_id3Remove one volume.Where target_id is vol[x]5
-config vol -set [-N] [-w] [-r ] [-i] [-a] [-d] [-b] -target target_id3Modify the properties of one volume.
  • [-N volume_name] is the name of the volume
  • [-w <0|1|2|3>] is the cache write policy:
    • 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:
    • Type 0 for the No Read Ahead policy
    • Type 1 for the Read Ahead Policy
  • [-i <0|1>] is the cache I/O policy:
    • Type 0 for the Direct I/O policy
    • Type 1 for the Cached I/O policy
  • [-a <0|2|3>] is the access policy:
    • 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:
    • Type 0 if the policy is unchanged
    • Type 1 to enable policy6
    • Type 2 to disable policy
  • [-b <0|1>] is the background initialization:
    • Type 0 to enable initialization
    • Type 1 to disable initialization
  • -target_id is vol[x]5

-config vol -add [-R] [-D disk] [-H disk] [-1 hole] [-N] [-w] [-r]3,7

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
  • [-w <0|1|2|3>] is the cache write policy:
    • 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:
    • Type 0 for the No Read Ahead policy
    • Type 1 for the Read Ahead Policy
-config vol -add[-i] [-a] [-d] [-f] [-S] [-P] -target target_id3Create 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.

  • [-i <0|1>] is the cache I/O policy:
    • Type 0 for the Direct I/O policy
    • Type 1 for the Cached I/O policy
  • [-a <0|2|3>] is the access policy:
    • 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:
    • Type 0 if the policy remains unchanged
    • Type 1 to enable the policy6
    • Type 2 to disable the policy
  • [-f <0|1|2>] is the type of initialization:
    • 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
  • [-P strip_size] is the volume strip size for example, 512B, 4K, 128K, 1M, and so on
  • -target target_id is:
    • ctrl[x] (new storage pool)5
    • pool[x] (existing storage pool)5
-config vol -getfreecap [-R] [-D disk] [-H disk] -target target_id3Get 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]5
-fgi vol[idx]Fast initialize the specified volume(s)Where vol[idx] is vol[id1],vol[id2]:..
-helpDisplay the command usage and options 
Note
  1. This command is only supported on servers where the IMM can access the RAID controller.
  2. Firmware information is displayed only for associated controllers, disks, and Flash DIMMs. Firmware information for associated pools and volumes are not displayed.
  3. Information is displayed on multiple lines due to space limitations.
  4. This command is only supported on servers that support RAID logs.
  5. This command is only supported on servers that support RAID configurations.
  6. The Enable value does not support RAID level 1 configurations.
  7. A partial list of available options are listed here. The remaining options for the storage -config vol -add command are listed in the following row.
Examples:
system> storage -config ctrl -clrcfg -target ctrl[0]
ok
system>
system> storage -config ctrl -clrforgn -target ctrl[0]
ok
system>
system> storage -config ctrl -imptforgn -target ctrl[0]
ok
system>
system> storage -config ctrl -scanforgn -target ctrl[0]
Detect 1 foreign configuration(s) on controller ctrl[0]
system>
system> storage -config drv -addhsp -dedicated pool[0-1] -target disk[0-0]
ok
system>
system> storage -config drv -addhsp -target disk[0-0]
ok
system>
system> storage -config drv -mkbad -target disk[0-0]
ok
system>
system> storage -config drv -mkgood -target disk[0-0]
ok
system>
system> storage -config drv -mkmissing -target disk[0-0]
ok
system>
system> storage -config drv -mkoffline -target disk[0-0]
ok
system>
system> storage -config drv -mkonline -target disk[0-0]
ok
system>
system> storage -config drv -prprm -target disk[0-0]
ok
system>
system> storage -config drv -rmhsp -target disk[0-0]
ok
system>
system> storage -config drv -undoprprm -target disk[0-0]
ok
system>
system> storage -config vol -add -1 1 -target pool[0-1]
ok
system>
system> storage -config vol -add -R 1 -D disk[0-0]:disk[0-1] -w 1 -r 2 -i 0 -a 0 -d 0 -f 0 -N LD_volume -S 100000 -P 64K -H disk[0-2] -target ctrl[0]
ok
system>
system> storage -config vol -getfreecap -R 1 -D disk[0-0]:disk[0-1] -H disk[0-2] -target ctrl[0]
The drive group configuration is good with free capacity 500000MB
system>
system> storage -config vol -remove -target vol[0-1]
ok
system>
system> storage -config vol -set -N LD_volume -w 0 -target vol[0-0]
ok
system>
system> storage -list controllers
ctrl[0] ServerRAID M5110e(Slot No. 0)
ctrl[1] ServerRAID M5110f(Slot No. 1)
system>
system> storage -list drives
disk[0-0] Drive 0
disk[0-1] Drive 1
disk[0-2] Drive 2
system>
system> storage -list pools
pool[0-0] Storage Pool 0
pool[0-1] Storage Pool 1
system>
system> storage -list volumes
vol[0-0] Volume 0
vol[0-1] Volume 1
Vol[0-2] Volume 2
system>
system> storage -list drives -target ctrl[0]
disk[0-0] Drive 0
disk[0-1] Drive 1
disk[0-2] Drive 2
system>
system> storage -list drives -target pool[0-0]
disk[0-0] Drive 0
disk[0-1] Drive 1
system>
system> storage -list pools -target ctrl[0]
pool[0-0] Storage Pool 0
system>
system> storage -list volumes -target ctrl[0]
vol[0-0] Volume 0
vol[0-1] Volume 1
system>
system> storage -list volumes -target pool[0-0]
vol[0-0] Volume 0
vol[0-1] Volume 1
system>
system> storage -show ctrl[0] firmware
Total Firmware number: 2
Name: RAID Firmware1
Description: RAID Firmware
Manfacture: IBM
Version: 4.01(3)T
Release Date: 01/05/2013
Name: RAID Firmware2
Description: RAID Firmware
system>
system> storage -show ctrl[0] info
Product Name: ServerRAID M5110e
Firmware Package Version: 23.7.0.1.2
Battery Backup: Installed
Manufacture: IBM
UUID: 1234567890123456
Model Type / Model: 1234AHH
Serial No.: 12345678901
FRU No.: 5005076049CC4
Part No.: LSI2004
Cache Model Status: Unknown
Cache Model Memory Size: 300MB
Cache Model Serial No.: PBKUD0XTA0P04Y
PCI Slot Number: 0
PCI Bus Number: 2
PCI Device Number: 2
PCI Function Number: 10
PCI Device ID: 0x1000
PCI Subsystem Device ID: 0x1413
Ports: 2
Port 1: 12345678901234
Port 2: 12345678901235
Storage Pools: 2
pool[0-0] Storage Pool 0
pool[0-1] Storage Pool 1
Drives: 3
disk[0-0] Drive 0
disk[0-1] Drive 1
disk[0-2] Drive 2
system>
system> storage -show disk[0-0] firmware
Total Firmware number: 1
Name: Drive
Description:
Manufacture:
Version: BE24
Release Date:
system>
system> storage -show disk[0-0] info
Product Name: ST98394893
State: Online
Slot No.: 0
Disk Type: SATA
Media Type: HHD
Health Status: Normal
Capacity: 100.000GB
Speed: 6.0Gb/s
Current Temperature: 33C
Manufacture: ATA
Device ID: 5
Enclusure ID: 0x00FC
Machine Type:
Model:
Serial No.: 9XKJKL
FRU No.:
Part No.:
system>
system> storage -show pool[0-0]
RAID State: RAID 0
RAID Capacity: 67.000GB (0.000GB free)
Drives: 2
disk[0-0] Drive 0
disk[0-1] Drive 1
Volumes: 2
vol[0-0] Volume 0
vol[0-1] Volume 1
system>
system> storage -show pool[0-1] info
RAID State: RAID 1
RAID Capacity: 231.898GB (200.000GB free)
Holes: 2
#1 Free Capacity: 100.000GB
#2 Free Capacity: 100.000GB

Drives: 2
disk[0-1] Drive 1
disk[0-2] Drive 2

Volume: 1
vol[0-1] LD_volume
system>
system> storage -show vol[0-0]
Name: Volume 0
Stripe Size: 64KB
Status: Offline
Capacity: 100.000GB
system>
system> storage -show vol[0-0] info
Name: LD_volume
Status: Optimal
Stripe Size: 64KB
Bootable: Not Bootable
Capacity: 231.898GB
Read Policy: No Read Ahead
Write Policy: Write Through
I/O Policy: Direct I/O
Access Policy: Read Write
Disk Cache Policy: Unchanged
Background Initialization: Enable
system>