From 52684081eff6bfb5531805e2df43fe0aeed2f6ca Mon Sep 17 00:00:00 2001 From: Brice Waegeneire Date: Wed, 13 Dec 2023 13:38:44 +0100 Subject: [PATCH] Ajout PERCCLI --- HowtoPerccli.md | 217 ++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 217 insertions(+) create mode 100644 HowtoPerccli.md diff --git a/HowtoPerccli.md b/HowtoPerccli.md new file mode 100644 index 00000000..80ef0c31 --- /dev/null +++ b/HowtoPerccli.md @@ -0,0 +1,217 @@ +- Documentation : [https://www.dell.com/support/kbdoc/en-uk/000177280/how-to-use-the-poweredge-raid-controller-perc-command-line-interface-cli-utility-to-manage-your-raid-controller]() +- Status de cette page : unstable / bullseye + +[PERCCLI](https://www.dell.com/support/kbdoc/en-uk/000177280/how-to-use-the-poweredge-raid-controller-perc-command-line-interface-cli-utility-to-manage-your-raid-controller) est un utilitaire en ligne de commande permettant de gérer les controleurs RAID de Dell. + +Dans notre usage PECCLI remplace [MegaCLI](InfosMegaCLI). PEERCLI est en réalité un rebranding du logiciel [StorCLI](https://docs.broadcom.com/doc/12352476) édité par Broadcom. + +# Installation + +On télécharge `perccli` et on l'installe dans `/usr/local/sbin/perccli` : + +~~~(sh) +# curl -A notcurl -OL https://dl.dell.com/FOLDER09770976M/1/PERCCLI_7.2313.0_A14_Linux.tar.gz +# bsdtar -xOf PERCCLI_7.2313.0_A14_Linux.tar.gz PERCCLI_7.2313.0_A14_Linux/perccli-007.2313.0000.0000-1.noarch.rpm | + bsdtar -C /usr/local/sbin/ -'s|\./opt/MegaRAID/perccli/perccli64|perccli|' -xf- ./opt/MegaRAID/perccli/perccli64 +~~~ + +# Explications + +## Syntaxe de la ligne de commande + +La commande `perccli` permet d'agir sur différent éléments des cartes RAID. Ci dessous se trouve la liste des premiers arguments supporté par la commande associé à leurs éléments, `X` correspond à l'index (commencant à 0) de cet élément : + +- `/cX` : un controleur +- `/eX` : un ¿berceau? (*enclosure*) +- `/sX` : un emplacement (*slot*) +- `/vX` : un disque virtuel +- `/dX` : un groupe de disques +- `/fall` : la configuration externe (*foreign configuration*) +- `/pX` : un disque physique +- `/lnX` : une ligne (*Lane*) +- `/bbu` : la batterie (*battery backup unit*) +- `/cv` : le cache (*cache vault*) + +Par exemple pour avoir l'état du premier controleur (son index est donc 0) il faut faire `perccli /c0 show`. + +Pour avoir une sortie en JSON d'une commande il suffit de la sufixer avec l'argument `J`. Par exemple pour avoir l'état du la batterie du premier controleur en JSON il faut executer `perccli /c0/bbu show J`. + +## Abréviations de la sortie standard + +De nombreuses abréviations sont utilisées dans la sortie standard, en voici une **liste non exhaustive** : + +- ASOs : Advanced Software Options +- AWB : Always WriteBack +- AftrLD : Identify Freespace After LD +- AftrVD : Identify Freespace After VD +- Alms : Alarm count +- Arr : Array Index +- B : Blocked +- BBU : Battery backup unit/CV +- BT : Background Task Active +- C : Cached IO +- CBShld : Copyback Shielded +- CFShld : Configured shielded +- CO : Cache Offload +- CR : CacheCade(Read) +- CW : CacheCade(Read/Write) +- Cac : CacheCade +- CertProv : Certificate Provision mode +- Chrg : Charging +- Cl : Cluster +- Cmp : Compatible Profile +- Consist : Consistent +- Cpybck : CopyBack +- Ctl : Controller Index +- Curr : Current Profile +- DG : Drive Group +- DGs : Drive groups +- DHS : Dedicated Hot Spare +- DID : Device ID +- DNOpt : Array NotOptimal +- DS3 : Dimmer Switch 3 +- DS : DimmerSwitch +- Dflt : Default Profile +- Dgd : Degraded +- Dgrd : Degraded +- EHS : Emergency Spare Drive +- EID : Enclosure Device ID +- F : Foreign +- FC : Flush Commands +- FP : Fast Path +- FSpace : Free Space Present +- FUA : Force Unit Access +- Fld : Failed +- FreSpc : Freespace available before expansion +- Frgn : Foreign +- GHS : Global Hotspare +- HA : High Availability +- HD : Hidden +- HSPShld : Hotspare shielded +- Hlth : Health +- IOPs : IO per second +- InDwdCnt : Invalid Dword Count +- Intf : Interface +- InvalDwdCnt : Invalid Dword count +- LosOfDwrdSynCnt : Loss of Dword synchronization count +- LsDwSyCnt : Loss of Dword system Count +- MD : Max Disks +- MaxAHCIDev : Maximum AHCI Devices +- MaxLD : Maximum Logical Drives +- MaxPCIeDev : Maximum PCIe Devices +- MaxPhyDrv : Maximum Physical Drives +- Med : Media Type +- Msng : Missing +- MsngCbl : Cable Failure +- MsngCbl : Missing Cable +- N : No +- NR : No Read Ahead +- NdAtn : Need Attention +- NoArrExp : Without Array Expansion +- OCE : Online Capacity Expansion +- OfLn : OffLine +- Offln : Offline +- Onln : Online +- Opt : Optimal +- Optl : Optimal +- Optm : Optimal Profile +- PD : Physical drive count +- PDC : Drive Cache +- PDC : PD Cache +- PDs : Physical drives +- PI : Protection Info +- PNO : Phy Number +- PS : Power Supply Count +- Pdgd : Partially degraded +- Pend : Pending Profile +- PhyNo : Phy Number +- PhyResetPrbCnt : Phy reset problem count +- ProdID : Product ID +- ProfID : Profile ID +- R : Read Ahead Always +- RC : Read Commands +- RF : Reduced Feature Set +- RO : Read Only +- RW : Read Write +- Rbld : Rebuild +- Re : Recovery +- Read RT : Average Read Response Time +- Rec : Recovery +- RepInProg : Repair in progress +- RnDiErCnt : Running Disparity Error Count +- Row : Row Index +- RungDispartyErrCnt : Running Disparity error count +- SED : Self Encrypting Drive +- SIM : SIM Count +- SR : Sectors Read +- SS : Safe Store +- SSHA : Single server High Availability +- SW-FUA : Sectors written with FUA +- SW : Sectors written +- Safe : Safe-mode boot +- SeSz : Sector Size +- SlotBP : Bays On Port +- Sntze : Sanitize +- Sp : Spun +- Span : Span Index +- T : TransitioTRANS=TransportReady +- TSs : Temperature Sensor count +- Temperature : Temperature in Degree Celsius +- Total RT : Average Total Response Time +- Type : Drive Type +- UBUnsp : UBad Unsupported +- UBad : Unconfigured Bad +- UGShld : UGood shielded +- UGUnsp : UGood Unsupported +- UGood : Unconfigured Good +- Unkwn : Unknown +- VD : Virtual Drive +- VDs : Virtual drives +- WB : WriteBack +- WBSup : Write Back Support +- WC-FUA : Write Commands with FUA +- WT : WriteThrough +- Write RT : Average Write Response Time +- X : Not Available/Not Installed +- Xfer Rate : Transfer Rate +- Y : Yes +- dflt : Default +- sCC : Scheduled +- sPR : Scheduled Patrol Read +- us : micro seconds + + +# Utilisation + +## Avoir un aperçu des controlleurs RAID d'un systême + +~~~ +# perccli /c0/bbu show all +CLI Version = 007.2313.0000.0000 Mar 07, 2023 +Operating system = Linux 5.10.0-24-amd64 +Status Code = 0 +Status = Success +Description = None + +Number of Controllers = 1 +Host Name = foo +Operating System = Linux 5.10.0-24-amd64 + +System Overview : +=============== + +--------------------------------------------------------------------------- +Ctl Model Ports PDs DGs DNOpt VDs VNOpt BBU sPR DS EHS ASOs Hlth +--------------------------------------------------------------------------- + 0 PERCH750Adapter 8 10 4 0 4 0 Opt On - N 0 Opt +--------------------------------------------------------------------------- + +Ctl=Controller Index|DGs=Drive groups|VDs=Virtual drives|Fld=Failed +PDs=Physical drives|DNOpt=Array NotOptimal|VNOpt=VD NotOptimal|Opt=Optimal +Msng=Missing|Dgd=Degraded|NdAtn=Need Attention|Unkwn=Unknown +sPR=Scheduled Patrol Read|DS=DimmerSwitch|EHS=Emergency Spare Drive +Y=Yes|N=No|ASOs=Advanced Software Options|BBU=Battery backup unit/CV +Hlth=Health|Safe=Safe-mode boot|CertProv-Certificate Provision mode +Chrg=Charging | MsngCbl=Cable Failure +~~~ +