Panduan Pemecahan Masalah Device Update for IoT Hub

Artikel
05/24/2023

Dokumen ini mencantumkan beberapa pertanyaan umum dan masalah yang dilaporkan pengguna Pembaruan Perangkat. Jika Anda mengalami masalah yang tidak muncul dalam panduan pemecahan masalah ini, lihat bagian Menghubungi Dukungan Microsoft untuk mendokumentasikan situasi Anda.

Mengimpor pembaruan

T: Saya mengalami masalah saat menyambungkan instans Pembaruan Perangkat ke instans IoT Hub saya

Pastikan rute pesan IoT Hub Anda dikonfigurasi dengan benar, sesuai dokumentasi sumber daya Pembaruan Perangkat.

Anda mungkin tidak memiliki izin akses yang dikonfigurasi dengan benar. Harap pastikan Anda telah mengonfigurasi izin akses dengan benar sesuai dengan dokumentasi Kontrol akses Pembaruan Perangkat.

T: Saya mengalami kesalahan jenis 500 saat mengimpor konten ke layanan Pembaruan Perangkat

Kode kesalahan dalam rentang 500 dapat menunjukkan masalah dengan layanan Device Update. Harap tunggu 5 menit, lalu coba lagi. Jika kesalahan yang sama terus berlanjut, ikuti petunjuk di bagian Menghubungi Dukungan Microsoft untuk mengajukan permintaan dukungan ke Microsoft.

T: Saya ingin mempertahankan properti kompatibilitas yang sama (menargetkan pembaruan saya ke jenis perangkat yang sama), tetapi ubah Penyedia atau Nama dalam manifes impor. Tetapi saya mendapatkan kesalahan "Gagal: kesalahan mengimpor pembaruan karena batas yang terlampaui" ketika saya melakukannya

Set properti kompatibilitas yang sama persis tidak dapat digunakan dengan lebih dari satu kombinasi Nama dan Penyedia Pembaruan. Ini memungkinkan layanan Pembaruan Perangkat untuk menentukan dengan pasti pembaruan mana yang harus tersedia untuk disebarkan ke perangkat tertentu. Jika Anda perlu memperbarui beberapa komponen atau partisi pada satu perangkat, fitur pembaruan proksi menyediakan kemampuan tersebut.

T: Saya mengalami pesan kesalahan saat mengimpor konten dan ingin memahami lebih lanjut tentang hal itu

Baca dokumentasi Kode Kesalahan Device Update untuk informasi lebih rinci tentang pesan kesalahan terkait impor.

Kegagalan perangkat

T: Bagaimana cara memastikan perangkat saya tersambung ke Device Update for IoT Hub?

Anda dapat memverifikasi bahwa perangkat Anda tersambung ke Pembaruan Perangkat dengan memeriksa apakah perangkat tersebut muncul di bawah bagian perangkat "Tidak Dikelompokkan" dalam tampilan kepatuhan portal Azure.

T: Satu atau beberapa perangkat saya gagal diperbarui

Ada banyak kemungkinan akar penyebab kegagalan pembaruan perangkat. Harap validasi bahwa perangkat tersebut: 1) tersambung ke instans IoT Hub Anda, 2) tersambung ke instans Device Update Anda, dan 3) layanan Delivery Optimization (DO) sedang berjalan. Jika ketiganya benar untuk perangkat Anda, ikuti petunjuk di bagian Menghubungi Dukungan Microsoft untuk mengajukan permintaan dukungan ke Microsoft.

T: Agen Pembaruan Perangkat saya gagal memulai

Salah satu alasan paling umum untuk kegagalan dalam start-up agen Pembaruan Perangkat adalah file konfigurasi yang salah bentuk (du-config.json). Silakan lihat dokumentasi file konfigurasi dan pastikan agen Anda dikonfigurasi dengan benar. Perhatikan bahwa semua nilai dalam file konfigurasi harus menggunakan tanda kutip ganda.

Menyebarkan pembaruan

T: Saya telah menyebarkan pembaruan ke perangkat saya, tetapi status kepatuhan mengatakan penyebaran tidak ada di pembaruan terbaru. Apa yang harus saya lakukan?

Status kepatuhan perangkat memerlukan waktu hingga 5 menit untuk di-refresh. Harap tunggu, lalu periksa lagi.

T: Status penyebaran perangkat saya menunjukkan tidak kompatibel, apa yang harus saya lakukan?

Properti produsen dan model perangkat yang ditargetkan mungkin telah diubah setelah menyambungkan perangkat ke IoT Hub, menyebabkan perangkat sekarang dianggap tidak kompatibel dengan konten pembaruan penyebaran saat ini.

Periksa Antarmuka Inti ADU untuk melihat produsen dan model yang dilaporkan perangkat Anda ke layanan Device Update, dan pastikan itu cocok dengan produsen dan model yang Anda tentukan dalam manifes impor dari memperbarui konten yang disebarkan. Anda dapat mengubah properti ini untuk perangkat tertentu menggunakan file konfigurasi Device Update.

T: Saya melihat penyebaran saya berada dalam tahap "Aktif" tetapi tidak ada perangkat saya yang "Sedang dalam proses" dengan pembaruan. Apa yang harus saya lakukan?

Pastikan tanggal mulai penyebaran Anda tidak ditetapkan di masa mendatang. Saat Anda membuat penyebaran baru, tanggal mulai penyebaran ditetapkan secara default ke hari berikutnya sebagai perlindungan kecuali Anda mengubahnya secara eksplisit. Anda dapat menunggu tanggal mulai penyebaran tiba, atau membatalkan penyebaran yang sedang berlangsung dan membuat penyebaran baru dengan tanggal mulai yang diinginkan.

T: Saya mencoba mengelompokkan perangkat saya, tetapi saya tidak melihat tag di menu drop-down saat membuat grup

Pastikan Anda telah mengonfigurasi rute pesan dengan benar di IoT Hub Anda sesuai dengan dokumentasi Sumber daya Device Update. Anda harus menandai perangkat Anda lagi setelah mengonfigurasi rute.

Penyebab utama lainnya adalah Anda menerapkan tag sebelum menghubungkan perangkat Anda ke Device Update for IoT Hub. Pastikan perangkat Anda sudah tersambung ke Device Update. Anda dapat memverifikasi bahwa perangkat Anda tersambung ke Device Update for IoT Hub dengan memeriksa apakah perangkat tersebut muncul di bawah perangkat “Tidak dikelompokkan” di tampilan kepatuhan. Tambahkan tag untuk sementara dengan nilai yang berbeda, lalu tambahkan tag yang Anda maksudkan lagi setelah perangkat tersambung.

Jika menggunakan Device Provisioning Service (DPS), pastikan Anda menandai perangkat Anda setelah disediakan dan bukan selama proses pembuatan Perangkat. Jika Anda telah menandai perangkat selama langkah pembuatan Perangkat, Anda harus memberi tag sementara pada perangkat Anda dengan nilai yang berbeda setelah disediakan, lalu menambahkan tag yang Anda maksudkan lagi.

T: Penyebaran saya berhasil diselesaikan, tetapi beberapa perangkat gagal diperbarui

Ini mungkin disebabkan oleh kesalahan sisi klien pada perangkat yang gagal. Harap lihat bagian Kegagalan Perangkat dari panduan pemecahan masalah ini.

T: Saya mengalami kesalahan di UX saat mencoba memulai penyebaran

Ini mungkin disebabkan oleh bug layanan/UX, atau oleh masalah izin API. Harap ikuti petunjuk di bagian Menghubungi Dukungan Microsoft untuk mengajukan permintaan dukungan ke Microsoft.

T: Saya memulai penyebaran tetapi tidak mencapai status akhir

Ini mungkin disebabkan oleh masalah performa layanan, bug layanan, atau bug klien. Harap coba kembali penyebaran Anda setelah 10 menit. Jika Anda mengalami masalah yang sama, harap tarik log perangkat Anda dan lihat bagian Kegagalan Perangkat dari panduan pemecahan masalah ini. Jika masalah yang sama terus berlanjut, ikuti petunjuk di bagian Menghubungi Dukungan Microsoft untuk mengajukan permintaan dukungan ke Microsoft.

T: Saya bermigrasi dari agen tingkat perangkat untuk menambahkan agen sebagai identitas Modul pada perangkat, dan pembaruan saya ditampilkan sebagai 'sedang berlangsung' meskipun telah diterapkan ke perangkat

Ini mungkin disebabkan jika Anda tidak menghapus agen lama yang berkomunikasi melalui Device Twin. Saat Anda memprovisikan agen Pembaruan Perangkat sebagai Modul (lihat panduan) semua komunikasi antara perangkat dan layanan Pembaruan Perangkat terjadi melalui Module Twin, jadi ingatlah untuk menandai Module Twin perangkat saat membuat grup dan semua komunikasi harus terjadi melalui Module Twin.

Mengunduh pembaruan ke perangkat

T: Bagaimana cara melanjutkan pengunduhan saat perangkat telah tersambung kembali setelah periode pemutusan sambungan?

Unduhan akan dilanjutkan sendiri ketika konektivitas dipulihkan dalam periode 24 jam. Setelah 24 jam, unduhan perlu dilakukan ulang oleh pengguna.

Menggunakan Microsoft Connected Cache (MCC)

T: Saya mengalami masalah saat mencoba menyebarkan modul MCC di perangkat IoT Edge saya

Lihat dokumentasi IoT Edge untuk menyebarkan modul Edge ke perangkat IoT Edge. Anda dapat memeriksa apakah modul MCC berhasil berjalan di perangkat IoT Edge Anda dengan membuka http://localhost:5100/Summary.

T: Salah satu perangkat IoT saya mencoba mengunduh pembaruan melalui MCC, tetapi gagal

Ada beberapa masalah yang dapat menyebabkan perangkat IoT gagal tersambung ke MCC. Untuk mendiagnosis masalah, harap kumpulkan klien DO dan log Nginx dari perangkat yang gagal (lihat bagian Menghubungi Dukungan Microsoft untuk petunjuk tentang mengumpulkan log klien).

Perangkat Anda mungkin gagal menarik konten dari Internet untuk diteruskan ke modul MCC-nya karena URL yang digunakannya tidak diizinkan. Untuk menentukan apakah demikian, Anda perlu memeriksa variabel lingkungan IoT Edge Anda di portal Azure.

Memecahkan masalah instans yang hilang di portal Azure

T: Saya tidak melihat instans Pembaruan Perangkat untuk IoT Hub saat saya memilih ikon "gigi"

Ada beberapa kemungkinan penyebab masalah ini. Lihat di bawah ini untuk langkah-langkah pemecahan masalah.

Instans Pembaruan Perangkat perlu dikaitkan dengan hub Azure IoT di grup sumber daya dan langganan yang sama. Jika Anda telah memindahkan instans Pembaruan Perangkat atau hub ke grup sumber daya atau langganan yang berbeda, Anda mungkin tidak melihat instans Anda di portal Azure. Anda harus melakukan salah satu langkah berikut untuk terus menggunakan Pembaruan Perangkat untuk IoT Hub:

Mengembalikan item yang dipindahkan ke konfigurasi aslinya.
Jika Anda hanya memindahkan hub IoT dari satu grup sumber daya ke grup sumber daya lainnya, ubah instans Pembaruan Perangkat Anda dengan resourceId baru hub IoT.
Jika Anda memindahkan item dari satu langganan ke langganan lainnya, pastikan akun Pembaruan Perangkat dan hub IoT berada dalam langganan yang sama, lalu ubah instans Pembaruan Perangkat Anda dengan resourceId baru hub IoT.

Setidaknya izin tingkat Baca diperlukan untuk hub IoT dan akun Device Update for IoT Hub Anda untuk mengakses fungsionalitas Pembaruan Perangkat melalui pengalaman hub IoT di portal Azure.

Untuk mengelola izin untuk IoT Hub Anda:
- Pilih hub Anda dari portal Azure
- Pilih "Kontrol akses (IAM) dari bilah navigasi sebelah kiri.
- Pilih "Tambahkan penetapan peran".
- Pilih peran dengan setidaknya akses Baca dan pilih Berikutnya.
- Di samping "Anggota", pilih "+Pilih anggota".
- Tambahkan akun Anda di flyout sebelah kanan, dan pilih tombol "Pilih".
- Pilih "Tinjau + tetapkan".
Untuk mengelola izin untuk akun Device Update for IoT Hub Anda, minta pemilik akun untuk mengambil langkah-langkah berikut:
- Pilih akun Pembaruan Perangkat Anda dari portal Azure.
- Pilih "Kontrol akses (IAM) dari bilah navigasi sebelah kiri.
- Pilih "Tambahkan penetapan peran".
- Pilih peran Pembaca (atau peran dengan izin yang setara).
- Di samping "Anggota", pilih "+Pilih anggota".
- Tambahkan akun Anda di flyout sebelah kanan, dan pilih tombol "Pilih".
- Pilih "Tinjau + tetapkan".

Pelajari selengkapnya tentang kontrol akses berbasis peran untuk layanan Pembaruan Perangkat.

Menghubungi Dukungan Microsoft

Jika mengalami masalah yang tidak dapat diselesaikan menggunakan FAQ di atas, Anda dapat mengajukan permintaan dukungan dengan Dukungan Microsoft melalui antarmuka portal Azure. Bergantung pada kategori masalah Anda, Anda mungkin diminta untuk mengumpulkan dan berbagi data tambahan untuk membantu Dukungan Microsoft menyelidiki masalah Anda.

Harap lihat di bawah untuk petunjuk tentang cara mengumpulkan setiap jenis data.

Anda dapat menggunakan getDevice untuk memeriksa informasi tambahan dalam respons payload API.

Selain itu, informasi berikut dapat berguna untuk mempersempit akar penyebab masalah Anda:

Jenis perangkat apa yang Anda coba perbarui (IoT Edge Gateway, lainnya)
Jenis klien Pembaruan Perangkat apa yang Anda gunakan (Berbasis gambar, Berbasis paket, Simulator)
OS apa yang dijalankan perangkat Anda
Detail mengenai arsitektur perangkat Anda
Apakah Anda telah berhasil menggunakan Pembaruan Perangkat untuk memperbarui perangkat sebelumnya

Jika informasi di atas ada, harap sertakan dalam deskripsi Anda tentang masalah ini.

Mengumpulkan log klien

Pada Perangkat Raspberry Pi, ada dua set log yang ditemukan di sini:
```
/adu/logs
```
```
/var/cache/do-client-lite/log
```
Untuk klien yang dikemas, log ditemukan di sini:
```
/var/log/adu
```
```
/var/cache/do-client-lite/log
```
Untuk Simulator, log ditemukan di sini:
```
/tmp/aduc-logs
```

Kode kesalahan

Anda mungkin diminta untuk memberikan kode kesalahan saat melaporkan masalah terkait impor pembaruan, kegagalan perangkat, atau menyebarkan pembaruan.

Kode kesalahan dapat diperoleh dengan melihat antarmuka ADUCoreInterface. Harap merujuk ke dokumentasi kode kesalahan Pembaruan Perangkat untuk informasi tentang cara mengurai kode kesalahan untuk diagnosis dan pemecahan masalah mandiri.

ID Pelacakan

Anda mungkin diminta untuk memberikan ID pelacakan saat melaporkan masalah terkait mengimpor atau menyebarkan pembaruan.

ID pelacakan untuk tindakan pengguna tertentu dapat ditemukan dalam respons API, atau di bagian Riwayat Impor di antarmuka pengguna portal Azure.

Saat ini, ID pelacakan untuk tindakan penyebaran hanya dapat diakses melalui respons API.

Deployment ID

Anda mungkin diminta untuk memberikan ID penyebaran saat melaporkan masalah terkait mengimpor atau menyebarkan pembaruan.

ID penyebaran dibuat oleh pengguna saat memanggil API untuk memulai penyebaran.

Saat ini, ID penyebaran untuk penyebaran yang dimulai dari antarmuka pengguna portal Azure otomatis dibuat dan tidak muncul ke pengguna.

Nama instans IoT Hub

Anda mungkin diminta untuk memberikan nama instans IoT Hub saat melaporkan masalah terkait kegagalan perangkat atau menyebarkan pembaruan.

Nama IoT Hub dipilih oleh pengguna saat pertama kali diprovisikan.

Nama akun Pembaruan Perangkat

Anda mungkin diminta untuk memberikan nama akun Pembaruan Perangkat Saat melaporkan masalah terkait impor pembaruan, kegagalan perangkat, atau menyebarkan pembaruan.

Nama akun Pembaruan Perangkat dipilih oleh pengguna saat pertama kali mendaftar untuk layanan. Informasi selengkapnya dapat ditemukan dalam dokumentasi sumber daya Pembaruan Perangkat.

Nama instans Pembaruan Perangkat

Anda mungkin diminta untuk memberikan nama instans Pembaruan Perangkat saat melaporkan masalah terkait impor pembaruan, kegagalan perangkat, atau menyebarkan pembaruan.

Nama instans Pembaruan Perangkat dipilih oleh pengguna saat pertama kali diprovisikan. Informasi selengkapnya dapat ditemukan dalam dokumentasi sumber daya Pembaruan Perangkat.

ID Perangkat

Anda mungkin diminta untuk memberikan ID perangkat saat melaporkan masalah terkait kegagalan perangkat atau menyebarkan pembaruan.

ID perangkat ditentukan oleh pelanggan saat perangkat pertama kali diprovisikan. Ini juga dapat diambil dari Device Twin perangkat.

ID Pembaruan

Anda mungkin diminta untuk memberikan ID pembaruan saat melaporkan masalah terkait mengimpor atau menyebarkan pembaruan.

ID pembaruan ditentukan oleh pelanggan saat memulai penyebaran.

Log Nginx

Anda mungkin diminta untuk menyediakan log Nginx saat melaporkan masalah yang terkait dengan Cache Terhubung Microsoft.

ADU-conf.txt

Anda mungkin diminta untuk memberikan file konfigurasi Pembaruan Perangkat ("adu-conf.txt") saat melaporkan masalah yang terkait dengan penyebaran pembaruan.

File konfigurasi bersifat opsional dan dibuat oleh pengguna mengikuti petunjuk dalam dokumentasi konfigurasi Pembaruan Perangkat.

Manifes impor

Anda mungkin diminta untuk memberikan file manifes impor saat melaporkan masalah terkait mengimpor atau menyebarkan pembaruan.

Manifes impor adalah file yang dibuat oleh pelanggan saat mengimpor konten pembaruan ke layanan Pembaruan Perangkat.

Langkah berikutnya

Pelajari selengkapnya tentang kode kesalahan Pembaruan Perangkat