← 전체로 돌아가기
스킬 storage

ZFS Zpool 가져오기 및 관리

ZFS 풀 가져오기, 이름 변경, 마운트 설정 및 디스크 초기화.

zfslinuxstoragezpooldisk-management

ZFS zpool 관리 핵심 팁이야. 풀 가져오기, 이름 변경, 마운트 포인트 설정, 그리고 디스크 초기화까지 한 번에 정리해봤어.

ZFS 설치 및 확인

sudo apt install zfsutils-linux
zfs --version
zfs list

ZFS 풀 이름 변경

기존 풀 이름을 바꾸려면 export 후 새 이름으로 import하면 돼.

sudo zpool export [기존_풀_이름]
sudo zpool import [기존_풀_이름] [새_풀_이름]
# 예: sudo zpool import raid1_12tb pool0_12tb

가져올 수 있는 풀 확인

아직 import되지 않은 풀이 있는지 확인하려면:

sudo zpool import

ZFS 풀 마운트 포인트 변경

풀의 마운트 경로를 바꾸려면 zfs set mountpoint 명령어를 사용해.

sudo zfs set mountpoint=[새_경로] [풀_이름]
# 예: sudo zfs set mountpoint=/mnt/pool1_6tb pool1_6tb

디스크 초기화 (기존 데이터 제거)

새 디스크를 ZFS로 사용하기 전, 기존 파일 시스템이나 LVM 데이터를 지워야 할 때. * LVM 중지: sudo vgchange -an * RAID (md) 확인/중지: sudo cat /proc/mdstat, sudo mdadm --stop /dev/md127 * 파일 시스템 시그니처 제거:

sudo wipefs -a /dev/sdi # 해당 디스크명으로

디스크 ID 기반 ZFS 풀 가져오기

디스크 경로(예: /dev/sdi)는 바뀔 수 있으니, 안정적인 by-id 경로를 사용하는 게 좋아. 1. 풀 생성: sudo zpool create pool1_6tb mirror sdi sdj 2. 풀 내보내기: sudo zpool export pool1_6tb 3. ID 경로로 다시 가져오기:

sudo zpool import -d /dev/disk/by-id pool1_6tb

여기서 배울 것

  1. ZFS 풀 이름 변경 및 마운트 포인트 설정 방법
  2. 새 디스크 사용 전 기존 파일 시스템 데이터 제거 요령
  3. 디스크 ID 기반으로 ZFS 풀 가져오기 (안정성 확보)
  4. ZFS 기본 명령어 (설치, 목록 확인)
원본 파일 보기 (.claude/skills/tn-zfs-zpool-import/SKILL.md)
---
name: ZFS Zpool Import & Management
description: This skill should be used when the user asks to import an existing ZFS zpool, rename a zpool, change its mount point, or prepare disks for ZFS by wiping old filesystem data.
version: 1.0.0
source: /home/son/prj/resume/backup_notes_260317/notion/Tech Note/zfs zpool import 2f2d7efd824b80a0bab2c0dd9629ec1b.md
---

# zfs zpool import

install :

```c
sudo apt install zfsutils-linux
```

```c
zfs --version
```

zfs list

```c
son@son-x99:/mnt$ zfs list
NAME         USED  AVAIL  REFER  MOUNTPOINT
pool0_12tb  2.71T  8.07T  2.71T  /mnt/pool0_12tb
pool1_6tb    780K  5.33T    96K  /mnt/pool1_6tb
pool2_4tb   1.38T  2.14T  1.38T  /mnt/pool2_4tb
pool3_4tb   2.89T   639G  2.89T  /mnt/pool3_4tb
pool4_4tb   1.71T  1.80T  1.71T  /mnt/pool4_4tb
```

change name

```bash
sudo zpool export [풀 네임]
sudo zpool import [풀 네임] [새 네임]

예시)
sudo zpool export raid1_12tb
sudo zpool import raid1_12tb pool0_12tb
```

check possible pool

(it doesn’t import yet. just check up)

```bash
sudo zpool import
```

change mount point

```bash
# 예: pool1_6tb를 /mnt/data6 에 마운트하고 싶을 때
sudo zfs set mountpoint=[주소] [풀 이름]
sudo zfs set mountpoint=/mnt/pool1_6tb pool1_6tb
```

기존 data remove

```bash
# 모든 활성화된 LVM 볼륨 그룹 중지
sudo vgchange -an
```

md check (multiple devices)

```bash
sudo cat /proc/mdstat
```

stop

```bash
sudo mdadm --stop /dev/md127
sudo mdadm --stop /dev/md4
```

wipe file system

```bash
sudo wipefs -a /dev/sdi
sudo wipefs -a /dev/sdj
```

import

```bash
# 1. 생성
sudo zpool create pool1_6tb mirror sdi sdj
# -f 가 필요할수도?

# 2. 내보내기 (ID 기반 전환을 위해)
sudo zpool export pool1_6tb

# 3. ID 경로로 다시 가져오기
sudo zpool import -d /dev/disk/by-id pool1_6tb
```

import hdd by id

brief structure

```bash
pool0_12tb = sdb / sde
pool1_6tb = sdi / sdj

pool2_4tb = sdd(기존나스1번) / sdc (wd purple)
pool3_4tb = sda(기존나스2번) / sdf (hgst 같은모델)(번호안붙음)
pool4_4tb = sdg(기존나스3번) / sdh(wd blue)
```

[fdisk / lsblk result](zfs%20zpool%20import/fdisk%20lsblk%20result%202f3d7efd824b80b59ad8ce050fe528a3.md)