Udostępnij za pośrednictwem

Przewodnik rozwiązywania problemów z aktualizacją urządzenia dla IoT Hub

  • Artykuł

W tym dokumencie wymieniono niektóre typowe pytania i problemy zgłaszane przez użytkowników usługi Device Update. Jeśli wystąpi problem, który nie pojawi się w tym przewodniku rozwiązywania problemów, zapoznaj się z sekcją Kontaktowanie pomoc techniczna firmy Microsoft, aby udokumentować sytuację.

Importowanie aktualizacji

Pyt.: Mam problemy z połączeniem wystąpienia usługi Device Update z wystąpieniem IoT Hub

Upewnij się, że trasy komunikatów IoT Hub są poprawnie skonfigurowane zgodnie z dokumentacją zasobów usługi Device Update.

Być może nie masz poprawnie skonfigurowanych uprawnień dostępu. Upewnij się, że prawidłowo skonfigurowano uprawnienia dostępu zgodnie z dokumentacją kontroli dostępu do aktualizacji urządzeń .

Pyt.: Występuje błąd 500-type podczas importowania zawartości do usługi Device Update

Kod błędu w zakresie 500 może wskazywać na problem z usługą Device Update. Poczekaj 5 minut, a następnie spróbuj ponownie. Jeśli ten sam błąd będzie się powtarzać, postępuj zgodnie z instrukcjami w sekcji Kontaktowanie pomoc techniczna firmy Microsoft, aby zgłosić wniosek o pomoc techniczną w firmie Microsoft.

Pyt.: Chcę zachować te same właściwości zgodności (dotyczy mojej aktualizacji tego samego typu urządzenia), ale zmień dostawcę lub nazwę w manifeście importu. Otrzymuję jednak błąd "Niepowodzenie: błąd podczas importowania aktualizacji z powodu przekroczenia limitu"

Nie można używać tego samego dokładnego zestawu właściwości zgodności z więcej niż jedną kombinacją dostawcy aktualizacji i nazwy. Pozwala to usłudze Device Update na określenie z pewnością, które aktualizacje powinny być dostępne do wdrożenia na danym urządzeniu. Jeśli musisz zaktualizować wiele składników lub partycji na jednym urządzeniu, funkcja aktualizacji serwera proxy zapewnia tę możliwość.

Pyt.: Występuje komunikat o błędzie podczas importowania zawartości i chciałbym dowiedzieć się więcej o nim

Aby uzyskać bardziej szczegółowe informacje na temat komunikatów o błędach związanych z importowaniem, zapoznaj się z dokumentacją kodów błędów aktualizacji urządzeń .

Błędy urządzeń

Pyt.: Jak mogę upewnić się, że urządzenie jest połączone z usługą Device Update dla IoT Hub?

Możesz sprawdzić, czy urządzenie jest połączone z usługą Device Update, sprawdzając, czy jest ono wyświetlane w sekcji "Niezgrupowane" urządzenia w widoku zgodności Azure Portal.

Pyt.: Co najmniej jedno z moich urządzeń nie może zaktualizować

Istnieje wiele możliwych głównych przyczyn niepowodzenia aktualizacji urządzenia. Sprawdź, czy urządzenie jest: 1) połączone z wystąpieniem IoT Hub, 2) połączone z wystąpieniem usługi Device Update i 3) jest uruchomiona usługa optymalizacji dostarczania (DO). Jeśli wszystkie trzy są prawdziwe dla twojego urządzenia, postępuj zgodnie z instrukcjami w sekcji Kontaktowanie pomoc techniczna firmy Microsoft, aby zgłosić wniosek o pomoc techniczną w firmie Microsoft.

Pyt.: Nie można uruchomić mojego agenta aktualizacji urządzenia

Jednym z najczęstszych powodów niepowodzenia podczas uruchamiania agenta usługi Device Update jest źle sformułowany plik konfiguracji (du-config.json). Zapoznaj się z dokumentacją pliku konfiguracji i upewnij się, że agent jest poprawnie skonfigurowany. Należy pamiętać, że wszystkie wartości w pliku konfiguracji muszą używać podwójnych cudzysłowów.

Wdrażanie aktualizacji

Pyt.: Wdrożono aktualizację na urządzeniach, ale stan zgodności wskazuje, że nie dotyczy najnowszej aktualizacji. Co mam zrobić?

Odświeżenie stanu zgodności urządzenia może potrwać do 5 minut. Zaczekaj, a następnie sprawdź ponownie.

Pyt.: Stan wdrożenia urządzenia jest niezgodny, co należy zrobić?

Właściwości producenta i modelu urządzenia docelowego mogły zostać zmienione po połączeniu urządzenia z IoT Hub, co powoduje, że urządzenie jest teraz uznawane za niezgodne z zawartością aktualizacji bieżącego wdrożenia.

Sprawdź interfejs podstawowy usługi ADU , aby zobaczyć, jaki producent i model urządzenia raportuje do usługi Device Update, i upewnij się, że jest zgodny z producentem i modelem określonym w manifeście importu wdrożonej zawartości aktualizacji. Te właściwości dla danego urządzenia można zmienić przy użyciu pliku konfiguracji usługi Device Update.

Pyt.: Widzę, że moje wdrożenie znajduje się na etapie "Aktywne", ale żadne z moich urządzeń nie jest "W toku" z aktualizacją. Co mam zrobić?

Upewnij się, że data rozpoczęcia wdrożenia nie jest ustawiona w przyszłości. Podczas tworzenia nowego wdrożenia data rozpoczęcia wdrożenia jest domyślnie ustawiona na następny dzień jako zabezpieczenie, chyba że jawnie ją zmienisz. Możesz poczekać na nadejście daty rozpoczęcia wdrożenia lub anulować bieżące wdrożenie i utworzyć nowe z wymaganą datą rozpoczęcia.

Pyt.: Próbuję zgrupować moje urządzenia, ale nie widzę tagu na liście rozwijanej podczas tworzenia grupy

Upewnij się, że trasy komunikatów zostały poprawnie skonfigurowane w IoT Hub zgodnie z dokumentacją zasobów usługi Device Update. Po skonfigurowaniu trasy konieczne będzie ponowne tagowanie urządzenia.

Inną główną przyczyną może być zastosowanie tagu przed nawiązaniem połączenia urządzenia z usługą Device Update dla IoT Hub. Upewnij się, że urządzenie jest już połączone z usługą Device Update. Możesz sprawdzić, czy urządzenie jest połączone z usługą Device Update dla IoT Hub, sprawdzając, czy urządzenie jest wyświetlane w widoku zgodności w obszarze "Niezgrupowane". Tymczasowo dodaj tag innej wartości, a następnie ponownie dodaj zamierzony tag po nawiązaniu połączenia z urządzeniem.

Jeśli używasz usługi Device Provisioning Service (DPS), upewnij się, że urządzenia są tagowane po ich aprowizacji, a nie podczas procesu tworzenia urządzenia. Jeśli urządzenie zostało już otagowane podczas kroku Tworzenia urządzenia, musisz tymczasowo oznaczyć urządzenie inną wartością po jego aprowizacji, a następnie dodać zamierzony tag ponownie.

Pyt.: Moje wdrożenie zakończyło się pomyślnie, ale niektóre urządzenia nie zostały zaktualizowane

Może to być spowodowane błędem po stronie klienta na urządzeniach, które uległy awarii. Zobacz sekcję Błędy urządzeń w tym przewodniku rozwiązywania problemów.

Pyt.: Wystąpił błąd w środowisku użytkownika podczas próby zainicjowania wdrożenia

Przyczyną może być usterka usługi/środowiska użytkownika lub problem z uprawnieniami interfejsu API. Postępuj zgodnie z instrukcjami w sekcji Kontaktowanie pomoc techniczna firmy Microsoft, aby złożyć wniosek o pomoc techniczną w firmie Microsoft.

Pyt.: Rozpoczęto wdrożenie, ale nie osiąga stanu końcowego

Może to być spowodowane problemem z wydajnością usługi, usterką usługi lub usterką klienta. Ponów próbę wdrożenia po 10 minutach. Jeśli wystąpi ten sam problem, pobierz dzienniki urządzenia i zapoznaj się z sekcją Błędy urządzeń w tym przewodniku rozwiązywania problemów. Jeśli ten sam problem będzie się powtarzać, postępuj zgodnie z instrukcjami w sekcji Kontaktowanie pomoc techniczna firmy Microsoft, aby zgłosić wniosek o pomoc techniczną w firmie Microsoft.

Pyt.: Przeprowadzono migrację z agenta na poziomie urządzenia w celu dodania agenta jako tożsamości modułu na urządzeniu, a moja aktualizacja jest wyświetlana jako "w toku", mimo że została zastosowana do urządzenia

Może to być spowodowane tym, że nie usunięto starszego agenta, który komunikował się za pośrednictwem bliźniaczej reprezentacji urządzenia. Podczas aprowizowania agenta aktualizacji urządzeń jako modułu (zobacz , jak) cała komunikacja między urządzeniem a usługą Device Update odbywa się za pośrednictwem bliźniaczej reprezentacji modułu, dlatego pamiętaj o tagowaniu bliźniaczej reprezentacji modułu urządzenia podczas tworzenia grup i całej komunikacji musi nastąpić za pośrednictwem bliźniaczej reprezentacji modułu.

Pobieranie aktualizacji na urządzeniach

Pyt.: Jak mogę wznowić pobieranie po ponownym połączeniu urządzenia po okresie rozłączenia?

Pobieranie zostanie wznowione po przywróceniu łączności w ciągu 24 godzin. Po upływie 24 godzin pobieranie musi zostać ponownie zainicjowane przez użytkownika.

Korzystanie z usługi Microsoft Connected Cache (MCC)

Pyt.: Występuje problem podczas próby wdrożenia modułu MCC na urządzeniu IoT Edge

Zapoznaj się z dokumentacją IoT Edge dotyczącą wdrażania modułów usługi Edge na urządzeniach IoT Edge. Możesz sprawdzić, czy moduł MCC działa pomyślnie na urządzeniu IoT Edge, przechodząc dohttp://localhost:5100/Summary.

Pyt.: Jedno z moich urządzeń IoT próbuje pobrać aktualizację za pośrednictwem mcC, ale kończy się niepowodzeniem

Istnieje kilka problemów, które mogą powodować niepowodzenie połączenia urządzenia IoT z mcC. Aby zdiagnozować ten problem, zbierz dzienniki klienta DO i serwera Nginx z urządzenia, które kończy się niepowodzeniem (zobacz sekcję Kontaktowanie się z pomoc techniczna firmy Microsoft, aby uzyskać instrukcje dotyczące zbierania dzienników klienta).

Urządzenie może nie ściągnąć zawartości z Internetu do przekazania do modułu MCC, ponieważ adres URL używany przez niego nie jest dozwolony. Aby ustalić, czy tak, należy sprawdzić zmienne środowiskowe IoT Edge w Azure Portal.

Rozwiązywanie problemów z brakującym wystąpieniem w Azure Portal

Pyt.: Nie widzę wystąpienia aktualizacji urządzenia dla IoT Hub po wybraniu ikony "koła zębatego"

Istnieje kilka możliwych przyczyn tego problemu. Zobacz poniżej, aby uzyskać instrukcje rozwiązywania problemów.

Wystąpienie usługi Device Update musi być skojarzone z centrum Azure IoT Hub w tej samej grupie zasobów i subskrypcji. Jeśli wystąpienie usługi Device Update lub Centrum zostało przeniesione do innej grupy zasobów lub subskrypcji, wystąpienie może nie być widoczne w Azure Portal. Aby kontynuować korzystanie z usługi Device Update dla IoT Hub, należy wykonać jedną z następujących czynności:

  • Zwróć przeniesione elementy do oryginalnej konfiguracji.
  • Jeśli centrum IoT przeniesiono tylko z jednej grupy zasobów do innej, zmodyfikuj wystąpienie usługi Device Update przy użyciu nowego identyfikatora resourceId centrum IoT.
  • Jeśli elementy zostały przeniesione z jednej subskrypcji do innej, upewnij się, że konto aktualizacji urządzeń i centrum IoT znajdują się w tej samej subskrypcji, a następnie zmodyfikuj wystąpienie usługi Device Update przy użyciu nowego identyfikatora resourceId centrum IoT.

Wymagane są co najmniej uprawnienia na poziomie odczytu zarówno dla centrum IoT, jak i usługi Device Update dla konta IoT Hub w celu uzyskania dostępu do funkcji aktualizacji urządzeń za pośrednictwem środowiska centrum IoT w Azure Portal.

  • Aby zarządzać uprawnieniami IoT Hub:
    • Wybierz centrum z Azure Portal
    • Wybierz pozycję "Kontrola dostępu (IAM) na pasku nawigacyjnym po lewej stronie.
    • Wybierz pozycję "Dodaj przypisanie roli".
    • Wybierz rolę z co najmniej dostępem do odczytu i wybierz pozycję Dalej.
    • Obok pozycji "Członkowie" wybierz pozycję "+Wybierz członków".
    • Dodaj swoje konto w oknie wysuwanym po prawej stronie i wybierz przycisk "Wybierz".
    • Wybierz pozycję "Przejrzyj i przypisz".
  • Aby zarządzać uprawnieniami usługi Device Update dla konta IoT Hub, poproś właściciela konta o wykonanie następujących kroków:
    • Wybierz konto usługi Device Update z Azure Portal.
    • Wybierz pozycję "Kontrola dostępu (Zarządzanie dostępem i tożsamościami) na pasku nawigacyjnym po lewej stronie.
    • Wybierz pozycję "Dodaj przypisanie roli".
    • Wybierz rolę Czytelnik (lub taką z równoważnymi uprawnieniami).
    • Obok pozycji "Członkowie" wybierz pozycję "+Wybierz członków".
    • Dodaj swoje konto w oknie wysuwanym po prawej stronie i wybierz przycisk "Wybierz".
    • Wybierz pozycję "Przejrzyj i przypisz".

Dowiedz się więcej o kontroli dostępu opartej na rolach dla usługi Device Update.

Kontaktowanie się z pomocą techniczną firmy Microsoft

Jeśli napotkasz problemy, których nie można rozwiązać przy użyciu powyższych często zadawanych pytań, możesz zgłosić wniosek o pomoc techniczną z pomoc techniczna firmy Microsoft za pośrednictwem interfejsu Azure Portal. W zależności od kategorii, do której należy twój problem, może zostać wyświetlony monit o zebranie i udostępnienie dodatkowych danych w celu ułatwienia pomoc techniczna firmy Microsoft zbadania problemu.

Zapoznaj się z poniższymi instrukcjami dotyczącymi zbierania poszczególnych typów danych.

Możesz użyć polecenia getDevice , aby sprawdzić dodatkowe informacje w odpowiedzi ładunku interfejsu API.

Ponadto następujące informacje mogą być przydatne do zawężania głównej przyczyny problemu:

  • Jakiego typu urządzenie próbujesz zaktualizować (IoT Edge Gateway, inne)
  • Jakiego typu klienta usługi Device Update używasz (oparty na obrazach, opartych na pakietach, symulatorze)
  • Jaki system operacyjny jest uruchomiony na urządzeniu
  • Szczegóły dotyczące architektury urządzenia
  • Czy aktualizacja urządzenia została pomyślnie użyta do zaktualizowania urządzenia przed

Jeśli masz jakiekolwiek z powyższych informacji, dołącz je do opisu problemu.

Zbieranie dzienników klienta

  • Na urządzeniu Raspberry Pi znajdują się dwa zestawy dzienników:

    /adu/logs

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

  • W przypadku spakowanego klienta dzienniki znajdują się tutaj:

    /var/log/adu

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

  • W przypadku symulatora dzienniki znajdują się tutaj:

    /tmp/aduc-logs

Kody błędów

Może zostać wyświetlony monit o podanie kodów błędów podczas zgłaszania problemu związanego z importowaniem aktualizacji, awarią urządzenia lub wdrażaniem aktualizacji.

Kody błędów można uzyskać, patrząc na interfejs ADUCoreInterface . Zapoznaj się z dokumentacją kodów błędów usługi Device Update , aby uzyskać informacje na temat analizowania kodów błędów na potrzeby samodzielnej diagnostyki i rozwiązywania problemów.

Identyfikator śledzenia

Podczas zgłaszania problemu związanego z importowaniem lub wdrażaniem aktualizacji może zostać wyświetlony monit o podanie identyfikatora śledzenia.

Identyfikator śledzenia dla danej akcji użytkownika można znaleźć w odpowiedzi interfejsu API lub w sekcji Historia importu interfejsu użytkownika Azure Portal.

Obecnie identyfikatory śledzenia dla akcji wdrażania są dostępne tylko za pośrednictwem odpowiedzi interfejsu API.

Identyfikator wdrożenia

Podczas zgłaszania problemu związanego z wdrażaniem aktualizacji może zostać wyświetlony monit o podanie identyfikatora wdrożenia.

Identyfikator wdrożenia jest tworzony przez użytkownika podczas wywoływania interfejsu API w celu zainicjowania wdrożenia.

Obecnie identyfikatory wdrożenia dla wdrożeń inicjowanych z interfejsu użytkownika Azure Portal są generowane automatycznie i nie są udostępniane użytkownikowi.

nazwa wystąpienia IoT Hub

Podczas zgłaszania problemu związanego z awariami urządzeń lub wdrażania aktualizacji może zostać wyświetlony monit o podanie nazwy wystąpienia IoT Hub.

Nazwa IoT Hub jest wybierana przez użytkownika podczas pierwszej aprowizacji.

Nazwa konta usługi Device Update

Podczas zgłaszania problemu związanego z importowaniem aktualizacji lub wdrażaniem aktualizacji może zostać wyświetlony monit o podanie nazwy konta usługi Device Update.

Nazwa konta usługi Device Update jest wybierana przez użytkownika podczas pierwszego rejestrowania się w usłudze. Więcej informacji można znaleźć w dokumentacji zasobów usługi Device Update .

Nazwa wystąpienia usługi Device Update

Podczas zgłaszania problemu związanego z importowaniem aktualizacji aktualizacji aktualizacji lub wdrażaniem aktualizacji może zostać wyświetlony monit o podanie nazwy wystąpienia usługi Device Update.

Nazwa wystąpienia usługi Device Update jest wybierana przez użytkownika podczas pierwszej aprowizacji. Więcej informacji można znaleźć w dokumentacji zasobów usługi Device Update .

Identyfikator urządzenia

Podczas zgłaszania problemu związanego z awariami urządzeń lub wdrażania aktualizacji może zostać wyświetlony monit o podanie identyfikatora urządzenia.

Identyfikator urządzenia jest definiowany przez klienta podczas pierwszej aprowizacji urządzenia. Można go również pobrać z bliźniaczej reprezentacji urządzenia.

Identyfikator aktualizacji

Podczas zgłaszania problemu związanego z wdrażaniem aktualizacji może zostać wyświetlony monit o podanie identyfikatora aktualizacji.

Identyfikator aktualizacji jest definiowany przez klienta podczas inicjowania wdrożenia.

Dzienniki serwera Nginx

Podczas zgłaszania problemu związanego z usługą Microsoft Connected Cache może zostać wyświetlony monit o podanie dzienników serwera Nginx.

ADU-conf.txt

Podczas zgłaszania problemu związanego z wdrażaniem aktualizacji aktualizacji może zostać wyświetlony monit o podanie pliku konfiguracji usługi Device Update ("adu-conf.txt").

Plik konfiguracji jest opcjonalny i tworzony przez użytkownika zgodnie z instrukcjami w dokumentacji konfiguracji usługi Device Update .

Importowanie manifestu

Podczas zgłaszania problemu związanego z importowaniem lub wdrażaniem aktualizacji może zostać wyświetlony monit o podanie pliku manifestu importu.

Manifest importu to plik utworzony przez klienta podczas importowania zawartości aktualizacji do usługi Device Update.

Następne kroki

Dowiedz się więcej o kodach błędów usługi Device Update