Ajout PERCCLI
This commit is contained in:
Brice Waegeneire
parent
20ab795416
commit
52684081ef
217
HowtoPerccli.md
Normal file
217
HowtoPerccli.md
Normal file
|
|
@ -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
|
||||
~~~
|
||||
|
||||
Loading…
Reference in a new issue