Version: Next 🚧

문제 해결

`command not found: mass-ctl`

클라이언트 머신에 mass-client 패키지가 설치되어 있는지 확인하십시오:

mass-ctl --version

패키지가 설치되어 있는데도 명령을 찾을 수 없으면 새 로그인 셸을 여십시오. 패키지가 /etc/profile.d를 통해 /opt/boostx-sds/bin을 PATH에 추가합니다.

mass-ctl login으로 유효한 인증서를 받거나, --cert / --key / --ca로 머신 인증서를 지정합니다
대시보드의 Identity & Access → Users & Groups 또는 Machines에서 아이덴티티가 Active인지 확인합니다
Identity & Access → Access Rules에서 대상 볼륨에 필요한 권한을 부여하는 접근 정책이 있는지 확인합니다
볼륨이 마운트된 상태에서 정책을 변경했다면 재마운트합니다 — 권한 변경은 기존 마운트에 재마운트 후 적용됩니다

mass-ctl login을 다시 실행합니다. 머신 인증서는 장기 유효하며 거의 만료되지 않습니다. 재발급이 필요하면 호스트에서 sudo mass-ctl machine register를 다시 실행하십시오.

클라이언트 호스트에 스토리지 네트워크 서브넷의 네트워크 카드가 있어야 합니다. mass-ctl은 연결 타임아웃까지 멈춰 있는 대신 불일치 내용을 알려주는 오류와 함께 즉시 중단합니다.

클라이언트가 스토리지 패브릭에 연결되어 있는지 확인합니다
해당 인터페이스에 그 서브넷의 주소가 있는지 확인합니다
네트워크 카드가 여러 개이고 기본 주소가 스토리지 네트워크 밖에 있는 호스트에서는 클라이언트가 올바른 카드를 자동으로 선택합니다. 선택할 수 없으면 시도한 네트워크를 오류 메시지에 알려줍니다

노드의 스토리지 서비스가 재시작되면 기존 마운트는 스스로 복구되며, 마운트가 재설정되어 다음 접근이 정상 동작합니다. 클라이언트를 재부팅할 필요는 없습니다. 오류가 계속되면 언마운트 후 다시 마운트하십시오.

재부팅 복구는 기본으로 등록됩니다. 해당 마운트를 --no-fstab(명시적 임시 마운트)으로 만들지 않았는지 확인하십시오. 비 root 등록은 패키지와 함께 설치되는 헬퍼를 통하므로, 패키지가 부분적으로 제거되지 않았는지도 확인합니다.

작업 시작 전에 셸에서 eval $(mass-ctl env --bandwidth)를 실행합니다
패브릭이 의도한 전송 방식으로 동작하는지 확인합니다 — Hardware → Network에 패브릭 프로토콜 칩(RDMA 또는 TCP)이 표시됩니다
이더넷 패브릭이면 스위치를 포함해 점보 프레임(MTU 9000)이 끝까지 설정되어 있는지 확인합니다
멀티 소켓 호스트에서는 클라이언트가 이미 가장 가까운 네트워크 카드를 자동으로 선택합니다

필요한 MPI 런타임은 패키지에 포함되어 있습니다. Mellanox OFED 호스트에서는 호환되는 MPI가 자동으로 선택됩니다. 직접 설치한 MPI를 사용하려면 --mpi-prefix를 지정하십시오.

--verbose를 추가하거나 로그 레벨을 높입니다:

mass-ctl --log-level debug mount --volume-id <id> -m /mnt/data