Storcli: Difference between revisions

From HPCWIKI
Jump to navigation Jump to search
(Fix: remove --- horizontal lines (12 removed))
 
(27 intermediate revisions by 2 users not shown)
Line 1: Line 1:
'''StorCLI''' is a command line tool for the administration of '''MegaRAID Controllers''' and the '''successor of MegaCLI.'''
= Storcli =


[[HBA/RAID controller]] provides high level summary for HBA and RAID controller. 
{{Status
|status=Draft
|owner=Knowledge Agent
|last_update=2026-07-15
|review=Pending
}}


Detailed background and overall introduction is available [https://docs.broadcom.com/doc/12352476 this old document] and user reference manual is available at this Broadcom site<ref>https://docs.broadcom.com/doc/12352476</ref>
{{TOC}}


== Install storcli under Ubuntu ==
== Overview ==


# Download the latest version of storecli from [https://www.broadcom.com/site-search?page=1&per_page=100&q=storcli&sort_direction&#x5B;pages&#x5D;=desc&sort_field&#x5B;pages&#x5D;=updated_at Broadcom URL] then unzip the zip file.
StorCLI는 Broadcom(구 LSI/Avago) MegaRAID 컨트롤러를 관리하기 위한 명령줄 도구입니다. MegaCLI의 후속 버전으로, 더 향상된 기능과 호환성을 제공합니다.
# Unzip will create folder name storcli_rel and this folder containes Unified_storcli_all_os.zip
# Again, unzip Unified_storcli_all_os.zip under the storcli_rel folder then it creates Unified_storcli_all_os folder which contains installable package to [[support]] various version of operating system.
# For Ubuntu, move to Unbuntu folder under the unzipped folder name Unified_storcli_all_os, e.g, Unified_storcli_all_os/Ubuntu
# Install Debian packages. By default, storcli64 executable file will be installed at  /opt/MegaRAID/storcli/storcli64
<syntaxhighlight lang="bash">
$ sudo dpkg -i storcli_rel/Unified_storcli_all_os/Ubuntu/*.deb  #example to install deb package


# To verify storcli installation
=== Summary ===
$dpkg -l | grep -i storecli


# Default storcli command will be installed at By default, storcli64 executable file will be installed at /opt/MegaRAID/storcli/storcli64
* 무엇인가? — MegaRAID 컨트롤러 관리 CLI 도구
* 왜 필요한가? — RAID 구성, 모니터링, 성능 최적화
* 언제 사용하는가? — 데이터센터 서버 RAID 관리


</syntaxhighlight>


* Administrator can add /opt/MegaRAID/storcli/storcli64 to $PATH or create symbolic link to exist $PATH such as /usr/local/bin
== Purpose ==


* HPCMATE storage system has symbolic link at /usr/loca/bin/storcli -> /opt/MegaRAID/storcli/storcli64
이 문서가 존재하는 이유


== Storcli vs Megacli ==
* Goal: StorCLI 설치, 명령어, RAID 구성, 모니터링 방법 제공
Although Storcli is '''successor of MegaCLI, StorCLI command syntax does not compatible with MegaCLI.'''  [https://www.broadcom.com/support/knowledgebase/1211161499760/lsi-command-line-interface-cross-reference-megacli-vs-twcli-vs-s this Broadcom page] '''describes the difference''' between MegaCLI and StorCLI
* Scope: StorCLI 설치, 명령어 요약, RAID 생성/삭제/확장, 핫 스페어 관리
* Non-goals: MegaCLI 레거시 명령어, 특정 OEM 펌웨어 설정은 별도 문서


== Storcli Commands ==


====== Storcli command should be used as root priviliges otherwise command result is not successful without any error message. ======
== Key Concepts ==
<syntaxhighlight lang="bash">
$ storcli show      #cli without priviliges
CLI Version = 007.2310.0000.0000 Nov 02, 2022
Operating system = Linux 5.4.0-153-generic
Status Code = 0
Status = Success
Description = None


Number of Controllers = 0
{| class="wikitable"
Host Name = shannon-nas
! Concept
Operating System  = Linux 5.4.0-153-generic
! Description
! Related
|-
| MegaRAID
| Broadcom RAID 컨트롤러 라인업
| [[Storcli]]
|-
| Virtual Drive
| RAID로 구성된 논리 드라이브
| [[Storcli]]
|-
| Physical Drive
| 실제 물리적 디스크
| [[Storcli]]
|-
| Hot Spare
| 예비 디스크 — 자동 복구
| [[Storcli]]
|-
| Write Policy
| Write Back/Through — 성능 vs 안전
| [[Storcli]]
|-
| BBU/CacheVault
| 캐시 보호 장치
| [[HBA/RAID controller]]
|-
| Direct Mode
| PD 매핑 고정
| [[Storcli]]
|-
| Foreign Config
| 이전 서버 구성 이력
| [[Storcli]]
|}




$ sudo storcli show    ##cli with priviliges
== Architecture ==
CLI Version = 007.2310.0000.0000 Nov 02, 2022
Operating system = Linux 5.4.0-153-generic
Status Code = 0
Status = Success
Description = None
 
Number of Controllers = 1
Host Name = shannon-nas
Operating System  = Linux 5.4.0-153-generic


System Overview :
StorCLI는 MegaRAID 컨트롤러와 물리적 디스크 간 인터페이스입니다:
===============


------------------------------------------------------------------------------------
<syntaxhighlight lang="mermaid">
Ctl Model                  Ports PDs DGs DNOpt VDs VNOpt BBU sPR DS  EHS ASOs Hlth
graph TD
------------------------------------------------------------------------------------
    A[StorCLI] --> B[MegaRAID Controller]
  0 AVAGOMegaRAIDSAS9361-8i     8  6  0    0  0    0 N/A On  1&2 Y      3 Opt 
    B --> C[Physical Drives]
------------------------------------------------------------------------------------
    B --> D[Virtual Drives]
 
    B --> E[BBU/CacheVault]
Ctl=Controller Index|DGs=Drive groups|VDs=Virtual drives|Fld=Failed
    C --> F[HDD/SSD]
PDs=Physical drives|DNOpt=Array NotOptimal|VNOpt=VD NotOptimal|Opt=Optimal
     D --> G[OS / Filesystem]
Msng=Missing|Dgd=Degraded|NdAtn=Need Attention|Unkwn=Unknown
    E --> H[Cache Protection]
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
</syntaxhighlight>
</syntaxhighlight>


== Creating and Deleting a RAID ==


=== Create Virtual Drives ===
== Workflow ==
Storcli /cx add vd type=raid[0|1|5|6|10|50|60][Size=<VD1_Sz>,<VD2_Sz>,..|*all] [name=<VDNAME1>,..] drives=e:s|e:s-x|e:s-x,y [PDperArray=x|auto*] [SED] [pdcache=on|off|*default][pi] [DimmerSwitch(ds)=default|automatic(auto)| *none|maximum(max)|MaximumWithoutCaching(maxnocache)] [wt|*wb] [nora|*ra] [*direct|cached] [CachedBadBBU|*NoCachedBadBBU]


[strip=<8|16|32|64|128|256|512|1024] [AfterVd=x] [Spares=[e:]s|[e:]s-x|[e:]s-x,y] [force]
=== Deleting Virtual Drives ===
The following command deletes virtual drives:
storcli /cx/v(x|all) del [cc|cachecade].  (The cc or cachecade option to confirm that the deleted drive is a CacheCade drive)
=== Setting the Cache Policy in a Virtual Drive<ref>https://techdocs.broadcom.com/content/dam/broadcom/techdocs/data-center-solutions/tools/generated-pdfs/12Gbs-MegaRAID-Tri-Mode-Software.pdf</ref> ===
Storcli /cx/v(x|all) set wrcache=wt|wb|awb  (write cache to write back, write through, or always write back)
{| class="wikitable"
{| class="wikitable"
|+
! Stage
!Write Policy
! Input
!Description
! Output
|-
| Install
| .deb package
| storcli64 binary
|-
| Show
| storcli show
| Controller info
|-
|-
|Write Back
| Create RAID
|The controller sends a data transfer completion signal to the host when the controller
| storcli add vd
 
| Virtual Drive
cache receives the data in a transaction. If you select the Write Back policy and the
 
battery is absent, the firmware disables the Write Back policy and defaults to the Write
 
Through policy.
|-
|-
|Write Through
| Monitor
|The controller sends a data transfer completion signal to the host when the drive
| storcli /c0/vall show
subsystem receives all the data in a transaction.
| RAID status
|-
|-
|Always Write Back
| Replace Disk
|The controller sends a data transfer completion signal to the host when the controller
| storcli /c0/e8/s0 start rebuild
cache receives all the data in a transaction. If you select the Always Write Back policy
| Rebuild in progress
 
and the battery is absent, the firmware is forced to use the Write Back policy.
|}
|}


=== '''Listup available HDDs to create RAID disk group under controller #0''' ===
Before we begin to initialize and create RAID disk group, we would need to check and the necessary disk information.


== Detailed Explanation ==


NOTE: Newly added physical disks will be under the status, UGOOD (Unconfigured Good)<syntaxhighlight lang="bash">
=== StorCLI 설치 (Ubuntu) ===
$ sudo storcli /c0/eall/sall show
CLI Version = 007.2310.0000.0000 Nov 02, 2022
Operating system = Linux 5.4.0-153-generic
Controller = 0
Status = Success
Description = Show Drive Information Succeeded.


Drive Information :
<syntaxhighlight lang="bash">
=================
# 최신 버전 다운로드 (Broadcom 공식 URL)
-----------------------------------------------------------------------------
# storcli_rel 폴더 생성
EID:Slt DID State DG      Size Intf Med SED PI SeSz Model            Sp Type
# Unified_storcli_all_os.zip 추출
-----------------------------------------------------------------------------
# Ubuntu 폴더로 이동
0:0      4 UGood -  10.913 TB SAS  HDD N  N  512B HUH721212AL5200  U  -   
0:1      3 UGood -  10.913 TB SAS  HDD N  N  512B HUH721212AL5200  U  -   
0:2      2 UGood -  10.913 TB SAS  HDD N  N  512B HUH721212AL5200  U  -   
0:3      1 UGood -  10.913 TB SAS  HDD N  N  512B HUH721212AL5200  U  -   
0:4      6 UGood -  10.913 TB SAS  HDD N  N  512B HUH721212AL5200  U  -   
0:5      5 UGood -  10.913 TB SAS  HDD N  N  512B HUH721212AL5200  U  -   
-----------------------------------------------------------------------------
</syntaxhighlight>** Some disks may have the ‘F’ indicator which means that the disk came from a previously configured RAID group in a different server. To delete any foreign drives, simply enter the following command: –<syntaxhighlight lang="bash">
$sudo storcli /c0 /fall delete
</syntaxhighlight>
 
=== Create RAID1 group for OS ===
To protect OS boot issue, RAID1 (mirror with two disk) would increase safty on OS bootup under enterprise environment.
 
Folloing shows RAID1 configuration example using two 1TB SSD for OS <syntaxhighlight lang="bash">
$ sudo storcli /c0 /vall show
CLI Version = 007.2310.0000.0000 Nov 02, 2022
Operating system = Linux 5.4.0-42-generic
Controller = 0
Status = Success
Description = None


# Debian 패키지 설치
$ sudo dpkg -i storcli_rel/Unified_storcli_all_os/Ubuntu/*.deb


Virtual Drives :
# 설치 확인
==============
$ dpkg -l | grep -i storcli


---------------------------------------------------------------
# 기본 설치 경로: /opt/MegaRAID/storcli/storcli64
DG/VD TYPE  State Access Consist Cache Cac sCC      Size Name
---------------------------------------------------------------
0/0  RAID1 Optl  RW    No      RWTD  -  ON  931.000 GB OS 
---------------------------------------------------------------


# 심볼릭 링크 생성 (권장)
$ sudo ln -s /opt/MegaRAID/storcli/storcli64 /usr/local/bin/storcli
</syntaxhighlight>
</syntaxhighlight>


=== Create RAID group ===
=== StorCLI vs MegaCLI ===
add the disks into a single virtual disk group via the '''''add vd''''' command. In this case, we will setup a RAID Level 6 disk group with RAID6.<syntaxhighlight lang="bash">
# Create RAID6 disk group with 6 HDDs range 0:0-5 as name RAID6
$ sudo storcli /c0 add vd r6 name=RAID6 drives=0:0-5
CLI Version = 007.2310.0000.0000 Nov 02, 2022
Operating system = Linux 5.4.0-153-generic
Controller = 0
Status = Success
Description = Add VD Succeeded.


# Verify RAID6 disk group
StorCLI는 MegaCLI의 후속 버전이지만, **명령어 구문이 호환되지 않습니다**. Broadcom의 크로스 레퍼런스 페이지에서 차이점을 확인할 수 있습니다.
$ sudo storcli /c0/vall show
CLI Version = 007.2310.0000.0000 Nov 02, 2022
Operating system = Linux 5.4.0-153-generic
Controller = 0
Status = Success
Description = None


Virtual Drives :
=== StorCLI 명령어 사용 ===
==============
---------------------------------------------------------------
DG/VD TYPE  State Access Consist Cache Cac sCC      Size Name 
---------------------------------------------------------------
0/0  RAID6 Optl  RW    No      RWTD  -  ON  43.654 TB RAID6
---------------------------------------------------------------


$lsblk
**StorCLI는 루트 권한으로 실행해야 합니다.** (권한 없으면 에러 없이 실패)
NAME        MAJ:MIN RM  SIZE RO TYPE MOUNTPOINT
sda          8:0    0  43.7T  0 disk <<< VD name RAID6 is available on OS


#make GPT partition
<syntaxhighlight lang="bash">
$ sudo parted -s -a optimal /dev/sda mklabel gpt mkpart primary 0% 100%
# 권한 없이 실행 (실패)
$ lsblk
$ storcli show
NAME        MAJ:MIN RM  SIZE RO TYPE MOUNTPOINT
Number of Controllers = 0
sda          8:0    0  43.7T  0 disk
└─sda1        8:1    0  43.7T  0 part


#Make filesystem
# 권한 있고 실행 (성공)
$ sudo sudo mkfs.ext4 /dev/sda1
$ sudo storcli show
Number of Controllers = 1
</syntaxhighlight>
</syntaxhighlight>


=== Delete RAID6 disk groups ===
=== 시스템 개요 ===
To delete exist disk groups, use del command options<syntaxhighlight lang="bash">
 
$ sudo storcli /c0/v0 del
<syntaxhighlight lang="bash">
CLI Version = 007.2310.0000.0000 Nov 02, 2022
$ sudo storcli show
Operating system = Linux 5.4.0-153-generic
Controller = 0
Status = Success
Description = Delete VD succeeded


hpcmate@shannon-nas:~$ sudo storcli /c0/vall show
System Overview :
CLI Version = 007.2310.0000.0000 Nov 02, 2022
===============
Operating system = Linux 5.4.0-153-generic
------------------------------------------------------------------------------------
Controller = 0
Ctl Model                  Ports PDs DGs DNOpt VDs VNOpt BBU sPR DS  EHS ASOs Hlth
Status = Success
------------------------------------------------------------------------------------
Description = No VD's have been configured.
  0 AVAGOMegaRAIDSAS9361-8i    8  6  0    0  0    0 N/A On  1&2 Y      3 Opt
------------------------------------------------------------------------------------
</syntaxhighlight>
</syntaxhighlight>


== remove a dedicated (DHS) or global hot spare (GHS)? ==
**기호 설명:**
Determine enclosure and slot with this command:
* Ctl: Controller Index
<code>storcli /c0/eall/sall show</code>
* DGs: Drive Groups
* VDs: Virtual Drives
* PDs: Physical Drives
* Fld: Failed
* DNOpt: Array NotOptimal
* VNOpt: VD NotOptimal
* Opt: Optimal
* Msng: Missing
* Dgd: Degraded
* sPR: Scheduled Patrol Read
* DS: DimmerSwitch
* EHS: Emergency Spare Drive
* Hlth: Health


 
=== RAID 생성 ===
<code>storcli /c0/e252/s4 delete hotsparedrive</code>


<syntaxhighlight lang="bash">
<syntaxhighlight lang="bash">
Determine GHS disk's enclosure and slot with this command:
# RAID6 생성 (6개 HDD)
$ sudo storcli /c0 add vd r6 name=RAID6 drives=0:0-5


storcli /c0/eall/sall show
# RAID1 생성 (OS용)
$ sudo storcli /c0 add vd type=raid1 drives=0:0-1 name=OS


# RAID10 생성
$ sudo storcli /c0 add vd type=raid10 drives=0:0-3 name=RAID10


EID:Slt DID State DG      Size Intf Med SED PI SeSz Model                  Sp Type
# RAID5 생성
-------------------------------------------------------------------------------------
$ sudo storcli /c0 add vd type=raid5 drives=0:0-5 name=RAID5
...
</syntaxhighlight>
65:10    6 UGood -  10.913 TB SAS  HDD N  N  512B MG07SCA12TE            U  -   
65:11    3 GHS  -   10.913 TB SAS  HDD N  N  512B MG07SCA12TE            U  -   
66:0    10 UGood -  10.913 TB SAS  HDD N  N  512B MG07SCA12TE            D  -   


To remove the disk, you first have to turn it into a UGOOD - "unconfigured good" disk by deleting the hotspare status:
**RAID 생성 옵션:**
* `strip=<8|16|32|64|128|256|512|1024>` — 스트라이프 크기
* `pdcache=on|off|default` — 물리적 드라이브 캐시
* `wt|wb` — Write Through/Back
* `nora|ra` — Read Ahead
* `Spares=[e:]s|[e:]s-x` — 핫 스페어


storcli /c0/e65/s11 delete hotsparedrive
=== RAID 삭제 ===


The drive will now look like this:
<syntaxhighlight lang="bash">
65:11    3 UGood  -  10.913 TB SAS  HDD N  N  512B MG07SCA12TE            U  -   
# 가상 드라이브 삭제
$ sudo storcli /c0/v0 del


Now you can turn it off using
# 모든 가상 드라이브 삭제
storcli /c0/e65/s11 set offline
$ sudo storcli /c0/vall del
</syntaxhighlight>


which changes the state to:
=== 디스크 캐시 정책 ===
65:11    3 UGood  -  10.913 TB SAS  HDD N  N  512B MG07SCA12TE      D  -   
                                                                        ^


(the value in the "Sp" = Spun column changed from "U" = Up to "D" = Down).
<syntaxhighlight lang="bash">
# 가상 드라이브 캐시 정책 설정
$ sudo storcli /c0/v0 set pdcache=on
$ sudo storcli /c0/v0 set rdcache=nora
$ sudo storcli /c0/v0 set wrcache=wb
</syntaxhighlight>
</syntaxhighlight>


== Location of HDDs<ref>https://www.thomas-krenn.com/en/wiki/StorCLI_commands#Creating_a_Virtual_Drive</ref> ==
**LSI 권장사항:**
<syntaxhighlight lang="bash">
* 모든 RAID 레벨 → Direct I/O 권장
# Blinking HDD to find location, controller 0, Enclosure0, slot 2
* RAID 0/1/10 (스트리밍) → Write Through 권장
$ sudo storcli /c0/e0/s2 start locate
* RAID 0/1/10 (랜덤) → Write Back 권장
# To stop blinking
* RAID 5/6 → Write Back 권장
$ sudo storcli /c0/e0/s2 stop locate
 
</syntaxhighlight>
=== Write Policy ===


== Storcli Commands Summary<ref>https://docs.broadcom.com/doc/12352476</ref> ==
{| class="wikitable"
{| class="wikitable"
|+
! Write Policy
!Type
! Description
!Description
! Recommendation
!Example
|-
|-
|System Commands
| Write Back (WB)
|show system status
| 컨트롤러 캐시에 데이터 수신 시 완료 신호
|storcli show
| "bursty" 쓰기 환경에 효율적
storcli show all
|-
 
| Write Through (WT)
storcli show ctrlcount
| 드라이브에 데이터 수신 시 완료 신호
 
| RAID 0/1/10 스트리밍 데이터에 권장
storcli show help
 
storcli -v
|-
|-
|Controller Commands
| Always Write Back (AWB)
|show and set controller properties
| BBU 부재 시에도 Write Back 강제
Syntax : 
| BBU 필수 (데이터 손실 위험)
|}


storcli /cx show <property>
=== 디스크 정보 확인 ===


storcli /cx set <property>=<value>
<syntaxhighlight lang="bash">
# 사용 가능한 디스크 확인
$ sudo storcli /c0/eall/sall show


where x is controller number
# 출력 예시
|
# EID:Slt DID State DG      Size Intf Med SED PI SeSz Model            Sp Type
* storcli /cx show
# 0:0      4 UGood -  10.913 TB SAS  HDD N  N  512B HUH721212AL5200  U  -
* storcli /cx show all
</syntaxhighlight>
* storcli /cx show freespace
*storcli /cx set rebuildrate=<value>
*storcli /cx show rebuildrate
|-
|Drive Commands
|information and perform actions related to physical drives
storcli /cx[/ex]/sx show


torcli /cx[/ex]/sx set properties
**디스크 상태:**
* UGood: Unconfigured Good
* GHS: Global Hot Spare
* DHS: Dedicated Hot Spare
* Onln: Online
* Fld: Failed


where,
=== Foreign Configuration 처리 ===


* c specifies the controller #.
<syntaxhighlight lang="bash">
* e specifies the enclosure ID.
# Foreign Configuration 삭제
* s represents the slot in the enclosure.
$ sudo storcli /c0/fall delete
* e:s-x is the range convention used to represent slots s to x in the enclosure e.
|Sets physical drive properties


* missing: Sets the drive status as missing.
# Foreign Configuration 확인
* good: Sets the drive status to unconfigured good.
$ sudo storcli /c0/fall show
* offline: Sets the drive status to offline.
</syntaxhighlight>
* online: Sets the drive status to online.


Shows virtual drive information
=== 핫 스페어 관리 ===


* all: shows all properties of the physical drive
{| class="wikitable"
! Type
! Description
! Example
|-
| Global Hot Spare
| 모든 RAID 그룹에 자동 할당
| `storcli /cx/ex/sx add hotsparedrive`
|-
|-
|Virtual Drives Commands
| Dedicated Hot Spare
|Creates/Delete/Set/Show virtual drives
| 특정 RAID 그룹에 할당
|
| `storcli /cx/ex/sx add hotsparedrive dgs=N`
|-
|-
|Foreign Configurations Commands
| Emergency Hot Spare
|commands to view, import, and delete foreign configurations:
| SMART 오류 시 자동 할당
|storcli /c0/fall show preview foreign
| `storcli /cx set eghs eug=on`
storcli /c0/fall import preview
|}


storcli /c0/fall show all
**핫 스페어 제거:**


storcli /cx/fx|fall del|delete [ securitykey=ss... ]
<syntaxhighlight lang="bash">
storcli /cx/fx|fall import [preview][ securitykey=ss... ]
# 핫 스페어 상태 제거
$ sudo storcli /c0/e65/s11 delete hotsparedrive
 
# 디스크 오프라인
$ sudo storcli /c0/e65/s11 set offline
</syntaxhighlight>


storcli /cx/fx|fall show [all] [ securitykey=ss... ]
=== 디스크 위치 찾기 ===
|-
|BIOS-Related Commands
|
|<nowiki>storcli /cx autobootselect(abs)=<on|off></nowiki>
storcli /cx set bios=<on|off>


storcli /cx set headlessafemode|hsm=<on/off>
<syntaxhighlight lang="bash">
# 디스크 깜빡이기 (물리적 위치 확인)
$ sudo storcli /c0/e0/s2 start locate


storcli /cx set headlesscontinueonerror|hcoe=<on/off>
# 깜빡임 중지
$ sudo storcli /c0/e0/s2 stop locate
</syntaxhighlight>


storcli /cx set stoponerror|soe=<on|off>
=== 디스크 교체 ===


storcli /cx show bios
<syntaxhighlight lang="bash">
|-
# 실패한 디스크 교체
|OPROM BIOS Commands
$ sudo storcli /c0/e8/s0 insert dg=0 array=0 row=0
|
|<nowiki>storcli /cx/ex/sx set bootdrive=on|off</nowiki>
storcli /cx/vx set bootdrive=on|off


storcli /cx show bootdrive
# 수동 리빌드 시작
|-
$ sudo storcli /c0/e8/s0 start rebuild
|Drive Group Commands
</syntaxhighlight>
|
|storcli /cx/dall show
storcli /cx/dall show all


storcli /cx/dall show cachecade
=== 디스크 직렬 번호 확인 ===
|-
|Dimmer Switch Commands
|Dimmer Switch is the power-saving policy for the virtual drive
|storcli/c0 show ds
storcli /cx/vx set ds=<default | auto | none | max | maxnocache>
|-
|BBU Commands
|<u>Recent Versions of Storcli now use the /cv command instead of bbu</u><ref>https://support.siliconmechanics.com/portal/en/kb/articles/bbu-commands-for-storcli</ref>
$ sudo storcli /c0/cv show


|<u>Old version of storcli,</u> 
<syntaxhighlight lang="bash">
storcli /cx/bbu show
$ sudo storcli /c0/eALL/sALL show all | egrep 'Device attributes|SN = '
storcli /cx/bbu show all
</syntaxhighlight>


storcli /cx/bbu set bbuMode=<value>
=== 디스크 상태 확인 (smartctl) ===


storcli /cx/bbu set learndelayinterval=<value>
<syntaxhighlight lang="bash">
# 디바이스 ID 확인
$ sudo storcli /c0/eall/sall show


storcli /cx/bbu set powermode=sleep
# smartctl로 디스크 테스트
$ smartctl -d megaraid,1 -a /dev/sda
</syntaxhighlight>


storcli /cx/bbu set writeaceess=sealed
=== Direct Mode vs Persistent Mode ===


storcli /cx/bbu show modes
{| class="wikitable"
! Mode
! Description
! Use Case
|-
| Persistent (default)
| device IDs 변경 가능, expanders에 적합
| 기본값
|-
| Direct
| device IDs 고정, phy 번호와 일치
| 직접 연결 디스크
|}


storcli /cx/bbu show properties
<syntaxhighlight lang="bash">
# 현재 설정 확인
$ sudo storcli /c0 show directpdmapping


storcli /cx/bbu show status
# Direct Mode 활성화
$ sudo storcli /c0 set directpdmapping=on


storcli /cx/bbu start learn
# Direct Mode 비활성화
|-
$ sudo storcli /c0 set directpdmapping=off
|Enclosure Commands
</syntaxhighlight>
|
|storcli /cx/ex download src=filepath[forceActivate]
storcli /cx/ex show all


storcli /cx/ex show status
=== RAID 확장 ===
|-
|PHY Commands
|shows  PHY layer information, sets the PHY link speed
|<nowiki>storcli /cx/px|pall set linkspeed=0(auto)|1.5|3|6|12</nowiki>
storcli /cx/px|pall show


storcli /cx/px|pall show all
<syntaxhighlight lang="bash">
|-
# 기존 RAID5에 디스크 추가
|Logging Commands
$ sudo storcli /c0/v0 start migrate type=raid5 option=add drives=8:0
|generate and maintain log files
</syntaxhighlight>
|storcli /cx clear events
storcli /cx delete termlog


storcli /cx show events file=<absolute path>
※ RAID 00, 10, 50, 60은 이 방식으로 확장 불가


storcli /cx show eventloginfo
=== StorCLI 명령어 요약 ===


storcli /cx show termlog type=config|contents
|}
{| class="wikitable"
{| class="wikitable"
|+Properties for Show and Set Commands
! Type
!Property Name
! Description
!Set Command Range
! Example
!Description
|-
|-
|abortcconerror
| System
|<nowiki>on|off</nowiki>
| 시스템 상태 확인
|Aborts consistency check when it detects an inconsistency.
| `storcli show`<br>`storcli show ctrlcount`<br>`storcli -v`
|-
|-
|activityforlocate
| Controller
|<nowiki>on|off</nowiki>
| 컨트롤러 속성
|Enables/disables drive activity, drive activity locates function for systems without SGPIO/SES capabilities.
| `storcli /cx show`<br>`storcli /cx set rebuildrate=50`
|-
|-
|alarm
| Drive
|<nowiki>on|off|silence</nowiki>
| 물리적 드라이브
silence: Silences the alarm
| `storcli /cx/ex/sx show`<br>`storcli /cx/ex/sx set good`
|Enables/disables alarm on critical errors
|-
|-
|backplane
| Virtual Drive
|0: Use autodetect logic of backplanes,
| 가상 드라이브
such as SGPIO and I2C SEP using GPIO
| `storcli /cx/vx show init`<br>`storcli /cx/vx start init full`
 
pins.
 
1: Disable autodetect SGPIO.
 
2: Disable I2C SEP autodetect.
 
3: Disable both the autodetects.
|Configures enclosure detection on a non-SES/expander
backplane.
|-
|-
|batterywarning
| Consistency Check
|<nowiki>on|off</nowiki>
| 일관성 검사
|Enables/disables battery warnings
| `storcli /cx/vx start cc`<br>`storcli /cx/vx pause cc`
|-
|-
|bgirate
| Background Init
|0 to 100
| 백그라운드 초기화
|Sets background initialization rate in percentage.
| `storcli /cx/vx start bgi`<br>`storcli /cx/vx stop bgi`
|-
|-
|cacheflushint
| Foreign Config
|0 to 255, default value 4
| 외부 구성
|Sets cache flush interval in seconds
| `storcli /c0/fall import`<br>`storcli /c0/fall delete`
|-
|-
|ccrate
| BBU/CV
|0 to 100
| 캐시 보호
|Sets consistency check rate in percentage
| `storcli /cx/cv show all`<br>`storcli /cx/bbu show status`
|-
|-
|coercion
| Hot Spare
|0: No coercion
| 핫 스페어
1: 128 MB
| `storcli /cx/ex/sx add hotsparedrive`<br>`storcli /cx/ex/sx delete hotsparedrive`
|}


2: 1 GB
|Sets drive capacity in coercion mode
|-
|consistencycheck
|See  Consistency Check.
|See  Consistency Check.
|-
|copyback
|<nowiki>on|off</nowiki>
type = smartssd|smarthdd|all


smartssd: Copy back enabled for SSD
== Configuration ==


drives.
<syntaxhighlight lang="bash">
# StorCLI 설치
$ sudo dpkg -i storcli_rel/Unified_storcli_all_os/Ubuntu/*.deb
$ sudo ln -s /opt/MegaRAID/storcli/storcli64 /usr/local/bin/storcli


smarthdd: Copy back enabled for HDD
# RAID 구성
$ sudo storcli /c0 add vd type=raid6 drives=0:0-5 name=DATA


drives.
# RAID 상태 확인
$ sudo storcli /c0/vall show


all: Copy back enabled for both ssd
# 디스크 상태 확인
$ sudo storcli /c0/eall/sall show


drives and HDD drives.
# 캐시 정책 설정
$ sudo storcli /c0/v0 set wrcache=wb
$ sudo storcli /c0/v0 set rdcache=nora
$ sudo storcli /c0/v0 set pdcache=on
</syntaxhighlight>


Example:


storcli /cx set copyback=on
== Examples ==


type=all
=== Example 1: RAID6 생성 및 마운트 ===
|Enables/disables copy back for drive types.
|-
|directpdmapping
|<nowiki>on|off</nowiki>
|Enables/disables direct physical drive mapping. When
enclosures are used, this feature is disabled; otherwise it


should be enabled.
<syntaxhighlight lang="bash">
|-
# RAID6 생성
|eccbucketleakrate
$ sudo storcli /c0 add vd r6 name=RAID6 drives=0:0-5
|0 to 65535
|Sets leak rate of the single-bit bucket in minutes (one
entry removed per leak-rate).
|-
|eccbucketsize
|0 to 255
|Sets size of ECC single-bit-error bucket (logs event
when full).
|-
|enableeghsp
|<nowiki>on|off</nowiki>
|Enables/disables the commissioning of otherwise
incompatible global hot spare drives as Emergency Hot


Spare (EHSP) drives
# RAID6 확인
|-
$ sudo storcli /c0/vall show
|enableesmarter
|<nowiki>on|off</nowiki>
|Enables/disables the commissioning of Emergency Hot
Spare (EHSP) drives for Predictive Failure (PFA) events.
|-
|enableeug
|<nowiki>on|off</nowiki>
|Enables/disables the commissioning of Unconfigured
Good drives as Emergency Hot Spare (EHSP) drives
|-
|exposeencldevice
|<nowiki>on|off</nowiki>
|Enables/disables device drivers to expose enclosure
devices; for example, expanders, SEPs
|-
|<nowiki>dimmerswitch|ds</nowiki>
|Todo Dimmer Switch Commands.
|Todo Dimmer Switch Commands.
|-
|foreignautoimport
|<nowiki>on|off</nowiki>
|Imports foreign configuration automatically, at boot.
|-
|jbod
|<nowiki>on|off</nowiki>
|Enables/disables JBOD mode; by default, drives become system drives.
'''NOTE Not supported by all controllers'''
|-
|loadbalancemode
|<nowiki>on|off</nowiki>
|Enables/disables automatic load balancing between SAS phys or ports in a wide port configuration
|-
|maintainpdfailhistory
|<nowiki>on|off</nowiki>
|Maintains the physical drive fail history
|-
|migraterate
|0 to 100
|Sets data migration rate in percentage
|-
|<nowiki>patrolread|pr</nowiki>
|Todo Patrol Read
|Todo Patrol Read
|-
|perfmode
|0: Tuned to provide best [[IOPS]], currently
applicable to non-FastPath


1: Tuned to provide least latency, currently
# 파티션 생성
$ sudo parted -s -a optimal /dev/sda mklabel gpt mkpart primary 0% 100%


applicable to non-FastPath
# 파일시스템 생성
|Performance tuning setting for the controller
$ sudo mkfs.ext4 /dev/sda1
|-
|pi
|<nowiki>on|off</nowiki>
|Enables/disables data protection on the controller
|-
|preventpiimport
|<nowiki>on|off </nowiki>
|Enables/disables import data protection drives on the controller
|-
|prcorrectunconfiguredareas
|<nowiki>on|off </nowiki>
|Correct media errors during PR by writing 0s to unconfigured areas of the disk
|-
|prrate 
|0 to 100
|Sets patrol read rate of the virtual drives in percentage
|-
|rebuildrate
|0 to 100
|Sets rebuild rate of the drive in percentage
|-
|reconrate 
|0 to 100
|Sets reconstruction rate for a drive in percentage
|-
|restorehotspare 
|<nowiki>on|off</nowiki>
|Becomes a hot spare on insertion of a failed drive.
|-
|smartpollinterval 
|0 to 65535
|Set time for polling of SMART errors in seconds
|-
|spinupdrivecount
|0 to 255
|Sets number of drives that are spun up at a time
|-
|spinupdelay 
|0 to 255
|Sets spin-up delay between a group of drives or a set of drives, in seconds
|-
|stoponerror 
|<nowiki>on|off</nowiki>
|Stops the MegaRAID [[BIOS]] during POST, if any errors are
encountered
|-
|time
|Valid time in yymmdd hh:mm:ss format or systemtime
|Sets the controller time to your input value or the system
time (local time in 24-hour format)
|-
|usefdeonlyencrypt 
|<nowiki>on|off</nowiki>
|Enables/disables FDE drive-based encryption
|}


== Hot spare drives ==
# 마운트
A hot spare is an extra, unused drive that is part of the disk subsystem. It is usually in Standby mode, ready for service if a drive fails.
$ sudo mount /dev/sda1 /mnt/data
</syntaxhighlight>


Hot spares let you replace failed drives without system shutdown or user intervention. The controller supports automatic and transparent rebuilds of failed drives using hot spare drives, which provide a high degree of fault tolerance and zero downtime.
=== Example 2: 디스크 교체 ===


The failed drive is removed from the virtual drive and marked ready awaiting removal after the rebuild to a hot spare begins. You can make hot spares of the drives that are not in a RAID virtual drive
<syntaxhighlight lang="bash">
# 실패한 디스크 확인
$ sudo storcli /c0/eall/sall show


=== Types of hot spare ===
# 디스크 교체
$ sudo storcli /c0/e8/s0 insert dg=0 array=0 row=0


* Global hot spare
# 리빌드 시작
* Dedicated hot spare
$ sudo storcli /c0/e8/s0 start rebuild


<syntaxhighlight lang="bash">
# 리빌드 진행률 확인
create and delete hot spare drives
$ sudo storcli /c0 show rebuild
</syntaxhighlight>


storcli /cx[/ex]/sx add hotsparedrive {dgs=<n|0,1,2...>}[enclaffinity][nonrevertible]
storcli /cx/[ex]/sx delete hotsparedrive


dgs - Valid drive group number
== Best Practices ==
enclaffinity - Valid enclosure number, Specifies the enclosure with which the hot spare is
associated. If this option is specified, affinity is set; if it is not specified, there is no affinity.
</syntaxhighlight>** NOTE Affinity cannot be removed after it is set for a hot spare drive.<ref>https://docs.broadcom.com/doc/12352476</ref>


If the hot spare is designated as having enclosure affinity, it tries to rebuild any failed drives on the backplane in which it resides before rebuilding any other drives on other backplanes.
* StorCLI는 항상 루트 권한으로 실행
* Write Back + BBU/CacheVault 조합 사용 (성능 최적화)
* 핫 스페어 구성 (자동 복구)
* 정기적인 Consistency Check 실행
* Foreign Configuration 처리 (교체 서버 디스크)
* Direct Mode 활성화 (직접 연결 디스크)
* 디스크 직렬 번호 기록 (물리적 위치 추적)
* 정기적인 [[smartctl]] 모니터링


== Direct mode / Persistent mode / Device IDs <ref>https://www.broadcom.com/support/knowledgebase/1211161503520/direct-mode---persistant-mode---device-ids-on-megaraid</ref> ==


* Persistent mode (directpdmapping=off)(the default) device IDs can change, and increment, or be different even on new controllers depending on what was connected during the LSI manufacturing process.  '''Persistent mode is good for expanders'''.
== Limitations ==
* Direct mode (directpdmapping=on) device IDs never change, and always match the phy number.
<syntaxhighlight lang="bash">
#To check the current setting:
syntax: storcli /cx show directpdmapping
example:  storcli /c0 show directpdmapping


#To enable direct PD mapping:
* StorCLI는 MegaCLI와 명령어 호환 안됨
syntax: storcli /cx set directpdmapping=on
* RAID 00/10/50/60은 확장 불가
example:  storcli /cx set directpdmapping=on
* Write Back은 BBU 필수 (데이터 손실 위험)
* StorCLI는 루트 권한 필요
* 일부 기능은 컨트롤러 모델에 따라 제한됨


#To disable direct PD mapping:
syntax: storcli /cx set directpdmapping=off
example:  storcli /cx set directpdmapping=off
</syntaxhighlight>


== References ==
== References ==
<references />
 
* https://docs.broadcom.com/doc/12352476
* https://www.broadcom.com/support/knowledgebase/1211161499760/
 
 
== Related Pages ==
 
* [[HBA/RAID controller]]
* [[Hardware RAID information on Linux]]
* [[RAID]]
* [[Storage]]
* [[BBU]]
 
 
[[Category:Linux]]
== Knowledge Graph ==
 
Related
 
→ [[Linux]]
→ [[Server]]
→ [[Hardware]]
→ [[Network]]
 
[[Category:Reference]]

Latest revision as of 11:30, 17 July 2026

Storcli

Template:Status

Template:TOC

Overview

StorCLI는 Broadcom(구 LSI/Avago) MegaRAID 컨트롤러를 관리하기 위한 명령줄 도구입니다. MegaCLI의 후속 버전으로, 더 향상된 기능과 호환성을 제공합니다.

Summary

  • 무엇인가? — MegaRAID 컨트롤러 관리 CLI 도구
  • 왜 필요한가? — RAID 구성, 모니터링, 성능 최적화
  • 언제 사용하는가? — 데이터센터 서버 RAID 관리


Purpose

이 문서가 존재하는 이유

  • Goal: StorCLI 설치, 명령어, RAID 구성, 모니터링 방법 제공
  • Scope: StorCLI 설치, 명령어 요약, RAID 생성/삭제/확장, 핫 스페어 관리
  • Non-goals: MegaCLI 레거시 명령어, 특정 OEM 펌웨어 설정은 별도 문서


Key Concepts

Concept Description Related
MegaRAID Broadcom RAID 컨트롤러 라인업 Storcli
Virtual Drive RAID로 구성된 논리 드라이브 Storcli
Physical Drive 실제 물리적 디스크 Storcli
Hot Spare 예비 디스크 — 자동 복구 Storcli
Write Policy Write Back/Through — 성능 vs 안전 Storcli
BBU/CacheVault 캐시 보호 장치 HBA/RAID controller
Direct Mode PD 매핑 고정 Storcli
Foreign Config 이전 서버 구성 이력 Storcli


Architecture

StorCLI는 MegaRAID 컨트롤러와 물리적 디스크 간 인터페이스입니다: 

graph TD
    A[StorCLI] --> B[MegaRAID Controller]
    B --> C[Physical Drives]
    B --> D[Virtual Drives]
    B --> E[BBU/CacheVault]
    C --> F[HDD/SSD]
    D --> G[OS / Filesystem]
    E --> H[Cache Protection]


Workflow

Stage Input Output
Install .deb package storcli64 binary
Show storcli show Controller info
Create RAID storcli add vd Virtual Drive
Monitor storcli /c0/vall show RAID status
Replace Disk storcli /c0/e8/s0 start rebuild Rebuild in progress


Detailed Explanation

StorCLI 설치 (Ubuntu)

# 최신 버전 다운로드 (Broadcom 공식 URL)
# storcli_rel 폴더 생성
# Unified_storcli_all_os.zip 추출
# Ubuntu 폴더로 이동

# Debian 패키지 설치
$ sudo dpkg -i storcli_rel/Unified_storcli_all_os/Ubuntu/*.deb

# 설치 확인
$ dpkg -l | grep -i storcli

# 기본 설치 경로: /opt/MegaRAID/storcli/storcli64

# 심볼릭 링크 생성 (권장)
$ sudo ln -s /opt/MegaRAID/storcli/storcli64 /usr/local/bin/storcli

StorCLI vs MegaCLI

StorCLI는 MegaCLI의 후속 버전이지만, **명령어 구문이 호환되지 않습니다**. Broadcom의 크로스 레퍼런스 페이지에서 차이점을 확인할 수 있습니다.

StorCLI 명령어 사용

    • StorCLI는 루트 권한으로 실행해야 합니다.** (권한 없으면 에러 없이 실패)
# 권한 없이 실행 (실패)
$ storcli show
Number of Controllers = 0

# 권한 있고 실행 (성공)
$ sudo storcli show
Number of Controllers = 1

시스템 개요

$ sudo storcli show

System Overview :
===============
------------------------------------------------------------------------------------
Ctl Model                   Ports PDs DGs DNOpt VDs VNOpt BBU sPR DS  EHS ASOs Hlth
------------------------------------------------------------------------------------
  0 AVAGOMegaRAIDSAS9361-8i     8   6   0     0   0     0 N/A On  1&2 Y      3 Opt
------------------------------------------------------------------------------------
    • 기호 설명:**
  • Ctl: Controller Index
  • DGs: Drive Groups
  • VDs: Virtual Drives
  • PDs: Physical Drives
  • Fld: Failed
  • DNOpt: Array NotOptimal
  • VNOpt: VD NotOptimal
  • Opt: Optimal
  • Msng: Missing
  • Dgd: Degraded
  • sPR: Scheduled Patrol Read
  • DS: DimmerSwitch
  • EHS: Emergency Spare Drive
  • Hlth: Health

RAID 생성

# RAID6 생성 (6개 HDD)
$ sudo storcli /c0 add vd r6 name=RAID6 drives=0:0-5

# RAID1 생성 (OS용)
$ sudo storcli /c0 add vd type=raid1 drives=0:0-1 name=OS

# RAID10 생성
$ sudo storcli /c0 add vd type=raid10 drives=0:0-3 name=RAID10

# RAID5 생성
$ sudo storcli /c0 add vd type=raid5 drives=0:0-5 name=RAID5
    • RAID 생성 옵션:**
  • `strip=<8|16|32|64|128|256|512|1024>` — 스트라이프 크기
  • `pdcache=on|off|default` — 물리적 드라이브 캐시
  • `wt|wb` — Write Through/Back
  • `nora|ra` — Read Ahead
  • `Spares=[e:]s|[e:]s-x` — 핫 스페어

RAID 삭제

# 가상 드라이브 삭제
$ sudo storcli /c0/v0 del

# 모든 가상 드라이브 삭제
$ sudo storcli /c0/vall del

디스크 캐시 정책

# 가상 드라이브 캐시 정책 설정
$ sudo storcli /c0/v0 set pdcache=on
$ sudo storcli /c0/v0 set rdcache=nora
$ sudo storcli /c0/v0 set wrcache=wb
    • LSI 권장사항:**
  • 모든 RAID 레벨 → Direct I/O 권장
  • RAID 0/1/10 (스트리밍) → Write Through 권장
  • RAID 0/1/10 (랜덤) → Write Back 권장
  • RAID 5/6 → Write Back 권장

Write Policy

Write Policy Description Recommendation
Write Back (WB) 컨트롤러 캐시에 데이터 수신 시 완료 신호 "bursty" 쓰기 환경에 효율적
Write Through (WT) 드라이브에 데이터 수신 시 완료 신호 RAID 0/1/10 스트리밍 데이터에 권장
Always Write Back (AWB) BBU 부재 시에도 Write Back 강제 BBU 필수 (데이터 손실 위험)

디스크 정보 확인

# 사용 가능한 디스크 확인
$ sudo storcli /c0/eall/sall show

# 출력 예시
# EID:Slt DID State DG      Size Intf Med SED PI SeSz Model            Sp Type
# 0:0       4 UGood -  10.913 TB SAS  HDD N   N  512B HUH721212AL5200  U  -
    • 디스크 상태:**
  • UGood: Unconfigured Good
  • GHS: Global Hot Spare
  • DHS: Dedicated Hot Spare
  • Onln: Online
  • Fld: Failed

Foreign Configuration 처리

# Foreign Configuration 삭제
$ sudo storcli /c0/fall delete

# Foreign Configuration 확인
$ sudo storcli /c0/fall show

핫 스페어 관리

Type Description Example
Global Hot Spare 모든 RAID 그룹에 자동 할당 `storcli /cx/ex/sx add hotsparedrive`
Dedicated Hot Spare 특정 RAID 그룹에 할당 `storcli /cx/ex/sx add hotsparedrive dgs=N`
Emergency Hot Spare SMART 오류 시 자동 할당 `storcli /cx set eghs eug=on`
    • 핫 스페어 제거:**
# 핫 스페어 상태 제거
$ sudo storcli /c0/e65/s11 delete hotsparedrive

# 디스크 오프라인
$ sudo storcli /c0/e65/s11 set offline

디스크 위치 찾기

# 디스크 깜빡이기 (물리적 위치 확인)
$ sudo storcli /c0/e0/s2 start locate

# 깜빡임 중지
$ sudo storcli /c0/e0/s2 stop locate

디스크 교체

# 실패한 디스크 교체
$ sudo storcli /c0/e8/s0 insert dg=0 array=0 row=0

# 수동 리빌드 시작
$ sudo storcli /c0/e8/s0 start rebuild

디스크 직렬 번호 확인

$ sudo storcli /c0/eALL/sALL show all | egrep 'Device attributes|SN = '

디스크 상태 확인 (smartctl)

# 디바이스 ID 확인
$ sudo storcli /c0/eall/sall show

# smartctl로 디스크 테스트
$ smartctl -d megaraid,1 -a /dev/sda

Direct Mode vs Persistent Mode

Mode Description Use Case
Persistent (default) device IDs 변경 가능, expanders에 적합 기본값
Direct device IDs 고정, phy 번호와 일치 직접 연결 디스크 
# 현재 설정 확인
$ sudo storcli /c0 show directpdmapping

# Direct Mode 활성화
$ sudo storcli /c0 set directpdmapping=on

# Direct Mode 비활성화
$ sudo storcli /c0 set directpdmapping=off

RAID 확장

# 기존 RAID5에 디스크 추가
$ sudo storcli /c0/v0 start migrate type=raid5 option=add drives=8:0

※ RAID 00, 10, 50, 60은 이 방식으로 확장 불가

StorCLI 명령어 요약

Type Description Example
System 시스템 상태 확인 `storcli show`
`storcli show ctrlcount`
`storcli -v`
Controller 컨트롤러 속성 `storcli /cx show`
`storcli /cx set rebuildrate=50`
Drive 물리적 드라이브 `storcli /cx/ex/sx show`
`storcli /cx/ex/sx set good`
Virtual Drive 가상 드라이브 `storcli /cx/vx show init`
`storcli /cx/vx start init full`
Consistency Check 일관성 검사 `storcli /cx/vx start cc`
`storcli /cx/vx pause cc`
Background Init 백그라운드 초기화 `storcli /cx/vx start bgi`
`storcli /cx/vx stop bgi`
Foreign Config 외부 구성 `storcli /c0/fall import`
`storcli /c0/fall delete`
BBU/CV 캐시 보호 `storcli /cx/cv show all`
`storcli /cx/bbu show status`
Hot Spare 핫 스페어 `storcli /cx/ex/sx add hotsparedrive`
`storcli /cx/ex/sx delete hotsparedrive`


Configuration

# StorCLI 설치
$ sudo dpkg -i storcli_rel/Unified_storcli_all_os/Ubuntu/*.deb
$ sudo ln -s /opt/MegaRAID/storcli/storcli64 /usr/local/bin/storcli

# RAID 구성
$ sudo storcli /c0 add vd type=raid6 drives=0:0-5 name=DATA

# RAID 상태 확인
$ sudo storcli /c0/vall show

# 디스크 상태 확인
$ sudo storcli /c0/eall/sall show

# 캐시 정책 설정
$ sudo storcli /c0/v0 set wrcache=wb
$ sudo storcli /c0/v0 set rdcache=nora
$ sudo storcli /c0/v0 set pdcache=on


Examples

Example 1: RAID6 생성 및 마운트

# RAID6 생성
$ sudo storcli /c0 add vd r6 name=RAID6 drives=0:0-5

# RAID6 확인
$ sudo storcli /c0/vall show

# 파티션 생성
$ sudo parted -s -a optimal /dev/sda mklabel gpt mkpart primary 0% 100%

# 파일시스템 생성
$ sudo mkfs.ext4 /dev/sda1

# 마운트
$ sudo mount /dev/sda1 /mnt/data

Example 2: 디스크 교체

# 실패한 디스크 확인
$ sudo storcli /c0/eall/sall show

# 디스크 교체
$ sudo storcli /c0/e8/s0 insert dg=0 array=0 row=0

# 리빌드 시작
$ sudo storcli /c0/e8/s0 start rebuild

# 리빌드 진행률 확인
$ sudo storcli /c0 show rebuild


Best Practices

  • StorCLI는 항상 루트 권한으로 실행
  • Write Back + BBU/CacheVault 조합 사용 (성능 최적화)
  • 핫 스페어 구성 (자동 복구)
  • 정기적인 Consistency Check 실행
  • Foreign Configuration 처리 (교체 서버 디스크)
  • Direct Mode 활성화 (직접 연결 디스크)
  • 디스크 직렬 번호 기록 (물리적 위치 추적)
  • 정기적인 smartctl 모니터링


Limitations

  • StorCLI는 MegaCLI와 명령어 호환 안됨
  • RAID 00/10/50/60은 확장 불가
  • Write Back은 BBU 필수 (데이터 손실 위험)
  • StorCLI는 루트 권한 필요
  • 일부 기능은 컨트롤러 모델에 따라 제한됨


References


Related Pages

Knowledge Graph

Related

→ Linux → Server → Hardware → Network

Retrieved from "http://wiki.hpcmate.com/index.php?title=Storcli&oldid=3452"