All Products
Search

This Product

    IoT Platform:Migrasi instans

    Document Center

    IoT Platform:Migrasi instans

    Last Updated:Jun 17, 2026

    Migrasikan data dari instans publik lama ke instans Edisi Perusahaan target dengan membuat tugas migrasi, melakukan migrasi bertahap, dan menjalankan migrasi penuh.

    Prasyarat

    Langkah 1: Buat tugas migrasi

    Buat tugas migrasi untuk produk tertentu di instans publik Anda. Status awal tugas tersebut adalah To be Migrated, yang menunjukkan bahwa migrasi belum dimulai dan tidak akan memengaruhi layanan Anda.

    1. Masuk ke IoT Platform console.

    2. Di pojok kiri atas Konsol, pilih wilayah tempat IoT Platform diaktifkan. Pada tab Instance Overview, klik Public Instance.

      Penting

      Fitur migrasi instans hanya mendukung migrasi data dari instans publik lama ke instans Enterprise Standard. Untuk informasi lebih lanjut tentang instans, lihat Ikhtisar instans.

    3. Di panel navigasi sebelah kiri, pilih Resource Allocation > Instance Migration. Pada tab Migration List, klik Create Migration Task.

    4. Di kotak dialog, pilih Target Instance ID dan Product dari instans publik yang akan dimigrasikan, lalu klik OK.

      Membuat tugas migrasi tidak langsung memulai proses migrasi. Sebelum melanjutkan, pastikan instans target memiliki kuota perangkat yang cukup untuk produk yang dipilih dan tinjau dokumentasi migrasi.

      Setelah tugas migrasi dibuat, statusnya menjadi To be Migrated, yang menunjukkan bahwa migrasi belum dimulai.

    5. Opsional: Lihat detail migrasi: Di halaman Migration Details, lihat informasi mengenai tugas migrasi.

    6. Opsional: Aktifkan sinkronisasi data: Sinkronisasi data untuk model TSL perangkat dinonaktifkan secara default. Anda dapat mengaktifkannya segera setelah membuat tugas migrasi untuk mencegah gangguan layanan selama migrasi.

      Catatan

      Jika bisnis Anda tidak memerlukan sinkronisasi data perangkat, Anda dapat melewati langkah ini.

    Langkah 2: Migrasi bertahap

    Lakukan migrasi bertahap terlebih dahulu dengan batch kecil perangkat. Pantau prosesnya untuk memastikan layanan Anda tidak terganggu sebelum memulai migrasi penuh.

    Penting

    • Kami menyarankan Anda membuat perangkat baru di bawah produk tersebut untuk migrasi bertahap.

    • Jika Anda telah mengonfigurasi subscription sisi server AMQP atau penerusan pesan ke AMQP, Anda harus menyalin ID kelompok konsumen yang diperbarui dan restart SDK client AMQP agar dapat menerima data setelah migrasi bertahap selesai.

    Mulai migrasi bertahap

    1. Pada tab Migration List, temukan tugas dengan status To be Migrated dan klik Start Migration di kolom Actions.

    2. Di kotak dialog Start Migration Task, pilih metode untuk menentukan perangkat yang akan dimigrasikan secara bertahap.

      Penting

      Jumlah perangkat yang akan dimigrasikan tidak boleh melebihi sisa kuota perangkat pada instans target. Jika melebihi, sistem akan menampilkan pesan error: The total number of devices in the target instance exceeds the maximum limit.

      Pemilihan manual

      Penting

      Anda dapat memilih hingga 100 perangkat per tugas migrasi bertahap menggunakan metode ini.

      1. Klik daftar drop-down perangkat canary, lalu di panel perangkat yang muncul di sebelah kanan, centang perangkat yang diinginkan.

      2. Klik OK.

      Unggah file

      Penting

      Anda dapat menambahkan hingga 10.000 perangkat per tugas migrasi bertahap menggunakan metode ini.

      1. Klik Download Template. Di file yang diunduh, masukkan nama perangkat di kolom DeviceNames, lalu simpan file tersebut.

      2. Klik Upload File untuk mengunggah file yang telah disimpan ke IoT Platform console.

    3. Pastikan Anda telah menyelesaikan semua operasi pra-migrasi, centang kotak yang sesuai, lalu klik Start Now.

      Tiga kotak centang tersebut adalah I have read the migration documentation, Server-side modifications are complete, dan I have verified the process with test devices.

    Canary release in progress

    Pada tab Migration List, status tugas migrasi berubah menjadi Canary release in progress.

    Pada tahap ini, Anda hanya dapat melihat detail migrasi. Klik View di kolom Actions untuk membuka halaman Migration Details dan melihat informasi tugas. Untuk informasi lebih lanjut, lihat Opsional: Lihat detail migrasi.

    Canary release completed

    Saat tugas migrasi memasuki status Canary Release Completed, perangkat yang ditentukan telah dimigrasikan. Anda dapat melanjutkan ke migrasi penuh atau melakukan rollback migrasi jika diperlukan. Untuk informasi lebih lanjut, lihat topik berikut:

    Langkah 3: Migrasi penuh

    Setelah migrasi bertahap selesai, mulai migrasi penuh untuk produk yang ditentukan.

    Penting

    Pastikan refactoring sistem telah selesai dan dipublikasikan. Misalnya, pemanggilan API cloud harus menyertakan ID instans Enterprise, dan ID kelompok konsumen di SDK client AMQP harus diperbarui. Untuk informasi lebih lanjut, lihat Persiapan sebelum migrasi.

    Mulai migrasi penuh

    1. Pada tab Migration List, temukan tugas dengan status Canary Release Completed dan klik Start Migration di kolom Actions.

    2. Di kotak dialog Start Migration Task, klik Full Migration. Pastikan Anda telah menyelesaikan semua operasi pra-migrasi, centang kotak yang sesuai, lalu klik Start Now.

      Penting

      Jumlah perangkat yang akan dimigrasikan tidak boleh melebihi sisa kuota perangkat pada instans target. Jika melebihi, sistem akan menampilkan pesan error: The total number of devices in the target instance exceeds the maximum limit.

      Tiga kotak centang tersebut adalah I have read the migration documentation, Server-side modifications are complete, dan I have verified the process with test devices.

    Migrating

    Pada tab Migration List, status tugas migrasi berubah menjadi Migrating.

    Pada tahap ini, Anda dapat melihat detail, menjeda tugas, atau melakukan rollback:

    Migration completed

    Saat status tugas migrasi berubah menjadi Migration Completed, produk yang ditentukan beserta perangkatnya telah dimigrasikan dari instans publik. Jika migrasi data yang dilaporkan perangkat juga telah selesai, Anda dapat menonaktifkan sinkronisasi data secara manual. Untuk detailnya, lihat Opsional: Nonaktifkan sinkronisasi data.

    Opsional: Rollback tugas migrasi

    Penting

    • Anda tidak dapat melakukan rollback tugas yang berstatus Canary release in progress.

    • Sebelum memulai rollback, pastikan produk yang bersangkutan belum dihapus dari instans publik. Jika produk telah dihapus, rollback akan gagal.

    • Rollback tidak menghapus data subscription sisi server dan mesin aturan yang telah dimigrasikan dari instans Edisi Perusahaan target.

    Mulai rollback

    Berdasarkan kebutuhan bisnis Anda, Anda dapat melakukan rollback tugas migrasi yang berstatus Canary Release Completed, Migrating, Pause Migration, Continue Migration, atau Migration Completed:

    1. Pada tab Migration List, klik Rollback di kolom Actions untuk tugas migrasi tersebut.

    2. Di kotak dialog Start Rollback Task, pilih jenis rollback untuk mengembalikan migrasi perangkat.

      Perangkat tertentu

      Pilih salah satu metode berikut untuk memilih perangkat yang akan di-rollback, lalu klik Start Now.

      Penting

      Anda dapat memilih hingga 10.000 perangkat per tugas rollback menggunakan metode ini.

      Pemilihan manual

      1. Klik daftar drop-down perangkat rollback, lalu di panel perangkat yang muncul di sebelah kanan, centang perangkat yang diinginkan.

      2. Klik OK.

      Di kotak dialog Start Rollback Task, atur Rollback Type ke Specific Devices dan Device Selection Method ke Manual Selection. Setelah memilih perangkat, klik Start Now.

      Unggah file

      1. Klik Download Template. Di file yang diunduh, masukkan nama perangkat di kolom DeviceNames, lalu simpan file tersebut.

      2. Klik Upload File untuk mengunggah file yang telah disimpan ke IoT Platform console.

      Di kotak dialog Start Rollback Task, atur Rollback Type ke Specific Devices dan Device Selection Method ke Upload File, lalu klik Start Now.

    Rolling back

    • Untuk tugas yang berstatus Canary Release Completed, Migrating, Pause Migration, atau Continue Migration, memulai rollback akan mengubah statusnya menjadi Rolling Back. Anda dapat menjeda tugas dalam status ini. Untuk informasi lebih lanjut, lihat Opsional: Jeda tugas migrasi.

    • Untuk tugas yang berstatus Migration Completed, memulai rollback akan mengubah statusnya menjadi Batch Rollback. Anda tidak dapat menjeda tugas dalam status ini.

    Rollback completed

    Setelah rollback selesai, semua data perangkat yang dimigrasikan untuk tugas tersebut menjadi tidak valid dan status tugas migrasi kembali ke To be Migrated.

    Penting

    Setelah rollback berhasil, jika Anda perlu memigrasikan data produk tersebut lagi:

    Opsional: Jeda tugas migrasi

    Anda dapat menjeda tugas migrasi yang berstatus Migrating atau Rolling Back. Pada tab Migration List, klik Pause di kolom Actions tugas migrasi, lalu klik Confirm.

    Hasil operasi ini bergantung pada status tugas sebelumnya:

    Status sebelumnya

    Hasil

    Migrating

    Status tugas berubah menjadi Pause Migration, dan data untuk produk tersebut berhenti dimigrasikan ke instans target.

    Anda dapat mengklik Continue Migration untuk melanjutkan tugas migrasi penuh.

    Rolling Back

    Status tugas berubah menjadi Pause Rollback.

    Anda dapat mengklik Continue Rollback untuk menyelesaikan rollback tugas migrasi.

    Klik Start Now.

    Di kotak dialog Start Rollback Task, atur Rollback Type ke Specific Devices atau All Devices. Rollback penuh akan mengembalikan semua perangkat yang dimigrasikan dalam tugas tersebut ke instans publik.

    Opsional: Lihat detail migrasi

    1. Pada tab Migration List, klik View di kolom Actions untuk tugas migrasi tersebut.

    2. Di halaman Migration Details, lihat informasi tugas, termasuk ProductKey, status migrasi, jumlah total perangkat, ID instans target, waktu pembuatan, waktu mulai sinkronisasi data, dan daftar perangkat yang dipilih untuk migrasi.

      Anda dapat memfilter perangkat berdasarkan status migrasi (Not Migrated, Migrated, atau Migration Failed) atau mencari perangkat tertentu untuk memeriksa progres migrasinya.

      Jika migrasi perangkat gagal, .

      Bagian atas halaman Migration Details menampilkan status tugas sebagai Canary release in progress.

    3. Opsional: Kembali ke halaman Instance Migration dan klik Migration Monitoring untuk melihat statistik real-time metrik data migrasi. Untuk informasi lebih lanjut, lihat Lihat metrik data migrasi.

      Metrik pemantauan migrasi mencakup Online Device Count dan Message Volume Sent to Platform. Anda dapat menggunakan daftar drop-down Time untuk memfilter statistik berdasarkan rentang waktu.

    Opsional: Aktifkan sinkronisasi data

    Sinkronisasi data untuk model TSL perangkat dinonaktifkan secara default. Anda dapat mengaktifkannya setelah membuat tugas migrasi untuk mencegah gangguan layanan selama migrasi.

    1. Pada tab Migration List, klik View di kolom Actions untuk tugas migrasi tersebut.

    2. Di pojok kanan atas halaman Migration Details, klik Enable Data Synchronization.

      Pada titik ini, halaman menampilkan "-" untuk Data Migration Status dan Data Synchronization Start Time, yang menunjukkan bahwa sinkronisasi data belum diaktifkan.

      Setelah sinkronisasi data diaktifkan, data yang dilaporkan oleh perangkat produk tertentu di instans publik akan disinkronkan ke instans Edisi Perusahaan target. Sinkronisasi dimulai dalam waktu satu menit setelah Anda mengaktifkannya.

      Di halaman Migration Details, Anda dapat melihat Data Synchronization Start Time dan Data Migration Status yang spesifik.

    Opsional: Nonaktifkan sinkronisasi data

    Sistem secara otomatis menonaktifkan sinkronisasi data 30 hari setelah diaktifkan. Anda juga dapat menonaktifkannya secara manual:

    Catatan

    Sebelum menonaktifkan sinkronisasi data, pastikan migrasi instans telah selesai untuk menghindari gangguan layanan.

    1. Pada tab Migration List, klik View di kolom Actions untuk tugas migrasi tersebut.

    2. Di pojok kanan atas halaman Migration Details, klik Disable Data Synchronization.

      Penting

      Setelah Anda menonaktifkan sinkronisasi data secara manual, Anda tidak dapat mengaktifkannya kembali jika tugas migrasi telah selesai. Jika tugas belum selesai, Anda dapat mengaktifkan kembali sinkronisasi data.

    Hasil

    Saat status tugas berubah menjadi Migration Completed, data produk telah dimigrasikan ke instans target.