Azure 파일 동기화 문제 해결

아티클
04/10/2024

Azure 파일 동기화 사용하여 온-프레미스 파일 서버의 유연성, 성능 및 호환성을 유지하면서 Azure Files organization 파일 공유를 중앙 집중화할 수 있습니다. 이 문서는 Azure 파일 동기화 배포에서 발생할 수 있는 문제를 해결하고 resolve 데 도움이 되도록 설계되었습니다. 또한 문제에 대한 심층 조사가 필요한 경우 시스템에서 중요한 로그를 수집하는 방법도 설명합니다.

일반적인 문제 해결 설명서

발생하는 문제에 따라 적절한 문제 해결 설명서를 검토합니다.

문제	문제 해결 설명서
에이전트 설치 또는 서버 등록 문제	Azure 파일 동기화 에이전트 설치 및 서버 등록 문제 해결
클라우드 엔드포인트 또는 서버 엔드포인트 만들기 문제 또는 등록된 서버가 오프라인 상태임	Azure 파일 동기화 동기화 그룹 관리 문제 해결
서버 엔드포인트에 오류 상태 있거나 파일이 동기화되지 않습니다.	Azure 파일 동기화 동기화 상태 및 오류 문제 해결
파일 계층화 또는 회수 실패	Azure 파일 동기화 클라우드 계층화 문제 해결

어디서부터 시작해야 할지 잘 모르는 경우 일반 문제 해결 첫 번째 단계를 참조하세요.

일반적인 문제 해결 첫 번째 단계

Azure 파일 동기화 문제가 발생하는 경우 먼저 다음 단계를 완료합니다.

서버에서 Azure Portal 또는 이벤트 로그를 사용하여 오류를 확인합니다. Azure Portal 또는 이벤트 로그를 사용하여 Azure 파일 동기화 환경의 상태를 보는 방법에 대한 자세한 내용은 Azure 파일 동기화 모니터링을 참조하세요.
서버에서 Azure 파일 동기화 서비스가 실행되고 있는지 확인합니다.
- 서비스 MMC 스냅인을 열고 스토리지 동기화 에이전트 서비스(FileSyncSvc)가 실행 중인지 확인합니다.
Azure 파일 동기화 필터 드라이버(StorageSync.sys 및 StorageSyncGuard.sys)가 서버에서 실행되고 있는지 확인합니다.
- 관리자 권한 명령 프롬프트에서 를 실행합니다 fltmc. StorageSync.sys 및 StorageSyncGuard.sys 파일 시스템 필터 드라이버가 나열되어 있는지 확인합니다.
서버의 Debug-StorageSyncServer cmdlet을 사용하여 일반적인 문제를 검사.

Debug-StorageSyncServer cmdlet

cmdlet은 Debug-StorageSyncServer 인증서 구성 오류 및 잘못된 서버 시간과 같은 Azure 파일 동기화 서버의 일반적인 문제를 진단합니다. 또한 일부 기존 스크립트 및 cmdlet(AFSDiag.ps1,FileSyncErrorsReport.ps1및 )의 기능을 cmdlet에 병합하여 Azure 파일 동기화 Test-StorageSyncNetworkConnectivity문제 해결을 Debug-StorageSyncServer 간소화했습니다.

서버에서 진단 실행하려면 다음 PowerShell 명령을 실행합니다.

Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll"
Debug-StorageSyncServer -Diagnose

서버에서 네트워크 연결을 테스트하려면 다음 PowerShell 명령을 실행합니다.

Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll"
Debug-StorageSyncServer -TestNetworkConnectivity

서버에서 동기화하지 못하는 파일을 식별하려면 다음 PowerShell 명령을 실행합니다.

Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll"
Debug-StorageSyncServer -FileSyncErrorsReport

서버에서 로그 및 추적을 수집하려면 다음 PowerShell 명령을 실행합니다.

Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll"
Debug-StorageSyncServer -AFSDiag -OutputDirectory C:\output -KernelModeTraceLevel Verbose -UserModeTraceLevel Verbose

Azure 파일 동기화 서버에서 로그 및 추적을 수집하는 방법

문제 해결 설명서의 단계를 수행한 후 문제가 해결되지 않으면 AFSDiag 도구를 실행하고 추가 진단을 위해 사례에 할당된 지원 엔지니어에게 .zip 파일 출력을 보냅니다.

AFSDiag를 실행하려면 아래 단계를 수행합니다.

관리자 권한 PowerShell 창을 열고 다음 명령을 실행합니다(각 명령 다음에 Enter 키를 누릅니다.)

참고

AFSDiag는 로그를 수집하기 전에 출력 디렉터리와 임시 폴더를 만들고 실행 후 임시 폴더를 삭제합니다. 데이터가 포함되지 않은 출력 위치를 지정합니다.
```
Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll"
Debug-StorageSyncServer -AFSDiag -OutputDirectory C:\output -KernelModeTraceLevel Verbose -UserModeTraceLevel Verbose
```
문제를 재현합니다. 완료되면 D를 입력합니다.
로그 및 추적 파일이 포함된 .zip 파일은 지정한 출력 디렉터리에 저장됩니다.

참고 항목

도움을 요청하십시오.

질문이 있거나 도움이 필요한 경우 지원 요청을 생성하거나 Azure 커뮤니티 지원에 문의하세요. Azure 피드백 커뮤니티에 제품 피드백을 제출할 수도 있습니다.