Sdílet prostřednictvím

Migrace zařízení a skupin z verze Public Preview na aktualizaci verze Public Preview

  • Článek

Vzhledem k tomu, že aktualizace zařízení pro službu IoT Hub vydává nové verze, budete chtít aktualizovat svá zařízení o nejnovější funkce a vylepšení zabezpečení. Tento článek obsahuje informace o tom, jak migrovat z verze Public Preview na aktuální verzi Public Preview Refresh (PPR). Tento článek také vysvětluje chování skupin a uživatelského prostředí v těchto verzích. Pokud nemáte zařízení, skupiny a nasazení, která používají verzi Public Preview, můžete tuto stránku ignorovat.

Pro úspěšnou migraci budete muset upgradovat agenta DU spuštěného na vašich zařízeních. Budete také muset vytvořit nové skupiny zařízení pro nasazení a správu aktualizací. Mějte na paměti, že vzhledem k tomu, že ve verzi PPR dochází k velkým změnám, doporučujeme postupovat podle pokynů, abyste se vyhnuli chybám.

Aktualizace agenta aktualizace zařízení

Pro verzi Public Preview Refresh je potřeba agenta Device Update aktualizovat ručně, jak je popsáno níže. Aktualizace agenta prostřednictvím nasazení služby Device Update není podporovaná kvůli velkým změnám ve verzi Public Preview a PPR.

  1. Pokud chcete zobrazit zařízení používající starší agenty (verze 0.7.0/0.6.0) a skupiny vytvořené před 3. 2. 2022, přejděte na portál verze Public Preview, ke kterému se dostanete přes banner.

    Snímek obrazovky s nápisem

  2. Na Azure Portal vytvořte nové zařízení IoT/IoT Edge. Zkopírujte primární připojovací řetězec zařízení ze zobrazení zařízení pro pozdější použití. Další podrobnosti najdete v části Přidání zařízení do IoT Hub.

  3. Pak se k zařízení přihlaste pomocí SSH a odeberte všechny staré agenty Device Update.

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

  4. Odebrání starého konfiguračního souboru

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

  5. Instalace nového agenta

    sudo apt-get install deviceupdate-agent

    Alternativně můžete získat asset .deb z GitHubu a nainstalovat agenta.

    sudo apt install <file>.deb

    Při pokusu o upgrade agenta aktualizace zařízení bez odebrání starého agenta a konfiguračních souborů dojde k následující chybě.

    Snímek obrazovky s chybou aktualizace

  6. Spuštěním následujícího příkazu zadejte do konfiguračního souboru primární připojovací řetězec zařízení IoT (nebo modulu v závislosti na tom, jak jste zařízení s aktualizací zařízení zřídili).

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

  7. Do konfiguračního souboru přidejte model, výrobce, název agenta, typ připojení a další podrobnosti.

  8. Odstraňte staré zařízení IoT/IoT Edge z portálu public Preview.

Poznámka

Pokus o aktualizaci agenta prostřednictvím nasazení du způsobí, že zařízení už nebude možné spravovat pomocí služby Device Update. Zařízení se bude muset znovu zřídit, aby se spravovala ze služby Device Update.

Migrace skupin do verze Public Preview Refresh

  1. Pokud vaše zařízení používají agenta Aktualizace zařízení verze 0.6.0 nebo 0.7.0, upgradujte na nejnovější verzi agenta 0.8.0 podle výše uvedených kroků.

  2. Existující skupiny na portálu Public Preview odstraňte tak, že přejdete na banner.

  3. Přidejte značku skupiny do dvojčete zařízení pro aktualizovaná zařízení. Další podrobnosti najdete v části Přidání značky do zařízení .

  4. Znovu vytvořte skupiny na portálu PPR tak, že přejdete na Přidat skupiny a v rozevíracím seznamu vyberete odpovídající značku skupin.

  5. Skupinu se stejným názvem nelze vytvořit na portálu PPR, pokud se neodstraní na portálu Public Preview.

Chování při seskupování a nasazení napříč verzemi

  • Skupiny vytvořené na portálu verze Public Preview Refresh budou umožňovat přidávání jenom zařízení s nejnovější verzí Device Update Agent (0.8.0). Zařízení se staršími agenty (0.7.0/0.6.0) nelze do těchto skupin přidat.

  • Všechna nová zařízení, která používají nejnovějšího agenta, se automaticky přidají do výchozí skupiny DeviceClass na kartě Skupiny a nasazení. Pokud se do vlastností zařízení přidá značka skupiny, zařízení se přidá do této skupiny, pokud skupina pro tuto značku existuje.

  • Pro zařízení používající nejnovějšího agenta platí, že pokud se do vlastností zařízení přidá značka skupiny, ale odpovídající skupina ještě není vytvořená, zařízení se na kartě Skupiny a nasazení nezobrazí.

  • Pokud se nepřidá značka skupiny, zařízení, která používají starší agenty, se na starém portálu zobrazí jako neseskupené.

Další kroky

Vysvětlení konfiguračního souboru agenta aktualizace zařízení

Následující kurzy vám pomůžou s jednoduchou ukázkou aktualizace zařízení pro IoT Hub: