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

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


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 will allow 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.
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. Aditional 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:

    PERCCLI commands require Administrative rights in Windows operating systems

    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 logfile=log.txt
    /cx specifies the controller where x is the controller index

    Creates the RAID controller log (ttylog)

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

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

    perccli /cx show eventloginfo > eventloginfo.txt

    Creates the 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:

    PERCCLI commands require root priviledges in Linux

    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 logfile=log.txt
    /cx specifies the controller where x is the controller index

    Creates the RAID controller log (ttylog)

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

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

    ./perccli /cx show eventloginfo > eventloginfo.txt

    Creates the 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:

    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 logfile=log.txt
    /cx specifies the controller where x is the controller index

    Creates the RAID controller log (ttylog)

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

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

    ./perccli /cx show eventloginfo > eventloginfo.txt

    Creates the 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 supported by that controller. For your PERC adapter documentation, access Storage Adapters & Controllers, select your specific storage controller, and click on 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



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

Visit and ask for support in our Communities

Create an online support Request



Article ID: SLN283135

Last Date Modified: 10/14/2019 01:18 PM


Rate this article

Accurate
Useful
Easy to understand
Was this article helpful?
Yes No
Send us feedback
Comments cannot contain these special characters: <>()\
Sorry, our feedback system is currently down. Please try again later.

Thank you for your feedback.