Azure 파일 동기화 문제 해결

아티클
08/02/2024

Azure 파일 동기화를 사용하여 온-프레미스 파일 서버의 유연성, 성능 및 호환성을 유지하면서 Azure Files에서 조직의 파일 공유를 중앙 집중화할 수 있습니다. 이 문서는 Azure 파일 동기화 배포 시 발생할 수 있는 문제를 해결하는 데 도움을 주기 위해 작성되었습니다. 또한 문제를 좀 더 자세히 조사해야 할 경우 시스템에서 중요한 로그를 수집하는 방법을 설명합니다.

일반적인 문제 해결 설명서

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

문제	문제 해결 설명서
에이전트 설치 또는 서버 등록 문제	Azure 파일 동기화 에이전트 설치 및 서버 등록 문제 해결
클라우드 엔드포인트 또는 서버 엔드포인트 만들기 문제 또는 등록된 서버가 오프라인 상태입니다.	Azure 파일 동기화 문제 해결 - 동기화 그룹 관리
서버 엔드포인트에 오류 상태가 있거나 파일이 동기화되지 않습니다.	Azure 파일 동기화 동기화 상태 및 오류 문제 해결
파일 계층화 또는 회수 실패	Azure 파일 동기화 클라우드 계층화 문제 해결
스토리지 동기화 에이전트 서비스(FileSyncSvc)를 시작하지 못함	Azure 파일 동기화 문제 해결
서버의 높은 메모리 사용량	Azure 파일 동기화 문제 해결

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

일반적인 문제 해결 첫 단계

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

서버에서 Azure Portal 또는 이벤트 로그를 사용하여 오류를 확인합니다. Azure Portal 또는 이벤트 로그를 사용하여 Azure 파일 동기화 환경의 상태를 보는 방법에 대한 자세한 내용은 Azure 파일 동기화 모니터링을 참조하세요.
서버에서 Azure 파일 동기화 서비스가 실행 중인지 확인합니다.
- 서비스 MMC 스냅인을 열고 스토리지 동기화 에이전트 서비스(FileSyncSvc)가 실행 중인지 확인합니다. 서비스가 실행되고 있지 않고 시작에 실패하면 스토리지 동기화 에이전트 서비스(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 및Test-StorageSyncNetworkConnectivity)의 기능을 cmdlet에 Debug-StorageSyncServer 병합하여 Azure 파일 동기화 문제 해결을 간소화했습니다.

서버에서 진단을 실행하려면 다음 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 파일은 사용자가 지정한 출력 디렉터리에 저장됩니다.

스토리지 동기화 에이전트 서비스(FileSyncSvc)를 시작하지 못함

Azure 파일 동기화 에이전트(v17.3 이상)를 설치하거나 업그레이드한 후 다음 증상 중 하나가 발생할 수 있습니다.

스토리지 동기화 에이전트 서비스(FileSyncSvc)가 다음 오류로 시작되지 않습니다.
```
Error 0x80070057: The parameter is incorrect. 
```

Register-AzStorageSyncServer: Exception of type 'Commands.StorageSync.Interop.Exceptions.ServerRegistrationException' was thrown.

ServerRegistration.exe 또는 AfsUpdater.exe 열지 못함

이 문제는 Azure 파일 동기화 에이전트가 Windows 보안 기능에 종속되어 있고 이 보안 기능에 대한 업데이트가 설치되지 않았기 때문에 발생합니다.

이 문제를 해결하려면 Windows Server에 다음 업데이트가 설치되어 있는지 확인합니다.

Windows Server 2012 R2: KB5021653
Windows Server 2016: KB5040562
Windows Server 2019: KB5005112 및 KB5040430

서버의 높은 메모리 사용량

Azure 파일 동기화 동기화 및 클라우드 계층화에 ESE(Extensible Storage Engine) 데이터베이스를 사용합니다. ESE 데이터베이스는 시스템 메모리의 최대 80%를 사용하여 성능을 향상시킬 수 있습니다. ESE 데이터베이스에서 사용하는 메모리 양을 제한하려면 서버에서 MaxESEDbCachePercent 레지스트리 설정을 구성할 수 있습니다.

ESE 메모리 사용 제한을 60%로 줄이려면 메모리 사용률과 데이터베이스의 적절한 성능을 유지하기에 충분한 캐시 간의 적절한 균형을 유지하려면 관리자 권한 명령 프롬프트에서 다음 명령을 실행합니다.

REG ADD HKLM\Software\Microsoft\Azure\StorageSync /v MaxESEDbCachePercent /t REG_DWORD /d 60

MaxESEDbCachePercent 레지스트리 설정이 만들어지면 스토리지 동기화 에이전트(FileSyncSvc) 서비스를 다시 시작합니다.

참고 항목

도움을 요청하십시오.

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

다음을 통해 공유