PowerEdge: How to Use the PowerEdge Expandable RAID Controller Command-Line Interface Utility

Summary: This article explains how to download, install, and use the Dell PowerEdge RAID Controller (PERC) Command-Line Interface (CLI) utility to manage your RAID controller. The utility is supported on PERC Series 8 and later family controllers on hosts running Windows, Linux, or ESXi. PERCCLI can also extract RAID controller logs which contain information that allows you or Dell Technical Support to determine the status of RAID controllers and the connected storage devices to narrow down possible sources of error. ...

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.
Check out other resources

Instructions

Note: PERCCLI has replaced Mega-CLI starting with the PERC Series 8 and later series. See the article PowerEdge: List of PowerEdge RAID Controller types for Dell systems to identify which series is your PERC controller.
 

Access the PERCCLI in Microsoft Windows, Linux, or VMware:

Installing and using PERCCLI in Windows operating systems

Video for using PERCCLI in Windows
The videos are in English, more videos can be found in our Video Library.

Using PERCCLI in Windows

Duration: 00:01:55 (hh:mm:ss)
When available, closed caption (subtitles) language settings can be chosen using the CC icon on this video player.

Perform the following procedures to install and use PERCCLI in Windows operating systems:

  1. Download the Windows PERCCLI utility from the Dell support site. Select your system, then Drivers & Downloads filtering by category SAS RAID or by using the keyword PERCCLI

  2. Extract the self-extracting downloaded file, and copy the perccli.exe and perccli64.exe files to C:\Windows\System32 directory

  3. From the command prompt, run any of the following example PERCCLI commands:

    Note: PERCCLI commands require Administrative rights in Windows operating systems.
    Note: Depending upon the version of OS and perccli, the executable may be perccli or perccli64.
     

    Command

    Action

    		 
    perccli show

     This shows a summary of controller and controller-associated information. The summary includes the number of controllers by index.

    		 
    perccli /cx show termlog

/cX specifies the controller where X is the controller index

Example: 
If the controller index was 0 the command would be
"perccli /c0 show termlog"

     Creates the RAID controller log (ttylog)

    		 
    perccli /cX /eall /sall show all > disks.txt

/cX specifies the controller where X is the controller index

Example: perccli /c0 /eall /sall show all > disks.txt

     Creates the RAID controller log with all information for all slots on the controller

    		 
    perccli /cX show eventloginfo > eventloginfo.txt

/cX specifies the controller where X is the controller index

Example: perccli /c0 show eventloginfo > eventloginfo.txt

     Creates the RAID controller log with history of the log files


Installing and using PERCCLI commands in Linux

Perform the following procedures to install and use the PERCCLI in Linux operating systems:

  1. Download the Linux PERCCLI utility from the Dell support site. Select your system, then Drivers & Downloads filtering by category SAS RAID or by using the keyword PERCCLI

  2. To install the percli RPM, run rpm -ivh <percli-x.xx-x.noarch.rpm>, or to upgrade the percli RPM, run rpm -Uvh <percli-x.xx-x.noarch.rpm>.
  3. Change the directory to /opt/MegaRAID/perccli.
  4. As a root user, run ./perccli.

  5. From the terminal window, run any of the following example PERCCLI commands:

    Note: PERCCLI commands require root privileges in Linux.

       

    Note: Depending upon the version of OS and perccli, the executable may be perccli or perccli64.
     

    Command

    Action

    		 
    ./perccli show

     This shows a summary of controller and controller-associated information. The summary includes the number of controllers by index.

    		 
    ./perccli /cX show termlog 

/cX specifies the controller where X is the controller index

Example:
If the controller index was 0 the command would be
"./perccli /c0 show termlog"

     Creates the RAID controller log (ttylog)

    		 
    ./perccli /cX /eall /sall show all > disks.txt

/cX specifies the controller where X is the controller index

Example: ./perccli /c0 /eall /sall show all > disks.txt

     Creates the RAID controller log with all information for all slots on the controller

    		 
    ./perccli /cX show eventloginfo > eventloginfo.txt

/cX specifies the controller where X is the controller index

Example: ./perccli /c0 show eventloginfo > eventloginfo.txt

     Creates the RAID controller log with history of the log files

 

Installing and using the PERCCLI in VMware ESXi

Perform the following procedures to access the command prompt in systems using VMware:

  1. Download the VMware PERCCLI utility from the Dell support site. Select your system, then Drivers & Downloads filtering by category SAS RAID or by using the keyword PERCCLI

  2. Extract the VMware_PERCCLI_xxxxx_x.x-xxx.xxxx.tar.gz to /vmfs/volume/datastore1 on the host

  3. View the list of installed VIB packages using the following command: esxcli software vib list

  4. Install the VIB package using the command: esxcli software vib install -v /vmfs/volume/datastore1/vmware-perccli-xxx.xxxx.xxxx.xxxx.vib --no-sig-check where /vmfs/volume/datastore1 is the path detail of the VIB.

  5. You can remove the installed VIB by using the command: esxcli software vib remove -n=vmware-esx-perccli.vib --force

  6. Run perccli by browsing to the following location: cd/opt/lsi/perccli

  7. From the terminal window, run any of the following example PERCCLI commands:
       

    Note: Depending upon the version of OS and perccli, the executable may be perccli or perccli64.

     

    Command

    Action

    		 
    ./perccli show

     This shows a summary of controller and controller-associated information. The summary includes the number of controllers by index.

    		 
    ./perccli /cX show show termlog logfile=log.txt

/cX specifies the controller where X is the controller index

Example: ./perccli /c0 show termlog logfile=log.txt

     Creates the RAID controller log (ttylog)

    		 
    ./perccli /cX /eall /sall show all > disks.txt

/cX specifies the controller where X is the controller index

Example: ./perccli /c0 /eall /sall show all > disks.txt

     Creates the RAID controller log with all information for all slots on the controller

    		 
    ./perccli /cX show eventloginfo > eventloginfo.txt

/cX specifies the controller where X is the controller index

Example: ./perccli /c0 show eventloginfo > eventloginfo.txt

     Creates the RAID controller log with history of the log files

List of available PERC commands

See your PERC User's Guide or CLI Reference Guide for information about the specific commands that the controller supports. For PERC adapter documentation, go to Storage Adapters and Controllers, select your specific storage controller, and click the Documentation tab and then Manuals and Documents section.

In each manual, command lines are listed by category, for example:

Standard

  • System commands (Including Show)
  • Controller commands
  • Drive commands
  • Virtual drives commands
  • Foreign configurations commands

More

  • BIOS-related commands
  • Drive group commands
  • Dimmer switch commands
  • BBU commands
  • Enclosure commands
  • PHY commands
  • Logging commands
  • PERC CLI command examples

Additional Information

Install PERCCLI on Red Hat, Ubuntu, ESXi, and Windows.

Duration: 00:08:24 (hh:mm:ss)
When available, closed caption (subtitles) language settings can be chosen using the CC icon on this video player.

Affected Products

Microsoft Windows Server 2016, SUSE Linux Enterprise Server 11, SUSE Linux Enterprise Server 12, OEMR R740xd, OEMR R740xd2, PowerEdge RAID Controller H730P MX, PowerEdge RAID Controller H745P MX, PowerEdge C4130, Poweredge C4140, PowerEdge c6320 , PowerEdge c6320p, PowerEdge C6420, Poweredge FC430, Poweredge FC630, PowerEdge FC640, PowerEdge FD332, PowerEdge M420, PowerEdge M520, PowerEdge M620, PowerEdge M620 (for PE VRTX), PowerEdge M630, PowerEdge M630 (for PE VRTX), PowerEdge M640, PowerEdge M640 (for PE VRTX), PowerEdge M820, PowerEdge M820 (for PE VRTX), PowerEdge M830, PowerEdge M830 (for PE VRTX), PowerEdge MX740C, PowerEdge MX840C, PowerEdge R220, PowerEdge R230, PowerEdge R240, PowerEdge R250, PowerEdge R260, PowerEdge R320, PowerEdge R330, PowerEdge R350, PowerEdge R360, PowerEdge R420, PowerEdge R430, PowerEdge R440, PowerEdge R450, PowerEdge R520, PowerEdge R530, PowerEdge R530xd, PowerEdge R540, PowerEdge R550, PowerEdge R620, PowerEdge R630, PowerEdge R640, PowerEdge R6415, PowerEdge R650, PowerEdge R650xs, PowerEdge R6515, PowerEdge R6525, PowerEdge R660, PowerEdge R660xs, PowerEdge R6615, PowerEdge R6625, PowerEdge R670, PowerEdge R720, PowerEdge R720XD, PowerEdge R730, PowerEdge R730xd, PowerEdge R740, PowerEdge R740XD, PowerEdge R740XD2, PowerEdge R7415, PowerEdge R7425, PowerEdge R750, PowerEdge R750XA, PowerEdge R750xs, PowerEdge R7515, PowerEdge R7525, PowerEdge R760, PowerEdge R760XA, PowerEdge R760xd2, PowerEdge R760xs, PowerEdge R7615, PowerEdge R7625, PowerEdge R770, PowerEdge R820, PowerEdge R830, PowerEdge R840, PowerEdge R860, PowerEdge R920, PowerEdge R930, PowerEdge R940, PowerEdge R940xa, PowerEdge R960, PowerEdge RAID Controller H310, PowerEdge RAID Controller H330, PowerEdge RAID Controller H710, PowerEdge RAID Controller H710P, PowerEdge RAID Controller H730, PowerEdge RAID Controller H730P, PowerEdge RAID Controller H740P, PowerEdge RAID Controller H810, PowerEdge RAID Controller H830, PowerEdge RAID Controller H840, PowerEdge T130, PowerEdge T140, PowerEdge T150, PowerEdge T160, PowerEdge T320, PowerEdge T330, PowerEdge T340, PowerEdge T350, PowerEdge T360, PowerEdge T420, PowerEdge T430, PowerEdge T440, PowerEdge T550, PowerEdge T620, PowerEdge T630, PowerEdge T640, Red Hat Enterprise Linux Version 7, Red Hat Enterprise Linux Version 9, Red Hat Enterprise Linux Version 8 ...

Products

Microsoft Windows Server 2019, Microsoft Windows Server 2022, 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 H745, 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 C6520, PowerEdge C6525, PowerEdge C6615, PowerEdge C6620, PowerEdge R340, PowerEdge RAID Controller H965e Adapter, PowerEdge T560, PowerEdge XE2420, PowerEdge XE7420, PowerEdge XE7440, PowerEdge XE8640, PowerEdge XE9640, PowerEdge XE9680 ...
Article Properties
Article Number: 000177280
Article Type: How To
Last Modified: 22 Nov 2024
Version:  14
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.