IoT Platform:Iniciar una actualización por lotes

Requisitos previos

Se han completado las siguientes operaciones:

1. An update package is added.

2. Optional. The update package is verified.

Procedimiento

1. Inicie sesión en la consola de IoT Platform.

2. En la página Overview, busque la instancia que desea gestionar y haga clic en el ID o el nombre de la instancia.

3. En el panel de navegación izquierdo, seleccione Maintenance > OTA Update.

   Nota

   Para ofrecer un mejor servicio, IoT Platform ha mejorado la función de actualización OTA y ha añadido estadísticas sobre las versiones de los paquetes de actualización. Cuando utilice la nueva función de actualización OTA en la consola por primera vez, deberá asociar los paquetes de actualización cargados con productos. Solo puede asociar un paquete de actualización con un producto. Para obtener más información sobre cómo asociar paquetes de actualización con productos, consulte las instrucciones en la consola.

4. En la pestaña Update Packages, busque el paquete de actualización que desea gestionar y haga clic en Batch Update en la columna Actions. En el paso Update Scope Configuration, configure los parámetros y haga clic en Next. La siguiente tabla describe los parámetros.

   

   Parámetro	Descripción
   Update Method	Tipo de actualización. Este parámetro es opcional. Valores válidos: Static Update: actualiza únicamente los dispositivos existentes que cumplen las condiciones especificadas. Dynamic Update: actualiza continuamente los dispositivos que cumplen las condiciones especificadas. Las actualizaciones dinámicas se pueden realizar en los siguientes escenarios: Los dispositivos activados después de una actualización dinámica cumplen las condiciones especificadas. Las versiones actuales del módulo OTA que reportan los dispositivos no cumplen las condiciones especificadas. Sin embargo, los dispositivos continúan reportando versiones del módulo OTA que sí cumplen dichas condiciones. Nota Solo puede crear un lote de actualización dinámica por cada paquete de actualización. Si ya creó un lote de actualización dinámica con un paquete, debe cancelar ese lote antes de crear otro nuevo. Un dispositivo puede actualizarse como máximo 10 veces dentro de un lote de actualización dinámica basado en versiones. Si el dispositivo ya se actualizó 10 veces, no se podrá iniciar ninguna otra actualización en él, incluso si posteriormente cumple las condiciones requeridas para una actualización dinámica.
   Upgrade range	Alcance de la actualización. Este parámetro es opcional. Valores válidos: All Devices: actualiza todos los dispositivos del producto especificado que cumplen las condiciones de actualización definidas. Selected Devices: actualiza únicamente los dispositivos seleccionados. Si selecciona Selected Devices, puede utilizar uno de los siguientes métodos para elegir los dispositivos necesarios: Select: Seleccione los dispositivos que desea actualizar en la lista desplegable Device Range. Si utiliza una instancia Enterprise Edition en la región Japan (Tokyo), puede usar la función Advanced search para buscar dispositivos. También puede descargar un archivo CSV que contiene los nombres de los dispositivos coincidentes. Upload File: Descargue un archivo de plantilla en formato .csv, introduzca los nombres de los dispositivos necesarios en dicho archivo y cárguelo. Cada archivo de plantilla puede contener un máximo de 1,000,000 registros. Si un archivo de plantilla contiene uno o más nombres de dispositivo no válidos, se producirá un error. Haga clic en Download Invalid Device Name List para descargar el archivo con los nombres no válidos. Posteriormente, modifique y vuelva a cargar el archivo de plantilla. Phased Update: actualiza los dispositivos especificados. Esta opción solo se muestra si establece el parámetro Update Method en Static Update. Debe especificar al menos un dispositivo para una actualización gradual. Si selecciona Phased Update, aparecerá el campo Update Adoption Rate (%). Debe especificar un porcentaje para los dispositivos indicados en este campo. IoT Platform calcula la cantidad de dispositivos que se pueden actualizar según el porcentaje especificado. El resultado del cálculo se redondea hacia abajo. Group Update: actualiza el grupo de dispositivos especificado. Esta opción solo se muestra si establece el parámetro Update Method en Static Update. La lista desplegable Group list muestra todos los grupos principales y sus subgrupos en la instancia actual. Para obtener más información sobre cómo crear un grupo de dispositivos, consulte Device groups.
   Version number to be upgraded	Antes de configurar este parámetro, tenga en cuenta lo siguiente: Si realiza una actualización estática completa, este parámetro es opcional. Si realiza una actualización dinámica completa, este parámetro es obligatorio. Si establece el parámetro Upgrade range en Selected Devices, este parámetro no se mostrará. La lista desplegable Version number to be upgraded muestra las versiones del módulo OTA de todos los dispositivos del producto actual, excepto la versión destino de la actualización. Puede seleccionar una o más versiones. Si no configura este parámetro, no se aplicará ningún límite al número de versión del módulo OTA de los dispositivos que se van a actualizar. Si realiza una actualización diferencial, el valor de este parámetro será el número de versión que especifique al agregar el paquete de actualización. Si establece el parámetro Update Method en Dynamic Update al crear un lote de actualización y dicho lote se encuentra en estado updating, podrá modificar el valor de este parámetro.

5. En el paso Update Policy Configuration, configure los parámetros y haga clic en Complete. A continuación, IoT Platform enviará notificaciones de actualización a los dispositivos. La siguiente tabla describe los parámetros.

   

   Parámetro	Descripción
   Upgrade time	Momento en que desea realizar la actualización OTA. Valores válidos: Update: realiza la actualización OTA inmediatamente. Scheduled Update: realiza la actualización OTA dentro de un intervalo de tiempo específico. Puede definir una hora de inicio y una hora de finalización para la actualización OTA. La hora de inicio debe ser entre 5 minutos y 7 días posterior a la hora actual. La hora de finalización debe ser entre 1 hora y 30 días posterior a la hora de inicio. La hora de finalización es opcional. Si no especifica una hora de finalización, la actualización no se detendrá forzosamente. Nota Las actualizaciones programadas solo son compatibles si establece el parámetro Update Method en Static Update.
   Whether IoT Platform Actively Pushes Update Task	Especifica si IoT Platform envía automáticamente tareas de actualización a los dispositivos. Yes: Después de crear un lote de actualización, IoT Platform envía automáticamente las tareas de actualización a los dispositivos en línea especificados. Este es el valor predeterminado. En este caso, el dispositivo aún puede iniciar una solicitud para obtener la información sobre la tarea de actualización OTA from IoT Platform. No: El dispositivo inicia una solicitud para obtener la información sobre la tarea de actualización OTA from IoT Platform.
   Update Package Push Rate	Cantidad de dispositivos a los que desea enviar la URL de descarga del paquete de actualización por minuto. Valores válidos: Constant Rate y Variable Rate. Importante Este parámetro no se muestra si establece el parámetro Whether IoT Platform Actively Pushes Update Task en No. La opción Variable Rate solo está disponible para instancias Enterprise Edition. A continuación se describen los parámetros: Si especifica Constant Rate, debe configurar el parámetro Update at Constant Rate. Valores válidos: de 10 a 10000. El valor debe ser un número entero. Unidad: dispositivos por minuto. Una vez que especifica un valor para el parámetro Update at Constant Rate, la tasa de envío se mantiene sin cambios. Por ejemplo, si necesita corregir una vulnerabilidad de alto riesgo, debe enviar un paquete de actualización a todos los dispositivos para realizar la actualización. En este caso, se recomienda establecer el parámetro Update Package Push Rate en Constant Rate. Puede configurar la tasa constante máxima en 10,000 dispositivos por minuto. De esta manera, podrá enviar el paquete de actualización a los dispositivos objetivo lo antes posible. Variable Rate: En algunos casos, podría necesitar enviar un paquete de actualización a una tasa baja inicialmente (por ejemplo, un dispositivo por minuto) y luego aumentar continuamente la tasa de envío según ciertas condiciones. Puede establecer el parámetro Update Package Push Rate en Variable Rate. Por ejemplo, si desea enviar un paquete de actualización a todos los dispositivos a una tasa baja cuando se agrega una nueva función. Así podrá actualizar primero una pequeña porción de dispositivos al inicio del proceso. Luego, podrá comprobar si los dispositivos actualizados funcionan como se espera y determinar si aumenta la tasa de envío según el resultado de dicha comprobación. Este proceso es similar al de realizar una actualización gradual antes de una actualización completa para garantizar el éxito en todos los dispositivos. Si especifica Variable Rate, debe configurar los siguientes parámetros: Basic Push Rate: especifica la cantidad de dispositivos a los que desea enviar un paquete de actualización por minuto si la cantidad de dispositivos a los que se ha enviado el paquete o la cantidad de dispositivos actualizados no alcanza el valor del parámetro Pushed Devices o Updated Devices en la sección Increase Push Rate. Valores válidos: de 1 a 10000. El valor debe ser un número entero menor o igual al valor del parámetro Maximum Push Rate. Incremental Factor: especifica un factor incremental con base en el cual el sistema aumenta la tasa de envío. Este parámetro aplica si la cantidad de dispositivos a los que se ha enviado el paquete de actualización o la cantidad de dispositivos actualizados alcanza el valor del parámetro Pushed Devices o Updated Devices en la sección Increase Push Rate. Valores válidos: de 1.20 a 5.00. El valor se redondea a dos decimales. Maximum Push Rate: especifica la cantidad máxima de dispositivos a los que desea enviar el paquete de actualización por minuto. Valores válidos: de 10 a 10000. El valor debe ser un número entero. Si la tasa a la que el sistema envía el paquete de actualización alcanza la tasa máxima, el sistema continuará enviando el paquete a dicha tasa máxima y dejará de modificarla. Increase Push Rate: especifica un valor de umbral para el parámetro Pushed Devices o Updated Devices. Valores válidos: de 1 a 100000. El valor debe ser un número entero. Si la cantidad de dispositivos a los que se ha enviado el paquete de actualización o la cantidad de dispositivos actualizados alcanza el valor de umbral, el sistema aumentará la tasa de envío según el valor del parámetro Incremental Factor. Ejemplo: Realiza una actualización OTA con la siguiente configuración: Establece el parámetro Update Package Push Rage en Variable Rate, define el parámetro Basic Push Rate en 50, establece el parámetro Incremental Factor en 2, fija el Maximum Push Rate en 10000 y luego configura el parámetro Pushed Devices en 1000 dentro de la sección Increase Push Rate. El siguiente proceso describe cómo se lleva a cabo la actualización OTA: Se crea una tarea de actualización OTA para enviar un paquete de actualización a 1,000 dispositivos a una tasa inicial de 50 dispositivos por minuto. Posteriormente, la tasa de envío aumenta según el factor incremental. El siguiente proceso describe cómo el sistema incrementa la tasa de envío: La tarea de actualización OTA envía el paquete a 1,000 dispositivos a una tasa de 50 dispositivos por minuto. Luego, el sistema incrementa la tasa a 100 dispositivos por minuto según el valor del parámetro Incremental Factor. La tarea de actualización OTA envía el paquete a otros 1,000 dispositivos a una tasa de 100 dispositivos por minuto. Un total de 2,000 dispositivos han recibido el paquete. Entonces, el sistema incrementa la tasa a 200 dispositivos por minuto. La tarea de actualización OTA envía el paquete a otros 1,000 dispositivos a una tasa de 200 dispositivos por minuto. Un total de 3,000 dispositivos han recibido el paquete. Luego, el sistema incrementa la tasa a 400 dispositivos por minuto. La tarea de actualización OTA envía el paquete a otros 1,000 dispositivos a una tasa de 400 dispositivos por minuto. Un total de 4,000 dispositivos han recibido el paquete. Después, el sistema incrementa la tasa a 800 dispositivos por minuto. De este modo, la tarea de actualización OTA continúa enviando el paquete a tasas de 800, 1,600, 3,200 y finalmente 6,400 dispositivos por minuto hasta que un total de 8,000 dispositivos reciben el paquete y la tasa de envío se incrementa a 12,800 dispositivos por minuto según el valor del parámetro Incremental Factor. Dado que el valor 12800 supera el umbral de 10000 establecido en el parámetro Maximum Push Rate, la tarea de actualización OTA enviará el paquete a la tasa máxima de 10,000 dispositivos por minuto y dejará de modificar dicha tasa. Si un lote de actualización que creó se encuentra en estado updating, podrá modificar la tasa de envío especificada para distribuir el paquete de actualización. No obstante, no podrá cambiar el tipo de envío de Constant Rate a Variable Rate ni viceversa. Para obtener más información, consulte Manage update batches.
   Upgrade failed retry interval	Intervalo entre un fallo de actualización y el reintento posterior. Valores válidos: Do Not Retry Retry Immediately Retry in 10 Minutes Retry in 30 Minutes Retry in 1 Hour Retry in 24 Hours Importante El valor del parámetro Upgrade failed retry interval debe ser menor que el valor del parámetro Device upgrade time-out (minutes). Ejemplos: Si establece el tiempo de espera en 60 minutos, el intervalo máximo de reintento que puede especificar es de 30 minutos. Si establece el tiempo de espera en 1,440 minutos, el intervalo máximo de reintento que puede especificar es de 1 hora. Si desea establecer el parámetro Upgrade failed retry interval en Retry in 24 Hours, se recomienda no configurar el parámetro Device upgrade time-out (minutes). Si una actualización excede el tiempo de espera, no se realizará ningún reintento.
   Max. Retry Times	Cantidad máxima de reintentos que se pueden ejecutar si falla una actualización. Valores válidos: 1 2 5
   Device upgrade time-out (minutes)	Tiempo de espera de la actualización para un solo dispositivo. Si un dispositivo especificado no se ha actualizado dentro de este periodo, la actualización caducará. Valores válidos: de 1 a 1440. Unidad: minutos. Nota El periodo de actualización comienza from la primera vez que el dispositivo especificado reporta el progreso de la actualización. Durante la actualización, es posible que el paquete se envíe repetidamente al dispositivo especificado debido a que este se conecta y desconecta varias veces. La hora de inicio del periodo de actualización permanece inalterada. Si establece el parámetro Update Method en Dynamic Update al crear un lote de actualización y dicho lote se encuentra en estado updating, podrá modificar el valor de este parámetro. Para obtener más información, consulte Manage update batches.
   The device supports simultaneous updates of multiple modules	Especifica si un dispositivo admite actualizaciones simultáneas en varios módulos. Este parámetro solo se muestra para una instancia Enterprise Edition o una instancia pública de la nueva versión. Valores válidos: Yes: El dispositivo admite actualizaciones simultáneas en varios módulos. En este caso, IoT Platform utiliza la tarea de actualización actual para sobrescribir las tareas de actualización anteriores del mismo módulo, pero no sobrescribe las tareas de actualización que están en curso. Importante Solo un dispositivo que utiliza Link SDK V4.x para C admite actualizaciones simultáneas en varios módulos. Para obtener más información, consulte Overview. Puede establecer el parámetro The device supports simultaneous updates of multiple modules o Override Previous Device Update Tasks en Yes. La configuración de los parámetros The device supports simultaneous updates of multiple modules y Override Previous Device Update Tasks de un nuevo lote de actualización dinámica para un grupo de dispositivos debe ser idéntica a la del lote de actualización dinámica existente para dicho grupo. Para obtener más información, consulte la tabla Simultaneous updates of multiple modules en el tema OTA update overview. No: El dispositivo no admite actualizaciones simultáneas en varios módulos. Valor predeterminado: No.
   Override Previous Device Update Tasks	Especifica si se deben sobrescribir las tareas de actualización anteriores de un dispositivo. Si un dispositivo tiene múltiples tareas de actualización, debe indicar si la tarea actual debe sobrescribir las anteriores. Una tarea de actualización en un dispositivo puede estar en estado Pending Confirmation, To Be Pushed o Pushed. Valores válidos: Yes: Solo se ejecuta la tarea de actualización más reciente. Las tareas anteriores se cancelan. No: Solo se ejecuta la tarea de actualización existente. Valor predeterminado: No. Nota Las tareas de actualización que están en curso no se sobrescriben.
   Take Effect for only Devices that Newly Report Versions	Especifica si se deben actualizar únicamente los dispositivos que reporten nuevas versiones del módulo OTA posteriormente. Este parámetro solo se muestra si establece el parámetro Update Method en Dynamic Update. Valores válidos: Yes: actualiza únicamente los dispositivos que reportan nuevas versiones del módulo OTA. No: actualiza los dispositivos existentes que cumplen las condiciones de actualización y verifica continuamente si los dispositivos que reportan nuevas versiones del módulo OTA también cumplen dichas condiciones. Valor predeterminado: No.
   APP Confirm Upgrade	Especifica si puede utilizar una aplicación móvil para realizar la actualización. Si selecciona Yes, deberá desarrollar la aplicación móvil. Valores válidos: Yes: Para realizar una actualización OTA en un dispositivo, debe confirmar la actualización mediante su aplicación móvil. Puede llamar a la operación ConfirmOTATask para confirmar varias tareas de actualización en estado pendiente de confirmación simultáneamente. Posteriormente, el dispositivo podrá obtener la información sobre la tarea de actualización OTA según el valor del parámetro Whether IoT Platform Actively Pushes Update Task. No: El dispositivo obtiene la información sobre la tarea de actualización OTA según la configuración del parámetro Whether IoT Platform Actively Pushes Update Task. Valor predeterminado: No.
   Update Package Download Protocol	Protocolo que desea utilizar para descargar el paquete de actualización. Valores válidos: HTTPS y MQTT. Una vez que un dispositivo recibe la URL del paquete de actualización from IoT Platform, puede utilizar este protocolo para descargarlo. Importante Si desea descargar el paquete de actualización mediante el protocolo Message Queuing Telemetry Transport (MQTT), tenga en cuenta lo siguiente: Su servicio debe estar desplegado en la región China (Shanghai), China (Beijing) o China (Shenzhen). El paquete de actualización OTA solo puede contener un archivo, y el tamaño de dicho archivo no puede superar los 16 MB. Debe utilizar la versión más reciente de Link SDK para C con el fin de desarrollar las funciones del dispositivo necesarias para realizar actualizaciones OTA y descargar archivos a través de MQTT. Para obtener más información, consulte Sample code.
   Batch label	Haga clic en Add Tag. En los campos que aparecen, especifique la clave de etiqueta y el valor de etiqueta. Si un lote de actualización que creó se encuentra en estado updating, podrá modificar la etiqueta o agregar más etiquetas. Para obtener más información, consulte Manage update batches. Las etiquetas de un lote de actualización se envían a los dispositivos cuando IoT Platform les envía notificaciones de actualización. Puede pasar el puntero sobre el icono para consultar las reglas con base en las cuales puede configurar las etiquetas.

6. Opcional:En la pestaña Batch Management de la página Update Package Details, busque el lote de actualización dinámica y haga clic en Edit en la columna Actions. En los pasos Update Scope Configuration y Update Policy Configuration, podrá modificar los valores de los parámetros Version number to be upgraded y Device upgrade time-out. También puede cancelar la configuración de tiempo de espera.

   Importante

   • Antes de modificar la configuración de actualización dinámica, tenga en cuenta lo siguiente:

     • Version number to be upgraded: Si agrega un número de versión, se actualizarán tanto los dispositivos existentes que usan esa versión como los nuevos dispositivos que coincidan con la directiva dinámica. Si elimina un número de versión, los dispositivos existentes no se verán afectados.

     • Device upgrade time-out: Este parámetro solo surte efecto para actualizaciones OTA dinámicas en dispositivos nuevos. Los dispositivos existentes no se ven afectados.

   • No puede modificar el valor del parámetro Version number to be upgraded para un lote de actualización dinámica basado en grupos.

Resultado

Después de iniciar una actualización por lotes, IoT Platform envía una notificación de actualización a los dispositivos especificados según su configuración. Puede consultar el estado de actualización de cada dispositivo y la información del paquete de actualización en la consola de IoT Platform. Para obtener más información, consulte View update status.

Operaciones de API relacionadas

Para obtener más información sobre las operaciones de API relacionadas con la función de actualización OTA, consulte OTA update APIs.