将设备和组从公共预览版迁移到公共预览版更新版

随着 IoT 中心服务的设备更新发布新版本,需要更新设备以获取最新功能和安全性改进。 本文介绍如何从 公共预览版 迁移到当前 公共预览版(PPR)版本。 本文还解释了这些版本中的用户组和用户体验行为。 如果没有使用公共预览版的设备、组和部署,则可以忽略此页面。

若要成功迁移,必须升级设备上运行的 DU 代理。 还需要创建新的设备组才能部署和管理更新。 请注意,由于 PPR 版本发生了重大更改,因此我们建议你严格按照说明作以避免错误。

更新设备更新代理

对于公共预览版刷新版本,需要手动更新设备更新代理,如下所示。 由于公共预览版本和 PPR 版本出现重大更改,无法通过设备更新部署来更新代理。

  1. 若要查看使用旧版代理(版本 0.7.0/0.6.0)和在 2022 年 02 月 3 日之前创建的组的设备,请导航到可通过横幅访问的公共预览门户。

    横幅的屏幕截图。

  2. 在 Azure 门户中创建新的 IoT/IoT Edge 设备。 从设备视图中复制设备的主连接字符串供以后使用。 有关更多详细信息,请参阅 “将设备添加到 IoT 中心 ”部分。

  3. 然后,通过 SSH 连接到设备并删除任何旧的设备更新代理。

    sudo apt remove deviceupdate-agent 
    sudo apt remove adu-agent 
    
  4. 删除旧配置文件

    sudo rm -f /etc/adu/adu-conf.txt 
    
  5. 安装新代理

    sudo apt-get install deviceupdate-agent 
    

    或者,可以从 GitHub 获取.deb资产并安装代理

    sudo apt install <file>.deb
    

    尝试升级设备更新代理而不删除旧的代理和配置文件将导致如下所示的错误。

    更新错误的屏幕截图。

  6. 在配置文件中输入 IoT 设备的主连接字符串(或模块连接字符串,具体视您如何使用 设备更新预配设备),然后运行以下命令。

    sudo nano /etc/adu/du-config.json
    
  7. 在配置文件中添加模型、制造商、代理名称、连接类型和其他详细信息

  8. 从公共预览门户删除旧的 IoT/IoT Edge 设备。

注释

尝试通过 DU 部署对代理进行更新将导致设备无法再由设备更新功能管理。 需要重新为设备进行预配,以便能够通过设备更新平台进行管理。

将组迁移到公共预览刷新阶段

  1. 如果设备使用的是设备更新代理版本 0.6.0 或 0.7.0,请按照以下步骤升级到最新的代理版本 0.8.0。

  2. 通过导航横幅删除公共预览门户中的现有组。

  3. 将组标记添加到已更新设备的设备孪生中。 有关更多详细信息,请参阅 “将标记添加到设备 ”部分。

  4. 通过转到“添加组”并从下拉列表中选择相应的组标记,在 PPR 门户中重新创建组。

  5. 请注意,如果未删除公共预览门户中的组,则无法在 PPR 门户中创建具有相同名称的组。

跨版本分组和部署行为

  • 在公共预览版刷新发布门户中创建的组仅允许添加具有最新设备更新代理 (0.8.0) 的设备。 具有较旧代理的设备(0.7.0/0.6.0)无法添加到这些组。

  • 使用最新代理的任何新设备将自动添加到“组和部署”选项卡中的默认 DeviceClass 组。如果将组标记添加到设备属性,则如果存在该标记的组,设备将添加到该组。

  • 对于使用最新代理的设备,如果将组标记添加到设备属性,但尚未创建相应的组,则设备将不会显示在“组和部署”选项卡中。

  • 如果未添加组标记,使用旧代理的设备将在旧门户中显示为未分组。

后续步骤

了解设备更新代理配置文件

可以使用以下教程来简单演示 IoT 中心的设备更新: