Memigrasikan perangkat dan grup dari Pratinjau Umum ke Refresh Pratinjau Umum

  • Artikel
  • 3 menit untuk membaca

Saat layanan Device Update for IoT Hub merilis versi baru, Anda pasti ingin memperbarui perangkat Anda untuk mendapatkan fitur dan peningkatan keamanan terbaru. Artikel ini memberikan informasi tentang cara bermigrasi dari rilis Pratinjau Umum ke rilis Refresh Pratinjau Umum (PPR) saat ini. Artikel ini juga menjelaskan perilaku grup dan UX di seluruh rilis ini. Jika Anda tidak memiliki perangkat, grup, dan penyebaran yang menggunakan rilis Pratinjau Umum, Anda dapat mengabaikan halaman ini.

Untuk berhasil bermigrasi, Anda harus meningkatkan agen DU yang berjalan di perangkat Anda. Anda juga harus membuat grup perangkat baru untuk menyebarkan dan mengelola pembaruan. Perhatikan bahwa karena ada perubahan besar dengan rilis PPR, kami sarankan Anda mengikuti instruksi dengan cermat untuk menghindari kesalahan.

Memperbarui agen pembaruan perangkat

Untuk rilis Refresh Pratinjau Umum, agen Pembaruan Perangkat perlu diperbarui secara manual seperti yang dijelaskan di bawah ini. Memperbarui agen melalui penyebaran Pembaruan Perangkat tidak didukung karena perubahan besar di seluruh Pratinjau Umum dan rilis PPR.

  1. Untuk melihat perangkat menggunakan agen lama (versi 0.7.0/0.6.0) dan grup yang dibuat sebelum 02/03/2022, masuk ke portal Pratinjau Umum, yang dapat diakses melalui spanduk.

    Screenshot of banner.

  2. Buat perangkat IoT/IoT Edge baru di portal Microsoft Azure. Salin string koneksi utama untuk perangkat dari tampilan perangkat untuk nanti. Untuk detail selengkapnya, lihat bagian Menambahkan Perangkat ke IoT Hub.

  3. Kemudian, SSH ke perangkat Anda dan hapus agen Pembaruan Perangkat lama.

    sudo apt remove deviceupdate-agent 
sudo apt remove adu-agent

  4. Menghapus file konfigurasi lama

    rm -f /etc/adu/adu-conf.txt

  5. Memasang agen baru

    sudo apt-get install deviceupdate-agent

    Atau, Anda dapat memperolah aset .deb dari GitHub dan memasang agen

    sudo apt install <file>.deb

    Mencoba memutakhirkan agen Pembaruan Perangkat tanpa menghapus agen lama dan file konfigurasi akan mengakibatkan kesalahan yang ditunjukkan di bawah ini.

    Screenshot of update error.

  6. Masukkan string koneksi utama perangkat (atau modul, tergantung pada bagaimana Anda memprovisikan perangkat dengan Pembaruan Perangkat) dari perangkat IoT Anda, dalam file konfigurasi dengan menjalankan perintah di bawah ini.

    /etc/adu/du-config.json

  7. Menambahkan detail model dan produsen Anda dalam file konfigurasi

  8. Hapus perangkat IoT/IoT Edge lama dari portal pratinjau umum.

Catatan

Mencoba memperbarui agen melalui penyebaran DU akan menyebabkan perangkat tidak lagi dapat dikelola oleh Pembaruan Perangkat. Perangkat harus diprovisikan ulang untuk dikelola dari Pembaruan Perangkat.

Memigrasikan grup ke Refresh Pratinjau Umum

  1. Jika perangkat Anda menggunakan agen Pembaruan Perangkat versi 0.6.0 atau 0.7.0, tingkatkan ke versi agen terbaru 0.8.0 dengan mengikuti langkah-langkah di atas.

  2. Hapus grup yang ada di portal pratinjau umum dengan menavigasi keseluruhan spanduk.

  3. Tambahkan tag grup ke kembaran perangkat untuk perangkat yang diperbarui. Untuk detail selengkapnya, lihat bagian Menambahkan tag ke perangkat Anda.

  4. Buat ulang grup di portal PPR dengan masuk ke 'Menambahkan Grup' dan pilih tag grup yang sesuai dari daftar drop-down.

  5. Perhatikan bahwa grup dengan nama yang sama tidak dapat dibuat di portal PPR jika grup di portal pratinjau umum tidak dihapus.

Perilaku grup dan penyebaran di seluruh rilis

  • Grup yang dibuat di portal rilis Refresh Pratinjau Umum hanya akan mengizinkan penambahan perangkat dengan Agen Pembaruan Perangkat terbaru (0.8.0). Perangkat dengan agen lama (0.7.0/0.6.0) tidak dapat ditambahkan ke grup ini.

  • Setiap perangkat baru yang menggunakan agen terbaru akan secara otomatis ditambahkan ke Grup Kelas Perangkat Default di tab 'Grup dan Penyebaran'. Jika tag grup ditambahkan ke properti perangkat, maka perangkat akan ditambahkan ke grup tersebut jika ada grup untuk tag tersebut.

  • Untuk perangkat yang menggunakan agen terbaru, jika tag grup ditambahkan ke properti perangkat tetapi grup yang sesuai belum dibuat, perangkat tidak akan terlihat di tab 'Grup dan Penyebaran'.

  • Perangkat yang menggunakan agen yang lebih lama akan muncul sebagai tidak dikelompokkan di portal lama jika tag grup tidak ditambahkan.

Langkah berikutnya

Memahami file konfigurasi agen Pembaruan Perangkat

Anda dapat menggunakan tutorial berikut untuk demonstrasi sederhana Device Update for IoT Hub: