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

W tym dokumencie wymieniono niektóre typowe pytania i problemy zgłaszane przez użytkowników usługi Device Update. W miarę postępu aktualizacji urządzenia w publicznej wersji zapoznawczej ten przewodnik rozwiązywania problemów będzie okresowo aktualizowany przy użyciu nowych pytań i rozwiązań. Jeśli wystąpi problem, który nie zostanie wyświetlony w tym przewodniku rozwiązywania problemów, zapoznaj się z sekcją Kontaktowanie się z pomocą techniczną firmy Microsoft , aby udokumentować twoją sytuację.

Importowanie aktualizacji

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

Upewnij się, że trasy komunikatów usługi 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ń .

Mam problem z wystąpieniem błędu typu 500 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 się z pomocą techniczną firmy Microsoft, aby zgłosić wniosek o pomoc techniczną w firmie Microsoft.

Chcę zachować te same właściwości zgodności (skierować moją aktualizację do tego samego typu urządzenia), ale zmienić dostawcę lub nazwę w manifeście importu. Ale otrzymuję błąd "Niepowodzenie: błąd podczas importowania aktualizacji z powodu przekroczenia limitu", gdy to zrobię.

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. Dzięki temu usługa Device Update pozwala określić 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ść.

.: Podczas importowania zawartości pojawia się komunikat o błędzie i chcę dowiedzieć się więcej na ten temat.

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ądzenia .

Błędy urządzeń

.: Jak mogę upewnić się, że moje urządzenie jest połączone z usługą Device Update dla usługi 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 "Urządzenia niezgrupowane" w widoku zgodności witryny Azure Portal.

Jedno lub więcej moich urządzeń nie może się zaktualizować.

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

Wdrażanie aktualizacji

P: Wdrożyłem aktualizację na moje urządzenie/urządzenia, ale stan zgodności wskazuje, że nie jest na najnowszej aktualizacji. Co należy zrobić?

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

Q: Status wdrożenia mojego urządzenia jest niekompatybilny, co powinienem zrobić?

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

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

Widzę, że wdrożenie znajduje się na etapie "Aktywny", ale żadne z moich urządzeń nie jest w trakcie realizacji aktualizacji. Co należy 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ślna do następnego dnia jako zabezpieczenie, chyba że jawnie zmienisz je. 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.

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

Upewnij się, że trasy komunikatów w usłudze IoT Hub zostały prawidłowo skonfigurowane zgodnie z dokumentacją zasobów usługi Device Update . Po skonfigurowaniu trasy musisz ponownie oznaczyć urządzenie.

Inną główną przyczyną może być zastosowanie tagu przed nawiązaniem połączenia urządzenia z usługą Device Update dla usługi 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 usługi IoT Hub, sprawdzając, czy jest ono wyświetlane w obszarze "Niezgrupowane" urządzenia w widoku zgodności. 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 oznaczasz urządzenia po ich aprowizacji, a nie podczas procesu tworzenia urządzenia. Jeśli urządzenie zostało już otagowane podczas kroku tworzenia urządzenia, konieczne będzie tymczasowe oznaczanie urządzenia inną wartością po jej aprowizacji, a następnie ponowne dodanie zamierzonego tagu.

Moje wdrożenie zakończyło się pomyślnie, ale niektóre urządzenia nie zdołały się zaktualizować.

Może to być spowodowane przez błąd po stronie klienta na urządzeniach, które uległy awarii. Zapoznaj się z sekcją Device Failures (Błędy urządzeń) tego przewodnika rozwiązywania problemów.

.: 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 się z pomocą techniczną firmy Microsoft, aby zgłosić wniosek o pomoc techniczną w firmie Microsoft.

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

Może to być spowodowane problemem z wydajnością usługi, usterką usługi lub usterką klienta. Proszę ponowić próbę wdrożenia za 10 minut. 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 się z pomocą techniczną firmy Microsoft, aby zgłosić wniosek o pomoc techniczną w firmie Microsoft.

.: 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.

To mogło być spowodowane, jeśli nie usunąłeś starszego agenta, który komunikował się za pośrednictwem Device Twin. Podczas aprowizowania agenta aktualizacji urządzenia jako modułu (zobacz instrukcje), wszystkie komunikaty między urządzeniem a usługą Device Update są realizowane za pośrednictwem modułu Twin. Dlatego pamiętaj, aby oznaczyć moduł Twin urządzenia podczas tworzenia grup. Wszelka komunikacja musi odbywać się za pośrednictwem modułu Twin.

Pobieranie aktualizacji na urządzeniach

.: Jak 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)

Mam do czynienia z problemem podczas próby wdrożenia modułu MCC na moim urządzeniu IoT Edge.

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

.: 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 Nginx z urządzenia, które jest wadliwe (zobacz sekcję Kontaktowanie się z pomocą techniczną firmy Microsoft, aby uzyskać instrukcje dotyczące zbierania dzienników klienta).

Urządzenie może nie ściągnąć zawartości z Internetu, aby przekazać ją do modułu MCC, ponieważ adres URL, który jest używany, nie jest dozwolony. Aby określić, czy tak, należy sprawdzić zmienne środowiskowe usługi IoT Edge w witrynie Azure Portal.

Kontaktowanie się z pomocą techniczną firmy Microsoft

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

Zapoznaj się z poniższymi instrukcjami dotyczącymi zbierania poszczególnych typów danych. Możesz użyć getDevices, aby sprawdzić dodatkowe informacje w odpowiedzi zawartości interfejsu API.

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

Jakiego typu urządzenie próbujesz zaktualizować (azure Percept, brama usługi IoT Edge, inne)
Jakiego typu klienta usługi Device Update używasz (oparty na obrazach, opartych na pakiecie, symulatorze)
Jaki system operacyjny jest uruchomiony na urządzeniu
Szczegóły dotyczące architektury urządzenia
Czy wcześniej udało Ci się pomyślnie zaktualizować urządzenie za pomocą aktualizacji urządzeń

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

Zbieranie dzienników klientów

Na urządzeniu Raspberry Pi znajdują się dwa zestawy dzienników znajdujących się tutaj:
```
/adu/logs
```
```
/var/cache/do-client-lite/log
```
W przypadku klienta w wersji pakietowej 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

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

Kody błędów można uzyskać, przeglądając interfejs ADUCoreInterface . Zapoznaj się z dokumentacją kodów błędów aktualizacji urządzeń , aby uzyskać informacje na temat analizowania kodów błędów na potrzeby samodzielnej diagnostyki i rozwiązywania problemów.

Identyfikator śledzenia

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

Identyfikator śledzenia dla konkretnej akcji użytkownika można znaleźć w odpowiedzi interfejsu API lub w sekcji Historia importu w interfejsie 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 raportowania 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 witryny Azure Portal są generowane automatycznie i nie są wyświetlane użytkownikowi.

Nazwa wystąpienia usługi 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 usługi IoT Hub.

Nazwa usługi 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, awariami urządzenia lub wdrażaniem aktualizacji, możesz zostać poproszony lub poproszona 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, awariami urządzeń lub wdrażaniem aktualizacji możesz zostać poproszony o podanie nazwy instancji 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 Cyfrowego Bliźniaka Urządzenia.

Identyfikator aktualizacji

Podczas raportowania 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 raportowania 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 możesz zostać poproszony o podanie pliku konfiguracyjnego aktualizacji urządzenia ("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ępny krok: Dowiedz się więcej o kodach błędów aktualizacji urządzenia

Last updated on 2021-02-17

Udostępnij przez