Storcli: Difference between revisions

From HPCWIKI
Jump to navigation Jump to search
(Fix: remove --- horizontal lines (12 removed))
 
(38 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 =


More background and overall introduction is available [https://docs.broadcom.com/doc/12352476 this old document]
{{Status
|status=Draft
|owner=Knowledge Agent
|last_update=2026-07-15
|review=Pending
}}


== Install storcli under Ubuntu ==
{{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 ==
 
{| class="wikitable"
! 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 컨트롤러와 물리적 디스크 간 인터페이스입니다:
 
<syntaxhighlight lang="mermaid">
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]
</syntaxhighlight>
 
 
== Workflow ==
 
{| class="wikitable"
! 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) ===


# 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.
# 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">
<syntaxhighlight lang="bash">
$ sudo dpkg -i storcli_rel/Unified_storcli_all_os/Ubuntu/*.deb  #example to install deb package
# 최신 버전 다운로드 (Broadcom 공식 URL)
# storcli_rel 폴더 생성
# Unified_storcli_all_os.zip 추출
# Ubuntu 폴더로 이동


# To verify storcli installation
# Debian 패키지 설치
$dpkg -l | grep -i storecli
$ sudo dpkg -i storcli_rel/Unified_storcli_all_os/Ubuntu/*.deb


# Default storcli command will be installed at By default, storcli64 executable file will be installed at /opt/MegaRAID/storcli/storcli64
# 설치 확인
$ dpkg -l | grep -i storcli


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


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


* HPCMATE storage system has symbolic link at /usr/loca/bin/storcli -> /opt/MegaRAID/storcli/storcli64
StorCLI는 MegaCLI의 후속 버전이지만, **명령어 구문이 호환되지 않습니다**. Broadcom의 크로스 레퍼런스 페이지에서 차이점을 확인할 수 있습니다.


== Storcli vs Megacli ==
=== StorCLI 명령어 사용 ===
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


== Storcli Commands ==
**StorCLI는 루트 권한으로 실행해야 합니다.** (권한 없으면 에러 없이 실패)


====== Storcli command should be used as root priviliges otherwise command result is not successful without any error message. ======
<syntaxhighlight lang="bash">
<syntaxhighlight lang="bash">
$ storcli show     #cli without priviliges
# 권한 없이 실행 (실패)
CLI Version = 007.2310.0000.0000 Nov 02, 2022
$ storcli show
Operating system = Linux 5.4.0-153-generic
Status Code = 0
Status = Success
Description = None
 
Number of Controllers = 0
Number of Controllers = 0
Host Name = shannon-nas
Operating System  = Linux 5.4.0-153-generic


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


$ sudo storcli show    ##cli with 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 = 1
<syntaxhighlight lang="bash">
Host Name = shannon-nas
$ sudo storcli show
Operating System  = Linux 5.4.0-153-generic


System Overview :
System Overview :
===============
===============
------------------------------------------------------------------------------------
------------------------------------------------------------------------------------
Ctl Model                  Ports PDs DGs DNOpt VDs VNOpt BBU sPR DS  EHS ASOs Hlth  
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
   0 AVAGOMegaRAIDSAS9361-8i    8  6  0    0  0    0 N/A On  1&2 Y      3 Opt
------------------------------------------------------------------------------------
------------------------------------------------------------------------------------
</syntaxhighlight>
**기호 설명:**
* 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


Ctl=Controller Index|DGs=Drive groups|VDs=Virtual drives|Fld=Failed
=== RAID 생성 ===
PDs=Physical drives|DNOpt=Array NotOptimal|VNOpt=VD NotOptimal|Opt=Optimal
 
Msng=Missing|Dgd=Degraded|NdAtn=Need Attention|Unkwn=Unknown
<syntaxhighlight lang="bash">
sPR=Scheduled Patrol Read|DS=DimmerSwitch|EHS=Emergency Spare Drive
# RAID6 생성 (6개 HDD)
Y=Yes|N=No|ASOs=Advanced Software Options|BBU=Battery backup unit/CV
$ sudo storcli /c0 add vd r6 name=RAID6 drives=0:0-5
Hlth=Health|Safe=Safe-mode boot|CertProv-Certificate Provision mode
 
Chrg=Charging | MsngCbl=Cable Failure
# 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
</syntaxhighlight>
</syntaxhighlight>


=== Storcli Commands Summary ===
**RAID 생성 옵션:**
{| class="wikitable"
* `strip=<8|16|32|64|128|256|512|1024>` — 스트라이프 크기
|+
* `pdcache=on|off|default` — 물리적 드라이브 캐시
!Type
* `wt|wb` — Write Through/Back
!Description
* `nora|ra` — Read Ahead
!Example
* `Spares=[e:]s|[e:]s-x` — 핫 스페어
|-
|System Commands
|show system status
|storcli show
storcli show all
 
storcli show ctrlcount


storcli show help
=== RAID 삭제 ===


storcli -v
<syntaxhighlight lang="bash">
|-
# 가상 드라이브 삭제
|Controller Commands
$ sudo storcli /c0/v0 del
|show and set controller properties
Syntax : 
storcli /cx show <property>


# 모든 가상 드라이브 삭제
storcli /cx set <property>=<value>
$ sudo storcli /c0/vall del
</syntaxhighlight>


=== 디스크 캐시 정책 ===
where x is controller number
|
* storcli /cx show
* storcli /cx show all
* 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
storcli /cx[/ex]/sx set properties
where,


* c specifies the controller #.
<syntaxhighlight lang="bash">
* e specifies the enclosure ID.
# 가상 드라이브 캐시 정책 설정
* s represents the slot in the enclosure.
$ sudo storcli /c0/v0 set pdcache=on
* e:s-x is the range convention used to represent slots s to x in the enclosure e.
$ sudo storcli /c0/v0 set rdcache=nora
|Sets physical drive properties
$ sudo storcli /c0/v0 set wrcache=wb
</syntaxhighlight>


* missing: Sets the drive status as missing.
**LSI 권장사항:**
* good: Sets the drive status to unconfigured good.
* 모든 RAID 레벨 → Direct I/O 권장
* offline: Sets the drive status to offline.
* RAID 0/1/10 (스트리밍) → Write Through 권장
* online: Sets the drive status to online.
* RAID 0/1/10 (랜덤) → Write Back 권장
* RAID 5/6 → Write Back 권장


Shows virtual drive information
=== Write Policy ===


* all: shows all properties of the physical drive
{| class="wikitable"
! Write Policy
! Description
! Recommendation
|-
|-
|Virtual Drives Commands
| Write Back (WB)
|Creates/Delete/Set/Show virtual drives
| 컨트롤러 캐시에 데이터 수신 시 완료 신호
|
| "bursty" 쓰기 환경에 효율적
|-
|-
|Foreign Configurations Commands
| Write Through (WT)
|
| 드라이브에 데이터 수신 시 완료 신호
|
| RAID 0/1/10 스트리밍 데이터에 권장
|-
|-
|BIOS-Related Commands
| Always Write Back (AWB)
|
| BBU 부재 시에도 Write Back 강제
|
| BBU 필수 (데이터 손실 위험)
|-
|Drive Group Commands
|
|
|-
|Dimmer Switch Commands
|Dimmer Switch is the power-saving policy for the virtual drive
|
|-
|BBU Commands
|
|
|-
|Enclosure Commands
|
|
|-
|PHY Commands
|
|
|-
|Logging Commands
|generate and maintain log files
|
|}
|}
=== 디스크 정보 확인 ===
<syntaxhighlight lang="bash">
# 사용 가능한 디스크 확인
$ 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  -
</syntaxhighlight>
**디스크 상태:**
* UGood: Unconfigured Good
* GHS: Global Hot Spare
* DHS: Dedicated Hot Spare
* Onln: Online
* Fld: Failed
=== Foreign Configuration 처리 ===
<syntaxhighlight lang="bash">
# Foreign Configuration 삭제
$ sudo storcli /c0/fall delete
# Foreign Configuration 확인
$ sudo storcli /c0/fall show
</syntaxhighlight>
=== 핫 스페어 관리 ===
{| class="wikitable"
{| class="wikitable"
|+Properties for Show and Set Commands
! Type
!Property Name
! Description
!Set Command Range
! Example
!Description
|-
|-
|abortcconerror
| Global Hot Spare
|<nowiki>on|off</nowiki>
| 모든 RAID 그룹에 자동 할당
|Aborts consistency check when it detects an inconsistency.
| `storcli /cx/ex/sx add hotsparedrive`
|-
|-
|activityforlocate
| Dedicated Hot Spare
|<nowiki>on|off</nowiki>
| 특정 RAID 그룹에 할당
|Enables/disables drive activity, drive activity locates function for systems without SGPIO/SES capabilities.
| `storcli /cx/ex/sx add hotsparedrive dgs=N`
|-
|-
|alarm
| Emergency Hot Spare
|<nowiki>on|off|silence</nowiki>
| SMART 오류 시 자동 할당
silence: Silences the alarm
| `storcli /cx set eghs eug=on`
|Enables/disables alarm on critical errors
|}
|-
|backplane
|0: Use autodetect logic of backplanes,
such as SGPIO and I2C SEP using GPIO


pins.
**핫 스페어 제거:**


1: Disable autodetect SGPIO.
<syntaxhighlight lang="bash">
# 핫 스페어 상태 제거
$ sudo storcli /c0/e65/s11 delete hotsparedrive
 
# 디스크 오프라인
$ sudo storcli /c0/e65/s11 set offline
</syntaxhighlight>


2: Disable I2C SEP autodetect.
=== 디스크 위치 찾기 ===


3: Disable both the autodetects.
<syntaxhighlight lang="bash">
|Configures enclosure detection on a non-SES/expander
# 디스크 깜빡이기 (물리적 위치 확인)
backplane.
$ sudo storcli /c0/e0/s2 start locate
|-
|batterywarning
|<nowiki>on|off</nowiki>
|Enables/disables battery warnings
|-
|bgirate
|0 to 100
|Sets background initialization rate in percentage.
|-
|cacheflushint
|0 to 255, default value 4
|Sets cache flush interval in seconds
|-
|ccrate
|0 to 100
|Sets consistency check rate in percentage
|-
|coercion
|0: No coercion
1: 128 MB


2: 1 GB
# 깜빡임 중지
|Sets drive capacity in coercion mode
$ sudo storcli /c0/e0/s2 stop locate
|-
</syntaxhighlight>
|consistencycheck
|See  Consistency Check.
|See  Consistency Check.
|-
|copyback
|<nowiki>on|off</nowiki>
type = smartssd|smarthdd|all


smartssd: Copy back enabled for SSD
=== 디스크 교체 ===


drives.
<syntaxhighlight lang="bash">
# 실패한 디스크 교체
$ sudo storcli /c0/e8/s0 insert dg=0 array=0 row=0


smarthdd: Copy back enabled for HDD
# 수동 리빌드 시작
$ sudo storcli /c0/e8/s0 start rebuild
</syntaxhighlight>


drives.
=== 디스크 직렬 번호 확인 ===


all: Copy back enabled for both ssd
<syntaxhighlight lang="bash">
$ sudo storcli /c0/eALL/sALL show all | egrep 'Device attributes|SN = '
</syntaxhighlight>


drives and HDD drives.
=== 디스크 상태 확인 (smartctl) ===


Example:
<syntaxhighlight lang="bash">
# 디바이스 ID 확인
$ sudo storcli /c0/eall/sall show


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


type=all
=== Direct Mode vs Persistent Mode ===
|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.
{| class="wikitable"
! Mode
! Description
! Use Case
|-
|-
|eccbucketleakrate
| Persistent (default)
|0 to 65535
| device IDs 변경 가능, expanders에 적합
|Sets leak rate of the single-bit bucket in minutes (one
| 기본값
entry removed per leak-rate).
|-
|-
|eccbucketsize
| Direct
|0 to 255
| device IDs 고정, phy 번호와 일치
|Sets size of ECC single-bit-error bucket (logs event
| 직접 연결 디스크
when full).
|}
|-
 
|enableeghsp
<syntaxhighlight lang="bash">
|<nowiki>on|off</nowiki>
# 현재 설정 확인
|Enables/disables the commissioning of otherwise
$ sudo storcli /c0 show directpdmapping
incompatible global hot spare drives as Emergency Hot
 
# Direct Mode 활성화
$ sudo storcli /c0 set directpdmapping=on
 
# Direct Mode 비활성화
$ sudo storcli /c0 set directpdmapping=off
</syntaxhighlight>
 
=== RAID 확장 ===
 
<syntaxhighlight lang="bash">
# 기존 RAID5에 디스크 추가
$ sudo storcli /c0/v0 start migrate type=raid5 option=add drives=8:0
</syntaxhighlight>


Spare (EHSP) drives
※ RAID 00, 10, 50, 60은 이 방식으로 확장 불가
|-
|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
=== StorCLI 명령어 요약 ===


applicable to non-FastPath
{| class="wikitable"
|Performance tuning setting for the controller
! Type
! Description
! Example
|-
|-
|pi
| System
|<nowiki>on|off</nowiki>
| 시스템 상태 확인
|Enables/disables data protection on the controller
| `storcli show`<br>`storcli show ctrlcount`<br>`storcli -v`
|-
|-
|preventpiimport
| Controller
|<nowiki>on|off </nowiki>
| 컨트롤러 속성
|Enables/disables import data protection drives on the controller
| `storcli /cx show`<br>`storcli /cx set rebuildrate=50`
|-
|-
|prcorrectunconfiguredareas
| Drive
|<nowiki>on|off </nowiki>
| 물리적 드라이브
|Correct media errors during PR by writing 0s to unconfigured areas of the disk
| `storcli /cx/ex/sx show`<br>`storcli /cx/ex/sx set good`
|-
|-
|prrate 
| Virtual Drive
|0 to 100
| 가상 드라이브
|Sets patrol read rate of the virtual drives in percentage
| `storcli /cx/vx show init`<br>`storcli /cx/vx start init full`
|-
|-
|rebuildrate
| Consistency Check
|0 to 100
| 일관성 검사
|Sets rebuild rate of the drive in percentage
| `storcli /cx/vx start cc`<br>`storcli /cx/vx pause cc`
|-
|-
|reconrate 
| Background Init
|0 to 100
| 백그라운드 초기화
|Sets reconstruction rate for a drive in percentage
| `storcli /cx/vx start bgi`<br>`storcli /cx/vx stop bgi`
|-
|-
|restorehotspare 
| Foreign Config
|<nowiki>on|off</nowiki>
| 외부 구성
|Becomes a hot spare on insertion of a failed drive.
| `storcli /c0/fall import`<br>`storcli /c0/fall delete`
|-
|-
|smartpollinterval 
| BBU/CV
|0 to 65535
| 캐시 보호
|Set time for polling of SMART errors in seconds
| `storcli /cx/cv show all`<br>`storcli /cx/bbu show status`
|-
|-
|spinupdrivecount
| Hot Spare
|0 to 255
| 핫 스페어
|Sets number of drives that are spun up at a time
| `storcli /cx/ex/sx add hotsparedrive`<br>`storcli /cx/ex/sx delete hotsparedrive`
|-
|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
|-
|
|
|
|}
|}
== Configuration ==
<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
# 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
</syntaxhighlight>
== Examples ==
=== Example 1: RAID6 생성 및 마운트 ===
<syntaxhighlight lang="bash">
# 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
</syntaxhighlight>
=== Example 2: 디스크 교체 ===
<syntaxhighlight lang="bash">
# 실패한 디스크 확인
$ 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
</syntaxhighlight>
== 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 ==
== 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"