IoT Platform:Prasyarat

Batasan

Sebelum memulai

Sebelum melakukan migrasi, tinjau informasi berikut untuk menilai dampak terhadap bisnis.

• Data yang akan dimigrasikan:

  Saat Anda memigrasikan instans publik, Platform IoT secara otomatis menyinkronkan dan memigrasikan Produk, Perangkat, dan data penerusan pesan. Tabel berikut menjelaskan data yang dimigrasikan.

  Item data	Data yang dimigrasikan	Catatan
  Produk	Informasi Produk: ProductKey, nama, tipe node, kategori, dan lainnya. Definisi fitur: Properti, layanan, event, dan model Thing Specification Language (TSL) ekstensi, termasuk data model TSL draft. Skrip: Skrip penguraian data, termasuk data skrip draft.	Migrasi mendukung Produk dan Perangkat yang menggunakan sertifikat per-perangkat atau per-Produk untuk autentikasi pra-pendaftaran. Untuk sub-perangkat gateway, hubungan topologi tetap tidak berubah selama migrasi. Setelah migrasi, mereka dapat terhubung ke Platform IoT seperti biasa. Oleh karena itu, jika Anda memigrasikan perangkat gateway atau sub-perangkatnya, Anda harus memigrasikannya bersama ke instans Perusahaan yang sama. Produk dan Perangkat yang telah diberi otorisasi tidak dapat dimigrasikan. Fitur otorisasi untuk Produk dan Perangkat tidak didukung di instans Perusahaan. Produk dan Perangkat yang menggunakan Studio Layanan Data tidak dapat dimigrasikan. Produk dan Perangkat yang mengaktifkan layanan video tidak dapat dimigrasikan. Produk dan Perangkat yang terhubung ke IoT Edge atau Link WAN tidak dapat dimigrasikan. Setelah migrasi, tipe validasi model TSL untuk Produk tetap tidak berubah. Setelah migrasi, data asli tetap disimpan di instans publik lama. Untuk mencegah operasi yang tidak disengaja, hapus data ini secara manual setelah migrasi instans selesai dan Anda memastikan layanan berjalan normal.
  Perangkat	Informasi Perangkat: Informasi sertifikat perangkat. Sertifikat perangkat dijamin unik secara global. Data Perangkat: Data properti, event, dan layanan model TSL.	Penting Perangkat yang didistribusikan di bawah instans tidak dapat dimigrasikan. Perangkat yang akan dimigrasikan harus memiliki fitur reconnect. Anda harus menyelesaikan pengembangan SDK sisi perangkat dan menghubungkan perangkat ke Platform IoT agar komunikasi berjalan normal. Catatan Jika Anda menggunakan Link SDK yang disediakan oleh Platform IoT untuk mengembangkan perangkat, sisi perangkat secara otomatis terhubung ke instans Perusahaan. Anda tidak perlu mengubah nama domain koneksi perangkat. Untuk informasi lebih lanjut tentang Link SDK, lihat Koneksi perangkat. Jika Anda tidak menggunakan SDK sisi perangkat yang disediakan oleh Platform IoT, Anda harus mengubah nama domain koneksi perangkat dan mengembangkan logika reconnect sendiri untuk perangkat tersebut. Selama migrasi, jika perangkat sedang online, perangkat tersebut akan dipaksa offline. Setelah migrasi, perangkat yang dimigrasikan secara otomatis dihapus dari instans publik lama. Anda tidak perlu memodifikasi SDK sisi perangkat. Perangkat dapat berhasil terhubung ke instans Perusahaan tujuan dan berkomunikasi secara normal. Hanya pengguna dalam daftar putih yang dapat memigrasikan perangkat yang menggunakan autentikasi berbasis ID². Anda dapat submit a ticket untuk meminta izin daftar putih. Untuk informasi lebih lanjut tentang autentikasi berbasis ID², lihat Perangkat terotentikasi ID². Petunjuk migrasi data model TSL: Secara default, sinkronisasi data dinonaktifkan. Setelah membuat tugas migrasi, Anda dapat mengaktifkan sinkronisasi data secara manual untuk memastikan layanan Anda tidak terganggu selama migrasi instans. Setelah Anda mengaktifkan sinkronisasi data, data yang dilaporkan oleh perangkat di bawah Produk yang akan dimigrasikan di instans publik akan disinkronkan ke instans Perusahaan tujuan. Sinkronisasi dimulai dengan penundaan maksimum 1 menit. Mulai hari Anda mengaktifkan sinkronisasi data, data dapat disinkronkan hingga 30 hari. Anda dapat menonaktifkan dan mengaktifkan kembali fitur sinkronisasi data perangkat secara manual. Jika Anda tidak menonaktifkannya secara manual, sistem akan secara otomatis menonaktifkan sinkronisasi data setelah 30 hari. Sebelum sinkronisasi data dinonaktifkan, pastikan migrasi instans telah selesai untuk menghindari gangguan pada layanan terkait. Sinkronisasi data bersifat satu arah. Hanya mendukung sinkronisasi data yang dilaporkan oleh perangkat di bawah Produk yang akan dimigrasikan dari instans publik ke instans Perusahaan. Saat sinkronisasi data diaktifkan, jika perangkat dikembalikan (rollback) dari instans Perusahaan ke instans publik, data perangkat yang dimigrasikan tidak dikembalikan. Ketika perangkat dimigrasikan kembali ke instans Perusahaan, data di instans Perusahaan lengkap, tetapi data di instans publik akan tidak lengkap.
  Penerusan pesan	Langganan sisi server: Konfigurasi langganan sisi server AMQP dan MNS serta hubungan langganan. Penerusan data: Aturan pengalihan, termasuk pengaturan SQL, sumber data, tujuan data seperti RocketMQ, TSDB, RDS, dan FC, serta skrip penguraian. Kelompok konsumen: Informasi kelompok konsumen. Setelah migrasi, ID kelompok konsumen baru dibuat.	Setelah migrasi, data asli tetap disimpan di instans publik lama. Untuk mencegah operasi yang tidak disengaja, hapus data ini secara manual setelah migrasi instans selesai dan Anda memastikan layanan berjalan normal. Jika Anda telah mengonfigurasi langganan sisi server AMQP atau penerusan pesan ke AMQP, Anda harus menjalankan dua client AMQP. Hal ini memastikan bahwa baik instans publik maupun instans Perusahaan memiliki client AMQP untuk menerima data, sehingga mencegah kehilangan data. Instans Perusahaan tidak mendukung langganan sisi server melalui HTTP/2. Ubah metode langganan sisi server dari HTTP/2 di instans publik asli menjadi AMQP.

• Penggunaan fitur:

  Setelah perangkat dimigrasikan ke instans Perusahaan tujuan, Anda dapat terus menggunakan konfigurasi yang dimigrasikan. Untuk menggunakan fitur tambahan, Anda dapat mengonfigurasinya ulang di instans Perusahaan. Untuk informasi lebih lanjut tentang penggunaan fitur, lihat Penggunaan fitur setelah migrasi.

• Penagihan:

  Untuk perangkat yang dimigrasikan ke instans Perusahaan, Anda tidak lagi ditagih untuk komunikasi pesan, durasi koneksi, atau pembaruan over-the-air (OTA).

Persiapan sebelum migrasi

Nilai dampak terhadap bisnis dan modifikasi sistem bisnis Anda sebelum memigrasikan instans untuk memastikan perangkat berkomunikasi secara normal setelah migrasi.

Alur migrasi keseluruhan

Alur migrasi instans terdiri dari empat bagian berikut.

Prosedur migrasi

1. Langkah 1: Buat tugas migrasi. Tambahkan tugas migrasi untuk Produk tertentu.

   Penting

   Untuk memastikan layanan Anda tidak terganggu selama migrasi instans, Anda dapat mengaktifkan sinkronisasi data secara manual setelah membuat tugas migrasi. Tindakan ini memigrasikan data yang dilaporkan oleh perangkat di bawah Produk yang akan dimigrasikan dari instans publik ke instans Perusahaan tujuan. Untuk informasi lebih lanjut, lihat Aktifkan sinkronisasi data.

2. Langkah 2: Lakukan migrasi grayscale. Salin data Produk dan penerusan pesan secara berurutan, lalu migrasikan data untuk perangkat grayscale tertentu.

   Peringatan

   Jika Anda telah mengonfigurasi langganan sisi server AMQP atau penerusan pesan ke AMQP, Anda harus menyalin dan memperbarui ID kelompok konsumen serta menjalankan SDK client AMQP baru untuk menerima data setelah migrasi grayscale selesai.

   Amati tugas tersebut dan pastikan migrasi tidak memengaruhi layanan Anda sebelum melakukan migrasi penuh.

3. Langkah 3: Lakukan migrasi penuh. Kueri semua data di bawah Produk tertentu dan migrasikan semua data perangkat.

   Peringatan

   Pastikan refaktor sistem telah selesai dan dipublikasikan. Misalnya, pemanggilan Cloud API harus mencakup ID instans Perusahaan, dan ID kelompok konsumen di SDK client AMQP harus diperbarui. Untuk informasi lebih lanjut, lihat Persiapan sebelum migrasi.

   Setelah migrasi penuh berhasil, periksa status dan hasil layanan yang berjalan untuk memastikan pemanggilan Cloud API telah dialihkan ke instans Perusahaan tujuan.

4. Opsional: Kembalikan tugas migrasi. Jika migrasi gagal atau terjadi masalah, Anda dapat mengembalikan semua data perangkat yang dimigrasikan, seperti informasi sertifikat perangkat dan data model Thing Specification Language (TSL), ke instans publik untuk memulihkan operasi normal. Operasi ini tidak menghapus data langganan sisi server atau penerusan pesan yang dimigrasikan dari instans Perusahaan tujuan.

Referensi

• Praktik terbaik migrasi instans

• FAQ migrasi instans

FAQ

Sebelum migrasi

• Apa yang perlu saya ketahui saat memigrasikan instans publik lama ke instans Perusahaan?

• Apakah memigrasikan instans publik lama ke instans Perusahaan mengonsumsi spesifikasi resource instans Perusahaan?

• Dapatkah saya memigrasikan instans publik lama Platform IoT dari satu akun ke instans Perusahaan di akun lain?

• Dapatkah saya memigrasikan instans Perusahaan Platform IoT? Jika ya, bagaimana caranya?

• Saat memigrasikan instans publik Platform IoT ke instans Perusahaan, apakah paket pembaruan OTA juga ikut dimigrasikan?

• Dapatkah Produk dan Perangkat yang telah diberi otorisasi di instans publik lama dimigrasikan ke instans Perusahaan?

• Dapatkah instans publik lama dimigrasikan ke semua jenis instans Perusahaan?

• Apakah migrasi instans publik lama mendukung migrasi cross-region atau cross-account ke instans Perusahaan?

Saat migrasi

• Apa arti migrasi grayscale dalam konteks migrasi instans?

• Saat memigrasikan instans publik lama ke instans Perusahaan, apakah saya perlu membuat Produk dan Perangkat serta mengonfigurasi penerusan pesan di instans Perusahaan terlebih dahulu?

• Apakah memigrasikan instans publik lama memengaruhi perangkat yang terhubung?

Setelah migrasi

• Setelah migrasi grayscale instans publik lama, halaman detail migrasi tidak menampilkan perangkat atau informasi migrasi apa pun

• Apakah saya perlu memperbarui nama domain koneksi setelah memigrasikan instans publik lama?

• Setelah instans publik lama berhasil dimigrasikan, apakah pemanggilan Cloud API sisi server perlu mencakup ID instans Perusahaan?