Udostępnij za pośrednictwem

Migrowanie urządzeń i grup z publicznej wersji zapoznawczej do funkcji Odświeżanie publicznej wersji zapoznawczej

  • Artykuł

Ponieważ usługa Device Update for IoT Hub publikuje nowe wersje, należy zaktualizować urządzenia pod kątem najnowszych funkcji i ulepszeń zabezpieczeń. Ten artykuł zawiera informacje o sposobie migracji z wersji publicznej w wersji zapoznawczej do bieżącej wersji publicznej (PPR). W tym artykule wyjaśniono również zachowanie grupy i środowiska użytkownika w tych wersjach. Jeśli nie masz urządzeń, grup i wdrożeń korzystających z wersji publicznej w wersji zapoznawczej, możesz zignorować tę stronę.

Aby pomyślnie przeprowadzić migrację, należy uaktualnić agenta DU uruchomionego na urządzeniach. Konieczne będzie również utworzenie nowych grup urządzeń w celu wdrażania aktualizacji i zarządzania nimi. Należy pamiętać, że ponieważ w wydaniu samoobsługowego resetowania hasła wprowadzono poważne zmiany, zalecamy dokładne wykonanie instrukcji, aby uniknąć błędów.

Aktualizowanie agenta aktualizacji urządzenia

W przypadku wersji Publicznej wersji zapoznawczej agent aktualizacji urządzenia musi zostać zaktualizowany ręcznie zgodnie z poniższym opisem. Aktualizowanie agenta za pośrednictwem wdrożenia usługi Device Update nie jest obsługiwane z powodu poważnych zmian w publicznej wersji zapoznawczej i funkcji samoobsługowego resetowania hasła.

  1. Aby wyświetlić urządzenia przy użyciu starszych agentów (wersje 0.7.0/0.6.0) i grupy utworzone przed 02.03.2022 r., przejdź do portalu publicznej wersji zapoznawczej, do którego można uzyskać dostęp za pośrednictwem baneru.

    Zrzut ekranu przedstawiający baner.

  2. Utwórz nowe urządzenie IoT/IoT Edge na Azure Portal. Skopiuj podstawowe parametry połączenia dla urządzenia z widoku urządzenia do późniejszego użycia. Aby uzyskać więcej informacji, zobacz sekcję Dodawanie urządzenia do IoT Hub.

  3. Następnie przeprowadź połączenie SSH z urządzeniem i usuń dowolnego starego agenta usługi Device Update.

    sudo apt remove deviceupdate-agent 
sudo apt remove adu-agent

  4. Usuwanie starego pliku konfiguracji

    sudo rm -f /etc/adu/adu-conf.txt

  5. Instalowanie nowego agenta

    sudo apt-get install deviceupdate-agent

    Alternatywnie możesz pobrać zasób deb z usługi GitHub i zainstalować agenta

    sudo apt install <file>.deb

    Próba uaktualnienia agenta usługi Device Update bez usunięcia starego agenta i plików konfiguracji spowoduje błąd przedstawiony poniżej.

    Zrzut ekranu przedstawiający błąd aktualizacji.

  6. Wprowadź podstawowe parametry połączenia urządzenia IoT (lub modułu, w zależności od sposobu aprowizowania urządzenia za pomocą usługi Device Update) w pliku konfiguracji, uruchamiając poniższe polecenie.

    sudo nano /etc/adu/du-config.json

  7. Dodawanie modelu, producenta, nazwy agenta, typu połączenia i innych szczegółów w pliku konfiguracji

  8. Usuń stare urządzenie IoT/IoT Edge z portalu publicznej wersji zapoznawczej.

Uwaga

Próba zaktualizowania agenta za pomocą wdrożenia du doprowadzi do braku możliwości zarządzania urządzeniem przez usługę Device Update. Urządzenie będzie musiało zostać ponownie aprowizacji, aby było zarządzane z poziomu usługi Device Update.

Migrowanie grup do odświeżania publicznej wersji zapoznawczej

  1. Jeśli urządzenia korzystają z agenta usługi Device Update w wersji 0.6.0 lub 0.7.0, przeprowadź uaktualnienie do najnowszej wersji agenta 0.8.0, wykonując powyższe kroki.

  2. Usuń istniejące grupy w portalu w publicznej wersji zapoznawczej, przechodząc przez baner.

  3. Dodaj tag grupy do bliźniaczej reprezentacji urządzenia dla zaktualizowanych urządzeń. Aby uzyskać więcej informacji, zobacz sekcję Dodawanie tagu do urządzenia .

  4. Utwórz ponownie grupy w portalu PPR, przechodząc do pozycji "Dodaj grupy" i wybierając odpowiedni tag grup z listy rozwijanej.

  5. Należy pamiętać, że nie można utworzyć grupy o tej samej nazwie w portalu PPR, jeśli grupa w portalu publicznej wersji zapoznawczej nie zostanie usunięta.

Zachowanie grupowania i wdrażania w wersjach

  • Grupy utworzone w portalu wersji publicznej w wersji zapoznawczej zezwalają tylko na dodawanie urządzeń z najnowszym agentem aktualizacji urządzeń (0.8.0). Nie można dodać urządzeń ze starszymi agentami (0.7.0/0.6.0) do tych grup.

  • Wszystkie nowe urządzenia korzystające z najnowszego agenta zostaną automatycznie dodane do domyślnej grupy DeviceClass na karcie "Grupy i wdrożenia". Jeśli tag grupy zostanie dodany do właściwości urządzenia, urządzenie zostanie dodane do tej grupy, jeśli istnieje grupa dla tego tagu.

  • W przypadku urządzenia korzystającego z najnowszego agenta, jeśli tag grupy zostanie dodany do właściwości urządzenia, ale odpowiednia grupa nie została jeszcze utworzona, urządzenie nie będzie widoczne na karcie "Grupy i wdrożenia".

  • Jeśli tag grupy nie zostanie dodany, urządzenia używające starszych agentów będą wyświetlane jako niezgrupowane w starym portalu.

Następne kroki

Omówienie pliku konfiguracji agenta usługi Device Update

Do prostego pokazu aktualizacji urządzenia dla IoT Hub można użyć następujących samouczków: