PowerEdge: Managing the PowerEdge RAID Controller with PERCCLI

Summary: This article provides information about how to manage the Dell PowerEdge RAID Controller (PERC) using the PERCCLI utility.

This article applies to This article does not apply to This article is not tied to any specific product. Not all product versions are identified in this article.

Instructions

Managing PERC Controllers with PERCCLI

 

Virtual Disk (VD) Management

Control consistency checks, preserved cache, and virtual disks using the commands below:

  • Pause a consistency check
  • Resume a consistency check
  • Show consistency check status
  • Start a consistency check
  • Stop a consistency check
  • Delete preserved cache
  • Show preserved cache
  • Delete a virtual disk
  • Create a virtual disk
# Pause consistency check
perccli /cX/vY pause cc

# Resume consistency check
perccli /cX/vY resume cc

# Show consistency check status
perccli /cX/vY show cc

# Start consistency check (add "force" if required)
perccli /cX/vY start cc [force]

# Stop consistency check
perccli /cX/vY stop cc

# Delete preserved cache (add "force" if required)
perccli /cX/vY delete preservedCache [force]

# Show preserved cache
perccli /cX show preservedCache

# Delete a virtual disk (use "all" to delete all VDs)
perccli /cX/vY|all del

# Create a virtual disk (example)
perccli /cX add vd r5 size=500GB name=VD1 drives=1:0-3 pdperarray=4 pdcache=on wt wb strip=128 force
Caution: Using force may cause data loss. Verify the target drives before running.

 

 

 

Physical Disk Management

Use the following commands to view, configure, locate, and assign hot spares for physical disks.

  • Show drive information
  • Set drive state (JBOD, good, offline, online)
  • Start/stop drive locate LED
  • Add or delete a hot spare drive
  • Manage foreign configurations
# Show a specific drive (controller X, enclosure Y, slot Z)
perccli /cX/eY/sZ show

# Show all drives on a controller
perccli /cX/eall/sall show

# Show all drives with detailed information
perccli /cX/eY/sZ|sall show all

# Show drives in JBOD mode
perccli /cX/eY/sall show jbod
perccli /cX/eY/sZ show jbod

# Set a drive to JBOD
perccli /cX/eY/sZ set jbod

# Set a drive to GOOD (add "force" if required)
perccli /cX/eY/sZ set good [force]

# Set a drive OFFLINE
perccli /cX/eY/sZ set offline

# Set a drive ONLINE
perccli /cX/eY/sZ set online

# Start locate LED on a drive
perccli /cX/eY/sZ start locate

# Stop locate LED on a drive
perccli /cX/eY/sZ stop locate

# Add a hot‑spare drive (optional DG list, enclosure affinity, non‑revertible)
perccli /cX/eY/sZ add hotsparedrive [DGs=0,1,2][enclaffinity][nonrevertible]

# Delete a hot‑spare drive
perccli /cX/eY/sZ delete hotsparedrive

# Delete foreign configuration (add security key if required)
perccli /cX/fx|fall del [securitykey=sssssssssss]

# Import foreign configuration (preview optional)
perccli /cX/fx|fall import [preview][securitykey=sssssssssss]

# Show foreign configuration (add "all" to list all)
perccli /cX/fx|fall show [all][securitykey=sssssssssss]
Warning: Deleting a foreign configuration removes all pending RAID metadata. Ensure that the configuration is no longer needed before proceeding.

 

Option Value range Description
rXX RAID [0|1|5|6|10|50|60] Sets the RAID type of the configuration.
size Maximum size based on the physical drives and RAID level. Sets the size of each virtual drive. Default is the capacity of all referenced disks.
name 15 characters Specifies the drive name for each virtual drive.
drives Valid enclosure number and slot numbers (e:s|e:s-x|e:s-x,y) Defines which physical drives belong to the VD. e = enclosure ID, s = slot.
pdperarray 0‑15 Number of physical drives per array. Default is chosen automatically.
sed Creates security‑enabled drives.
pdcache on|off|default Enables or disables physical‑drive cache.
pi Enables protection information.
dimmerswitch default|automatic|none|maximum|maxnocache Specifies power‑saving policy for the logical device.
wt|wb wt (write‑through) or wb (write‑back) Sets write policy. Write‑back is default.
nora|ra ra (read‑ahead) or nora (no read‑ahead) Controls read‑ahead. Read‑ahead is default.
cachedbadbbu|nocachedbadbbu Enable/disable caching when BBU is faulty. Disabled by default.
strip 8,16,32,64,128,256,512,1024 Sets the strip size for the RAID configuration.
aftervd Valid virtual drive number Creates the VD in the free slot next to the specified VD.
spares List of physical drives Assigns spare drives to the disk group.
force Forces addition of a security‑capable drive without security.

 

 

For installation of PERCCLI refer to: PowerEdge: How to Install PERCCLI utility on Red Hat Linux, Ubuntu Linux, VMware ESXi, and Windows Server

Additional Information

Affected Products

PowerEdge RAID Controller H345, PowerEdge RAID Controller H350 Adapter SAS, PowerEdge RAID Controller H355 Front SAS, PowerEdge RAID Controller H355 Adapter SAS, PowerEdge RAID Controller H365i Adapter, PowerEdge RAID Controller H365i Front DC-MHS , PowerEdge RAID Controller H730P MX, PowerEdge RAID Controller H745, PowerEdge RAID Controller H745P MX, PowerEdge RAID Controller H750 Adapter SAS, PowerEdge RAID Controller H755 Adapter, PowerEdge RAID Controller H755 MX Adapter, PowerEdge RAID Controller H755N Front NVMe, PowerEdge RAID Controller H755 Front SAS, PowerEdge RAID Controller H965i Adapter, PowerEdge RAID Controller H965i Front, PowerEdge RAID Controller H965i MX, PowerEdge RAID Controller H975i Front, PowerEdge RAID Controller H330, PowerEdge RAID Controller H730, PowerEdge RAID Controller H730P, PowerEdge RAID Controller H740P, PowerEdge RAID Controller H965e Adapter ...
Article Properties
Article Number: 000394815
Article Type: How To
Last Modified: 18 Mar 2026
Version:  2
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.