본문으로 건너뛰기
Version: Next 🚧

문제 해결

볼륨 그룹 문제

볼륨 그룹이 Ready가 되지 않음

  1. Storage → Volume Groups에서 해당 볼륨 그룹을 클릭합니다
  2. 상태 메시지를 확인합니다

볼륨 그룹은 스토리지가 실제로 사용 가능해진 후에만 Ready로 표시됩니다. 스토리지 백엔드에서 멈춘 작업은 수 분 내에 자동으로 복구됩니다.

볼륨 그룹 생성이 거부됨

메시지원인조치
저장 공간 부족 / 한도 도달클러스터의 볼륨 그룹 상한 또는 노드별 용량에 도달했습니다. 메시지에 현재 최대값과 병목 요인이 표시됩니다.사용하지 않는 볼륨 그룹을 삭제하거나 용량을 추가합니다
최소 크기 미달요청 크기가 모든 스토리지 요구 사항을 충족할 수 없습니다대화상자에 표시된 최소 크기를 사용합니다
레이블 충돌다른 볼륨 그룹이 해당 레이블을 이미 사용 중입니다. 강제 삭제 후 아직 회수되지 않은 경우일 수 있습니다.다른 레이블을 사용하거나 잔여 스토리지를 먼저 회수합니다
잠시 후 다시 시도생성 요청이 동시에 몰렸습니다잠시 후 재시도합니다

용량이 예상보다 적게 표시됨

먼저 Hardware → Drives에서 모든 데이터 드라이브가 Healthy, In Cluster인지 확인합니다. 그다음 Analytics → Capacity를 비교합니다. 할당(allocated) 용량은 볼륨 그룹의 요청 크기에서 계산되므로, 미할당 공간은 아직 예약하지 않은 용량입니다.

볼륨 문제

볼륨이 Provisioning에서 멈춤

  1. Storage → Volumes에서 해당 볼륨을 클릭합니다
  2. 상태 메시지를 확인합니다 — 프로비저닝은 보통 수 분 내에 완료됩니다

프로비저닝을 완료할 수 없는 볼륨은 멈춘 상태로 남지 않고 메시지와 함께 Failed로 전환됩니다.

마운트 실패: 볼륨을 찾을 수 없거나 연결할 수 없음

마운트는 스토리지 백엔드의 연결 가능 여부를 먼저 확인하므로, 연결할 수 없으면 멈춰 있지 않고 명확한 메시지와 함께 즉시 실패합니다.

  1. Storage → Volumes에서 볼륨이 Ready인지 확인합니다
  2. 상위 볼륨 그룹이 Ready인지 확인합니다
  3. Hardware → Nodes에서 non-Ready 또는 Unreachable 상태의 노드가 있는지 확인합니다

마운트 실패: permission denied / access denied

다음을 확인합니다:

  1. 아이덴티티가 Active인지 — Identity & Access → Users & Groups(또는 Machines)
  2. 해당 볼륨에 필요한 권한을 부여하는 접근 정책이 있는지 — Identity & Access → Access Rules
  3. 클라이언트 인증서가 유효한지. mass-ctl login 인증서는 기본 24시간 유효하므로 만료되었으면 mass-ctl login을 다시 실행합니다.
  4. 정책을 최근에 변경했다면 재마운트합니다 — 권한 변경은 기존 마운트에 재마운트 후에 적용됩니다

네트워크 카드가 여러 개인 호스트에서 마운트 실패

호스트에 스토리지 네트워크 서브넷에 속한 네트워크 카드가 없으면 mass-ctl이 불일치 내용을 알려주는 오류와 함께 즉시 중단합니다. 클라이언트를 스토리지 패브릭에 연결하거나, 올바른 인터페이스에 해당 서브넷의 주소가 설정되어 있는지 확인합니다.

볼륨 삭제가 완료되지 않음

  • 마운트된 볼륨은 사전에 거부됩니다 — 마운트를 해제하면 삭제가 자동으로 이어집니다
  • 클라이언트가 비정상 종료(전원 손실, 강제 종료)된 볼륨은 수 분 내에 스스로 완료됩니다
  • 그 외의 경우 강제 삭제를 사용한 뒤 Storage → Orphan Storage에서 남은 스토리지를 회수합니다