tunefs.lustre는 Lustre 파일 시스템에서 MGT, MDT, OST와 같은 스토리지 대상의 설정을 조정하는 핵심 유틸리티로, 일반적으로 대상 장치가 **마운트 해제된 상태**에서 사용됩니다. 주요 매개변수들을 분류하여 사용법과 일반적인 시나리오를 설명합니다.
1. 주요 매개변수 분류 및 사용법
1.1. 대상 유형 지정
--mgs: 장치를 관리 서비스(MGS)로 지정합니다.--nomgs: MDT에서 MGS 서비스를 비활성화합니다(복합 대상에 해당).--ost/--mdt: 대상 유형을 지정합니다(--index와 함께 사용해야 합니다).
1.2. 파일 시스템 식별
--fsname=<name>: 파일 시스템 이름을 지정합니다 (8자 이하, 예:--fsname=fs1). MGS를 제외하고 **필수**입니다.--index=<N>: 대상의 인덱스 번호를 설정합니다 (예: MDT0000의 경우0). 10진수 또는 16진수(0x0)를 지원합니다.
1.3. MGS 노드 설정
--mgsnode=<NID>: MGS의 네트워크 식별자(NID)를 지정합니다. 형식은192.168.0.1@tcp0과 같습니다. OST/MDT에 **필수**입니다.--failnode=<NID>: 장애 조치 노드를 설정합니다 (--servicenode와 상호 배타적).--servicenode=<NID>: 여러 서비스 노드를 지정하여 부하를 분산합니다.
1.4. 매개변수 관리
--param <key>=<value>: 영구적인 설정을 적용합니다 (재시작 시 적용됨).# I/O 타임아웃 시간 수정 tunefs.lustre --param="sys.timeout=50" /dev/sda1 # OST 장애 처리 모드 설정 tunefs.lustre --param="failover.mode=failout" /dev/ost1--erase-param <key>: 개별 매개변수를 삭제합니다.--erase-params: **모든 기존 매개변수**를 지웁니다.--param과 함께 사용하여 설정을 재구성해야 합니다.tunefs.lustre --erase-params --param="new_param=value" /dev/sdb
1.5. 고급 작업
--writeconf: **구성 파일을 강제로 재생성**합니다 (손상된mountdata등을 복구). **주의**: 이 작업은 관련 대상 모두를 마운트 해제해야 하며, 구성이 초기화될 수 있습니다.--rename=<new_fsname>: 파일 시스템 이름을 변경합니다 (전역적으로 고유해야 합니다).--backfstype=zfs: ZFS 백엔드 스토리지를 지정합니다. 장치 경로 대신 풀 이름/데이터셋 이름을 사용해야 합니다 (예:tank/ost1).
2. 일반적인 작업 시나리오
2.1. OST 장애 조치 노드 변경
tunefs.lustre --ost --fsname=fs1 --index=0 --mgsnode=192.168.0.10@tcp0 \
--param="failover.node=192.168.0.11@tcp0" /dev/sda1
결과: 주 노드에 장애가 발생하면 OST0000이 자동으로 예비 노드로 전환됩니다.
2.2. 손상된 구성 파일 복구
tunefs.lustre --writeconf --fsname=fs1 --index=0 --mgsnode=192.168.0.10@tcp0 /dev/ost1
상황: 정전으로 인해 OST가 마운트되지 않을 때, CONFIGS/ 디렉토리의 메타데이터를 재생성합니다.
2.3. ZFS 백엔드 스토리지 매개변수 조정
tunefs.lustre --backfstype=zfs --fsname=fs1 --index=1 \
--param="zfs.lz4_compress=1" tank/ost1
결과: LZ4 압축을 활성화하여 스토리지 효율성을 높입니다.
3. 매개변수 사용 시 주의사항
- 작업 전제 조건: 대상 장치가 반드시 **마운트 해제**되어야 합니다(
umount). 그렇지 않으면 수정이 적용되지 않습니다. - 매개변수 상속:
--param으로 설정된 매개변수는 기존 값을 덮어쓰지만, 서비스 재시작이 필요합니다. - ZFS 전용 구문: 풀 이름/데이터셋 이름을 사용할 때는 장치 경로(예:
/dev/sda)를 생략해야 합니다. - 주의 필요 작업:
--writeconf및--erase-params는 설정을 영구적으로 삭제할 수 있으므로, 작업 전에 반드시 백업하십시오.
4. 자주 사용되는 매개변수 요약표
| 매개변수 | 기능 | 예시 |
|---|---|---|
--param <key>=<value> |
영구 매개변수 설정 | --param="lov.stripesize=4M" |
--erase-params |
모든 기존 매개변수 삭제 | --param과 함께 사용하여 설정 재구성 |
--writeconf |
구성 파일 재생성 (복구용) | 손상된 mountdata 복구 |
--failnode=<NID> |
장애 조치 노드 지정 | --failnode=192.168.1.2@tcp0 |
--backfstype=zfs |
ZFS 백엔드 스토리지 선언 | 풀 이름(예: tank/ost1)과 함께 사용 |
전체 매개변수는 공식 문서를 참조하거나 tunefs.lustre --help를 실행하십시오.