다음은 Google Workspace Migrate를 설정하고 이전을 실행할 때 발생할 수 있는 문제를 해결하는 방법입니다.
연결 또는 연결 오류 문제 해결하기
서비스 호스트 로그 확인하기- 로그를 찾으려면 다음 안내를 따르세요.
- 플랫폼 설치 시: C:\Program Files\Google Workspace Migrate\Google Workspace Migrate Platform\AppBridgeServiceHost.log로 이동합니다.
- 노드 설치 시 C:\Program Files\Google Workspace Migrate\Google Workspace Migrate Platform Node\AppBridgeServiceHost.log로 이동합니다.
참고: 이전 버전의 Google Workspace Migrate를 실행하는 경우 경로에서 Google Workspace 대신 G Suite를 사용해야 할 수 있습니다.
- 로그를 열고 끝까지 스크롤합니다.
- 관련 문제가 있는 경우 문제를 해결합니다.
'Access denied: Symmetric encryption is required for this service request but not configured'라는 메시지는 무시해도 됩니다.
- 문제를 해결할 수 없는 경우 Google Workspace Migrate 문제 지원팀에 문의하기를 참고하세요.
- Google Workspace Migrate 플랫폼에 로그인하고 오른쪽 상단에서 Servers(서버)를 클릭합니다.
- 노드가 목록에 표시되는지 확인합니다.
- 노드 상태가 Ready(준비됨)(녹색)인지 확인합니다.
노드를 Google Workspace Migrate 플랫폼에 연결하려고 할 때 오류가 발생하면 노드가 실행 중인지 확인하세요.
- 플랫폼을 실행 중인 머신의 브라우저에서 노드의 IP 주소와 포트를 입력합니다(예: http://192.0.2.1:5131).
- 플랫폼이 노드에 도달할 수 있고 노드 서비스가 실행 중인 경우 'Node is running'이라는 메시지가 표시됩니다.
- 오류가 발생하면 다음 옵션을 시도해 보세요.
- 네트워크 오류인 경우 이를 해결하고 다시 시도합니다.
- 노드 서비스를 다시 시작합니다.
- 노드 애플리케이션을 다시 설치합니다. 자세한 내용은 노드 서버 설치하기의 단계를 따르세요.
이 오류가 표시되는 경우 다음 단계를 따르세요.
- 노드 서버의 서비스 호스트 로그로 이동합니다.
자세한 내용은 서비스 호스트 로그 확인하기를 참고하세요.
- 다음 오류를 확인합니다. 제공된 플랫폼 호스트 주소 https://platformserver:443/Hub에 연결할 수 없습니다.
- 오류 메시지가 표시되면 다음 옵션을 시도해 보세요.
- 플랫폼 서버와의 네트워크 연결을 확인합니다. 네트워크 문제가 있는 경우 문제를 해결하고 노드 서비스를 다시 시작합니다.
- 플랫폼이 TLS 인증서로 구성된 경우 플랫폼을 실행하는 컴퓨터의 브라우저에 플랫폼의 IP 주소와 포트(예: https://192.0.2.1:5131)를 입력합니다. TLS 인증서가 유효하고 만료되지 않았는지도 확인해야 합니다.
호스트 로그에 invalid_grant 메시지가 표시되면 다음을 확인합니다.
- 대상 계정의 모든 API 범위를 사용 설정했는지 확인합니다. 자세한 내용은 Google Cloud Console을 사용하여 API 사용 설정하기를 참고하세요.
- 서비스 계정에 Google 관리 콘솔에서 필요한 범위가 승인되었는지 확인합니다. 승인 시 서비스 계정의 클라이언트 ID가 아닌 OAuth 2.0 클라이언트 ID를 사용했는지 확인합니다. 자세한 내용은 OAuth 웹 클라이언트 ID 만들기를 참고하세요.
이전이 느리게 실행되거나 전혀 실행되지 않는 경우 Google Workspace의 API 할당량 수준과 관련된 오류일 수 있습니다. 자세한 내용은 할당량 작업을 참고하세요.
이전 상태 및 진행 상황 추적하기
파티션 모니터링하기검사 또는 브리지를 실행할 때 파티션의 상태를 모니터링할 수 있습니다.
- Google Workspace Migrate 플랫폼에서 Scans(검사) 또는 Bridges(브리지)를 클릭합니다.
- 확인하려는 검사 또는 브리지에서 Logs(로그)
Partition log(파티션 로그)를 클릭합니다.
- State(상태)에서 파티션 상태를 확인합니다.
- Ready(준비됨): 시작할 준비가 되었습니다.
- Starting(시작): 이전 또는 검사를 준비합니다.
- Crawling(크롤링): 원본 시스템에서 데이터를 읽습니다.
- Processing(처리 중): 대상 시스템에 데이터를 쓸 수 있도록 준비합니다.
- Committing(커밋): 대상 시스템에 데이터를 씁니다.
- Cancelled(취소됨): 실패했습니다. 취소된 파티션 문제 해결하기로 이동합니다.
- Completed(완료됨): 작업이 완료되었습니다.
- Skipped(건너뜀)(실패한 트랜잭션을 재시도할 때 표시됨): 실패한 트랜잭션이 없으므로 건너뜁니다.
파티션 로그에 Canceled(취소됨)로 표시된 파티션이 있다면 아래 옵션을 사용하여 문제를 해결하세요.
옵션 1: 오류 코드 확인하기
오류 코드를 찾으려면 파티션 로그의 행을 가리킨 다음 More(더보기) Partition log(파티션 로그)를 클릭합니다. 실패와 관련된 오류 코드를 사용하여 문제를 해결합니다. 자세한 내용은 Google Workspace Migrate 오류 메시지 해석하기를 참고하세요.
옵션 2: 노드 확인하기
파티션 로그를 사용하여 노드의 모든 파티션이 취소되었는지 확인할 수 있습니다. 취소된 모든 노드는 일반적으로 연결 문제를 나타냅니다(예: 소스 서비스를 일시적으로 사용할 수 없음). 노드 연결 오류의 단계를 완료한 다음 검사를 다시 시도하거나 델타 이전을 실행하세요.
옵션 3: 파티션 실행 로그 확인하기
문제가 여러 노드에 영향을 미치는 경우 파티션 실행 로그를 검사할 수 있습니다. 파티션과 관련된 실행 로그를 보려면 다음 안내를 따르세요.
- 파티션 로그를 엽니다.
- 로그의 행을 가리킨 다음 More(더보기)
- State(상태)
- 실패한 작업을 검토하여 문제의 원인을 파악하고 해결합니다.
- 검사 또는 이전을 다시 시도합니다.
이전 요약에서 유사한 오류가 증가했다면 이전 구성이 올바르지 않을 수 있습니다.
다음 구성 항목이 올바르게 설정되었는지 확인하세요.
- Google 관리 콘솔에서 API, 특히 Admin SDK가 올바르게 사용 설정되었는지 확인합니다. 자세한 내용은 Google Cloud Console을 사용하여 API 사용 설정하기를 참고하세요.
- 사용자 계정이 원본 계정과 Google Workspace에 있는지 확인합니다. 계정이 동결, 정지 또는 이름이 변경되지 않았는지 확인합니다.
- 모든 사용자에게 필요한 Google Workspace 서비스(예: Gmail 또는 Google Drive)가 사용 설정되어 있는지 확인합니다. 자세한 내용은 Google Workspace 요구사항을 참고하세요.
이 오류가 호스트 로그에 표시되면 Drive 파일에 타사 앱을 허용해야 할 수도 있습니다.
문제를 해결하려면 타사 앱이 드라이브에 저장된 파일을 사용할 수 있도록 허용 단계를 따르세요.
브리지 오류 수정하기
델타 이전으로 브리지 실행하기델타 이전을 실행하여 많은 오류를 해결할 수 있는 경우가 많습니다. 델타 이전은 지속적인 오류를 식별하고 비율 제한 및 할당량 수준, 네트워킹 문제, 401 오류와 같은 일시적인 문제를 해결합니다. 델타 이전을 여러 번 실행하여 문제를 해결할 수 있습니다. 자세한 내용은 서비스 시작 준비하기를 참고하세요.
| 60008 오류 또는 키워드 | 문제 해결 단계 |
|---|---|
| No mapping found (매핑을 찾을 수 없습니다). | 공유 드라이브 데이터를 하나의 Google Workspace 계정에서 다른 계정으로 이전하고 새 계정에서 공유 드라이브를 수동으로 만든 경우 이 오류가 발생할 수 있습니다. 문제를 해결하려면 다음 안내를 따르세요.
|
| 문제가 발생한 항목이 종속된 트랜잭션이 실패했습니다. | 동일한 브리지에서 실패한 항목을 확인하고 문제를 해결합니다. 문제를 해결할 때 델타 브리지를 실행하세요. |
|
상위 객체를 이전할 수 없습니다. 'The bridge execution was halted or completed prior to dependency of the transaction being completed'라는 메시지가 표시될 수도 있습니다. |
문제가 발생한 항목의 상위 객체가 이전되지 않았거나 하위 객체가 상위 객체보다 먼저 이전되었습니다. 문제를 해결하려면 다음 안내를 따르세요.
|
| 이전 후 대상 상위 항목이 삭제되거나, 이름이 변경되거나, 다른 위치로 이동되었습니다. 다른 브리지에서 소스 상위 항목 또는 소스 하위 항목을 다시 이전하려고 시도하면 해당 항목을 찾을 수 없습니다. |
|
| 소스와 대상 간 매핑 쌍이 지원되지 않습니다. | 매핑을 검토하여 소스와 대상 위치가 유효한지 확인합니다. 자세한 내용은 Exchange, SharePoint, 파일 공유, Box 또는 Google Workspace의 매핑 만들기 및 관리하기를 참고하세요. |
| LocationNotFound | 대상 사용자에게 공유 드라이브가 포함된 Google Workspace 라이선스가 없으므로 Google Workspace 공유 드라이브를 대상 계정의 공유 드라이브로 이전할 수 없습니다. 대상 계정에서 라이선스를 확인한 후 다시 시도해 주세요. |
| OrphanedContent |
분리된 항목의 소유자가 매핑의 원본 계정으로 지정되지 않은 경우에도 이 오류가 표시될 수 있습니다. Google Workspace Migrate에서 항목을 이전하지 않으며 60008 오류 코드가 표시됩니다. 이 경우 오류는 불가피합니다. 참고: 다른 대상 위치에 있는 분리된 파일은 별도의 문제로 인해 발생할 가능성이 높습니다. 예를 들어 분리된 항목의 매핑에 대상 폴더가 지정되어 있지 않고 항목이 대상 사용자의 내 드라이브 루트 폴더에 있는 경우 이러한 상황이 발생할 수 있습니다. |
- Google Workspace Migrate 플랫폼에서 Scans(검사) 또는 Bridges(브리지)를 클릭합니다.
- 확인하려는 검사 또는 브리지에서 Logs(로그)
- 트랜잭션을 가리킨 다음 More(더보기)
- 이 표를 사용하여 일반적인 트랜잭션 오류와 문제 해결 단계를 확인합니다.
| 오류 메시지 및 코드 | 문제 해결 단계 |
|---|---|
| Failed(실패) 상태인 트랜잭션 | 트랜잭션을 찾고 트랜잭션 세부정보의 정보를 사용하여 문제를 해결합니다. |
| 오류 메시지: The request type does not allow write operations
오류 코드: 1048640 |
객체 유형의 요청 핸들러에 대상 계정에 대한 객체 쓰기 권한이 없습니다. 예를 들어 Google Workspace에 원본 항목에 해당하는 유형이 없습니다.
위치 매핑이 올바르게 설정되어 있고 매핑이 논리적인지 확인합니다. |
| 오류 메시지: An internal connector error occurred
오류 코드: 2097125 |
트랜잭션 및 실행 로그에서 오류 메시지를 확인합니다. 오류 메시지가 도움이 되지 않으면 플랫폼 또는 노드 서비스 호스트 로그에서 세부정보를 확인하세요. |
| The bridge execution was halted or completed prior to dependency of the transaction being completed | 먼저 이전되는 다른 항목에 의존하기 때문에 항목이 이전되지 않았으며 해당 항목의 이전이 완료되지 않았습니다. 예를 들어 폴더가 Drive에 생성되지 않았기 때문에 폴더에 있는 파일이 이전되지 않았습니다.
오류에서 ABHierarchicalPath.Path를 찾아 연결된 항목을 확인합니다. 트랜잭션 로그에서 해당 항목을 찾아 이전에 실패한 이유를 파악합니다. |
다음과 같은 이유로 트랜잭션 로그의 트랜잭션을 건너뛸 수 있습니다.
- 델타 이전을 실행 중이며 지난번 이전 이후로 객체가 변경되지 않았습니다.
- 객체가 설정 템플릿의 필터 조건에 의해 제외되었습니다.
- 이메일 콘텐츠를 그룹으로 이전하는 중이며 메일의 대용량 첨부파일은 건너뜁니다.
- 공유 드라이브 설정 템플릿을 사용 중이지만 콘텐츠를 내 드라이브로 이전하고 있습니다.
이전 소스에 따라 항목을 건너뛸 수 있는 다른 이유는 다음과 같습니다.
- SharePoint: 폴더는 문서 라이브러리의 일부가 아니므로 건너뜁니다.
- Exchange: Google 그룹스로 이전 시 임시보관 이메일은 건너뜁니다.
- Box: 버전이 비어 있으므로 파일 버전은 건너뜁니다.
- 파일 공유: 항목에 액세스할 수 있는 충분한 권한이 노드에 없으므로 항목을 건너뜁니다.
- Gmail: Chat 메시지(Chat 라벨 아래의 항목)는 건너뜁니다.
도움이 더 필요하신가요?
Google Workspace Migrate 관련 문제 지원팀에 문의하기를 참고하세요.
Google, Google Workspace 및 관련 마크와 로고는 Google LLC의 상표입니다. 기타 모든 회사명 및 제품명은 해당 업체의 상표입니다.