IoT Hub için Cihaz Güncelleştirmesi Sorun Giderme Kılavuzu

Bu belgede Cihaz Güncelleştirmesi kullanıcılarının bildirdiği bazı yaygın sorular ve sorunlar listelenir. Bu sorun giderme kılavuzunda görünmeyen bir sorunla karşılaşırsanız, durumunuzu belgelendirmek için İletişim Microsoft Desteği bölümüne bakın.

Güncelleştirmeleri içeri aktarma

S: Cihaz Güncelleştirmesi örneğimi IoT Hub örneğime bağlarken sorun yaşıyorum

IoT Hub ileti yollarınızın Cihaz Güncelleştirmesi kaynakları belgelerine göre doğru yapılandırıldığından emin olun.

S: Rolle ilgili bir hatayla karşılaşıyorum (Azure portal hata iletisi veya 403 API hatası)

Erişim izinleriniz doğru yapılandırılmamış olabilir. Lütfen Cihaz Güncelleştirmesi erişim denetimi belgelerine göre erişim izinlerini doğru yapılandırdığınızdan emin olun.

S: Cihaz Güncelleştirme hizmetine içerik aktarırken 500 tür bir hatayla karşılaşıyorum

500 aralığındaki bir hata kodu, Cihaz Güncelleştirme hizmetiyle ilgili bir sorun olduğunu gösterebilir. Lütfen 5 dakika bekleyin ve yeniden deneyin. Aynı hata devam ederse, Microsoft'a bir destek isteği göndermek için lütfen İletişim Microsoft Desteği bölümündeki yönergeleri izleyin.

S: Aynı uyumluluk özelliklerini korumak (güncelleştirmemi aynı cihaz türüne hedeflemek) ama içeri aktarma bildirimindeki Sağlayıcıyı veya Adı değiştirmek istiyorum. Ancak bunu yaptığımda "Başarısız oldu: sınırı aşıldığından güncelleştirme içeri aktarılırken hata oluştu" hatasını alıyorum

Aynı uyumluluk özellikleri kümesi birden fazla Güncelleştirme Sağlayıcısı ve Ad bileşimiyle kullanılamaz. Bu, Cihaz Güncelleştirme hizmetinin belirli bir cihaza dağıtmak için hangi güncelleştirmelerin kullanılabilir olması gerektiğini kesin olarak belirlemesine olanak tanır. Tek bir cihazda birden çok bileşeni veya bölümü güncelleştirmeniz gerekiyorsa, ara sunucu güncelleştirme özelliği bu özelliği sağlar.

S: İçeriği içeri aktarırken bir hata iletisiyle karşılaşıyorum ve içerik hakkında daha fazla bilgi edinmek istiyorum

İçeri aktarmayla ilgili hata iletileri hakkında daha ayrıntılı bilgi için lütfen Cihaz Güncelleştirme Hata Kodları belgelerine bakın.

Cihaz hataları

S: Cihazımın IoT Hub için Cihaz Güncelleştirmesi'ne bağlı olduğundan nasıl emin olabilirim?

Cihazınızın Cihaz Güncelleştirmesi'ne bağlı olduğunu doğrulamak için Azure portal uyumluluk görünümündeki "Gruplandırılmamış" cihazlar bölümünde görünip görünmediğini de kontrol edebilirsiniz.

S: Bir veya daha fazla cihazım güncelleştirilemeye devam ediyor

Cihaz güncelleştirme hatasının birçok olası kök nedeni vardır. Lütfen cihazın şu IoT Hub örneğine bağlı olduğunu, 2) Cihaz Güncelleştirmesi örneğine bağlı olduğunu ve 3) Teslim İyileştirme (DO) hizmetinin çalıştığını doğrulayın. Üçü de cihazınız için geçerliyse, Microsoft'a destek isteği göndermek için lütfen İletişim Microsoft Desteği bölümündeki yönergeleri izleyin.

S: Cihaz Güncelleştirme aracım başlatılamıyor

Cihaz Güncelleştirmesi aracısı başlatma işleminin başarısız olmasının en yaygın nedenlerinden biri, hatalı biçimlendirilmiş bir yapılandırma dosyasıdır (du-config.json). Lütfen yapılandırma dosyası belgelerine bakın ve aracınızın doğru yapılandırıldığından emin olun. Yapılandırma dosyasındaki tüm değerlerin çift tırnak kullanması gerektiğini unutmayın.

Güncelleştirme dağıtma

S: Cihazlarıma bir güncelleştirme dağıttım, ancak uyumluluk durumu en son güncelleştirmede olmadığını belirtiyor. Ne yapmalıyım?

Cihaz uyumluluk durumunun yenilenmesi 5 dakika kadar sürebilir. Lütfen bekleyin ve yeniden kontrol edin.

S: Cihazımın dağıtım durumu uyumsuz görünüyor, ne yapmalıyım?

Hedeflenen bir cihazın üretici ve model özellikleri, cihaz IoT Hub bağlandıktan sonra değiştirilmiş olabilir ve bu da cihazın artık geçerli dağıtımın güncelleştirme içeriğiyle uyumsuz olarak kabul edilmesine neden olabilir.

Cihazınızın Cihaz Güncelleştirme hizmetine hangi üreticiyi ve modeli bildirdiğini görmek için ADU Çekirdek Arabirimi'ni denetleyin ve dağıtılmakta olan güncelleştirme içeriğinin içeri aktarma bildiriminde belirttiğiniz üretici ve modelle eşleştiğinden emin olun. Cihaz Güncelleştirmesi yapılandırma dosyasını kullanarak belirli bir cihazın bu özelliklerini değiştirebilirsiniz.

S: Dağıtımımın "Etkin" aşamasında olduğunu görüyorum ancak güncelleştirmeyle birlikte cihazlarımdan hiçbiri "Devam ediyor" değil. Ne yapmalıyım?

Dağıtım başlangıç tarihinizin gelecekte ayarlanmadığından emin olun. Yeni bir dağıtım oluşturduğunuzda, açıkça değiştirmediğiniz sürece dağıtım başlangıç tarihi varsayılan olarak bir sonraki güne ayarlanır. Dağıtım başlangıç tarihinin gelmesini bekleyebilir veya devam eden dağıtımı iptal edip istenen başlangıç tarihiyle yeni bir dağıtım oluşturabilirsiniz.

S: Cihazlarımı gruplandırmaya çalışıyorum ancak grup oluştururken açılan listede etiketi görmüyorum

Cihaz Güncelleştirmesi kaynakları belgelerine göre IoT Hub ileti yollarını doğru yapılandırdığınızdan emin olun. Yolu yapılandırdıktan sonra cihazınızı yeniden etiketlemeniz gerekir.

Bir diğer kök neden, cihazınızı IoT Hub için Cihaz Güncelleştirmesi'ne bağlamadan önce etiketi uygulamanız olabilir. Cihazınızın Cihaz Güncelleştirmesi'ne zaten bağlı olduğundan emin olun. Cihazınızın IoT Hub için Cihaz Güncelleştirmesi'ne bağlı olduğunu doğrulamak için uyumluluk görünümündeki "Gruplanmamış" cihazlar altında gösterilip gösterilmediğini kontrol edebilirsiniz. Geçici olarak farklı bir değere sahip bir etiket ekleyin ve ardından cihaz bağlandıktan sonra hedeflenen etiketinizi yeniden ekleyin.

Cihaz Sağlama Hizmeti (DPS) kullanıyorsanız cihaz oluşturma işlemi sırasında değil, sağlandıktan sonra cihazlarınızı etiketlediğinizden emin olun. Cihaz oluşturma adımı sırasında cihazınızı zaten etiketlediyseniz, cihazınızı sağlandıktan sonra geçici olarak farklı bir değerle etiketlemeniz ve ardından hedeflenen etiketi yeniden eklemeniz gerekir.

S: Dağıtımım başarıyla tamamlandı ancak bazı cihazlar güncelleştirilemedi

Bunun nedeni başarısız cihazlarda istemci tarafı hatası olabilir. Lütfen bu sorun giderme kılavuzunun Cihaz Hataları bölümüne bakın.

S: Dağıtım başlatmaya çalışırken UX'te bir hatayla karşılaştım

Bunun nedeni bir hizmet/UX hatası veya API izinleri sorunu olabilir. Microsoft'a destek isteği göndermek için lütfen İletişim Microsoft Desteği bölümündeki yönergeleri izleyin.

S: Dağıtım başlattım ama son duruma ulaşmıyor

Bunun nedeni bir hizmet performansı sorunu, hizmet hatası veya istemci hatası olabilir. Lütfen 10 dakika sonra dağıtımınızı yeniden deneyin. Aynı sorunla karşılaşırsanız lütfen cihaz günlüklerinizi çekin ve bu sorun giderme kılavuzunun Cihaz Hataları bölümüne bakın. Aynı sorun devam ederse Microsoft'a destek isteği göndermek için lütfen İletişim Microsoft Desteği bölümündeki yönergeleri izleyin.

S: Cihaz düzeyinde bir aracıdan aracıyı cihaza Modül kimliği olarak eklemeye geçiş yaptım ve cihaza uygulanmış olsa bile güncelleştirmem 'devam ediyor' olarak görünüyor

Cihaz İkizi üzerinden iletişimde bulunan eski aracıyı kaldırmadıysanız bu durum ortaya çıkabilir. Cihaz Güncelleştirme aracısını Modül olarak sağladığınızda ( nasıl yapılır) cihaz ile Cihaz Güncelleştirme hizmeti arasındaki tüm iletişimler Modül İkizi üzerinden gerçekleşir, bu nedenle grupları oluştururken cihazın Modül İkizini etiketlemeyi unutmayın ve tüm iletişimlerin modül ikizi üzerinden gerçekleşmesi gerekir.

Güncelleştirmeleri cihazlara indirme

S: Bir cihaz bir süre bağlantı kesildikten sonra yeniden bağlandığında indirme işlemine devam Nasıl yaparım??

24 saatlik bir süre içinde bağlantı geri yüklendiğinde indirme işlemi kendi kendine devam eder. 24 saat sonra indirme işleminin kullanıcı tarafından yeniden başlatılması gerekir.

Microsoft Bağlı Önbelleği (MCC) kullanma

S: MCC modülünü IoT Edge cihazıma dağıtmaya çalışırken bir sorunla karşılaşıyorum

Edge modüllerini IoT Edge cihazlara dağıtmak için IoT Edge belgelerine bakın. MCC modülünün IoT Edge cihazınızda başarıyla çalıştırılıp çalıştırılamadığını denetlemek içinhttp://localhost:5100/Summary.

S: IoT cihazlarımdan biri MCC aracılığıyla bir güncelleştirmeyi indirmeye çalışsa da başarısız oluyor

IoT cihazının MCC'ye bağlanırken başarısız olmasına neden olabilecek çeşitli sorunlar vardır. Sorunu tanılamak için lütfen başarısız olan cihazdan DO istemcisi ve Nginx günlüklerini toplayın (istemci günlüklerini toplama yönergeleri için İletişim Microsoft Desteği bölümüne bakın).

Kullandığı URL'ye izin verilmediğinden cihazınız MCC modülüne geçirmek için İnternet'ten içerik çekemeyebilir. Bunun olup olmadığını belirlemek için Azure portal'da IoT Edge ortam değişkenlerinizi denetlemeniz gerekir.

Azure portal eksik bir örneğin sorunlarını giderme

S: "Dişli" simgesini seçtiğim zaman IoT Hub için Cihaz Güncelleştirmesi örneğini görmüyorum

Bu sorunun birkaç olası nedeni vardır. Sorun giderme adımları için aşağıya bakın.

Cihaz Güncelleştirmesi örneğinin aynı kaynak grubu ve abonelikteki bir Azure IoT hub'ı ile ilişkilendirilmesi gerekir. Cihaz Güncelleştirmesi örneğinizi veya hub'ınızı farklı bir kaynak grubuna veya aboneliğe taşıdıysanız örneğinizi Azure portal göremeyebilirsiniz. IoT Hub için Cihaz Güncelleştirmesi'ni kullanmaya devam etmek için aşağıdaki adımlardan birini uygulamanız gerekir:

• Taşınan öğeleri özgün yapılandırmalarına döndür.
• IoT hub'ınızı yalnızca bir kaynak grubundan diğerine taşıdıysanız, Cihaz Güncelleştirmesi örneğinizi IoT hub'ınızın yeni resourceId değeriyle değiştirin.
• Öğeleri bir abonelikten diğerine taşıdıysanız Cihaz Güncelleştirme hesabının ve IoT hub'ınızın aynı abonelikte olduğundan emin olun ve Ardından Cihaz Güncelleştirmesi örneğinizi IoT hub'ınızın yeni resourceId değeriyle değiştirin.

Azure portal IoT hub'ı deneyimi aracılığıyla Cihaz Güncelleştirmesi işlevselliğine erişmek için hem IoT hub'ınız hem de IoT Hub hesabınız için Cihaz Güncelleştirmesi için en azından Okuma düzeyinde izinler gerekir.

• IoT Hub izinlerinizi yönetmek için:
  • Azure portal hub'ınızı seçin
  • Sol gezinti çubuğundan "Erişim denetimi (IAM) seçeneğini belirleyin.
  • "Rol ataması ekle"yi seçin.
  • En azından Okuma erişimi olan bir rol seçin ve İleri'yi seçin.
  • "Üyeler" öğesinin yanındaki "+Üye seç"i seçin.
  • Sağ taraftaki açılır öğeye hesabınızı ekleyin ve "Seç" düğmesini seçin.
  • "Gözden geçir + ata" seçeneğini belirleyin.
• IoT Hub hesabınızın Cihaz Güncelleştirmesi izinlerini yönetmek için hesabın sahibinden şu adımları gerçekleştirmesini isteyin:
  • Azure portal Cihaz Güncelleştirmesi hesabınızı seçin.
  • Sol gezinti çubuğundan "Erişim denetimi (IAM) seçeneğini belirleyin.
  • "Rol ataması ekle" seçeneğini belirleyin.
  • Okuyucu rolünü (veya eşdeğer izinlere sahip bir rol) seçin.
  • "Üyeler" öğesinin yanındaki "+Üye seç"i seçin.
  • Sağ taraftaki açılır öğeye hesabınızı ekleyin ve "Seç" düğmesini seçin.
  • "Gözden geçir + ata" seçeneğini belirleyin.

Cihaz Güncelleştirme hizmeti için rol tabanlı erişim denetimi hakkında daha fazla bilgi edinin.

Microsoft Destek ile iletişim kurma

Yukarıdaki SSS'ler kullanılarak çözülemez sorunlarla karşılaşırsanız, Azure portal arabirimi aracılığıyla Microsoft Desteği ile bir destek isteğinde bulunabilirsiniz. Sorununuzun hangi kategoriye ait olduğunu belirttiğinize bağlı olarak, sorununuzu araştırmak Microsoft Desteği yardımcı olmak için ek verileri toplamanız ve paylaşmanız istenebilir.

Her veri türünü toplama yönergeleri için lütfen aşağıya bakın.

API'nin yük yanıtında ek bilgi olup olmadığını denetlemek için getDevice kullanabilirsiniz.

Ayrıca, aşağıdaki bilgiler sorununuzun kök nedenini daraltmada yararlı olabilir:

• Güncelleştirmeye çalıştığınız cihaz türü (IoT Edge Ağ Geçidi, diğer)
• Kullandığınız Cihaz Güncelleştirmesi istemci türü (Görüntü tabanlı, Paket tabanlı, Simülatör)
• Cihazınızın çalıştırılan işletim sistemi
• Cihazınızın mimarisiyle ilgili ayrıntılar
• Cihaz Güncelleştirmesi'ni daha önce bir cihazı güncelleştirmek için başarıyla kullanıp kullanmadığınız

Yukarıdaki bilgilerden herhangi birine sahipseniz lütfen bunu sorunun açıklamasına ekleyin.

İstemci günlüklerini toplama

• Raspberry Pi Cihazında burada iki günlük kümesi bulunur:

  /adu/logs
  

  /var/cache/do-client-lite/log
  

• Paketlenmiş istemci için günlükler burada bulunur:

  /var/log/adu
  

  /var/cache/do-client-lite/log
  

• Simülatör için günlükler burada bulunur:

  /tmp/aduc-logs
  

Hata kodları

Bir güncelleştirmeyi içeri aktarma, cihaz hatası veya güncelleştirme dağıtmayla ilgili bir sorun bildirildiğinde hata kodları sağlamanız istenebilir.

Hata kodları, ADUCoreInterface arabirimine bakılarak elde edilebilir. Kendi kendine tanılama ve sorun giderme için hata kodlarını ayrıştırma hakkında bilgi için lütfen Cihaz Güncelleştirmesi hata kodları belgelerine bakın.

İzleme Kimliği

Bir güncelleştirmeyi içeri aktarma veya dağıtmayla ilgili bir sorunu bildirirken izleme kimliği sağlamanız istenebilir.

Belirli bir kullanıcı eyleminin izleme kimliği API yanıtında veya Azure portal kullanıcı arabiriminin İçeri Aktarma Geçmişi bölümünde bulunabilir.

Şu anda dağıtım eylemleri için izleme kimliklerine yalnızca API yanıtı üzerinden erişilebilir.

Dağıtım Kimliği

Güncelleştirme dağıtımıyla ilgili bir sorunu bildirirken bir dağıtım kimliği sağlamanız istenebilir.

Dağıtım kimliği, bir dağıtım başlatmak için API'yi çağırırken kullanıcı tarafından oluşturulur.

Şu anda, Azure portal kullanıcı arabiriminden başlatılan dağıtımların dağıtım kimlikleri otomatik olarak oluşturulur ve kullanıcıya gösterilmez.

IoT Hub örnek adı

Cihaz hatalarıyla ilgili bir sorun bildirirken veya bir güncelleştirmeyi dağıtırken IoT Hub örneğinizin adını sağlamanız istenebilir.

IoT Hub adı ilk sağlandığında kullanıcı tarafından seçilir.

Cihaz Güncelleştirme hesabı adı

Bir güncelleştirmeyi içeri aktarma, cihaz hataları veya bir güncelleştirmeyi dağıtma ile ilgili bir sorunu bildirirken Cihaz Güncelleştirmesi hesabınızın adını sağlamanız istenebilir.

Cihaz Güncelleştirmesi hesap adı, hizmete ilk kez kaydolduğunda kullanıcı tarafından seçilir. Cihaz Güncelleştirmesi kaynakları belgelerinde daha fazla bilgi bulabilirsiniz.

Cihaz Güncelleştirme örneği adı

Bir güncelleştirmeyi içeri aktarma, cihaz hataları veya bir güncelleştirmeyi dağıtma ile ilgili bir sorunu bildirirken Cihaz Güncelleştirmesi örneğinizin adını sağlamanız istenebilir.

Cihaz Güncelleştirmesi örneği adı, ilk sağlandığında kullanıcı tarafından seçilir. Cihaz Güncelleştirmesi kaynakları belgelerinde daha fazla bilgi bulabilirsiniz.

Cihaz Kimliği

Cihaz hatalarıyla ilgili bir sorunu bildirirken veya bir güncelleştirmeyi dağıtırken sizden bir cihaz kimliği sağlamanız istenebilir.

Cihaz kimliği, cihaz ilk kez sağlandığında müşteri tarafından tanımlanır. Cihazın Cihaz İkizi'nden de alınabilir.

Güncelleştirme Kimliği

Güncelleştirme dağıtımıyla ilgili bir sorunu bildirirken bir güncelleştirme kimliği sağlamanız istenebilir.

Güncelleştirme kimliği, bir dağıtım başlatırken müşteri tarafından tanımlanır.

Nginx günlükleri

Microsoft Bağlı Önbelleği ile ilgili bir sorunu bildirirken Nginx günlüklerini sağlamanız istenebilir.

ADU-conf.txt

Güncelleştirme dağıtımıyla ilgili bir sorun bildirildiğinde Cihaz Güncelleştirmesi yapılandırma dosyasını ("adu-conf.txt") sağlamanız istenebilir.

Yapılandırma dosyası isteğe bağlıdır ve Cihaz Güncelleştirmesi yapılandırma belgelerindeki yönergeleri izleyerek kullanıcı tarafından oluşturulur.

İçeri aktarma bildirimi

Bir güncelleştirmeyi içeri aktarma veya dağıtmayla ilgili bir sorunu bildirirken içeri aktarma bildirim dosyanızı sağlamanız istenebilir.

İçeri aktarma bildirimi, cihaz güncelleştirme hizmetine güncelleştirme içeriği aktarılırken müşteri tarafından oluşturulan bir dosyadır.

Sonraki adımlar

Cihaz Güncelleştirme hata kodları hakkında daha fazla bilgi edinin