Memecahkan masalah Google Workspace Migrate

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

1. Untuk menemukan log:
   • Untuk penginstalan platform—Buka C:\Program Files\Google Workspace Migrate\Google Workspace Migrate Platform\AppBridgeServiceHost.log.
   • Untuk 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.

2. Buka log lalu scroll ke bagian akhirnya.
3. 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).

4. Jika Anda tidak dapat memperbaiki masalah ini, buka Menghubungi dukungan terkait masalah Google Workspace Migrate.

Memastikan node berjalan

1. Login ke platform Google Workspace Migrate dan klik Servers (Server) di pojok kanan atas.
2. Pastikan node Anda muncul dalam daftar.
3. Periksa apakah status node Ready (Siap - hijau).

Terjadi error saat mengaitkan node

Jika Anda mendapatkan error saat mencoba mengaitkan node dengan platform Google Workspace Migrate, periksa apakah node berjalan:

1. Masukkan alamat IP dan port node (misalnya, http://192.0.2.1:5131) di browser pada komputer yang menjalankan platform.
2. Jika platform dapat menjangkau node dan layanan node sedang berjalan, Anda akan mendapatkan pesan "Node is running" (Node berjalan).
3. 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.

Server node menampilkan status Unknown (Tidak diketahui)

Jika Anda mendapatkan pesan error ini: 

1. Buka log host layanan untuk server node.

   Untuk mengetahui detailnya, buka Memeriksa log host layanan.

2. Periksa error berikut: The provided platform host address https://platformserver:443/Hub (Alamat host platform yang disediakan, https://platformserver:443/Hub, tidak dapat dijangkau).
3. 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.

Error pemberian izin tidak valid atau migrasi berjalan sangat lambat

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 partisi

Saat menjalankan pemindaian atau jembatan, Anda dapat memantau status partisi.

1. Di platform Google Workspace Migrate, klik Scans (Pemindaian) atau Bridges (Jembatan).
2. Di pemindaian atau jembatan yang ingin Anda periksa, klik Log (Log) Partition log (Log partisi).
3. Pada 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. 

Memecahkan masalah partisi yang dibatalkan

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:

1. Buka log partisi.
2. Arahkan kursor ke baris dalam log, lalu klik More (Lainnya) Execution log (Log eksekusi).
3. Klik Status (Status)Failed (Gagal).
4. Tinjau kegagalan untuk mengisolasi dan memecahkan penyebab masalah tersebut.
5. Coba lagi pemindaian atau migrasi.

Mengatasi peningkatan jumlah kegagalan

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:

1. Pastikan API, terutama Admin SDK, diaktifkan dengan benar di konsol Google Admin. Untuk mengetahui detailnya, buka Menggunakan Google Cloud Console untuk mengaktifkan API.
2. Pastikan akun pengguna ada di akun sumber dan di Google Workspace. Pastikan akun tidak dibekukan, ditangguhkan, atau diganti namanya.
3. Pastikan layanan Google Workspace yang diperlukan (misalnya, Gmail atau Google Drive) telah diaktifkan untuk semua pengguna. Untuk mengetahui detailnya, buka Persyaratan Google Workspace.

Memperbaiki error "The domain policy has disabled third-party Drive apps (Kebijakan domain telah menonaktifkan aplikasi Drive pihak ketiga)"

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 delta

Anda 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.

Memecahkan error 60008

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 ke akun lainnya, dan telah membuat drive bersama secara manual di akun baru. Untuk memecahkan masalah: Pada pemetaan, aktifkan Map content only (Hanya petakan konten). Untuk mengetahui detailnya, buka Membuat & mengelola pemetaan. Jalankan jembatan delta.
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: Buka log transaksi, lalu untuk Error Code (Kode Error), telusuri 60008 untuk menemukan item yang terpengaruh. Untuk mengetahui detail tentang cara menemukan dan menggunakan log, buka Log transaksi. Untuk Source Link (Link Sumber) atau Source Location (Lokasi Sumber), perhatikan jalur ke item yang terpengaruh. Dengan menggunakan informasi jalur, temukan induk objek yang terpengaruh dan konfirmasi bahwa statusnya Failed (Gagal). Dengan menggunakan informasi Error Code (Kode Error) dan Log (Log) untuk objek induk, pecahkan masalah objek induk. Setelah Anda mengatasi masalah untuk objek induk, jalankan jembatan delta.
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.	Buka log transaksi, lalu untuk Error Code (Kode Error), telusuri 60008 untuk menemukan item yang terpengaruh. Untuk mengetahui detail tentang cara menemukan dan menggunakan log, buka Log transaksi. Untuk Source Link (Link Sumber) atau Source Location (Lokasi Sumber), perhatikan jalur ke item yang terpengaruh. Dengan menggunakan informasi jalur, temukan induk objek yang terpengaruh. Jika objek induk diubah atau dihapus, pilih salah satu opsi: Pulihkan nama asli dan lokasi parent entity. Perbarui pemetaan Anda untuk mencerminkan nama dan lokasi baru parent entity. Setelah Anda mengatasi masalahnya, jalankan jembatan delta.
Penyambungan pemetaan sumber ke target tidak didukung.	Tinjau pemetaan Anda untuk memastikan bahwa lokasi sumber dan target valid. Untuk mengetahui detailnya, buka Membuat & mengelola pemetaan untuk Exchange, SharePoint, berbagi file, Box, atau Google Workspace.
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	Buat pemetaan untuk konten usang. Misalnya, buka Memigrasikan item usang di Drive dari akun sumber. Pastikan semua pengguna ditentukan dalam pemetaan identitas. Untuk mengetahui detailnya, buka Membuat & mengelola pemetaan identitas. Perbarui jembatan menggunakan pemetaan dan pemetaan identitas baru, serta jalankan jembatan delta. 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.

Menggunakan detail transaksi untuk memperbaiki masalah

1. Di platform Google Workspace Migrate, klik Scans (Pemindaian) atau Bridges (Jembatan).
2. Di pemindaian atau jembatan yang ingin diperiksa, klik Logs (Log) Transaction log (Log transaksi).
3. Arahkan kursor ke transaksi, lalu klik More (Lainnya) Transaction details (Detail transaksi).
4. 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.

Memecahkan masalah transaksi yang dilewati

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.

Masih butuh bantuan?

Buka Menghubungi dukungan terkait 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.}