Compartir vía

Migración de dispositivos y grupos de la versión preliminar pública a la actualización de la versión preliminar pública

  • Artículo

Dado que el servicio Device Update for IoT Hub lanza versiones nuevas, es aconsejable actualizar los dispositivos para tener las últimas características y mejoras de seguridad. En este artículo se proporciona información sobre cómo migrar la versión preliminar pública a la versión actual, es decir, la versión de la actualización de la versión preliminar pública (PPR). En este artículo también se explica el comportamiento del grupo y la experiencia de usuario en estas versiones. Si no tiene dispositivos, grupos e implementaciones que usen la versión preliminar pública, puede omitir esta página.

Para migrar correctamente, tendrá que actualizar el agente DU que se ejecuta en los dispositivos. También tendrá que crear nuevos grupos de dispositivos para implementar y administrar las actualizaciones. Tenga en cuenta que, como hay cambios importantes con la versión PPR, se recomienda seguir las instrucciones con atención para evitar errores.

Actualización del agente de Device Update

Para la versión de la actualización de la versión preliminar pública, el agente de Device Update debe actualizarse manualmente como se describe a continuación. No se admite la actualización del agente a través de una implementación de Device Update debido a cambios importantes en la versión preliminar pública y PPR.

  1. Para ver los dispositivos que usan agentes anteriores (versiones 0.7.0/0.6.0) y grupos creados antes del 03/02/2022, vaya al portal de la versión preliminar pública, al que se puede acceder a través del banner.

    Captura de pantalla del banner.

  2. Cree un nuevo dispositivo IoT/IoT Edge en Azure Portal. Copie la cadena de conexión principal del dispositivo desde la vista del dispositivo para más adelante. Para obtener más información, consulte la sección Agregar dispositivo a IoT Hub.

  3. A continuación, aplique SSH en el dispositivo y quite cualquier agente anterior de Device Update.

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

  4. Elimine el archivo de configuración anterior

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

  5. Instale el nuevo agente

    sudo apt-get install deviceupdate-agent

    Como alternativa, puede obtener el recurso .deb de GitHub e instalar el agente.

    sudo apt install <file>.deb

    Al intentar actualizar el agente de Device Update sin quitar los archivos de configuración y el agente anteriores, se producirá el error que se muestra a continuación.

    Captura de pantalla del error de actualización.

  6. Escriba la cadena de conexión principal del dispositivo IoT, en función de cómo se aprovisionó el dispositivo con Device Update, en el archivo de configuración mediante la ejecución del comando siguiente.

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

  7. Agregue el modelo, el fabricante, el nombre del agente, el tipo de conexión y otros detalles en el archivo de configuración

  8. Elimine el dispositivo IoT/IoT Edge anterior del portal de la versión preliminar pública.

Nota

Si intenta actualizar el agente a través de una implementación de DU, el dispositivo ya no se podrá administrar mediante Device Update. El dispositivo tendrá que volver a aprovisionarse para administrarse desde Device Update.

Migración de grupos a la actualización de versión preliminar pública

  1. Si los dispositivos usan las versiones 0.6.0 o 0.7.0 del agente de Device Update, actualice a la versión más reciente del agente 0.8.0 siguiendo los pasos anteriores.

  2. Para eliminar los grupos existentes en el portal de la versión preliminar pública, vaya a través del banner.

  3. Agregue una etiqueta de grupo al dispositivo gemelo para los dispositivos actualizados. Para más información, consulte la sección Agregar una etiqueta al dispositivo.

  4. Vuelva a crear los grupos en el portal de PPR; para lo que debe ir a "Agregar grupos" y seleccionar la etiqueta de grupos correspondiente en la lista desplegable.

  5. Tenga en cuenta que no se puede crear un grupo con el mismo nombre en el portal de PPR si no se elimina el grupo en el portal de versión preliminar pública.

Comportamiento de grupo e implementación entre versiones

  • Los grupos creados en el portal de la versión de actualización de versión preliminar pública solo permitirán la adición de dispositivos con el agente de Device Update más reciente (0.8.0). Los dispositivos con agentes anteriores (0.7.0/0.6.0) no se pueden agregar a estos grupos.

  • Los dispositivos nuevos que usen el agente más reciente se agregarán automáticamente a un grupo DeviceClass predeterminado en la pestaña "Groups and Deployments" (Grupos e implementaciones). Si se agrega una etiqueta de grupo a las propiedades del dispositivo, el dispositivo se agregará a ese grupo si existe un grupo para esa etiqueta.

  • Para el dispositivo que usa el agente más reciente, si se agrega una etiqueta de grupo a las propiedades del dispositivo, pero aún no se ha creado el grupo correspondiente, el dispositivo no estará visible en la pestaña "Groups and Deployments" (Grupos e implementaciones).

  • Los dispositivos que usan los agentes anteriores se mostrarán como desagrupados en el portal anterior si no se agrega la etiqueta de grupo.

Pasos siguientes

Descripción del archivo de configuración del agente de Device Update

Puede usar los siguientes tutoriales para una demostración sencilla de Device Update for IoT Hub: