File Storage 문제 해결

본 문서는 File Storage 서비스 사용 중 발생할 수 있는 문제를 해결하는 방법을 안내합니다.

• 마운트 오류
  • 마운트 포인트가 존재하지 않음
  • 이미 마운트됨
  • 접근 거부 또는 연결 시간 초과
• 체크섬 불일치 (Checksum mismatch)

---

마운트 오류

마운트가 실패하거나 예상대로 작동하지 않는 경우, 아래의 원인과 해결 방법을 참조하여 문제를 해결하십시오.

마운트 포인트가 존재하지 않음

마운트 대상 경로인 Mount PATH가 존재하지 않거나 잘못 지정되었습니다.

오류 메시지

mount.nfs: mount point {Mount PATH} does not exist

▶️ 해결 방법

1. Mount PATH가 정확한지 확인합니다.
2. 경로가 존재하지 않는 경우, 다음 명령어로 경로에 맞게 마운트 대상 파일을 생성하시기 바랍니다.

mkdir -p {Mount PATH}

3. 다시 마운트를 시도합니다.

이미 마운트됨

해당 파일 시스템이 이미 마운트된 상태입니다.

오류 메시지

mount.nfs: ... already mounted

▶️ 해결 방법

1. mount 명령어를 실행하여 현재 마운트된 파일 시스템을 확인합니다.

   mount | grep {Mount PATH}

   명령어 실행 결과 예시

   $ mount | grep /mnt/my_nfs
   192.168.1.100:/export/nfs/share on /mnt/my_nfs type nfs (rw,relatime,vers=4.2,rsize=1048576,wsize=1048576,namlen=255,hard,proto=tcp,timeo=600,retrans=2,sec=sys,clientaddr=192.168.1.101,local_lock=none)

   위 예시에서 /mnt/my_nfs 경로는 192.168.1.100:/export/nfs/share가 이미 마운트된 상태임을 나타냅니다. 파일 시스템 타입은 nfs, 권한은 rw(읽기/쓰기)로 설정되어 있습니다.

2. 추가 마운트가 불필요한 경우, 기존 마운트를 유지합니다.

3. 기존 마운트를 해제해야 하는 경우, 다음 명령어를 실행하여 언마운트합니다.

   umount {Mount PATH}

   명령어 실행 결과 예시

   $ umount /mnt/my_nfs

   언마운트 후 mount 명령어를 다시 실행하여 /mnt/my_nfs가 더 이상 표시되지 않으면 성공적으로 해제된 것입니다.

접근 거부 또는 연결 시간 초과

File Storage의 접근 제어 설정에서 마운트하려는 클라이언트 IP 주소가 허용되지 않았거나, 클라이언트와 File Storage 간 네트워크 연결에 문제가 발생할 수 있습니다.

오류 메시지

mount.nfs: ... access dened 또는 Connection timed out

▶️ 해결 방법

1. File Storage 접근 제어 설정을 확인하고, 클라이언트 IP 주소를 허용 목록에 추가합니다.

2. 클라이언트 인스턴스에서 File Storage와 통신이 가능한지 네트워크 연결을 확인합니다.

   • 포트 확인

   telnet {File Storage IP} 2049
   • telnet 명령어가 실패하는 경우, 다음 항목을 점검합니다.
     • 클라이언트의 보안 그룹에서 2049(NFS)포트의 인바운드 트래픽이 허용되었는지 확인합니다.
     • 클라이언트와 File Storage가 동일한 서브넷에 있거나, 라우팅 및 보안 그룹이 올바르게 설정되었는지 점검합니다.
     • 네트워크 ACL이 NFS 트래픽을 차단하지 않는지 확인합니다.

3. 위 단계를 점검 후에도 문제가 해결되지 않을 경우, 로그를 추가로 확인하고 헬프데스크에 문의하십시오.

---

체크섬 불일치 (Checksum mismatch)

마운트된 경로를 통해 데이터를 복사하는 과정에서 원본 데이터와 복사된 데이터의 체크섬이 일치하지 않을 경우, 데이터 무결성에 문제가 발생했을 가능성이 있습니다.

▶️ 해결 방법

1. NFS 클라이언트 환경에서 아래 명령어를 사용해 스크립트 파일을 다운로드합니다.

   Checksum 스크립트 다운로드

   curl -O https://objectstorage.kr-central-2.kakaocloud.com/v1/fe631cd1b7a14c0ba2612d031a8a5619/public/docs/file_storage/checksum_inspection.sh
   chmod +x checksum_inspection.sh

2. 다운로드한 스크립트를 실행하여 Source File Checksum과 Remote NAS Destination Checksum을 비교합니다.

   ./checksum_inspection.sh {source-file-path} {remote-nas-file-path}

   명령어 실행 결과 예시

   Remote NAS file checksum matches the source file.
   Checksum matched for iteration 58. Continuing to next iteration.
   -------------------------------------
   Iteration: 59
   1024+0 records in
   1024+0 records out
   1073741824 bytes (1.1 GB, 1.0 GiB) copied, 7.81003 s, 137 MB/s
   Source File Checksum:              742be2cafe65354d29470fe6dc735df7
   Remote NAS Destination Checksum:   449643df40c7d780060fb2c89aedc37f

3. Source File Checksum과 Remote NAS Destination Checksum이 동일하면 데이터 전송이 정상적으로 완료된 것입니다. 반면 체크섬 값이 다른 경우, 데이터 전송 중 문제가 발생했을 가능성이 있습니다.

4. 위의 단계를 통해 문제를 해결하지 못한 경우, 헬프데스크로 문의하여 Storage 복구를 요청합니다.