문제 해결: File Gateway 문제

Amazon CloudWatch 로그 그룹에 로그 항목을 기록하도록 File Gateway를 구성할 수 있습니다. 이 경우 게이트웨이 상태 및 게이트웨이에서 발생하는 오류에 대한 알림을 받게 됩니다. 이러한 오류 및 상태 알림에 대한 정보는 CloudWatch Logs에서 확인할 수 있습니다.

이 단원에서는 각 오류의 원인 및 상태 알림과 문제 해결 방법을 이해하는 데 도움이 되는 정보를 찾을 수 있습니다.

오류: FileMissing

FileMissing 오류는 ObjectMissing 오류와 유사하며 오류를 해결하는 단계는 동일합니다. 지정된 File Gateway 이외의 라이터가 Amazon FSx에서 지정된 파일을 삭제하면 FileMissing 오류가 발생할 수 있습니다. 객체에 대한 Amazon FSx로의 후속 업로드 또는 Amazon FSx에서 검색이 실패합니다.

FileMissing 오류를 해결하려면

1. 파일의 최신 사본을 SMB 클라이언트의 로컬 파일 시스템에 저장합니다(3단계에서이 파일 사본 필요).

2. SMB 클라이언트를 사용하여 파일 게이트웨이에서 파일을 삭제합니다.

3. SMB 클라이언트를 사용하여 1단계 Amazon FSx에서 저장한 파일의 최신 버전을 복사합니다. File Gateway를 통해이 작업을 수행합니다.

오류: FsxFileSystemAuthenticationFailure

파일 시스템을 연결하는 동안 제공된 자격 증명이 만료되거나 권한이 취소되면 FsxFileSystemAuthenticationFailure 오류가 발생할 수 있습니다.

FsxFileSystemAuthenticationFailure 오류를 해결하려면

1. Amazon FSx 파일 시스템을 연결할 때 제공된 자격 증명이 여전히 유효한지 확인합니다.

2. Amazon FSx for Windows File Server 파일 시스템 연결에 설명된 대로 사용자에게 필요한 모든 권한이 있는지 확인합니다.

오류: FsxFileSystemConnectionFailure

게이트웨이 시스템에서 Amazon FSx 서버에 액세스할 수 없는 경우 FsxFileSystemConnectionFailure 오류가 발생할 수 있습니다.

FsxFileSystemConnectionFailure 오류를 해결하려면

1. 모든 방화벽 및 VPC 규칙이 게이트웨이 시스템과 Amazon FSx 서버 간의 연결을 허용하는지 확인합니다.

2. Amazon FSx 서버가 실행 중인지 확인합니다.

오류: FsxFileSystemFull

Amazon FSx 파일 시스템에 여유 디스크 공간이 충분하지 않은 경우 FsxFileSystemFull 오류가 발생할 수 있습니다.

FsxFileSystemFull 오류를 해결하려면

• Amazon FSx 파일 시스템의 스토리지 공간을 늘립니다.

오류: GatewayClockOutOfSync

게이트웨이가 로컬 시스템 시간과 AWS Storage Gateway 서버에서 보고한 시간 간에 5분 이상의 차이를 감지하면 GatewayClockOutOfSync 오류가 발생할 수 있습니다. 클록 동기화 문제는 게이트웨이와 간의 연결에 부정적인 영향을 미칠 수 있습니다 AWS. 게이트웨이 클럭이 동기화되지 않은 경우 NFS 및 SMB 연결에 I/O 오류가 발생할 수 있으며 SMB 사용자에게 인증 오류가 발생할 수 있습니다.

GatewayClockOutOfSync 오류를 해결하려면

• 게이트웨이와 NTP 서버 간의 네트워크 구성을 확인합니다. 게이트웨이 VM 시간 동기화 및 NTP 서버 구성 업데이트에 대한 자세한 내용은 게이트웨이의 네트워크 시간 프로토콜(NTP) 서버 구성을 참조하세요.

오류: InvalidFileState

지정된 게이트웨이 이외의 라이터가 지정된 파일 공유에서 지정된 파일을 수정할 때 InvalidFileState 오류가 발생할 수 있습니다. 따라서 게이트웨이의 파일 상태가 Amazon FSx의 파일 상태와 일치하지 않습니다. Amazon FSx에서 파일의 후속 업로드 또는 검색이 실패할 수 있습니다.

InvalidFileState 오류를 해결하려면

1. 파일의 최신 사본을 SMB 클라이언트의 로컬 파일 시스템에 저장합니다(4단계에서 복사하려면이 파일이 필요함). Amazon FSx의 파일 버전이 최신 버전인 경우 해당 버전을 다운로드합니다. SMB 클라이언트를 사용하여 Amazon FSx 공유에 직접 액세스하여이 작업을 수행할 수 있습니다.

2. Amazon FSx에서 파일을 직접 삭제합니다.

3. SMB 클라이언트를 사용하여 게이트웨이에서 파일을 삭제합니다.

4. SMB 클라이언트를 사용하여 1단계에서 저장한 파일의 최신 버전을 File Gateway를 통해 Amazon FSx로 복사합니다.

오류: ObjectMissing

지정된 File Gateway 이외의 라이터가 Amazon FSx에서 지정된 파일을 삭제할 때 ObjectMissing 오류가 발생할 수 있습니다. 객체에 대한 Amazon FSx로의 후속 업로드 또는 Amazon FSx에서 검색이 실패합니다.

ObjectMissing 오류를 해결하려면

1. 파일의 최신 사본을 SMB 클라이언트의 로컬 파일 시스템에 저장합니다(3단계에서이 파일 사본 필요).

2. SMB 클라이언트를 사용하여 파일 게이트웨이에서 파일을 삭제합니다.

3. SMB 클라이언트를 사용하여 1단계 Amazon FSx에서 저장한 파일의 최신 버전을 복사합니다. File Gateway를 통해이 작업을 수행합니다.

오류: DroppedNotifications

게이트웨이 루트 디스크의 여유 스토리지 공간이 1GB 미만이거나 1분 간격 내에 100개 이상의 상태 알림이 생성되는 경우 다른 예상 유형의 CloudWatch 로그 항목 대신 DroppedNotifications 오류가 발생할 수 있습니다. 이러한 상황에서 게이트웨이는 예방 조치로 자세한 CloudWatch 로그 알림 생성을 중지합니다.

DroppedNotifications 오류를 해결하려면

1. Storage Gateway 콘솔의 게이트웨이 모니터링 탭에서 Root Disk Usage 지표를 확인하여 사용 가능한 루트 디스크 공간이 부족한지 확인합니다.

2. 사용 가능한 공간이 1GB 미만인 경우 게이트웨이의 루트 스토리지 디스크 크기를 늘립니다. 지침은 가상 머신 하이퍼바이저 설명서를 참조하세요.

   Amazon EC2 게이트웨이의 루트 디스크 크기를 늘리려면 Amazon Elastic Compute Cloud 사용 설명서의 EBS 볼륨에 대한 수정 요청을 참조하세요.

   참고

   AWS Storage Gateway 하드웨어 어플라이언스의 루트 디스크 크기를 늘릴 수 없습니다.

3. 게이트웨이 다시 시작합니다.

알림: HardReboot

게이트웨이 VM이 예기치 않게 다시 시작될 때 HardReboot 알림을 받을 수 있습니다. 이러한 다시 시작의 원인은 정전, 하드웨어 오류 또는 다른 이벤트일 수 있습니다. VMware 게이트웨이의 경우 vSphere 고가용성 애플리케이션 모니터링으로 재설정하면이 이벤트가 발생할 수 있습니다.

게이트웨이가 이러한 환경에서 실행되는 경우 HealthCheckFailure 알림이 있는지 확인하고 VM에 대한 VMware 이벤트 로그를 참조하십시오.

알림: 재부팅

게이트웨이 VM을 다시 시작할 때 재부팅 알림을 받을 수 있습니다. VM 하이퍼바이저 관리 콘솔 또는 Storage Gateway 콘솔을 사용하여 게이트웨이 VM을 다시 시작할 수 있습니다. 게이트웨이의 유지 관리 주기 동안 게이트웨이 소프트웨어를 사용하여 다시 시작할 수도 있습니다.

재부팅이 게이트웨이에서 구성된 유지 관리 시작 시간 10분 이내에 수행되는 경우 이 재부팅은 정상적인 현상일 수 있으며 문제의 징조가 아닙니다. 유지 관리 기간을 크게 벗어나 재부팅이 수행된 경우 게이트웨이가 수동으로 다시 시작되었는지 확인합니다.

문제 해결: Active Directory 도메인 문제

FSx File Gateway는 Active Directory 도메인 문제에 대한 특정 로그 메시지를 생성하지 않습니다. 게이트웨이를 Active Directory 도메인에 조인하는 데 문제가 있는 경우 다음을 수행합니다.

• 게이트웨이가 읽기 전용 도메인 컨트롤러(RODC)를 사용하여 도메인에 조인하려고 하지 않는지 확인합니다.

• 게이트웨이가 올바른 DNS 서버를 사용하도록 구성되어 있는지 확인합니다.

  예를 들어 Amazon EC2 게이트웨이 인스턴스를 AWS관리형 Active Directory에 조인하려는 경우 EC2 VPC에 대한 DHCP 옵션 세트가 AWS관리형 Active Directory DNS 서버를 지정하는지 확인합니다.

  VPC DHCP 옵션 세트를 통해 구성하는 DNS 서버는 VPC의 모든 EC2 인스턴스에 제공됩니다. 개별 게이트웨이에 DNS 서버를 지정하려면 해당 게이트웨이의 EC2 로컬 콘솔을 사용하여 지정할 수 있습니다.

  온프레미스 게이트웨이의 경우 VM 로컬 콘솔을 사용하여 DNS 서버를 지정합니다.

• 게이트웨이의 로컬 콘솔에 있는 명령 프롬프트에서 다음 명령을 실행하여 게이트웨이 네트워크 연결을 확인합니다. 강조 표시된 변수를 배포의 실제 도메인 이름 및 IP 주소로 바꿉니다.

  dig -d ExampleDomainName
  ncport -d ExampleDomainControllerIPAddress -p 445
  ncport -d ExampleDomainControllerIPAddress -p 389
  

• Active Directory 서비스 계정에 필요한 권한이 있는지 확인합니다. 자세한 내용은 Active Directory 서비스 계정 권한 요구 사항을 참조하세요.

• 게이트웨이가 올바른 조직 단위(OU)에 조인하는지 확인합니다.

  도메인에 가입하면 게이트웨이의 게이트웨이 ID를 계정 이름(예: SGW-1234ADE)으로 사용하여 기본 컴퓨터 컨테이너(OU 아님)에 Active Directory 컴퓨터 계정이 생성됩니다. 이 계정의 이름은 사용자 지정할 수 없습니다.

  Active Directory 환경에 새 컴퓨터 객체에 대해 지정된 OU가 있는 경우 도메인을 조인할 때 해당 OU를 지정해야 합니다.

  지정된 OU에 조인하려고 할 때 액세스 거부 오류가 발생하면 Active Directory 도메인 관리자에게 문의하십시오. 관리자가 게이트웨이의 컴퓨터 계정을 미리 준비해야 도메인에 가입할 수 있습니다. 자세한 내용은 Microsoft Active Directory 인증을 위해 Storage Gateway 파일 게이트웨이를 도메인에 조인하는 것과 관련된 문제를 해결하려면 어떻게 해야 합니까?를 참조하세요.

• 게이트웨이의 로컬 콘솔에 있는 명령 프롬프트에서 다음 명령을 실행하여 게이트웨이의 호스트 이름을 DNS에서 확인할 수 있는지 확인합니다. 강조 표시된 변수를 게이트웨이의 실제 호스트 이름으로 바꿉니다.

  dig -d ExampleHostName -r A

  게이트웨이에 대한 사용자 지정 호스트 이름을 구성한 경우 IP 주소를 가리키는 DNS A 레코드를 수동으로 추가해야 합니다.

• 게이트웨이와 도메인 컨트롤러 간의 네트워크 지연 시간이 상당히 낮은지 확인합니다. 게이트웨이가 20초 이내에 도메인 컨트롤러로부터 응답을 받지 못하면 도메인에 조인하기 위한 쿼리 시간이 초과될 수 있습니다.

  JoinDomain CLI 명령을 사용하여 게이트웨이를 도메인에 조인하는 경우 --timeout-in-seconds 플래그를 추가하여 제한 시간을 최대 3,600초로 늘릴 수 있습니다.

• 게이트웨이를 도메인에 조인하는 데 사용하는 Active Directory 사용자에게 필요한 권한이 있는지 확인합니다.

문제 해결: CloudWatch 지표 사용

Storage Gateway에서 Amazon CloudWatch 지표를 사용하여 문제를 해결하기 위한 작업에 대한 다음 정보를 찾을 수 있습니다.

주제

• 디렉터리를 탐색할 때 게이트웨이가 느리게 반응합니다.

• 게이트웨이가 응답하지 않습니다.

• Amazon FSx 파일 시스템에 파일이 표시되지 않음

• Amazon FSx 파일 시스템에 이전 스냅샷이 표시되지 않음

• 게이트웨이가 Amazon FSx로 데이터를 전송하는 속도가 느림

• 게이트웨이 백업 작업이 실패하거나 게이트웨이에 쓸 때 오류가 있음

디렉터리를 탐색할 때 게이트웨이가 느리게 반응합니다.

ls 명령을 실행하거나 디렉터리를 탐색할 때 File Gateway가 느리게 반응하는 경우 IndexFetch 및 IndexEviction CloudWatch 지표를 확인합니다.

• ls 명령을 실행하거나 디렉터리를 검색할 때 지표가 IndexFetch 0보다 큰 경우 File Gateway는 영향을 받는 디렉터리의 내용에 대한 정보 없이 시작되었으며 FSx for Windows File Server에 액세스해야 했습니다. 해당 디렉터리의 콘텐츠를 나열하려는 후속 노력이 더 빨리 이루어져야 합니다.

• 지표가 IndexEviction 0보다 크면 File Gateway가 당시 캐시에서 관리할 수 있는 한도에 도달했음을 의미합니다. 이 경우 파일 게이트웨이는 새 디렉터리를 나열하기 위해 가장 최근에 액세스한 디렉터리에서 일부 스토리지 공간을 확보해야 합니다. 이 문제가 자주 발생하고 성능에 영향을 미치는 경우에 문의하세요 지원.

  관련 Amazon FSx 파일 시스템의 지원 내용과 사용 사례에 따라 성능을 개선하기 위한 권장 사항을 논의합니다.

게이트웨이가 응답하지 않습니다.

File Gateway가 응답하지 않는 경우 다음을 수행합니다.

• 최근 재부팅 또는 소프트웨어 업데이트가 있었다면 IOWaitPercent 지표를 확인하십시오. 이 지표는 처리되지 않은 디스크 I/O 요청이 있을 때 CPU가 유휴 상태인 시간의 백분율을 보여줍니다. 경우에 따라 이 값이 높고(10 이상) 서버가 재부팅되거나 업데이트된 후에 증가했을 수 있습니다. 이러한 경우 File Gateway는 인덱스 캐시를 RAM으로 재구축할 때 느린 루트 디스크로 인해 병목 현상이 발생할 수 있습니다. 루트 디스크에 더 빠른 물리적 디스크를 사용하여 이 문제를 해결할 수 있습니다.

• MemUsedBytes 지표가 지표에 있거나 MemTotalBytes 지표와 거의 동일한 경우 파일 게이트웨이에 사용 가능한 RAM이 부족한 것입니다. File Gateway에 최소 필수 RAM이 있는지 확인합니다. 이미 있는 경우 워크로드 및 사용 사례에 따라 File Gateway에 RAM을 더 추가하는 것이 좋습니다.

  파일 공유가 SMB인 경우 파일 공유에 연결된 SMB 클라이언트 수 때문일 수도 있습니다. 지정된 시간에 연결된 클라이언트 수를 확인하려면 SMBV(1/2/3)Sessions 지표를 확인합니다. 연결된 클라이언트가 많은 경우 File Gateway에 RAM을 더 추가해야 할 수 있습니다.

Amazon FSx 파일 시스템에 파일이 표시되지 않음

게이트웨이의 파일이 Amazon FSx 파일 시스템에 반영되지 않는 경우 FilesFailingUpload 지표를 확인합니다. 지표에서 일부 파일이 업로드에 실패한다고 보고하는 경우 상태 알림을 확인합니다. 파일을 업로드하지 못하면 게이트웨이는 문제에 대한 세부 정보가 포함된 상태 알림을 생성합니다.

Amazon FSx 파일 시스템에 이전 스냅샷이 표시되지 않음

최상위 폴더 이름 바꾸기 또는 권한 변경과 같은 FSx File Gateway의 일부 파일 작업으로 인해 여러 파일 작업이 수행되어 FSx for Windows File Server 파일 시스템에서 I/O 로드가 높아질 수 있습니다. 파일 시스템에 워크로드에 대한 성능 리소스가 충분하지 않은 경우 파일 시스템은 기록 섀도우 복사본 보존보다 지속적인 I/O의 가용성을 우선시하기 때문에 섀도우 복사본을 삭제할 수 있습니다.

Amazon FSx 콘솔에서 모니터링 및 성능 페이지를 확인하여 파일 시스템이 과소 프로비저닝되었는지 확인합니다. 그렇다면 SSD 스토리지로 전환하거나, 처리량 용량을 늘리거나, SSD IOPS를 늘려 워크로드를 처리할 수 있습니다.

게이트웨이가 Amazon FSx로 데이터를 전송하는 속도가 느림

File Gateway가 Amazon FSx for Windows File Server로 데이터를 느리게 전송하는 경우 다음을 수행합니다.

• CachePercentDirty 지표가 80 이상인 경우 File Gateway는 Amazon FSx for Windows File Server에 데이터를 업로드할 수 있는 것보다 더 빠르게 디스크에 데이터를 쓰고 있습니다. File Gateway에서 업로드할 대역폭을 늘리거나, 하나 이상의 캐시 디스크를 추가하거나, 클라이언트 쓰기 속도를 늦추거나, 연결된 Amazon FSx for Windows File Server의 처리량 용량을 늘리는 것이 좋습니다.

• CachePercentDirty 지표가 낮으면 IoWaitPercent 지표를 확인합니다. IoWaitPercent가 10보다 크면 파일 게이트웨이가 로컬 캐시 디스크의 속도에 따라 병목 현상이 발생할 수 있습니다. 캐시에 로컬 SSD(Solid State Drive) 디스크를 사용하는 것이 좋습니다. 추천 제품은 NVMe(NVM Express)입니다. 이러한 디스크를 사용할 수 없는 경우 성능 향상을 위해 별도의 물리적 디스크에서 여러 캐시 디스크를 사용해 보십시오.

게이트웨이 백업 작업이 실패하거나 게이트웨이에 쓸 때 오류가 있음

File Gateway 백업 작업이 실패하거나 File Gateway에 쓸 때 오류가 있는 경우 다음을 수행합니다.

• CachePercentDirty 지표가 90% 이상인 경우 캐시 디스크에 사용 가능한 공간이 충분하지 않기 때문에 File Gateway가 디스크에 대한 새 쓰기를 수락할 수 없습니다. File Gateway가 FSx for Windows File Server에 업로드되는 속도를 확인하려면 CloudBytesUploaded 지표를 확인합니다. 이 지표를 클라이언트가 파일 게이트웨이에 파일을 쓰는 속도를 보여주는 WriteBytes 지표와 비교합니다. SMB 클라이언트가 FSx for Windows File Server에 업로드할 수 있는 것보다 더 빠르게 File Gateway에 쓰는 경우 백업 작업의 크기를 최소한으로 포함하도록 캐시 디스크를 더 추가합니다. 또는 업로드 대역폭을 늘립니다.

• 백업 작업과 같은 대용량 파일 복사가 실패하지만 지표가 CachePercentDirty 80% 미만인 경우 File Gateway가 클라이언트 측 세션 제한 시간에 도달했을 수 있습니다. SMB의 경우 PowerShell 명령 Set-SmbClientConfiguration -SessionTimeout 300을 사용하여 이 제한 시간을 늘릴 수 있습니다. 이 명령을 실행하면 이 제한 시간이 300초로 설정됩니다.