시작하기 전에
- 이전 단계에서 다운로드한 GoogleWorkspaceMigrate_Platform_Installer를 플랫폼을 설치할 Windows 서버에 복사합니다.
- Windows 서버를 최신 상태로 유지하되 이전 중에 자동 업데이트를 사용 중지하여 프로세스가 중단되지 않도록 하는 것이 좋습니다.
- Google Workspace Migrate 플랫폼을 설치할 Windows 서버에 충분한 공간이 있는지 확인합니다. 자세한 내용은 시스템 요구사항을 참고하세요.
- 서비스 계정 키를 서버에 복사합니다. 키는 서비스 계정을 설정할 때 생성되었습니다. 다시 만들어야 하는 경우 인증을 위한 서비스 계정 만들기를 참고하세요.
1단계: 플랫폼 설치 및 설정 방법 선택하기
플랫폼을 수동으로 설치하거나 명령줄을 사용하여 설치할 수 있습니다.
수동으로 플랫폼 설치하기플랫폼의 Windows 서버에서 다음을 수행합니다.
- 관리자 권한으로 GoogleWorkspaceMigrate_Platform_Installer를 실행합니다.
- 설치 프로그램의 언어를 선택하고 OK(확인)를 클릭합니다.
- 라이선스 계약에 동의하고 Next(다음)를 클릭합니다.
- Google Workspace Migrate 플랫폼을 설치할 위치를 선택하고 Next(다음)를 클릭합니다.
- 시작 메뉴 폴더를 선택하고 Next(다음)를 클릭합니다.
- 추가 바로가기 옵션을 선택하고 Next(다음)를 클릭합니다.
- 포트 번호를 입력하거나 기본 포트 5131을 수락하고 Next(다음)를 클릭합니다.
- Google OAuth 클라이언트 ID를 입력하고 Next(다음)를 클릭합니다.
Google Cloud console을 설정할 때 ID를 만들었습니다. OAuth 웹 클라이언트 ID 만들기를 참고하세요.
- Browse(찾아보기)를 클릭하고 서비스 계정 키가 포함된 JSON 파일의 위치를 선택한 다음 Next(다음)를 클릭합니다.
Google Workspace 서비스 계정을 만들 때 JSON 파일을 만들었습니다. 파일을 분실했거나 Google Cloud console에서 키를 삭제한 경우 해당 단계를 반복하여 새 계정을 만들어야 합니다. 자세한 내용은 인증을 위한 서비스 계정 만들기를 참고하세요.
- 이전하려는 대상 Google Workspace 도메인의 최고 관리자 이메일 주소를 입력하고 Next(다음)를 클릭합니다.
서비스 계정을 승인할 때 사용한 것과 동일한 이메일 주소를 사용합니다. 자세한 내용은 인증을 위한 서비스 계정 만들기를 참고하세요.
- Install(설치)을 클릭합니다.
- 설치 후 Finish(마침)를 클릭합니다.
참고: 이 Windows 서버의 호스트 이름 또는 내부 IP 주소를 기록해 두세요. 이 값은 이후 단계에서 필요합니다.
명령줄에서 설치하면 설치 프로그램은 자동으로 다음 설정 옵션을 선택합니다.
- Google Workspace Migrate 설치 위치(C:\Program Files\Google Workspace Migrate)
- 시작 메뉴 폴더(Google Workspace Migrate)
- 모든 사용자를 위한 바탕화면 바로가기 생성
- Windows 시작 시 Google Workspace Migrate 관리 앱 자동 열림
Windows 서버에서 다음을 실행합니다.
- 관리자 권한으로 PowerShell을 실행합니다.
- Google Workspace Migrate를 설치하려면 다음 명령어와 추가 매개변수를 입력하세요. 아래 세부정보를 참고하세요.
GoogleWorkspaceMigrate_Platform_Installer_version-number.exe /CLIENTID=client-ID /SERVICEACCOUNT=C:\path-to-service-account.json /ADMINEMAIL=admin-email
- Google Workspace Migrate 플랫폼 서비스를 시작하려면 다음 명령어를 입력하세요.
Start-Service -Name AppBridge.Local.ServiceHost
- 시작 메뉴에서 Google Workspace Migrate 관리 앱을 엽니다. 또는 Windows를 다시 시작할 때 앱이 자동으로 다시 열리도록 합니다.
명령줄 매개변수
사용할 수 있는 명령줄 매개변수에 관한 자세한 내용은 Inno Setup 문서를 참고하세요.
| 매개변수 | 설명 |
|---|---|
| /ADMINEMAIL | 대상 Google Workspace 계정의 최고 관리자의 이메일 주소입니다. |
| /CLIENTID | Google Cloud console을 설정할 때 생성된 OAuth 웹 클라이언트 ID입니다. 자세한 내용은 OAuth 웹 클라이언트 ID 만들기를 참고하세요. |
| /LOG | (선택사항) 로그 파일의 파일 이름입니다.
설치 프로그램의 출력이 있는 로그 파일을 만듭니다. 설치 프로그램이 제대로 작동하지 않는 경우 로그 파일에서 정보를 확인할 수 있습니다. |
| /NORESTART | (선택사항) 설치 중에 시스템 재시작을 방지합니다. |
| /PORT | (선택사항) Google Workspace Migrate 서비스의 포트 번호입니다(기본값: 5131). |
| /SERVICEACCOUNT | 서비스 계정의 JSON 파일 경로입니다. 자세한 내용은 인증을 위한 서비스 계정 만들기를 참고하세요.
경로에 공백이 포함된 경우 경로를 따옴표로 묶습니다. |
| /SP- | (선택사항) 설정 시작 시 프롬프트를 사용 중지합니다. |
| /SUPPRESSMSGBOXES | (선택사항) 모든 메시지 상자를 표시하지 않습니다. |
| /VERYSILENT | (선택사항) 설치 프로세스 중에 설정 마법사와 창을 사용 중지합니다. |
플랫폼 업그레이드
CLIENTID, SERVICEACCOUNT, ADMINEMAIL 매개변수는 해당 값을 변경하지 않는 한 업그레이드할 때 필요하지 않습니다.
예:
GoogleWorkspaceMigrate_Platform_Installer_version-number.exe /SP- /VERYSILENT /SUPPRESSMSGBOXES /NORESTART
2단계: 선택적인 단계 완료하기
HTTP 프록시 서버를 사용하도록 플랫폼 설정하기프록시 서버를 사용하는 경우 플랫폼을 설치한 서버에서 다음을 실행합니다.
- Google Workspace Migrate 앱을 더블클릭합니다.
- 작업 표시줄에서 Google Workspace Migrate
를 마우스 오른쪽 버튼으로 클릭하고 Edit proxy settings(프록시 설정 수정)를 선택합니다.
- Use a proxy server(프록시 서버 사용)를 선택합니다.
- Address(주소)에 http://proxy ip address:port 형식을 사용하여 프록시 주소를 입력합니다.
예: http://192.0.2.1:8888
- OK(확인)를 클릭합니다.
- 작업 표시줄에서 Google Workspace Migrate
- Google Workspace Migrate
네트워크 환경을 변경하고 프록시 서버를 삭제하는 경우 위의 1단계와 2단계를 반복하고 Use a proxy server(프록시 서버 사용)를 선택 해제한 후 OK(확인)를 클릭하세요.
자체 서명 인증서는 사용하지 않는 것이 좋습니다.
플랫폼을 설치한 서버에서 다음을 수행합니다.
- TLS 비공개 키를 Windows 개인 인증서 저장소로 가져옵니다. TLS 비공개 키 가져오기에 대한 자세한 내용은 Microsoft 문서를 참고하세요.
- 컴퓨터가 신뢰할 수 없는 인증 기관(CA)에서 인증서를 발급한 경우 신뢰할 수 있는 루트 인증 기관 저장소에 CA 인증서를 추가합니다. 인증서를 저장소에 배치하는 방법에 대한 자세한 내용은 Microsoft 문서를 참고하세요.
- 관리자 권한으로 명령 프롬프트를 엽니다.
- 인증서 지문을 찾으려면 다음 명령어를 입력합니다.
PowerShell -Command dir cert:\LocalMachine\My
- 로컬 컴퓨터의 개인 저장소에 있는 인증서 목록에서 사용하려는 인증서의 지문을 복사합니다.
- 포트를 구성하려면 다음 명령어를 입력합니다.
netsh http add sslcert ipport=0.0.0.0:플랫폼-포트-번호 certhash=인증서-지문 appid= {3e3783f6-b92c-4546-8dee-672bf5c665ef}
설정 문제 해결하기
Google Workspace Migrate 플랫폼 설정 또는 로그인 문제를 해결하려면 플랫폼 문제 해결하기를 참고하세요.
다음 단계
Google, Google Workspace 및 관련 마크와 로고는 Google LLC의 상표입니다. 기타 모든 회사명 및 제품명은 해당 업체의 상표입니다.