How to use the PowerEdge RAID Controller (PERC) Command Line Interface (CLI) utility to manage your RAID controller

Summary: How to download, install and use the Dell EMC PowerEdge RAID Controller (PERC) Command Line Interface (CLI) utility to manage your RAID controller on Dell EMC systems.

Article Content


Symptoms

This article explains how to download, install, and use the Dell EMC PowerEdge RAID Controller (PERC) Command Line Interface (CLI) utility to manage your RAID controller. The utility is supported on PERC Series 8 and newer family controllers on host running Windows, Linux, or ESXi. PERCCLI can also extract RAID controller logs which contain information that allows you and/or Dell Technical Support to determine the status of RAID controllers and the connected storage devices to narrow down possible sources of error.
 
SLN283135_en_US__1icon PERCCLI has replaced MegaCli starting with the PERC Series 8 and newer series. See the List of PERC types for Dell EMC systems to identify which series is your PERC controller.

Access the PERCCLI in Microsoft Windows, Linux, or VMware:
 
Video for using PERCCLI in Windows
Videos are in English. Translated subtitles available for some languages. Additional videos can be found in our Video Library.

 

Perform the following procedures to install and use PERCCLI in Windows operating systems:
  1. Download the Windows PERCCLI utility from Dell support site. Select your system, then Drivers & downloads filtering by category SAS RAID or by using the keyword PERCCLI

  2. Unzip 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:

    SLN283135_en_US__1icon PERCCLI commands require Administrative rights in Windows operating systems

       

    SLN283135_en_US__1icon Depending upon version of OS and perccli, executable may be perccli or perccli64
     

    Command

    Action

    perccli show

    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

Perform the following procedures to install and use the PERCCLI in Linux operating systems:
  1. Download the Linux PERCCLI utility from 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 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:

    SLN283135_en_US__1icon PERCCLI commands require root privileges in Linux

       

    SLN283135_en_US__1icon Depending upon version of OS and perccli, executable may be perccli or perccli64
     

    Command

    Action

    ./perccli show

    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

Perform the following procedures to access the command prompt in systems using VMware:
  1. Download the VMware PERCCLI utility from 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:
       

    SLN283135_en_US__1icon Depending upon version of OS and perccli, executable may be perccli or perccli64

     

    Command

    Action

    ./perccli show

    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 on the specific commands that are supported by that controller. For your PERC adapter documentation, access Storage Adapters & 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
 

Additional

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

Cause

 

Resolution

 
Need more help?  
SLN283135_en_US__7cloud Find additional PowerEdge and PowerVault articles
Watch Part Replacement Videos for Enterprise products
   
SLN283135_en_US__8chat

Visit and ask for support in our Communities

   
SLN283135_en_US__9key

Create an online support Request

Article Properties


Affected Product

Servers, PowerEdge, PowerVault, Microsoft Windows Server 2016, Microsoft Windows 2008 Server R2, Microsoft Windows 2012 Server, Microsoft Windows 2012 Server R2, SUSE Linux Enterprise Server 11, SUSE Linux Enterprise Server 12, OEMR R740xdServers, PowerEdge, PowerVault, Microsoft Windows Server 2016, Microsoft Windows 2008 Server R2, Microsoft Windows 2012 Server, Microsoft Windows 2012 Server R2, 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 R320, PowerEdge R330, PowerEdge R420, PowerEdge R430, PowerEdge R440, PowerEdge R520, PowerEdge R530, PowerEdge R530xd, PowerEdge R540, PowerEdge R620, PowerEdge R630, PowerEdge R640, PowerEdge R6415, PowerEdge R6515, PowerEdge R720, PowerEdge R720xd, PowerEdge R730, PowerEdge R730xd, PowerEdge R740, PowerEdge R740xd, PowerEdge R7415, PowerEdge R7425, PowerEdge R7515, PowerEdge R820, PowerEdge R830, PowerEdge R920, PowerEdge R930, PowerEdge R940, PowerEdge R940xa, 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 T320, PowerEdge T330, PowerEdge T420, PowerEdge T430, PowerEdge T440, PowerEdge T620, PowerEdge T630, PowerEdge T640, Red Hat Enterprise Linux Version 5, Red Hat Enterprise Linux Version 6, Red Hat Enterprise Linux Version 7See more

Last Published Date

25 Jun 2021

Version

5

Article Type

Solution

Rate This Article


Accurate
Useful
Easy to Understand
Was this article helpful?

0/3000 characters