문제 해결
대시보드 접근 불가
증상: 브라우저에서 https://<head-node-ip>:30082에 접속되지 않음
확인 사항:
- 헤드 노드 전원이 켜져 있고 네트워크 케이블이 연결되어 있는지
- 관리 인터페이스와 같은 네트워크에 있거나 라우팅 경로가 있는지
- 워크스테이션과 헤드 노드 사이에서
30082(HTTPS),30080(HTTP),30083(REST API) 포트가 방화벽에 막혀 있지 않은지
방금 전원을 켰다면 관리 소프트웨어가 기동될 때까지 2~3분 기다립니다.
시스템 상태가 Degraded 또는 Failed
모든 페이지 상단 배너에 각 원인과 권장 해결 방법이 표시됩니다. 항목마다 하나 이상의 복구 동작이 제공되며, 영향이 적은 순서로 정렬됩니다. 실행 전 대화상자에서 동작 내용, 데이터 접근 중단 여부, 소요 시간, 되돌릴 수 있는지를 안내하며, 영향이 큰 동작은 명시적 확인을 요구합니다.
대시보드에서 안전하게 처리할 수 없는 상황은 실행 버튼 대신 호스트에서 수행할 절차와 System → Support로 가는 경로가 안내됩니다.
노드가 Ready 상태가 아님
Hardware → Nodes에서 해당 노드를 클릭합니다.
| 상태 | 원인 추정 | 조치 |
|---|---|---|
| Initializing | 노드가 기동 중 | 전원 인가 후 5~10분 대기 |
| Degraded | 하드웨어 문제 또는 패브릭에서 스토리지 일시 연결 불가 | 노드의 드라이브·링크 상태 확인. 연결 불가 스토리지는 자동 복구됩니다 |
| Failed | 노드에 연결할 수 없음 | 네트워크 케이블과 전원 확인, 노드 상태 표시등 확인 |
노드는 도달 가능 상태(Synced / Recovering / Unreachable)도 함께 표시합니다.
Recovering은 정상이며 스스로 해소됩니다. Unreachable이 계속되면 패브릭 링크를 점검하세요.
스토리지 엔진이 응답하지 않음
드라이브 I/O를 담당하는 엔진이 응답을 멈추고 자동 복구가 중단되면 모든 사용자에게 경고 배너가 표시됩니다. 관리자에게는 배너에 Recover engine 버튼이 제공되며, 확인 절차를 거쳐 해당 엔진을 재시작합니다. 이 과정에서 해당 드라이브에 대한 I/O가 잠시 중단될 수 있습니다.
용량이 예상보다 적음
Hardware → Drives로 이동합니다.
- 모든 데이터 드라이브가 Healthy, In Cluster로 표시되어야 합니다
- Failed로 표시된 드라이브는 이 페이지에서 교체할 수 있습니다 — 드라이브 교체 참조
- System Disk로 표시된 드라이브는 부트 드라이브이며 클러스터 스토리지가 아닙니다
드라이브가 정상인데도 용량이 부족하면 용량이 예상보다 적게 표시됨을 참조하세요.
볼륨 그룹 또는 볼륨이 Provisioning에서 멈춤
프로비저닝은 보통 수 분 내에 완료됩니다. 스토리지 백엔드에서 멈춘 작업은 수 분 내에 자동으로 복구되며, 그래도 완료할 수 없는 볼륨은 멈춘 상태로 남지 않고 메시지와 함께 Failed로 전환됩니다.
10분 이상 Provisioning 상태가 유지되면:
- Storage → Volume Groups(또는 Volumes)에서 해당 항목을 클릭합니다
- 상태 메시지를 확인합니다
- Hardware → Nodes에서 대상 노드가 Ready인지 확인합니다
일반적인 원인:
- 사용 가능 용량 부족 — 사용량 대비 총 용량 확인
- 프로비저닝 중 노드가 오프라인이 됨
대시보드 접근 권한 상실
대시보드에 접근할 수 있으면 My Profile → Change Password에서 본인 비밀번호를 변경하거나, 다른 관리자가 Identity & Access → Users & Groups에서 계정을 재설정할 수 있습니다.
관리자 누구도 로그인할 수 없으면, 어플라이언스에 셸 접근이 가능한 운영자가 관리자 계정을 복구할 수 있습니다:
sudo mass-ctl reset-admin-password --restore-access
관리자 아이덴티티를 다시 활성화하고 관리 서비스를 재시작합니다. 셸 접근이 불가능하면 MangoBoost 지원팀에 문의하세요.
대시보드에 오래된 데이터가 표시됨
대부분의 화면은 자동으로 갱신됩니다. 계속 오래된 데이터가 보이면 페이지를 새로 고치고, 그래도 해결되지 않으면 로그아웃 후 다시 로그인합니다.