M365Con 2027 – 무료 온라인 컨퍼런스 · 11–22 Jan 2027 · 120 sessions→ m365con.net

블로그 · Mirko Peters

SPMT 및 Migration Manager 오류: 엔드포인트, 디스크 공간, 검사 체크리스트

By ·

SPMT에서 디스크 공간 부족이 보고되거나 Migration Manager 에이전트에 Connected로 표시되는데 검사를 수행하지 못합니까? 필요한 엔드포인트, 로컬 작업 폴더, 대상 스토리지, 에이전트 설정을 이 순서대로 확인하십시오.

Automatically translated with AI from the original post. Read the English original

파일 공유 또는 온프레미스 SharePoint 마이그레이션은 몇 주 동안 잘 실행될 수 있습니다. 그러다 어느 순간 라이브러리가 디스크 공간 메시지와 함께 실패하거나, 방화벽이 엔드포인트를 거부하거나, Migration Manager 에이전트가 "Connected" 상태에 머물며 검사를 거부할 수 있습니다. 2025년 말부터 2026년 말까지의 Microsoft 커뮤니티 스레드 네 건에서 이런 사례가 확인됩니다. 이 중 해결책으로 표시된 답변은 하나뿐이므로, 이 글은 해당 사례를 현재 Learn 페이지와 함께 정리합니다. 이 글은 문제 해결 가이드이며 Microsoft의 공식 절차가 아닙니다.

핵심 포인트

  • Microsoft Learn에 나온 엔드포인트 목록 전체를 허용하십시오. SPMT용 api.office.com과 Migration Manager의 검사 엔드포인트도 포함됩니다. 한 스레드는 IP 주소가 아니라 호스트 이름으로 허용하라고 권장합니다.
  • https://가 포함된 항목을 거부하는 방화벽에서는 FQDN 개체에 호스트 이름만 입력해야 할 수 있습니다. 이 내용은 해결책으로 표시된 스레드에서 보고되었습니다.
  • Learn에 문서화된 SPMT 디스크 공간 오류는 로컬 작업 폴더를 가리킵니다. 따라서 먼저 마이그레이션 컴퓨터의 여유 공간을 확인하고, 그다음 대상 사이트의 스토리지를 확인하십시오.
  • 연결된 에이전트에서 발생하는 'Cannot scan'에 대해서는 스레드에서 확인된 해결책이 없었습니다. 한 질문자는 Microsoft가 알려진 문제로 처리한 지원 사례를 받았습니다.
  • 대부분의 스레드가 '지원 사례 열기'로 끝났으므로, 실패 보고서, 정확한 오류 코드, 그리고 UTC 기준 발생 시각을 미리 준비해 두십시오.

증상 예시

  • 엔드포인트: SPMT 컴퓨터의 방화벽이 https://api.office.com을 잘못된 항목으로 거부합니다. 게시자는 이 API가 지원 중단되었다는 내용을 읽었지만, SPMT 필수 구성 요소 페이지(2026년 8월 기준)에는 여전히 이 주소가 나와 있습니다.
  • 디스크 공간: SharePoint 2019에서 SharePoint Online으로의 마이그레이션에서 두 라이브러리가 "There isn't enough disk space in the target site collection" 및 "Not all the items in the package have been migrated" 메시지와 함께 실패합니다. 게시자는 대상 사이트에 공간이 충분하다고 설명합니다(2026년 8월).
  • Cannot scan: Migration Manager 에이전트에 Connected로 표시되지만 "Cannot scan"이 뜹니다. 9월 중순까지는 마이그레이션이 정상적으로 동작했습니다. 에이전트를 다시 설치해도 해결되지 않았고, 질문자는 Microsoft 마이그레이션 엔드포인트에 대한 SSL 요청 실패를 확인했습니다(2026년 10월).
  • 인증서 로그인: 인증서 기반 인증으로 에이전트를 다시 설치한 후, 검사 탭의 Add Source Path가 비활성화되고 에이전트 로그에 token_not_found가 반복해서 기록됩니다(2025년 11월).

1단계: 엔드포인트 확인

Learn은 두 도구의 엔드포인트를 HTTPS URL로 나열합니다. Migration Manager에 대해서는 에이전트가 이 엔드포인트로 요청을 보내고 응답을 받으며, 엔드포인트가 Migration Manager를 호출할 수는 없고, 에이전트가 원격 연결을 위해 포트를 열지 않는다고 설명합니다.

SPMT의 Learn 사전 요구 사항 페이지에는 다음 항목 등이 나와 있습니다.

  • 인증: login.microsoftonline.com, login.windows.net, aadcdn.msftauth.net, aadcdn.msauth.net, secure.aadcdn.microsoftonline-p.com
  • 콘텐츠 이동 및 유효성 검사 API: api.office.com, graph.windows.net
  • Azure 마이그레이션 큐 및 스토리지: .queue.core.windows.net 및 .blob.core.windows.net
  • 대상: *.sharepoint.com
  • 테넌트 및 사이트 정보용 Graph: graph.microsoft.com

Migration Manager의 경우 Learn 사전 요구 사항 페이지에 스캔 관련 엔드포인트가 추가로 나와 있습니다. 예를 들어 api.mmp.svc.cloud.microsoft, odyssey.mmp.svc.cloud.microsoft, odyssey.prod.migrations.microsoft.com과 여러 SignalR 호스트가 있습니다. api.prod.migrations.microsoft.com은 Migration Manager 웹 UI에 필요한 항목으로 같은 페이지에 명시되어 있습니다. 목록은 변경되므로 항상 페이지에서 최신 목록을 그대로 확인하십시오. 페이지 도입부에는 SignalR 연결용으로 production.odyssey.ops.mover.io도 언급되어 있는데, 이 호스트는 표에 없으므로 표 주변의 본문 내용도 함께 확인해야 합니다.

api.office.com 스레드에서 해결된 답변으로 표시된 댓글은 다음과 같은 조언을 제시합니다.

  1. 방화벽이 거부했다고 해서 해당 엔드포인트가 불필요하다는 증거로 보지 마십시오.
  2. 마이그레이션 컴퓨터에서 TCP 443으로 호스트 이름을 허용하고, IP 주소가 아닌 DNS 기반 규칙을 사용하십시오. 이는 스레드의 조언입니다. Learn에서는 포트를 명시하지 않습니다.
  3. 방화벽 필드가 항목을 거부하면 FQDN 개체에 호스트 이름만 입력하십시오. 필드가 거부하는 대상은 https:// 접두사일 수 있습니다. 이 부분은 Learn이 아니라 스레드의 조언입니다.
  4. 마이그레이션 컴퓨터에서 이름 확인과 아웃바운드 TLS 연결을 테스트한 다음 스캔을 다시 실행하십시오.

마이그레이션 컴퓨터에서 간단히 테스트하는 방법은 다음과 같습니다.

``powershell Test-NetConnection api.office.com -Port 443 Test-NetConnection odyssey.prod.migrations.microsoft.com -Port 443 ``

*.blob.core.windows.net과 같은 와일드카드는 그대로 테스트할 수 없습니다. 대신 테넌트에서 실제 호스트 이름을 테스트하십시오. "Cannot scan" 스레드의 한 답변은 에이전트와 이 호스트 사이에서 프록시, 방화벽, SSL 검사 또는 인증서 변경이 없는지도 확인하라고 권합니다. 두 사전 요구 사항 페이지에서는 SSL 검사가 언급된 것을 보지 못했으므로, 이 부분은 커뮤니티의 제안으로 보시기 바랍니다.

2단계: 마이그레이션 컴퓨터의 여유 공간 확인

SPMT의 문제 해결 페이지에는 다음 오류가 정리되어 있습니다.

  • "Scan File Failure: Not enough disk space to pack the file": 마이그레이션 작업 폴더의 디스크 공간이 원본 파일 크기에 비해 부족한 경우입니다. 작업 폴더의 용량을 늘린 뒤 다시 시도하십시오.
  • 오류 0x02040012: SPMT가 작업 폴더에 패키지를 캐시하기 때문에 로컬 컴퓨터의 임시 스토리지가 부족한 경우입니다. 임시 스토리지를 확장한 뒤 다시 시도하십시오.

Learn은 권장 및 최소 하드웨어 프로필 모두에서 SPMT를 실행하는 컴퓨터에 로컬 저장소 150GB의 여유 공간을 권장합니다. 시스템 드라이브와 작업 폴더가 있는 드라이브를 확인하십시오. 문제 해결 페이지에는 작업 폴더 %appdata%\Microsoft\MigrationToolStorage가 언급되어 있으며, 여러 오류 항목에서 마이그레이션 중에는 이 폴더의 파일과 폴더를 닫아 두어야 한다고 설명합니다.

SharePoint 2019 스레드에서 MVP 타이틀을 가진 커뮤니티 구성원의 답변은 이 메시지가 SharePoint Online 제한이 아니라 로컬 임시 스토리지를 가리킬 가능성이 높다고 말했습니다. Learn 페이지에는 위의 로컬 오류가 나열되어 있지만 "target site collection"이라는 정확한 문구는 없습니다. 따라서 로컬 확인이 가장 근거가 뒷받침되는 첫 단계입니다.

3단계: 대상 사이트와 테넌트 스토리지 확인

같은 스레드의 다른 답변은 두 번째 메시지인 "Not all the items in the package have been migrated"가 아마 첫 번째 오류의 부수적인 결과일 것이라고 말했습니다. 대상 사이트의 스토리지 제한(SharePoint 관리 센터의 활성 사이트에서 확인), 전체 테넌트 스토리지, 이전 버전 및 휴지통 콘텐츠를 확인하라고 제안했습니다. 이 답변과 앞의 답변은 해결된 답변으로 표시되지 않았고, 게시자도 결과를 보고하지 않았습니다.

대상 사이트가 가득 찼다면, Learn이 저장소에 대해 설명하는 내용을 기억해 두십시오. 사용량 보고서는 최대 48시간까지 늦게 반영될 수 있으며, 수동 저장소 모드에서는 사이트마다 각자의 용량 제한이 있습니다.

"일부 항목이 마이그레이션되지 않음" 문제와 관련하여, Learn 문제 해결 페이지에는 오류 0x01710009가 두 번 나옵니다. 한 번은 "Errors or time-out for Server Processing the file: Not all the items in the package are migrated"라는 텍스트와 함께, 다른 한 번은 패키지 내 일부 항목이 실패한 작업 종료 오류로 인한 실패로 나오며, 이때는 마이그레이션을 다시 시작하라는 조언이 함께 제시됩니다. 목록 항목의 종속성이 누락된 경우(오류 0x01410010)에는 FailureSummaryReport.csv를 확인하고, 종속성이 마이그레이션 범위에 포함되어 있는지 확인하십시오. 이 스레드에서는 실패한 라이브러리 하나를 더 작은 배치로 나누어 다시 시도한 뒤, 누락된 항목을 찾기 위해 증분 마이그레이션을 실행하라고 제안합니다. 이는 Learn의 절차가 아니라 커뮤니티의 제안입니다.

4단계: Migration Manager 에이전트 확인

Learn의 Migration Manager 문제 해결 페이지에는 "Cannot scan"은 아니지만 증상이 비슷한 몇 가지 에이전트 사례가 나와 있습니다.

  • 에이전트 연결 끊김: 가능한 원인으로는 에이전트 컴퓨터의 네트워크 상태, 테넌트 관리자 계정의 암호 변경 또는 이와 유사한 중요 변경(이 경우 모든 에이전트를 다시 설치해야 함), 자동 업그레이드 실패, 토큰 만료가 있습니다.
  • 검사가 Queued 상태에 머무름: 예약은 Default 에이전트 그룹에 있는 에이전트에서만 가능합니다. 해당 그룹에 에이전트가 없다면 에이전트의 그룹을 Default로 변경하십시오.
  • 작업 제출 실패(0x01610002): 페이지에서는 microsoft.sharepoint.migration.clientservice.exe 및 microsoft.sharepoint.migration.mthost.exe에 대해 바이러스 백신 예외를 설정하도록 권장합니다.

"Cannot scan" 스레드에서 한 응답자는 Microsoft의 에이전트 설정 단계를 나열하면서, 모든 공유 폴더가 영향을 받는지 아니면 일부만 영향을 받는지 물었습니다. 같은 스레드의 자동 생성 답변은 에이전트 구성 파일을 편집하라고 제안했습니다. 이러한 답변은 근거가 되지 않으며, 제가 확인한 Learn 페이지에도 이와 유사한 내용은 없었습니다. 따라서 Microsoft의 확인 없이 해당 변경을 적용하지 마십시오. 질문자는 지원 엔지니어로부터 알려진 문제이며 현재 작업 중이라는 이야기를 들었다고 적었습니다. 그러나 스레드에서 Microsoft 직원이 이를 확인하지는 않았습니다. 증상이 일치한다면 지원팀에 빨리 문의하십시오.

5단계: 에이전트의 인증서 로그인

인증서 스레드에는 확인된 해결책이 없습니다. Microsoft 직원 모더레이터는 token_not_found의 원인으로 인증서 구성 파일이 없거나 불완전한 점을 지목했고, 앱 권한을 확인하라고 요청했습니다. 질문자는 해당 파일을 확인했으며 에이전트도 여러 번 다시 설치했다고 답했습니다. 이후 모더레이터는 엔드포인트 점검과 관리 사이트에 대한 앱의 읽기 권한 부여를 제안했고, 질문자는 엔드포인트 테스트는 통과했지만 문제가 계속된다고 보고했습니다. 마지막 모더레이터 댓글은 문제가 계속되면 Microsoft Service Hub를 이용하라고 제안했습니다. 해결을 확인한 답변은 없습니다. 제가 읽은 Learn 페이지에서는 파일 형식이나 권한을 확인할 수 없었으므로, 인증서 인증은 공식 Migration Manager 설정 페이지를 참고하고 이 스레드에는 의존하지 마십시오.

6단계: 증거 수집

Learn은 Migration Manager의 로그 위치를 다음과 같이 안내합니다. 실패한 작업은 %AppData%\Microsoft\SPMigration\Logs에서 확인하고, 완료된 작업의 작업 보고서는 %AppData%\Microsoft\SPMigration\Logs 아래의 Migration\MigrationTool[tenant_site] 폴더(또는 사용자 지정 작업 폴더 아래)에서 확인합니다. 하위 폴더를 수정한 시간순으로 정렬하고, 작업 시작 시점에 가장 가까운 폴더를 여십시오. SPMT 페이지에는 자체 로그 폴더가 나와 있지 않으므로, (한 답변에서 제안한 대로) 도구에서 실패한 작업의 보고서를 여십시오. 첫 번째 실패 항목, 오류 코드, 상관 ID, UTC 기준 시간을 기록하고 대상 사이트 URL도 함께 적어 두십시오.

제한 사항 및 미해결 사항

  • 표시된 해결책이 있는 것은 엔드포인트 문제뿐이며, 그마저도 질문자가 확인 의견을 남기지 않았습니다.
  • 디스크 공간, "Cannot scan", 인증서 관련 스레드는 모두 미해결 상태입니다. 해당 단계는 문제 범위를 좁히기 위한 점검 목록으로 활용하십시오.
  • Migration Manager 사전 요구 사항 페이지에는 2025년 7월이라고 표시된 업데이트 날짜가 있습니다. 현재 포털이 요구하는 내용과 비교해 확인하십시오.

관련 자료

데이터 원본

쇼 팔로우하기Spotify

Entities in this article

SharePoint SharePoint migration Tenant-to-tenant migration

Related articles

RSS