IoT Platform：Memulai pembaruan batch

Prosedur

1. Masuk ke Konsol IoT Platform.

2. Di halaman Overview, klik All environment. Pada tab Semua Lingkungan, temukan instance yang ingin Anda kelola dan klik ID atau nama instance tersebut.

3. Di panel navigasi sisi kiri, pilih Maintenance > OTA Update
   Catatan Untuk memberikan layanan yang lebih baik, IoT Platform meningkatkan fitur pembaruan OTA dan menambahkan statistik pada versi paket pembaruan. Saat menggunakan fitur pembaruan OTA baru di konsol untuk pertama kalinya, Anda harus mengaitkan paket pembaruan yang diunggah dengan produk. Anda hanya dapat mengaitkan paket pembaruan dengan satu produk. Untuk informasi lebih lanjut tentang cara mengaitkan paket pembaruan dengan produk, lihat petunjuk di konsol.
4. Di tab Paket Pembaruan, temukan paket pembaruan yang ingin Anda kelola dan klik Batch Update di kolom Tindakan. Di langkah Konfigurasi Ruang Lingkup Pembaruan, konfigurasikan parameter dan klik Next. Tabel berikut menjelaskan parameter tersebut.
   

   Parameter	Deskripsi
   Metode Pembaruan	Jenis pembaruan. Parameter ini opsional. Nilai valid: Pembaruan Statis: memperbarui hanya perangkat yang ada yang memenuhi kondisi tertentu. Pembaruan Dinamis: terus-menerus memperbarui perangkat yang memenuhi kondisi tertentu. Pembaruan dinamis dapat dilakukan dalam skenario berikut: Perangkat yang diaktifkan setelah pembaruan dinamis dilakukan memenuhi kondisi tertentu. Versi modul OTA saat ini yang dilaporkan oleh perangkat tidak memenuhi kondisi tertentu. Namun, perangkat terus melaporkan versi modul OTA yang memenuhi kondisi tertentu. Catatan Anda hanya dapat menggunakan paket pembaruan untuk membuat satu batch pembaruan dinamis. Jika Anda telah membuat batch pembaruan dinamis menggunakan paket pembaruan, Anda harus membatalkan batch pembaruan dinamis ini sebelum membuat yang lainnya. Perangkat dapat diperbarui maksimal 10 kali dalam batch pembaruan dinamis berbasis versi. Jika perangkat telah diperbarui 10 kali, tidak ada pembaruan yang dapat dimulai pada perangkat meskipun kondisi yang diperlukan untuk pembaruan dinamis dipenuhi kemudian.
   Rentang Peningkatan	Lingkup pembaruan. Parameter ini opsional. Nilai valid: Semua Perangkat: memperbarui semua perangkat yang memenuhi kondisi pembaruan tertentu di produk tertentu. Perangkat Terpilih: hanya memperbarui perangkat tertentu. Jika Anda memilih Perangkat Terpilih, Anda dapat menggunakan salah satu metode berikut untuk memilih perangkat yang diperlukan: Select: Pilih perangkat yang ingin Anda perbarui dari daftar drop-down Rentang Perangkat. Jika Anda menggunakan instance Enterprise Edition di wilayah Jepang (Tokyo), Anda dapat menggunakan fitur Pencarian Lanjutan untuk mencari perangkat. Anda juga dapat mengunduh file CSV yang berisi nama perangkat yang cocok. Upload File: Unduh file template dalam format .csv, masukkan nama perangkat yang diperlukan di file template, lalu unggah file template. Setiap file template dapat berisi maksimal 1.000.000 catatan. Jika file template berisi satu atau lebih nama perangkat yang tidak valid, kesalahan akan terjadi. Klik Download Invalid Device Name List untuk mengunduh file yang berisi nama perangkat tidak valid. Kemudian, modifikasi dan unggah ulang file template. Pembaruan Bertahap: memperbarui perangkat tertentu. Opsi ini hanya ditampilkan jika Anda mengatur parameter Metode Pembaruan ke Pembaruan Statis. Anda harus menentukan setidaknya satu perangkat untuk pembaruan bertahap. Jika Anda memilih Pembaruan Bertahap, bidang Tingkat Adopsi Pembaruan (%) muncul. Anda harus menentukan persentase untuk perangkat tertentu di bidang tersebut. IoT Platform menghitung jumlah perangkat yang dapat diperbarui berdasarkan persentase yang ditentukan. Hasil perhitungan dibulatkan ke bawah. Pembaruan Grup: memperbarui grup perangkat tertentu. Opsi ini hanya ditampilkan jika Anda mengatur parameter Update Method ke Static Update. Daftar drop-down Grup menampilkan semua grup induk dan subgrup mereka di instance saat ini. Untuk informasi lebih lanjut tentang cara membuat grup perangkat, lihat Grup Perangkat.
   Nomor versi yang akan ditingkatkan	Sebelum mengonfigurasi parameter ini, perhatikan item berikut: Jika Anda melakukan pembaruan statis penuh, parameter ini opsional. Jika Anda melakukan pembaruan dinamis penuh, parameter ini wajib. Jika Anda mengatur parameter Rentang Peningkatan ke Selected Devices, parameter ini tidak ditampilkan. Daftar drop-down Nomor Versi yang Akan Ditingkatkan menampilkan versi modul OTA dari semua perangkat di produk saat ini, kecuali versi yang akan diperbarui. Anda dapat memilih satu atau lebih versi. Jika Anda tidak mengonfigurasi parameter ini, tidak ada batasan yang ditentukan untuk nomor versi modul OTA dari perangkat yang akan diperbarui. Jika Anda melakukan pembaruan diferensial, nilai parameter ini adalah nomor versi yang Anda tentukan saat menambahkan paket pembaruan. Jika Anda mengatur parameter Update Method ke Dynamic Update saat membuat batch pembaruan dan batch pembaruan dalam keadaan updating, Anda dapat mengubah nilai parameter ini.

5. Di langkah Konfigurasi Kebijakan Pembaruan, konfigurasikan parameter dan klik Complete. Kemudian, IoT Platform mendorong notifikasi pembaruan ke perangkat. Tabel berikut menjelaskan parameter tersebut.
   

   Parameter	Deskripsi
   Waktu Peningkatan	Waktu Anda ingin melakukan pembaruan OTA. Nilai valid: Pembaruan: segera melakukan pembaruan OTA. Pembaruan Terjadwal: melakukan pembaruan OTA dalam rentang waktu tertentu. Anda dapat menentukan waktu mulai dan waktu akhir untuk pembaruan OTA. Waktu mulai harus 5 menit hingga 7 hari setelah waktu saat ini. Waktu akhir harus 1 jam hingga 30 hari setelah waktu mulai. Waktu akhir bersifat opsional. Jika Anda tidak menentukan waktu akhir, pembaruan tidak dihentikan secara paksa. Catatan Pembaruan terjadwal didukung hanya jika Anda mengatur parameter Metode Pembaruan ke Static Update.
   Apakah IoT Platform Secara Aktif Mendorong Tugas Pembaruan	Menentukan apakah IoT Platform secara otomatis mendorong tugas pembaruan ke perangkat. Yes: Setelah batch pembaruan dibuat, IoT Platform secara otomatis mendorong tugas pembaruan ke perangkat online yang ditentukan. Ini adalah nilai default. Dalam hal ini, perangkat masih dapat memulai permintaan untuk mendapatkan informasi tentang tugas pembaruan OTA dari IoT Platform. No: Perangkat memulai permintaan untuk mendapatkan informasi tentang tugas pembaruan OTA dari IoT Platform.
   Tingkat Dorongan Paket Pembaruan	Jumlah perangkat ke mana Anda ingin mendorong URL unduhan paket pembaruan per menit. Nilai valid: Constant Rate dan Variable Rate. Penting Parameter ini tidak ditampilkan jika Anda mengatur parameter Whether IoT Platform Actively Pushes Update Task ke No. Opsi Variable Rate hanya tersedia untuk instance Enterprise Edition. Daftar berikut menjelaskan parameter: Jika Anda menentukan Constant Rate, Anda harus mengonfigurasi parameter Update at Constant Rate. Nilai valid: 10 hingga 10.000. Nilainya harus bilangan bulat. Unit: perangkat per menit. Setelah Anda menentukan nilai untuk parameter Pembaruan pada Tingkat Tetap, tingkat dorongan tetap tidak berubah. Sebagai contoh, jika Anda ingin memperbaiki kerentanan risiko tinggi, Anda harus mendorong paket pembaruan ke semua perangkat untuk melakukan pembaruan. Dalam hal ini, kami sarankan Anda mengatur parameter Tingkat Dorongan Paket Pembaruan ke Tingkat Tetap. Anda dapat mengatur tingkat dorongan tetap maksimum hingga 10.000 perangkat per menit. Dengan cara ini, Anda dapat mendorong paket pembaruan ke perangkat yang ingin Anda perbarui sesegera mungkin. Variable Rate: Dalam beberapa kasus, Anda mungkin perlu mendorong paket pembaruan pada tingkat rendah terlebih dahulu (seperti satu perangkat per menit), lalu terus meningkatkan tingkat dorongan berdasarkan kondisi tertentu. Anda dapat mengatur parameter Tingkat Dorongan Paket Pembaruan ke Variable Rate. Sebagai contoh, Anda ingin mendorong paket pembaruan ke semua perangkat pada tingkat rendah saat fitur baru ditambahkan. Dengan cara ini, Anda dapat melakukan pembaruan terlebih dahulu pada sebagian kecil perangkat di awal proses pembaruan. Kemudian, Anda dapat memeriksa apakah perangkat yang diperbarui berjalan seperti yang diharapkan dan menentukan apakah akan meningkatkan tingkat dorongan berdasarkan hasil pemeriksaan. Proses ini mirip dengan proses melakukan pembaruan bertahap sebelum pembaruan penuh untuk memastikan pembaruan sukses semua perangkat. Jika Anda menentukan Tingkat Variabel, Anda harus mengonfigurasi parameter berikut: Basic Push Rate: menentukan jumlah perangkat ke mana Anda ingin mendorong paket pembaruan per menit jika jumlah perangkat ke mana paket pembaruan didorong atau jumlah perangkat yang diperbarui tidak mencapai nilai parameter Perangkat Didorong atau Perangkat Diperbarui di bagian Increase Push Rate. Nilai valid: 1 hingga 10.000. Nilainya harus bilangan bulat yang kurang dari atau sama dengan nilai parameter Maximum Push Rate. Incremental Factor: menentukan faktor penambahan berdasarkan mana sistem meningkatkan tingkat dorongan. Parameter ini berlaku jika jumlah perangkat ke mana paket pembaruan didorong atau jumlah perangkat yang diperbarui mencapai nilai parameter Perangkat Didorong atau Perangkat Diperbarui di bagian Increase Push Rate. Nilai valid: 1,20 hingga 5,00. Nilai dibulatkan menjadi dua tempat desimal. Maximum Push Rate: menentukan jumlah maksimum perangkat ke mana Anda ingin mendorong paket pembaruan per menit. Nilai valid: 10 hingga 10.000. Nilainya harus bilangan bulat. Jika tingkat dorongan sistem mencapai tingkat dorongan maksimum, sistem mendorong paket pembaruan pada tingkat dorongan maksimum dan tidak lagi mengubah tingkat dorongan. Increase Push Rate: menentukan nilai ambang untuk parameter Pushed Devices atau Updated Devices. Nilai valid: 1 hingga 100.000. Nilainya harus bilangan bulat. Jika jumlah perangkat ke mana paket pembaruan didorong atau jumlah perangkat yang diperbarui mencapai nilai ambang, sistem meningkatkan tingkat dorongan berdasarkan nilai parameter Incremental Factor. Contoh: Anda melakukan pembaruan OTA dengan mengonfigurasi pengaturan berikut: Atur parameter Tingkat Dorongan Paket Pembaruan ke Tingkat Variabel, atur parameter Basic Push Rate ke 50, atur parameter Incremental Factor ke 2, atur parameter Maximum Push Rate ke 10.000, lalu atur parameter Pushed Devices ke 1.000 di bagian Increase Push Rate. Proses berikut menjelaskan cara pembaruan OTA dilakukan: Tugas pembaruan OTA dibuat untuk mendorong paket pembaruan ke 1.000 perangkat pada tingkat 50 perangkat per menit di awal proses. Kemudian, tingkat dorongan meningkat berdasarkan faktor penambahan. Proses berikut menjelaskan cara sistem meningkatkan tingkat dorongan: Tugas pembaruan OTA mendorong paket pembaruan ke 1.000 perangkat pada tingkat 50 perangkat per menit. Kemudian, sistem meningkatkan tingkat dorongan ke 100 perangkat per menit berdasarkan nilai parameter Incremental Factor. Tugas pembaruan OTA mendorong paket pembaruan ke 1.000 perangkat lainnya pada tingkat 100 perangkat per menit. Total 2.000 perangkat telah menerima paket pembaruan. Kemudian, sistem meningkatkan tingkat dorongan ke 200 perangkat per menit. Tugas pembaruan OTA mendorong paket pembaruan ke 1.000 perangkat lainnya pada tingkat 200 perangkat per menit. Total 3.000 perangkat telah menerima paket pembaruan. Kemudian, sistem meningkatkan tingkat dorongan ke 400 perangkat per menit. Tugas pembaruan OTA mendorong paket pembaruan ke 1.000 perangkat lainnya pada tingkat 400 perangkat per menit. Total 4.000 perangkat telah menerima paket pembaruan. Kemudian, sistem meningkatkan tingkat dorongan ke 800 perangkat per menit. Dengan cara ini, tugas pembaruan OTA mendorong paket pembaruan pada tingkat 800 perangkat per menit, 1.600 perangkat per menit, 3.200 perangkat per menit, lalu 6.400 perangkat per menit hingga total 8.000 perangkat menerima paket pembaruan dan tingkat dorongan meningkat menjadi 12.800 perangkat per menit berdasarkan nilai parameter Incremental Factor. Nilai 12.800 melebihi nilai ambang 10.000 yang Anda tentukan untuk parameter Maximum Push Rate. Oleh karena itu, tugas pembaruan OTA mendorong paket pembaruan pada tingkat dorongan maksimum 10.000 perangkat per menit dan tidak lagi mengubah tingkat dorongan. Jika batch pembaruan yang Anda buat dalam keadaan updating, Anda dapat mengubah tingkat dorongan yang Anda tentukan untuk mendorong paket pembaruan. Namun, Anda tidak dapat mengubah jenis dorongan dari Constant Rate ke Variable Rate atau sebaliknya. Untuk informasi lebih lanjut, lihat Kelola batch pembaruan.
   Interval Ulangi Gagal Peningkatan	Interval antara kegagalan pembaruan dan percobaan ulang setelah kegagalan. Nilai valid: Jangan Coba Lagi Coba Sekarang Coba dalam 10 Menit Coba dalam 30 Menit Coba dalam 1 Jam Coba dalam 24 Jam Penting Nilai parameter Upgrade failed retry interval harus kurang dari nilai parameter Device upgrade time-out (minutes). Contoh: Jika Anda mengatur periode timeout ke 60 menit, interval percobaan ulang maksimum yang dapat Anda tentukan adalah 30 menit. Jika Anda mengatur periode timeout ke 1.440 menit, interval percobaan ulang maksimum yang dapat Anda tentukan adalah 1 jam. Jika Anda ingin mengatur parameter Upgrade failed retry interval ke Retry in 24 Hours, kami sarankan Anda tidak mengonfigurasi parameter Device upgrade time-out (minutes). Jika pembaruan timeout, tidak ada percobaan ulang yang dilakukan.
   Maks. Jumlah Percobaan Ulangi	Jumlah maksimum percobaan ulang yang dapat dilakukan jika pembaruan gagal. Nilai valid: 1 2 5
   Waktu Batas Peningkatan Perangkat (menit)	Periode timeout pembaruan untuk perangkat tunggal. Jika perangkat yang ditentukan belum diperbarui dalam periode ini, pembaruan timeout. Nilai valid: 1 hingga 1.440. Unit: menit. Catatan Periode pembaruan dimulai dari pertama kali perangkat yang ditentukan melaporkan kemajuan pembaruan. Selama pembaruan, paket pembaruan mungkin didorong berulang kali ke perangkat yang ditentukan karena perangkat tersebut online dan offline berkali-kali. Waktu mulai periode pembaruan tetap tidak berubah. Jika Anda mengatur parameter Update Method ke Dynamic Update saat membuat batch pembaruan dan batch pembaruan dalam keadaan updating, Anda dapat mengubah nilai parameter ini. Untuk informasi lebih lanjut, lihat Kelola batch pembaruan.
   Perangkat mendukung pembaruan simultan pada beberapa modul	Menentukan apakah perangkat mendukung pembaruan simultan pada beberapa modul. Parameter ini hanya ditampilkan untuk instance Enterprise Edition atau instance publik versi baru. Nilai valid: Yes: Perangkat mendukung pembaruan simultan pada beberapa modul. Dalam hal ini, IoT Platform menggunakan tugas pembaruan saat ini untuk menimpa tugas pembaruan sebelumnya untuk modul yang sama dan tidak menimpa tugas pembaruan yang sedang berlangsung. Penting Hanya perangkat yang menggunakan Link SDK V4.x untuk C yang mendukung pembaruan simultan pada beberapa modul. Untuk informasi lebih lanjut, lihat Ikhtisar. Anda dapat mengatur parameter The device supports simultaneous updates of multiple modules atau Override Previous Device Update Tasks ke Yes. Pengaturan parameter The device supports simultaneous updates of multiple modules dan Override Previous Device Update Tasks dari batch pembaruan dinamis baru untuk grup perangkat harus sama dengan pengaturan batch pembaruan dinamis yang ada untuk grup perangkat tersebut. Untuk informasi lebih lanjut, lihat tabel Pembaruan simultan pada beberapa modul di topik Ikhtisar. No: Perangkat tidak mendukung pembaruan simultan pada beberapa modul. Nilai default: Tidak.
   Timpa Tugas Pembaruan Perangkat Sebelumnya	Menentukan apakah akan menimpa tugas pembaruan sebelumnya dari perangkat. Jika perangkat memiliki beberapa tugas pembaruan, Anda harus menentukan apakah akan menggunakan tugas pembaruan saat ini untuk menimpa tugas pembaruan sebelumnya. Tugas pembaruan pada perangkat dapat berada dalam status Menunggu Konfirmasi, Akan Didorong, atau Sudah Didorong. Nilai valid: Yes: Hanya tugas pembaruan terbaru yang dilakukan. Tugas pembaruan sebelumnya dibatalkan. No: Hanya tugas pembaruan yang ada yang dilakukan. Nilai default: Tidak. Catatan Tugas pembaruan yang sedang berlangsung tidak ditimpa.
   Berlaku hanya untuk Perangkat yang Baru Melaporkan Versi	Menentukan apakah hanya memperbarui perangkat yang kemudian melaporkan versi OTA modul baru. Parameter ini hanya ditampilkan jika Anda mengatur parameter Metode Pembaruan ke Dynamic Update. Nilai valid: Yes: hanya memperbarui perangkat yang melaporkan versi OTA modul baru. No: Memperbarui perangkat yang ada yang memenuhi kondisi pembaruan dan terus memeriksa apakah perangkat yang melaporkan versi modul OTA baru memenuhi kondisi pembaruan. Nilai default: No.
   APP Confirm Upgrade	Menentukan apakah Anda dapat menggunakan aplikasi seluler untuk melakukan pembaruan. Jika memilih Ya, Anda harus mengembangkan aplikasi seluler tersebut. Nilai valid: Yes: Untuk melakukan pembaruan OTA pada perangkat, Anda harus mengonfirmasi pembaruan melalui aplikasi seluler yang dikembangkan. Anda dapat memanggil operasi ConfirmOTATask untuk mengonfirmasi beberapa tugas pembaruan yang berstatus menunggu konfirmasi secara bersamaan. Selanjutnya, perangkat dapat memperoleh informasi tugas pembaruan OTA berdasarkan nilai parameter Whether IoT Platform Actively Pushes Update Task. No: Perangkat memperoleh informasi tugas pembaruan OTA berdasarkan pengaturan parameter Whether IoT Platform Actively Pushes Update Task. Nilai default: Tidak.
   Protokol Unduhan Paket Pembaruan	Protokol yang digunakan untuk mengunduh paket pembaruan. Nilai valid: HTTPS dan MQTT. Setelah perangkat menerima URL paket pembaruan dari IoT Platform, protokol ini dapat digunakan untuk mengunduh paket tersebut. Penting Untuk mengunduh paket pembaruan menggunakan protokol Message Queuing Telemetry Transport (MQTT), perhatikan hal-hal berikut: Layanan Anda harus diterapkan di wilayah China (Shanghai), China (Beijing), atau China (Shenzhen). Paket pembaruan OTA hanya dapat mencakup satu file dengan ukuran tidak lebih dari 16 MB. Gunakan versi terbaru Link SDK untuk C untuk mengembangkan fitur perangkat guna melakukan pembaruan OTA dan mengunduh file melalui MQTT. Untuk detail lebih lanjut, lihat Contoh kode.
   Label Batch	Klik Add Tag. Pada bidang yang muncul, tentukan kunci label dan nilai label. Jika batch pembaruan yang Anda buat berstatus updating, Anda dapat memodifikasi atau menambahkan lebih banyak label. Untuk informasi lebih lanjut, lihat Kelola batch pembaruan. Label dari batch pembaruan akan dikirim ke perangkat saat IoT Platform mendorong notifikasi pembaruan ke perangkat-perangkat tersebut. Arahkan penunjuk ke ikon untuk melihat aturan yang digunakan dalam mengonfigurasi label.

6. Opsional:Di tab Manajemen Batch halaman Update Package Details, temukan batch pembaruan dinamis dan klik Edit di kolom Tindakan. Di langkah Update Scope Configuration dan Update Policy Configuration, Anda dapat mengubah nilai parameter Version number to be upgraded dan Device upgrade time-out. Anda dapat membatalkan pengaturan timeout.
   Penting

   • Sebelum Anda memodifikasi pengaturan pembaruan dinamis, perhatikan item berikut:
     • Version number to be upgraded: Jika Anda menambahkan nomor versi, perangkat yang ada yang menggunakan versi tersebut dan perangkat baru yang sesuai dengan kebijakan dinamis diperbarui. Jika Anda menghapus nomor versi, perangkat yang ada tidak terpengaruh.
     • Device upgrade time-out: Parameter ini hanya berlaku untuk pembaruan OTA dinamis pada perangkat baru. Perangkat yang ada tidak terpengaruh.
   • Anda tidak dapat mengubah nilai parameter Version number to be upgraded untuk batch pembaruan dinamis berbasis grup.

Hasil

Setelah Anda memulai pembaruan batch, IoT Platform mendorong notifikasi pembaruan ke perangkat yang ditentukan berdasarkan pengaturan Anda. Anda dapat melihat status pembaruan setiap perangkat dan informasi paket pembaruan di Konsol IoT Platform. Untuk informasi lebih lanjut, lihat Lihat status pembaruan.

Operasi API Terkait

Untuk informasi lebih lanjut tentang operasi API terkait fitur pembaruan OTA, lihat Pembaruan OTA.