Ta bu sayfa, bir firmware güncellemesi bir cihaza ulaşmadığında, tamamlanmadığında veya dalgalar halinde yapılan dağıtım durduğunda yardımcı olur. Paketin sayfasından başlayın (Firmware > paket): its Devices listesi her cihazın State, Progress, Tries ve Problem bilgilerini gösterir. Cihazın Firmware sekmesi, cihazın neyi Runs çalıştırdığını, Update bölümünü ve History geçmişini gösterir.
Cihaza imaj sunulmuyor
Atama yapmadan önce Check seçeneğini işaretleyin: What happens, paketi almayacak cihazları nedeniyle birlikte listeler.
| Neden | Çözüm |
|---|---|
| Profili için güncellemeler kapalı | Profilin Firmware sekmesinde Allow firmware updates for this profile seçeneğini açın (yeni profilde varsayılan olarak kapalıdır) |
| Başka donanım modeli | Paket Hardware models listeler; cihaz başka bir model bildiriyor |
| Başka bir profil için üretilmiş | Paket tek bir profille sınırlı (Only for devices of this profile) |
| İmzasız izin verilmiyor | Paket Not signed durumunda ve profil Allow unsigned images seçeneğine izin vermiyor (bunu yalnızca test cihazlarında kullanın) |
| Mevcut sürüm çok eski | Cihaz, Lowest version it can update from değerinden daha eski |
| Mevcut sürüm henüz bilinmiyor | Cihaz current_fw_version bilgisini bildirmedi. Her bağlantıdan sonra göndermelidir. |
| Daha özel atama önceliklidir | Cihaz ataması cihaz listesine, cihaz listesi ise profile göre önceliklidir |
| Dalgasını bekliyor | Bir dağıtımda, sonraki bir dalgadaki cihaz dalgası başlayana kadar hiçbir şey almaz: Waits for wave n |
Paket hazır değil
| State | Anlamı |
|---|---|
| Being checked | Dosya virüs taramasından geçirilir; tarama temiz çıkarsa Ready olur |
| Rejected | Sağlama toplamı, imza veya tarama başarısız oldu; dosya silindi. Yeniden yükleyin. |
| Retire sonrası | Yeni atamalar için artık sunulmaz; çalışan güncellemeler devam eder |
| Revoke sonrası | Kurulmamalıdır: kurulumu başlamamış güncellemeler durduruldu |
İmza, kayıtlı Signing keys anahtarlarınıza göre denetlenir. Bir anahtarı iptal etmek, onunla imzalanmış tüm paketleri iptal eder.
Güncelleme durumunu okuyun
| State | Anlamı | Yapılacaklar |
|---|---|---|
| Queued | Atandı; cihaz çevrimiçi olduğunda gönderilir | Cihazı çevrimiçi duruma getirin |
| Sent to the device | Cihaza bildirildi; indirmeye başlamalıdır | Bu durum sürerse, cihaz v1/attributes/set üzerindeki fw_* paylaşılan özniteliklerini işlemiyor demektir |
| Downloading, Downloaded, Checked, Installing | Cihazın bildirdiği ilerleme | Bekleyin |
| Waiting | Cihaz güncellemeyi tutuyor: ölçümlü bağlantıda, mobil veri dışında veya cihazın kendisinde onay beklerken | Hata değil. Aşağıya bakın. |
| Failed | Cihaz bir fw_error koduyla FAILED bildirdi | Problem alanını okuyun; nedeni giderdikten sonra Try again seçin |
| No answer in time | Cihaz, Download may take (minutes) (varsayılan 60) veya Installing may take (minutes) (varsayılan 20) süresi içinde bildirim göndermeyi kesti | Bağlantıyı ve cihazı kontrol edin; yavaş bağlantılar veya büyük imajlar için profildeki süreleri artırın |
| Went back to the old version | Yeni sürüm düzgün başlamadı ve cihaz eski sürüme döndü | İmajı erişebildiğiniz bir cihazda test edin; açılış günlüklerini kontrol edin |
| Not for this device | Paket bu cihaza uygun değil | İlk tabloya bakın |
| Cancelled | Kurulmadan önce durduruldu |
Tries per update (varsayılan 3, profilin Firmware sekmesinde 1 ile 10 arası), her güncellemenin kaç deneme hakkı olacağını belirler. Başarısız, zaman aşımına uğrayan veya eski sürüme dönen cihazlar için paket sayfası Try again seçeneğini sunar.
Ölçümlü bağlantıda bekleme
Mobil (LTE) bağlantıdaki bir cihaz fw_wait: metered bildirir ve bekler, çünkü Allow updates over LTE (mobile data) varsayılan olarak kapalıdır. Güncellemesine izin vermek için:
- profil için bu ayarı açın veya
- cihazın Firmware sekmesinde Updates over LTE seçeneğini Allowed for this device olarak ayarlayın.
fw_wait: quota_exhausted, cihazın mobil veri kotasının dolduğu anlamına gelir; approval ise birinin cihazda onaylaması gerektiği anlamına gelir. Bekleyen cihazlar, bir dalga kapandığında hata sayılmaz.
İndirme ve kurulum sorunları
| Belirti | Neden |
|---|---|
| İndirme 15 dakika sonra başarısız oluyor | fw_url 15 dakika geçerlidir. Cihaz fw_url değerini yeniden istemeli ve bir HTTP Range isteğiyle kaldığı yerden devam etmelidir. |
| Sağlama toplamı tutuyor ama cihaz imajı reddediyor | İmza doğrulanamıyor. Cihaz reddetmekte haklıdır: imajı kayıtlı bir anahtarla yeniden imzalayın. |
| Cihaz Updated bildiriyor ama durum değişmiyor | Yeni current_fw_version olmadan gelen UPDATED tek başına kabul edilmez. Yeniden başlatmadan sonra çalışan sürümü bildirin. |
| Firmware hiç sunulmuyor | Firmware, düz MQTT üzerinden asla sunulmaz: cihaz TLS kullanmalıdır |
Cihazın neyi aldığı ve neyi bildirdiği için Firmware updates (OTA) sayfasına bakın.
Bir dağıtım kendiliğinden duraklatıldı
Dalgalar halinde yapılan bir dağıtım, bir dalga şu durumda kendiliğinden duraklar:
| Gösterilen neden | Anlamı | Yapılacaklar |
|---|---|---|
| çok fazla cihaz başarısız oldu | Dalganın At most failed (%) değerinden fazla başarısızlık var | Başarısız cihazların Problem alanına bakın, nedeni giderin, sonra Resume veya Abort seçin |
| çok az cihaz güncellendi | Dalga, gerekenden az güncellenmiş cihazla kapandı | Genellikle çevrimdışı cihazlar. Kontrol edip devam ettirin. |
| hiçbir cihaz zamanında tamamlanmadı | Dalga, hiçbir cihaz tamamlanmadan kapandı | Cihazlar çevrimdışı olabilir veya indiremiyor olabilir |
“Güncellemesine başlamış cihazlar güncellemeyi tamamlar; biri dağıtımı devam ettirene kadar başka hiçbir cihaz güncellemeyi almaz.” Yöneticilere uygulama içinde bir bildirim gönderilir. Resume o ana kadar olanları kabul eder: yalnızca yeni başarısızlıklar kapıya karşı sayılır. Abort atamayı kaldırır ve geri alınamaz.
Olağan plan: %1 kanarya (1 ila 10 cihaz), ardından %10, %50 ve kalanı; her dalga, tamamlanan cihazların %90’ının güncellenmesini gerektirir, %5’in üzerinde başarısızlıkta duraklar ve en geç 240 dakika sonra kapanır. Bkz. Rolling out firmware in waves.
Kimin neyi yapabileceği
| Eylem | Varsayılan rol |
|---|---|
| Paketleri ve güncelleme durumlarını görüntüleme | Kullanıcı |
| Paket yükleme, kullanımdan kaldırma, iptal etme, silme; atama; OTA ayarlarını değiştirme; yeniden deneme | Yönetici |
| İmzalama anahtarlarını kaydetme ve iptal etme | Sahip |