Berikut cara memecahkan masalah yang mungkin Anda alami saat menyiapkan Google Workspace Migrate dan menjalankan migrasi.
Error pengaitan | Melacak migrasi | Error jembatan
Memecahkan masalah error pengaitan atau koneksi
Buka bagian | Ciutkan semua & ke bagian atas
Memeriksa log host layanan- Untuk menemukan log:
- Di penginstalan platform—Buka C:\Program Files\Google Workspace Migrate\Google Workspace Migrate Platform\AppBridgeServiceHost.log.
- Di penginstalan node—Buka C:\Program Files\Google Workspace Migrate\Google Workspace Migrate Platform Node\AppBridgeServiceHost.log.
Catatan: Jika menjalankan Google Workspace Migrate versi lebih lama, Anda mungkin perlu menggunakan G Suite di jalur, bukan Google Workspace.
- Buka log lalu scroll ke bagian akhirnya.
- Jika ada masalah yang relevan, pecahkan masalahnya.
Anda dapat mengabaikan pesan "Access denied: Symmetric encryption is required for this service request but not configured" (Akses ditolak: Enkripsi simetris diperlukan untuk permintaan layanan ini, tetapi belum dikonfigurasi).
- Jika Anda tidak dapat memperbaiki masalah ini, buka Menghubungi dukungan untuk masalah Google Workspace Migrate.
- Login ke platform Google Workspace Migrate dan klik Servers (Server) di pojok kanan atas.
- Pastikan node Anda muncul dalam daftar.
- Periksa apakah status node Ready (Siap - hijau).
Jika Anda mendapatkan error saat mencoba mengaitkan node dengan platform Google Workspace Migrate, periksa apakah node berjalan:
- Masukkan alamat IP dan port node (misalnya, http://192.0.2.1:5131) di browser pada komputer yang menjalankan platform.
- Jika platform dapat menjangkau node dan layanan node sedang berjalan, Anda akan mendapatkan pesan "Node is running" (Node berjalan).
- Jika Anda menerima error, coba opsi berikut:
- Jika terjadi error jaringan, selesaikan error dan coba lagi.
- Mulai ulang layanan node.
- Instal ulang aplikasi node. Untuk mengetahui detailnya, ikuti langkah-langkah dalam Menginstal server node.
Jika Anda mendapatkan pesan error ini:
- Buka log host layanan untuk server node.
Untuk mengetahui detailnya, buka Memeriksa log host layanan.
- Periksa error berikut: The provided platform host address https://platformserver:443/Hub (Alamat host platform yang disediakan, https://platformserver:443/Hub, tidak dapat dijangkau).
- Jika Anda melihat error, coba opsi berikut:
- Periksa koneksi jaringan ke server platform. Jika ada masalah jaringan, selesaikan masalahnya dan mulai ulang layanan node.
- Jika platform dikonfigurasi dengan sertifikat TLS, masukkan alamat IP dan port platform (misalnya, https://192.0.2.1:5131) di browser pada komputer yang menjalankan platform. Selain itu, pastikan sertifikat TLS valid dan masa berlakunya belum habis.
Jika Anda mendapatkan pesan invalid_grant (pemberian izin tidak valid) di log host, periksa apakah:
- Anda mengaktifkan semua cakupan API untuk akun target. Untuk mengetahui detailnya, buka Menggunakan Google Cloud Console untuk mengaktifkan API.
- Akun layanan diotorisasi untuk cakupan yang diperlukan di konsol Google Admin. Gunakan client ID OAuth 2.0 untuk otorisasi, bukan client ID akun layanan. Untuk mengetahui detailnya, buka artikel Membuat client ID web OAuth.
Jika migrasi berjalan lambat atau tidak berjalan sama sekali, mungkin error-nya berkaitan dengan level kuota Google Workspace API. Untuk mengetahui detailnya, buka Menangani kuota.
Memantau kondisi & progres migrasi
Buka bagian | Ciutkan semua & ke bagian atas
Memantau partisiSaat menjalankan pemindaian atau jembatan, Anda dapat memantau status partisi.
- Di platform Google Workspace Migrate, klik Scans (Pemindaian) atau Bridges (Jembatan).
- Di pemindaian atau jembatan yang ingin Anda periksa, klik Logs (Log)
Partition log (Log partisi).
- Di bagian State (Status), periksa status partisi:
- Ready (Siap)—Siap untuk memulai.
- Starting (Memulai)—Sedang mempersiapkan migrasi atau pemindaian.
- Crawling (Meng-crawl)—Membaca data dari sistem sumber.
- Processing (Memproses)—Bersiap untuk menulis data ke sistem target.
- Committing (Melakukan commit)—Menulis data ke sistem target.
- Cancelled (Dibatalkan)—Gagal. Lanjutkan ke Memecahkan masalah partisi yang dibatalkan.
- Completed (Selesai)—Selesai memproses.
- Skipped (Dilewati)—Dilewati karena tidak ada proses yang gagal, ditampilkan saat mencoba ulang proses yang gagal.
Jika Anda menemukan partisi dengan status Canceled (Dibatalkan) di log partisi, pecahkan masalah menggunakan opsi di bawah.
Opsi 1: Periksa kode error
Untuk menemukan kode error, arahkan kursor ke baris di log partisi, lalu klik More (Lainnya) Partition log (Log partisi). Gunakan kode error yang terkait dengan kegagalan proses untuk memecahkan masalah tersebut. Untuk mengetahui detailnya, buka Menafsirkan pesan error Google Workspace Migrate.
Opsi 2: Periksa node
Gunakan log partisi untuk memeriksa apakah semua partisi pada suatu node dibatalkan. Jika semua node yang dibatalkan, hal ini biasanya berarti ada masalah koneksi, misalnya, layanan sumber tidak tersedia untuk sementara. Selesaikan langkah-langkah di Terjadi error saat mengaitkan node. Setelah itu, coba lagi pemindaian atau jalankan migrasi delta.
Opsi 3: Periksa log eksekusi partisi
Jika masalah memengaruhi beberapa node, Anda dapat memeriksa log eksekusi partisi. Untuk melihat log eksekusi yang terkait dengan partisi:
- Buka log partisi.
- Arahkan kursor ke baris dalam log, lalu klik More (Lainnya)
- Klik Status (Status)
- Tinjau kegagalan untuk mengisolasi dan memecahkan penyebab masalah tersebut.
- Coba lagi pemindaian atau migrasi.
Jika ada makin banyak kegagalan yang serupa dalam ringkasan migrasi, konfigurasi migrasi Anda mungkin salah.
Periksa item konfigurasi berikut untuk memastikan semuanya telah disiapkan dengan benar:
- Pastikan API, terutama Admin SDK, diaktifkan dengan benar di konsol Google Admin. Untuk mengetahui detailnya, buka Menggunakan Google Cloud Console untuk mengaktifkan API.
- Pastikan akun pengguna ada di akun sumber dan di Google Workspace Migrate. Pastikan akun tidak dibekukan, ditangguhkan, atau diganti namanya.
- Pastikan layanan Google Workspace Migrate yang diperlukan (misalnya, Gmail atau Google Drive) telah diaktifkan untuk semua pengguna. Untuk mengetahui detailnya, buka Persyaratan Google Workspace.
Jika mendapatkan error ini di log host, Anda mungkin perlu mengizinkan aplikasi pihak ketiga untuk file Drive.
Untuk memperbaiki masalah ini, ikuti langkah-langkah di Mengizinkan aplikasi pihak ketiga mengakses file yang disimpan di Drive.
Memperbaiki error jembatan
Buka bagian | Ciutkan semua & ke bagian atas
Menjalankan jembatan sebagai migrasi deltaAnda sering kali dapat memperbaiki banyak error dengan menjalankan migrasi delta. Migrasi delta mengidentifikasi error yang terus-menerus terjadi dan membersihkan masalah sementara, seperti pembatasan kapasitas dan tingkat kuota, masalah jaringan, dan error 401. Anda dapat menjalankan migrasi delta beberapa kali untuk memecahkan masalah. Untuk mengetahui detailnya, buka Bersiap menggunakan akun.
| Error 60008 atau kata kunci | Langkah-langkah pemecahan masalah |
|---|---|
| No mapping found (Tidak ditemukan pemetaan). | Anda mungkin menerima error ini jika memigrasikan data drive bersama dari satu akun Google Workspace Migrate ke akun lainnya, dan telah membuat drive bersama secara manual di akun baru. Untuk memecahkan masalah:
|
| Transaction that the affected item depended on failed. (Item yang terpengaruh memiliki dependensi terhadap transaksi yang gagal). | Lihat item gagal lainnya di jembatan yang sama dan pecahkan masalah tersebut. Setelah Anda menyelesaikan masalahnya, jalankan jembatan delta. |
|
Parent object failed to migrate. (Objek induk gagal dimigrasikan.) Anda mungkin juga melihat: The bridge execution was halted or completed prior to dependency of the transaction being completed. (Eksekusi jembatan dihentikan atau diselesaikan sebelum dependensi transaksi selesai.) |
Objek induk item yang terpengaruh gagal dimigrasikan, atau objek turunan dimigrasikan sebelum objek induknya. Untuk memecahkan masalah:
|
| Parent entity target dihapus, diganti namanya, atau dipindahkan ke lokasi lain setelah migrasi. Ketika jembatan lain mencoba memigrasikan entitas turunan atau induk sumber lagi, entitas tersebut tidak dapat ditemukan. |
|
| Penyambungan pemetaan sumber ke target tidak didukung. | Tinjau pemetaan Anda untuk memastikan bahwa lokasi sumber dan target sudah valid. Untuk mengetahui detailnya, buka Membuat & mengelola pemetaan untuk Exchange, SharePoint, berbagi file, Box, atau Google Workspace Migrate . |
| LocationNotFound | Drive bersama Google Workspace tidak dapat dimigrasikan ke drive bersama di akun target karena pengguna target tidak memiliki lisensi Google Workspace yang menyertakan drive bersama. Periksa lisensi di akun target Anda, lalu coba lagi. |
| OrphanedContent |
Anda mungkin juga melihat error ini jika pemilik item usang tidak ditentukan sebagai akun sumber dalam pemetaan. Google Workspace Migrate tidak akan memigrasikan item dan menampilkan kode error 60008. Error tidak dapat dihindari dalam situasi ini. Catatan: File usang di lokasi target yang berbeda kemungkinan berasal dari masalah yang berbeda. Situasi ini dapat terjadi, misalnya, jika tidak ada folder target yang ditentukan dalam pemetaan untuk item usang, dan item tersebut dimasukkan ke dalam folder root Drive Saya milik pengguna target. |
| No mapping found for user (Pemetaan untuk pengguna tidak ditemukan) |
|
Jika file gagal dimigrasikan dengan error ini:
- Buka log transaksi.
- Untuk Error Code, telusuri 1029 untuk menentukan apakah folder induk gagal dimigrasikan.
- Jika folder induk tidak dimigrasikan, periksa kode error dan perbaiki masalahnya.
- Jalankan jembatan delta.
Jika Anda memigrasikan file dari satu drive bersama ke drive bersama lain, pastikan Anda menggunakan pemetaan identitas yang memetakan sumber ke pengguna target di jembatan.
- Di platform Google Workspace Migrate, klik Scans (Pemindaian) atau Bridges (Jembatan).
- Di pemindaian atau jembatan yang ingin diperiksa, klik Logs (Log)
- Arahkan kursor ke transaksi, lalu klik More (Lainnya)
- Gunakan tabel ini untuk menemukan error transaksi umum dan langkah-langkah pemecahan masalah.
| Pesan error & kode | Langkah-langkah pemecahan masalah |
|---|---|
| Transaksi dalam status Failed (Gagal) | Temukan transaksi dan pecahkan masalah menggunakan informasi dalam detail transaksi. |
| Pesan error: The request type does not allow write operations (Jenis permintaan tidak mengizinkan operasi penulisan)
Kode error: 1048640 |
Pengendali permintaan untuk jenis objek tidak dapat menuliskan objek ke akun target (misalnya, item sumber tidak memiliki jenis yang setara di Google Workspace).
Periksa apakah pemetaan lokasi Anda ditetapkan dengan benar dan pemetaannya logis. |
| Pesan error: An internal connector error occurred (Terjadi error konektor internal)
Kode error: 2097125 |
Periksa pesan error di log transaksi dan eksekusi. Jika pesan error tidak membantu, periksa detail di log host layanan platform atau node. |
| The bridge execution was halted or completed prior to dependency of the transaction being completed (Eksekusi jembatan dihentikan atau diselesaikan sebelum dependensi transaksi selesai.) | Item tidak ditransfer karena bergantung pada item lain yang dimigrasikan lebih dahulu, tetapi item tersebut tidak berhasil dimigrasikan. Misalnya, file dalam folder tidak dimigrasikan karena folder tersebut tidak dibuat di Drive.
Dalam error, temukan ABHierarchicalPath.Path dan catat item terkait. Kemudian, temukan item tersebut di log transaksi untuk memahami alasan item gagal dimigrasikan. |
Transaksi dalam log transaksi Anda mungkin dilewati karena alasan berikut:
- Anda menjalankan migrasi delta dan objek belum berubah sejak migrasi sebelumnya.
- Objek dikecualikan oleh kondisi filter di template setelan.
- Anda memigrasikan konten email ke grup, dan lampiran pesan yang berukuran besar dilewati.
- Anda menggunakan template setelan drive bersama, tetapi memigrasikan konten ke Drive Saya.
Bergantung pada sumber migrasi, alasan lain item dilewati adalah:
- SharePoint—Folder dilewati karena bukan merupakan bagian dari library dokumen.
- Exchange—Email draf dilewati saat dimigrasikan ke Google Grup.
- Box—Revisi file dilewati karena revisi kosong.
- Berbagi file—Item dilewati karena node tidak memiliki izin yang memadai untuk mengakses item.
- Gmail—Pesan Chat (item dalam label Chat) akan dilewati.
Saat bermigrasi antar Drive Bersama menggunakan template setelan Default, GWM akan membuat Drive Bersama baru di akun target, tetapi mungkin tidak memigrasikan data dari Drive Bersama sumber. Hal ini dikarenakan:
- Tidak ada Pemetaan Identitas untuk sumber dan target.
- Opsi Izinkan pengguna yang tidak dipetakan di Template tidak dicentang.
Ada dua cara untuk memperbaiki masalah ini:
- Buat template kustom dari template setelan Default dan centang Izinkan pengguna yang tidak dipetakan.
- Tambahkan Pemetaan Identitas.
Laporan transaksi mungkin terlalu besar untuk didownload. Pecahkan masalah dengan opsi berikut:
Opsi 1: Menambahkan filter sebelum melakukan migrasi
Untuk mengurangi ukuran laporan, filter log transaksi untuk menelusuri data tertentu, seperti status penyelesaian atau kode error. Untuk mengetahui detailnya, buka Memantau progres migrasi.
Opsi 2: Mendownload log dengan filter
Anda dapat menggunakan command line untuk menentukan cara mendownload log transaksi:
- Untuk mengurangi jumlah item dalam log, gunakan opsi transactionState.
- Untuk menambah waktu yang dibutuhkan log untuk didownload, gunakan opsi queryTimeout.
Untuk mengetahui detailnya, buka Mendownload log menggunakan command line.
Jika migrasi lebih lambat dari yang diharapkan, pastikan Anda memenuhi persyaratan sistem berikut.
Tingkat kuota Google API
Setelan kuota Anda dapat menyebabkan kode error, seperti Error 403 Forbidden, 429 Too Many Requests, atau 503 Service Unavailable. Untuk memverifikasi apakah tingkat kuota memengaruhi kecepatan migrasi Anda:
- Periksa kuota di konsol Google Cloud. Untuk mengetahui langkah-langkahnya, buka Melihat kuota di Konsol Google Cloud.
- Sesuaikan kuota untuk mendukung penggunaan resource Anda. Untuk mengetahui langkah-langkahnya, buka Mengelola kuota menggunakan konsol.
Setelan pembatasan sisi klien
Setelan throttling mengelola kecepatan klien dapat mengirim permintaan ke layanan Google. Terkadang, setelan menyebabkan kode error, seperti Error 403 Forbidden, 429 Too Many Requests, atau 503 Service Unavailable.
Kode error ini dapat muncul karena kecepatan throttling yang terlalu tinggi di Google Workspace Migrate (GWM). Jika throttling sisi klien tinggi tanpa throttling sisi server yang signifikan, penyesuaian setelan padding di GWM dapat membantu.
Sebelum memulai
- Perubahan ini hanya boleh dilakukan oleh administrator berpengalaman, karena perubahan mungkin memiliki konsekuensi yang tidak diinginkan.
- Langkah-langkah berikut menetapkan strategi throttling Google, tetapi Anda mungkin juga perlu menggunakan sumber data lain, termasuk googleThrottlingStrategy, exchangeThrottlingStrategy, dan sharepointThrottlingStrategy.
Untuk mengganti strategi throttling default pada GWM versi 2.1.54.0 dan yang lebih baru:
- Di server Platform, buat direktori: C:\ProgramData\AppBridge\Overrides
- Tambahkan file JSON bernama throttling_settings.json
- Dengan menggunakan Notepad, tambahkan teks berikut ke file JSON:
{
"googleThrottlingStrategy": {
"throttlingModel": "ADAPTIVE_THROTTLING",
"adaptiveThrottlePadding": 32,
"adaptiveThrottleAcceptanceRatio": 1.1,
"adaptiveThrottleIntervalMs": 60000
}
} - Simpan file JSON.
- Di area notifikasi Windows, klik
.
- Hentikan layanan GWM, lalu mulai lagi.
Pembatasan firewall
Untuk mengurangi gangguan pada operasi disk dan jaringan, uninstal software antivirus, pemindai keamanan, dan software tidak penting lainnya dari server Workspace.
Google Workspace Migrate menggunakan MySQL untuk menyimpan setelan konfigurasi dan detail logging. Jika koneksi MySQL Anda terputus-putus atau tidak responsif, buka Memeriksa log host layanan dan ikuti langkah-langkah untuk penginstalan platform.
Jika Anda melihat error MySQL untuk AppBridgeServiceHost.log:
- Buka Memecahkan masalah MySQL.
- Jika Anda masih memerlukan bantuan, buka Menghubungi dukungan untuk masalah Google Workspace Migrate.
Masih butuh bantuan?
Buka Menghubungi dukungan untuk masalah Google Workspace Migrate.
Google, Google Workspace, serta merek dan logo yang terkait adalah merek dagang Google LLC. Semua nama perusahaan dan produk lainnya adalah merek dagang masing-masing perusahaan yang terkait.