다음은 Google Workspace Migrate 플랫폼을 설정하거나 설치하는 동안 발생할 수 있는 문제를 해결하는 방법입니다.
로그인 시 오류 발생
플랫폼에 로그인할 때 다음 오류가 발생할 수 있습니다.
You have created a new client application that uses libraries for user authentication or authorization that will soon be deprecated. New clients must use the new libraries instead; existing clients must also migrate before these libraries are deprecated
Google Workspace Migrate 버전 2.3.4.0 이상으로 업그레이드한 후 다시 시도해 주세요. 자세한 내용은 소프트웨어 업그레이드하기를 참고하세요.
플랫폼 구성 문제 해결하기
Google Workspace Migrate에 로그인할 때 Platform is not configured correctly(플랫폼이 올바르게 구성되지 않았습니다)라는 메시지가 표시되면 다음 안내를 따르세요.
- 서비스 호스트 로그를 엽니다. 서비스 호스트 로그 확인하기의 단계를 따릅니다.
- 로그 끝까지 스크롤하면서 원인이 될 수 있는 문제를 찾습니다.
- 아래 일반적인 문제에 대한 문제 해결 단계를 따릅니다.
| 메시지 | 문제 해결 단계 |
| Client is unauthorized to retrieve access tokens using this method, or client not authorized for any of the scopes requested. | 수동으로 서비스 계정을 설정한 경우, 수동으로 서비스 계정 만들기에서 도메인에 대한 위임 단계를 완료하고 범위를 승인했는지 확인하세요. |
|
수동으로 플랫폼 설치하기에서 올바른 OAuth 클라이언트 ID를 사용했는지 확인하세요.
이 작업의 8단계에서 OAuth 클라이언트 ID를 입력합니다. |
| Platform is not configured correctly. | 클라우드 접근 보안 브로커(CASB) 공급업체의 에이전트 설치 여부를 플랫폼 서버에서 확인하세요.
설치되어 있는 경우 에이전트를 삭제하여 트래픽을 올바르게 주고받도록 하세요. 자세한 내용은 Google Workspace에 타사 CASB를 설정하는 방법 안내를 참고하세요. |
플랫폼 교체하기
하드웨어 오류 등으로 인해 플랫폼 인스턴스를 교체해야 하는 경우 Google Workspace Migrate를 설정할 때 사용되는 암호화 키와 비밀번호가 필요합니다. 암호화 키는 데이터베이스에 액세스할 때 필요합니다. 암호화 키가 없이는 플랫폼에서 이전 데이터를 복구할 수 없습니다.
키가 없는 경우 Google Workspace Migrate 설정을 다시 해야 합니다.
옵션 1: 암호화 키가 있는 경우새 플랫폼을 설정하려면 다음 안내를 따르세요.
- 플랫폼을 다운로드하고 설치합니다.
자세한 내용은 플랫폼 설치 및 설정하기를 참고하세요.
- Chrome browser(Chrome 브라우저)를 열고 http(s)://localhost:<포트> 형식을 사용하여 Google Workspace Migrate 플랫폼의 URL을 입력합니다.
- 서비스 계정의 클라이언트 ID를 승인하는 데 사용한 것과 동일한 관리자 계정을 사용하여 플랫폼에 로그인합니다.
- Get started(시작하기)를 클릭합니다.
- I want to recover previous migration data(지난 이전 데이터 복구하기)를 클릭합니다.
- Password(비밀번호) 입력란에 암호화 키 비밀번호를 입력합니다.
- Upload CSV file(CSV 파일 업로드)을 클릭하여 암호화 키를 업로드하거나 파일을 상자로 드래그합니다.
- Recover key(복구 키)를 클릭합니다.
- Google Workspace Migrate를 처음 설정할 때 사용한 데이터베이스 설정을 사용하여 데이터베이스 설정 구성하기의 단계를 완료합니다.
- 처음 Google Workspace Migrate를 설정할 때 사용한 콜백 주소와 노드를 사용하여 설정 과정을 계속 진행합니다.
복구 과정을 완료하면 새 플랫폼에서 이전 데이터에 액세스할 수 있습니다.
키가 없는 경우 Google Workspace Migrate 설정을 다시 설정합니다.
- 데이터베이스 및 플랫폼의 모든 VM을 삭제합니다.
- VM을 만들고 데이터베이스 및 플랫폼용 소프트웨어를 재설치합니다.
자세한 내용은 데이터베이스 설치하기 및 플랫폼 설치 및 설정하기를 참고하세요.
- 기존 노드를 새 플랫폼과 다시 연결합니다.
자세한 내용은 노드 서버 추가하기를 참고하세요.