File Storage 문제 해결

File Storage 사용 중 발생할 수 있는 문제와 해결 방법을 안내합니다.

마운트 오류
체크섬 불일치

마운트 오류

마운트가 실패하거나 예상대로 작동하지 않는 경우 아래 원인과 해결 방법을 확인하세요.

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

마운트 대상 경로인 Mount PATH가 존재하지 않거나 잘못 지정된 경우 발생합니다.

오류 메시지
mount.nfs: mount point {Mount PATH} does not exist

해결 방법은 다음과 같습니다.

Mount PATH가 정확한지 확인합니다.
경로가 존재하지 않으면 다음 명령어로 마운트 대상 디렉터리를 생성합니다.
```
mkdir -p {Mount PATH}
```
다시 마운트를 시도합니다.

이미 마운트됨

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

오류 메시지
mount.nfs: ... already mounted

해결 방법은 다음과 같습니다.

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가 이미 마운트된 상태임을 나타냅니다.

추가 마운트가 필요하지 않으면 기존 마운트를 유지합니다.
기존 마운트를 해제해야 하는 경우 다음 명령어를 실행합니다.
```
umount {Mount PATH}
```
언마운트 후 mount 명령어를 다시 실행하여 /mnt/my_nfs가 더 이상 표시되지 않으면 정상적으로 해제된 것입니다.

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

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

오류 메시지
mount.nfs: ... access denied 또는 Connection timed out

해결 방법은 다음과 같습니다.

File Storage 접근 제어 설정을 확인하고 클라이언트 IP 주소를 허용 목록에 추가합니다.
클라이언트 인스턴스에서 File Storage와 통신할 수 있는지 확인합니다.
```
telnet {File Storage IP} 2049
```
telnet 명령어가 실패하면 다음 항목을 점검합니다.
- 클라이언트의 보안 그룹에서 2049(NFS) 포트의 인바운드 트래픽이 허용되었는지 확인합니다.
- 클라이언트와 File Storage가 동일한 서브넷에 있거나, 라우팅 및 보안 그룹이 올바르게 설정되었는지 확인합니다.
- 네트워크 ACL이 NFS 트래픽을 차단하지 않는지 확인합니다.
위 단계를 점검한 후에도 문제가 해결되지 않으면 로그를 확인한 후 헬프데스크에 문의하세요.

체크섬 불일치

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

해결 방법은 다음과 같습니다.

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

Checksum 스크립트 다운로드
curl -O https://objectstorage.kr-central-2.kakaocloud.com/v1/c11fcba415bd4314b595db954e4d4422/public/docs/file_storage/checksum_inspection.sh
chmod +x checksum_inspection.sh

다운로드한 스크립트를 실행하여 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

Source File Checksum과 Remote NAS Destination Checksum이 동일하면 데이터 전송이 정상적으로 완료된 것입니다. 체크섬 값이 다르면 데이터 전송 중 문제가 발생했을 수 있습니다.
위 단계를 통해 문제를 해결하지 못한 경우 헬프데스크로 문의하여 Storage 복구를 요청합니다.

마운트 오류​

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

이미 마운트됨​

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

체크섬 불일치​

마운트 오류

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

이미 마운트됨

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

체크섬 불일치