명령어

팁

모든 명령어는 --help로 전체 플래그를 확인할 수 있으며, 설치 후 탭 완성 기능을 사용할 수 있습니다.

mount

볼륨을 로컬 디렉터리에 마운트합니다.

mass-ctl mount \
  --volumegroup-label <vg-label> \
  --volume-label <vol-label> \
  -m <mount-point>

UUID를 사용하는 경우:

mass-ctl mount \
  --pool-uuid <pool-uuid> \
  --container-uuid <container-uuid> \
  -m /mnt/data

옵션:

플래그	설명
--volumegroup-label	VolumeGroup 레이블 (사람이 읽을 수 있는 이름)
--volume-label	Volume 레이블 (사람이 읽을 수 있는 이름)
--pool-uuid	VolumeGroup UUID (레이블 대신 사용)
--container-uuid	Volume UUID (레이블 대신 사용)
-m, --mount-point	볼륨을 마운트할 로컬 디렉터리

unmount

마운트된 볼륨을 언마운트합니다.

mass-ctl unmount -m /mnt/data

volume

CLI에서 Volume을 관리합니다.

mass-ctl volume list               # 모든 볼륨 목록 조회
mass-ctl volume list --mine        # 내 계정으로 접근 가능한 볼륨만 조회
mass-ctl volume get <id>           # 볼륨 상세 정보 확인
mass-ctl volume create --name <이름> --volumegroup <vg-id> --size <bytes> --type posix
mass-ctl volume delete <id>

volumegroup

CLI에서 VolumeGroup을 관리합니다.

mass-ctl volumegroup list
mass-ctl volumegroup get <id>
mass-ctl volumegroup create --name <이름> --label <레이블> --size <bytes>
mass-ctl volumegroup delete <id>

volume snapshot

Volume의 스냅샷을 관리합니다.

mass-ctl volume snapshot list <volume-id>
mass-ctl volume snapshot create <volume-id> --name <스냅샷-이름>
mass-ctl volume snapshot delete <snapshot-id>

volume access / volumegroup access

CLI에서 접근 정책을 직접 관리합니다 (관리자 전용). 일반적인 접근 관리는 대시보드 접근 → 정책을 사용하세요.

mass-ctl volume access list <volume-id>
mass-ctl volume access grant <volume-id> --identity <identity-id> --permissions read,write
mass-ctl volume access revoke <identity-id> <policy-id>

env

현재 셸 세션의 I/O 성능을 최적화하는 환경변수를 설정합니다.

# 대용량 순차 I/O 최적화 (최대 대역폭)
eval $(mass-ctl env --mode bandwidth)

# 메타데이터 집약적 워크로드 최적화
eval $(mass-ctl env --mode metadata)

# 표준 설정으로 초기화
eval $(mass-ctl env --mode standard)

성능 가이드:

모드	일반적인 처리량	최적 워크로드
standard	500~800 MB/s	일반 워크로드
bandwidth	3~5 GB/s	대용량 파일 읽기/쓰기, AI 학습 데이터
metadata	높은 IOPS	소형 파일 다수, 체크포인팅