---

---

---

1. 개요

• OMV는 물리 디스크를 서비스에 노출하기까지 4단계 계층을 거칩니다. 앞 단계를 완료해야 다음 단계의 선택 목록에 장치가 나타납니다.

[물리 디스크]
     │ ① 지우기 (Wipe)
     ▼
[빈 디스크]
     │ ② 파일 시스템 생성 (mkfs)
     ▼
[파일 시스템]
     │ ③ 마운트 + 변경사항 적용
     ▼
[마운트된 볼륨]
     │ ④ 공유 폴더 생성 + 변경사항 적용
     ▼
[공유 폴더] ──▶ (범위 밖) SMB / NFS / Docker 볼륨

• 범위: ① ~ ④
• 범위 밖: SMB/NFS 공유 설정, 사용자 권한 관리, RAID 구성

---

2. 환경

항목	값
하드웨어	Raspberry Pi 5
스토리지 확장	Radxa Penta SATA HAT (JMB585 PCIe→SATA)
OS	Raspberry Pi OS Lite (64-bit)

---

3. 사전 조건

항목	내용
데이터 손실	지우기는 파티션 테이블과 파일 시스템 서명을 제거하며 복구가 불가능합니다. 사전 백업이 필요합니다.
대상 식별	장치명(/dev/sdX)은 재부팅 시 변경될 수 있으므로 모델명 + 일련번호로 식별해야 합니다.
OS 디스크	부팅 디스크(본 환경에서는 /dev/mmcblk0)는 작업 대상에서 제외합니다.

---

4. 용어

4.1 기본 개념

용어	설명
디스크(Disk)	물리 저장 장치 자체를 말합니다. /dev/sda, /dev/sde 처럼 표기됩니다.
파티션(Partition)	하나의 디스크를 나눠 놓은 영역입니다. 장치명 뒤에 숫자가 붙습니다. /dev/sde1
파일 시스템(File System)	파티션 안에 데이터를 정리해 저장하는 방식입니다. XFS, EXT4, BTRFS 등이 있습니다.
포맷 / mkfs	파티션에 파일 시스템을 새로 만드는 작업입니다.
마운트(Mount)	파일 시스템을 특정 폴더 경로에 연결해 실제로 파일을 읽고 쓸 수 있게 만드는 작업입니다.
공유 폴더(Shared Folder)	SMB·NFS 같은 서비스에 내보내기 위해 OMV에 등록하는 폴더입니다.
지우기(Wipe)	파티션 정보와 기존 파일 시스템 흔적을 지워 디스크를 빈 상태로 되돌리는 작업입니다.

4.2 저장소 관련

용어	설명
GPT	디스크를 어떻게 나눴는지 기록하는 최신 방식입니다. 2TB가 넘는 디스크에는 반드시 필요합니다.
UUID	파일 시스템마다 붙는 고유 번호입니다. 장치명과 달리 한번 정해지면 바뀌지 않습니다.
/dev/sdX	SATA·USB 디스크에 붙는 이름입니다. 인식되는 순서에 따라 재부팅할 때마다 바뀔 수 있습니다.
S.M.A.R.T	디스크가 스스로 상태를 점검하는 기능입니다. 고장 조짐을 미리 파악하는 데 씁니다.
AG (Allocation Group)	XFS가 볼륨을 여러 덩어리로 쪼개 동시에 처리하는 단위입니다. 로그에 agcount=4 형태로 나옵니다.
내부 로그(internal log)	XFS가 작업 내역을 기록해 두는 공간입니다. 갑자기 전원이 꺼져도 빠르게 복구할 수 있게 해 줍니다.
ACL	소유자와 그룹 외에 사용자 한 명 한 명에게 따로 권한을 주는 방식입니다.

4.3 메뉴 구조

메뉴	역할
저장소 > 디스크	물리 디스크 목록, 지우기
저장소 > S.M.A.R.T	디스크 건강 상태 모니터링
저장소 > 파일 시스템	파일 시스템 생성 및 마운트
저장소 > 공유 폴더	서비스에 내보낼 폴더 정의

---

5. 절차

5.1 디스크 지우기

• 경로 : 저장소 → 디스크

1. 목록에서 대상 디스크를 클릭해서 선택합니다. 선택한 행이 강조되고 하단에 1 selected / N total이 표시됩니다.
2. 툴바의 지우개 아이콘을 클릭합니다.
3. 확인 창에서 지우기 방식을 선택합니다.

방식	동작	소요 시간	용도
빠른(Quick)	디스크 앞부분의 파티션 정보와 파일 시스템 흔적만 제거	수 초	일반적인 재사용
보안(Secure)	디스크 전체를 다른 값으로 덮어씀	수 시간	매각·폐기

1. 실행 결과를 확인합니다.

출력	의미
Creating new GPT entries in memory.	새 GPT 파티션 테이블을 생성했습니다.
GPT data structures destroyed!	기존 파티션 구조를 제거했습니다.
10485760 bytes (10 MB) copied	디스크 시작/끝 10MB를 0으로 덮어썼습니다.
END OF LINE	작업이 종료되었음을 나타냅니다.

5.2 파일 시스템 생성

• 경로 : 저장소 → 파일 시스템

1. 툴바의 + 아이콘을 클릭하고 파일 시스템 종류를 선택합니다.

종류	특성	적용 대상
EXT4	리눅스 표준입니다. 복구 도구가 많습니다	범용 기본값
XFS	대용량 파일 쓰기·병렬 I/O가 우수하며 온라인 확장을 지원합니다	미디어·백업 볼륨
BTRFS	스냅샷·체크섬을 지원하나 설정이 복잡하고 RAID5/6는 권장하지 않습니다	스냅샷이 필요한 경우
F2FS	플래시 메모리에 최적화되어 있습니다	SD카드, eMMC
JFS	사실상 유지보수만 이루어지고 있습니다	권장하지 않습니다

1. 장치 드롭다운에서 대상 디스크를 선택하고 저장을 클릭합니다.

1. mkfs 실행 결과를 확인하고 닫기를 클릭합니다.

출력	의미
meta-data=/dev/sde1	파티션이 자동 생성되었습니다. (sde → sde1)
isize=512	inode 크기가 512바이트입니다.
agcount=4, agsize=7814612 blks	4개 Allocation Group, 그룹당 약 30 GiB입니다.
bsize=4096, blocks=31258448	블록 4KB × 31,258,448 ≈ 119.24 GiB입니다.
crc=1	메타데이터 체크섬이 활성화되었습니다.
log =internal log, blocks=16384	볼륨 내부에 64 MiB 저널이 생성되었습니다.
Discarding blocks...Done.	SSD TRIM을 수행했습니다.

5.3 마운트

1. 파일 시스템을 선택하고 저장을 클릭합니다.

필드	입력값	설명
파일 시스템	/dev/sde1 [XFS, 119.24 GiB]	마운트할 대상입니다.
Usage Warning Threshold	85% (기본값 유지를 권장합니다)	사용률 초과 시 알림을 발송합니다.
Tags	(비움)	분류용 선택 항목입니다.

5.4 변경사항 적용 (1차)

• OMV는 웹 UI의 조작을 즉시 시스템에 반영하지 않고 대기 상태로 보관합니다. /etc/fstab 등 실제 시스템 파일에는 적용 시점에 반영됩니다.

1. 적용 전 상태입니다. 사용 가능, 마우트됨 열이 비어있습니다.
2. 노란색 Pending configuration changes 배너 우측 체크 아이콘을 클릭합니다.

1. 적용 후 상태입니다.

5.5 공유 폴더 생성

• 경로 : 저장소 → 공유 폴더

1. 툴바의 + 아이콘을 클릭합니다.

1. 각 필드를 입력합니다.
2. 저장을 클릭합니다.

필드	입력값	비고
이름	128G	영문·숫자를 권장합니다. 한글·공백을 사용하면 CLI/Docker 경로 처리에 불리합니다.
파일 시스템	/dev/sde1 [XFS, 2.31 GiB (2%) used, 116.86 GiB available]	5.4를 완료하지 않으면 목록에 표시되지 않습니다.
Relative path	128G/	이름 입력 시 자동으로 채워지며, 폴더가 없으면 생성됩니다.
권한	아래 표를 참조하시기 바랍니다	폴더의 리눅스 권한입니다.
Tags	(비움)	선택 항목입니다.

5.6 변경사항 적용 (2차)

1. 생성된 공유 폴더 정보를 확인합니다.
2. 체크 아이콘을 클릭해 적용합니다.

1. 공유 폴더가 128G가 Available 상태로 생성됩니다. 이후 SMB/NFS 볼륨 선택 목록에 나타납니다.

---