Synopsis
|
Inventory
NOTE:You can also run the command using
raid in place of the
storage command.
- To view the help details for get command, run the following command:
racadm storage help get
- To generate and view information about the inventory of storage root node, run the following command:
racadm storage get status
- To generate and view information about the inventory of controllers, run the following command:
racadm storage get controllers -o
racadm storage get controllers -o -p <property names separated by comma>
- To get the list of controllers, run the following command:
racadm storage get controllers
- To get the properties of a controller, run the following command:
racadm storage get controllers:<Controller FQDD>
NOTE:HBA, BOSS and PERC controllers connected through slimline cable will have FQDDs starting with
SL. Example -
NonRaid.SL.5-1,
AHCI.SL.5-1,
RAID.SL.5-1 and so on.
- To generate and view information about the inventory of batteries, run the following command:
racadm storage get batteries -o
racadm storage get batteries --refkey <Controller FQDDs separated by comma>
racadm storage get batteries --refkey <Controller FQDDs separated by comma> -o
racadm storage get batteries --refkey <Controller FQDDs separated by comma> -o -p <property names separated by comma>
- To generate and view information about the inventory of virtual disks, run the following command:
racadm storage get vdisks
racadm storage get vdisks --refkey <Controller FQDDs separated by comma>
racadm storage get vdisks --refkey <Controller FQDDs separated by comma> -o
racadm storage get vdisks --refkey <Controller FQDDs separated by comma> -o -p <property names separated by comma>
- To generate and view information about the inventory of enclosures, run the following command:
NOTE:FQDD of certain Backplanes may not be the same in Software Inventory and Hardware Inventory.
racadm storage get enclosures -o
racadm storage get enclosures --refkey <Connector FQDDs separated by comma>
racadm storage get enclosures --refkey <Connector FQDDs separated by comma> -o -p <property names separated by comma>
- To get the list of enclosures, run the following command:
racadm storage get enclosures
- To get the properties of an enclosure, run the following command:
racadm storage get enclosures:<Enclosure FQDD>
- To generate and view information about the inventory of physical disk drives, run the following command:
racadm storage get pdisks
racadm storage get pdisks -o
racadm storage get pdisks -o -p <property names separated by comma>
racadm storage get pdisks --refkey <Enclosure/Backplanes FQDDs separated by comma>
racadm storage get pdisks --refkey <Enclosure/Backplanes FQDDs separated by comma> -o
racadm storage get pdisks --refkey <Enclosure/Backplanes FQDDs separated by comma> -o -p <property names separated by comma>
-
To get the list of physical disks, run the following command:
racadm storage get pdisks
-
To get the properties of a physical disk, run the following command:
racadm storage get pdisks:<PD FQDD>
- To get a list of physical disks in a virtual disk, run the following command:
racadm storage get pdisks -vdkey:<VD FQDD>
- To generate and view information about the inventory of fans, run the following command:
racadm storage get fans --refkey <Enclosure FQDDs separated by comma>
racadm storage get fans --refkey <Enclosure FQDDs separated by comma > -o
racadm storage get fans --refkey <Enclosure FQDDs separated by comma> -o -p <property names separated by comma>
- To generate and view information about the inventory of EMMs, run the following command:
racadm storage get emms -refkey <Enclosure FQDDs separated by comma>
racadm storage get emms --refkey <Enclosure FQDDs separated by comma> -o
racadm storage get emms --refkey <Enclosure FQDDs separated by comma> -o -p <property names separated by comma>
- To generate and view information about the inventory of PSU, run the following command:
racadm storage get psus -refkey <Enclosure FQDDs separated by comma>
racadm storage get psus --refkey <Enclosure FQDDs separated by comma> -o
racadm storage get psus --refkey <Enclosure FQDDs separated by comma> -o -p <property names separated by comma>
Configuration
NOTE: For any storage operation executed, creating a configuration job is needed for the operation to be applied. Only storage operations that don't need a configuration job to apply the changes are blink/unblink. Also supported is the ability to stack multiple storage operations for one configuration job. Examples are
execute reset config,
create VD,
assign hotspare and
create configuration job. For more details on creating configuration job, refer to
jobqueue help create command".
Below are the supported input options for storage operations:
-
--refkey—Specifies the controller or enclosure FQDDs.
-
-name—Specifies the new name for the virtual disk.
NOTE:You can use alphanumeric characters, spaces, dashes, and underscores in the disk name. Any other special character that you enter is removed and replaced by a space while creating a virtual disk.
-
-size—Specifies the new size for the virtual disk. It should be more than the current size.
- b—Specifies the size in bytes
- k—Specifies the size in kilobytes
- m—Specifies the size in megabytes
- g—Specifies the size in gigabytes
- t—Specifies the size in terabytes
- -rl—Sets the storage level.
- r0—storage 0-Striping
- r1—storage 1-Mirroring
- r5—storage 5-Striping with Parity
- r6—storage 6-Striping with Extra Parity
- r10—storage 10-Spanned Striping with Mirroring
- r50—storage 50-Spanned Striping with Parity
- r60—storage 60-Spanned Striping with Extra Parity
-
-new_rl—Specifies the new possible raid level for the virtual disk
- r0—RAID0
- r1—RAID1
- r5—RAID5
- r6—RAID6
NOTE: This is a mandatory option must provide with RLM operation. Possible raid migrations with disk addition are R0-R1, R0-R5/R6,R1-R0/R5/R6, R5-R0/R6, R6-R0/R5. Possible raid migrations without disk addition are R1-R0, R5-R0, R6-R0/R5.
- -wp{wt|wb|wbf}—Sets the write policy to Write Through, Write Back, or Write Back Force
- -rp {nra|ra|ara}—Sets the read policy to No Read Ahead, Read Ahead, Adaptive Read Ahead
- -ss—Specifies the stripe size to use.
- -pdkey:<PD FQDD list>—Specifies the physical disk drive to use in the virtual disk.
- -dcp—Sets the Disk Cache Policy in the Virtual Disk.
- enabled—Allows the virtual disk to use the cache.
- disabled—Does not allow the virtual disk to use the cache.
- default—Uses the default cache policy. For SAS drives, use the
disabled option and for SATA drives, use the
enabled option by default.
- -name <VD name>—Specifies the name of the virtual disk.
- -size <VD size>—Specifies the size of each virtual disk.
- b—Specifies the size in bytes
- k—Specifies the size in kilobytes
- m—Specifies the size in megabytes
- g—Specifies the size in gigabytes
- t—Specifies the size in terabytes
- -sc—Number of spans in a virtual disk (required for multi-span RAID level)
NOTE:
- From PERC9 storage controller onwards, if the value of
controller.SupportRAID10UnevenSpans is
supported, you can enter only
0 for this option while creating RAID level 10. The created RAID10 virtual disk displays the spandepth as
1 (default).
- For other controllers:
- The default value for multi-span RAID levels is 2 and for basic RAID level is 1.
- For hybrid RAID levels such as RAID10, RAID50, and RAID60, this option is mandatory.
- The value for-sc option can be 0 only for RAID10.
- -T10PIEnable—Creates a virtual disk with protection information.
- -sd <SecureDisk>—Set the secure disk to encrypt the VD.
- enabled—Enable the encryption in VD.
- disabled—Disable the encryption in VD.
- -key <Key id>—Specifies the key id.
- -passwd <passphrase>—Specifies the passphrase.
- -newpasswd <passphrase>—Specifies the new passphrase.
- -assign {yes | no}—Assigns or unassigns the disk as a hotspare.
- -type { ghs | dhs}—Assigns a global or dedicated hotspare.
- -vdkey:<VD FQDD>—Assigns the dedicated hotspare to the specified virtual disk. This option is required for dedicated hotspare.
- -state <start|stop>—start value starts a patrol read operation.
stop value stops a running patrol read operation.
NOTE:
- To start the operation, the Controller.PatrolReadMode must be in
Manual mode.
- The values displayed for properties such as
Patrol Read,
Check Consistency Rate,
Rebuild Rate,
BGI Rate, and
Reconstruction Rate are displayed in percentage.
-
-speed—Specifies the initialization of the Virtual disk.
- blink: <FQDD> or
unblink: <FQDD>—<FQDD> can be physical disk drives, virtual disks, or PCIeSSD.
- <PCIeSSD FQDD>—Specifies the PCIeSSD FQDD.
- <PCIeSSD controller|enclosure FQDD>—Specifies the PCIeSSD controller or enclosure FQDD.
-
preparetoremove—Specifies the PCIeSSD drive to prepare for removal.
NOTE:Ensure that ISM is installed and running to perform the
preparetoremove operation.
- cryptographicerase—Specifies the PCIeSSD, SED (Self encrypting drive) or ISE device to perform the cryptographic erase operation.
NOTE:If running this operation on an ISE or SED device, it must not be a part of a RAID volume. If the device is part of a RAID volume, delete the volume first and then run
cryptographicerase.
- -mdtype { windows | linux}—Specifies the metadata type for the physical disk conversion to RAID
NOTE: SWRAID only supports mdtype.
- -mode—Specifies the PERC key management type.
- To view the help details for a configuration command, run the following command:
racadm storage help <command>
where command can take below values
converttoraid, converttononraid, controllers, clearconfig, createsecuritykey, createvd, deletesecuritykey,
deletevd, encryptvd, enclosures, emms, fans, hotspare, importconfig, ccheck, cryptographicerase, preparetoremove, blink, unblink, cancelcheck, renamevd, cancelbgi, rebuild, cancelrebuild, capacityexpanon, raidlevelmigrationinit, modifysecuritykey, psus, pdisks, resetconfig, tempprobes, vdisks, patrolread, forceonline,
forceoffline,replacephysicaldisk,unlock,and setbootvd.
NOTE: iSM must be running on the operating system to run the preparetoremove method:
- To create, delete, and secure the virtual disks, to start or stop the consistency check on the specified virtual disk, run the following command:
racadm storage createvd:<Controller FQDD> -rl {r0|r1|r5|r6|r10|r50|r60}[-wp {wt|wb|wbf}] [-rp {nra|ra|ara}] [-ss {1k|2k|4k|8k|16k|32k|64k|128k|256k|512k|1M|2M|4M|8M|16M}]-pdkey:<comma separated PD FQDD> [-dcp {enabled|disabled|default}] [-name <VD name>] [-size <VD size>{b|k|m|g|t}] [-T10PIEnable] [-sd <secureDisk>]
NOTE:
- T10PI is no longer supported on PERC controllers.
- If the
<VD name> exceeds 15 characters when running the
createvd command, it gets corrected to a length of 15 characters once the command is completed successfully.
racadm storage init:<VD FQDD> -speed {fast|full}
racadm storage deletevd:<VD FQDD>
racadm storage encryptvd:<VD FQDD>
racadm storage createsecuritykey:<Controller FQDD> -key <Key id> -xxx <passphrase>
racadm storage modifysecuritykey:<Controller FQDD> -key <Key id>-xxx <old passphrase> -xxx <new passphrase>
racadm storage deletesecuritykey:<Controller FQDD>
racadm storage ccheck:<VD FQDD>
racadm storage cancelcheck:<VD FQDD>
- To set virtual disk as bootvd and replace physical disk in virtual disk:
racadm storage setbootvd:<Controller FQDD> -vd <VD FQDD >
racadm storage replacephysicaldisk:<Source PD FQDD > -dstpd <Destination PD FQDD>
-
To rename, expansion and raid level migration of the virtual disks and, to rebuild, cancel rebuild and cancel the back-ground initialization, run the following command:
racadm storage renamevd:<VD FQDD > -name <new_vd_name>
racadm storage capacityexpansion:<VD FQDD > -size <new size VD> -pdkey <PD FQDDs>
racadm storage capacityexpansion:<VD FQDD> -size <new size>.
racadm storage discardcache:<Controller FQDD>
racadm storage raidlevelmigration:<VD FQDD > -new_rl <raid_level> -pdkey:<PD FQDD separated by commas>
racadm storage rebuild:<PD FQDD>
racadm storage cancelrebuild:<PD FQDD>
racadm storage cancelbgi:<VD FQDD>
- To convert the physical disk drives and assign or delete a hotspare. To scan physical disks that are connected to a controller and detect problem, run the following command:
racadm storage converttononraid:<PD FQDD>
racadm storage converttoraid:<PD FQDD>
-mdtype <metadataType>
NOTE: Convert to RAID or Non RAID is not supported on PERC 10 (RAID mode) and BOSS controller cards. PERC10 in eHBA mode supports convert to RAID or Non-RAID.
NOTE:-mdtype is only supported for SWRAID controllers.
racadm storage hotspare:<PD FQDD> -assign yes -type dhs -vdkey: <VD FQDD>
racadm storage hotspare:<PD FQDD> -assign yes –type ghs
racadm storage hotspare:<PD FQDD> -assign no
racadm storage patrolread:<Controller FQDD> -state start|stop
NOTE:If the
–assign option is
no, you cannot add other options. If the
–assign option is
yes and if the
-type option is not present, the global hotspare (ghs) is created by default.
- To reset, clear, and import the storage configuration to the controller, run the following command:
racadm storage importconfig:<Controller FQDD>
racadm storage resetconfig:<Controller FQDD>
racadm storage clearconfig:<Controller FQDD>
- To unlock foreign configuration:
racadm storage unlock:<Controller FQDD> -key <Key id> -passwd <passphrase>
- To start or stop a blink or identify operation on the specified storage device, run the following command:
racadm storage blink:<FQDD>
racadm storage blink:<PCIeSSD FQDD>
racadm storage unblink:<FQDD>
racadm storage unblink:<PCIeSSD FQDD>
NOTE:
- The start or stop a blink feature is not supported for HHHL PCIe SSD devices.
- BOSS-S2 controllers support blink and unblink feature on M.2 drives.
- To force a physical disk online, offline
racadm storage forceonline:<PD FQDD>
racadm storage forceoffline:<PD FQDD>
NOTE:Forcing a physical drive offline or online may result in loss of data. For more information, see the latest
PERC User's Guide.
- To prepare the PCIeSSD drive for removal:
racadm storage preparetoremove <PCIeSSD FQDD>
NOTE:The Prepare to Remove task is not supported for HHHL PCIe SSD devices.
- To perform a cryptographic erase operation on PCIeSSD device, run the following command:
racadm storage cryptographicerase:<PCIeSSD FQDD>
- To set the encryption mode to Secure Enterprise Key Manager (SEKM) for the PERC controller:
racadm storage setencryptionmode:<Controller FQDD> -mode <KEY Management Mode>
NOTE:You need to enable SEKM on iDRAC before enabling SEKM on the PERC controller.
- To request iDRAC to rekey all devices:
racadm storage rekey:<Controller FQDD>
|